# FogCloud云YAT产品对接协议
#一、说明
- Fog平台的识别码为:0x10
- 模组连接 Fog 平台时,需要烧录三元组,采用一机一码方式。
- 三元组可以由庆科烧录,也可以由客户自己烧录。
#二、产品配置格式
pk: ProductKey
ps: ProductSecret
dn: DeviceName
ds: DeviceSecret
{
"pk": "123",
"ps": "456",
"dn": "asd",
"ds": "zxc",
}
#三、配网方式
Fog 平台配网方式:蓝牙配网
格式如下:
MCU->WiFi
CMD | PAYLOAD | |||
Cloud Code | Type | TimeOut | 说明 | |
0x13 | 0x00 | 0x00 | 2 Byte | EMC系列:蓝牙配网 |
0x10 | 0x00 | 2 Byte | EMC系列:蓝牙配网 | |
0x03 | 2 Byte | 蓝牙配网 |
#四、数据通信之JSON
如果选择MCU与WiFi模组的属性通信方式为JSON格式,由于Fog平台数据分为:属性、事件、服务,需要MCU区分数据类型。
注:JSON依据实际产品功能提供
#1、属性上报
MCU->WiFi
CMD | PAYLOAD | 说明 | |
Type | JSON | JSON格式数据 n取值范围1~1023 | |
0x27 | 0x01 | n Byte | 属性上报 |
WiFi->MCU
无
{"onoff":1}
#2、属性下发
WiFi->MCU
CMD | PAYLOAD | 说明 | |
Type | JSON | JSON格式数据 n取值范围1~1023 | |
0x27 | 0x01 | n Byte | 属性下发 |
MCU->WiFi
无
- 属性下发格式与属性上报格式一致
#3、事件上报
MCU->WiFi
CMD | PAYLOAD | 说明 | |||
Type | EventID Length | EventID | JSON | JSON格式数据 n取值范围1~1020 | |
0x27 | 0x02 | 1 Byte | n Byte | n Byte | 事件上报 |
EventID Length: 事件ID长度
EventID:事件ID,string类型
WiFi->MCU
无
#4、服务下发
WiFi->MCU
CMD | PAYLOAD | 说明 | |||
Type | ServiceID Len | ServiceID | JSON | JSON格式数据 n取值范围1~1023 | |
0x27 | 0x03 | 1 Byte | n Byte | n Byte | 服务下发 |
ServiceID Len: 服务ID长度
serviceID:服务ID,string类型
MCU->WiFi
无
#五、数据通信之RAW-TLV
#1. 属性配置表规则
RAW-TLV模式的属性配置表存放在云端。
脚本:
修改 profile ,替换 fog.js中的 profile,上传Fog后台。
注:TLV依据实际产品属性和功能提供
#Cli
fog_env <env> (0:product, 1:dev, 2:beta)
fog keys. fogkey [<fog_pk> <fog_ps> <fog_dn> <fog_ds>]
fog_private_domain eu-dev.fogcloud.io eu-dev.fogcloud.io