大不自多智能硬件开放平台XLINK接入指南
一、基本介绍
行者XOSS硬件开放平台（下称XLINK平台）是上海大不自多信息科技有限公司推出的连接硬件设备的物联网解决方案。行者硬件开放平台以行者用户ID和XOSS ID为基础，为硬件生产商提供便捷的户外智能设备接入服务，打造智能硬件设备制造商和用户共赢的物联网平台，实现人，设备，厂家的互联互通。
本平台提供蓝牙设备和wifi设备的智能互联，用户可以在行者APP或者XOSSAPP内查看和管理相应的智能设备。
1.1 平台优势
成熟的接入方案，目前平台已经接入设备超过500w个，近十家企业的数十种智能硬件设备接入。
行者和XOSS用户基数强大，数据分析和云服务可靠，可以为用户提供可靠的APP
提供定期的设备统计数据，包括激活，活跃，留存等。
提供标准化的接口和文档，设备可以快速接入APP或者云端，减少设备厂家的研发成本，缩短上市周期。
拥有大量存量户外用户，有利于利用硬件设备口碑传播，降低运营成本。
支持定制化开发。
1.2 基础接入服务
基于低功耗蓝牙的APP直连服务，提供设备激活，数据同步，数据管理，设备管理等基础功能。
基于wifi的云端直连服务，支持标准oauth授权，自动数据同步，APP端消息通知服务。
APP设备⻚面静态展示，数据⻚面设备品牌展示。
设备激活，活跃等数据分析。
1.3 增值服务
支持基于蓝牙的OTA服务
支持定制化的数据展示
支持详细的用户数据报表
基于行者或者XOSS的订阅服务
其他定制化的服务
1.4 接入设备展示
目前已有十多家接入行者和XOSS APP平台，包括码表，前灯，尾灯，eBike，定制化的传感器等。 部分接入厂商：
- 成都晨电智能科技有限公司
- 深圳市汇泰科电子有限公司
- 深圳市酷思运动科技有限公司
- 常州新思维新能源汽车技术有限公司
部分接入产品：
二、接入流程
2.1 确认您需要的服务
与我们取得联系，发送邮件至wei.hu@bi-ci.com或者developer@bi-ci.com，或者添加以下企业微信：
2.2 创建开发者账号
参考以下创建您的行者开发者账号。
2.3 签订接入合同
签订正式的接入合同
2.4 开发测试
预计需要10周
获取测试设备授权
提供基础的测试设备接入的信息和测试用APP
提供测试版硬件联合调试
2.5 设备入库
将正式版本硬件信息按照一下格式提供，将在5个工作日内设备信息在后台入库。
2.6 验证上线
提供正式版本硬件，上线前验证。
2.7 后台查看基础数据
三、硬件接入要求
3.1 蓝牙设备接入要求
3.1.1 设备需要支持蓝牙低功耗基础的Device Information，需要提供完整的DIS服务数据。
通过标准蓝牙设备信息服务（DIS）来获取设备当前信息，包括设备生产商，设备型号，串号，硬件版本号，固件版本号。
无论是正常模式下还是固件升级模式下，都需要提供DIS服务。
| 特征 | 值 | 例子 |
|---|---|---|
| Manufacturer Name String | 生产商名不超过20字符 | XOSS Works |
| Model Number String | 型号名称不超过10个字符 | N1 |
| Serial Number String | 唯一串号不超过20个字符 | 2124A22 |
| Hardware Revision String | 硬件版本号不超过10个字符 | 1.5.0 |
| Firmware Revision String | 固件版本号不超过10个字符 | 1.23.55 |
| Software Revision String | 软件版本号不超过10个字符（可选） | 5.0.22 |
例子：
设备信息在设备上线前，需要提前入库，设备信息表如下：
| id | Manufacturer | Model | Serial Number | Hardware Revision | Firmware Revision |
|---|---|---|---|---|---|
| 1 | XOSS Works | N1 | 983122 | 1.5.0 | 1.23.55 |
| 2 |
3.1.2 设备需要支持蓝牙低功耗基础的Battery 服务
参考蓝牙官方标准协议，BS服务UUID为0x180F，本设备需要的特征服务表定义如下：
| 特征 | UUID | 支持 | 描述 |
|---|---|---|---|
| Battery Level | 0x2A19 | M | 电池电量 0～100 |
| Battery Level Status | 0x2BED | O | 电池电量状态定义，包括是否充电中 |
3.1.3 设备同步数据需要提供生产商注册的ANT+ ID信息
设备厂商提供
3.1.4 蓝牙设备命名规范
智能硬件设备名称均以[前缀][缩写][识别码]结构
DFU模式下以[DFU][缩写][识别码]结构
前缀可自定义为不超过4个字符的字符串
缩写为设备型号缩写，不超过3个字符
识别码不超过6个字符
样例：
XOSS G码表：XOSS_G_654321 DFU模式下名称为DFU_G_654321
3.1.5 设备接入交互界面规范
1.产品名：中/英版本（若只提供一个，则中/英版本下显示一致）。在产品列表显示用。
显示示例：
2.图片：需提供4张透明底PNG格式产品图片，尺寸及命名规范如下：
