# 中移云YAT产品接入流程
#一、中国移动杭研对接方案介绍
#1.1 中国移动杭研平台介绍
中国移动杭研平台，主要通过杭州前端生态服务团队，对接甄选智能IoT设备，实现接入中国移动物联网平台以及和家亲APP，提供IOT设备智能化的一站式开发和全生命周期管理。
杭研技术团队提供基于 Andlink 协议的IoT设备接入规范，使得基于庆科信息的智能模组，方便快捷地实现设备端的接入。中国移动平台网站（项目名：连楹https://open.home.10086.cn/ (opens new window)）提供该物联网接入方案的产品配置、运营和量产服务。
庆科信息的模组（杭研称为定制模组代号）：目前所有定制模组型号（后续有新增，在此表补充），举例如下：
产品型号 | 模组品牌类型 | 模组型号 |
AOS-IOT定制模组 | 庆科Wi-Fi | EMW3080V2 |
庆科Wi-Fi | EMW3090V2 | |
庆科Wi-Fi蓝牙combo | EMC3080 | |
庆科Wi-Fi蓝牙combo | EMC3090 |
#1.2 平台能力及对接流程
针对各个对接环节的说明，可以登录中国移动连楹平台网站了解，或本文其他章节。
#1.3 中国移动平台账号
只有注册为企业类型的账号，才可以开启中国移动物联网平台产品接入，成为企业客户需要提交企业相关资质文件，详情请登录中国移动连楹平台网站了解。
通常，企业账号（登录手机号）提供给庆科信息技术人员通过验证码登录，便于进行产品信息查询及支持。
#1.4 中移平台名词解释
词条 | 解释说明 |
DM | Data Management，即终端管理数据上报，设备入库提测时与Andlink同时测试的项目。通过设备的设备 ID、SN、MAC，在和家亲生态合作平台运营管理子系统平台查询设备上报的终端管理数据与心跳明细信息，从而检测设备长时间工作的稳定性。低功耗休眠类产品（如门铃）对心跳明细信息不做要求。 |
CMEI | CMEI China Mobile Equipment Identity，是中国移动非蜂窝智能硬件统一编码，编码采用 15 位数字组成。CMEI 码对每一个产品做唯一标识。 |
TUI 码/TAC码 | Terminal unique identification/Type Allocation Code 即CMEI 前八位即智能硬件的型号核准号 20 码，由中国移动营销资源管理系统自动分配（有时会人工干预分配，请以最终审批入库TUI 码为准） |
Andlink Bootstrap | 平台收到的设备注册信息，需含有 deviceExtInfo 数据，字段包含：cmei、authMode、authId、mac、sn、reserve、manuDate、OS、chips、type、factory、model。 |
AndlinkSDK版本 | 版本号adlkModuleVx.x.x：该字段由3位构成，从左往右，均是阿拉伯数字，范围0～9；分别表示基线版本号X,次版本号Y，修订版本号Z，说明如下： 基线版本号X：基线版本号，当 API 的兼容性变化时，X 需递增 次版本号Y：次版本号，当增加功能时(不影响 API 的兼容性)，Y 需递增。 修订版本号Z：修订号，当做 Bug 修复时(不影响 API 的兼容性)，Z 需递增。 |
AHSVerion | 中移杭研团队针对定制模组中间件，面向外部合作伙伴和内部开发人员和测试人员使用的版本号，AHSVersion:"AOS-IOT-RTOS-模组型号-产品型号-AndlinkSDK版本" |
#二、平台产品创建
中国移动连楹平台上的产品创建，通常需要联系产品经理，沟通产品定位后创建工单，自行创建产品的评审材料。
#2.1 联系产品经理
按照列表联系对应产品品类经理，沟通接入中移杭研平台的意向及计划。
杭研前端团队提供全方位的生态品类咨询及接入服务，设备厂商可以对应联系品类客户经理****沟通答疑。
客服咨询 | 产品入库流程咨询及资料准备指南查看规范 (opens new window) | 黄小燕 | ---- | |
品类客户经理 | 智能组网 | 路由器、全光、POE面板等入库查看规范 (opens new window) | 李光华 | 18867111954 |
健康养老 | 血压计、体脂秤、健康手表等入库查看规范 (opens new window) | 袁敏林 | 18867120271 | |
安防监控 | 摄像头、可视门锁、猫眼门铃等入库查看规范 (opens new window) | 翟耀宗 | 18867122050 | |
社区终端 | 人脸门禁、车闸、充电桩等入库查看规范 (opens new window) | 李甫标 | 18867103601 | |
智能家居 | 智能家居设备、传感器、台灯、NAS等入库查看规范 (opens new window) | 孙捷昊 | 18867123055 | |
教育娱乐办公 | 音箱、投影、电视、教育终端、办公终端等入库查看规范 (opens new window) | 孙捷昊 | 18867123055 | |
生态运营 总负责人 | 产品入库过程中有任何问题需协调解决或者投诉建议，请优先与生态运营总负责人沟通 | 施超 | 18867103086 | |
#2.2 产品预审沟通
预审沟通：中移生态团队对接，期望首先通过中国移动办公 APP 沟通；
首次添加预审对接人骆宇峰，可通过添加微信号：lyf13456850040（请备注公司简称，姓名）；
中移移动办公软件下载链接：https://zhengqi.10086.cn/hebangong/download.html (opens new window)；
安装后添加中移移动办公APP账号：13735510307。（请备注对外呢称：公司简称，姓名）。
预审通过后预审对接人会在中移移动办公软件建立沟通对接群，可在手机端将群二维码分享给需进群人员，然后在移动办公软件扫描群二维码进群。若有关于移动办公APP的操作疑问，请联系客服：400-1100-868或陈意得15080984056。
#2.3 申请工单ID
联系产品经理后，需要对接营销库客服:13520982294 邮箱:ctrm100@139.com；
前往营销库（https://device.open.10086.cn:8017/ (opens new window)）注册账号，并提交测试/报备，参考：https://open.home.10086.cn/openhomePortal/pages/document/?id=20220620000005 (opens new window)
注意：营销库获取的杭研委托单号就是连楹平台预审需要的工单ID（若获取的杭研委托单号位数少一位，请在末尾加1；单号于营销库获取后，需等待后台将数据同步至连楹平台方可使用（等待时长常在几小时内）。
#2.4 填写预审产品资料
根据品类产品经理的指引，或者自行到中移连楹平台“资源中心”下载必要的资料模板。
预审资料--厂商需提供的预审资料20221124.zip (opens new window)
摄像头、猫眼门铃-可视门锁-可视台灯-预审资料下载20221118.rar (opens new window)
产品信息：
平台产品预审需要提交的公司商务及产品说明等资料，请以平台登录后的要求为准，通常产品品类相关。
产品功能填写示例：
#2.5 庆科信息模组填写参考
IPv6 专项：目前智能大屏类、智能音箱类、家庭安防类产品必须满足IPv6 专项测试要求，根据自身设备实现的功能进行相关项目的自测。
另外：提测前，需要申报庆科信息模块的软件版本信息，可咨询技术或商务经理，或者调试窗口对应信息：softwareVersion和 FirmwareVersion。
#三、设备接入及调试
#3.1 设备接入流程
产品创建好后，就可以开始进入开发调试阶段，需要在中移杭研后台配置好产品功能点。
能力集成：按照产品经理建议选配产品能力。
APP 配置：和家亲APP的设备面板（依据不同设备有差别），可以是中移杭研平台自有的，或者联合和家亲 APP 团队定制开发好，目前使用更多的产品是使用平台现有的模板，设备面板个性化的特性，无法由庆科团队来完成。
功能点是产品品类相关，添加这部分信息前，可以联系中移杭研品类产品经理，或者已沟通过的庆科信息模块端技术联系人，提供参考设置或协助。
#3.2 产品信息导出
#3.2.1 通信协议
庆科信息模组已经对接好中移杭研平台，设备端有一套《中移杭研YAT通信协议》 (opens new window)需要对接。
SLIP（Serial Line Internet Packet）层
... | START | PAYLOAD | END | ... | START | PAYLOAD | END | ... |
1 Byte | 2...1026 Byte | 1 Byte | 1 Byte | 2...1026 Byte | 1 Byte |
START | 起始符，标志数据包的开始，定义十六进制：0xC0 |
PAYLOAD | 载荷数据。其中：
|
END | 结束符，标志数据包的结束，定义十六进制：0xD0 |
IMC（inter MCU Communication）层
TYPE | PAYLOAD | CRC8 |
1 Byte | 0...1024 Byte | 1 Byte |
命令 | 载荷数据 | PAYLOAD 的CRC校验值 |
注意：数据传输采用小端模式，如：timeout_s=0x3C00 表示 60s。
CRC 计算法参考代码：
#3.2.2 产品信息
调试前导出平台创建好设备信息，便于调试。一个新的杭研产品，至少包括以下关键信息：
中移开发者账号：(手机号)
ID#：
{
project ID: 589759
Token：productToken
andlinkToken：andlinkToken
TUA/CMEI：11107640
}
#3.2.3 功能调试
拿到庆科信息的模组样品，可以按需重新配置杭研产品信息，配置产品信息可通过调试串口方式，或者设备端的用户串口方式。
用户串口默认配置
- Band rate: 115200
- Data bites: 8
- Parity: None
- Stop bites: 1
用户串口的波特率调试阶段，可以在调试串口输入cli命令实现：
uart [bandrate] ，uart <rx_pin>|<tx_pin> <pin num>。
查看波特率命令 uart或者 设置波特率为9600，命令 uart 9600 .
设置uart的rx/tx引脚，命令 uart rx_pin 12 或uart tx_pin 11.
更新模组杭研产品信息: 通过调试串口的CLI命令，可以更新产品特定字段的值：
写入pid&token&CMEI：andlink 589759 37TfGOHXXXX1 cnWJPMaXXXX1M 111076400000560
写入 DM版本AHSVersion：kv set andlink_ahs_version EMC3080-P20
写入 DM产品供应商Vendor：kv set andlink_device_vendor HUTLON
写入 DM产品品牌Brand：kv set andlink_device_brand HUTLON
写入 DM产品型号Model：kv set andlink_device_model P20
写入 DM供电模式：kv set andlink_power_supply_mode battery
设备端MCU开发可先实现配网命令，模块正确执行的话，手机可搜索到热点“CMQLINK-{PID}-{MAC}”
也可以通过 PC 端串口工具，给庆科信息的模块发送以下测试命令：
C0 13 0A 02 00 00 4A D0 热点配网命令
C0 12 00 00 D0 查询配网
C0 24 00 00 D0 查询UTC
* 状态上报格式：C0 27 JSONs CRC8 D0，JSONs字段参考杭研后台导出的profile。
* 电池类会断开模块供电的产品，板卡收到0x36命令，需额外保持供电20-30s。
更多命令请参考《中移杭研YAT通信协议》 (opens new window)，可向庆科信息技术经理或商务经理索取。
#3.3 中移杭研产品入库
入库测试需要联系品类经理，提前预约排队，因为多品类产品都共用杭研测试实验室，通常排队时间较久。
提测设备信息：一致性要求：设备包装、铭牌、上报信息、提测信息中的产品名称、型号、CMEI、MAC、SN等信息一致，提测时若发现不一致，则判定该提测单为不通过。
提测的必要材料：包括但不限于软件自测报告、固件包、参数表、说明书、认证证书、生产资料等。测试范围包含生产资料审核、软件测试、集成测试、硬件测试、包材审核五个部分。测试用例由合作伙伴门户网站公开，合作伙伴需对反馈的测试缺陷进行相应回复，否则视为提测不通过，产品需重新提测。
入库测试样机：需提前寄送4台样机至浙江省杭州市余杭区余杭塘路1600号 中移（杭州）信息技术有限公司；程博（收）：18346056014 （请以后台产品页或品类经理提供的信息为准）。
测试报告模板下载 (opens new window) 产品认证材料下载模板及说明 (opens new window) 厂商升级说明书模板下载 (opens new window)
#四、和家亲APP
#4.1 调试入库测试 APP
下载和家亲APP进行设备调试过程中，如需修改功能参数或配网页， 请联系管理员：
功能参数审核—— 何文强 15979317324；
配网页审核——陈仕：18867122950/何文强：15979317324
测试和家亲 APP 下载地址及版本要求在 https://www.pgyer.com/17AL 进行下载，厂商需完成设备在Android 及iOS双端测试，APP 统一使用线上环境 99.0.0 版本。
#4.2 批量产品 APP
入库后的产品，直接各大应用市场下载，搜索“和家亲”即可。
#五、设备OTA说明
#5.1 OTA升级版本创建
点击顶部banner，进入工作台，选择左侧边栏运营中心——OTA升级——版本管理
点击右上角“添加版本”，根据弹窗内容，填写相关信息，完成版本创建
#5.2 少量设备现网环境测试升级
点击左侧边栏设备管理，选择待升级设备、点击“设备升级”按钮，根据弹框内容，填写升级信息，完成升级任务创建。点击左侧边栏OTA升级升级管理，查看设备升级详情。
- 测试升级可以不需审核状态，也可对设备进行升级。
#5.3 进行批量升级
点击左侧版本管理，选择对应版本，点击提交按钮。上传相关附件，点击确认按钮，版本提交至管理员审核，可按页面提示联系管理员进行后续审核、测试和批量升级（和管理员协商配置平台推送、自检升级策略）
点击左侧升级管理，选择批量升级页签，查看升级任务列表。点击详情按钮，进入批量升级任务的详情页，可查看当前升级任务下版本分布、升级进度、升级设备列表、升级任务基本信息等。
#六、模块固件确认书
如果联调测试好，为了便于模块量产时可以准确地烧写所需版本的固件，已经预先写入针对产品信息的配置，需要输出并双方签订固件确认书（或叫承认书），将记录好与杭研后台产品相关的信息，双方按照首页信息下单和交付采购庆科信息的模块。
#6.1 固件确认书信息
通常的庆科信息模块固件确认书的信息包括：
下单产品型号：包括庆科信息模组型号，固件SN及杭研产品 PID。
量产固件信息：固件SN，通常两个圆点隔开的 12 位数字字母串，如0000.HY00.Y132，其中 Y132表示模块固件的版本，可从杭研后台看到firmwareVersion显示为1.3.2。
量产模组标签要求：庆科标准模块标签，包括品牌、MAC及CMIITID，也可申请加上固件SN或产品型号代码。
量产采购的包装标签要求：包括外箱标签及整包标签，庆科信息的标准外包装标签如图所示。
#6.2 确认书签字
针对模块型号、固件信息和标签信息，确认准确无误后，双方在首页上签字留档。
← 中移云YAT对接协议 固件下载 →