# homekit-bridge

**Repository Path**: albb0608/homekit-bridge

## Basic Information

- **Project Name**: homekit-bridge
- **Description**: 让任意设备接入Apple HomeKit.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://github.com/zebin-wu/homekit-bridge
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2023-02-04
- **Last Updated**: 2023-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# homekit-bridge

English Version | [中文版](README_CN.md)

## Introduction

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](https://github.com/apple/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](https://www.lua.org), 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.

## Supported devices

### Mi Home - [miio](plugins/miio/README.md)

Product Name | Model
-|-
Xiaomi Mi Air Conditioner Companion 2 | `lumi.acpartner.mcn02`
Xiaomi Smart Plug (Wi-Fi) | `chuangmi.plug.m3`
Xiaomi Smart Plug 2 (Bluetooth Gateway) | `chuangmi.plug.212a01`
Zhimi DC Variable Frequency Fan 2S | `zhimi.fan.za4`
Xiaomi DC Variable Frequency Fan 1X | `dmaker.fan.p5`
Xiaomi DC Variable Frequency Tower Fan | `dmaker.fan.p9`
Xiaomi Smart Dehumidifier 22L | `dmaker.derh.22l`

## Supported platform

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

## Getting started

### Attention

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

```bash
git submodule update --init
```

### Linux (Ubuntu)

#### Prepare

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

#### Compile and install

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

#### Run

Run homekit-bridge by default:

```bash
homekit-bridge
```

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

Option | Description
-|-
`-d`, `--dir` | set the working directory
`-e`, `--entry` | set the entry script name
`-h`, `--help` | display this help and exit

#### Configure

The configuration file `config.json` is placed in `/usr/local/lib/homekit-bridge` by default, you can edit it before running homekit-bridge. If you specified the working directory, homekit-bridge will find `config.json` in the specified directory.

### ESP-IDF

#### Prepare

Set up the host environment and ESP-IDF as per the steps given [here](https://docs.espressif.com/projects/esp-idf/en/v4.4.2/get-started/index.html).

The currently tested ESP-IDF version is **v4.4.2**, switch to this version with the following command:

```bash
git fetch --tag
git checkout v4.4.2
git submodule update
```

#### Compile and flash

Compile, flash and connect to console as below:

```bash
cd /path/to/homekit-bridge/platform/esp
export ESPPORT=/dev/ttyUSB0  # Set your board's serial port here
idf.py set-target [esp32|esp32s2|esp32c3|esp32s3]
idf.py flash
idf.py monitor
```

#### Join Wi-Fi

Use `join` command to configure Wi-Fi:

```bash
join "<ssid>" "<password>"
```

#### Configure

TODO

## License

[Apache-2.0 © 2021-2022 Zebin Wu and homekit-bridge contributors.](LICENSE)