https://www.yiyangiot.com/#/login?redirect=/device/detail/index
账号 17599352333
密码 12345678
860132060529195
云芯小见康养手表平台使用入口:
1.医养平台:https://www.yiyangiot.com/#/login?redirect=/home
2.校园平台:https://school.yiyangiot.com/#/login?redirect=/home
3.H5平台:https://web.yiyangiot.com/device/
4.云芯官网:https://www.xcloudtech.com/product/34/
5.SSO平台文档:https://web.yiyangiot.com/files/sso.pdf
6.硬件开发者平台:http://fzd.xcloudtech.com:6868/DeviceManagement
对接文档:https://web.yiyangiot.com/files/iot.pdf
7.ISV对接硬件API平台:http://fzd.xcloudtech.com:4000/#/login
对接文档:https://web.yiyangiot.com/files/saas.pdf
8.小见APP:https://fangzoudiu.xcloudtech.com/xiao_jian/
9.平台对接文档:https://web.yiyangiot.com/files/process.pdf
开发前必读
该协议中所有数据都按照[MNYD*设备ID*内容长度*内容]格式,中括号是需要带上的, 设备ID为IMEI,内 容长度固定为四个字节的ASCII码,高位在前低位在后,例如FFFF表示长度为65535.
一.终端发送指令
链路保持
(1)
终端发送:
[ MNYD**YYYYYYYYYYYYYYY*LEN*PING]
实例:[MNYD*334588000000156*0004*PING] 平台回复:
[MNYD**YYYYYYYYYYYYYYY*LEN*PING,是否绑定(0表示未绑定, 1表示绑定)]
实例:[MNYD*334588000000156*0006*PING,0]或[MNYD*334588000000156*0006*PING,1]
说明:链路保持数据每5分钟发一次,若终端未收到服务器的回复,则会一分钟重连一次,重连5次后一 直 连接不上服务器,终端就会重启.
(2)
终端发送:
[MNYD**YYYYYYYYYYYYYYY*LEN*KA, 日期, 步数,翻滚次数, 电量百分数,里程数(km)]
实例:[MNYD*334588000000156*0014*KA,120414,50,100,100,100.12] 平台回复:
[ MNYD**YYYYYYYYYYYYYYY*LEN*KA]
实例:[MNYD*334588000000156*0002*KA]
说明:链路保持数据每5分钟发一次,若终端未收到服务器的回复,则会一分钟重连一次,重连5次后一直连 接 不上服务器,终端就会重启.
日期格式为(年月日),比如120414,表示2012年4月14日;(手表所在地日期)
步数为当天的总步数,翻滚次数表示当天的总翻滚次数(用于睡眠监控),电量百分数为当前的电量,用 0-100表示。里程数为当天总里程数,没有传0或不传即可。
如没有步数和翻滚次数则传0即可。
位置数据上报
终端发送: 实例:
[MNYD**334588000000156*00CD*UD,180916,025723,A,22.570733,N,113.8626083,E,0.00,249.5,0.0,6,100,6 0,0,0,00000010,7,255,460,1,9529,21809,158,9529,63555,133,9529,63554,129,9529,21405,126 ,9529,21242 , 124 ,9529,21151,120,9529,63556,119,0]
说明:
数据内容: UD, 命令号
180916,日期(年月日)(0时区),表示0时区的二零一八年九月十六号 025723,时间(时分秒)(0时区),表示0时区的两点五十七分二十三秒 A,gps定位有效
22.570733,纬度 N, 纬度表示
113.8626083,经度
E, 经度表示 0.00,速度 249.5,方向 0.0,海拔
6 ,卫星个数
100,gsm信号强度
60,电量
0,计步数
0 ,翻转次数
00000010,终端状态,数据为16进制,解析成二进制为00000000000000000000000000010000前面4个字节 表示状态,后面4个字节表示报警,数据中第4位为1,对照文档最后的数据解析,表示手表静止状态。 详细可参看文档最后部分。
7,基站个数
255,460,1,9529,21809,158,9529,63555,133,9529,63554,129,9529,21405,126,9529,21242,124,95 29,21151,1
20,9529,63556,119,基站信息 0,WiFi个数
平台不需要回复
说 明:终端按照设定间隔上报位置和状态信息, 不需要平台回复.
获取服务器端时间
终端发送: [MNYD*YYYYYYYYYYYYYYY*LEN*LGZONE] 实例:[MNYD*1234567890*0006*LGZONE]
平台回复: [MNYD*YYYYYYYYYYYYYYY*LEN*LGZONE, 时区, 时间, 日期] 实例:[MNYD*1234567890*001D*LGZONE,+8,08:00:00,2016-01-12]
实例表示:东八区,上午8点整
说明: 当设备开机建立链接时, 需要获取当前最新的时间。服务器将最新的时间回复给终端。西时 区用“-”表示,时间用24小时制。
请求位置数据
终端发送:
[ XT*YYYYYYYYYY*LEN*WG,位置数据(见附录一)] 实例:
[XT*8800000015*0087*WG,220414,134652 ,A,22.571707,N,113.8613968,E,0.1,0.0,100,7,60,90,1 000,50,0001,4,1,460,0,9360,4082,131,9360,4092,148,9360,4091,143,9360,4153,1 41]
平台回复:
[XT*YYYYYYYYYY*LEN*WG,纬度, 经度, 精准度, 具体位置描述]
实例:[XT*8800000015*0021*WG,22.571707,113.8613968,550,广州越秀黄花岗 公园]以 上位置数据部分使用Unicode编码, 最终上面示例传到终端将是:
[XT*334588000000156*0041*WG,22.571707,113.8613968,550,5E7F5DDE8D8A79C09EC482 B15C97516C56ED]
请求电话本设置信息
终端请求电话本下发:
[ XT*YYYYYYYYYYYYYYY*LEN*PHLQ] 服务器回复:
[XT*YYYYYYYYYYYYYYY*LEN*PHL, 电话本信 息]
将执行平台发送电话本命令(详见平台发送电话本指令)
二.平台发送指令
定位指令
平台发送:
[ MNYD*YYYYYYYYYYYYYYY*LEN*CR]
实例:[MNYD*334588000000156*0002*CR] 终端回复:
[ MNYD*YYYYYYYYYYYYYYY*LEN*CR]
实例:[MNYD*334588000000156*0002*CR]
说明:立即定位(如有gps功能,可通过此命令进行开启并进行Gps定位上传)。
通 过该指令触发的位置上传指令, 指令名改为CRUD, 即在原先位置指令上加CR,表示 该位置是通过“立即定位”触发的
定位数据上传间隔设置
平台发送:
[MNYD*YYYYYYYYYYYYYYY*LEN*UPLOAD, 时 间 间 隔 ]
实例:[MNYD*334588000000156*0009*UPLOAD,600] 终端回复:
[ MNYD* YYYYYYYYYYYYYYY* LEN* UPLOAD]
实例:[MNYD*334588000000156*0006*UPLOAD]
说明:设置终端 定时上报位置的时 间间隔,单位是秒, 此上传 间隔针对手表 处于运动状 态时,手表静止时不传位置数据。(出厂时默认上传间隔为十分钟)
设置电话本+白名单(最多50条)
平台发送:
[MNYD*334588000000156*len*PHL, 号码,名字, 号码,名字, 号码,名字, 号码,名字, 号码,名字]
len:发送长度16进制表示占用2个字节 号码:ascii字符
名字:Unicode编码该接口融合了白名单和电话本的功能,最多对应50组号码与名字,号码不超 过20个ascii字符, 姓名不超过10个Unicode字符。示例
:[MNYD*334588000000156*0010*PHL,110,5F204E09]5F204E09--->张三,是使用unicode编码
终端回复: [MNYD*334588000000156*0003*PHL]
三、健康数据
设置心率上传
平台发送:
[MNYD*334588000000156*len*hrtstart,x]
实例:[MNYD*334588000000156*len*hrtstart, 1] x为1则代表终端心率单次上传实时心率。
终端回复
[MNYD*334588000000156*len*hrtstart]
终端心率上传
终端上传:
[MNYD*334588000000156*len*heart,x,hrv值(如没有可不带)]
x为每分钟心率数据。
实例: [MNYD*334588000000156*len*heart,100,100]
代表终端的心率为: 100次/分钟 平台回复:
[MNYD*334588000000156*0005*heart]
设置体温上传
平台发送:
[XT*334588000000156*len*wdstart,x]
实例:[XT*334588000000156*len*wdstart, 1]
x为1则代表终端单次上传实时体温。 x为0则代表终端体温上传关闭。
终端回复
[XT*334588000000156*len*wdstart]
上传体温数据
终端上传:
[ XT*YYYYYYYYYYYYYYY* LEN*temp, X. X] X.X:当前测到温度值。
实例: [XT*334588000000156*0009*temp,36.2]
代表终端的温度为: 36.2 平台回复:
[XT*334588000000156*0004*temp]
上传血压数据
终 端 发 送 [ XT*YYYYYYYYYYYYYYY*LEN*blood, x, y] x是收缩压(高压)
y是舒张压(低压)
示例[XT*334588000000156*000C*blood,150,70] 平台回复:
[XT*334588000000156*0005*blood]
血压心率上传(同时测量血压和心率)
终端上传:
[XT*334588000000156*len*bphrt,xx,xx,xx,xx,xx,xx,xx] 第一个参数代表高压为0代表无效
第二个参数代表低压为0代表无效 第三个参数代表心率为0代表无效
第 四个参数代表身高厘米
第五个参数代表性别1男2女
第六个参数代表年龄
第七个参数代表体重KG 平台回复:
[XT*334588000000156*len*bphrt]
上传血氧数据
终 端发送 [ XT*YYYYYYYYYYYYYYY*LEN*oxygen, x] x表示血氧饱和度
示例[XT*334588000000156*0009*oxygen,15] 平台回复:
[XT*334588000000156*0006*oxygen]
上传睡眠数据报告(前一天20点至当天20点为当天)
终 端 发送 [XT *YYYYYYYYYYYYYYY*LEN*SleepReport, 日期 , 睡眠起始时间, 睡 眠 结束 时 间 , 睡 眠 时 长 (分钟),睡眠数据条数 , 睡 眠程 度 ,...]
日期:年-月-日,例如2024-02-09 睡眠起始时间:时:分,例如22:54 睡眠结束时间:时:分,例如07:10 睡眠时长:单位分钟, 例如496
睡眠数据条数:睡眠数据的条数, 最多 107条
睡 眠程度: 从前一天20:00开始,每个时间段(约808秒) 的睡眠情况, 用整型表示, 0-7,数值越大,睡眠越深, 具体值为0清醒, 1,2浅睡, 6,7深睡
1 每天16点后,终端主动上传一次睡眠数据 示例
终端发送:
[XT*334588000000156*0101*SleepReport,2024-02-09,22:54,07:10,496,107,0,0,0,0,0 … ,0] 平台回复:
[XT*334588000000156*000B*Sleep]
2 平台主动请求 平台发送:
[XT*334588000000156*000B*SleepReport] 终端回复到当前为止的睡眠数据:
[XT*334588000000156*0101*SleepReport,2024-02-09,22:54,07:10,496,107,0,0,0,0,0 … ,0]
附录
附录一:位置数据说明
名称 |
实例(ASII码) |
说明 |
日期 |
120414 |
(年月日)2012年4月14日(0时区) |
时间 |
101930 |
(时分秒)10点19分30秒(0时区) |
是否定位 |
A |
A:定位V:未定位 |
纬度 |
22.564025 |
按照DD.DDDDDD格式定义,此纬度值为 :22.564025 |
纬度标识 |
N |
N表示北纬, S表示南纬. |
经度 |
113.242329 |
按照DDD.DDDDDD格式定义,此经度值为 :113.242329. |
经度标识 |
E |
E表示东经,W表示西经 |
速度 |
5.21 |
5.21公里/小时. |
方向 |
152 |
方向在152度. |
海拔 |
100 |
单位为米 |
卫星个数 |
9 |
表 明 GPS卫星个数 |
GSM信号强度 |
100 |
表示当前GSM信号强度(0-100) |
电量 |
90 |
表示当前电量等级百分比 |
计步数 |
1000 |
计步数为1000。为当天的步数 |
翻滚次数 |
50 |
翻滚50次 |
终端状态 |
00000000(16进制) |
用 二进制字符串表示为 00000000000000100000000000000000含义如下:左边 高16bit表示报警,右边低16bit表示状态. Bit位(0开始)含义(1有效) 0低电状态 1出围栏状态(目前没用到) 2进围栏状态(目前没用到) 3手环戴上取下状态 4手表运行静止状态 16SOS报警 17低电报警 18出围栏报警(目前没用到) 19进围栏报警(目前没用到) 20手环拆除报警 21跌倒报警 22震动报警 23断油断电报警 24心率骤降报警 25车辆启动、位移报警 |
|
|
26低温报警 27高温报警 28超速报警 比如00200010,即表示 00000000001000000000000000010000
分别是第四位为1,第21位为1,对应21位是跌倒报 警 |
基站个数 |
4 |
上报基站个数,0表示不上报基站信息(默认不带基站 数据,定位会失败) |
连 接 基 站ta |
1 |
GSM时延 |
MCC国家码 |
460 |
460代表中国 |
MNC网号 |
02 |
02代表中国移动 |
连接基站位置区域码 |
10133 |
区域码 |
连接基站编号 |
5173 |
基站编号 |
连接基站信号强度 |
100 |
信号强度 |
附近基站1位置区域码 |
10133 |
区域码 |
附近基站1编号 |
5173 |
基站编号 |
附近基站1信号强度 |
100 |
信号强度 |
附近基站2位置区域码 |
10133 |
区域码 |
附近基站2编号 |
5173 |
基站编号 |
附近基站2信号强度 |
100 |
信号强度 |
附近基站3位置区域码 |
10133 |
区域码 |
附近基站3编号 |
5173 |
基站编号 |
附近基站3信号强度 |
100 |
信号强度 |
… |
… |
… |
Wifi信息数量 |
5 |
Wifi个数(最多5个),按信号强度排序. |
Wifi1名字 |
rrr |
第1个wifi信息名字 |
Wifi1MAC地址 |
1c:fa:68:13:a5:b4 |
第1个wifiMAC地址 |
Wifi1信号强度 |
-61 |
第1个wifi信号强度 |
Wifi1名字 |
abc |
第2个wifi名字 |
Wifi1MAC地址 |
1c:fa:68:13:a5:b5 |
第2个wifiMAC地址 |
Wifi1信号强度 |
-87 |
第2个wifi信号强度 |
… |
… |
… |
23456