Flex2.0

Appearance

灵活接口 ​

灵活接口是专为灵活固件设计的全能数据通道，助力 AI 硬件实现无缝互联与智能交互。

特性 ​

全协议支持 ​

  • TCP：工业级双向通信，完美对接传感器/MCU 等设备
  • WebSocket：跨平台支持 Web/APP/小程序等移动应用
  • HTTP：极简 Get/Post 接口，快速集成到现有系统

智能数据路由 ​

  • 全域广播/群组广播/定向推送
  • 定时推送/动态绑定
  • 多协议数据统一汇聚处理

应用场景 ​

  • ✓ 工业自动化控制与实时预警
  • ✓ 智能餐饮点餐/互动营销系统
  • ✓ 酒店 RCU 智能化改造
  • ✓ 社交化 AI 硬件开发
  • ✓ 传统系统快速 AI 升级

数据协议 ​

Hello ​

建立连接时发送：

json
{
    "type": "hello"
}

Ping ​

维持连接的心跳包，600 秒内无通讯数据需发送心跳包维持连接：

json
{
    "type": "ping"
}

Chat ​

向设备 AI 发送消息，可用于 MCP 调用、语音播发等：

json
{
    "type": "chat",
    "text": "播放邓紫棋的多远都要在一起"
}

此接口会主动唤醒设备，并发送文字内容给 AI，效果等同于在设备旁边与之对话。

Audio ​

调用设备解码播放能力，可用于歌曲、电台、语音留言等音频的精准推送：

json
{
    "type": "audio",
    "url": "https://audio/abc.mp3",
    "text": "message to capsule"
}

支持格式：.mp3、.flac、.wav、.m4a、.opus、.ogg、.m3u8

Music ​

调用设备线上音乐能力，静默执行在线音乐搜索并播放，不会唤醒 AI：

json
{
    "type": "music",
    "text": "多远都要在一起 邓紫棋"
}

Radio ​

调用设备网络电台能力，静默执行电台播放，不会唤醒 AI：

json
{
    "type": "radio",
    "id": 1,
    "text": "怀旧好声音电台"
}

电台编号查阅 电台列表

Message ​

给设备留言，内容会显示在设备的信息胶囊和对话界面：

json
{
    "type": "message",
    "text": "message to capsule",
    "content": "message to chat box",
    "sound": 11
}
  • sound：提示音编号 1~22，为 0 则不播放提示音

Volume ​

控制设备音量：

json
{
    "type": "volume",
    "value": 50,
    "save": true
}

Brightness ​

控制设备背光亮度：

json
{
    "type": "brightness",
    "value": 80,
    "save": true
}

Theme ​

控制设备主题模式：

json
{
    "type": "theme",
    "value": "dark"
}

value 只能是 light 或 dark

Image ​

给设备发送图文消息：

json
{
    "type": "image",
    "url": "https://image/abc.jpg",
    "text": "message to capsule",
    "sound": 11
}

QRCode ​

向设备发送二维码消息：

json
{
    "type": "qrcode",
    "content": "https://space.bilibili.com/77092304",
    "text": "subscribe my channel",
    "sound": 11
}

Button ​

远程触发设备按键：

json
{
    "type": "button",
    "key": 1,
    "event": 1
}
  • key：按键编号（1=BOOT键, 2=VOL+键, 3=VOL-键）
  • event：按键动作（1=单击, 2=双击, 3=长按）

Mijia ​

通过小智(ESP32)控制米家设备：

json
{
    "type": "mijia",
    "name": "次卧吸顶灯",
    "ip": "192.168.31.100",
    "token": "e8ac5aexxxxxxxxxxxxxx053e80",
    "did": "1005401931",
    "siid": "2",
    "state": 1
}

提示

  • 小智(ESP32)需要与米家设备处于同一 WIFI 网络下才能实现控制
  • 支持控制小米蓝牙 mesh 设备，填写参数时注意填写 mesh 网关设备的 ip 和 token
  • 建议在路由器管理页面将需要控制的设备设置静态 IP

详细说明请查阅 米家设备

Status ​

查询设备的各项参数（仅支持 TCP 和 WebSocket）：

请求：

json
{
    "type": "status"
}

响应：

json
{
    "type": "status",
    "device_id": "41D334",
    "volume": 50,
    "brightness": 80,
    "display_width": 320,
    "display_height": 240,
    "theme": "dark",
    "network": "wifi",
    "ssid": "Xiaomi_2222",
    "rssi": -45,
    "firmware_tag": "Flex",
    "firmware_ver": "1.6.3.28",
    "compile_time": "Jun 28 2025 21:53:15",
    "local_music": 100
}

Subscribe ​

订阅设备上报信息（仅支持 TCP 和 WebSocket）：

json
{
    "type": "subscribe"
}

接口地址 ​

TCP & WebSocket ​

在上述数据中增加 "push":"41D334" 即可将消息推送至编号为 41D334 的设备。

服务器地址和端口找群主获取：1041054478

HTTP POST ​

  • 地址：https://nodelua.com/home_iot/api/push.php
  • Body：{"device_id":"41D334","type":"message","text":"我在丽丰你在哪?","content":"来来来影院找我","sound":11}
  • 成功响应：{ "code": 0, "msg": "数据已推送至设备" }
  • 失败响应：{ "code": 4013, "msg": "目标设备处于离线状态！" }

Flex2.0 灵活固件

Copyright © 2025