对接智能硬件接口

TODO：需要杨工提供，有关 id的数据字典。

总述

• 本文档规范主要用于约定 智慧健康 与 智能硬件 的通讯协议。
• 数据调用方式为标准 Client/Server 调用，即客户端（智慧健康）向服务端（智能硬件）发起调用。调用方式为：Android 定向广播，传输数据的格式为JSON。客户端发送测试指令给服务端，服务端处理后会将检测数据以1s 的频率，向客户端返回检测的数据，暂定最大重试次数设置为10次。若客户端已正确处理数据，则需要向服务端应答数据已处理。

//  C->S
bundle.putString("${客户端包名}", "${传输的数据}");
//  S->C
bundle.putString("${服务端包名}", "${传输的数据}");

CHECKSUM 的计算和校验

每个接口都需要带上 checksum 参数，并需要正确计算 checksum的值。

// 比如调用检测的指令
{
    "intent":"detect", 
    "id":"bg",         
    "code":"4949",
    "checksum":"计算的 checksum 值"
}

checksum 的计算方式：

• 智能硬件分配给智慧健康一个 secret。（比如：XnG0@oHE）
• 将 json 中的 key 和 value 拆分开，以 key字母序排序。上例的 key 的排序为: code、id、intent。
• 拼装字符串：code=4949&id=bg&intent=detect，以&连接。
• step 1:(accesstoken) = md5(code=4949&id=bg&intent=detect)。
• step 2:checksum = md5(${secret}&${accesstoken})，${}表示变量。

服务端/客户端拿到数据后，依照上述的校验值计算方式进行 checksum 的计算。若两者的校验结果保持一致则处理，否则则告知客户端checksum 异常。

NFC规范 扫描试剂标签

场景：由智慧健康主动打开 NFC 监听，所以要求试剂瓶上贴的 NFC 标签满足下面的约定。

{
    "id":"bg",      
    "code":"4949",  
    "date":"2017-07-12 18:00:00"
}
--------------------------------------------
id: 表示检测项目的标签，字段唯一。
code:校验码，通常范围是0~4949之间。
date:生产日期，要求为标准的 yyyy-MM-dd HH:mm:ss格式。
--------------------------------------------

接口列表

intent = detection : 发起调用检测意图
intent = detectionResult :发起调用检测意图的响应结果
intent = detectionProcess : 指令已处理

C->S 调起检测功能指令

{
    "intent":"detection", 
    "id":"bg",         
    "code":"4949",
    "checksum":"..."
}
--------------------------------------------
intent: 表示意图。
id: 表示检测项目的标签，字段唯一。
code:校验码，通常范围是0~4949之间。
--------------------------------------------

C->S 发送检测数据已接收指令

{
    "intent":"detectionProcess", 
    "id":"bg",         
    "date":"2017-07-12 19:45:00",
    "checksum":"..."
}   
--------------------------------------------
intent:表示意图。
id: 表示检测项目的标签，字段唯一。
date:应答接收数据的日期，要求为标准的 yyyy-MM-dd HH:mm:ss格式。（使用该日期对应某一条检测数据）。
--------------------------------------------

S->C 服务端向客户端端发送检测数据指令

{
    "intent":"detectionResult",
    "id":"bg",
    "data":"18.9",
    "unit":"mmHg/L",
    "date":"2017-07-12 19:45:00",
    "checksum":"..."
}
--------------------------------------------
id: 表示检测项目的标签，字段唯一。
data: 表示检测后的数据。
unit:表示该数据对应的单位。
date:检测日期，要求为标准的 yyyy-MM-dd HH:mm:ss格式。
--------------------------------------------