Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paullj1/TreatLife-HomeKit
Open source firmware for the TreatLife DS0X dimmer switches for native HomeKit use.
https://github.com/paullj1/TreatLife-HomeKit
esp8266 esp8266-arduino firmware homekit homekit-accessory-protocol ota treatlife treatlife-homekit tuya
Last synced: about 2 months ago
JSON representation
Open source firmware for the TreatLife DS0X dimmer switches for native HomeKit use.
- Host: GitHub
- URL: https://github.com/paullj1/TreatLife-HomeKit
- Owner: paullj1
- License: mit
- Created: 2021-03-06T18:10:23.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-14T14:30:20.000Z (almost 2 years ago)
- Last Synced: 2024-07-30T20:56:50.092Z (5 months ago)
- Topics: esp8266, esp8266-arduino, firmware, homekit, homekit-accessory-protocol, ota, treatlife, treatlife-homekit, tuya
- Language: C++
- Homepage:
- Size: 1.8 MB
- Stars: 9
- Watchers: 2
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# TreatLife HomeKit
Open source firmware with native HomeKit support, and OTA upgrades for:
* [TreatLife DS01C touch dimmer switch](https://smile.amazon.com/dp/B07PJTLB7Z)
* [TreatLife DS02S dimmer switch](https://smile.amazon.com/dp/B07YKFSWJN)
* [TreatLife DS02 three-way dimmer switch](https://smile.amazon.com/dp/B08R89VNMV)
* [TreatLife DS03 dimmer and fan control](https://smile.amazon.com/dp/B086PPRWL7)
# Release Binaries
[]()
[](https://github.com/paullj1/TreatLife-HomeKit/releases)
* [DS01C](https://github.com/paullj1/TreatLife-HomeKit/releases/latest/download/DS01C.bin)
* [DS02](https://github.com/paullj1/TreatLife-HomeKit/releases/latest/download/DS02.bin)
* [DS02S](https://github.com/paullj1/TreatLife-HomeKit/releases/latest/download/DS02S.bin)
* [DS03](https://github.com/paullj1/TreatLife-HomeKit/releases/latest/download/DS03.bin)
# Flashing
## Using esptool from Espressif
1. Setup [esptool](https://github.com/espressif/esptool)
2. Acquire a USB to Serial adapter (I used [this one](https://www.amazon.com/dp/B07VV4B2MJ))
3. Solder the 3.3v (VCC), GND, TXD, and RXD onto the chip:
* 
4. Connect GPIO0 to ground when applying power to the chip to enter flash mode
* I did this by soldering a wire to the back of the USB to serial adapter's GND pin, and then touching it to GPIO0 when plugging in USB adapter
5. Run esptool (where `/dev/tty.usbserial-XXXX` is your USB to serial adapter, and `DS02S.bin` is the desired firmware image):
```
esptool.py -p /dev/tty.usbserial-XXXX -b 115200 write_flash -e 0x0 DS02S.bin
```
6. Reboot device by unplugging USB power, and then plugging it back in
# Setup
1. When device boots, it will enter config mode
2. Connect to WiFi access point the device exposes (ESP-XXXXXX) where XXXXXX is the last 6 bytes of the devices MAC address
3. Configure your WiFi SSID/password
4. Go to the home app on your iPhone/iPad and press the "+" button and select "Add Accessory"
5. Press "I Don't Have a Code or Cannot Scan"
6. Your device should appear on this screen, select it, and enter the setup code "030-52-021" (or use QR code above)
7. Device should pair
# Config Mode
* To enter config mode to change your SSID, or update the firmware, press and hold the light on/off button for at least five seconds, then browse to the IP address of the device. To get the IP, you can look at your ARP cache for the MAC address which matches the devices serial number.
# Notes
* If upgrading from tasmota, you'll need to use the gzip'd binary in the release
* This firmware is built to utilize the ESP8266EX chip in the SmartLife devices
which has 2mb of flash
* If upgrading from an older version, DO NOT use the gzip'd binary, the full
bin should work
# Building
## arduino-cli
```
# To build a specific device, cd into its dir, then:
# In any of the device directories (DS01C, DS02S, DS03, etc...)
make requirements
make compile
# Resulting binary will be DSXXX.bin; use esptool, "make upload", or Arduino to flash
# To build all at once from top level directory (resulting bins will be in 'release' dir):
make
```
## Arduino IDE
Use the following settings, and install the required dependencies:
# Dependencies (libraries you'll need to install in Arduino IDE):
* [Arduino-HomeKit-ESP8266](https://github.com/Mixiaoxiao/Arduino-HomeKit-ESP8266) by [Mixiaoxiao](https://github.com/Mixiaoxiao)
* [WiFi Manager](https://github.com/tzapu/WiFiManager) by [tzapu](https://github.com/tzapu)
* Provides easy config, and OTA updates
# Credits
* Adapted Tuya MCU driver code from [Tasmota](https://tasmota.github.io/docs/)