从嵌入式到社区物联网：基于Pegasus智能家居套件的全栈实验方案

一、前言：让"小车"跑进智能家居世界

在物联网教学或个人创客实验中，我们经常面临一个问题：如何把单片机、智能家居设备与云端社区系统（如Home Assistant、JetLinks）打通？

Pegasus 智能家居开发套件为我们提供了理想的实验平台------它不仅支持 OpenHarmony 系统，还能通过 MQTT 与各类物联网平台互联。

本文将以一个"鸿蒙小车+智能家居+社区平台"的实验为主线，展示一个完整的端到端方案。

---

二、实验总体思路：三层架构

整个系统可以分为三个层次：

层次	内容	技术要点
设备层（Device）	Pegasus 开发板 / STM32 / 传感器 / 电机小车	串口通信、数据采集、指令控制
网关层（Gateway）	Serial2MQTT 网关	将串口数据转发到 MQTT Broker，实现双向控制
平台层（Cloud/Community）	Home Assistant / JetLinks / 自建 Mosquitto	统一物模型、规则引擎、可视化控制

这种结构的优势是：

• 解耦：设备与平台之间无需直接依赖协议。
• 可扩展：多个设备可通过 MQTT 主题进行管理。
• 开放性强：可对接任意社区生态，如 Home Assistant Dashboard。

---

三、Serial2MQTT ------ 串口与MQTT之间的桥梁

在实验中，很多同学卡在了"如何让 STM32 或 Pegasus 设备与 MQTT 通信"的环节。

其实完全不用重写复杂的通信协议，一个轻量级的中间件即可解决：

👉 Serial2MQTT。

1️⃣ 功能概述

Serial2MQTT 是一个常驻服务程序，用于：

• 从串口读取数据并发布到 MQTT 主题；
• 订阅 MQTT 消息并发送回串口；
• 支持多个主题（Topic）和设备映射。

2️⃣ 示例配置

假设我们有两个主题：

• xw103/home/light/set：控制灯光开关
• xw103/home/motor/set：控制小车前进后退

串口每秒上报：

{"data": {"temperature": 25.5, "humidity": 60}}

Serial2MQTT 的示例配置（Node.js 版本）如下：

import SerialPort from 'serialport';
import mqtt from 'mqtt';

// 串口与MQTT配置
const serial = new SerialPort.SerialPort({ path: 'COM10', baudRate: 115200 });
const client = mqtt.connect('mqtt://localhost:1883');

// 监听串口数据 -> 转发到MQTT
serial.on('data', (data) => {
  const msg = data.toString().trim();
  client.publish('xw103/home/sensor', msg);
  console.log('↗️ Serial -> MQTT:', msg);
});

// MQTT下行指令 -> 发给串口
['xw103/home/light/set', 'xw103/home/motor/set'].forEach((topic) => {
  client.subscribe(topic);
});

client.on('message', (topic, message) => {
  console.log('↘️ MQTT -> Serial:', topic, message.toString());
  serial.write(message.toString() + '\n');
});

这样，一个多主题双向通信的 Serial2MQTT 网关就完成了。

---

四、Home Assistant 与 JetLinks 的融合应用

🔹 Home Assistant 自动化展示

在 Home Assistant 中，我们可以通过 MQTT 集成快速接入这些主题，例如：

mqtt:
  sensor:
    - name: "室内温度"
      state_topic: "xw103/home/sensor"
      value_template: "{{ value_json.data.temperature }}"
  switch:
    - name: "客厅灯"
      command_topic: "xw103/home/light/set"
      payload_on: "ON"
      payload_off: "OFF"

配合 Lovelace 仪表盘，温湿度数据与灯光控制面板一目了然。

🔹 JetLinks 平台的数据模型

JetLinks 更适合教学和企业级展示，它通过物模型定义设备能力：

{
  "id": "pegasus_01",
  "name": "鸿蒙小车",
  "properties": [
    {"id": "temperature", "name": "温度", "type": "float"},
    {"id": "humidity", "name": "湿度", "type": "int"}
  ],
  "events": [{"id": "telemetry", "name": "遥测数据"}]
}

JetLinks 可以直接作为 MQTT 客户端接入现有的 Mosquitto，从而统一管理多个家庭设备，提供告警、数据存储与规则引擎。

---

五、延伸与教学价值

该方案不仅适合创客实验，也非常适合高校物联网、嵌入式或大数据方向课程。

通过该实验，学生可以理解：

• MQTT 在物联网中的核心作用；
• 串口网关设计思想；
• 云端平台（Home Assistant / JetLinks）对设备的统一管理；
• 从传感器 → MQTT → 平台 的完整数据闭环。

---

六、结语

从一个简单的"串口+MQTT"小实验出发，我们构建了一个完整的智能家居实验平台。

无论是家庭自动化，还是教学科研，这种基于 Pegasus 智能家居套件 + Serial2MQTT + 社区平台 的架构，都能让嵌入式设备真正融入到智能生态中。

"物联网的美，在于让每一个微小的节点，都能参与世界的互联。"

---