Unreleased SwitchBot Firmware Documentation

kendallgoto commented 2 years ago

I haven't studied any of these binaries, so take care:

Debug v1.0 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V10.bin (unreleased 2021-12-06) Debug v1.1 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V11.bin (2021-12-06) Debug v1.2 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V12.bin (2021-12-27) Debug v1.3 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V13.bin (2022-03-03) Debug v1.4 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V14.bin (2022-05-06) Debug v1.5 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V15.bin (2022-11-04) Debug v1.6 http://www.wohand.com/version/wocaodebug/firmware/WoPlugUS/WoPlugUS_V16.bin (unreleased 2023-03-29)

Production v1.1 http://www.wohand.com/version/wocaotech/firmware/WoPlugUS/WoPlugUS_V11.bin Production v1.2 http://www.wohand.com/version/wocaotech/firmware/WoPlugUS/WoPlugUS_V12.bin (latest for regular plugs as of 2022-07-19) Production v1.3 http://www.wohand.com/version/wocaotech/firmware/WoPlugUS/WoPlugUS_V13.bin Production v1.4 http://www.wohand.com/version/wocaotech/firmware/WoPlugUS/WoPlugUS_V14.bin (latest for HomeKit plugs as of 2022-07-19) Production v1.5 http://www.wohand.com/version/wocaotech/firmware/WoPlugUS/WoPlugUS_V15.bin (2022-11-10)

Just wanted to document the links I found - I'm not sure what the practical difference is between the debug and production firmware versions in each case.

Cossid commented 2 years ago

~~Curious, are there any hardware differences for the HomeKit plugs, or is it just software?~~ Read the closed issue, thanks!

Additional hardware:

Production v1.4 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V14.bin Production v1.5 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V15.bin Production v1.6 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V16.bin Production v1.7 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V17.bin Production v1.8 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V18.bin Production v1.9 http://www.wohand.com/version/wocaotech/firmware/WoHumi/WoHumi_V19.bin

evlo commented 2 years ago

So with this would it be possible to just upload it to the device through switchbota and revert to factory? I'm asking as ie. sonoff has different firmware for each unit.

kendallgoto commented 2 years ago

no - these are OTA images. They only contain the app-code portion of the app. Switchbota writes the entire internal flash of the device, requiring the bootloader, partition table, nvs values, etc.

You can, however, trigger one of these to install using the original firmware and a custom crafted BLE message. For the Switchbot Plugs, I wrote the BLE info here: https://github.com/kendallgoto/switchbot-plug-influxdb/blob/master/notes.txt#L47

To install a debug build on a production plug, you'd need to likely spoof the web server using something like Switchbota's node webserver (with modifications) to serve the Debug build for a Production request.

kendallgoto commented 1 year ago

Updated OP w/ new releases I saw on 3/29/2023, including: 1.5 has been released to production from debug 1.6 has appeared in debug

AJolly commented 4 months ago

I can confirm this worked successfully with 1.5, including letting me flash to esphome.

kendallgoto / switchbota

Unreleased SwitchBot Firmware Documentation #23