京东平台YAT对接协议

京东平台的识别码为：0x02。

1. 产品配置格式

模组连接京东平台时，采用一U一密方式。产品配置可以由庆科烧录，也可以客户自己烧录。

cid: 品类

brand: 品牌

softap_ssid: SoftAP配网方式的AP名称

uuid: 系统分配的产品唯一标识码

pub_key: 公钥、设备认证云端

private_key: 私钥、云端认证设备

Payload格式如下：

{
	"cid": "1",
	"brand": "123",
	"softap_ssid": "JD_xxxx",
	"uuid": "123244",
	"pub_key": "asdffdsdfdsf",
	"private_key": "dfsdfdexvgxcff"
}

debug 串口烧录方式：

2. 配网方式

京东平台配网方式：设备热点配网

格式如下：

MCU->WiFi

CMD	PAYLOAD
	Cloud Code	Type	TimeOut	说明
0x13	0x00	0x00	2 Byte	EMW系列：热点配网 EMC系列：蓝牙配网
	0x02	0x00	2 Byte	热点配网
		0x02	2 Byte	热点配网
		0x03	2 Byte	蓝牙配网

3. 解绑

京东平台没有设备端解绑功能，解绑指令（0x23）将执行清除feedid。切换账号绑定设备前，需要先清除feedid。 既发送解绑指令。

MCU清除Feedid 的配网流程如下：

4. 数据通信

• JSON-TLV格式通信（注意： 该方案暂时不支持）
• 支持JSON
• 支持透传

4.1. 数据通信JSON-TLV

注意： 该方案暂时不支持

4.1.1. 属性配置表规则

{
	"joylink": {
		"configuration": {
			"cid": "xxx",
			"brand": "xxxx",
			"softap_ssid": "xxxx",
			"pub_key": "xxxx",
			"private_key": "xxxx"
		},
		"properties": [{
			"tag": 1,
			"identifier": "bool_value",
			"dataType": "bool"
		}, {
			"tag": 2,
			"identifier": "enum_value",
			"dataType": "enum"
		}, {
			"tag": 3,
			"identifier": "char_value",
			"dataType": "char"
		}, {
			"tag": 4,
			"identifier": "short_value",
			"dataType": "short"
		}, {
			"tag": 5,
			"identifier": "int_value",
			"dataType": "int"
		}, {
			"tag": 6,
			"identifier": "float_value",
			"dataType": "float"
		}, {
			"tag": 7,
			"identifier": "double_value",
			"dataType": "double"
		}, {
			"tag": 8,
			"identifier": "text_value",
			"dataType": "text"
		}]
	}
}

4.2. 数据通信JSON

4.2.1. 下发JSON格式

{
	"snapshot": [{
		"current_value": "0",
		"stream_id": "stream_id_1"
	}, {
		"current_value": "1",
		"stream_id": "stream_id_2"
	}],
	"streams": [{
		"current_value": "2",
		"stream_id": "stream_id_2"
	}]
}

snapshot :设备快照

4.2.2. 上报JSON格式

{
	"code": 0,
	"streams": [{
		"stream_id": "stream_id_1",
		"current_value": "0"
	}]
}

4.3. 数据通信之RAW-TLV

RAW-TLV模式的属性配置表存放在模组端。透传脚本为lua编写 profile 为 list.

脚本：📎General_Script_0.0.2.lua

不同的应用只需修改profile,上传至京东平台。

RAW-TLV数据上报与下发同JSON-TLV数据上报下发一致。

5. OTA说明

由于京东平台的ota是根据判断固件ID的大小进行升级的，切固件ID由平台生产，依次累加。为了方便实现固件的统一，YAT固件默认上报固件ID为 0。

固件OTA时，设备会记录云端下发的固件ID和固件版本号，当固件升级成功后，系统检测固件版本号是否一致，若固件版本号一致，则将保存的固件ID上报云端，若固件版本不一致，则将ota时服务器下发的 id 值 -1 上报到云端。

测试OTA完成后，请删除OTA任务，否则终端用户会提示更新。

6. 连云流程

7. 京东小家 ios

以下是京东小家APP iosi沙箱环境使用方法：

1.在App Store下载京东小家APP

2.打开京东小家APP,正常登陆，然后杀掉进程

3.再次打开京东小家APP,，点击"“我的”点击右上角的"设置”点击“关于我们”连续点击6次"京东小家”在弹窗中输入"888888”在弹窗中点击下面的"APP环境”

4.重启京东小家APP,已经进入了沙箱环境