小熊派BearPi-HM Nano鸿蒙开发板实战：从环境搭建到MQTT物联网通信

鸿蒙专家

对于希望快速入门HarmonyOS设备开发的开发者来说，小熊派BearPi-HM Nano是一款性价比极高的IoT开发板。它基于Hi3861 Wi-Fi SoC芯片，板载NFC、LED、按键、E53扩展接口等资源，配合华为DevEco Device Tool工具链，可以一站式完成代码编写、编译、烧录和调试。本文基于实际开发经验，整理从环境搭建到WiFi连接与MQTT通信的完整流程，并提炼常见问题的解决办法。

一、硬件认知与开发环境搭建
BearPi-HM Nano开发板采用三段式布局：左侧为E53扩展接口，引出GPIO、SPI、I2C、ADC、UART等引脚；中间是Hi3861主控、NFC线圈（用于“碰一碰”配网）和用户LED；右侧是USB Type-C接口（供电兼烧录）、CH340串口芯片、复位键和两个自定义按键。出厂固件上电后红色LED闪烁，若不亮需检查USB线是否为数据线。

开发环境的搭建在2024年以后有了重大简化：HUAWEI DevEco Device Tool 3.1+版本已支持纯Windows环境开发Hi3861，不再依赖Linux虚拟机。纯Windows方案的优势在于：首次编译仅需约2分30秒，一键烧录约30秒，环境配置仅三步——安装DevEco Device Tool、下载源码（推荐通过DevEco Marketplace导入hi3861_hdu_iot_application项目，SDK约413MB）、配置工具链。关键避坑点：Windows路径长度限制260字符，务必把项目放在磁盘根目录（如D:\bearpi_project），否则编译会莫名失败；首次编译会自动下载Python依赖，建议配置国内pip镜像加速。

硬件连接只需一根USB Type-C数据线即可同时实现供电、烧录和调试。烧录时需要将开发板置入烧录模式：按住复位键再上电，保持2秒，串口应打印“###HiBurn###”提示。

二、入门示例：LED闪烁与按键检测
LED控制是最基础的实验。板载红色LED连接GPIO 9，低电平点亮。以下代码使用HarmonyOS的IoTGpio接口实现500ms间隔闪烁：

2. #include "ohos_init.h"
3. #include "cmsis_os2.h"
4. #include "iot_gpio.h"
5. #include "hi_gpio.h"
6. #include "hi_io.h"
8. #define LED_GPIO_PIN 9
10. static void GpioInit(void)
11. {
12.     IoTGpioInit(LED_GPIO_PIN);
13.     IoTGpioSetDir(LED_GPIO_PIN, IOT_GPIO_DIR_OUT);
14. }
16. static void LED_Task(void *arg)
17. {
18.     (void)arg;
19.     GpioInit();
20.     while (1) {
21.         IoTGpioSetOutputVal(LED_GPIO_PIN, IOT_GPIO_VALUE0);  // 点亮
22.         osDelay(50);  // 500ms (10ms × 50)
23.         IoTGpioSetOutputVal(LED_GPIO_PIN, IOT_GPIO_VALUE1);  // 熄灭
24.         osDelay(50);
25.     }
26. }
28. static void LED_Entry(void)
29. {
30.     osThreadAttr_t attr = {
31.         .name = "LED_Task",
32.         .stack_size = 4096,
33.         .priority = osPriorityNormal,
34.     };
35.     osThreadNew(LED_Task, NULL, &attr);
36. }
38. SYS_RUN(LED_Entry);

复制代码

代码要点：SYS_RUN()宏使任务在系统启动时自动执行；osDelay()的参数单位是10ms；LED采用低电平驱动设计。

按键检测采用中断方式。KEY1连接GPIO 5，下降沿触发。示例代码在按键按下时翻转LED状态并打印计数值：

2. #include "ohos_init.h"
3. #include "cmsis_os2.h"
4. #include "iot_gpio.h"
5. #include "hi_gpio.h"
7. #define KEY1_GPIO 5
8. #define LED_GPIO 9
10. static uint32_t key_press_count = 0;
12. static void Key1_ISR(uint32_t gpioIrqNum)
13. {
14.     (void)gpioIrqNum;
15.     key_press_count++;
16.     printf("[KEY] Button pressed! Count: %u\r\n", key_press_count);
17.     static uint8_t led_state = 0;
18.     led_state = !led_state;
19.     IoTGpioSetOutputVal(LED_GPIO, led_state ? IOT_GPIO_VALUE1 : IOT_GPIO_VALUE0);
20. }
22. static void GpioInterruptInit(void)
23. {
24.     IoTGpioInit(KEY1_GPIO);
25.     IoTGpioInit(LED_GPIO);
26.     IoTGpioSetDir(KEY1_GPIO, IOT_GPIO_DIR_IN);
27.     IoTGpioSetDir(LED_GPIO, IOT_GPIO_DIR_OUT);
28.     IoTGpioRegisterIsrFunc(KEY1_GPIO, IOT_INT_TYPE_EDGE, IOT_GPIO_EDGE_FALL_LEVEL_LOW, Key1_ISR, NULL);
29. }
31. static void KeyDemo_Entry(void)
32. {
33.     GpioInterruptInit();
34.     printf("[KEY Demo] Started. Press KEY1 to toggle LED.\r\n");
35. }
37. SYS_RUN(KeyDemo_Entry);

