基於 ESP32S3-R8N16 開發板的 HomeKit 亮燈

1
#ifndef DEV_SINGLELED_H
2
#define DEV_SINGLELED_H
3
#include "HomeSpan.h" // 需自行在 PlatformIO 中安裝 HomeSpan 庫
4

5
struct Dev_SingleLED: Service::LightBulb {
6
    int led_pin; // led 的接腳
7
    SpanCharacteristic *is_on; // 判斷燈的狀態：打開/關閉
8

9
    // 建構子
10
    Dev_SingleLED(int led_pin): Service::LightBulb() {
11
        this->led_pin = led_pin;
12
        is_on = new Characteristic::On();
13
        pinMode(led_pin, OUTPUT);
14
    }
15

16
    // Update 函式
17
    boolean update() override {
18
        digitalWrite(led_pin, is_on->getNewVal<int>()); // 從 HomeSpan 獲取狀態
19
        return true;
20
    }
21
};
22

23
#endif //DEV_SINGLELED_H

1
#include "HomeSpan.h"
2
#include "Dev_SingleLED.h"
3

4
void setup() {
5
    // 啟動 Serial Monitor
6
    // 這裡的波特率需要與 platformio.ini 中的 monitor_speed 相同
7
    Serial.begin(115200);
8

9
    // 啟動 homespan
10
    // Category::Lighting 是燈光類別
11
    // "測試用 LED 燈" 是這個 HomeSpan 的名稱，會顯示在 Home App 中
12
    homeSpan.begin(Category::Lighting, "測試用 LED 燈");
13

14
    // HAP 附件資料庫
15
    // 順序非常重要，一定是先 SpanAccessory，再 Service，最後 Characteristic。或許加上縮排會好理解一些。Service 是從屬於 SpanAccessory 的，Characteristic 又是從屬於 Service 的。一個 SpanAccessory 就代表一個 HomeKit 附件。
16
    new SpanAccessory();
17
    // AccessoryInformation 這個 Service 是必須的，主要是後面的 Characteristic::Identify() 特徵是必須的，這個特徵用來識別 HomeKit 附件。
18
    new Service::AccessoryInformation();
19
    new Characteristic::Identify();
20
    // 新增燈泡服務
21
    // Dev_SingleLED 是我們自定義的燈泡服務結構體
22
    // 接腳號碼為 11，需提前連結好硬體電路，串連 LED 和 1k 歐電阻，並將一端接到 GPIO 11 接腳，另一腳接 GND。
23
    new Dev_SingleLED(11);
24
}
25

26
void loop() {
27
    // 啟動 HomeSpan
28
    homeSpan.poll();
29
}