ESP32 - HomeKit Demo

REPRODUCTION STEPS

Open a terminal window on your mac.

docker pull espressif/idf:latest

• At this point idf (ESP-IDF v5.3-dev-2032-g4d90eedb6e)

git clone --recursive https://github.com/AchimPieters/esp32-homekit-demo.git

docker run -it -v ~/esp32-homekit-demo:/project -w /project espressif/idf:latest

cd examples/led

idf.py set-target esp32

idf.py menuconfig

• Select Serial flasher config and then Flash size (2MB) set to 4MB
• Select Partition table and then Partition Table(Single factory app, no OTA) Set to Custom partition table CSV
• Select StudioPieters and then (mysid) WIFI SSID and fill in your Wi-Fi Network name, then Select (mypassword) WiFI Password and fill in your Wi-Fi Network password.
• Then press ESC until you are asked Save Configuration? and select (Y)es

idf.py build

Open a new terminal window on your mac.

cd esp32-homekit-demo/examples/led

esptool.py erase_flash

esptool.py -p /dev/tty.usbserial-01FD1166 -b 460800 --before default_reset --after hard_reset --chip esp32  write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin 0x10000 build/main.bin

• Replace /dev/tty.usbserial-01FD1166 with your USB port.

screen /dev/tty.usbserial-01FD1166 115200

• Replace /dev/tty.usbserial-01FD1166 with your USB port.

	ESP32 Series	ESP32-C2 Series	ESP32-C3 Series	ESP32-C6 Series	ESP32-S2 Series	ESP32-S3 Series	ESP32-H2 Series
LED
LOCK
PROGRAMMABLE SWITCH
SWITCH
SECURITY SYSTEM
TEMPERATURE SENSOR
THERMOSTAT
OUTLET
LIGHT
LIGHT STRIP RGB
LIGHT STRIP RGBW
WINDOW COVERING
FAN
GARAGE DOOR OPENER
LIGHT SENSOR
MOTION SENSOR

HOMEKIT ACCESSORY CATEGORY	NUMBER
Other	1
Bridges	2
Fans	3
Garage door openers	4
Lighting	5
Locks	6
Outlets	7
Switches	8
Thermostats	9
Sensors	10
Security systems	11
Doors	12
Windows	13
Window coverings	14
Programmable switches	15
Range extenders	16
IP cameras	17
Video door bells	18
Air purifiers	19
Heaters	20
Air conditioners	21
Humidifiers	22
Dehumidifiers	23
Apple tv	24
Speakers	26
Airport	27
Sprinklers	28
Faucets	29
Shower heads	30
Televisions	31
Target remotes	32

_{^{-------------------------------------------------------------------------------------------------------------------------------------}}
WORKS WITH APPLE HOME BADGE

^{The Works with Apple Home badge can be used to visually communicate that your accessory is compatible with the Apple Home and Siri on Apple devices. If you plan to develop or manufacture a HomeKit accessory that will be distributed or sold, your company needs to be enrolled in the MFi Program.}

_{^{-------------------------------------------------------------------------------------------------------------------------------------}}
SAFETY

_{Technology and the laws and limitations imposed by manufacturers and content owners are constantly changing. Thus, some of the projects described may not work, may be inconsistent with current laws or user agreements, or may damage or adversely affect some equipment. Your safety is your own responsibility, including proper use of equipment and safety gear, and determining whether you have adequate skill and experience. Power tools, electricity, and other resources used for these projects are dangerous, unless used properly and with adequate precautions, including safety gear. Some illustrative photos do not depict safety precautions or equipment, in order to show the project steps more clearly. These projects are not intended for use by children. Use of the instructions, kits, projects and suggestions on StudioPieters.nl is at your own risk. StudioPieters® disclaims all responsibility for any resulting damage, injury, or expense. It is your responsibility to make sure that your activities comply with applicable laws, including copyright.Always check the webpage associated with each project before you get started. There may be important updates or corrections! The United States Fire Administration (USFA) has a guide and many simple steps you can take to prevent the loss of life and property resulting from electrical fires. StudioPieters® is not responsible for your product function or certification if you choose to use our products in your design.}

_{^{-------------------------------------------------------------------------------------------------------------------------------------}}

ORIGINAL PROJECT

^{MIT LICENCE}

_{Copyright © 2017 Maxim Kulkin | ESP-Homekit-demo}

_{Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:}

_{The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software}

_{THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}

_{^{-------------------------------------------------------------------------------------------------------------------------------------}}

APPLE HOME

_{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 Apple Inc. All rights reserved.}