复制代码

调试时可用MobaXterm或PuTTY连接串口，波特率115200，观察按键计数信息。

三、进阶示例：WiFi STA连接与MQTT通信
物联网项目首先需要联网。Hi3861支持STA模式连接到无线路由器。以下代码演示完整流程：注册WiFi事件、使能WiFi、添加热点配置并连接、等待连接成功、获取网络接口并启动DHCP。等待连接超时设置为15秒，DHCP等待约3秒。

2. #include "ohos_init.h"
3. #include "cmsis_os2.h"
4. #include "hi_wifi_api.h"
5. #include "lwip/netifapi.h"
6. #include "lwip/sockets.h"
7. #include <string.h>
9. #define WIFI_SSID "YourSSID"
10. #define WIFI_PASSWORD "YourPassword"
12. static volatile int g_connect_success = 0;
13. static struct netif *g_lwip_netif = NULL;
15. static void WifiConnectionHandler(uint8_t state, WifiLinkedInfo *info)
16. {
17.     (void)info;
18.     if (state == WIFI_STATE_CONNECTED) {
19.         printf("[WiFi] Connected to AP successfully!\r\n");
20.         g_connect_success = 1;
21.     } else {
22.         printf("[WiFi] Disconnected, state: %d\r\n", state);
23.     }
24. }
26. static void WifiScanDoneHandler(uint8_t state, uint8_t size)
27. {
28.     (void)state;
29.     printf("[WiFi] Scan finished, found %d APs\r\n", size);
30. }
32. static int WiFiConnect(void)
33. {
34.     int ret;
35.     WifiEvent event = {
36.         .onWifiConnectionChanged = WifiConnectionHandler,
37.         .onWifiScanStateChanged = WifiScanDoneHandler,
38.     };
39.     ret = RegisterWifiEvent(&event);
40.     if (ret != WIFI_SUCCESS) return -1;
42.     ret = EnableWifi();
43.     if (ret != WIFI_SUCCESS) return -1;
45.     WifiDeviceConfig config = {0};
46.     strncpy(config.ssid, WIFI_SSID, sizeof(config.ssid) - 1);
47.     strncpy(config.password, WIFI_PASSWORD, sizeof(config.password) - 1);
48.     int networkId = -1;
49.     ret = AddDeviceConfig(&config, &networkId);
50.     if (ret != WIFI_SUCCESS || networkId < 0) return -1;
52.     ret = ConnectTo(networkId);
53.     if (ret != WIFI_SUCCESS) return -1;
55.     int wait_count = 0;
56.     while (!g_connect_success && wait_count < 150) {
57.         usleep(100000);
58.         wait_count++;
59.     }
60.     if (!g_connect_success) return -1;
62.     g_lwip_netif = netifapi_netif_find("wlan0");
63.     if (g_lwip_netif == NULL) return -1;
65.     netifapi_netif_set_default(g_lwip_netif);
66.     dhcp_start(g_lwip_netif);
68.     for (int i = 0; i < 30; i++) {
69.         osDelay(20);
70.         if (dhcp_is_bound(g_lwip_netif) == ERR_OK) {
71.             ip4_addr_t ip, gw, mask;
72.             netifapi_netif_get_addr(g_lwip_netif, &ip, &netmask, &gw);
73.             printf("[WiFi] IP: %s\r\n", ip4addr_ntoa(&ip));
74.             return 0;
75.         }
76.     }
77.     return -1;
78. }
80. // 在任务中调用WiFiConnect，成功后即可进行网络操作

复制代码

WiFi连接成功后，即可实现MQTT客户端。以下代码使用Eclipse Paho MQTT C客户端库，连接公共MQTT服务器broker.emqx.io:1883，订阅bearpi/control主题，并每隔2秒向bearpi/temperature发布模拟的传感器数据（JSON格式）。注意MQTT任务栈空间需设置为8192字节。

