简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

Bluetooth LE 系列授权

更新时间:2022-05-12 02:08:33下载pdf

完成固件开发后,您需要对模组或芯片进行授权以实现连接云服务的能力。根据不同场景的需求,涂鸦提供了多种烧录授权的方式。本文介绍如何获取并使用三种类型的授权凭证。

获取授权凭证

  1. 涂鸦 IoT 开发平台 上创建自定义开发方案产品。详细步骤请参考 创建产品

  2. 硬件开发 步骤中,选择 免费领取2个激活码

    说明:每个新账号可以领取 2 个激活码。

    Bluetooth LE 系列授权

  3. 选择一种授权凭证。平台提供了 生产凭证生产凭证-仅授权授权码清单 三种凭证。
    Bluetooth LE 系列授权

授权码清单

授权码清单存于一个 Excel 表格,其中包含了 UUID+authKey 的组合。客户购买后由云端一次性生成授权码清单,且清单可在线下使用。

使用场景

前期开发调试阶段(仅蓝牙),生产信息由用户自己管控。

第一步 平台下单

在获取授权凭证步骤中选择 授权码清单

Bluetooth LE 系列授权

授权码在提取订单的时候生成,多用于设备调测阶段领用,可以定义为常量直接写入 SDK 中。

Bluetooth LE 系列授权

第二步 SDK 配置流程

研发工程师在前期调试的时候,可通过修改SDK中的以下内容进行临时授权:

  1. 在头文件中填写授权码清单中的信息。
    Bluetooth LE 系列授权

  2. 在 demo.c 文件中使能授权信息。

    Bluetooth LE 系列授权

    例如上图中,默认修改以下信息:

    .use_ext_license_key = 1, //1-info in tuya_ble_sdk_demo.h, 0-auth info
    .device_id_len       = 16, //DEVICE_ID_LEN,
    

    注意事项

    早期下载的 SDK 版本中,可能没有 use_ext_license_key 成员,此时仅修改 device_id_len 即可,请参照下述代码中的形式进行修改。

    device_param.device_id_len = 16;    //If use the license stored by the SDK,initialized to 0, Otherwise 16.
    

生产凭证

生产凭证为一个字符串。生产凭证(Token)包含了涂鸦 IoT 开发平台上传的固件信息及授权信息。
在云模组烧录授权平台中烧录时,需要输入生产凭证。该软件依赖网络,使用时会显示生产凭证的剩余次数,并会从云端拉取授权信息。软件安装使用请参考 通用 Wi-Fi SDK 烧录授权说明

使用场景

多方合作模式中委托涂鸦完成芯片的烧录授权,在固件开发完成阶段用于固件验证。

第一步 配置固件

  • 修改 tuya_ble_sdk_demo.c 文件。tuya_ble_sdk_demo.c 里使用的默认配置表示使用芯片 flash 中存储的授权信息,即产测上位机导入的授权信息。

    use_ext_license_key = 0 
    device_id_len =0 
    

    Bluetooth LE 系列授权

  • 修改 tuya_ble_sdk_demo.h 文件,部分参数修改请参考下表。

    Bluetooth LE 系列授权

    参数 说明
    TY_DEVICE_PID 产品 ID。该参数需要先在 IoT 平台上创建产品,才可以获取到产品 ID
    TY_DEVICE_FIR_NAME 固件标识名。固件的唯一标识,上架固件时需要填写该参数,建议(公司名缩写+芯片或产品名称)
    TY_DEVICE_FVER_NUM 固件版本号(HEX类型)。与 TY_DEVICE_FVER_STR 保持一致低地址两字节有效
    TY_DEVICE_FVER_STR 固件版本号(字符串)。上架固件时需要填写该参数,蓝牙只支持两位版本号,即 X.X 格式

完成以上配置以后可编译固件,并进行下一步。

第二步 新建固件

  1. 在自定义方案产品创建流程的 硬件开发 页面下,单击 新增自定义固件

    Bluetooth LE 系列授权

  2. 在弹出的窗口中补全信息。

    Bluetooth LE 系列授权

    其中有几个选项说明如下,其余按照平台提示配置即可。

    参数 说明
    固件标识名 与固件中填写的标识名保持一致
    固件类型 选择蓝牙固件
    Flash 大小 按芯片资料配置
    是否使用涂鸦生产 涂鸦标准模组 SDK 开发,该选项可选
  3. 完成配置后单击 上传固件

