# 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

#属性配置表规则

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
更新时间: 2023/11/29 13:52:34