项目简介
本项目是基于Arduino的Esp8266 Homekit固件模板。苹果公司的Homekit智能家居框架,能让开发者为智能设备创建配件并集成到iOS设备的家庭应用中。此模板为开发者提供了快速上手的平台,帮助他们创建自定义的Homekit配件。
项目的主要特性和功能
- 支持开发者创建符合自身需求的自定义Homekit配件。
- 以基本开关功能为例,便于开发者理解和修改。
- 可通过WiFi连接到路由器,实现与iOS设备的通信。
- 代码带有详细注释和说明,降低开发者理解和修改难度。
安装使用步骤
假设用户已下载本项目的源码文件:
1. 配置开发环境:
- 到Arduino官网下载对应系统版本的Arduino IDE(Windows用户也可到应用商店下载)并安装。
- 打开Arduino,Windows用户点击“文件”>“首选项”,Mac用户点击左上角“Arduino”>“Preference”,在“附加开发板管理器网址”一栏填入:https://arduino.esp8266.com/stable/package_esp8266com_index.json。
- 关闭窗口,打开“工具”>“开发板”>“开发板管理器”,搜索“esp8266”并安装。
- 关闭窗口,打开“工具”>“管理库...”,搜索“homekit”,安装“HomeKit - ESP8266”。
2. 硬件链接:把LED的正极(长的一端)连接在Esp8266开发板的IO2口上,负极(短的一端)连接在GND上。
3. 代码修改:
- 在my_accessory.c
文件中:
- 创建变量:将homrkit_characteristic_t /*变量名*/ = HOMEKIT_CHARACTERISTIC_(/*变量类型*/,/*变量初始值*/);
修改为homrkit_characteristic_t cha_on = HOMEKIT_CHARACTERISTIC_(ON, false);
。
- 配置信息:将HOMEKIT_ACCESSORY(.id=/*编号*/, .category=homekit_accessory_category_/*种类*/, .services=(homekit_service_t*[])
修改为HOMEKIT_ACCESSORY(.id=1, .category=homekit_accessory_category_switch, .services=(homekit_service_t*[])
。
- 服务设置:将HOMEKIT_SERVICE(/*服务名*/, .primary=/*是否为主服务*/, .characteristics=(homekit_characteristic_t*[]) {&/*变量名*/, NULL}),
修改为HOMEKIT_SERVICE(SWITCH, .primary=true, .characteristics=(homekit_characteristic_t*[]) {&cha_on, NULL}),
。
- 在wifi_info.h
文件中,把const char *ssid = "Your - Wifi - Name";
和const char *password = "Your - Wifi - Password";
分别替换为自己的WiFi名称和密码。
- 在Template.ino
文件中:
- 定义引脚与触发器:在your_setup
内添加pinMode(2, OUTPUT); digitalWrite(2, HIGH); cha_on.setter = cha_on_setter;
。
- 设置触发器:在最末尾添加void cha_on_setter(const homekit_value_t value) {bool on = value.bool_value; cha_on.value.bool_value = on; PRTLOG("开关状态: %s", on ? "开" : "O关"); digitalWrite(2, on ? HIGH : LOW);}
。
4. 上传程序:
- 打开Arduino,点击菜单栏中的“工具”,选择“开发板”>“ESP8266 Boards”>“Generic ESP8266 Module”。
- 再次点击菜单栏中的“工具”,将一些项目修改成如下内容:
- LwIP Variant: v2 Lower Memory
- Debug Level: 无
- Espressif FW: nonos - sdk 2.2.1+119(191122)
- SSL Support: Basic SSL ciphers (lower ROM use)
- VTables: Flash
- Erase Flash: All Flash Contents
- CPU Frequency: 160MHz
- 将ESP8266开发板连接至电脑,在“工具”菜单内选择正确的端口,点击上传按钮等待程序上传。
5. 连接验证:
- 确保手机与ESP8266处于同一Wifi内。
- 打开家庭(Home)App,点击右上角加号,点击“添加或扫描配件”。
- 点击最下方的“我没有或无法扫描代码”,若一切正常会出现配件的图标。
- 点击配件的图标,选择“仍然添加”以忽略“未认证配件”的警告。
- 输入代码“11111111”(八个1),稍等片刻即可配对成功。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】