Home

Welcome to the homekit_wifi_thermostat wiki!

OTA Instructions

This accessory firmware uses an over the air mechanism (OTA) to download and install pre-compiled firmware directly to your device from GitHb

The OTA mechanism was created by HomeACessoryKid, I’ve included some quick start instructions below, but if you want to know how it works and see the source code it can be found here:- https://github.com/HomeACcessoryKid/ota

Installing pre-built firmware OTA

The simplest way to get up and running involves two stages:-

• Stage 1 - flashing the OTA firmware to your device
• Stage 2 - connecting the device to your WiFi and telling it to flash the accessory firmware form GitHub

Stage 1 - installing OTA firmware to your device

To install the OTA firmware we need to download three pre-build files as follows:- 

• otaboot.bin file from here:- https://github.com/HomeACcessoryKid/ota/releases/

• blank_config.bin and rboot.bin from here:- https://github.com/SuperHouse/esp-open-rtos/tree/master/bootloader/firmware_prebuilt

  You then need to erase and flash these there file to your device as follows, I assume here you have esptool.py installed and know how to put you device into flash mode:-

  esptool.py -p /dev/cu.usbserial erase_flash esptool.py -p /dev/cu.usbserial --baud 230400 write_flash -fs 8m -fm qio -ff 40m 0x2000 otaboot.bin 0x0 rboot.bin 0x1000 blank_config.bin

Stage 2 - connecting the device to your WiFi and telling it to flash the accessory firmware from GitHub

When your device restarts, it will be operating as a Wifi access point, connect to the device with your iOS device, by selecting it in settings->wifi. You will then be promoted with a configuration web page:-

• select your WiFi by clicking on it
• enter your WiFi password
• enter the GitHub directory - maccoylton/homekit_wifi_thermostat
• enter filename - main.bin.
• click the join button

The device will now re-boot, connect to your Wifi network, download and flash the main.bin file from the latest release from the repository github.com/maccoylton/homekit_wifi_thermostat. Once this is completed the device will reboot again and be ready to be paired like any standard HomeKit Accessory.

Updating pre-built firmware OTA

To update your accessory firmware to the latest release, in the accessory you will see a firmwareupdate switch, set this to on and the latest version of the firmware will be automatically downloaded and flashed. The accessory will reboot once the flash has completed, if no updated flash is available, it will revert back to the current version already installed.