利用ESPHome+ESP8266，使用舵机将房屋顶灯控制开关接入HA+Homekit教程

一、所需材料及环境准备

HomeAssistant环境，可运行在路由器/Windows电脑/树莓派等平台上，本文不再赘述，教程自行Google/Baidu
具有Wifi模块，usb接口的ESP开发板，包括ESP32，ESP8266等，本教程以ESP8266 NodeMCU（CH340）开发版为例
SG90或其他180度舵机
一台电脑，装有python3/pip3，本文以macOS为例。且需已安装CH340或CP2102芯片的对应驱动，可详询你购买开发板的卖家
数据线，固定舵机所需如尼龙扎带等杂项工具

二、具体实现步骤

（1）将ESPHome刷入开发板

电脑本地需安装ESPHome环境，在macOS终端下，用pip安装

pip3 install --user esphome

设置环境变量，注意根据自己的python路径修改

export PATH="$PATH:/Users/你的用户名/Library/Python/你的python版本/bin"

至此ESPHome面板在本地已安装结束，你需要新建一个任意一个你希望存放其配置文件的目录，并在终端内cd到该目录，并启动

如：

cd /Users/alexwei/Developer/ESPhome_demo

esphome dashboard demo1/

当看到以下提示时，说明安装已成功

2024-06-15 22:01:10,062 INFO Starting dashboard web server on http://0.0.0.0:6052 and configuration dir demo1/...

此时，在浏览器内打开http://localhost:6052/

可以看到ESPHome的本地管理页面（注意在接下来的操作中，请勿关闭终端窗口，请保持后台运行）

点击右下角的+ NEW DEVICE，随便设定一个名字比如light，继续

注意此处不要着急安装，亲测大概率会失败，原因未知，先SKIP后续再安装即可成功

选择对应的芯片型号，比如ESP8266

接下来再开始安装，按照指引进行即可

（2）修改并写入配置文件

点击EDIT，进入配置页面，将以下配置文件复制粘贴替换全部，记得对应修改自己的wifi ssid和密码

# board需要对应你的板子型号，否则可能无法写入，请注意
esphome:
  name: light
  platform: ESP8266
  board: nodemcuv2


logger:

# key可自行修改，用于连接HA
api:
  encryption:
    key: "VmM7VolyYLNgJ3xf8PUNFbLFyFWa+/UjvzIVw9nax+4="
  services:
    - service: control_servo
      variables:
        position: float
      then:
        - servo.write:
            id: my_servo
            level: !lambda 'return position / 180.0;'
        - delay: 1s
        - servo.write:
            id: my_servo
            level: !lambda 'return 90.0 / 180.0;'
            
ota:
  password: "8784b54c881cbd425f828e64b942d84e"

wifi:
  ssid: your_ssid #必须2.4Ghz，不可用5G Wi-Fi
  password: your_password


  ap:
    ssid: "Light Fallback Hotspot"
    password: "ATXaqZu1fTpK"

servo:
  - id: my_servo
    output: pwm_output
    min_level: 2.5%  # 调整最小脉宽信号
    max_level: 12.5%  # 调整最大脉宽信号

#pin可按照实际接线情况修改
output:
  - platform: esp8266_pwm
    id: pwm_output
    pin: D4
    frequency: 50 Hz

#角度可按照实际情况进行修改
switch:
  - platform: template
    name: "Light Switch"
    turn_on_action:
      - servo.write:
          id: my_servo
          level: !lambda 'return (90.0 + 90.0) / 180.0;'
      - delay: 1s
      - servo.write:
          id: my_servo
          level: !lambda 'return 90.0 / 180.0;'
    turn_off_action:
      - servo.write:
          id: my_servo
          level: !lambda 'return (90.0 - 90.0) / 180.0;'
      - delay: 1.1s
      - servo.write:
          id: my_servo
          level: !lambda 'return 92.0 / 180.0;'