【Follow me第二季第2期】开发板通过 MQTT 协议接入 Home Assistant

lijinlei

【Follow me第二季第2期】开发板通过 MQTT 协议接入 Home Assistant [复制链接]

# 【Follow me第二季第2期】开发板通过 MQTT 协议接入 Home Assistant

根据任务要求，完成环境搭建和开发板接入。具体包括

1. Docker 安装（Linux系统环境）
2. HomeAssistant安装
3. EMQX服务器安装
4. MQTT协议连接
5. 开发板连接

## 一、简介

介绍本任务使用的平台和协议，包括 MQTT协议、EMQX服务器、HomeAssistant.

### 1. MQTT

**[MQTT](https://www.emqx.com/zh/blog/the-easiest-guide-to-getting-started-with-mqtt)**（Message Queuing Telemetry Transport）即消息队列遥测传输协议，是一种基于 `publish/subscribe` (发布/订阅) 模式的 **轻量级** 通讯协议，适用于资源受限的设备下使用，特别是嵌入式领域。该协议构建于 **TCP/IP** 协议上，由 IBM 在1999年发布。

MQTT 最大优点在于，**用极少的代码和有限的带宽，为连接远程设备提供实时可靠的消息服务** 。

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846648" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846648&handlekey=savephoto_846648">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

#### MQTT 工作流程

1. 客户端建立连接

2. 客户端发布消息，或订阅主题以接收消息

3. MQTT Broker 接收发布的信息

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846649_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>MQTT通信.jpg</strong> <em class="xg1">(29.2 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846649" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846649&handlekey=savephoto_846649">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

在本项目中，Arduino UNO R4 WiFi 开发板是发布者（Publisher），主题是温湿度传感器（Sensor），子级别是温度（Temperature）和湿度（Humidity），接收者为 HomeAssistant .

#### 其他

QoS (Quality of Service levels) 即服务质量级别，一般设置为 0 ，等级越高，传输越复杂。

##### MQTT 数据包结构

**固定头 Eixed header** 包含消息类型 message type，标识位 DUP，QoS Level，RET，剩余长度 remain length .

**可变头 Variable header**

**消息体 Payload**

包括 CONNECT, SUBSCRIBE, SUBACK, UNSUBSCRIBE 四种类型

- `CONNECT`，消息体内容主要包括：客户端 ClientID、订阅 Topic、Message、用户名和密码
- `SUBSCRIBE`，消息体内容是一系列订阅主题以及 `QoS` ；
- `SUBACK`，消息体内容是服务器对于`SUBSCRIBE` 所申请的主题及 `QoS` 进行确认和回复。
- `UNSUBSCRIBE`，消息体内容是要订阅的主题。

#### MQTT 服务器搭建

目前MQTT代理的主流平台有下面几个：

- [Mosquitto](https://mosquitto.org/) 
- [VerneMQ](https://vernemq.com/) 
- [EMQX](https://www.emqx.com/zh)

[免费的公共 MQTT 服务器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker) （仅用于测试，请勿在生产环境中使用）该服务器信息

- **Broker 地址：**broker.emqx.io
- **TCP 端口：**1883
- **WebSocket端口：**8083
- **SSL/TLS 端口：**8883
- **WebSocket Secure 端口：**8084
- **QUIC 端口：**14567
- **CA 证书文件：**[broker.emqx.io-ca.crt](https://assets.emqx.com/data/broker.emqx.io-ca.crt)

这里我们使用本地计算机 Docker 容器安装的 **EMQX** 服务器作为 MQTT 的代理平台，安装步骤将在下一章节进行介绍。

### 2. EMQX

[EMQX](https://www.emqx.com/zh) 是一款全球下载量超千万的大规模分布式物联网 MQTT 服务器，单集群支持 1 亿物联网设备连接，消息分发时延低于 1 毫秒。为高可靠、高性能的物联网实时数据移动、处理和集成提供动力，助力企业构建关键业务的 IoT 平台与应用。

### 3. Home Assistant

[Home Assistant](https://www.home-assistant.io/) 家庭助理，HA，是一款基于 Python 的智能家居开源系统，可以方便地连接各种外部设备，如智能设备、摄像头、邮件、短消息、云服务等，支持众多品牌的智能家居设备，按照自己的需求手动或自动化地联动这些外部设备，构建随心所欲的智慧空间。

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846650_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>HomeAssistantWeb.png</strong> <em class="xg1">(66.25 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846650" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846650&handlekey=savephoto_846650">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

## 二、方案

### 1. Home Assistant

#### 安装

使用 [Docker](https://www.docker.com/) 容器安装 [Home Assistant](https://www.home-assistant.io/) ,

1. 下载 [Docker](https://www.docker.com/) 软件；

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846651_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>Docker下载安装.png</strong> <em class="xg1">(49.29 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846651" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846651&handlekey=savephoto_846651">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

2. C 盘根目录新建文件夹 `homeassistant` ；

3. 下载部署文件 [GitHub](https://gist.github.com/peyanski/4d803963e890955886d40ae00d1cfb90) 并解压得到 `docker-compose.yml` 保存至上述 `homeassistant` 文件夹；

4. Windows 打开 `命令提示符` 或 `Windows PowerShell`，输入如下代码实现自动下载镜像

```powershell
cd C:\homeassistant
docker-compose.yml
docker-compose up
```

5. 安装过程需大约 30 分钟，即可在 Docker 容器中创建 Home Assistant 镜像；

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846652_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>Docker镜像.png</strong> <em class="xg1">(42.68 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846652" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846652&handlekey=savephoto_846652">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

5. 自动从镜像安装 Home Assistant 到容器

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846653_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>Docker容器.png</strong> <em class="xg1">(53.43 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846653" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846653&handlekey=savephoto_846653">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

该代码 `docker-compose.yml` 将映射 Home Assistant 配置文件到 `C:/homeassistant` 文件夹；

5. 浏览器输入网址 `http://localhost:8123/` 进入Home Assistant 主界面，创建智能家居账号。

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846654_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>进入HomeAssistant.png</strong> <em class="xg1">(49.14 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846654" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846654&handlekey=savephoto_846654">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

详见：[Docker run Home Assistant in Windows](https://peyanski.com/home-assistant-container-on-windows-using-docker/) .

### 2. EMQX

[EMQX](https://www.emqx.com/zh) 是一款全球下载量超千万的大规模分布式物联网 MQTT 服务器，单集群支持 1 亿物联网设备连接，消息分发时延低于 1 毫秒。为高可靠、高性能的物联网实时数据移动、处理和集成提供动力，助力企业构建关键业务的 IoT 平台与应用。

#### (1) 安装 EMQX

使用 EMQX 最简单的方式是在 [EMQX Cloud](https://www.emqx.com/zh/cloud) 上创建完全托管的 MQTT 服务。

这里我们使用 Docker 运行 EMQX

Windows 命令行或 PowerShell 输入并执行如下代码

```powershell
docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest
```

等待进度条下载和部署完成（大约5分钟），即可获得 EMQX 服务器。

> Docker 内的 `localhost` 或 `127.0.0.1` 指向的是容器内部地址，如需访问宿主机地址请使用宿主机的真实 IP .

详见：[Gitee](https://gitee.com/emqx/emqx) .

#### (2) 配置 EMQX

（1）浏览器打开网址 `http://localhost:18083/` ，初始登录账户名 `admin` 密码 `public` ；

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846655_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>EMQX进入界面.png</strong> <em class="xg1">(44.59 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846655" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846655&handlekey=savephoto_846655">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

（2）依次打开 `访问控制` - `客户端认证` - `创建` - `Password-Based` - `内置数据库` - （默认配置）- `创建` ；

（3）`用户管理` - `新建用户` - 自定义用户名和密码（建议 admin）.

#### (3) 连接 EMQX 与 HA

（1）命令行或 PowerShell 输入 `ipconfig` 获取本地计算机 IPv4 地址，如 `42.34.25.153`

（2）配置 Home Assistant ，依次点击设置 - 设备与服务 - 添加集成 - 搜索 MQTT - 填写代理信息。

> 代理栏输入计算机 IP 地址，端口 1883，用户名和密码为 EMQX 中创建的用户信息。

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846656_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>连接MQTT.png</strong> <em class="xg1">(65.56 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846656" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846656&handlekey=savephoto_846656">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

（3）点击 `提交` 后显示 `成功创建 MQTT` ，此时 `集成` 选项下出现 `MQTT` 条目，EMQX 网页 `集群` 的 `总连接数` 和 `在线连接数` 由 `0` 变为 `1`，表明 MQTT 设备已连接。

参考：[MQTT 连入 Home Assistant](https://bbs.eeworld.com.cn/thread-1294158-1-1.html) .

#### (4) 测试 EMQX

新建连接分别作为发送端和接收端，参数设置如下

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846657_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>测试EMQX.png</strong> <em class="xg1">(32.74 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846657" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846657&handlekey=savephoto_846657">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

用户可以是同一个，也可以是不同的用户，需要在 EMQX 网页界面 `客户端认证` - `用户管理` - `新建用户`

接收端点击 `添加订阅` 自定义 Topic，如 `test` ，其他选项默认即可

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846667" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846667&handlekey=savephoto_846667">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

点击右上角分别 `连接` 发送端和接收端，在发送端对话窗口 Topic 栏输入接收端订阅名称 `test` ，在对话框中输入代码并点击发送，

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846658_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>MQTTX发送测试.png</strong> <em class="xg1">(27.2 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846658" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846658&handlekey=savephoto_846658">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

接收端将收到相同的信息

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846659_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>接收端信息.png</strong> <em class="xg1">(28.01 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846659" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846659&handlekey=savephoto_846659">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

至此测试表明我们搭建的 EMQX 客户端可以实现正常的信息发送与接收功能，为后面连接 Arduino UNO R4 WiFi 开发板并上传传感器数据奠定基础。

MQTT 协议根据 `主题` 来转发消息，主题通过 `/` 来区分层级，如 `chat/room/first` , `sensor/+/temperature` .

详见：[MQTT 客户端工具演示](https://docs.emqx.com/zh/emqx/latest/messaging/publish-and-subscribe.html) 和 [MQTT 协议入门：基础知识和快速教程](https://www.emqx.com/zh/blog/the-easiest-guide-to-getting-started-with-mqtt) .

#### (5) 测试 EMQX 与 HA

进入 Home Assistant `设置` - `设备与服务` - `MQTT` - `配置` 界面

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846660_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>MQTT测试.png</strong> <em class="xg1">(40.97 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846660" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846660&handlekey=savephoto_846660">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

依次设置 `发送端主题`、`监听端主题`、点击 `开始监听`、输入传输信息、点击 `发送`，若监听对话框弹出发送端发送的信息，则表明发送端与接收端连接成功。

详见：[MQTT协议](https://zhuanlan.zhihu.com/p/421109780) .

#### (6) 连接开发板

测试远程服务器的连通效果后，下一步便是将开发板与 EMQX 服务器连接，并上传数据至客户端和 Home Assistant 平台。

**具体操作**

打开 Arduino IDE ，安装 `ArduinoMqttClient.h` 库文件

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846663_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>ArduinoMqttClient.png</strong> <em class="xg1">(38.76 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846663" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846663&handlekey=savephoto_846663">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

打开该库文件的例程 `WiFiSimpleSender.ino` ，并对其进行修改，用于上传数据

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846661_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>ArduinoIDE_MQTTClient.png</strong> <em class="xg1">(27.12 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846661" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846661&handlekey=savephoto_846661">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

**代码**

```c++
#include <ArduinoMqttClient.h>
#if defined(ARDUINO_SAMD_MKRWIFI1010) || defined(ARDUINO_SAMD_NANO_33_IOT) || defined(ARDUINO_AVR_UNO_WIFI_REV2)
#include <WiFiNINA.h>
#elif defined(ARDUINO_SAMD_MKR1000)
#include <WiFi101.h>
#elif defined(ARDUINO_ARCH_ESP8266)
#include <ESP8266WiFi.h>
#elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_NICLA_VISION) || defined(ARDUINO_ARCH_ESP32) || defined(ARDUINO_GIGA) || defined(ARDUINO_OPTA)
#include <WiFi.h>
#elif defined(ARDUINO_PORTENTA_C33)
#include <WiFiC3.h>
#elif defined(ARDUINO_UNOR4_WIFI)
#include <WiFiS3.h>
#endif

#include "arduino_secrets.h"
///////please enter your sensitive data in the Secret tab/arduino_secrets.h
char ssid[] = SECRET_SSID;  // your network SSID (name)
char pass[] = SECRET_PASS;  // your network password (use for WPA, or use as key for WEP)

// To connect with SSL/TLS:
// 1) Change WiFiClient to WiFiSSLClient.
// 2) Change port value from 1883 to 8883.
// 3) Change broker value to a server with a known SSL/TLS root certificate 
//  flashed in the WiFi module.

WiFiClient wifiClient;
MqttClient mqttClient(wifiClient);

const char broker[] = "49.52.23.140";
int  port = 1883;
const char topic[]= "UNOR4/Send";

const long interval = 1000;
unsigned long previousMillis = 0;

int count = 0;

void setup() {
//Initialize serial and wait for port to open:
Serial.begin(115200);
while (!Serial) {
  ; // wait for serial port to connect. Needed for native USB port only
}

// attempt to connect to WiFi network:
Serial.print("Attempting to connect to WPA SSID: ");
Serial.println(ssid);
while (WiFi.begin(ssid, pass) != WL_CONNECTED) {
  // failed, retry
  Serial.print(".");
  delay(5000);
}

Serial.println("You're connected to the network");
Serial.println();
Serial.println(WiFi.localIP());

// You can provide a unique client ID, if not set the library uses Arduino-millis()
// Each client must have a unique client ID
// mqttClient.setId("clientId");

// You can provide a username and password for authentication
 mqttClient.setUsernamePassword("UNOR4", "123456");

Serial.print("Attempting to connect to the MQTT broker: ");
Serial.println(broker);

if (!mqttClient.connect(broker, port)) {
  Serial.print("MQTT connection failed! Error code = ");
  Serial.println(mqttClient.connectError());

while (1);
}

Serial.println("You're connected to the MQTT broker!");
Serial.println();
}

void loop() {
// call poll() regularly to allow the library to send MQTT keep alives which
// avoids being disconnected by the broker
mqttClient.poll();

// to avoid having delays in loop, we'll use the strategy from BlinkWithoutDelay
// see: File -> Examples -> 02.Digital -> BlinkWithoutDelay for more info
unsigned long currentMillis = millis();

if (currentMillis - previousMillis >= interval) {
  // save the last time a message was sent
  previousMillis = currentMillis;

Serial.print("Sending message to topic: ");
  Serial.println(topic);
  Serial.print("temperature: ");
  Serial.println(count);
  Serial.print("humidity: ");
  Serial.println(count);

// send message, the Print interface can be used to set the message contents
  mqttClient.beginMessage(topic);
  mqttClient.print("Temperature: ");
  mqttClient.print(count);
  mqttClient.print("Humidity: ");
  mqttClient.print(count);
  mqttClient.endMessage();

Serial.println();

count++;
}
}
```

> 注意修改 `arduino_secrets.h` 中的 WiFi 账号和密码，IP 地址、端口号、发送端主题、MQTT用户名和密码。

程序下载至 Arduino UNO R4 WiFi 开发板，通过串口监视器查看发送的信息，效果如下

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846664" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846664&handlekey=savephoto_846664">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

**MQTTX 客户端测试**

新建连接，填写IP地址、EMQX服务器客户端用户名和密码，添加订阅，主题与代码中设置的一致。

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846665_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>MQTTX_UNO_test.png</strong> <em class="xg1">(40.45 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846665" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846665&handlekey=savephoto_846665">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

参考：[EMQX Platform 文档](https://docs.emqx.com/zh/cloud/latest/connect_to_deployments/esp32.html) . [ESP8266 + MQTT : LED 灯的远程控制](https://www.emqx.com/zh/blog/esp8266_mqtt_led)

### 3. 连接HA

将发送的信息显示到 Home Assistant 智能家居平台，依次选择

`设置` - `设备与服务` - `MQTT` - `配置` - `监听主题` - 输入`主题` 名称 - 点击 `开始监听`，

便可接收信息，如下图所示

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_846666_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>HA_receive_UART.png</strong> <em class="xg1">(30.45 KB, 下载次数: 0)</em></p>
<p>
<a href="javascript:;" class="loginf" >下载附件</a>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_846666" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=846666&handlekey=savephoto_846666">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>