Skip to content
No description, website, or topics provided.
C C++ Shell Objective-C Makefile Dockerfile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Applications HomeKit ADK implementation Dec 18, 2019
Build Build AccessorySetupGenerator against host PAL instead of mock Jan 14, 2020
Documentation Add documentation for ADK development platforms Jan 14, 2020
External HomeKit ADK implementation Dec 18, 2019
HAP HomeKit ADK implementation Dec 18, 2019
PAL Fix lint issues Jan 14, 2020
Tests HomeKit ADK implementation Dec 18, 2019
Tools Fix lint issues Jan 14, 2020
.clang-format Add tools to lint the code Jan 14, 2020
.gitignore HomeKit ADK implementation Dec 18, 2019
CODE_OF_CONDUCT.md HomeKit ADK implementation Dec 18, 2019
CONTRIBUTING.md Add documentation for developing with ADK Jan 14, 2020
CONTRIBUTORS.md Fix contributors Dec 20, 2019
LICENSE.md HomeKit ADK implementation Dec 18, 2019
Makefile Don't enable TTY by default for dokcer compilation Jan 14, 2020
README.md

README.md

HomeKit Accessory Development Kit (ADK)

The HomeKit ADK is used by silicon vendors and accessory manufacturers to build HomeKit compatible devices.

The HomeKit ADK implements key components of the HomeKit Accessory Protocol (HAP), which embodies the core principles Apple brings to smart home technology: security, privacy, and reliability.

The HomeKit Open Source ADK is an open-source version of the HomeKit Accessory Development Kit. It can be used by any developer to prototype non-commercial smart home accessories. For commercial accessories, accessory developers must continue to use the commercial version of the HomeKit ADK available through the MFi Program.

Go to the Apple Developer Site if you like to learn more about developing HomeKit-enabled accessories and apps.

Documentation

Darwin PAL

Compile

make all

Run

./Output/Darwin-x86_64-apple-darwin18.6.0/Debug/IP/Applications/Lightbulb.OpenSSL

Linux PAL

Compile

make TARGET=Linux apps

Raspberry Pi

Prerequisites

Run this to create the SD card image (Linux+patches) and a Docker container (your build environment). Make sure that Docker is running before running this setup or it will fail and you will have to start over! This will take about an hour and will stop for input many times. It will also require you to swap the card out twice.

# Run the Docker app. It is required for docker import.
./Tools/raspi_sdcard_setup.sh

Compile

make TARGET=Raspi all

If docker doesn't find "dev-test/raspiadk-base", run the sdcard setup and make sure to do the docker import at the end of the script.

Install

After building, run this to install the build products to your RaspPi. (-n is for the hostname of your RaspPi and -p is the SSH password; both of these were chosen during the initial raspi_sdcard_setup.sh install).

./Tools/install.sh \
    -d raspi \
    -a Output/Raspi-armv6k-unknown-linux-gnueabihf/Debug/IP/Applications/Lightbulb.OpenSSL \
    -n raspberrypi \
    -p pi

Make options

Commmand Description Default
make <target>
  • apps - Build all apps
  • test - Build unit tests
  • all - Build apps and unit tests
all
make APPS=<application> Space delimited names of the apps to compile. Example:
make APPS=“Lightbulb Lock”
All applications
make BUILD_TYPE=<build_type> Build type:
  • Debug
  • Test
  • Release
Debug
make LOG_LEVEL=<level>
  • 0 - No logs are displayed
  • 1 - Error and Fault-level logs are displayed
  • 2 - Error, Fault-level and Info logs are displayed
  • 3 - Error, Fault-level, Info and Debug logs are displayed
  • 3 - For debug build
  • 1 - For test build
  • 0 - For release build
make PROTOCOLS=<protocol> Space delimited protocols supported by the applications:
  • BLE
  • IP
Example: make PROTOCOLS=“IP BLE”
All protocols
make TARGET=<platform> Build for a given target platform:
  • Darwin
  • Linux
  • Raspi
Build for the host Platform
make USE_HW_AUTH=<enable> Build with hardware authentication enabled:
  • 0 - Disable
  • 1 - Enable
Disabled
make USE_NFC=<enable> Build with NFC enabled:
  • 0 - Disable
  • 1 - Enable
Disabled
You can’t perform that action at this time.