第三步 上传固件

Bluetooth LE 系列授权

需要注意,固件版本 和当前 SDK 配置中保持一致。生产固件用户区固件升级固件,不同芯片平台文件类型名称略有不同,如不确定可以联系涂鸦技术支持。上传固件后要先完成固件上架后,固件才能在前台绑定。

第四步 平台下单

  1. 在获取授权凭证步骤中选择 生产凭证

    Bluetooth LE 系列授权

  2. 下载“生产凭证”文件:

    • 调试订单可在订单列表页中下载。

    • 量产订单可在提货单列表页下载压缩文件包。压缩包中包含一个.txt 文件,文件中为授权码(token)、数量和授权日期。

      Bluetooth LE 系列授权

第五步 云模组烧录

根据 PID 在平台获取授权码,参考 烧录授权 操作步骤章节内容下载安装 云模组烧录授权平台

烧录步骤为:

  1. 先给模组断电。
  2. 在云模组烧录授权平台软件中,输入授权码后单击 运行
  3. 烧录成功后,给模组上电。

生产凭证-仅授权

生产凭证-仅授权的表现形式是一串字符串,指生产凭证(Token)中不含固件信息,只用于授权激活。

它与授权码清单(UUID+Authkey)交付的区别:烧录时需要使用涂鸦上位机,上位机软件依赖网络,软件界面会显示生产凭证的剩余次数,运行时从云端实施拉取授权信息。

使用场景

设备固件由自己烧录的客户,仅使用涂鸦烧录工具进行授权产测操作。

第一步 平台下单

  1. 在获取授权凭证步骤中选择 生产凭证-仅授权

    Bluetooth LE 系列授权

  2. 下载“生产凭证-仅授权”文件:调试订单可在订单列表页,量产订单可在提货单列表页下载交付的压缩文件包,压缩包中包含一个.txt文件,文件中为授权码(token)、数量和授权日期。

    Bluetooth LE 系列授权

第二步 上位机烧录

以下为 生产凭证-仅授权 烧录方式。有以下两种烧录方式

  • 使用 独立授权工具+ 生产凭证-仅授权
  • 使用独立授权工具+ 生产工单
  • 在进行此步骤时请确认您的蓝牙 SDK 中已实现涂鸦的产测接口。
  • 已经注册申请了[PMS](https://pms.tuya.com/) 账号。

测试阶段

  1. 登录 PMS ,并在 生产支持 > 软件下载 中下载“生产解决方案”。
    Bluetooth LE 系列授权

  2. 下载后安装后,使用 PMS 账号密码登录软件,然后在主菜单界面选择 独立授权
    Bluetooth LE 系列授权

  3. 填写生产凭证信息。

    1. 工具通过串口与芯片/模组连接,所以需要在左侧 基础信息设置 区域将 通讯方式 设置为 串口波特率设置为 9600,其余选择按照默认即可。
    2. 在右侧区域中,在串口对应编号的窗口中选择对应 COM 口,,然后单击 基础信息设置 区域中左下方的 开始
    • **等待SN** 框中无需输入信息
    • 该工具最多支持1拖32路同时进行产测

    Bluetooth LE 系列授权

  4. 按上图填写信息后,点击独立授权。

  5. 在运行过程中当软件提示”开始授权 10%“时,对芯片/模组进行复位。
    如果进入产测模式失败,请尝试将波特率调整为 9600 进行测试或再次尝试复位。

  6. 等待独立授权完成。


量产阶段

  1. 参照《PMS自建工单操作说明》指导将领到的 生产凭证-仅授权 转换为工单。

    Bluetooth LE 系列授权

    • 转工单操作中若网页提示无操作权限、请提交工单申请。
    • PMS自建工单操作说明》需要在 [PMS](https://pms.tuya.com) 中下载。
  2. 输入工单号对模组进行授权。
    Bluetooth LE 系列授权

  3. 输入工单号和SN,后续步骤请参考‘’测试阶段‘’步骤进行授权。

    SN =工单号+5位16进制流水码(流水码从0开始递增,最大值为授权次数的总数) ,例如:工单号:FGSHFBE,SN号:FGSHFBE00001