# 京东平台YAT对接协议

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

#产品配置格式

模组连接京东平台时,采用一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 串口烧录方式:

#配网方式

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

格式如下:

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

蓝牙配网

#解绑

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

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

#数据通信

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

#数据通信JSON-TLV

注意: 该方案暂时不支持

#属性配置表规则

{
	"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"
		}]
	}
}

#数据通信JSON

#下发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 :设备快照

#上报JSON格式

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

#数据通信之RAW-TLV

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

脚本:📎General_Script_0.0.2.lua

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

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

#OTA说明

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

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

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

#连云流程

#京东小家 ios

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

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

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

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

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

更新时间: 2023/7/12 14:10:31