{"id":112347,"date":"2026-10-03T09:08:49","date_gmt":"2026-10-03T01:08:49","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/112347.html"},"modified":"2026-10-03T09:08:49","modified_gmt":"2026-10-03T01:08:49","slug":"mqtt%e6%99%ba%e8%83%bd%e6%8f%92%e5%ba%a7%e5%a6%82%e4%bd%95%e6%8e%a5%e5%85%a5home-assistant%ef%bc%8c%e4%bb%8e%e9%9b%b6%e5%bc%80%e5%a7%8b%e5%ae%8c%e6%95%b4%e5%b7%a5%e7%a8%8b%e5%ae%9e%e7%8e%b0%ef%bc%88ja","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/112347.html","title":{"rendered":"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09"},"content":{"rendered":"

GemeOpen GSPM1B \u00d7 Home Assistant \u00d7 Java(Spring Boot) + Angular Demo<\/h2>\n

\u628a GemeOpen GSPM1B \u667a\u80fd\u8f6c\u6362\u5668\u63d2\u5ea7 \u63a5\u5165 Home Assistant，\u5b9e\u73b0 \u901a\u65ad\u7535\u63a7\u5236 \u4e0e \u7535\u538b \/ \u7535\u6d41 \/ \u529f\u7387 \/ \u7d2f\u8ba1\u7528\u7535\u91cf \u91c7\u96c6；\u5e76\u9644\u4e00\u5957 Java(Spring Boot) + Angular \u7684\u5b8c\u6574\u81ea\u7814 Demo\u3002<\/p>\n

\u9762\u5411\u7a0b\u5e8f\u5458\u521d\u5b66\u8005：\u6587\u6863\u4ece\u96f6\u8bb2\u8d77，\u6bcf\u4e00\u6b65\u90fd\u53ef\u76f4\u63a5\u590d\u5236\u6267\u884c\u3002 \u672c\u5de5\u7a0b\u4e0e Python + React \u7248\u4e3a\u59ca\u59b9\u5de5\u7a0b，MQTT \u534f\u8bae\u4e0e\u63a5\u53e3\u5951\u7ea6\u5b8c\u5168\u4e00\u81f4\u3002<\/p>\n

\n

\u5f00\u53d1\u8005\u6587\u6863<\/h4>\n

https:\/\/www.smart-bird.cn\/doc\/product\/GSPM\/device\/GSPM1B\/command<\/p>\n

\u6e90\u7801\u4e0b\u8f7d\u5730\u5740<\/h4>\n

https:\/\/smart-bird-oss.smart-bird.cn\/document\/2026\/09\/28\/1127495749059821.zip<\/p>\n

\u2728 \u80fd\u529b\u4e00\u89c8<\/h3>\n\n\u80fd\u529bHome Assistant\u81ea\u7814 Demo<\/tr>\n\n\n\n\n\n\n\n
\u901a\u65ad\u7535\u5f00\u5173<\/td>\n\u2705 switch<\/td>\n\u2705 Web \u5f00\u5173<\/td>\n<\/tr>\n
\u5b9e\u65f6\u7535\u538b\/\u7535\u6d41\/\u529f\u7387<\/td>\n\u2705 sensor<\/td>\n\u2705 \u5b9e\u65f6\u5361\u7247<\/td>\n<\/tr>\n
\u7d2f\u8ba1\u7528\u7535\u91cf<\/td>\n\u2705 sensor（\u80fd\u6e90\u9762\u677f）<\/td>\n\u2705 \u5361\u7247<\/td>\n<\/tr>\n
\u5386\u53f2\u66f2\u7ebf<\/td>\n\u2705 History graph<\/td>\n\u2705 SVG \u6298\u7ebf<\/td>\n<\/tr>\n
\u5b9e\u65f6\u63a8\u9001<\/td>\n\u2014<\/td>\n\u2705 WebSocket<\/td>\n<\/tr>\n
\u9700\u8981\u5199\u4ee3\u7801<\/td>\n\u274c \u4ec5 YAML<\/td>\n\u2705 Java + Angular<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

🏗 \u67b6\u6784<\/h3>\n

GSPM1B \u2500\u2500MQTT\u2500\u2500\u25ba Mosquitto Broker \u25c4\u2500\u2500MQTT\u2500\u2500 Home Assistant (\u8def\u5f84 A, \u96f6\u4ee3\u7801)
\n \u25b2
\n \u2514\u2500\u2500MQTT\u2500\u2500 Java \u540e\u7aef(Spring Boot) \u2500\u2500REST\/WS\u2500\u2500 Angular \u524d\u7aef (\u8def\u5f84 B, \u81ea\u7814 Demo)<\/p>\n

🧰 \u6280\u672f\u6808<\/h3>\n\n\u5c42\u6280\u672f<\/tr>\n\n\n\n\n\n
\u8bbe\u5907\u901a\u4fe1<\/td>\nMQTT（Eclipse Paho Java Client）<\/td>\n<\/tr>\n
\u540e\u7aef<\/td>\nJava 17 \u00b7 Spring Boot 3.2 \u00b7 \u539f\u751f WebSocket \u00b7 Maven<\/td>\n<\/tr>\n
\u524d\u7aef<\/td>\nAngular 17（standalone）\u00b7 RxJS \u00b7 \u539f\u751f SVG \u56fe\u8868<\/td>\n<\/tr>\n
\u90e8\u7f72<\/td>\nDocker Compose \u00b7 Nginx \u00b7 Eclipse Mosquitto 2<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

📁 \u76ee\u5f55\u7ed3\u6784<\/h3>\n

gemeopen-ha-java-demo\/
\n\u251c\u2500\u2500 README.md # \u672c\u6587\u4ef6
\n\u251c\u2500\u2500 docker-compose.yml # \u4e00\u952e\u542f\u52a8 Mosquitto + \u540e\u7aef + \u524d\u7aef
\n\u251c\u2500\u2500 docs\/ # \u5168\u90e8\u4e2d\u6587\u6587\u6863
\n\u2502 \u251c\u2500\u2500 00-architecture.md # \u67b6\u6784\u4e0e\u63a5\u53e3\u5951\u7ea6（\u57fa\u51c6）
\n\u2502 \u251c\u2500\u2500 01-overview.md # \u65b9\u6848\u603b\u89c8（\u5148\u8bfb）
\n\u2502 \u251c\u2500\u2500 02-device-setup.md # \u8bbe\u5907\u7aef MQTT \u914d\u7f6e
\n\u2502 \u251c\u2500\u2500 03-homeassistant.md # Home Assistant \u63a5\u5165
\n\u2502 \u251c\u2500\u2500 04-backend.md # Java \u540e\u7aef\u8bf4\u660e
\n\u2502 \u251c\u2500\u2500 05-frontend.md # Angular \u524d\u7aef\u8bf4\u660e
\n\u2502 \u251c\u2500\u2500 06-deploy-ops.md # \u90e8\u7f72\u4e0e\u8fd0\u7ef4
\n\u2502 \u2514\u2500\u2500 07-troubleshooting.md # \u6392\u9519\u624b\u518c
\n\u251c\u2500\u2500 homeassistant\/ # HA \u914d\u7f6e\u7247\u6bb5
\n\u2502 \u251c\u2500\u2500 mqtt-gspm1b.yaml # switch + sensor \u5b9e\u4f53
\n\u2502 \u2514\u2500\u2500 dashboard.yaml # Lovelace \u4eea\u8868\u76d8
\n\u251c\u2500\u2500 backend\/ # Java Spring Boot \u540e\u7aef
\n\u2502 \u2514\u2500\u2500 src\/main\/java\/com\/gemeopen\/demo\/
\n\u2502 \u251c\u2500\u2500 mqtt\/MqttClientService.java # MQTT \u8fde\u63a5\/\u89e3\u6790\/\u4e0b\u53d1
\n\u2502 \u251c\u2500\u2500 store\/DeviceStore.java # \u72b6\u6001\u4e0e\u5386\u53f2
\n\u2502 \u251c\u2500\u2500 ws\/TelemetryWebSocketHandler.java
\n\u2502 \u2514\u2500\u2500 web\/DeviceController.java # REST \u7aef\u70b9
\n\u251c\u2500\u2500 frontend\/ # Angular \u524d\u7aef
\n\u2502 \u2514\u2500\u2500 src\/app\/
\n\u2502 \u251c\u2500\u2500 services\/{api,telemetry}.service.ts
\n\u2502 \u2514\u2500\u2500 components\/{switch-control,realtime-metrics,energy-total,history-chart}\/
\n\u251c\u2500\u2500 scripts\/ # \u8bbe\u5907\u914d\u7f6e\u811a\u672c
\n\u2502 \u251c\u2500\u2500 configure_device.py
\n\u2502 \u2514\u2500\u2500 device_switch.example.json
\n\u2514\u2500\u2500 mosquitto\/ # MQTT Broker \u914d\u7f6e
\n \u2514\u2500\u2500 mosquitto.conf<\/p>\n

🚀 \u5feb\u901f\u5f00\u59cb<\/h3>\n

# 1) \u542f\u52a8 Broker + \u540e\u7aef + \u524d\u7aef<\/span>
\ndocker<\/span> compose up -d<\/span> –build<\/span><\/p>\n

# 2) \u628a\u8bbe\u5907\u5207\u6362\u5230\u4f60\u7684 Broker（\u7f16\u8f91 scripts\/device_switch.json \u540e\u6267\u884c）<\/span>
\ncd<\/span> scripts &&<\/span> cp<\/span> device_switch.example.json device_switch.json
\npython3 configure_device.py –config<\/span> device_switch.json
\n# \u6210\u529f\u540e\u7ed9\u8bbe\u5907\u65ad\u7535\u91cd\u542f<\/span><\/p>\n

# 3) \u5f00\u542f\u8bbe\u5907\u5b9a\u65f6\u4e0a\u62a5（\u793a\u4f8b 15 \u79d2）<\/span>
\nmosquitto_pub -h<\/span> <<\/span>\u4f60\u7684IP><\/span> -p<\/span> 1883<\/span> \\\\<\/span>
\n -t<\/span> 'gemeopen\/gspm1b\/<MAC>\/command'<\/span> \\\\<\/span>
\n -m<\/span> '{"messageId":"1","timerEnable":1,"timerInterval":15,"type":"setting"}'<\/span><\/p>\n

# 4) \u6253\u5f00\u81ea\u7814 Demo<\/span>
\n# http:\/\/<\u4f60\u7684IP>:8080<\/span><\/p>\n

# 5) \u63a5\u5165 Home Assistant：\u89c1 docs\/03-homeassistant.md<\/span><\/p>\n

📖 \u6587\u6863\u8def\u7ebf（\u5efa\u8bae\u987a\u5e8f）<\/h3>\n
  • [01 \u00b7 \u65b9\u6848\u603b\u89c8] 01-overview.md<\/li>\n
  • [02 \u00b7 \u8bbe\u5907\u7aef\u914d\u7f6e] 02-device-setup.md<\/li>\n
  • \u6309\u9700\u9009\u62e9：\n
      \n
    • Home Assistant \u7528\u6237 \u2192 [03 \u00b7 HA \u63a5\u5165] 03-homeassistant.md<\/li>\n
    • Java \u5f00\u53d1\u8005 \u2192 [04 \u00b7 Java \u540e\u7aef] 04-backend.md\u3001[05 \u00b7 Angular \u524d\u7aef] 05-frontend.md<\/li>\n<\/ul>\n<\/li>\n
    • \u4e0a\u7ebf \u2192 [06 \u00b7 \u90e8\u7f72\u4e0e\u8fd0\u7ef4] 06-deploy-ops.md<\/li>\n
    • \u9047\u95ee\u9898 \u2192 [07 \u00b7 \u6392\u9519\u624b\u518c] 07-troubleshooting.md<\/li>\n

      \u26a0\ufe0f \u4e09\u4e2a\u6700\u91cd\u8981\u7684\u63d0\u9192<\/h3>\n
    • \u4e3b\u9898\u8bed\u4e49\u53cd\u76f4\u89c9：\u8bbe\u5907 publish \u4e3b\u9898\u662f\u4f60\u8981\u8ba2\u9605\u7684；\u8bbe\u5907 subcribe \u4e3b\u9898\u662f\u4f60\u8981\u53d1\u5e03\u6307\u4ee4\u7684\u3002<\/li>\n
    • Broker \u5730\u5740\u8bbe\u5907\u8981\u80fd\u8bbf\u95ee：\u8bbe\u5907\u7aef\u586b\u7684\u5fc5\u987b\u662f\u4f60\u670d\u52a1\u5668\u7684\u5c40\u57df\u7f51 IP \/ \u516c\u7f51\u57df\u540d，\u4e0d\u80fd\u662f localhost\u3002<\/li>\n
    • \u5207\u6362 MQTT \u540e\u9700\u91cd\u542f\u8bbe\u5907\u751f\u6548\u3002<\/li>\n

      🔧 \u73af\u5883\u8981\u6c42<\/h3>\n\n\u7ec4\u4ef6\u7248\u672c<\/tr>\n\n\n\n\n\n\n
      JDK<\/td>\n17+<\/td>\n<\/tr>\n
      Maven<\/td>\n3.8+<\/td>\n<\/tr>\n
      Node \/ npm<\/td>\n18+ \/ 20+（Angular 17 \u8981\u6c42 Node \u2265 18.13）<\/td>\n<\/tr>\n
      Docker \/ Compose<\/td>\n24+<\/td>\n<\/tr>\n
      Home Assistant<\/td>\n\u4efb\u610f\u8fd1\u671f\u7248\u672c<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      📄 \u8bf4\u660e<\/h3>\n
        \n
      • \u672c\u5de5\u7a0b\u4e3a\u6559\u5b66\u793a\u4f8b，\u751f\u4ea7\u4f7f\u7528\u8bf7\u53c2\u8003 [06 \u00b7 \u90e8\u7f72\u4e0e\u8fd0\u7ef4] 06-deploy-ops.md \u7684\u5b89\u5168\u6e05\u5355\u3002<\/li>\n
      • \u8bbe\u5907\u578b\u53f7\u534f\u8bae\u4ee5 GemeOpen \u5b98\u65b9\u5f00\u53d1\u6587\u6863\u4e3a\u51c6\u3002<\/li>\n<\/ul>\n

        00-architecture.md<\/h4>\n

        00 \u00b7 \u67b6\u6784\u4e0e\u63a5\u53e3\u5951\u7ea6（\u57fa\u51c6\u6587\u6863）<\/h2>\n

        \u672c\u6587\u662f\u6574\u4e2a\u5de5\u7a0b\u7684\u57fa\u51c6\u5951\u7ea6\u3002\u6240\u6709\u5b50\u6a21\u5757（Home Assistant \u914d\u7f6e\u3001Python \u540e\u7aef\u3001React \u524d\u7aef）\u90fd\u5fc5\u987b\u4e25\u683c\u9075\u5b88\u672c\u6587\u4ef6\u5b9a\u4e49\u7684\u4e3b\u9898\u540d\u3001\u6d88\u606f\u683c\u5f0f\u4e0e API \u5b57\u6bb5\u540d\u3002<\/p>\n

        1. \u603b\u4f53\u67b6\u6784<\/h3>\n

        \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 MQTT \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 MQTT \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
        \n\u2502 GSPM1B \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25ba \u2502 Mosquitto \u2502 \u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2502 Home Assistant \u2502
        \n\u2502 \u667a\u80fd\u63d2\u5ea7 \u2502 \u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2502 (\u81ea\u5efa Broker) \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25ba \u2502 MQTT \u96c6\u6210 \u2502
        \n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502 \u2502 switch + sensor \u2502
        \n \u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
        \n \u2502 \u2502 MQTT \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
        \n \u2502 \u2502 \u25c4\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2502 Python \u540e\u7aef (FastAPI)\u2502
        \n \u2502 \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25ba \u2502 MQTT \u21c4 REST\/WebSocket\u2502
        \n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
        \n \u2502 HTTP \/ WS
        \n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25bc\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
        \n \u2502 React \u524d\u7aef (Vite) \u2502
        \n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/p>\n

        \u4e24\u6761\u5e76\u884c\u7684\u6d88\u8d39\u8def\u5f84（\u4e92\u4e0d\u5f71\u54cd）：<\/p>\n

          \n
        • \u8def\u5f84 A（\u9762\u5411\u6700\u7ec8\u7528\u6237）：Home Assistant \u76f4\u63a5\u901a\u8fc7 MQTT \u96c6\u6210\u63a5\u5165，\u65e0\u9700\u81ea\u7814\u4ee3\u7801\u3002<\/li>\n
        • \u8def\u5f84 B（\u9762\u5411\u4e8c\u6b21\u5f00\u53d1）：Python + React Demo，\u6f14\u793a\u5982\u4f55\u81ea\u5efa\u4e00\u5957 Web \u63a7\u5236\u53f0\u3002<\/li>\n<\/ul>\n

          2. \u8bbe\u5907\u901a\u4fe1\u914d\u7f6e（\u51fa\u5382\u9ed8\u8ba4 \u2192 \u81ea\u5efa Broker）<\/h3>\n

          \u8bbe\u5907\u51fa\u5382\u9ed8\u8ba4\u8fde\u63a5 GemeOpen \u5382\u5bb6 MQTT \u670d\u52a1\u5668\u3002\u63a5\u5165\u81ea\u5efa Broker \u9700\u5728\u539f\u5382\u901a\u9053\u4e0b\u53d1 setting-mqtt \u6307\u4ee4（\u8be6\u89c1 docs\/02-device-setup.md）\u3002<\/p>\n

          setting-mqtt \u6307\u4ee4：<\/p>\n

          {<\/span>
          \n "clientId"<\/span>:<\/span> "gspm1b-28372fcbbbb8"<\/span>,<\/span>
          \n "messageId"<\/span>:<\/span> "20260520120000001"<\/span>,<\/span>
          \n "password"<\/span>:<\/span> "device-pass"<\/span>,<\/span>
          \n "port"<\/span>:<\/span> "1883"<\/span>,<\/span>
          \n "protocol"<\/span>:<\/span> "mqtt"<\/span>,<\/span>
          \n "publish"<\/span>:<\/span> "gemeopen\/gspm1b\/28372fcbbbb8\/report"<\/span>,<\/span>
          \n "server"<\/span>:<\/span> "192.168.1.10"<\/span>,<\/span>
          \n "subcribe"<\/span>:<\/span> "gemeopen\/gspm1b\/28372fcbbbb8\/command"<\/span>,<\/span>
          \n "type"<\/span>:<\/span> "custom"<\/span>,<\/span>
          \n "username"<\/span>:<\/span> "device"<\/span>
          \n}<\/span><\/p>\n

          \u26a0\ufe0f \u8bed\u4e49（\u6613\u9519，\u52a1\u5fc5\u6309\u6b64\u7406\u89e3）<\/p>\n

            \n
          • publish = \u8bbe\u5907\u53d1\u5e03\u6570\u636e\u7684\u4e3b\u9898 \u2192 \u670d\u52a1\u7aef\u8ba2\u9605\u5b83\u6765\u63a5\u6536\u4e0a\u62a5（\u672c\u9879\u76ee\u8bb0\u4f5c reportTopic）\u3002<\/li>\n
          • subcribe = \u8bbe\u5907\u8ba2\u9605\u7684\u4e3b\u9898 \u2192 \u670d\u52a1\u7aef\u53d1\u5e03\u6307\u4ee4\u5230\u5b83\u6765\u63a7\u5236\u8bbe\u5907（\u672c\u9879\u76ee\u8bb0\u4f5c commandTopic）\u3002<\/li>\n<\/ul>\n

            3. MQTT \u4e3b\u9898\u7ea6\u5b9a<\/h3>\n\n\u540d\u79f0\u9ed8\u8ba4\u503c\u65b9\u5411<\/tr>\n\n\n\n
            reportTopic<\/td>\ngemeopen\/gspm1b\/{mac}\/report<\/td>\n\u8bbe\u5907 \u2192 \u670d\u52a1\u7aef（\u4e0a\u884c，\u670d\u52a1\u7aef\u8ba2\u9605）<\/td>\n<\/tr>\n
            commandTopic<\/td>\ngemeopen\/gspm1b\/{mac}\/command<\/td>\n\u670d\u52a1\u7aef \u2192 \u8bbe\u5907（\u4e0b\u884c，\u670d\u52a1\u7aef\u53d1\u5e03）<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

            HA \u4e0e Python \u540e\u7aef\u4f7f\u7528\u540c\u4e00\u5957\u4e3b\u9898；\u4e24\u8005\u5404\u81ea\u7528\u72ec\u7acb clientId \u8fde\u63a5 Broker\u3002<\/p>\n

            4. \u6307\u4ee4\u4e0e\u6d88\u606f\u5951\u7ea6（JSON）<\/h3>\n

            4.1 \u4e0b\u884c\u6307\u4ee4（\u670d\u52a1\u7aef \u2192 \u8bbe\u5907，\u53d1\u5230 commandTopic）<\/h4>\n\n\u529f\u80fdpayload\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n
            \u901a\u65ad\u7535\u63a7\u5236<\/td>\n{"key":1,"messageId":"<id>","type":"event"}<\/td>\nkey=1 \u901a\u7535，key=0 \u65ad\u7535<\/td>\n<\/tr>\n
            \u67e5\u8be2\u5b9e\u65f6\u7535\u91cf<\/td>\n{"messageId":"<id>","type":"statistic"}<\/td>\n\u89e6\u53d1\u4e00\u6b21\u5b9e\u65f6\u6570\u636e\u56de\u4f20<\/td>\n<\/tr>\n
            \u8bbe\u7f6e\u4e0a\u62a5\u9891\u7387<\/td>\n{"messageId":"<id>","timerEnable":1,"timerInterval":15,"type":"setting"}<\/td>\n\u81ea\u52a8\u4e0a\u62a5\u5f00\u5173\u4e0e\u5468\u671f（5~86400 \u79d2）<\/td>\n<\/tr>\n
            \u83b7\u53d6\u8bbe\u5907\u4fe1\u606f<\/td>\n{"messageId":"<id>","type":"info"}<\/td>\n\u8fd4\u56de\u56fa\u4ef6\u3001IP\u3001\u4fe1\u53f7\u7b49<\/td>\n<\/tr>\n
            \u6062\u590d\u51fa\u5382<\/td>\n{"messageId":"<id>","system":"reset","type":"setting"}<\/td>\n\u8c28\u614e<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

            4.2 \u4e0a\u884c\u6d88\u606f（\u8bbe\u5907 \u2192 \u670d\u52a1\u7aef，\u6765\u81ea reportTopic）<\/h4>\n

            A. \u5b9a\u65f6\u81ea\u52a8\u4e0a\u62a5（device-timer-task）<\/p>\n

            {<\/span>
            \n "commandName"<\/span>:<\/span> "device-timer-task"<\/span>,<\/span>
            \n "mac"<\/span>:<\/span> "28372fcbbbb8"<\/span>,<\/span>
            \n "messageId"<\/span>:<\/span> ""<\/span>,<\/span>
            \n "source"<\/span>:<\/span> "auto"<\/span>,<\/span>
            \n "key"<\/span>:<\/span> 1<\/span>,<\/span>
            \n "voltage"<\/span>:<\/span> 226.024<\/span>,<\/span>
            \n "current"<\/span>:<\/span> 0.501<\/span>,<\/span>
            \n "power"<\/span>:<\/span> 113.4<\/span>,<\/span>
            \n "energy"<\/span>:<\/span> 25.047<\/span>
            \n}<\/span><\/p>\n

            B. \u6307\u4ee4\u54cd\u5e94（controller-event \/ info-statistic \/ info-all）<\/p>\n

            {<\/span>
            \n "commandName"<\/span>:<\/span> "info-statistic"<\/span>,<\/span>
            \n "mac"<\/span>:<\/span> "28372fcbbbb8"<\/span>,<\/span>
            \n "messageId"<\/span>:<\/span> "20260520120000001"<\/span>,<\/span>
            \n "source"<\/span>:<\/span> "command"<\/span>,<\/span>
            \n "key"<\/span>:<\/span> 1<\/span>,<\/span>
            \n "voltage"<\/span>:<\/span> 226.024<\/span>,<\/span>
            \n "current"<\/span>:<\/span> 0.501<\/span>,<\/span>
            \n "power"<\/span>:<\/span> 113.4<\/span>,<\/span>
            \n "energy"<\/span>:<\/span> 25.047<\/span>
            \n}<\/span><\/p>\n

            \u5b57\u6bb5\u8bed\u4e49\u4e0e\u5355\u4f4d<\/p>\n\n\u8bbe\u5907\u5b57\u6bb5\u542b\u4e49\u5355\u4f4d\u5f52\u4e00\u5316\u5b57\u6bb5（\u672c\u9879\u76ee\u7edf\u4e00\u547d\u540d）<\/tr>\n\n\n\n\n\n\n\n\n\n
            key<\/td>\n\u901a\u65ad\u7535\u72b6\u6001（1 \u901a\u7535 \/ 0 \u65ad\u7535）<\/td>\n\u2014<\/td>\nrelayOn (boolean)<\/td>\n<\/tr>\n
            voltage<\/td>\n\u7535\u538b<\/td>\nV<\/td>\nvoltageV<\/td>\n<\/tr>\n
            current<\/td>\n\u7535\u6d41<\/td>\nA<\/td>\ncurrentA<\/td>\n<\/tr>\n
            power<\/td>\n\u6709\u529f\u529f\u7387<\/td>\nW<\/td>\nactivePowerW<\/td>\n<\/tr>\n
            energy<\/td>\n\u7d2f\u8ba1\u7528\u7535\u91cf（\u65ad\u7535\u4e0d\u5f52\u96f6）<\/td>\nkW\u00b7h<\/td>\nenergyKwh<\/td>\n<\/tr>\n
            signal<\/td>\n\u4fe1\u53f7\u5f3a\u5ea6<\/td>\ndBm<\/td>\nsignalDbm<\/td>\n<\/tr>\n
            commandName<\/td>\n\u6307\u4ee4\u540d<\/td>\n\u2014<\/td>\ncommandName<\/td>\n<\/tr>\n
            source<\/td>\n\u6765\u6e90 command\/auto\/button<\/td>\n\u2014<\/td>\nsource<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

            5. Python \u540e\u7aef API \u5951\u7ea6（\u4f9b React \u524d\u7aef\u8c03\u7528）<\/h3>\n

            Base URL：http:\/\/<host>:8000<\/p>\n

            5.1 GET \/api\/health<\/h4>\n

            {<\/span> "status"<\/span>:<\/span> "ok"<\/span>,<\/span> "mqttConnected"<\/span>:<\/span> true<\/span>,<\/span> "deviceOnline"<\/span>:<\/span> true<\/span> }<\/span><\/p>\n

            5.2 GET \/api\/device<\/h4>\n

            \u8fd4\u56de\u5f53\u524d\u8bbe\u5907\u72b6\u6001\u5feb\u7167 DeviceState：<\/p>\n

            {<\/span>
            \n "mac"<\/span>:<\/span> "28372fcbbbb8"<\/span>,<\/span>
            \n "online"<\/span>:<\/span> true<\/span>,<\/span>
            \n "relayOn"<\/span>:<\/span> true<\/span>,<\/span>
            \n "voltageV"<\/span>:<\/span> 226.024<\/span>,<\/span>
            \n "currentA"<\/span>:<\/span> 0.501<\/span>,<\/span>
            \n "activePowerW"<\/span>:<\/span> 113.4<\/span>,<\/span>
            \n "energyKwh"<\/span>:<\/span> 25.047<\/span>,<\/span>
            \n "signalDbm"<\/span>:<\/span> –<\/span>75<\/span>,<\/span>
            \n "source"<\/span>:<\/span> "auto"<\/span>,<\/span>
            \n "lastUpdate"<\/span>:<\/span> 1787992225<\/span>
            \n}<\/span><\/p>\n

            lastUpdate \u4e3a\u79d2\u7ea7 Unix \u65f6\u95f4\u6233；\u65e0\u6570\u636e\u65f6\u5404\u6570\u503c\u5b57\u6bb5\u4e3a null\u3002<\/p>\n

            5.3 POST \/api\/device\/switch<\/h4>\n

            \u8bf7\u6c42：{ "on": true } \u2192 \u54cd\u5e94：{ "success": true, "state": <DeviceState> }<\/p>\n

            5.4 POST \/api\/device\/refresh<\/h4>\n

            \u89e6\u53d1\u4e00\u8f6e info + statistic \u67e5\u8be2，\u54cd\u5e94：{ "success": true }<\/p>\n

            5.5 GET \/api\/device\/history?limit=200<\/h4>\n

            \u8fd4\u56de\u91c7\u6837\u5386\u53f2（\u65f6\u95f4\u5347\u5e8f）：<\/p>\n

            [<\/span> {<\/span> "ts"<\/span>:<\/span> 1787992225<\/span>,<\/span> "voltageV"<\/span>:<\/span> 226.024<\/span>,<\/span> "currentA"<\/span>:<\/span> 0.501<\/span>,<\/span> "activePowerW"<\/span>:<\/span> 113.4<\/span>,<\/span> "energyKwh"<\/span>:<\/span> 25.047<\/span>,<\/span> "relayOn"<\/span>:<\/span> true<\/span> }<\/span> ]<\/span><\/p>\n

            5.6 GET \/api\/config<\/h4>\n

            \u8fd4\u56de\u975e\u654f\u611f\u8fd0\u884c\u914d\u7f6e：{ "reportTopic": "…", "commandTopic": "…", "mac": "…" }<\/p>\n

            5.7 WS \/ws\/telemetry<\/h4>\n

            WebSocket，\u6bcf\u6b21\u8bbe\u5907\u72b6\u6001\u66f4\u65b0\u65f6\u63a8\u9001\u4e00\u5e27 DeviceState（\u4e0e 5.2 \u540c\u7ed3\u6784）\u3002<\/p>\n

            6. \u540e\u7aef\u73af\u5883\u53d8\u91cf（.env）<\/h3>\n\n\u53d8\u91cf\u9ed8\u8ba4\u503c\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n\n\n\n\n\n
            MQTT_HOST<\/td>\n127.0.0.1<\/td>\nBroker \u5730\u5740<\/td>\n<\/tr>\n
            MQTT_PORT<\/td>\n1883<\/td>\nBroker \u7aef\u53e3<\/td>\n<\/tr>\n
            MQTT_USERNAME<\/td>\nbackend<\/td>\n\u540e\u7aef\u8fde\u63a5 Broker \u7684\u7528\u6237\u540d<\/td>\n<\/tr>\n
            MQTT_PASSWORD<\/td>\nbackend-pass<\/td>\n\u540e\u7aef\u5bc6\u7801<\/td>\n<\/tr>\n
            MQTT_CLIENT_ID<\/td>\ngemeopen-backend<\/td>\n\u540e\u7aef clientId（\u552f\u4e00）<\/td>\n<\/tr>\n
            MQTT_REPORT_TOPIC<\/td>\ngemeopen\/gspm1b\/+\/report<\/td>\n\u8ba2\u9605（+ \u901a\u914d\u5355\u8bbe\u5907）<\/td>\n<\/tr>\n
            MQTT_COMMAND_TOPIC<\/td>\ngemeopen\/gspm1b\/{mac}\/command<\/td>\n\u53d1\u5e03\u6307\u4ee4<\/td>\n<\/tr>\n
            DEVICE_MAC<\/td>\n28372fcbbbb8<\/td>\n\u76ee\u6807\u8bbe\u5907 MAC<\/td>\n<\/tr>\n
            HISTORY_SIZE<\/td>\n2000<\/td>\n\u5185\u5b58\u4e2d\u4fdd\u7559\u7684\u91c7\u6837\u6761\u6570<\/td>\n<\/tr>\n
            CORS_ORIGINS<\/td>\n*<\/td>\n\u5141\u8bb8\u7684\u524d\u7aef\u6765\u6e90<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

            7. \u524d\u7aef\u7ea6\u5b9a<\/h3>\n
              \n
            • \u6784\u5efa\u5de5\u5177：Vite + React 18<\/li>\n
            • \u72b6\u6001\u6765\u6e90：REST \u8f6e\u8be2（\/api\/device）+ WebSocket（\/ws\/telemetry）\u5b9e\u65f6\u63a8\u9001<\/li>\n
            • API Base：\u73af\u5883\u53d8\u91cf VITE_API_BASE（\u9ed8\u8ba4 http:\/\/localhost:8000）<\/li>\n
            • \u5c55\u793a\u5185\u5bb9：\u901a\u65ad\u7535\u5f00\u5173\u3001\u7535\u538b\/\u7535\u6d41\/\u529f\u7387\u5b9e\u65f6\u503c\u3001\u7d2f\u8ba1\u7528\u7535\u91cf\u3001\u5728\u7ebf\u72b6\u6001\u3001\u7b80\u6613\u5386\u53f2\u66f2\u7ebf<\/li>\n<\/ul>\n

              8. \u76ee\u5f55\u7ed3\u6784<\/h3>\n

              gemeopen-ha-demo\/
              \n\u251c\u2500\u2500 README.md # \u603b\u89c8\u4e0e\u5feb\u901f\u5f00\u59cb
              \n\u251c\u2500\u2500 docker-compose.yml # Mosquitto + \u540e\u7aef + \u524d\u7aef
              \n\u251c\u2500\u2500 docs\/
              \n\u2502 \u251c\u2500\u2500 00-architecture.md # \u672c\u6587\u4ef6（\u5951\u7ea6）
              \n\u2502 \u251c\u2500\u2500 01-overview.md # \u65b9\u6848\u603b\u89c8（\u521d\u5b66\u8005\u5411）
              \n\u2502 \u251c\u2500\u2500 02-device-setup.md # \u8bbe\u5907\u7aef MQTT \u914d\u7f6e
              \n\u2502 \u251c\u2500\u2500 03-homeassistant.md # Home Assistant \u63a5\u5165
              \n\u2502 \u251c\u2500\u2500 04-backend.md # Python \u540e\u7aef\u8bf4\u660e
              \n\u2502 \u251c\u2500\u2500 05-frontend.md # React \u524d\u7aef\u8bf4\u660e
              \n\u2502 \u251c\u2500\u2500 06-deploy-ops.md # \u90e8\u7f72\u4e0e\u8fd0\u7ef4
              \n\u2502 \u2514\u2500\u2500 07-troubleshooting.md # \u6392\u9519\u624b\u518c
              \n\u251c\u2500\u2500 homeassistant\/ # HA \u914d\u7f6e\u7247\u6bb5
              \n\u251c\u2500\u2500 backend\/ # Python FastAPI \u540e\u7aef
              \n\u251c\u2500\u2500 frontend\/ # React \u524d\u7aef
              \n\u251c\u2500\u2500 scripts\/ # \u8bbe\u5907\u914d\u7f6e\u811a\u672c
              \n\u2514\u2500\u2500 mosquitto\/ # Broker \u914d\u7f6e<\/p>\n

              01-overview.md<\/h4>\n

              01 \u00b7 \u65b9\u6848\u603b\u89c8（Java + Angular \u7248）<\/h2>\n

              1. \u8fd9\u4e2a\u9879\u76ee\u8981\u89e3\u51b3\u4ec0\u4e48？<\/h3>\n

              \u628a GemeOpen GSPM1B \u667a\u80fd\u8f6c\u6362\u5668\u63d2\u5ea7 \u63a5\u5165 Home Assistant，\u5b9e\u73b0：<\/p>\n

                \n
              • \u2705 \u901a\u65ad\u7535\u63a7\u5236（\u5f00 \/ \u5173）<\/li>\n
              • \u2705 \u5b9e\u65f6\u7535\u538b\u3001\u7535\u6d41\u3001\u529f\u7387\u91c7\u96c6<\/li>\n
              • \u2705 \u7d2f\u8ba1\u7528\u7535\u91cf\u67e5\u8be2<\/li>\n
              • \u2705（\u52a0\u5206）\u4e00\u5957 Java(Spring Boot) + Angular \u7684\u81ea\u7814 Demo<\/li>\n<\/ul>\n

                \u672c\u5de5\u7a0b\u4e0e Python + React \u7248\u662f\u300c\u59ca\u59b9\u5de5\u7a0b\u300d，MQTT \u534f\u8bae\u3001\u4e3b\u9898\u3001\u63a5\u53e3\u5951\u7ea6\u5b8c\u5168\u4e00\u81f4，\u53ea\u662f\u628a\u4e8c\u6b21\u5f00\u53d1\u7684\u6280\u672f\u6808\u6362\u6210\u4e86 Java + Angular\u3002<\/p>\n

                2. \u4e24\u6761\u63a5\u5165\u8def\u5f84<\/h3>\n

                \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                \n GSPM1B \u2500\u2500MQTT\u2500\u2524 Mosquitto Broker \u2502
                \n (\u8bbe\u5907) \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
                \n \u2502 MQTT \u2502 MQTT
                \n \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25bc\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u25bc\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                \n \u2502 \u8def\u5f84 A \u2502 \u2502 \u8def\u5f84 B \u2502
                \n \u2502 Home Assistant \u2502 \u2502 Java \u540e\u7aef (Spring Boot)\u2502
                \n \u2502 MQTT \u96c6\u6210 \u2502 \u2502 \u21c5 REST \/ WebSocket \u2502
                \n \u2502 switch + sensor \u2502 \u2502 Angular \u524d\u7aef \u2502
                \n \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
                \n \u65e0\u9700\u5199\u4ee3\u7801 \u9002\u5408 Java \u5f00\u53d1\u8005\u5b66\u4e60<\/p>\n

                3. \u6280\u672f\u6808<\/h3>\n\n\u5c42\u6280\u672f<\/tr>\n\n\n\n\n\n\n
                \u8bbe\u5907\u901a\u4fe1<\/td>\nMQTT（Eclipse Paho Java Client）<\/td>\n<\/tr>\n
                \u540e\u7aef<\/td>\nJava 17 + Spring Boot 3.2 + Spring Web + \u539f\u751f WebSocket<\/td>\n<\/tr>\n
                \u524d\u7aef<\/td>\nAngular 17（standalone components）+ RxJS + \u539f\u751f SVG \u56fe\u8868<\/td>\n<\/tr>\n
                Broker<\/td>\nEclipse Mosquitto 2<\/td>\n<\/tr>\n
                \u90e8\u7f72<\/td>\nDocker \/ Docker Compose + Nginx<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                4. \u5feb\u901f\u5f00\u59cb（5 \u6b65）<\/h3>\n

                # \u2460 \u542f\u52a8 Broker + \u540e\u7aef + \u524d\u7aef<\/span>
                \ncd<\/span> gemeopen-ha-java-demo
                \ndocker<\/span> compose up -d<\/span> –build<\/span><\/p>\n

                # \u2461 \u628a\u8bbe\u5907\u5207\u5230\u4f60\u7684 Broker（\u7f16\u8f91 scripts\/device_switch.json \u540e\u6267\u884c）<\/span>
                \ncd<\/span> scripts &&<\/span> cp<\/span> device_switch.example.json device_switch.json
                \npython3 configure_device.py –config<\/span> device_switch.json
                \n# \u6210\u529f\u540e\u7ed9\u8bbe\u5907\u65ad\u7535\u91cd\u542f<\/span><\/p>\n

                # \u2462 \u8ba9\u8bbe\u5907\u5b9a\u65f6\u4e0a\u62a5（\u793a\u4f8b 15 \u79d2）<\/span>
                \nmosquitto_pub -h<\/span> <<\/span>\u4f60\u7684IP><\/span> -p<\/span> 1883<\/span> -t<\/span> 'gemeopen\/gspm1b\/<MAC>\/command'<\/span> \\\\<\/span>
                \n -m<\/span> '{"messageId":"1","timerEnable":1,"timerInterval":15,"type":"setting"}'<\/span><\/p>\n

                # \u2463 \u6253\u5f00\u81ea\u7814 Demo：\u6d4f\u89c8\u5668\u8bbf\u95ee http:\/\/<\u4f60\u7684IP>:8080<\/span><\/p>\n

                # \u2464 \u63a5\u5165 Home Assistant：\u89c1 docs\/03-homeassistant.md<\/span><\/p>\n

                5. \u6587\u6863\u5bfc\u822a<\/h3>\n\n\u6587\u6863\u5185\u5bb9<\/tr>\n\n\n\n\n\n\n\n\n
                [02 \u00b7 \u8bbe\u5907\u7aef\u914d\u7f6e] 02-device-setup.md<\/td>\n\u628a\u8bbe\u5907\u6307\u5411\u81ea\u5efa Broker（\u5fc5\u8bfb）<\/td>\n<\/tr>\n
                [03 \u00b7 Home Assistant \u63a5\u5165] 03-homeassistant.md<\/td>\nHA \u96c6\u6210 + \u5b9e\u4f53 + \u4eea\u8868\u76d8 + \u81ea\u52a8\u5316<\/td>\n<\/tr>\n
                [04 \u00b7 Java \u540e\u7aef] 04-backend.md<\/td>\nSpring Boot + MQTT \u4ee3\u7801\u8bf4\u660e<\/td>\n<\/tr>\n
                [05 \u00b7 Angular \u524d\u7aef] 05-frontend.md<\/td>\n\u7ec4\u4ef6\u7ed3\u6784\u3001\u670d\u52a1\u3001\u8fd0\u884c\u65b9\u5f0f<\/td>\n<\/tr>\n
                [06 \u00b7 \u90e8\u7f72\u4e0e\u8fd0\u7ef4] 06-deploy-ops.md<\/td>\n\u4e09\u79cd\u90e8\u7f72\u65b9\u5f0f\u3001\u5907\u4efd\u3001\u76d1\u63a7<\/td>\n<\/tr>\n
                [07 \u00b7 \u6392\u9519\u624b\u518c] 07-troubleshooting.md<\/td>\n\u6309\u75c7\u72b6\u6392\u67e5<\/td>\n<\/tr>\n
                [00 \u00b7 \u67b6\u6784\u4e0e\u5951\u7ea6] 00-architecture.md<\/td>\n\u4e3b\u9898\/\u6d88\u606f\/API \u5951\u7ea6（\u57fa\u51c6）<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                6. \u5173\u952e\u6982\u5ff5 30 \u79d2\u901f\u901a<\/h3>\n
                  \n
                • MQTT：\u8f7b\u91cf\u53d1\u5e03\/\u8ba2\u9605\u534f\u8bae\u3002\u8bbe\u5907\u201c\u53d1\u5e03\u201d\u6570\u636e\u5230\u201c\u4e3b\u9898\u201d，\u7a0b\u5e8f\u201c\u8ba2\u9605\u201d\u8be5\u4e3b\u9898\u5373\u6536\u5230\u3002<\/li>\n
                • Broker（Mosquitto）：\u6d88\u606f\u4e2d\u8f6c\u7ad9；\u8bbe\u5907\u3001HA\u3001\u540e\u7aef\u90fd\u8fde\u5b83\u3002<\/li>\n
                • Topic：\u7c7b\u4f3c\u201c\u9891\u9053\u540d\u201d，\u672c\u9879\u76ee\u7528 gemeopen\/gspm1b\/<mac>\/report（\u8bbe\u5907\u53d1）\u4e0e …\/command（\u8bbe\u5907\u6536）\u3002<\/li>\n
                • Home Assistant：\u5f00\u6e90\u667a\u80fd\u5bb6\u5c45\u5e73\u53f0，\u901a\u8fc7 MQTT \u96c6\u6210\u628a\u8bbe\u5907\u53d8\u6210\u53ef\u63a7\u201c\u5b9e\u4f53\u201d\u3002<\/li>\n<\/ul>\n

                  \u26a0\ufe0f \u6700\u5bb9\u6613\u8e29\u7684\u5751：\u6587\u6863\u91cc publish \/ subcribe \u4e0e\u76f4\u89c9\u76f8\u53cd\u2014\u2014\u8bbe\u5907\u7684 publish \u4e3b\u9898\u662f\u4f60\u8981\u8ba2\u9605\u7684，subcribe \u4e3b\u9898\u662f\u4f60\u8981\u53d1\u5e03\u6307\u4ee4\u7684\u3002\u8be6\u89c1 [02] 02-device-setup.md \u3002<\/p>\n

                  \n

                  02-device-setup.md<\/h4>\n

                  02 \u00b7 \u8bbe\u5907\u7aef MQTT \u914d\u7f6e（\u628a GSPM1B \u6307\u5411\u81ea\u5efa Broker）<\/h2>\n

                  \u76ee\u6807：\u8ba9 GSPM1B \u628a\u6570\u636e\u53d1\u5230\u4f60\u81ea\u5df1\u7684 MQTT Broker（Mosquitto），\u8fd9\u6837 Home Assistant \u548c Python \u540e\u7aef\u624d\u80fd\u8bfb\u5230\u6570\u636e\u3001\u53d1\u51fa\u63a7\u5236\u6307\u4ee4\u3002<\/p>\n

                  1. \u4e3a\u4ec0\u4e48\u9700\u8981\u8fd9\u4e00\u6b65？<\/h3>\n

                  GSPM1B \u51fa\u5382\u65f6\u9ed8\u8ba4\u8fde\u63a5 GemeOpen \u5382\u5bb6\u6d4b\u8bd5\u670d\u52a1\u5668（mqtt.smart-bird.cn:1883），\u514d\u8d39\u4f9b\u8c03\u8bd5\u3002\u8981\u8ba9 HA \u63a5\u7ba1，\u5c31\u9700\u8981\u628a\u8bbe\u5907\u6539\u4e3a\u8fde\u63a5\u4f60\u81ea\u5df1\u7684 Broker\u3002<\/p>\n

                  \u8bbe\u5907\u63d0\u4f9b\u4e86\u4e13\u95e8\u7684\u6307\u4ee4 setting-mqtt（\u81ea\u5b9a\u4e49 MQTT \u53c2\u6570）\u6765\u5b8c\u6210\u8fd9\u4ef6\u4e8b\u3002<\/p>\n

                  2. \u51c6\u5907\u5de5\u4f5c<\/h3>\n

                  \u4f60\u9700\u8981\u5148\u77e5\u9053\u8bbe\u5907\u5f53\u524d\u6240\u5728 Broker \u7684\u8fde\u63a5\u4fe1\u606f，\u901a\u8fc7\u8bbe\u5907\u6307\u4ee4 info-protocol \u83b7\u53d6：<\/p>\n\n\u5b57\u6bb5\u542b\u4e49\u7528\u9014<\/tr>\n\n\n\n\n\n
                  server \/ port<\/td>\n\u5f53\u524d Broker \u5730\u5740\/\u7aef\u53e3<\/td>\n\u8fde\u63a5\u5b83\u6765\u4e0b\u53d1\u5207\u6362\u6307\u4ee4<\/td>\n<\/tr>\n
                  username<\/td>\n\u5f53\u524d Broker \u7528\u6237\u540d<\/td>\n\u8fde\u63a5\u51ed\u636e<\/td>\n<\/tr>\n
                  publish<\/td>\n\u8bbe\u5907\u53d1\u5e03\u4e3b\u9898（\u670d\u52a1\u7aef\u8ba2\u9605\u5b83\u6536\u6570\u636e）<\/td>\n\u8bb0\u4e3a report_topic<\/td>\n<\/tr>\n
                  subcribe<\/td>\n\u8bbe\u5907\u8ba2\u9605\u4e3b\u9898（\u670d\u52a1\u7aef\u5411\u5b83\u53d1\u6307\u4ee4）<\/td>\n\u8bb0\u4e3a command_topic<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                  \u26a0\ufe0f \u6ce8\u610f publish \/ subcribe（\u539f\u6587\u62fc\u5199）\u7684\u8bed\u4e49\u4e0e\u76f4\u89c9\u76f8\u53cd：<\/p>\n

                    \n
                  • \u8bbe\u5907\u628a\u6570\u636e publish \u5230 publish \u4e3b\u9898 \u2192 \u6240\u4ee5\u4f60\u8981\u8ba2\u9605\u5b83\u3002<\/li>\n
                  • \u8bbe\u5907 subscribe \u4e86 subcribe \u4e3b\u9898 \u2192 \u6240\u4ee5\u4f60\u8981\u5f80\u5b83\u53d1\u5e03\u6307\u4ee4\u3002<\/li>\n<\/ul>\n

                    \u83b7\u53d6\u65b9\u5f0f：<\/p>\n

                  • GemeOpen \u63a7\u5236\u53f0：\u767b\u5f55\u540e\u5728\u8bbe\u5907\u8be6\u60c5\u9875\u67e5\u770b；<\/li>\n
                  • \u8bbe\u5907\u6307\u4ee4：\u5f80\u8bbe\u5907\u53d1 {"type":"info","messageId":"…"}（info-protocol \u9700\u6309\u5176\u6587\u6863\u8bf4\u660e\u89e6\u53d1），\u8fd4\u56de\u91cc\u542b\u4e0a\u8ff0\u5b57\u6bb5；<\/li>\n
                  • \u5411\u5382\u5bb6\/\u9500\u552e\u7d22\u53d6：\u6d4b\u8bd5\u670d\u52a1\u5668\u7684\u8fde\u63a5\u51ed\u636e（username\/password）\u901a\u5e38\u9700\u8981\u5382\u5bb6\u63d0\u4f9b\u3002<\/li>\n

                    3. \u4e00\u952e\u5207\u6362\u811a\u672c<\/h3>\n

                    \u5de5\u7a0b\u63d0\u4f9b\u4e86\u811a\u672c scripts\/configure_device.py：<\/p>\n

                    cd<\/span> scripts
                    \ncp<\/span> device_switch.example.json device_switch.json
                    \n# \u7f16\u8f91 device_switch.json，\u586b\u5165 current（\u5f53\u524d Broker）\u4e0e target（\u4f60\u7684\u81ea\u5efa Broker）<\/span>
                    \npip install<\/span> paho-mqtt==<\/span>2.1<\/span>.0
                    \npython3 configure_device.py –config<\/span> device_switch.json<\/p>\n

                    \u914d\u7f6e\u6a21\u677f\u5173\u952e\u5b57\u6bb5：<\/p>\n

                    {
                    \n "current": { \/\/ \u8bbe\u5907\u201c\u73b0\u5728\u201d\u6240\u5728\u7684 Broker
                    \n "server": "mqtt.smart-bird.cn",
                    \n "port": 1883,
                    \n "username": "<\u5e73\u53f0\u7528\u6237\u540d>",
                    \n "password": "<\u5e73\u53f0\u5bc6\u7801>",
                    \n "report_topic": "<info-protocol \u7684 publish>",
                    \n "command_topic": "<info-protocol \u7684 subcribe>"
                    \n },
                    \n "target": { \/\/ \u8981\u5207\u6362\u5230\u7684\u201c\u81ea\u5efa\u201d Broker
                    \n "server": "192.168.1.10", \/\/ \u5fc5\u987b\u8bbe\u5907\u7f51\u7edc\u53ef\u8fbe
                    \n "port": 1883,
                    \n "username": "device",
                    \n "password": "device-pass",
                    \n "client_id": "gspm1b-28372fcbbbb8",
                    \n "publish_topic": "gemeopen\/gspm1b\/28372fcbbbb8\/report",
                    \n "subcribe_topic": "gemeopen\/gspm1b\/28372fcbbbb8\/command"
                    \n }
                    \n}<\/p>\n

                    \u811a\u672c\u4f1a：\u8fde\u63a5\u5f53\u524d Broker \u2192 \u5411 command_topic \u53d1\u5e03 setting-mqtt \u2192 \u7b49\u5f85\u8bbe\u5907\u56de\u6267\u3002<\/p>\n

                    \u6210\u529f\u540e\u4f1a\u63d0\u793a：<\/p>\n

                    \u2705 \u8bbe\u5907\u5df2\u63a5\u53d7\u65b0\u7684 MQTT \u914d\u7f6e\u3002
                    \n \u8bf7\u7ed9\u8bbe\u5907\u3010\u65ad\u7535\u91cd\u542f\u3011，\u6216\u53d1\u9001 controller-restart \u6307\u4ee4，\u4f7f\u914d\u7f6e\u751f\u6548\u3002<\/p>\n

                    4. \u4f7f\u914d\u7f6e\u751f\u6548<\/h3>\n

                    setting-mqtt \u9700\u8981\u91cd\u542f\u624d\u751f\u6548：<\/p>\n

                      \n
                    • \u65ad\u7535\u91cd\u542f：\u62d4\u6389\u8bbe\u5907\u518d\u4e0a\u7535（\u6700\u7b80\u5355）；<\/li>\n
                    • \u8f6f\u91cd\u542f：\u5411\u8bbe\u5907\u53d1 {"messageId":"…","system":"restart","type":"setting"}（controller-restart）\u3002<\/li>\n<\/ul>\n

                      5. \u9a8c\u8bc1\u8bbe\u5907\u5df2\u5207\u6362<\/h3>\n

                      \u5728\u4f60\u7684 Broker \u4e0a\u7528\u4efb\u610f MQTT \u5ba2\u6237\u7aef\u8ba2\u9605：<\/p>\n

                      mosquitto_sub -h<\/span> 192.168<\/span>.1.10 -p<\/span> 1883<\/span> -u<\/span> device -P<\/span> device-pass \\\\<\/span>
                      \n -t<\/span> 'gemeopen\/gspm1b\/28372fcbbbb8\/report'<\/span> -v<\/span><\/p>\n

                      \u82e5\u8bbe\u5907\u6309\u4e0a\u62a5\u5468\u671f\u6301\u7eed\u5410\u51fa JSON（\u542b voltage\/current\/power\/energy\/key），\u8bf4\u660e\u5207\u6362\u6210\u529f 🎉\u3002<\/p>\n

                      6. \u6ca1\u6709\u5382\u5bb6\u51ed\u636e\u600e\u4e48\u529e？<\/h3>\n
                        \n
                      • \u65b9\u6848 A（\u63a8\u8350）：\u8054\u7cfb GemeOpen \u83b7\u53d6\u6d4b\u8bd5\u670d\u52a1\u5668\u51ed\u636e，\u7528\u811a\u672c\u5207\u6362；<\/li>\n
                      • \u65b9\u6848 B：\u8bbe\u5907\u652f\u6301\u5185\u7f51 HTTP \u63a7\u5236（\u56fa\u4ef6 2.0.0+），\u53ef\u5728\u8bbe\u5907\u6240\u5728\u5c40\u57df\u7f51\u5185\u76f4\u63a5\u914d\u7f6e（\u5177\u4f53\u63a5\u53e3\u4ee5\u8bbe\u5907\u6587\u6863\u4e3a\u51c6）；<\/li>\n
                      • \u65b9\u6848 C：\u5148\u7528\u5382\u5bb6\u9ed8\u8ba4\u670d\u52a1\u5668\u8c03\u8bd5，\u8dd1\u901a scripts\/ \u4e0e\u540e\u7aef\u903b\u8f91\u540e，\u518d\u5207\u6362\u3002<\/li>\n<\/ul>\n

                        7. \u4e3b\u9898\u4e0e\u8bbe\u5907 MAC \u7684\u5bf9\u5e94\u5173\u7cfb<\/h3>\n

                        \u5efa\u8bae\u6309\u8bbe\u5907 MAC \u89c4\u5212\u4e3b\u9898，\u4fbf\u4e8e\u591a\u8bbe\u5907\u7ba1\u7406：<\/p>\n

                        gemeopen\/gspm1b\/<mac>\/report # \u8bbe\u5907\u4e0a\u62a5（\u4f60\u8ba2\u9605）
                        \ngemeopen\/gspm1b\/<mac>\/command # \u8bbe\u5907\u6307\u4ee4（\u4f60\u53d1\u5e03）<\/p>\n

                        \u540e\u7aef\u7684 MQTT_REPORT_TOPIC \u9ed8\u8ba4\u7528\u901a\u914d\u7b26 gemeopen\/gspm1b\/+\/report，\u53ef\u540c\u65f6\u63a5\u6536\u591a\u53f0\u8bbe\u5907\u3002<\/p>\n

                        \n

                        03-homeassistant.md<\/h4>\n

                        03 \u00b7 Home Assistant \u63a5\u5165<\/h2>\n

                        \u9762\u5411\u521d\u5b66\u8005，\u4ece\u96f6\u628a GSPM1B \u63a5\u5165 Home Assistant，\u5b9e\u73b0\u901a\u65ad\u7535\u63a7\u5236 + \u5b9e\u65f6\u7535\u6d41\/\u7535\u538b\/\u529f\u7387\u91c7\u96c6 + \u7d2f\u8ba1\u7528\u7535\u91cf\u3002<\/p>\n

                        1. \u6574\u4f53\u601d\u8def（\u5148\u770b\u8fd9\u5f20\u56fe）<\/h3>\n

                        GSPM1B \u2500\u2500MQTT\u2500\u2500\u25ba Mosquitto Broker \u25c4\u2500\u2500MQTT\u2500\u2500 Home Assistant
                        \n (\u8bbe\u5907) (\u4f60\u7684\u670d\u52a1\u5668) (MQTT \u96c6\u6210)<\/p>\n

                        Home Assistant \u901a\u8fc7 MQTT \u96c6\u6210\u8fde\u63a5\u4f60\u7684 Mosquitto，\u518d\u7528\u4e00\u4efd YAML \u628a\u8bbe\u5907\u6d88\u606f\u6620\u5c04\u6210\u5b9e\u4f53：<\/p>\n

                          \n
                        • switch（\u5f00\u5173）\u2192 \u63a7\u5236\u901a\u65ad\u7535<\/li>\n
                        • sensor（\u4f20\u611f\u5668）\u2192 \u7535\u538b \/ \u7535\u6d41 \/ \u529f\u7387 \/ \u7d2f\u8ba1\u7528\u7535\u91cf \/ \u4fe1\u53f7<\/li>\n<\/ul>\n

                          2. \u524d\u7f6e\u6761\u4ef6<\/h3>\n\n\u9879\u8981\u6c42<\/tr>\n\n\n\n\n\n
                          Home Assistant<\/td>\n\u4efb\u610f\u5b89\u88c5\u65b9\u5f0f（HAOS \/ Docker \/ Supervised \/ Core）<\/td>\n<\/tr>\n
                          MQTT Broker<\/td>\nMosquitto（\u672c\u5de5\u7a0b mosquitto\/ + docker-compose.yml \u5df2\u63d0\u4f9b）<\/td>\n<\/tr>\n
                          \u8bbe\u5907<\/td>\nGSPM1B \u5df2\u6309 [02 \u00b7 \u8bbe\u5907\u7aef\u914d\u7f6e] 02-device-setup.md \u6307\u5411\u4f60\u7684 Broker<\/td>\n<\/tr>\n
                          \u8bbe\u5907 MAC<\/td>\n\u540e\u9762\u914d\u7f6e\u4e2d\u6240\u6709 <MAC> \u90fd\u8981\u66ff\u6362\u6210\u5b83<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                          3. \u6b65\u9aa4\u4e00：\u51c6\u5907 Mosquitto Broker<\/h3>\n

                          3.1 \u7528\u672c\u5de5\u7a0b\u4e00\u952e\u542f\u52a8（\u63a8\u8350）<\/h4>\n

                          cd<\/span> gemeopen-ha-demo
                          \ndocker<\/span> compose up -d<\/span> mosquitto<\/p>\n

                          3.2 \u6216\u4f7f\u7528 Home Assistant OS \u7684\u5b98\u65b9 Add-on<\/h4>\n

                          \u8bbe\u7f6e \u2192 \u52a0\u8f7d\u9879 \u2192 \u641c\u7d22 Mosquitto broker \u2192 \u5b89\u88c5 \u2192 \u542f\u52a8\u3002<\/p>\n

                          \u7528\u54ea\u79cd\u90fd\u884c，\u53ea\u8981\u8bbe\u5907\u3001HA \u90fd\u8fde\u540c\u4e00\u4e2a Broker\u3002<\/p>\n

                          4. \u6b65\u9aa4\u4e8c：\u5728 HA \u4e2d\u6dfb\u52a0 MQTT \u96c6\u6210<\/h3>\n
                        • \u8bbe\u7f6e \u2192 \u8bbe\u5907\u4e0e\u670d\u52a1 \u2192 \u6dfb\u52a0\u96c6\u6210 \u2192 \u641c\u7d22 MQTT；<\/li>\n
                        • Broker \u586b mosquitto \u7684\u5730\u5740（Docker \u573a\u666f\u586b\u5bbf\u4e3b\u673a IP，\u5982 192.168.1.10）\u3001\u7aef\u53e3 1883；<\/li>\n
                        • \u586b\u5165 Mosquitto \u7684\u7528\u6237\u540d\/\u5bc6\u7801（\u89c1 mosquitto\/mosquitto.conf \u4e0e docker-compose.yml）；<\/li>\n
                        • \u63d0\u4ea4，\u96c6\u6210\u663e\u793a\u201c\u5df2\u8fde\u63a5\u201d\u3002<\/li>\n

                          5. \u6b65\u9aa4\u4e09：\u6dfb\u52a0\u5b9e\u4f53\u914d\u7f6e<\/h3>\n
                        • \u628a\u672c\u5de5\u7a0b\u7684 homeassistant\/mqtt-gspm1b.yaml \u590d\u5236\u5230 HA \u914d\u7f6e\u76ee\u5f55（\u4e0e configuration.yaml \u540c\u7ea7）；<\/li>\n
                        • \u7f16\u8f91 mqtt-gspm1b.yaml，\u628a \u6240\u6709 <MAC> \u66ff\u6362\u4e3a\u4f60\u7684\u8bbe\u5907 MAC（\u5c0f\u5199，\u4f8b\u5982 28372fcbbbb8）；<\/li>\n
                        • \u5728 configuration.yaml \u4e2d\u52a0\u5165\u4e00\u884c：<\/li>\n

                          mqtt<\/span>:<\/span> !include<\/span> mqtt–<\/span>gspm1b.yaml<\/p>\n

                        • \u5f00\u53d1\u8005\u5de5\u5177 \u2192 YAML \u2192 \u68c0\u67e5\u914d\u7f6e \u2192 \u91cd\u542f HA\u3002<\/li>\n

                          \u5982\u679c\u4f60\u66f4\u719f\u6089 UI：\u4e5f\u53ef\u5728\u8bbe\u7f6e \u2192 \u8bbe\u5907\u4e0e\u670d\u52a1 \u2192 MQTT \u2192 \u901a\u8fc7\u201c\u6dfb\u52a0\u5b9e\u4f53\u201d\u9010\u4e2a\u6dfb\u52a0，\u53c2\u6570\u4e0e YAML \u4e00\u81f4\u3002<\/p>\n

                          6. \u6b65\u9aa4\u56db：\u9a8c\u8bc1\u5b9e\u4f53<\/h3>\n

                          \u91cd\u542f\u540e，\u8bbe\u7f6e \u2192 \u8bbe\u5907\u4e0e\u670d\u52a1 \u2192 \u5b9e\u4f53，\u5e94\u80fd\u770b\u5230：<\/p>\n\n\u5b9e\u4f53 ID\u7c7b\u578b\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n\n
                          switch.gspm1b_switch<\/td>\nswitch<\/td>\n\u901a\u65ad\u7535\u5f00\u5173<\/td>\n<\/tr>\n
                          sensor.gspm1b_voltage<\/td>\nsensor<\/td>\n\u7535\u538b (V)<\/td>\n<\/tr>\n
                          sensor.gspm1b_current<\/td>\nsensor<\/td>\n\u7535\u6d41 (A)<\/td>\n<\/tr>\n
                          sensor.gspm1b_power<\/td>\nsensor<\/td>\n\u529f\u7387 (W)<\/td>\n<\/tr>\n
                          sensor.gspm1b_energy<\/td>\nsensor<\/td>\n\u7d2f\u8ba1\u7528\u7535\u91cf (kWh)<\/td>\n<\/tr>\n
                          sensor.gspm1b_signal<\/td>\nsensor<\/td>\n\u4fe1\u53f7\u5f3a\u5ea6 (dBm)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                          \u6d4b\u8bd5：<\/p>\n

                            \n
                          • \u70b9 switch.gspm1b_switch \u5f00\/\u5173，\u89c2\u5bdf\u5b9e\u7269\u63d2\u5ea7\u7ee7\u7535\u5668\u662f\u5426\u52a8\u4f5c；<\/li>\n
                          • \u82e5\u4f20\u611f\u5668\u6570\u503c\u4e3a\u201c\u672a\u77e5\u201d，\u8bf4\u660e\u8bbe\u5907\u8fd8\u6ca1\u4e0a\u62a5\u2014\u2014\u68c0\u67e5：\n
                          • \u8bbe\u5907\u662f\u5426\u5df2\u5207\u6362\u5230\u8be5 Broker（\u89c1 02 \u6587\u6863）；<\/li>\n
                          • \u662f\u5426\u5df2\u5f00\u542f\u5b9a\u65f6\u4e0a\u62a5（\u89c1\u4e0b\u8282）\u3002<\/li>\n<\/li>\n<\/ul>\n

                            7. \u6b65\u9aa4\u4e94：\u5f00\u542f\u8bbe\u5907\u5b9a\u65f6\u4e0a\u62a5（\u8ba9\u4f20\u611f\u5668\u6301\u7eed\u66f4\u65b0）<\/h3>\n

                            \u8bbe\u5907\u9ed8\u8ba4\u53ef\u80fd\u4e0d\u4e3b\u52a8\u6c47\u62a5\u3002\u7ed9\u5b83\u4e0b\u53d1\u4e00\u6b21\u201c\u8bbe\u7f6e\u4e0a\u62a5\u9891\u7387\u201d\u6307\u4ee4\u5373\u53ef（\u793a\u4f8b\u95f4\u9694 15 \u79d2）：<\/p>\n

                            mosquitto_pub -h<\/span> 192.168<\/span>.1.10 -p<\/span> 1883<\/span> -u<\/span> device -P<\/span> device-pass \\\\<\/span>
                            \n -t<\/span> 'gemeopen\/gspm1b\/28372fcbbbb8\/command'<\/span> \\\\<\/span>
                            \n -m<\/span> '{"messageId":"1","timerEnable":1,"timerInterval":15,"type":"setting"}'<\/span><\/p>\n

                            \u4e4b\u540e report \u4e3b\u9898\u4f1a\u6bcf 15 \u79d2\u6536\u5230\u4e00\u6761 device-timer-task，HA \u4f20\u611f\u5668\u968f\u4e4b\u66f4\u65b0\u3002<\/p>\n

                            8. \u6b65\u9aa4\u516d：\u6dfb\u52a0\u4eea\u8868\u76d8<\/h3>\n
                          • \u8bbe\u7f6e \u2192 \u4eea\u8868\u76d8 \u2192 \u65b0\u5efa\u4eea\u8868\u76d8（\u6807\u9898\u5982\u201c\u667a\u80fd\u63d2\u5ea7\u201d）；<\/li>\n
                          • \u6253\u5f00\u5b83 \u2192 \u53f3\u4e0a\u89d2\u7f16\u8f91 \u2192 \u6dfb\u52a0\u5361\u7247，\u6309 homeassistant\/dashboard.yaml \u7684\u5185\u5bb9\u6dfb\u52a0：\n
                              \n
                            • \u5f00\u5173：Entities \u5361\u7247 \u2192 switch.gspm1b_switch<\/li>\n
                            • \u7535\u538b\/\u7535\u6d41：Gauge \u5361\u7247<\/li>\n
                            • \u529f\u7387\/\u7535\u91cf：Sensor \u5361\u7247（\u5e26\u8ff7\u4f60\u66f2\u7ebf）<\/li>\n
                            • \u5386\u53f2：History graph \u5361\u7247<\/li>\n<\/ul>\n<\/li>\n

                              \u4e5f\u53ef\u76f4\u63a5\u628a dashboard.yaml \u7684\u5185\u5bb9\u7c98\u8d34\u5230\u201c\u539f\u59cb\u914d\u7f6e\u7f16\u8f91\u5668\u201d\u3002<\/p>\n

                              9. \u6b65\u9aa4\u4e03（\u52a0\u5206\u9879）：\u80fd\u6e90\u9762\u677f\u4e0e\u81ea\u52a8\u5316<\/h3>\n

                              \u80fd\u6e90\u9762\u677f：\u7d2f\u8ba1\u7528\u7535\u91cf\u5df2\u8bbe device_class: energy + state_class: total_increasing，\u4f1a\u81ea\u52a8\u51fa\u73b0\u5728 \u8bbe\u7f6e \u2192 \u4eea\u8868\u76d8 \u2192 \u80fd\u6e90 \u2192 \u6dfb\u52a0\u7528\u7535\u8bbe\u5907\u3002<\/p>\n

                              \u81ea\u52a8\u5316\u793a\u4f8b：\u529f\u7387\u8d85\u8fc7 2000W \u65f6\u901a\u77e5（configuration.yaml \u6216 UI \u81ea\u52a8\u5316）：<\/p>\n

                              automation<\/span>:<\/span>
                              \n –<\/span> alias<\/span>:<\/span> "GSPM1B \u529f\u7387\u8fc7\u9ad8\u63d0\u9192"<\/span>
                              \n trigger<\/span>:<\/span>
                              \n –<\/span> platform<\/span>:<\/span> numeric_state
                              \n entity_id<\/span>:<\/span> sensor.gspm1b_power
                              \n above<\/span>:<\/span> 2000<\/span>
                              \n for<\/span>:<\/span> "00:01:00"<\/span>
                              \n action<\/span>:<\/span>
                              \n –<\/span> service<\/span>:<\/span> persistent_notification.create
                              \n data<\/span>:<\/span>
                              \n title<\/span>:<\/span> "\u63d2\u5ea7\u529f\u7387\u8fc7\u9ad8"<\/span>
                              \n message<\/span>:<\/span> "\u5f53\u524d\u529f\u7387 {{ states('sensor.gspm1b_power') }} W"<\/span><\/p>\n

                              \u5b9a\u65f6\u65ad\u7535\u793a\u4f8b：<\/p>\n

                              –<\/span> alias<\/span>:<\/span> "\u6bcf\u5929 23:30 \u81ea\u52a8\u65ad\u7535"<\/span>
                              \n trigger<\/span>:<\/span>
                              \n –<\/span> platform<\/span>:<\/span> time
                              \n at<\/span>:<\/span> "23:30:00"<\/span>
                              \n action<\/span>:<\/span>
                              \n –<\/span> service<\/span>:<\/span> switch.turn_off
                              \n target<\/span>:<\/span>
                              \n entity_id<\/span>:<\/span> switch.gspm1b_switch<\/p>\n

                              10. \u5e38\u89c1\u95ee\u9898\u901f\u67e5<\/h3>\n\n\u73b0\u8c61\u6392\u67e5<\/tr>\n\n\n\n\n\n\n
                              switch \u663e\u793a\u4e0d\u53ef\u7528<\/td>\ncommand_topic\/state_topic \u91cc\u7684 <MAC> \u662f\u5426\u66ff\u6362\u6b63\u786e；MQTT \u96c6\u6210\u662f\u5426\u8fde\u63a5<\/td>\n<\/tr>\n
                              \u5f00\u5173\u80fd\u70b9\u4f46\u5b9e\u7269\u65e0\u53cd\u5e94<\/td>\n\u8bbe\u5907\u662f\u5426\u5df2\u5207\u5230\u8be5 Broker；command_topic \u662f\u5426\u4e3a\u8bbe\u5907\u7684 subcribe<\/td>\n<\/tr>\n
                              \u4f20\u611f\u5668\u4e00\u76f4\u201c\u672a\u77e5\u201d<\/td>\n\u672a\u5f00\u542f\u5b9a\u65f6\u4e0a\u62a5；\u6216\u8bbe\u5907\u672a\u4e0a\u62a5；\u7528 mosquitto_sub \u6293\u5305\u786e\u8ba4<\/td>\n<\/tr>\n
                              \u6570\u503c\u4e0d\u53d8<\/td>\n\u4e0a\u62a5\u95f4\u9694\u8fc7\u5927；\u6216\u672c\u5730\u7f13\u5b58\u672a\u89e6\u53d1\u4e0a\u62a5<\/td>\n<\/tr>\n
                              \u80fd\u6e90\u9762\u677f\u4e0d\u663e\u793a<\/td>\n\u786e\u8ba4 state_class: total_increasing \u5df2\u751f\u6548\u5e76\u5df2\u4ea7\u751f\u6570\u636e<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                              \u66f4\u591a\u6392\u9519\u89c1 [07 \u00b7 \u6392\u9519\u624b\u518c] 07-troubleshooting.md \u3002<\/p>\n

                              \n

                              04-backend.md<\/h4>\n

                              04 \u00b7 Java \u540e\u7aef（Spring Boot + MQTT）<\/h2>\n

                              \u8def\u5f84 B \u7684\u540e\u7aef：\u8ba2\u9605\u8bbe\u5907 MQTT \u6d88\u606f \u2192 \u5f52\u4e00\u5316 \u2192 \u901a\u8fc7 REST \/ WebSocket \u63d0\u4f9b\u7ed9 Angular \u524d\u7aef\u3002<\/p>\n

                              1. \u6587\u4ef6\u7ed3\u6784<\/h3>\n

                              backend\/
                              \n\u251c\u2500\u2500 pom.xml # Maven \u4f9d\u8d56（Spring Boot 3.2 + Paho MQTT）
                              \n\u251c\u2500\u2500 Dockerfile # \u591a\u9636\u6bb5：maven \u6784\u5efa \u2192 jre \u8fd0\u884c
                              \n\u251c\u2500\u2500 README.md
                              \n\u2514\u2500\u2500 src\/main\/
                              \n \u251c\u2500\u2500 resources\/application.yml # \u7aef\u53e3\u4e0e\u5168\u90e8\u73af\u5883\u53d8\u91cf
                              \n \u2514\u2500\u2500 java\/com\/gemeopen\/demo\/
                              \n \u251c\u2500\u2500 GemeOpenApplication.java # \u542f\u52a8\u7c7b
                              \n \u251c\u2500\u2500 model\/
                              \n \u2502 \u251c\u2500\u2500 DeviceState.java # \u8bbe\u5907\u72b6\u6001\u5feb\u7167（\u5951\u7ea6 5.2）
                              \n \u2502 \u251c\u2500\u2500 Sample.java # \u5386\u53f2\u91c7\u6837\u70b9（\u5951\u7ea6 5.5）
                              \n \u2502 \u2514\u2500\u2500 SwitchRequest.java # \u5f00\u5173\u8bf7\u6c42\u4f53（\u5951\u7ea6 5.3）
                              \n \u251c\u2500\u2500 store\/DeviceStore.java # \u7ebf\u7a0b\u5b89\u5168\u72b6\u6001 + \u73af\u5f62\u5386\u53f2
                              \n \u251c\u2500\u2500 mqtt\/MqttClientService.java # MQTT \u8fde\u63a5\/\u8ba2\u9605\/\u89e3\u6790\/\u4e0b\u53d1
                              \n \u251c\u2500\u2500 ws\/TelemetryWebSocketHandler.java # WebSocket \u5e7f\u64ad
                              \n \u251c\u2500\u2500 config\/
                              \n \u2502 \u251c\u2500\u2500 WebSocketConfig.java # \u6ce8\u518c \/ws\/telemetry
                              \n \u2502 \u2514\u2500\u2500 CorsConfig.java # \u8de8\u57df\u914d\u7f6e
                              \n \u2514\u2500\u2500 web\/DeviceController.java # REST \u7aef\u70b9<\/p>\n

                              2. \u8fd0\u884c<\/h3>\n

                              \u672c\u5730（\u9700 JDK 17+ \u4e0e Maven）<\/h4>\n

                              cd<\/span> backend
                              \nmvn spring-boot:run
                              \n# \u6216\u6784\u5efa\u540e\u8fd0\u884c<\/span>
                              \nmvn -DskipTests<\/span> package
                              \njava<\/span> -jar<\/span> target\/gemeopen-demo.jar<\/p>\n

                              \u53ef\u7528\u73af\u5883\u53d8\u91cf\u8986\u76d6\u914d\u7f6e（\u89c1 application.yml），\u4f8b\u5982：<\/p>\n

                              MQTT_HOST<\/span>=<\/span>192.168<\/span>.1.10 DEVICE_MAC<\/span>=<\/span>28372fcbbbb8 java<\/span> -jar<\/span> target\/gemeopen-demo.jar<\/p>\n

                              Docker<\/h4>\n

                              docker<\/span> build -t<\/span> gemeopen-backend-java .\/backend
                              \ndocker<\/span> run -d<\/span> –name<\/span> gemeopen-backend-java -p<\/span> 8000<\/span>:8000 \\\\<\/span>
                              \n -e<\/span> MQTT_HOST<\/span>=<\/span>192.168<\/span>.1.10 -e<\/span> DEVICE_MAC<\/span>=<\/span>28372fcbbbb8 \\\\<\/span>
                              \n gemeopen-backend-java<\/p>\n

                              3. API \u4e00\u89c8<\/h3>\n\n\u65b9\u6cd5\u8def\u5f84\u8bf4\u660e<\/tr>\n\n\n\n\n\n\n\n\n
                              GET<\/td>\n\/api\/health<\/td>\n\u670d\u52a1\/Broker\/\u8bbe\u5907\u5728\u7ebf\u72b6\u6001<\/td>\n<\/tr>\n
                              GET<\/td>\n\/api\/device<\/td>\n\u5f53\u524d\u72b6\u6001\u5feb\u7167<\/td>\n<\/tr>\n
                              POST<\/td>\n\/api\/device\/switch<\/td>\n\u901a\u65ad\u7535，body {"on": true}<\/td>\n<\/tr>\n
                              POST<\/td>\n\/api\/device\/refresh<\/td>\n\u89e6\u53d1\u4e00\u6b21 info + statistic \u67e5\u8be2<\/td>\n<\/tr>\n
                              GET<\/td>\n\/api\/device\/history?limit=200<\/td>\n\u91c7\u6837\u5386\u53f2（\u7ed8\u56fe\u7528）<\/td>\n<\/tr>\n
                              GET<\/td>\n\/api\/config<\/td>\n\u975e\u654f\u611f\u8fd0\u884c\u914d\u7f6e<\/td>\n<\/tr>\n
                              WS<\/td>\n\/ws\/telemetry<\/td>\n\u5b9e\u65f6\u72b6\u6001\u63a8\u9001<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                              \u5b57\u6bb5\u5b9a\u4e49\u89c1 [00 \u00b7 \u67b6\u6784\u4e0e\u5951\u7ea6] 00-architecture.md \u7b2c 5 \u8282\u3002<\/p>\n

                              4. \u4ee3\u7801\u5bfc\u8bfb（\u91cd\u70b9\u4e09\u5904）<\/h3>\n

                              4.1 MqttClientService：\u8fde\u63a5\u4e0e\u56de\u8c03<\/h4>\n

                              client =<\/span> new<\/span> MqttClient<\/span>(<\/span>brokerUrl,<\/span> clientId,<\/span> new<\/span> MemoryPersistence<\/span>(<\/span>)<\/span>)<\/span>;<\/span>
                              \nclient.<\/span>setCallback<\/span>(<\/span>new<\/span> MqttCallbackExtended<\/span>(<\/span>)<\/span> {<\/span>
                              \n public<\/span> void<\/span> connectComplete<\/span>(<\/span>boolean<\/span> reconnect,<\/span> String<\/span> serverURI)<\/span> {<\/span>
                              \n client.<\/span>subscribe<\/span>(<\/span>reportTopic,<\/span> 0<\/span>)<\/span>;<\/span> \/\/ \u8ba2\u9605\u8bbe\u5907\u4e0a\u62a5<\/span>
                              \n }<\/span>
                              \n public<\/span> void<\/span> messageArrived<\/span>(<\/span>String<\/span> topic,<\/span> MqttMessage<\/span> msg)<\/span> {<\/span>
                              \n DeviceState<\/span> state =<\/span> normalize<\/span>(<\/span>msg.<\/span>getPayload<\/span>(<\/span>)<\/span>)<\/span>;<\/span> \/\/ \u5f52\u4e00\u5316\u5b57\u6bb5<\/span>
                              \n store.<\/span>update<\/span>(<\/span>state)<\/span>;<\/span> \/\/ \u66f4\u65b0\u72b6\u6001\u4e0e\u5386\u53f2<\/span>
                              \n wsHandler.<\/span>broadcast<\/span>(<\/span>state)<\/span>;<\/span> \/\/ \u63a8\u9001\u7ed9\u524d\u7aef<\/span>
                              \n }<\/span>
                              \n .<\/span>.<\/span>.<\/span>
                              \n}<\/span>)<\/span>;<\/span><\/p>\n

                              4.2 \u5b57\u6bb5\u5f52\u4e00\u5316<\/h4>\n\n\u8bbe\u5907\u539f\u59cb\u5b57\u6bb5\u5f52\u4e00\u5316\u5b57\u6bb5\u7c7b\u578b<\/tr>\n\n\n\n\n\n\n\n
                              key (0\/1)<\/td>\nrelayOn<\/td>\nBoolean<\/td>\n<\/tr>\n
                              voltage<\/td>\nvoltageV<\/td>\nDouble<\/td>\n<\/tr>\n
                              current<\/td>\ncurrentA<\/td>\nDouble<\/td>\n<\/tr>\n
                              power<\/td>\nactivePowerW<\/td>\nDouble<\/td>\n<\/tr>\n
                              energy<\/td>\nenergyKwh<\/td>\nDouble<\/td>\n<\/tr>\n
                              signal<\/td>\nsignalDbm<\/td>\nInteger<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                              4.3 TelemetryWebSocketHandler：\u5e7f\u64ad<\/h4>\n

                              \u7ef4\u62a4 CopyOnWriteArraySet<WebSocketSession>，\u72b6\u6001\u66f4\u65b0\u65f6\u904d\u5386\u53d1\u9001；\u7531\u4e8e WebSocket \u4e0d\u80fd\u5e76\u53d1\u5199， \u53d1\u9001\u65f6\u7528 synchronized \u52a0\u9501\u4e32\u884c\u5316：<\/p>\n

                              public<\/span> void<\/span> broadcast<\/span>(<\/span>Object<\/span> payload)<\/span> {<\/span>
                              \n String<\/span> json =<\/span> mapper.<\/span>writeValueAsString<\/span>(<\/span>payload)<\/span>;<\/span>
                              \n TextMessage<\/span> msg =<\/span> new<\/span> TextMessage<\/span>(<\/span>json)<\/span>;<\/span>
                              \n synchronized<\/span> (<\/span>sendLock)<\/span> {<\/span>
                              \n for<\/span> (<\/span>WebSocketSession<\/span> s :<\/span> sessions)<\/span> {<\/span>
                              \n if<\/span> (<\/span>s.<\/span>isOpen<\/span>(<\/span>)<\/span>)<\/span> s.<\/span>sendMessage<\/span>(<\/span>msg)<\/span>;<\/span>
                              \n }<\/span>
                              \n }<\/span>
                              \n}<\/span><\/p>\n

                              5. \u4e8c\u6b21\u5f00\u53d1\u5efa\u8bae<\/h3>\n
                            • \u6301\u4e45\u5316：\u628a DeviceStore \u7684\u5185\u5b58\u5386\u53f2\u6362\u6210 JPA + PostgreSQL \/ InfluxDB；<\/li>\n
                            • \u591a\u8bbe\u5907：MQTT_REPORT_TOPIC \u5df2\u7528 + \u901a\u914d，\u53ef\u6309 MAC \u5efa\u7acb Map<String, DeviceState>；<\/li>\n
                            • \u9274\u6743：\u5f15\u5165 Spring Security，\u4e3a\u524d\u7aef\u63a5\u53e3\u52a0 Token；<\/li>\n
                            • \u914d\u7f6e\u5316\u9608\u503c：\u65b0\u589e\u544a\u8b66\u670d\u52a1，\u5bf9\u529f\u7387\/\u7535\u91cf\u505a\u8d8a\u9650\u56de\u8c03\u3002<\/li>\n
                              \n

                              05-frontend.md<\/h4>\n

                              05 \u00b7 Angular \u524d\u7aef（Angular 17）<\/h2>\n

                              \u8def\u5f84 B \u7684\u524d\u7aef：\u5c55\u793a\u5b9e\u65f6\u7535\u538b\/\u7535\u6d41\/\u529f\u7387\/\u7d2f\u8ba1\u7535\u91cf，\u5e76\u63d0\u4f9b\u901a\u65ad\u7535\u5f00\u5173\u3002<\/p>\n

                              1. \u6587\u4ef6\u7ed3\u6784<\/h3>\n

                              frontend\/
                              \n\u251c\u2500\u2500 package.json # \u4f9d\u8d56\u4e0e\u811a\u672c
                              \n\u251c\u2500\u2500 angular.json # \u6784\u5efa\u914d\u7f6e（\u542b env \u66ff\u6362\u3001dev \u4ee3\u7406）
                              \n\u251c\u2500\u2500 tsconfig.json \/ tsconfig.app.json
                              \n\u251c\u2500\u2500 proxy.conf.json # \u5f00\u53d1\u4ee3\u7406 \/api\u3001\/ws \u2192 localhost:8000
                              \n\u251c\u2500\u2500 Dockerfile # \u591a\u9636\u6bb5：ng build \u2192 nginx
                              \n\u251c\u2500\u2500 nginx.conf # \u6258\u7ba1 dist + \u53cd\u4ee3 \/api\u3001\/ws
                              \n\u251c\u2500\u2500 README.md
                              \n\u2514\u2500\u2500 src\/
                              \n \u251c\u2500\u2500 index.html
                              \n \u251c\u2500\u2500 main.ts # bootstrapApplication(AppComponent)
                              \n \u251c\u2500\u2500 styles.css # \u5168\u5c40\u6df1\u8272\u4e3b\u9898
                              \n \u251c\u2500\u2500 environments\/
                              \n \u2502 \u251c\u2500\u2500 environment.ts # apiBase: http:\/\/localhost:8000（\u5f00\u53d1）
                              \n \u2502 \u2514\u2500\u2500 environment.prod.ts # apiBase: ''（\u751f\u4ea7\u540c\u6e90，\u8d70 Nginx \u53cd\u4ee3）
                              \n \u2514\u2500\u2500 app\/
                              \n \u251c\u2500\u2500 app.config.ts # provideHttpClient()
                              \n \u251c\u2500\u2500 app.component.ts\/.html\/.css # \u6839\u5e03\u5c40
                              \n \u251c\u2500\u2500 models\/device-state.ts # \u7c7b\u578b\u4e0e\u7a7a\u503c\u515c\u5e95
                              \n \u251c\u2500\u2500 services\/
                              \n \u2502 \u251c\u2500\u2500 api.service.ts # REST \u5c01\u88c5
                              \n \u2502 \u2514\u2500\u2500 telemetry.service.ts # \u72b6\u6001\u6d41：REST + WebSocket + \u964d\u7ea7\u8f6e\u8be2
                              \n \u2514\u2500\u2500 components\/
                              \n \u251c\u2500\u2500 switch-control\/ # \u901a\u65ad\u7535\u5f00\u5173
                              \n \u251c\u2500\u2500 realtime-metrics\/ # \u7535\u538b\/\u7535\u6d41\/\u529f\u7387\/\u4fe1\u53f7
                              \n \u251c\u2500\u2500 energy-total\/ # \u7d2f\u8ba1\u7528\u7535\u91cf
                              \n \u2514\u2500\u2500 history-chart\/ # \u539f\u751f SVG \u6298\u7ebf\u56fe<\/p>\n

                              2. \u8fd0\u884c<\/h3>\n

                              cd<\/span> frontend
                              \nnpm<\/span> install<\/span>
                              \nnpm<\/span> start # http:\/\/localhost:4200（\u81ea\u52a8\u5e26 proxy.conf.json \u4ee3\u7406\u5230 8000）<\/span>
                              \nnpm<\/span> run build # \u751f\u4ea7\u6784\u5efa，\u4ea7\u7269\u5728 dist\/frontend\/browser\/<\/span><\/p>\n

                              3. \u6570\u636e\u6d41\u4e0e\u5b9e\u65f6\u66f4\u65b0<\/h3>\n

                              \u6838\u5fc3\u5728 telemetry.service.ts：<\/p>\n

                            • \u7528 BehaviorSubject<DeviceState> \u7ef4\u62a4\u72b6\u6001\u6d41 state$；<\/li>\n
                            • \u9996\u5c4f GET \/api\/device \u53d6\u521d\u503c；<\/li>\n
                            • \u8fde\u63a5 WebSocket \/ws\/telemetry，\u6bcf\u5e27\u66f4\u65b0 state$；<\/li>\n
                            • \u65ad\u7ebf\u6307\u6570\u9000\u907f\u91cd\u8fde（1s\u219230s \u5c01\u9876）；<\/li>\n
                            • WebSocket \u8fde\u7eed\u5931\u8d25\u5219\u964d\u7ea7\u4e3a 5 \u79d2\u8f6e\u8be2，\u6062\u590d\u540e\u81ea\u52a8\u505c\u6b62\u8f6e\u8be2\u3002<\/li>\n

                              \u7ec4\u4ef6\u901a\u8fc7 state$ | async \u8ba2\u9605，\u81ea\u52a8\u968f\u6570\u636e\u5237\u65b0\u3002<\/p>\n

                              4. \u754c\u9762\u6784\u6210<\/h3>\n\n\u533a\u57df\u7ec4\u4ef6\u5185\u5bb9<\/tr>\n\n\n\n\n\n\n
                              \u9876\u90e8<\/td>\nAppComponent<\/td>\n\u6807\u9898\u3001\u8bbe\u5907\u5728\u7ebf\u5fbd\u6807\u3001\u8fde\u63a5\u72b6\u6001（\u5b9e\u65f6\/\u8f6e\u8be2\/\u65ad\u5f00）\u3001\u6700\u540e\u66f4\u65b0\u65f6\u95f4\u3001\u5237\u65b0\u6309\u94ae<\/td>\n<\/tr>\n
                              \u63a7\u5236<\/td>\nSwitchControl<\/td>\n\u901a\u7535\/\u65ad\u7535\u5f00\u5173（\u8bf7\u6c42\u4e2d\u6001\u3001\u79bb\u7ebf\u7981\u7528\u3001\u9519\u8bef\u63d0\u793a）<\/td>\n<\/tr>\n
                              \u6307\u6807<\/td>\nRealtimeMetrics<\/td>\n\u7535\u538b V \/ \u7535\u6d41 A \/ \u529f\u7387 W \/ \u4fe1\u53f7 dBm<\/td>\n<\/tr>\n
                              \u7535\u91cf<\/td>\nEnergyTotal<\/td>\n\u7d2f\u8ba1\u7528\u7535\u91cf kWh<\/td>\n<\/tr>\n
                              \u8d8b\u52bf<\/td>\nHistoryChart<\/td>\n\u539f\u751f SVG \u53cc\u7ebf\u6298\u7ebf（\u7535\u538b + \u529f\u7387），\u542b\u7f51\u683c\u4e0e\u8303\u56f4\u7edf\u8ba1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                              5. \u914d\u7f6e<\/h3>\n\n\u73af\u5883API \u5730\u5740\u8bf4\u660e<\/tr>\n\n\n\n
                              \u5f00\u53d1<\/td>\nhttp:\/\/localhost:8000<\/td>\n\u4e5f\u53ef\u8d70 proxy.conf.json \u4ee3\u7406<\/td>\n<\/tr>\n
                              \u751f\u4ea7\u6784\u5efa<\/td>\n''（\u540c\u6e90）<\/td>\n\u7531 nginx.conf \u628a \/api\u3001\/ws \u53cd\u4ee3\u5230 backend:8000<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                              \u6539\u540e\u7aef\u5730\u5740：\u7f16\u8f91 src\/environments\/environment.ts\u3002<\/p>\n

                              6. \u6784\u5efa\u4e0e\u90e8\u7f72<\/h3>\n

                              npm<\/span> run build
                              \n# \u4ea7\u7269：dist\/frontend\/browser\/<\/span><\/p>\n

                              # Docker<\/span>
                              \ndocker<\/span> build -t<\/span> gemeopen-frontend-angular .\/frontend
                              \ndocker<\/span> run -d<\/span> -p<\/span> 8080<\/span>:80 gemeopen-frontend-angular<\/p>\n

                              7. \u4e8c\u6b21\u5f00\u53d1\u5efa\u8bae<\/h3>\n
                            • \u6362 UI \u7ec4\u4ef6\u5e93：\u53ef\u63a5\u5165 Angular Material \/ PrimeNG；<\/li>\n
                            • \u52a0\u8def\u7531：app.routes.ts \u62c6\u51fa\u300c\u5b9e\u65f6\u300d\u300c\u5386\u53f2\u300d\u300c\u8bbe\u7f6e\u300d\u591a\u9875；<\/li>\n
                            • \u591a\u8bbe\u5907：\u9876\u90e8\u52a0\u8bbe\u5907\u5207\u6362，\u6309 MAC \u4f20\u53c2；<\/li>\n
                            • \u544a\u8b66：\u8ba2\u9605\u540e\u7aef\u544a\u8b66\u6d41，\u505a Toast\/\u58f0\u97f3\u63d0\u793a\u3002<\/li>\n
                              \n

                              06-deploy-ops.md<\/h4>\n

                              06 \u00b7 \u90e8\u7f72\u4e0e\u8fd0\u7ef4<\/h2>\n

                              \u8986\u76d6 \u672c\u5730\u5f00\u53d1 \u2192 Docker \u90e8\u7f72 \u2192 \u751f\u4ea7\u5efa\u8bae，\u4ee5\u53ca\u65e5\u5e38\u8fd0\u7ef4\u64cd\u4f5c\u3002<\/p>\n

                              1. \u90e8\u7f72\u65b9\u5f0f\u603b\u89c8<\/h3>\n\n\u65b9\u5f0f\u9002\u7528\u573a\u666f\u96be\u5ea6\u8bf4\u660e<\/tr>\n\n\n\n\n
                              A. \u672c\u5730\u5f00\u53d1<\/td>\n\u5b66\u4e60\/\u8c03\u8bd5<\/td>\n\u2605<\/td>\n\u624b\u52a8\u8d77 Broker + Java \u540e\u7aef + Angular \u524d\u7aef<\/td>\n<\/tr>\n
                              B. Docker Compose<\/td>\n\u5feb\u901f\u4e0a\u7ebf<\/td>\n\u2605\u2605<\/td>\n\u4e00\u6761\u547d\u4ee4\u8d77\u5168\u5957（\u63a8\u8350）<\/td>\n<\/tr>\n
                              C. \u751f\u4ea7\u90e8\u7f72<\/td>\n\u957f\u671f\u8fd0\u884c<\/td>\n\u2605\u2605\u2605<\/td>\n\u5bc6\u7801\u8ba4\u8bc1 + HTTPS + \u81ea\u52a8\u542f\u52a8 + \u5907\u4efd<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                              \n

                              2. \u65b9\u5f0f A：\u672c\u5730\u5f00\u53d1<\/h3>\n

                              2.1 \u542f\u52a8 MQTT Broker<\/h4>\n

                              cd<\/span> gemeopen-ha-java-demo
                              \ndocker<\/span> compose up -d<\/span> mosquitto<\/p>\n

                              2.2 \u542f\u52a8 Java \u540e\u7aef（JDK 17+ \/ Maven）<\/h4>\n

                              cd<\/span> backend
                              \nmvn spring-boot:run
                              \n# \u6216<\/span>
                              \nmvn -DskipTests<\/span> package &&<\/span> java<\/span> -jar<\/span> target\/gemeopen-demo.jar<\/p>\n

                              \u7528\u73af\u5883\u53d8\u91cf\u8986\u76d6\u914d\u7f6e：<\/p>\n

                              MQTT_HOST<\/span>=<\/span>192.168<\/span>.1.10 DEVICE_MAC<\/span>=<\/span>28372fcbbbb8 java<\/span> -jar<\/span> target\/gemeopen-demo.jar<\/p>\n

                              \u5065\u5eb7\u68c0\u67e5：curl http:\/\/localhost:8000\/api\/health \u63a5\u53e3\u6587\u6863（\u5982\u542f\u7528）：http:\/\/localhost:8000\/api\/device<\/p>\n

                              2.3 \u542f\u52a8 Angular \u524d\u7aef（Node 18+）<\/h4>\n

                              cd<\/span> frontend
                              \nnpm<\/span> install<\/span>
                              \nnpm<\/span> start # http:\/\/localhost:4200（\u5df2\u914d\u7f6e\u4ee3\u7406\u5230 8000）<\/span><\/p>\n

                              \n

                              3. \u65b9\u5f0f B：Docker Compose（\u63a8\u8350）<\/h3>\n

                              3.1 \u524d\u7f6e<\/h4>\n
                                \n
                              • \u5b89\u88c5 Docker \u4e0e Docker Compose \u63d2\u4ef6；<\/li>\n
                              • \u4fee\u6539 docker-compose.yml \u4e2d DEVICE_MAC \u4e3a\u4f60\u7684\u8bbe\u5907 MAC\u3002<\/li>\n<\/ul>\n

                                3.2 \u542f\u52a8<\/h4>\n

                                cd<\/span> gemeopen-ha-java-demo
                                \ndocker<\/span> compose up -d<\/span> –build<\/span>
                                \ndocker<\/span> compose ps<\/span><\/p>\n\n\u670d\u52a1\u5730\u5740<\/tr>\n\n\n\n\n
                                Mosquitto<\/td>\nmqtt:\/\/<\u5bbf\u4e3b\u673aIP>:1883<\/td>\n<\/tr>\n
                                Java \u540e\u7aef API<\/td>\nhttp:\/\/localhost:8000\/api\/health<\/td>\n<\/tr>\n
                                Angular \u524d\u7aef<\/td>\nhttp:\/\/localhost:8080<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                                3.3 \u5173\u952e：\u8ba9\u8bbe\u5907\u80fd\u8bbf\u95ee\u5230 Broker<\/h4>\n

                                \u8bbe\u5907\u7aef setting-mqtt \u91cc\u7684 Broker \u5730\u5740\u5fc5\u987b\u586b \u5bbf\u4e3b\u673a\u5c40\u57df\u7f51 IP（\u5982 192.168.1.10）， \u4e0d\u80fd\u7528 localhost \/ mosquitto（\u90a3\u662f\u5bb9\u5668\u5185\u90e8\u5730\u5740）\u3002\u5e76\u786e\u8ba4\u9632\u706b\u5899\u653e\u884c 1883\u3002<\/p>\n

                                \n

                                4. \u65b9\u5f0f C：\u751f\u4ea7\u73af\u5883\u5efa\u8bae<\/h3>\n

                                4.1 \u542f\u7528 Broker \u5bc6\u7801\u8ba4\u8bc1<\/h4>\n

                                \u6309 mosquitto\/mosquitto.conf \u672b\u5c3e\u8bf4\u660e\u751f\u6210 passwd \u5e76\u5f00\u542f\u8ba4\u8bc1，\u7136\u540e\u540c\u6b65\u66f4\u65b0： \u8bbe\u5907 setting-mqtt\u3001HA MQTT \u96c6\u6210\u3001\u540e\u7aef MQTT_USERNAME\/MQTT_PASSWORD\u3002<\/p>\n

                                4.2 \u5b89\u5168\u6e05\u5355<\/h4>\n
                                  \n
                                • \u5173\u95ed\u533f\u540d\u8bbf\u95ee；\u8bbe\u5907\/HA\/\u540e\u7aef\u4f7f\u7528\u72ec\u7acb\u8d26\u53f7<\/li>\n
                                • MQTT \u7aef\u53e3\u4e0d\u66b4\u9732\u516c\u7f51；\u8fdc\u7a0b\u7528 VPN \u6216 TLS(8883)<\/li>\n
                                • \u524d\u7aef\u5bf9\u5916 HTTPS（Nginx\/Caddy \u53cd\u4ee3 + \u8bc1\u4e66）<\/li>\n
                                • \u540e\u7aef CORS_ORIGINS \u7531 * \u6536\u7d27\u4e3a\u4f60\u7684\u57df\u540d<\/li>\n
                                • \u5bc6\u94a5\u7528\u73af\u5883\u53d8\u91cf\/\u5bc6\u94a5\u7ba1\u7406，\u4e0d\u5165\u5e93\u4e0d\u5165\u4ee3\u7801<\/li>\n<\/ul>\n

                                  4.3 \u5f00\u673a\u81ea\u542f<\/h4>\n
                                    \n
                                  • Docker：restart: unless-stopped \u5df2\u914d\u7f6e；<\/li>\n
                                  • \u88f8\u673a\u540e\u7aef\u7528 systemd：<\/li>\n<\/ul>\n

                                    # \/etc\/systemd\/system\/gemeopen-backend.service
                                    \n[Unit]
                                    \nDescription=GemeOpen Java Backend
                                    \nAfter=network.target mosquitto.service
                                    \n[Service]
                                    \nWorkingDirectory=\/opt\/gemeopen-ha-java-demo\/backend
                                    \nExecStart=\/usr\/bin\/java -jar \/opt\/gemeopen-ha-java-demo\/backend\/target\/gemeopen-demo.jar
                                    \nEnvironment=MQTT_HOST=192.168.1.10
                                    \nEnvironment=DEVICE_MAC=28372fcbbbb8
                                    \nRestart=always
                                    \n[Install]
                                    \nWantedBy=multi-user.target<\/p>\n

                                    sudo<\/span> systemctl daemon-reload &&<\/span> sudo<\/span> systemctl enable<\/span> –now<\/span> gemeopen-backend<\/p>\n

                                    \n

                                    5. \u65e5\u5e38\u8fd0\u7ef4<\/h3>\n

                                    5.1 \u770b\u65e5\u5fd7<\/h4>\n

                                    docker<\/span> compose logs -f<\/span> backend
                                    \ndocker<\/span> compose logs -f<\/span> mosquitto
                                    \ndocker<\/span> compose logs -f<\/span> frontend<\/p>\n

                                    5.2 \u5065\u5eb7\u68c0\u67e5<\/h4>\n

                                    curl<\/span> http:\/\/localhost:8000\/api\/health
                                    \n# {"status":"ok","mqttConnected":true,"deviceOnline":true}<\/span><\/p>\n

                                    5.3 \u66f4\u65b0<\/h4>\n

                                    docker<\/span> compose up -d<\/span> –build<\/span> # Docker \u65b9\u5f0f<\/span>
                                    \n# \u6216\u88f8\u673a：\u91cd\u65b0 mvn package \u540e\u91cd\u542f\u670d\u52a1<\/span>
                                    \nsudo<\/span> systemctl restart gemeopen-backend<\/p>\n

                                    5.4 \u5907\u4efd<\/h4>\n
                                      \n
                                    • Broker \u6570\u636e：mosquitto-data \u5377；<\/li>\n
                                    • \u5386\u53f2\u6570\u636e：\u5f53\u524d Demo \u5b58\u4e8e\u5185\u5b58，\u91cd\u542f\u5373\u6e05\u7a7a\u3002\u751f\u4ea7\u5efa\u8bae\u6539\u63a5 PostgreSQL \/ InfluxDB \/ TimescaleDB\u3002<\/li>\n<\/ul>\n

                                      5.5 \u76d1\u63a7\u5efa\u8bae<\/h4>\n\n\u6307\u6807\u65b9\u5f0f<\/tr>\n\n\n\n\n\n
                                      \u540e\u7aef\u5b58\u6d3b<\/td>\n\/api\/health + Uptime Kuma \/ \u5b9a\u65f6 curl<\/td>\n<\/tr>\n
                                      JVM \u6307\u6807<\/td>\nSpring Boot Actuator + Prometheus + Grafana<\/td>\n<\/tr>\n
                                      MQTT \u8fde\u63a5\u6570<\/td>\nmosquitto_sub -t '$SYS\/broker\/clients\/connected'<\/td>\n<\/tr>\n
                                      \u8bbe\u5907\u5728\u7ebf<\/td>\n\u540e\u7aef online \u5b57\u6bb5，\u53ef\u52a0 HA \u81ea\u52a8\u5316\u544a\u8b66<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                                      5.6 JVM \u8c03\u4f18（\u53ef\u9009）<\/h4>\n

                                      java<\/span> -Xms256m<\/span> -Xmx512m<\/span> -jar<\/span> target\/gemeopen-demo.jar<\/p>\n

                                      \u5355\u8bbe\u5907\u4f4e\u9891\u4e0a\u62a5\u573a\u666f\u5185\u5b58\u5360\u7528\u5f88\u5c0f；\u53ef\u7ed3\u5408 Actuator \u89c2\u5bdf\u5806\u4f7f\u7528\u3002<\/p>\n

                                      \n

                                      6. \u914d\u7f6e\u901f\u67e5（\u540e\u7aef\u73af\u5883\u53d8\u91cf）<\/h3>\n

                                      \u89c1 [00 \u00b7 \u67b6\u6784\u4e0e\u5951\u7ea6] 00-architecture.md \u7b2c 6 \u8282，\u6216 backend\/src\/main\/resources\/application.yml\u3002<\/p>\n

                                      \n

                                      07-troubleshooting.md<\/h4>\n

                                      07 \u00b7 \u6392\u9519\u624b\u518c<\/h2>\n

                                      \u6309\u201c\u75c7\u72b6\u201d\u67e5\u201c\u539f\u56e0\/\u89e3\u51b3\u201d\u3002\u968f\u8eab\u5907\u597d\u4e24\u6761\u6293\u5305\u547d\u4ee4：<\/p>\n

                                      # \u770b\u8bbe\u5907\u662f\u5426\u5728\u53d1\u6570\u636e（\u8ba2\u9605\u8bbe\u5907\u4e0a\u62a5\u4e3b\u9898）<\/span>
                                      \nmosquitto_sub -h<\/span> 192.168<\/span>.1.10 -p<\/span> 1883<\/span> -t<\/span> 'gemeopen\/gspm1b\/+\/report'<\/span> -v<\/span><\/p>\n

                                      # \u770b\u662f\u5426\u6709\u4eba\u7ed9\u8bbe\u5907\u53d1\u6307\u4ee4（\u8ba2\u9605\u8bbe\u5907\u6307\u4ee4\u4e3b\u9898）<\/span>
                                      \nmosquitto_sub -h<\/span> 192.168<\/span>.1.10 -p<\/span> 1883<\/span> -t<\/span> 'gemeopen\/gspm1b\/+\/command'<\/span> -v<\/span><\/p>\n

                                      \n

                                      \u4e00\u3001\u8bbe\u5907\u4fa7<\/h3>\n\n\u75c7\u72b6\u53ef\u80fd\u539f\u56e0\u89e3\u51b3<\/tr>\n\n\n\n\n\n\n
                                      \u8bbe\u5907\u4e0d\u4e0a\u62a5<\/td>\n\u672a\u5207\u6362\u5230\u81ea\u5efa Broker<\/td>\n\u8fd0\u884c scripts\/configure_device.py \u6267\u884c setting-mqtt，\u518d\u65ad\u7535\u91cd\u542f<\/td>\n<\/tr>\n
                                      \u5207\u6362\u540e\u5f7b\u5e95\u6ca1\u6570\u636e<\/td>\n\u76ee\u6807 Broker \u8bbe\u5907\u4e0d\u53ef\u8fbe<\/td>\n\u5730\u5740\u7528\u5c40\u57df\u7f51 IP\/\u516c\u7f51\u57df\u540d，\u653e\u884c 1883<\/td>\n<\/tr>\n
                                      \u4e0a\u62a5\u95f4\u9694\u5f88\u957f<\/td>\n\u7535\u6c60\/\u7f13\u5b58\u7b56\u7565<\/td>\n\u628a timerInterval \u8c03\u5c0f（\u5982 15s）<\/td>\n<\/tr>\n
                                      \u901a\u7535\u540e\u6570\u636e\u4e0d\u5237\u65b0<\/td>\n\u672a\u5f00\u5b9a\u65f6\u4e0a\u62a5<\/td>\n\u53d1 {"timerEnable":1,"timerInterval":15,"type":"setting"}<\/td>\n<\/tr>\n
                                      \u6539\u4e86\u53c2\u6570\u4e0d\u751f\u6548<\/td>\n\u90e8\u5206\u8bbe\u7f6e\u9700\u91cd\u542f<\/td>\n\u65ad\u7535\u91cd\u542f\u6216\u53d1 {"system":"restart","type":"setting"}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                      \n

                                      \u4e8c\u3001MQTT Broker<\/h3>\n\n\u75c7\u72b6\u53ef\u80fd\u539f\u56e0\u89e3\u51b3<\/tr>\n\n\n\n\n\n
                                      \u5ba2\u6237\u7aef\u8fde\u4e0d\u4e0a<\/td>\n\u7aef\u53e3\/\u5730\u5740\/\u9632\u706b\u5899<\/td>\ndocker compose ps\u3001docker compose logs mosquitto<\/td>\n<\/tr>\n
                                      not authorised<\/td>\n\u5f00\u4e86\u8ba4\u8bc1\u4f46\u51ed\u636e\u9519<\/td>\n\u6838\u5bf9 passwd，\u6216\u4e34\u65f6\u6539\u56de allow_anonymous true \u9a8c\u8bc1<\/td>\n<\/tr>\n
                                      \u8ba2\u9605\u6536\u4e0d\u5230<\/td>\n\u4e3b\u9898\u62fc\u5199\u9519<\/td>\n\u7528 + \u901a\u914d\u6d4b\u8bd5 gemeopen\/gspm1b\/+\/report<\/td>\n<\/tr>\n
                                      \u5bb9\u5668\u8d77\u4e0d\u6765<\/td>\n\u914d\u7f6e\u8bed\u6cd5\u9519<\/td>\n\u67e5\u770b mosquitto \u65e5\u5fd7<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                      \n

                                      \u4e09\u3001Home Assistant<\/h3>\n\n\u75c7\u72b6\u53ef\u80fd\u539f\u56e0\u89e3\u51b3<\/tr>\n\n\n\n\n\n\n\n
                                      MQTT \u96c6\u6210\u6dfb\u52a0\u5931\u8d25<\/td>\nBroker \u5730\u5740\/\u51ed\u636e\u9519<\/td>\nDocker \u573a\u666f\u7528\u5bbf\u4e3b\u673a IP<\/td>\n<\/tr>\n
                                      switch \u4e0d\u53ef\u7528<\/td>\nstate_topic \u65e0\u6570\u636e<\/td>\n\u5148\u786e\u4fdd\u8bbe\u5907\u5728\u62a5\u6570\u636e；\u68c0\u67e5 <MAC> \u662f\u5426\u66ff\u6362<\/td>\n<\/tr>\n
                                      \u70b9\u5f00\u5173\u6ca1\u53cd\u5e94<\/td>\ncommand_topic \u586b\u6210 report<\/td>\n\u5fc5\u987b\u662f\u8bbe\u5907 subcribe \u4e3b\u9898（…\/command）<\/td>\n<\/tr>\n
                                      \u4f20\u611f\u5668\u4e00\u76f4\u201c\u672a\u77e5\u201d<\/td>\n\u672a\u5f00\u5b9a\u65f6\u4e0a\u62a5<\/td>\n\u5f00\u542f\u4e0a\u62a5；\u6293\u5305\u786e\u8ba4\u5b57\u6bb5\u540d<\/td>\n<\/tr>\n
                                      \u80fd\u6e90\u9762\u677f\u65e0\u6570\u636e<\/td>\n\u7f3a state_class<\/td>\n\u786e\u8ba4 energy \u4f20\u611f\u5668 total_increasing<\/td>\n<\/tr>\n
                                      \u6539 YAML \u4e0d\u751f\u6548<\/td>\n\u672a\u91cd\u8f7d<\/td>\n\u5f00\u53d1\u8005\u5de5\u5177 \u2192 YAML \u2192 \u68c0\u67e5\u914d\u7f6e \u2192 \u91cd\u542f HA<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                      \n

                                      \u56db\u3001Java \u540e\u7aef（Spring Boot）<\/h3>\n\n\u75c7\u72b6\u53ef\u80fd\u539f\u56e0\u89e3\u51b3<\/tr>\n\n\n\n\n\n\n\n
                                      \u542f\u52a8\u62a5 Port 8000 already in use<\/td>\n\u7aef\u53e3\u88ab\u5360\u7528<\/td>\n\u6539 server.port \u6216\u505c\u6389\u5360\u7528\u8fdb\u7a0b<\/td>\n<\/tr>\n
                                      \/api\/health \u91cc mqttConnected:false<\/td>\n\u8fde\u4e0d\u4e0a Broker<\/td>\n\u68c0\u67e5 MQTT_HOST\/PORT\/USERNAME\/PASSWORD<\/td>\n<\/tr>\n
                                      \/api\/device \u5168\u4e3a null<\/td>\n\u6ca1\u6536\u5230\u8bbe\u5907\u4e0a\u62a5<\/td>\n\u7528 mosquitto_sub \u9a8c\u8bc1\u8bbe\u5907\u5728\u53d1<\/td>\n<\/tr>\n
                                      \u5f00\u5173\u63a5\u53e3 success:true \u4f46\u5b9e\u7269\u65e0\u53cd\u5e94<\/td>\nMQTT_COMMAND_TOPIC \u7684 {mac} \u672a\u66ff\u6362<\/td>\n\u68c0\u67e5 DEVICE_MAC \u4e0e topic \u6a21\u677f<\/td>\n<\/tr>\n
                                      \u7f16\u8bd1\u62a5\u4f9d\u8d56\u4e0b\u8f7d\u5931\u8d25<\/td>\n\u7f51\u7edc\u6296\u52a8<\/td>\n\u91cd\u8bd5 mvn -DskipTests package；\u914d\u7f6e\u955c\u50cf<\/td>\n<\/tr>\n
                                      \u60f3\u8c03\u65e5\u5fd7\u7ea7\u522b<\/td>\n\u2014<\/td>\napplication.yml \u91cc logging.level.com.gemeopen=DEBUG<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                                      \u5c0f\u6280\u5de7：mvn -DskipTests package \u6253\u5305\u540e java -jar target\/gemeopen-demo.jar \u6700\u63a5\u8fd1\u751f\u4ea7\u8fd0\u884c\u65b9\u5f0f\u3002<\/p>\n

                                      \n

                                      \u4e94\u3001Angular \u524d\u7aef<\/h3>\n\n\u75c7\u72b6\u53ef\u80fd\u539f\u56e0\u89e3\u51b3<\/tr>\n\n\n\n\n\n\n\n
                                      \u9875\u9762\u4e00\u76f4\u201c\u79bb\u7ebf\u201d<\/td>\n\u540e\u7aef\u672a\u8d77\/\u5730\u5740\u9519<\/td>\n\u6253\u5f00 http:\/\/localhost:8000\/api\/health；\u68c0\u67e5 environment.ts<\/td>\n<\/tr>\n
                                      \u6709\u6570\u636e\u4f46\u4e0d\u5237\u65b0<\/td>\nWebSocket \u88ab\u4ee3\u7406\u62e6\u622a<\/td>\n\u5f00\u53d1\u7528 proxy.conf.json；\u751f\u4ea7\u7528 nginx.conf \u7684 \/ws \u6bb5<\/td>\n<\/tr>\n
                                      \u8de8\u57df\u62a5\u9519<\/td>\n\u540e\u7aef\u672a\u5141\u8bb8\u6765\u6e90<\/td>\n\u540e\u7aef CORS_ORIGINS \u8bbe\u4e3a\u524d\u7aef\u5730\u5740<\/td>\n<\/tr>\n
                                      \u56fe\u8868\u4e3a\u7a7a<\/td>\n\/api\/device\/history \u65e0\u6570\u636e<\/td>\n\u9700\u5148\u79ef\u7d2f\u82e5\u5e72\u6761\u4e0a\u62a5<\/td>\n<\/tr>\n
                                      npm install \u5f88\u6162<\/td>\n\u7f51\u7edc\/\u955c\u50cf<\/td>\n\u6362 npm \u955c\u50cf\u6e90，\u6216\u4f7f\u7528 Docker \u6784\u5efa<\/td>\n<\/tr>\n
                                      \u6784\u5efa\u540e\u63a5\u53e3 404<\/td>\n\u751f\u4ea7 apiBase \u672a\u8d70\u540c\u6e90<\/td>\n\u751f\u4ea7\u6784\u5efa\u7528 environment.prod.ts（apiBase: ''）+ Nginx \u53cd\u4ee3<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                      \n

                                      \u516d\u3001\u7f51\u7edc\u8fde\u901a\u6027\u81ea\u67e5（\u4e07\u80fd\u56db\u8fde）<\/h3>\n

                                      # 1) \u80fd\u5426\u5411 Broker \u53d1\u5e03\u6d4b\u8bd5\u6d88\u606f<\/span>
                                      \nmosquitto_pub -h<\/span> 192.168<\/span>.1.10 -p<\/span> 1883<\/span> -t<\/span> test<\/span> -m<\/span> hello<\/p>\n

                                      # 2) \u540e\u7aef \u2192 Broker \u914d\u7f6e<\/span>
                                      \ndocker<\/span> compose exec<\/span> backend sh<\/span> -c<\/span> 'echo $MQTT_HOST'<\/span><\/p>\n

                                      # 3) \u6d4f\u89c8\u5668\/\u547d\u4ee4\u884c \u2192 \u540e\u7aef<\/span>
                                      \ncurl<\/span> http:\/\/192.168.1.10:8000\/api\/health<\/p>\n

                                      # 4) HA \u2192 Broker（MQTT \u96c6\u6210\u9875\u9762\u770b\u201c\u5df2\u8fde\u63a5\u201d）<\/span><\/p>\n

                                      \u7edd\u5927\u591a\u6570\u95ee\u9898\u90fd\u80fd\u901a\u8fc7\u300c\u786e\u8ba4\u6570\u636e\u662f\u5426\u5230\u8fbe Broker\u300d\u5feb\u901f\u5b9a\u4f4d\u662f\u8bbe\u5907\u4fa7\u3001Broker \u4fa7\u8fd8\u662f\u5e94\u7528\u4fa7\u3002<\/p>\n

                                      \n","protected":false},"excerpt":{"rendered":"

                                      GemeOpen GSPM1B \u00d7 Home Assistant \u00d7 Java(Spring Boot) Angular Demo
                                      \n\u628a GemeOpen GSPM1B \u667a\u80fd\u8f6c\u6362\u5668\u63d2\u5ea7 \u63a5\u5165 Home Assistant，\u5b9e\u73b0 \u901a\u65ad\u7535\u63a7\u5236 \u4e0e \u7535\u538b \/ \u7535\u6d41 \/ \u529f\u7387 \/ \u7d2f\u8ba1\u7528\u7535\u91cf \u91c7\u96c6；\u5e76\u9644\u4e00\u5957 Java(Spring Boot) Angular \u7684\u5b8c\u6574\u81ea\u7814 Demo\u3002 \u9762\u5411\u7a0b\u5e8f\u5458\u521d\u5b66\u8005：\u6587\u6863\u4ece\u96f6\u8bb2\u8d77，\u6bcf\u4e00\u6b65\u90fd\u53ef<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[5120,99,190],"topic":[],"class_list":["post-112347","post","type-post","status-publish","format-standard","hentry","category-server","tag-angular-js","tag-java","tag-190"],"yoast_head":"\nMQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wsisp.com\/helps\/112347.html\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"og:description\" content=\"GemeOpen GSPM1B \u00d7 Home Assistant \u00d7 Java(Spring Boot) Angular Demo \u628a GemeOpen GSPM1B \u667a\u80fd\u8f6c\u6362\u5668\u63d2\u5ea7 \u63a5\u5165 Home Assistant，\u5b9e\u73b0 \u901a\u65ad\u7535\u63a7\u5236 \u4e0e \u7535\u538b \/ \u7535\u6d41 \/ \u529f\u7387 \/ \u7d2f\u8ba1\u7528\u7535\u91cf \u91c7\u96c6；\u5e76\u9644\u4e00\u5957 Java(Spring Boot) Angular \u7684\u5b8c\u6574\u81ea\u7814 Demo\u3002 \u9762\u5411\u7a0b\u5e8f\u5458\u521d\u5b66\u8005：\u6587\u6863\u4ece\u96f6\u8bb2\u8d77，\u6bcf\u4e00\u6b65\u90fd\u53ef\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wsisp.com\/helps\/112347.html\" \/>\n<meta property=\"og:site_name\" content=\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-03T01:08:49+00:00\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"14 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/112347.html\",\"url\":\"https:\/\/www.wsisp.com\/helps\/112347.html\",\"name\":\"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"isPartOf\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\"},\"datePublished\":\"2026-10-03T01:08:49+00:00\",\"dateModified\":\"2026-10-03T01:08:49+00:00\",\"author\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/112347.html#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wsisp.com\/helps\/112347.html\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/112347.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.wsisp.com\/helps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\",\"url\":\"https:\/\/www.wsisp.com\/helps\/\",\"name\":\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"description\":\"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"contentUrl\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"caption\":\"admin\"},\"sameAs\":[\"http:\/\/wp.wsisp.com\"],\"url\":\"https:\/\/www.wsisp.com\/helps\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wsisp.com\/helps\/112347.html","og_locale":"zh_CN","og_type":"article","og_title":"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","og_description":"GemeOpen GSPM1B \u00d7 Home Assistant \u00d7 Java(Spring Boot) Angular Demo \u628a GemeOpen GSPM1B \u667a\u80fd\u8f6c\u6362\u5668\u63d2\u5ea7 \u63a5\u5165 Home Assistant，\u5b9e\u73b0 \u901a\u65ad\u7535\u63a7\u5236 \u4e0e \u7535\u538b \/ \u7535\u6d41 \/ \u529f\u7387 \/ \u7d2f\u8ba1\u7528\u7535\u91cf \u91c7\u96c6；\u5e76\u9644\u4e00\u5957 Java(Spring Boot) Angular \u7684\u5b8c\u6574\u81ea\u7814 Demo\u3002 \u9762\u5411\u7a0b\u5e8f\u5458\u521d\u5b66\u8005：\u6587\u6863\u4ece\u96f6\u8bb2\u8d77，\u6bcf\u4e00\u6b65\u90fd\u53ef","og_url":"https:\/\/www.wsisp.com\/helps\/112347.html","og_site_name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","article_published_time":"2026-10-03T01:08:49+00:00","author":"admin","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"admin","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"14 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wsisp.com\/helps\/112347.html","url":"https:\/\/www.wsisp.com\/helps\/112347.html","name":"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","isPartOf":{"@id":"https:\/\/www.wsisp.com\/helps\/#website"},"datePublished":"2026-10-03T01:08:49+00:00","dateModified":"2026-10-03T01:08:49+00:00","author":{"@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41"},"breadcrumb":{"@id":"https:\/\/www.wsisp.com\/helps\/112347.html#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wsisp.com\/helps\/112347.html"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wsisp.com\/helps\/112347.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.wsisp.com\/helps"},{"@type":"ListItem","position":2,"name":"MQTT\u667a\u80fd\u63d2\u5ea7\u5982\u4f55\u63a5\u5165Home Assistant\uff0c\u4ece\u96f6\u5f00\u59cb\u5b8c\u6574\u5de5\u7a0b\u5b9e\u73b0\uff08Java+Angular\uff09"}]},{"@type":"WebSite","@id":"https:\/\/www.wsisp.com\/helps\/#website","url":"https:\/\/www.wsisp.com\/helps\/","name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","description":"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41","name":"admin","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/","url":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","contentUrl":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","caption":"admin"},"sameAs":["http:\/\/wp.wsisp.com"],"url":"https:\/\/www.wsisp.com\/helps\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/112347","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/comments?post=112347"}],"version-history":[{"count":0,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/112347\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media?parent=112347"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/categories?post=112347"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/tags?post=112347"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/topic?post=112347"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}