简体中文
简体中文
English
联系我们
注册
登录
语言
简体中文
简体中文
English
联系我们
登录
注册
返回主站
layout空间导航

Bluetooth LE 系列授权

更新时间:2021-09-10 06:06:14下载pdf

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

获取授权凭证

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

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

    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. 下载IndependentAuthDebugger

    注意

    • 注意第一次下载后,要重新打开软件,让工具自动升级到最新版本。
    • 该工具只能用于调试阶段,禁止用于产测!

    Bluetooth LE 系列授权

  2. 工具通过串口与芯片连接,通讯方式选择为COM,波特率为115200,SN不需要输入。

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

  4. 在运行过程中当软件提示”开始授权 10%“时,对芯片进行复位。如果进入产测模式失败,请尝试将波特率调整为9600测试(老SDK版本)。

  5. 独立授权完成

量产阶段

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

    Bluetooth LE 系列授权

    转工单操作中若网页提示无操作权限、请提交工单申请。

    说明:《PMS自建工单操作说明》需要在 PMS 中下载。

  2. 使用 云模组烧录授权平台 输入工单号对模组进行授权。
    Bluetooth LE 系列授权

  3. 输入工单号后,按下回车键并选择 工位-授权

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