Twinkly HomeKit Hub for Mongoose OS

Add your Twinkly Smart Lights to HomeKit smarthome infrastructure. Use Siri voice control and all the scripting potential from Apple

Supported platforms

ESP8266
ESP32

Dependencies

Twinkly library - Twinkly Mongoose OS library
ARP library - ARP scan implementation
HomeKit ADK library which is port of the official Apple HomeKit ADK
WiFi Setup library - Web-based WiFi setup captive portal

Adding Twinkly device to a hub

Type the accessory IP address in a browser, select desired device and press Add

Removing Twinkly device from a hub

Type the accessory IP address in a browser, select desired device and press ❌

Manual ON / OFF

Manual control is supported by Web GUI. This way You can another emergency control channel.

HomeKit accessory reset

Type the accessory IP address in a browser and press HAP reset

Accessory design

Every Twinkly device added represent itself as a LightBulb HomeKit service in the accessory

Identification

Build in LED blinks during the identification

LED indication

LED blink on twinkly library init
LED blink on twinkly device changes
LED blink on HAP going to update twinkly device
LED blinking continous on connection lost / (re)connecting

Setup

Using the Mongoose OS framework:

$ mos build
$ mos flash

WiFi settings

Connect WiFi access point name TWH-XXXX password twinklyhub, select home network and save credentials

Factory reset

Hold a button for factory reset. This will remove WiFi settings, HAP server status, Twinkly devices list.

Configuration:

  - ["pins.button", "i", -1, {title: "Button GPIO pin"}]
  - ["pins.button_hold_ms", "i", 5000, {title: "Button hold time for reset"}]
  - ["pins.button_pull_up", "b", true, {title: "Button pull up or down"}]

Copyrights

d4rkmen
Deomid "rojer" Ryabkov
The HomeKit ADK Contributors

d4rkmen/twinkly-homekit