量产二维码介绍
当设备基于物联网开发平台完成开发后,设备即将进入批量量产阶段。对于设备厂家而言,无论是使用腾讯连连小程序/自主品牌小程序/App,都可通过扫描二维码添加设备,从而提升用户使用体验。因此平台提供了各通信方式各品类的量产二维码方案,您可以根据设备类型,获取合适的二维码进行批量生产。
一型通用二维码:表示该产品品类下所有设备均可使用同一个二维码印于包装盒或设备上。例如,生产一款 Wi-Fi 类 SmartConfig 配网的智能灯,则该款智能灯的所有设备均可使用同一个二维码进行扫码配网添加。
一机一码:表示对于该产品下的设备,在量产时需生成与该设备一一对应的二维码,方可通过扫码将设备绑定到家庭下。
前提条件
产品已完成前序开发步骤,进入批量投产环节。
设备的实际生成环境,已具备量产的资质条件。
一型通用二维码
仅腾讯连连小程序支持“一型通用二维码”方式,可直接通过微信扫一扫或者腾讯连连小程序内扫一扫进行设备添加,具体说明如下:
设备类型
Wi-Fi 设备、BLE 设备、Zigbee 子设备、433子设备、自定义协议子设备。
获取方式
说明:
如何配置扫码后所进入页面,您可单击交互开发 > 扫一扫产品介绍/配网引导 > 配置进行操作。
一机一码
腾讯连连小程序、自主品牌小程序/App 均支持“一机一码”的方式进行设备添加。本文以腾讯连连小程序为示例进行说明,其他设备可参考进行操作,具体说明如下:
设备类型
蜂窝类设备(2G/3G/4G/5G)、LoraWAN、其它。
获取方式
在产品批量投产阶段,产品投入发布前,腾讯连连小程序和通用版 App 需物联网开发平台审核,通过审核变为可发布后,在您创建设备量产任务时,下载生成的 csv 文件获取一机一码的设备二维码内容。
说明:
自主品牌小程序/App 无需通过物联网开发平台审核,在进行产品发布确认后,即可进行量产管理。
操作步骤
腾讯连连小程序、通用版 App
1. 登录 物联网开发平台控制台,产品在量产前需经物联网开发平台审核通过后才能发布,在产品确认阶段,需要进行单击确认产品信息并发布进入申请发布量产。
2. 填写发布完成后,等待审批。
3. 审核通过后,选择左侧导航菜单设备量产,单击量产管理 > 批量创建设备。
4. 进入“创建量产”界面后,选择量产产品,在“一机一密二维码”栏选择“自动生成”,其他参数填写详情请参见 量产管理,单击确定即可完成量产创建。
5. 量产创建成功后,在“量产管理”页面即可出现批次列表,单击该批次右侧查看,即可获取量产详情信息。
6. 在量产详情页面单击下载设备信息,在生成的文件中,QR-code 后的内容即为每台设备的绑定二维码内容。
自主品牌小程序/App
1. 登录 物联网开发平台控制台,在产品确认阶段,单击确定信息并发布进入量产管理阶段。
2. 选择左侧导航菜单设备量产,单击量产管理 > 批量创建设备。
3. 进入“创建量产”界面后,选择量产产品,在“一机一密二维码”栏选择“自动生成”,其他参数填写详情请参见 量产管理,单击确定即可完成量产创建。
4. 量产创建成功后,在量产管理页面即可出现批次列表,单击该批次右侧查看,即可获取量产详情信息。
5. 在量产详情页面单击下载设备信息,在生成的文件中,QR-code 后的内容即为每台设备的绑定二维码内容。
量产管理介绍
当设备基于物联网开发平台完成开发并测试通过后,设备会进入量产阶段。待产品发布完成后,用户需要生成设备证书,烧录到设备中进行量产。
量产阶段一般至少会经过以下三个环节:
1. 设备所有者在 IoT Explorer 批量生成设备的关键信息(DeviceName、DeviceSecret)。
2. 设备所有者将生成的设备关键信息分发到授权设备厂家进行烧录。
3. 设备厂家按设备所有者的测试要求进行产测,产测通过的设备进行包装和交付,产测不通过的设备则不会包装、交付,需进一步分析产测不通过的原因。
前提条件
产品已完成前序开发步骤,产品已发布,进入批量投产环节。
设备的实际生成环境,已具备量产的资质条件。
量产步骤
1. 登录 物联网开发平台 ,选择公共实例。
2. 单击左侧菜单设备量产 > 量产管理,即可查看当前量产的产品记录。
说明:
首次进入量产管理,若无数据,则会在列表区域显示“暂无量产记录,请单击创建量产”。
3. 单击批量创建设备,则需要用户填写具体的产品信息和量产烧录方式。
量产产品:从下拉框选择已经发布的产品,会自动获取产品 ID。
烧录方式:可以选择一机一密和一型一密两种烧录方式,详情请参见 选择烧录方式。
生产方式:
对于一机一密烧录方式可以选择系统自动随机生成唯一的 DeviceName 和 DeviceSecret, 或者自主上传文件作为 DeviceName 并生成对应的 DeviceSecret。
对于一型一密可以选择自主上传文件作为 DeviceName 并生成对应的 DeviceSecret。
量产数量:最多一次性量产10000个设备。
一机一密二维码:根据需求自行选择。
4. 选择好烧录方式后,单击确定,后台会对批量任务进行处理。
5. 当后台审核处理完量产任务,则会显示量产信息,提供下载批量设备信息用于厂家烧录。
选择烧录方式
烧录方式分为一机一密(直接烧录)和一型一密(动态注册),一机一密又称为直接烧录,直接烧录的量产流程一般是自己生产、制造、烧录设备的企业使用,DeviceName 与 DeviceSecret 关键信息不会透露给外部合作伙伴,降低了关键信息在分发阶段转手风险。
功能项 | 直接烧录 | 动态注册 |
设备烧录信息 | 设备证书,即:ProductID、DeviceName、DeviceSecret。 | 设备证书,即: ProductID、ProductSecret、DeviceName(设备名称,一般为设备本身的 MAC 地址、SN 等)。 |
生成方式 | 自动生成和上传文件。 | 上传文件。 |
量产数量 | 单产品下10000个设备。 | 单产品下10000个设备。 |
安全性 | 较高。 | 较低。 |
默认开启 | 是。 | 控制台人工开启。 |
一机一密(直接烧录)
直接烧录的流程也分两种:
第一种:系统自动生成一批 DeviceName 与 DeviceSecret。
第二种:设备所有者上传产品序列号作为 DeviceName,然后系统根据上传的序列号生成与之一一对应的 DeviceSecret。
系统自动生成 DeviceName 与 DeviceSecret
1. 设备所有者选择一机一密直接烧录。
2. 设备所有者选择批量生成的设备数量。
3. 后台根据设备数量自动生成唯一的 DeviceName 与 DeviceSecret。
4. 后台通过下载 CSV 文件的方式输出生成的设备信息。
5. 设备所有者下载文件后可进行具体生成过程中的烧录过程。
系统根据用户导入的 DeviceName,生成配对的 DeviceSecret
1. 设备所有者选择一机一密直接烧录。
2. 设备所有者选择文件上传方式,并导入预先准备好的文件。
3. 后台根据上传文件中第一列的数据作为 DeviceName,并自动生成对应的 DeviceSecret。
4. 后台通过下载 CSV 文件的方式输出生成的设备信息。
5. 设备所有者下载文件后可进行具体生成过程中的烧录过程。
一型一密(设备动态注册)
设备动态注册的目的是在分发阶段不会提供 DeviceSecret,只会提供 ProductID、ProductSecret、DeviceName。设备在产测环节,会根据 ProductID、ProductSecret、DeviceName 去云端动态获取对应的 DeviceSecret,设备端收到后将存储该 DeviceSecret,然后发起设备正常的登录流程。可应用于需要将设备密钥信息分发多次的场景。
控制台操作流程
1. 设备所有者选择一型一密动态注册的烧录方式。
2. 设备所有者选择文件上传方式,并导入预先准备好的文件。
3. 后台根据上传文件中第一列的数据作为 DeviceName。
4. 系统为选择“动态注册”的产品输出产品 Secret 参数。
5. 设备所有者将 ProductID、ProductSecret 和 DeviceName 列表文件分发至设备生产厂家。
补充说明
厂家烧录产测环节设备上线动态获取密钥的流程如下:
1. 设备生产厂家将获取到设备所有者分发的数据进行烧录。
2. 烧录完成后进行产测。
3. 设备上电后,固件程序检查本地无 DeviceSecret,则通过设备 SDK 封装好的接口送入产品 ID、产品密钥、 DeviceName,SDK 将向云端获取 DeviceSecret。
3.1 首先对请求合法性进行签名校验。
3.2 其次检查 DeviceName 是否已在云端存在。
若不存在,则注册失败,产测也失败。
若设备存在,则云端将为该 DeviceName 返回一个加密后的 DeviceSecret。
4. 设备端收到 DeviceSecret 后,进行解密并存储在本地。
5. 设备端通过动态获取的 DeviceSecret,向云端发起 MQTT 登录请求。
6. 登录成功,则表示产测的第一步通过。