ESP HomeKit Devices

Add native HomeKit support, OTA updates and some custom settings to any device with an ESP8266 or ESP8285 microcontroller. This means that bridges like HomeBridge are not necessary.

This project uses a modified version of the Apple HomeKit accessory server library ESP-HomeKit from @MaximKulkin for ESP-OPEN-RTOS. And it uses a modified version of the OTA update system Life-Cycle-Manager (LCM) from @HomeACessoryKid.

This work is focused on any device that uses an esp8266 chip, like Sonoff, Shelly, and custom devices. Any suggestion is welcome, but only official Apple HomeKit characteristics will be considered (Those that work with stock Apple Home App), and custom HomeKit characteristics that use third-party Apps will be rejected.

Although already forbidden by the sources and subsequent licensing, it is not allowed to use or distribute this software for a commercial purpose.

HomeKit Accessory Protocol (HAP) is Apple’s proprietary protocol that enables third-party accessories in the home (e.g., lights, thermostats and door locks) and Apple products to communicate with each other. HAP supports two transports, IP and Bluetooth LE. The information provided in the HomeKit Accessory Protocol Specification (Non-Commercial Version) describes how to implement HAP in an accessory that you create for non-commercial use and that will not be distributed or sold.

The HomeKit Accessory Protocol Specification (Non-Commercial Version) can be downloaded from the HomeKit Apple Developer page.

Copyright © 2019-2020 Apple Inc. All rights reserved.

Home Accessory Architect Firmware (RavenCore v2)

It is an advanced firmware that lets you to configure any kind of device using a JSON string.

Documentation

Documentation is written and is maintained by @WizBangCrash

Helping and Supporting

This firmware will always be open source and free to use, but if you want to support future development you can do so by donating.

All kind of help is welcome. Feedbacks of new devices, testing, documentation about hardware...

Official Twitter and Chat

Follow me on Twitter to stay tuned with last news and releases:

Official Twitter

Here you can ask for help and share experiences with other users who use my firmwares (English, Spanish and Italian channels):

Join Official Community Chat

About issues

• Before opening a new issue, check if there is another of same topic.
• If you have bugs, please, attach a .txt file with logs. Read how to capture logs from your device