homekit-bridge designed for embedded devices allows you to connect non-HomeKit devices to Apple HomeKit quickly. It provides the following features:

• Configure the devices you want to connect to HomeKit.
• Write plugins to generate HomeKit bridged accessories.

homekit-bridge is based on HomeKitADK; the main C code is in the application layer of ADK.

HomekitADK not only implements HomeKit Accessory Protocol(HAP), but also abstracts platform-related interfaces to Platform Adapter Layer(PAL) to make the same application code behave consistently on different platforms.

In order to achieve better scalability and reduce development difficulty, homekit-bridge introduced the dynamic language Lua, encapsulated C modules into Lua modules, and used Lua to write upper-level applications. homekit-bridge also made the following optimizations to run Lua on devices with compact resources:

• Generate text code to byte code via luac.
• Generate directory trees for multiple Lua scripts and embed them in C code.
• Make the Lua VM supports reading the code directly from ROM instead of copying the code to RAM.

• Linux (Ubuntu/Raspberry Pi OS)
• ESP-IDF (ESP32/ESP32-S2/ESP32-C3/ESP32-S3)

After clone the repository to the local, please initialize submodules by the follow command:

git submodule update --init

sudo apt install cmake ninja-build clang libavahi-compat-libdnssd-dev libssl-dev python3-pip
sudo pip3 install cpplint

mkdir build
cd build
cmake -G Ninja .. && ninja
sudo ninja install

Run homekit-bridge by default:

homekit-bridge

The following options can be specified when running homekit-bridge:

Set up the host environment and ESP-IDF as per the steps given here.

The currently tested ESP-IDF version is v5.1.2, switch to this version with the following command:

git fetch --tag
git checkout v5.1.2
git submodule update

Compile, flash and connect to console as below:

idf.py set-target [esp32|esp32s2|esp32c3|esp32s3|esp32c6]
idf.py flash monitor

Use join command to configure Wi-Fi:

join "<ssid>" "<password>"

Using the follow commands to operate configuration items:

homekit-bridge config <key>

homekit-bridge config <key> <value>

homekit-bridge config --add <key> <value>

Each plugin has its own specific configuration, see the plugin readme for details.

homekit-bridge will automatically generate a setup code, which can be entered when adding accessory. The setup code can be obtained through the following command:

homekit-bridge setupcode

Apache-2.0 © 2021-2022 Zebin Wu and homekit-bridge contributors.