2. // 包含MQTTClient.h等
3. #define MQTT_SERVER_IP "broker.emqx.io"
4. #define MQTT_SERVER_PORT 1883
5. #define MQTT_CLIENT_ID "BearPi_Hi3861"
6. #define MQTT_TOPIC_PUB "bearpi/temperature"
7. #define MQTT_TOPIC_SUB "bearpi/control"
9. static MQTTClient mqtt_client;
10. static Network mqtt_network;
11. static unsigned char mqtt_send_buf[1024];
12. static unsigned char mqtt_recv_buf[1024];
14. static void mqtt_message_arrived(MessageData *msg_data)
15. {
16.     if (msg_data == NULL) return;
17.     printf("[MQTT] Received from topic '%.*s': %.*s\r\n",
18.            msg_data->topicName->lenstring.len,
19.            msg_data->topicName->lenstring.data,
20.            msg_data->message->payloadlen,
21.            (char *)msg_data->message->payload);
22. }
24. static void MqttTask(void)
25. {
26.     NetworkInit(&mqtt_network);
27.     if (NetworkConnect(&mqtt_network, MQTT_SERVER_IP, MQTT_SERVER_PORT) != 0) {
28.         printf("[MQTT] Network connect failed\r\n");
29.         return;
30.     }
31.     MQTTClientInit(&mqtt_client, &mqtt_network, 3000, mqtt_send_buf, sizeof(mqtt_send_buf), mqtt_recv_buf, sizeof(mqtt_recv_buf));
32.    
33.     MQTTPacket_connectData connectData = MQTTPacket_connectData_initializer;
34.     connectData.keepAliveInterval = 30;
35.     connectData.cleansession = 1;
36.     connectData.clientID.cstring = MQTT_CLIENT_ID;
37.     connectData.username.cstring = "demo";
38.     connectData.password.cstring = "demo";
39.    
40.     if (MQTTConnect(&mqtt_client, &connectData) != SUCCESS) {
41.         NetworkDisconnect(&mqtt_network);
42.         return;
43.     }
44.     MQTTSubscribe(&mqtt_client, MQTT_TOPIC_SUB, QOS1, mqtt_message_arrived);
45.    
46.     int msg_count = 0;
47.     while (1) {
48.         float temperature = 25.0f + (msg_count % 20) * 0.5f;
49.         char payload[64];
50.         snprintf(payload, sizeof(payload), "{"device":"%s","temp":%.1f,"humidity":%.1f}", MQTT_CLIENT_ID, temperature, 60.0f + msg_count % 30);
51.         MQTTMessage message = { .qos = QOS1, .retained = 0, .payload = payload, .payloadlen = strlen(payload) };
52.         MQTTPublish(&mqtt_client, MQTT_TOPIC_PUB, &message);
53.         osDelay(200);  // 2秒
54.         msg_count++;
55.     }
56. }
58. // 使用SYS_RUN或创建任务启动MqttTask

复制代码

测试时可在PC端使用MQTTX客户端订阅相同主题，验证设备上报的数据。

四、I2C传感器读取（BH1750光照强度）
开发板的E53接口支持I2C通信。以BH1750为例，初始化I2C0（400KHz），发送连续高分辨率模式命令（0x10），等待150ms后读取2字节数据，换算公式为：光照强度(lux) = raw / 1.2。

2. #include "hi_i2c.h"
3. #define BH1750_ADDR 0x23
4. #define BH1750_CON_H 0x10
6. static void I2C_Init(void)
7. {
8.     hi_i2c_init(HI_I2C_IDX_0, 400000);
9. }
11. static int BH1750_ReadLux(float *lux)
12. {
13.     hi_u8 send_data[1] = {BH1750_CON_H};
14.     hi_u8 recv_data[2] = {0};
15.     if (hi_i2c_write(HI_I2C_IDX_0, BH1750_ADDR, send_data, 1) != HI_ERR_SUCCESS) return -1;
16.     usleep(150000);
17.     if (hi_i2c_read(HI_I2C_IDX_0, BH1750_ADDR, NULL, recv_data, 2) != HI_ERR_SUCCESS) return -1;
18.     hi_u16 raw = (recv_data[0] << 8) | recv_data[1];
19.     *lux = raw / 1.2f;
20.     return 0;
21. }

复制代码

五、常见问题速查
1. 编译报错“toolchain not found”：检查DevEco Device Tool中compiler_bin_path是否指向DevTools_Hi3861V100_v1.0文件夹。
2. 烧录失败“Failed to connect device”：确保开发板进入烧录模式——按住复位键上电后保持2秒，串口输出“###HiBurn###”。
3. WiFi连接成功但无法获取IP：确认路由器开启DHCP；或手动设置静态IP：netifapi_netif_set_addr(g_lwip_netif, &ipaddr, &netmask, &gw)。
4. MQTT连接失败：先确保WiFi已连通且获取到IP；检查服务器地址端口；部分企业网络需使用WebSocket或配置代理。

小熊派BearPi-HM Nano开发板虽然资源有限，但覆盖了Wi-Fi、NFC、GPIO、I2C、SPI、UART等物联网核心能力，配合丰富的E53扩展板和社区例程，是入门HarmonyOS设备开发的理想选择。以上示例代码均可在DevEco Device Tool中直接编译运行，帮助开发者快速实现从LED控制到云端对接的完整项目。

热心网友1

感谢楼主的详细分享！小熊派BearPi-HM Nano这个板子确实很适合入门鸿蒙设备开发，尤其你提到的纯Windows环境搭建方案，省去了装虚拟机的麻烦，对新手太友好了。LED和按键的示例代码也很清晰，我打算照着试一下。 不过帖子在WiFi STA和MQTT通信那里刚好截断了，有点意犹未尽。想请教一下，MQTT部分具体是用的哪个云平台？有没有遇到连接不稳定或者证书加载的问题？如果方便的话，希望能再补充一下MQTT通信的完整流程，比如如何配置WiFi、MQTT客户端的初始化代码，以及和板子上的传感器结合的例子。期待更新！