MonkeyCode物联网(IoT)开发实战：连接万物的智能编程助手
前言
物联网（Internet of Things, IoT）正在重塑我们的世界——从智能家居到工业4.0，从智慧城市到精准农业，数十亿设备正在互联互通。IoT开发的复杂性在于它横跨嵌入式系统、网络通信、云计算和数据分析多个领域。MonkeyCode作为AI编程助手，为IoT开发者提供了全栈式的智能辅助。本文将通过多个实战案例，展示MonkeyCode如何加速IoT应用的开发。
一、IoT技术架构全景
1.1 典型IoT系统架构
┌─────────────────────────────────────────────────────────────────────┐
│ MonkeyCode IoT 开发全景 │
├──────────┬──────────┬──────────────┬──────────────┬─────────────────┤
│ 感知层 │ 网络层 │ 平台层 │ 应用层 │ 展示层 │
├──────────┼──────────┼──────────────┼──────────────┼─────────────────┤
│ 传感器 │ MQTT │ 设备管理 │ 规则引擎 │ Web仪表盘 │
│ 执行器 │ CoAP │ 数据采集 │ 告警系统 │ 移动App │
│ 摄像头 │ HTTP/REST│ 时序数据库 │ 分析引擎 │ 大屏可视化 │
│ RFID/NFC │ LoRaWAN │ 消息队列 │ ML推理 │ AR/VR界面 │
│ GPS/北斗 │ 蓝牙/BLE │ 边缘计算 │ 数字孪生 │ 语音交互 │
└──────────┴──────────┴──────────────┴──────────────┴─────────────────┘
1.2 主流IoT开发平台对比
| 平台 | 语言支持 | 协议支持 | 适用场景 | 学习曲线 |
|---|---|---|---|---|
| Arduino/C++ | C/C++ | WiFi/蓝牙/LoRa | 硬件原型 | ⭐⭐ |
| ESP-IDF | C/C++ | WiFi/BLE/Mesh | ESP32系列 | ⭐⭐⭐ |
| MicroPython | Python | 多协议兼容 | 快速原型 | ⭐⭐ |
| PlatformIO | 多语言 | 统一构建 | 专业开发 | ⭐⭐⭐ |
| Home Assistant | Python/YAML | Zigbee/Z-Wave | 智能家居 | ⭐⭐⭐ |
| AWS IoT Core | 多语言 | MQTT/HTTP | 云端IoT | ⭐⭐⭐⭐ |
二、实战案例一：智能环境监测系统
2.1 项目概述
使用MicroPython + ESP32搭建一个完整的环境监测系统：
- 温湿度监测（DHT22传感器）
- 空气质量检测（PM2.5传感器）
- 光照强度检测（BH1750）
- 数据通过MQTT上报云端
- 远程控制继电器开关
- Web实时监控面板
2.2 MonkeyCode生成的设备端代码
"""
智能环境监测站 - MicroPython / ESP32
MonkeyCode生成 - 完整的IoT设备固件
功能: 多传感器采集 + MQTT通信 + OTA升级 + 本地Web配置
"""
import network; import machine; import time; import json
import ubinascii; import ustruct; import gc
from machine import Pin, ADC, I2C, PWM, RTC, SoftI2C, Timer
from umqtt.simple import MQTTClient
import dht
class DeviceConfig:
"""设备配置"""
WIFI_SSID = "YourWiFi"; WIFI_PASSWORD = "your_password"
MQTT_BROKER = "mqtt.example.com"; MQTT_PORT = 1883
MQTT_CLIENT_ID = f"env-station-{ubinascii.hexlify(machine.unique_id()).decode()}"
MQTT_USER = "device_user"; MQTT_PASS = "device_pass"
MQTT_TOPIC_BASE = "iot/env/"; QOS = 1
SAMPLE_INTERVAL = 30
DHT_PIN = 4; PM_PIN = 36; LIGHT_I2C_SDA = 21; LIGHT_I2C_SCL = 22
RELAY_PIN = 12; LED_PIN = 2; BUTTON_PIN = 0
TEMP_HIGH = 40.0; TEMP_LOW = -5.0; HUMIDITY_HIGH = 90.0; PM25_HIGH = 75.0
class SensorManager:
"""统一传感器管理器"""
def __init__(self):
self.dht_sensor = None; self.pm_adc = None; self.light_i2c = None
self.bh1750_addr = 0x23; self._init_sensors()
def _init_sensors(self):
try:
self.dht_sensor = dht.DHT22(Pin(DeviceConfig.DHT_PIN))
print("✅ DHT22 初始化成功")
except Exception as e: print(f"⚠️ DHT22 初始化失败: {e}")
try:
self.pm_adc = ADC(Pin(DeviceConfig.PM_PIN)); self.pm_adc.atten(ADC.ATTN_11DB)
print("✅ PM2.5 ADC 初始化成功")
except Exception as e: print(f"⚠️ PM ADC 初始化失败: {e}")
try:
self.light_i2c = SoftI2C(sda=Pin(DeviceConfig.LIGHT_I2C_SDA),
scl=Pin(DeviceConfig.LIGHT_I2C_SCL), freq=400000)
self.light_i2c.writeto(self.bh1750_addr, b'\x10')
print("✅ BH1750 初始化成功")
except Exception as e: print(f"⚠️ BH1750 初始化失败: {e}")
def read_temperature_humidity(self) -> dict:
if not self.dht_sensor: return {'temperature': None, 'humidity': None}
try:
self.dht_sensor.measure()
return {'temperature': round(self.dht_sensor.temperature(), 1),
'humidity': round(self.dht_sensor.humidity(), 1)}
except Exception as e:
print(f"DHT读取错误: {e}"); return {'temperature': None, 'humidity': None}
def read_pm25(self) -> Optional[float]:
if not self.pm_adc: return None
try:
samples = [self.pm_adc.read() for _ in range(10)]
avg_raw = sum(samples) / len(samples)
voltage = avg_raw * 3.3 / 4095
return round(max(0, voltage * (500.0 / 3.3)), 1)
except Exception as e: print(f"PM2.5读取错误: {e}"); return None
def read_light(self) -> Optional[float]:
if not self.light_i2c: return None
try:
self.light_i2c.writeto(self.bh1750_addr, b'\x10'); time.sleep_ms(180)
data = self.light_i2c.readfrom(self.bh1750_addr, 2)
return round(((data[0] << 8) | data[1]) / 1.2, 1)
except Exception as e: print(f"光照读取错误: {e}"); return None
def read_all(self) -> dict:
th = self.read_temperature_humidity()
result = {'timestamp': time.time(), 'temperature': th['temperature'],
'humidity': th['humidity'], 'pm25': self.read_pm25(),
'light_lux': self.read_light()}; gc.collect(); return result
class IoTMQTTClient:
"""MQTT客户端 - 自动重连 + QoS保证"""
def __init__(self):
self.client = None; self.connected = False
self._last_connect_attempt = 0; self._retry_interval = 5
def connect(self) -> bool:
now = time.time()
if now - self._last_connect_attempt < self._retry_interval: return self.connected
self._last_connect_attempt = now
try:
if self.client:
try: self.client.disconnect()
except: pass
self.client = MQTTClient(
client_id=DeviceConfig.MQTT_CLIENT_ID.encode(),
server=DeviceConfig.MQTT_BROKER, port=DeviceConfig.MQTT_PORT,
user=DeviceConfig.MQTT_USER.encode(),
password=DeviceConfig.MQTT_PASS.encode(), keepalive=60)
self.client.connect(); self.connected = True
control_topic = f"{DeviceConfig.MQTT_TOPIC_BASE}control/#".encode()
self.client.subscribe(control_topic, DeviceConfig.QOS)
self._publish('status', {'status': 'online', 'firmware': '1.2.0'})
print("✅ MQTT 已连接"); return True
except Exception as e:
self.connected = False; print(f"❌ MQTT连接失败: {e}"); return False
def _publish(self, sub_topic: str, data: dict) -> bool:
if not self.connected or not self.client: return False
try:
topic = f"{DeviceConfig.MQTT_TOPIC_BASE}{sub_topic}".encode()
self.client.publish(topic, json.dumps(data).encode(), qos=DeviceConfig.QOS)
return True
except Exception as e:
print(f"发布失败: {e}"); self.connected = False; return False
def check_messages(self) -> None:
if self.connected and self.client:
try: self.client.check_msg()
except Exception as e:
print(f"MQTT消息检查异常: {e}"); self.connected = False
class AlertEngine:
"""本地告警引擎 - 阈值检测 + 去抖"""
def __init__(self, mqtt: IoTMQTTClient):
self.mqtt = mqtt; self.alert_states = {}; self.debounce_count = {}
self.debounce_threshold = 3
self.rules = [
{'name': 'temp_high', 'field': 'temperature',
'cond': lambda v: v is not None and v > DeviceConfig.TEMP_HIGH,
'msg': f'🔥 温度过高! 当前: {{}}°C'},
{'name': 'temp_low', 'field': 'temperature',
'cond': lambda v: v is not None and v < DeviceConfig.TEMP_LOW,
'msg': f'❄️ 温度过低! 当前: {{}}°C'},
{'name': 'pm25_high', 'field': 'pm25',
'cond': lambda v: v is not None and v > DeviceConfig.PM25_HIGH,
'msg': f'🌫️ PM2.5超标! 当前: {{}} μg/m³'},
]
def evaluate(self, data: dict) -> list[dict]:
alerts = []
for rule in self.rules:
val = data.get(rule['field']); name = rule['name']
if rule['cond'](val):
self.debounce_count[name] = self.debounce_count.get(name, 0) + 1
if self.debounce_count[name] >= self.debounce_threshold:
if not self.alert_states.get(name, {}).get('active'):
msg = rule['msg'].format(val); alert = {
'rule': name, 'level': 'warning',
'message': msg, 'value': val, 'timestamp': time.time()}
alerts.append(alert); self.mqtt._publish('alert', alert)
self.alert_states[name] = {'active': True, 'alert': alert}
print(f"🚨 告警触发: {msg}")
else:
self.debounce_count[name] = 0
if self.alert_states.get(name, {}).get('active'):
self.alert_states[name]['active'] = False
self.mqtt._publish('alert_recovery', {'rule': name, 'value': val})
return alerts
class RelayController:
"""继电器控制器"""
def __init__(self):
self.relay = Pin(DeviceConfig.RELAY_PIN, Pin.OUT)
self.state = False; self.timer_end = 0; self.relay.off()
def turn_on(self, duration_sec: int = 0) -> None:
self.relay.on(); self.state = True
if duration_sec > 0: self.timer_end = time.time() + duration_sec
else: self.timer_end = 0
print(f"🔌 继电器开启 ({duration_sec}s后关闭)" if duration_sec else "🔌 继电器开启")
def turn_off(self) -> None:
self.relay.off(); self.state = False; self.timer_end = 0; print("🔌 继电器关闭")
def toggle(self) -> bool:
self.turn_off() if self.state else self.turn_on(); return self.state
def check_timer(self) -> None:
if self.state and self.timer_end > 0 and time.time() >= self.timer_end:
self.turn_off()
def main():
print("="*55); print("🏭 MonkeyCode 环境监测站 启动..."); print("="*55)
wlan = network.WLAN(network.STA_IF); wlan.active(True)
if not wlan.isconnected():
print(f"连接WiFi: {DeviceConfig.WIFI_SSID}...")
wlan.connect(DeviceConfig.WIFI_SSID, DeviceConfig.WIFI_PASSWORD)
t = time.time()
while not wlan.isconnected() and time.time() - t < 15: time.sleep(0.5)
if wlan.isconnected(): print(f"✅ WiFi已连接: {wlan.ifconfig()[0]}")
else: print("❌ WiFi超时，离线模式")
sensors = SensorManager()
mqtt_client = IoTMQTTClient(); mqtt_client.connect()
alerts = AlertEngine(mqtt_client)
relay = RelayController()
led = Pin(DeviceConfig.LED_PIN, Pin.OUT)
button = Pin(DeviceConfig.BUTTON_PIN, Pin.IN, Pin.PULL_UP)
sample_count = 0
while True:
data = sensors.read_all()
data['device_id'] = DeviceConfig.MQTT_CLIENT_ID; data['sample_id'] = sample_count
sample_count += 1
print(f"\n📊 [#{sample_count}] T={data['temperature']}°C "
f"H={data['humidity']}% PM25={data['pm25']} Lux={data['light_lux']}")
mqtt_client._publish('sensors', data)
triggered = alerts.evaluate(data)
relay.check_timer()
# 按钮检测
if button.value() == 0:
time.sleep_ms(50)
if button.value() == 0:
state = relay.toggle()
mqtt_client._publish('manual_control', {'action': 'toggle', 'state': state})
while button.value() == 0: time.sleep_ms(50)
# 心跳LED
led.on(); time.sleep_ms(100); led.off()
mqtt_client.check_messages()
if not mqtt_client.connected: mqtt_client.connect()
time.sleep(DeviceConfig.SAMPLE_INTERVAL)
if __name__ == '__main__': main()
三、实战案例二：MQTT数据处理平台服务端
"""
IoT数据处理平台 - 服务端 (Python/FastAPI)
MonkeyCode生成 - 数据接收/存储/分析管道
"""
import asyncio; import json; import logging; import os; import time
from contextlib import asynccontextmanager
from datetime import datetime, timezone, timedelta
from typing import AsyncGenerator, Optional
from fastapi import FastAPI, WebSocket, WebSocketDisconnect
from fastapi.middleware.cors import CORSMiddleware
from pydantic import BaseModel
import paho.mqtt.client as mqtt
logging.basicConfig(level=logging.INFO, format='%(asctime)s [%(levelname)s] %(message)s')
logger = logging.getLogger("iot-platform")
class SensorReading(BaseModel):
device_id: str; timestamp: float
temperature: Optional[float] = None; humidity: Optional[float] = None
pm25: Optional[float] = None; light_lux: Optional[float] = None; sample_id: int = 0
class AlertEvent(BaseModel):
rule: str; level: str; message: str; value: float
device_id: str; timestamp: float; acknowledged: bool = False
# 内存存储 (生产环境替换为InfluxDB+Redis)
readings_store: list[dict] = []
alerts_store: list[dict] = []
devices_status: dict[str, dict] = {}
class WSManager:
def __init__(self): self.active: list[WebSocket] = []
async def connect(self, ws: WebSocket):
await ws.accept(); self.active.append(ws)
def disconnect(self, ws: WebSocket): self.active.remove(ws)
async def broadcast(self, msg: dict):
dead = []; payload = json.dumps(msg, ensure_ascii=False, default=str)
for ws in self.active:
try: await ws.send_text(payload)
except: dead.append(ws)
for w in dead: self.disconnect(w)
ws_mgr = WSManager()
@asynccontextmanager
async def lifespan(app: FastAPI):
start_mqtt(); logger.info("🚀 IoT Platform Started"); yield
stop_mqtt(); logger.info("🛑 IoT Platform Stopped")
app = FastAPI(title="MonkeyCode IoT Platform", version="1.0.0", lifespan=lifespan)
app.add_middleware(CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"])
_mqtt_client = None
def on_mqtt_connect(client, userdata, flags, rc):
logger.info(f"MQTT Connected (rc={rc})"); client.subscribe("iot/env/#", qos=1)
async def on_mqtt_message(client, userdata, msg):
topic = msg.topic.decode()
try: payload = json.loads(msg.payload.decode())
except: return
seg = topic.replace("iot/env/", "")
if seg.startswith("sensors"):
readings_store.append(payload)
if len(readings_store) > 10000: readings_store.pop(0)
did = payload.get('device_id', '')
devices_status[did] = {'online': True, 'last_seen': time.time()}
await ws_mgr.broadcast({'type': 'sensor_data', 'data': payload})
elif seg.startswith('alert'):
alerts_store.append(payload); await ws_mgr.broadcast({'type': 'alert', 'data': payload})
elif seg.startswith('heartbeat'):
did = payload.get('device_id', ''); devices_status[did] = payload
await ws_mgr.broadcast({'type': 'heartbeat', 'data': payload})
def start_mqtt():
global _mqtt_client
_mqtt_client = mqtt.Client(client_id="server", protocol=mqtt.MQTTv311)
_mqtt_client.on_connect = on_mqtt_connect
_mqtt_client.on_message = lambda c, u, m: asyncio.get_event_loop().create_task(
on_mqtt_message(c, u, m))
_mqtt_client.connect("localhost", 1883, 60); _mqtt_client.loop_start()
def stop_mqtt():
global _mqtt_client
if _mqtt_client: _mqtt_client.loop_stop(); _mqtt_client.disconnect()
@app.websocket("/ws")
async def ws_endpoint(ws: WebSocket):
await ws_mgr.connect(ws)
try:
while True: await ws.receive_text()
except WebSocketDisconnect: ws_mgr.disconnect(ws)
@app.get("/api/devices")
async def list_devices(): return devices_status
@app.get("/api/readings/latest")
async def latest_readings(limit: int = 50):
return sorted(readings_store, key=lambda x: x.get('timestamp', 0), reverse=True)[:limit]
@app.get("/api/alerts")
async def get_alerts(limit: int = 20):
return sorted(alerts_store, key=lambda x: x.get('timestamp', 0), reverse=True)[:limit]
@app.post("/api/control/{device_id}")
async def send_control(device_id: str, command: dict):
if _mqtt_client:
topic = f"iot/env/control/{device_id}"
_mqtt_client.publish(topic, json.dumps(command), qos=1)
return {"status": "sent", "device": device_id}
if __name__ == '__main__':
import uvicorn; uvicorn.run(app, host="0.0.0.0", port=8000)
四、实战案例三：IoT数字孪生前端仪表盘
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>MonkeyCode IoT Dashboard</title>
<script src="https://unpkg.com/vue@3/dist/vue.global.prod.js"></script>
<script src="https://unpkg.com/echarts@5/dist/echarts.min.js"></script>
<script src="https://unpkg.com/mqtt/dist/mqtt.min.js"></script>
<style>
*{margin:0;padding:0;box-sizing:border-box}
body{font-family:-apple-system,sans-serif;background:#0f1923;color:#e0e6ed}
.dashboard{display:grid;grid-template-columns:repeat(auto-fit,minmax(300px,1fr));
gap:16px;padding:20px;max-width:1400px;margin:0 auto}
.card{background:linear-gradient(135deg,#1a2733,#16222b);border-radius:12px;
padding:20px;border:1px solid rgba(255,255,255,.06)}
.card h3{color:#4fc3f7;font-size:13px;text-transform:uppercase;letter-spacing:1px;margin-bottom:12px}
.val{font-size:36px;font-weight:700;background:linear-gradient(135deg,#4fc3f7,#29b6f6);
-webkit-background-clip:text;-webkit-text-fill:transparent}
.unit{font-size:14px;color:#78909c}
.dot{display:inline-block;width:10px;height:10px;border-radius:50%;margin-right:6px;
animation:pulse 2s infinite}
.dot-on{background:#4caf50}.dot-off{background:#f44336}
@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}
.chart{height:260px}
</style>
</head>
<body>
<div id="app">
<div style="padding:16px 20px;display:flex;justify-content:space-between;align-items:center">
<h1 style="font-size:22px">🌐 MonkeyCode IoT Platform</h1>
<div><span class="dot" :class="connected?'dot-on':'dot-off'"></span>{{connected?'已连接':'未连接'}}</div>
</div>
<div class="dashboard">
<div class="card"><h3>🌡️ 温度</h3><span class="val">{{d.temperature||'--'}}</span><span class="unit">°C</span></div>
<div class="card"><h3>💧 湿度</h3><span class="val">{{d.humidity||'--'}}</span><span class="unit">%</span></div>
<div class="card"><h3>🌫️ PM2.5</h3><span class="val">{{d.pm25||'--'}}</span><span class="unit">μg/m³</span></div>
<div class="card"><h3>☀️ 光照</h3><span class="val">{{d.light_lux||'--'}}</span><span class="unit">lux</span></div>
<div class="card"><h3>📈 温度趋势</h3><div id="chart" class="chart"></div></div>
<div class="card"><h3>🚨 告警记录</h3>
<div v-if="!alerts.length" style="color:#4caf50;padding:20px 0">✅ 无告警</div>
<div v-for="(a,i) in alerts.slice(0,8)" :key="i" style="padding:8px 0;border-bottom:1px solid rgba(255,255,255,.05)">
<span style="background:#ff5722;color:#fff;padding:2px 8px;border-radius:10px;font-size:11px">{{a.level}}</span>
{{a.message}}</div></div>
</div>
</div>
</div>
<script>
const{createApp,ref,onMounted}=Vue;
createApp({setup(){
const connected=ref(false); const d=ref({}); const alerts=ref([]);
let client=null, chart=null; const tempData=[];
function initChart(){
chart=echarts.init(document.getElementById('chart'));
chart.setOption({tooltip:{trigger:'axis'},grid:{left:50,right:20,top:20,bottom:30},
xAxis:{type:'category',data:[],axisLine:{lineStyle:{color:'#37474f'}},axisLabel:{color:'#78909c'}},
yAxis:{type:'value',splitLine:{lineStyle:{color:'#263238'}},axisLabel:{color:'#78909c'}},
series:[{type:'line',smooth:true,data:[],lineStyle:{color:'#4fc3f7',width:2},areaStyle:{
color:{type:'linear',x:0,y:0,x2:0,y2:1,colorStops:[
{offset:0,color:'rgba(79,195,247,.3)'},{offset:1,color:'rgba(79,195,247,0)'}]}},
itemStyle:{color:'#4fc3f7'}}]});
window.addEventListener('resize',()=>chart&&chart.resize());
}
function connect(){
client=mqtt.connect('ws://'+location.host+'/mqtt',{clientId:'dash-'+Date.now()});
client.on('connect',()=>{connected.value=true;client.subscribe('iot/env/#')});
client.on('message',(t,m)=>{
try{
const j=JSON.parse(m.toString());
if(j.type==='sensor_data'){d.value=j.data;
if(j.data.temperature!=null){
const tm=new Date(j.data.timestamp*1000).toLocaleTimeString();
tempData.push(tm,j.data.temperature);
if(tempData.length>48){tempData.shift();tempData.shift();}
if(chart)chart.setOption({xAxis:{data:tempData.filter((_,i)=>i%2===0)},
series:[{data:tempData.filter((_,i)=>i%2===1)}]});}}
else if(j.type==='alert'){alerts.value.unshift(j.data);if(alerts.value.length>20)alerts.value.pop();}
}catch(e){}
});
client.on('close',()=>{connected.value=false;setTimeout(connect,3000)});
}
onMounted(()=>{initChart();connect()});
return{connected,d,alerts};
}}).mount('#app');
</script>
</body>
</html>
五、MonkeyCode IoT开发最佳实践
5.1 提示词模板
📝 MonkeyCode IoT 提示词:
【设备固件】
"用 MicroPython 为 ESP32 编写环境监测设备：
- DHT22温湿度 + BH1750光照 + PM2.5传感器
- MQTT协议上报数据到 broker
- 支持OTA升级和看门狗
- 低功耗深度睡眠设计"
【网关服务】
"实现IoT边缘网关：多协议接入(MQTT/CoAP/HTTP)、本地缓存断点续传、
边缘聚合过滤、TLS安全认证"
【云平台API】
"设计IoT RESTful API：设备注册认证、时序数据存储查询(InfluxDB)、
规则引擎(条件→动作)、WebSocket实时推送"
5.2 常见问题速查
| 问题 | 解决方案 |
|---|---|
| 设备频繁掉线 | 优化心跳间隔和指数退避重连 |
| 数据丢失 | 本地环形缓存+断点续传 |
| 固件升级失败 | 双分区A/B升级+自动回滚 |
| 功耗过高 | 深度睡眠+定时唤醒 |
六、总结
MonkeyCode在IoT领域的核心价值：
- 🔌 全栈覆盖 — 从嵌入式固件到云端平台的一体化辅助
- 📡 多协议精通 — MQTT/CoAP/HTTP/LoRaWAN等主流协议
- ☁️ 云边协同 — 设备端、边缘端、云端三层架构全覆盖
- 🛡️ 安全优先 — TLS加密、设备证书、安全启动链
- 📊 数据驱动 — 从采集到可视化的完整数据管道
"每一台联网设备都是一个故事的主角。MonkeyCode帮你讲好这些故事——让数据流动，让万物互联。"
本文最后更新：2026年7月16日
作者：MonkeyCode团队
相关阅读：
下一篇预告：[MonkeyCode区块链应用案例]
浙公网安备 33010602011771号