【Follow me第二季第2期】任务汇总

lijinlei

【Follow me第二季第2期】任务汇总 [复制链接]

<i class="pstatus"> 本帖最后由 lijinlei 于 2024-9-29 14:43 编辑 </i>

# 【Follow me第二季第2期】任务汇总

非常荣幸参加 EEWorld 和 DigiKey 联合举办的[【Follow me 第二季第 2 期】](https://www.eeworld.com.cn/huodong/digikey_follow_me_2024_02/)活动，从8月26号收到物料到9月28号完成所有任务，经过一个多月的学习、思考和实践，我对这块开发板和物联网有了更深刻的理解，也在微信群里结交了很多志同道合的朋友，感谢大家的支持和帮助，感谢工作人员对参与者的大力支持。

下面我将此次活动的任务完成情况进行汇总和报告。

所有任务已在 `DigiKey得捷技术专区` 板块分别发表 `作品展示` 帖，链接如下

1. [【Follow me第二季第2期】入门环境搭建、闪灯和串口发送](https://bbs.eeworld.com.cn/thread-1291974-1-1.html) ；

2. [【Follow me第二季第2期】驱动 12*8 点阵 LED 实现图像和文字显示](https://bbs.eeworld.com.cn/thread-1294041-1-1.html) ；

3. [【Follow me第二季第2期】DAC 生成正弦波](https://bbs.eeworld.com.cn/thread-1294043-1-1.html) ；

4. [【Follow me第二季第2期】OPAMP 放大 DAC 信号](https://bbs.eeworld.com.cn/thread-1294045-1-1.html) ；

5. [【Follow me第二季第2期】ADC 采集 OPAMP 放大 DAC 信号并串口显示波形](https://bbs.eeworld.com.cn/thread-1294047-1-1.html) ；

6. [【Follow me第二季第2期】开发板通过 MQTT 协议接入 Home Assistant](https://bbs.eeworld.com.cn/thread-1294801-1-1.html) ；

7. [【Follow me第二季第2期】SHT40温湿度模块获取环境数据 ](https://bbs.eeworld.com.cn/thread-1293824-1-1.html) ；

8. [【Follow me第二季第2期】开发板读取 SHT40 数据并上传至 Home Assistant](https://bbs.eeworld.com.cn/thread-1294905-1-1.html) .

视频录制见：[【Follow me第二季第2期】-【Follow me第二季第2期】-EEWORLD大学堂](https://training.eeworld.com.cn/video/41097) .

代码工程见：[【Follow me第二季第2期】所有任务的工程源码](https://download.eeworld.com.cn/detail/lijinlei/634523) .
## 项目演示视频

<div id="player_a1db30d45bfe93d8652159782870acdb0" class="localvideo-box"></div><div class="localvideo-title">【Follow me第二期】video</div><br/>

视频节点索引如下，

**入门任务：01:24**

**基础任务：02:12**

**进阶任务：06:32**

**扩展任务：12:39**

## 硬件物料

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847814_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>Follow me 第二季第2期物料.png</strong> <em class="xg1">(14.3 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_847814" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847814&handlekey=savephoto_847814">保存到相册</a>

</p>

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

</ignore_js_op>

Arduino UNO R4 WiFi 开发板 x1

![img](https://bbs.eeworld.com.cn/data/attachment/forum/202408/29/183559u05fwvth00h4u0wn.jpg.thumb.jpg)

SHT40 温湿度传感器模块 x1

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847815_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>SHT40 module.jpg</strong> <em class="xg1">(143.75 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_847815" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847815&handlekey=savephoto_847815">保存到相册</a>

</p>

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

</ignore_js_op>

## 任务成果展示

### 入门任务：搭建环境并开启第一步Blink / 串口打印Hello EEWorld！

对应论坛贴：[【Follow me第二季第2期】入门环境搭建、闪灯和串口发送](https://bbs.eeworld.com.cn/thread-1291974-1-1.html) https://bbs.eeworld.com.cn/thread-1291974-1-1.html

#### 环境搭建

1.官网下载并安装最新版 Arduino IDE： [Software | Arduino](https://www.arduino.cc/en/software) .

![img](https://bbs.eeworld.com.cn/data/attachment/forum/202408/29/183819hriwjvdi5d50ir05.jpg.thumb.jpg)

2.运行软件，**开发板管理** 搜索 `R4` 并安装最新版程序扩展包

#### 1. 闪灯 Blink

所需板载元件：绿色LED

打开开发板示例程序，并下载程序即可

![img](https://bbs.eeworld.com.cn/data/attachment/forum/202408/29/184048fdk7v2vgjj777pj2.jpg)

##### 代码

```c++
void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
  digitalWrite(LED_BUILTIN, HIGH);  // turn the LED on (HIGH is the voltage level)
  delay(500);                      // wait for a second
  digitalWrite(LED_BUILTIN, LOW);   // turn the LED off by making the voltage LOW
  delay(500);                      // wait for a second
}
```

##### 演示

<div id="player_330c7dc71bc4a9c9ae41c6666d2c66461" class="localvideo-box"></div><div class="localvideo-title">Blink</div><br/>

#### 2. 串口通信

所用板载元件：串口通信接口，即Type-C接口和数据线

##### 代码

```c++
void setup() {
  Serial.begin(115200);
}
void loop() {
  Serial.println("Hello EEWorld!");
  delay(500);
}

```

##### 演示

### 基础任务一：驱动12x8点阵LED

对应论坛贴：[【Follow me第二季第2期】驱动 12*8 点阵 LED 实现图像和文字显示](https://bbs.eeworld.com.cn/thread-1294041-1-1.html) https://bbs.eeworld.com.cn/thread-1294041-1-1.html

所需板载元件：12*8点阵LED

通过 [LED 矩阵工具](https://ledmatrix-editor.arduino.cc/) 定义点阵 LED 并实现心形图案的显示，并点击按钮 `</>` 下载相应的 `*.h` 文件。

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847818_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>LEDmatrix_editor.png</strong> <em class="xg1">(16.67 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_847818" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847818&handlekey=savephoto_847818">保存到相册</a>

</p>

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

</ignore_js_op>

#### 流程图

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847820_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>矩阵LED流程图.png</strong> <em class="xg1">(62.49 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_847820" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847820&handlekey=savephoto_847820">保存到相册</a>

</p>

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

</ignore_js_op>

#### 代码

```c++
#include "Arduino_LED_Matrix.h"   // Include the LED_Matrix library
//#include "frames.h"               // Include a header file containing some custom icons
const uint32_t heart[] = {
	0x3184a444,
	0x44042081,
	0x100a0040
};

ArduinoLEDMatrix matrix; // Create an instance of the ArduinoLEDMatrix class

void setup() {
  Serial.begin(115200);  // Initialize serial communication at a baud rate of 115200
  matrix.begin();        // Initialize the LED matrix
}

void loop() {
  matrix.loadFrame(heart);
  delay(500);
  
  // Turn off the display
  matrix.clear();
  delay(1000);

// Print the current value of millis() to the serial monitor
  Serial.println(millis());
}
```

#### 演示

### 基础任务二：用DAC生成正弦波

对应论坛贴：[【Follow me第二季第2期】DAC 生成正弦波](https://bbs.eeworld.com.cn/thread-1294043-1-1.html) https://bbs.eeworld.com.cn/thread-1294043-1-1.html

所需器件：板载 `A0` 接口产生 DAC 信号、示波器一台、BNC 信号测试线一条、公对公杜邦线两根

#### 流程图

<ignore_js_op>

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

</p>

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

</ignore_js_op>

#### 代码

```c++
#include "analogWave.h" // Include the library for analog waveform generation

analogWave wave(DAC);   // Create an instance of the analogWave class, using the DAC pin

int freq = 3;  // in hertz, change accordingly

void setup() {
  wave.sine(freq);       // Generate a sine wave with the initial frequency. 
  // Generate square and saw wave
  //wave.square(freq);
  //wave.saw(freq);
  wave.amplitude(0.7);   // set amplitude ratio [0.0,1.0]
}

void loop() {
}
```

#### 演示

### 基础任务三：用OPAMP放大DAC信号

对应论坛贴：[【Follow me第二季第2期】OPAMP 放大 DAC 信号](https://bbs.eeworld.com.cn/thread-1294045-1-1.html) https://bbs.eeworld.com.cn/thread-1294045-1-1.html

**所需元件**：板载 `A0` 、`A1`、`A2`、`A3` 引脚接口、杜邦线若干、面包板一块、10kΩ 色环电阻两只、示波器一台、BNC 信号测试线两根

在 `minus` 和 GND 之间连接一个电阻。然后使用第二个电阻将 output 和 `minus` 连接在一起。此时在 `plus` 处输入的任何信号都将在输出引脚处以两倍振幅显示。输入信号和 Arduino 板应该共享相同的电阻和 GND .

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847822_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>circuitAmplifierWiFi.png</strong> <em class="xg1">(19.85 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_847822" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847822&handlekey=savephoto_847822">保存到相册</a>

</p>

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

</ignore_js_op>

若要将电压信号放大 4 倍，则需考虑运算放大器的放大率，主要取决于所选的电阻值。

电路接线如下图所示

<ignore_js_op>

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

</p>

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

</ignore_js_op>

<ignore_js_op>

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

</p>

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

</ignore_js_op>

#### 流程图

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847825_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>OPAMP DAC.png</strong> <em class="xg1">(128.77 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_847825" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847825&handlekey=savephoto_847825">保存到相册</a>

</p>

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

</ignore_js_op>

#### 代码

```c++
#include <OPAMP.h>
#include "analogWave.h" // Include the library for analog waveform generation

analogWave wave(DAC);

int freq = 3;

void setup () {
  // activate OPAMP, default channel 0
  // Plus: Analog A1
  // Minus: Analog A2 
  // Output: Analog A3
  OPAMP.begin();
  wave.sine(freq);
  wave.amplitude(0.3);
}

void loop() {
}
```

#### 演示

<div id="player_6e75febea400c6eaaf2ef07411d282695" class="localvideo-box"></div><div class="localvideo-title">VID_20240923_OPAMP放大器</div><br/>

### 基础任务四：用ADC采集并且打印数据到串口等其他接口可上传到上位机显示曲线

对应论坛贴：[【Follow me第二季第2期】ADC 采集 OPAMP 放大 DAC 信号并串口显示波形](https://bbs.eeworld.com.cn/thread-1294047-1-1.html) https://bbs.eeworld.com.cn/thread-1294047-1-1.html

**所需元件**：板载 `A0` 、`A1`、`A2`、`A3` 、`A4`、`A5` 引脚接口、杜邦线若干、面包板一块、10kΩ 色环电阻两只、示波器一台、BNC 信号测试线两根

结合 DAC 输出正弦波信号、OPAMP 放大 DAC 信号的相关内容，通过开发板 ADC 读取和转换模拟量为数字参量，通过 Arduino IDE 的图形串口工具上位机同时显示 OPAMP 放大前后的 DAC 信号波形。

实物连线如下图所示

<ignore_js_op>

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

</p>

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

</ignore_js_op>

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847827_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>ADC_Read_DAC_OPAMP.jpg</strong> <em class="xg1">(593.32 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_847827" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847827&handlekey=savephoto_847827">保存到相册</a>

</p>

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

</ignore_js_op>

#### 流程图

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847829_menu" style="position: absolute; display: none" disautofocus="true">
<div class="xs0">
<p><strong>OPAMP ADC UART.png</strong> <em class="xg1">(138.8 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_847829" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847829&handlekey=savephoto_847829">保存到相册</a>

</p>

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

</ignore_js_op>

#### 代码

```c++
#include <OPAMP.h>
#include "analogWave.h" // Include the library for analog waveform generation

analogWave wave(DAC);

int freq = 100;

void setup () {
  Serial.begin(250000);
  analogReadResolution(14);
  wave.sine(freq);
  wave.amplitude(0.5);
  OPAMP.begin(OPAMP_SPEED_HIGHSPEED);
}

void loop() {
  Serial.print(analogRead(A4)); // DAC output
  Serial.print(" ");
  Serial.println(analogRead(A5)); // OPAMP output
}
```

#### 演示

<div id="player_ab6e4073caafc0617d79d3e83ea492706" class="localvideo-box"></div><div class="localvideo-title">串口打印OPAMP放大信号</div><br/>

### 进阶任务：通过Wi-Fi，利用MQTT协议接入到开源的智能家居平台HA（Home Assistant）

对应论坛贴：[【Follow me第二季第2期】开发板通过 MQTT 协议接入 Home Assistant](https://bbs.eeworld.com.cn/thread-1294801-1-1.html) https://bbs.eeworld.com.cn/thread-1294801-1-1.html

所需元件：Arduino UNO R4 WiFi 开发板、type-c 数据线一根

#### 部署 HA 环境

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

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

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

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

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

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

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

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

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

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

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847830_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_847830" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847830&handlekey=savephoto_847830">保存到相册</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_847831_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_847831" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847831&handlekey=savephoto_847831">保存到相册</a>

</p>

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

</ignore_js_op>

8. 安装 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 服务器。

9. 配置 EMQX

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

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847832_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_847832" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847832&handlekey=savephoto_847832">保存到相册</a>

</p>

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

</ignore_js_op>

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

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

10. 连接 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_847837_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_847837" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847837&handlekey=savephoto_847837">保存到相册</a>

</p>

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

</ignore_js_op>

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

#### 流程图

<ignore_js_op>

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

</p>

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

</ignore_js_op>

#### 代码

```c++
/*
https://bbs.eeworld.com.cn/thread-1293010-1-1.html
*/
#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++;
  }
}
```

#### 演示

<ignore_js_op>

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

</p>

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

</ignore_js_op>

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

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

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

<ignore_js_op>

<div class="tip tip_4 aimg_tip" id="aimg_847835_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_847835" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847835&handlekey=savephoto_847835">保存到相册</a>

</p>

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

</ignore_js_op>

### 扩展任务：通过外部SHT40温湿度传感器，上传温湿度到HA，通过HA面板显示数据

对应论坛贴：[【Follow me第二季第2期】开发板读取 SHT40 数据并上传至 Home Assistant](https://bbs.eeworld.com.cn/thread-1294905-1-1.html) https://bbs.eeworld.com.cn/thread-1294905-1-1.html

**所需元件**：Arduino UNO R4 WiFi 开发板、SHT40 温湿度传感器模块一个、Type-C 数据线一根

SHT40 温湿度传感器模块测试详见论坛帖：[【Follow me第二季第2期】SHT40温湿度模块获取环境数据 ](https://bbs.eeworld.com.cn/thread-1293824-1-1.html) .

#### 流程图

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_847836" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=847836&handlekey=savephoto_847836">保存到相册</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 "Adafruit_SHT4x.h"
#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"; // IP address
int        port     = 1883; // port
const char topic[]  = "UNOR4/Send"; // MQTT topic

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

int count = 0;
Adafruit_SHT4x sht4 = Adafruit_SHT4x();
float temperature_date,humidity_date;
sensors_event_t humidity, temp;
static TwoWire& SHT_I2C_INTERFACE = Wire1; // Wire1 is the QWIIC port of Uno R4 board

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
  }

Serial.println("SHT40 test");
  if (! sht4.begin(&SHT_I2C_INTERFACE)) {
    Serial.println("Couldn't find SHT40");
    while (1) delay(1);
  }

Serial.println("Found SHT40 sensor");
  Serial.print("Serial number 0x");
  Serial.println(sht4.readSerial(), HEX);

// You can have 3 different precisions, higher precision takes longer
  sht4.setPrecision(SHT4X_HIGH_PRECISION);
  switch (sht4.getPrecision()) {
     case SHT4X_HIGH_PRECISION: 
       Serial.println("High precision");
       break;
     case SHT4X_MED_PRECISION: 
       Serial.println("Med precision");
       break;
     case SHT4X_LOW_PRECISION: 
       Serial.println("Low precision");
       break;
  }

// You can have 6 different heater settings
  // higher heat and longer times uses more power
  // and reads will take longer too!
  sht4.setHeater(SHT4X_NO_HEATER);
  switch (sht4.getHeater()) {
     case SHT4X_NO_HEATER: 
       Serial.println("No heater");
       break;
     case SHT4X_HIGH_HEATER_1S: 
       Serial.println("High heat for 1 second");
       break;
     case SHT4X_HIGH_HEATER_100MS: 
       Serial.println("High heat for 0.1 second");
       break;
     case SHT4X_MED_HEATER_1S: 
       Serial.println("Medium heat for 1 second");
       break;
     case SHT4X_MED_HEATER_100MS: 
       Serial.println("Medium heat for 0.1 second");
       break;
     case SHT4X_LOW_HEATER_1S: 
       Serial.println("Low heat for 1 second");
       break;
     case SHT4X_LOW_HEATER_100MS: 
       Serial.println("Low heat for 0.1 second");
       break;
  }

// 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(temperature_date);
    // Serial.print("humidity: ");
    // Serial.println(humidity_date);
    uint32_t timestamp = millis();
    sht4.getEvent(&humidity, &temp);// populate temp and humidity objects with fresh data
    timestamp = millis() - timestamp;

Serial.print("Temperature: "); Serial.print(temp.temperature); Serial.println(" degrees C");
    Serial.print("Humidity: "); Serial.print(humidity.relative_humidity); Serial.println("% rH");

Serial.print("Read duration (ms): ");
    Serial.println(timestamp);
    temperature_date=temp.temperature;
    humidity_date=humidity.relative_humidity;

// send message, the Print interface can be used to set the message contents
    mqttClient.beginMessage(topic);
    mqttClient.println("{");
    mqttClient.print("   \"temperature\":");
    mqttClient.print(temperature_date);
    mqttClient.println(",");
    mqttClient.print("   \"humidity\":");
    mqttClient.println(humidity_date);
    mqttClient.print("}");
    mqttClient.endMessage();

Serial.println();

count+=0.01;
  }
}
```

#### MQTT 配置信息

前面测试程序中发送的是温度和湿度数据，因此需要在 Home Assistant 中增加传感器信息。

```json
# Example configuration.yaml entry
mqtt:
  sensor:
    - name: "Temperature"
      state_topic: "UNOR4/Send"
      suggested_display_precision: 1
      unit_of_measurement: "°C"
      value_template: "{{ value_json.temperature }}"
    - name: "Humidity"
      state_topic: "UNOR4/Send"
      unit_of_measurement: "%"
      value_template: "{{ value_json.humidity }}"
```

#### 演示

<div id="player_59565787a81a5b1b2d307fcdd8f0b5e77" class="localvideo-box"></div><div class="localvideo-title">VID_20240926_183919-(online-video-cutter.com)</div><br/>

## 项目源码

视频录制见：[【Follow me第二季第2期】-【Follow me第二季第2期】-EEWORLD大学堂](https://training.eeworld.com.cn/video/41097) https://training.eeworld.com.cn/video/41097

代码工程见：[【Follow me第二季第2期】所有任务的工程源码](https://download.eeworld.com.cn/detail/lijinlei/634523) https://download.eeworld.com.cn/detail/lijinlei/634523

## 项目总结
再次感谢微信群友们的无私帮助，在大佬们的聊天对话中学到很多专业知识，开拓了视野，特别是进阶任务和扩展任务的学习，不断解决问题并最终实现目标。

HomeAssistant 的镜像下载安装、开发板和 HA 的连接等经历，极大地丰富了我对物联网的认知，也感受到自己的渺小。

在阅读手册和访问官网链接等操作时明显感受到自身基础知识的匮乏，同时也激发了不断深入学习嵌入式开发的热情。

希望该活动越办越好，也希望越来越多的电子爱好者关注和参与 Follow me 活动，共同学习、分享和成长，用科技创造美好未来。