CB 系列模组烧录授权

更新时间:2024-06-19 06:43:49下载pdf

通过涂鸦开发者平台免开发方案成功生成固件,或使用自定义开发方案生成固件并上传到涂鸦开发者平台后,下一步需要对模组进行烧录授权。

本文将详细讲解 3 种不同的烧录授权方式:

  • 自定义开发烧录授权:适用于发布阶段,使用自定义开发方式创建的产品。

  • 三明治开发板方式烧录授权:仅适用于涂鸦三明治开发板的烧录授权。

  • 使用原厂工具烧录:适用于开发阶段。方案的特点是 授权一次,重复烧录

    下文中的生产凭证,授权码和 token 均描述同一事物。

适用芯片

适用于核心芯片为 BK7231N 的 CBX 系列模组,包含下列型号。

烧录前准备

烧录授权所需工具如下:

  • 申请涂鸦智慧生产管理系统(PMS)账号
  • 下载 生产解决方案
  • 下载 BK 原厂烧录工具
  • 一个 USB 转 UART 转换工具

注册 PMS 账号

选择个人开发者,按照系统注册指引填写相关信息后,你会收到涂鸦发送的审核成功邮件。

CB 系列模组烧录授权

下载并安装生产解决方案

下载生产解决方案

  1. 审核通过后,输入 PMS 账号和密码登录 涂鸦 PMS 系统

  2. 登录成功后,选择 知识库管理 > 软件下载 > 生产解决方案,下载 生产解决方案

    可在 软件名称 区域,搜索 生产解决方案

    CB 系列模组烧录授权

安装生产解决方案

  1. 双击 生产解决方案 安装包,会现下面的警告,单击 更多信息

    CB 系列模组烧录授权

  2. 单击 仍要运行

    CB 系列模组烧录授权

  3. 根据自身需求,设置程序安装的位置,建议不要有中文路径。

  4. 完成安装后,启动 生产解决方案,登录账号和密码同涂鸦 PMS 系统的账号和密码。

    CB 系列模组烧录授权

  5. 单击 云模组

    CB 系列模组烧录授权

  6. 检查安装情况。

    CB 系列模组烧录授权

    • 红色框内为黄色,则说明安装成功。可 下载原厂烧录工具

    • 红色框内全为白色,就需要对软进行如下设置,使它恢复正常。

      (1) 单击 文件 > 设置

      CB 系列模组烧录授权

      (2) 在 基础设置 中,将箭头 ① 指向的 多路选择1*1 选项改为 1*2,再单击 确认

      CB 系列模组烧录授权

      多路选择 改变后,界面如下图所示。

      CB 系列模组烧录授权

      (3) 将多路选择的 1*2,改回到 1*1,使两个黄色框变为一个黄色框,设置就完成了。

      CB 系列模组烧录授权

下载原厂烧录工具

单击 bk_writer_gui_V1.6.3,下载 Beken 原厂工具。

烧录

不同开发板或模组的烧录流程也不一样。如果使用的是涂鸦的三明治开发板,建议通过 云模组 工具进行烧录。

自定义开发烧录授权

此方案适用于 发布阶段 ,使用自定义开发方式创建的产品,需要先将编译好的固件上传到涂鸦开发者平台,获取生产凭证(token)后,再使用 云模组 工具进行烧录授权。

涂鸦模组需要完成授权才能连接涂鸦平台。授权完成的模组如果需要烧录开发好的固件或更改后的固件,可以参考 使用原厂工具烧录

上传固件

  1. 进入 涂鸦开发者平台,单击已开发的产品,找到 硬件开发

  2. 按照下图指示,单击 新增自定义固件,再填写相关固件信息。

    参数名称 描述
    固件标识名 固件标识名 必须和编译时的 apps 下的工程文件夹的名称保持一致。也就是说,如果这里的固件标识名填写为 wifi_one_light ,那么上传的固件应为 SDK 包中 apps 目录下的 wifi_one_light 文件夹中编译所生成的固件。
    Flash 大小 Flash 大小16 Mbit,也就是 2M 大小。关于不同模组的 flash 大小,参考涂鸦 文档中心Note: 1 byte(字节)= 8 bits(位)。 16 Mbit ÷ 8 = 2M。
    没有被 ② 的框框圈到的参数 使用默认设置。

    CB 系列模组烧录授权

  3. 相关信息填写完成后,单击 上传固件,进入下一步,开始上传固件。进行如下操作之后,单击 保存

    参数名称 描述
    固件版本 需要和编译时输入的版本号对应一致。
    生产固件 上传包含 QIO 的 bin 文件。
    用户区固件 上传包含 UA 的 bin 文件。
    升级固件 上传包含 UG 的 bin 文件。
    运行模式 运行模式选择 QIO

    CB 系列模组烧录授权

  4. 单击 进行固件上架

    CB 系列模组烧录授权

  5. 选择 不限范围,单击 确认上架

    选择 不限范围 是方便个人开发者管理产品。如果是公司将要量产的产品,请根据你的实际需求设置允许使用范围。

    CB 系列模组烧录授权

获取生产凭证(token)

将固件上传到涂鸦开发者平台,成功上架后,您就可以免费领取激活码。使用激活码通过 云模组 工具进行烧录授权。

  1. 单击 免费领取激活码

    CB 系列模组烧录授权

  2. 交付方式选择生产凭证,单击提交订单

    • 生产凭证: 产测授权工具 烧录授权 功能读取的凭证编码,可自动抓取指定数量的授权码,随固件一起逐个写入设备。需上传生产固件至涂鸦开发者平台。
    • 授权码清单: 写着每一个授权码 UUID 及相关信息的表单,需自行逐个写入设备。
    • 生产凭证-仅授权: 产测授权工具 独立授权 功能读取的凭证编码,无需固件,即可对设备进行逐个授权。

    CB 系列模组烧录授权

  3. 单击 去订单列表页看看

    CB 系列模组烧录授权

  4. 确认箭头 ① 所指向信息是否正确。确认无误后,单击箭头 ② 的 下载生产凭证

    CB 系列模组烧录授权

  5. 解压下载好的生产凭证,打开 Token_information.txt 文件,并复制生产凭证。

  6. 云模组 工具中输入生产凭证,并选择工位 烧录授权

    CB 系列模组烧录授权

    如果出现 获取 token 失败,没有操作权限 的错误,请参考 获取 token 失败,没有操作权限 中的解决办法。

    CB 系列模组烧录授权

    生产凭证输入完成后,界面如下图所示。在 基础信息 一栏中显示固件的相关信息。

    CB 系列模组烧录授权

烧录授权

  1. 云模组 工具上根据按照箭头的指引,输入生产凭证,选择工位为 烧录授权,并单击 确定

    CB 系列模组烧录授权

  2. 按照下表通过 USB 转 UART 工具,把三明治开发板与电脑连接起来。

    USB 转 UART 引脚 三明治 SoC 开发板引脚
    VCC VCC
    GND GND
    TX RX
    RX TX
  3. 选择烧录的串口,单击 运行,然后马上给模组断电再上电或按下复位按键使模组重启,开始对模组进行烧录授权操作。

    • 重启模组时不要直接把串口工具从电脑上拔掉,避免造成烧录失败。建议拔掉再插上模组与串口工具连接的 VCC 和 GND 的杜邦线。
    • CBU 的三明治 SoC 开发板自带 CH304 串口芯片。单击 运行 后,按下开发板上 USB 口复位按键即可重启芯片,开始烧录授权。

    CB 系列模组烧录授权

  4. (可选)如果在烧录授权过程中出现 进入产测失败 的错误,可能是因为该开发板在上一次烧录授权时,联网时长已经累计超过 15 分钟,设备此时关闭了产测功能,才导致无法进入产测,出现授权失败的情况。解决办法可参考 进入产测失败

    CB 系列模组烧录授权

三明治开发板方式烧录授权

本方法仅适用于涂鸦三明治开发板的烧录授权。

在涂鸦开发者平台上使用免开发方案创建的产品只能通过绑定三明治 SoC 主控板,在三明治开发套件中申请授权码的方式申请到生产凭证(token)。如果账号没有绑定过三明治 SoC 主控板,只有涂鸦模组,既不能获取到免开发方案产品的 token,也不能给模组烧录授权免开发方案的固件。

绑定三明治开发板

打开 涂鸦开发者平台,单击 产品 > 开发者工具 > 三明治开发板 > 绑定开发板。在弹窗中,输入开发板上的 ID 和密码,即可完成绑定。

CB 系列模组烧录授权

三明治开发板获取 Token

绑定完成后,根据下方图片指示的顺序进行操作,选择要烧录的产品,单击 申请新的授权码,便可成功申请到授权码。

CB 系列模组烧录授权

烧录授权

  1. 复制从涂鸦开发者平台上获取到的授权码后,打开 云模组 工具。

    CB 系列模组烧录授权

  2. 烧录授权可以参考 烧录授权,进行操作。

使用原厂工具烧录

此方案适用于开发阶段。方案的特点是 授权一次,重复烧录。方案需要确保模组在烧录前已完成授权,且烧录时要注意选择的 flash 区域,避免程序写入位置错误,导致程序无法正常运行。

在开发过程中,如果每次使用 云模组 工具对模组进行烧录授权,相对来说不太方便。如果模组已经完成授权,使用原厂工具进行烧录授权的方式,不但不会刷掉模组的授权信息,还可以达到 授权一次,重复烧录 的效果。

Beken 平台

使用此方法只能烧录应用区固件,无法给模组进行授权操作。可以使用该方法给已经授权过的模组进行烧录,避免每次更新代码生成固件后都要上传到涂鸦开发者平台使用 云模组 工具进行烧录授权。

  1. 按照下图步骤,在箭头 ① 所指向的烧录对象中,根据实际烧录的模组选择对应的芯片型号,可在 文档中心 查看相关模组规格书,确认模组使用的芯片型号。

  2. 单击箭头 ② 指向的 浏览 按钮,选择成功编译生成的包含了 UA 字样的 bin 文件。该文件就是应用区固件,这里选择的固件就是 wifi_one_light

  3. 在箭头 ③ 和箭头 ④ 指向的 起始地址 中填入 0x00011000操作长度 中填入0x00119000

  4. 在箭头 ⑤ 指向的位置选择正确的烧录串口,将箭头 ⑥ 指向的 通讯波特率 调整为最高值,可以加快烧录速度。

  5. 单击箭头 ⑦ 指向的 烧录,给模组通断电或复位模组使模组重启,开始烧录。烧录完成后,更改后的代码就成功烧录到模组中。你可以不再使用 云模组 工具对该模组再次进行授权操作。

    CB 系列模组烧录授权

烧录授权 FAQs

获取 token 失败,没有操作权限

输入生产凭证是,出现 获取 token 失败:没有操作权限 的提示。

CB 系列模组烧录授权

解决办法

如果出现该错误,需要登录 涂鸦 PMS 系统,选择 生产管理 > 工单管理 > 生产凭证确认,输入生产凭证,并单击 确认。之后,回到 云模组 工具中输入该生产凭证,单击 确认,即可开始烧录授权操作。

CB 系列模组烧录授权

抢总线失败错误

可能其它软件占用了烧录使用的串口。

解决办法

可以将烧录串口工具软件全部关闭,或直接插拔 USB 转 TTL 串口工具。

获取固件指纹错误

在仅授权的场景下,会出现 获取固件指纹错误 的情况。错误原因是由于模组内烧录的固件名称或版本号与授权的固件名称或版本号不一致。

解决办法

  1. 输入与模组固件名称和版本号一致的生产凭证(token),再进行授权处理。

  2. 对该模组进行烧录授权处理(非仅授权)。

    CB 系列模组烧录授权

进入产测失败

设备累计联网时长超过 15 分钟后,会关闭产测功能。在烧录授权过程中,如果出现 进入产测失败 的错误,并且日志中有 have actived over 15 min, not enter mf_init 字样的日志打印,说明设备关闭了产测功能。

解决办法

你需要先擦除 flash 中的相关数据才能授权成功。

CB 系列模组烧录授权

修改代码(通用方式)

进入产测失败时,可以在 tuya_device.c 文件 pre_device_init() 函数内调用 mf_test_ignore_close_flag() ; 函数,忽略产测关闭标志,从而避免因为产测关闭而无法通过授权。

CB 系列模组烧录授权

Beken 系列,使用原厂工具擦除相关数据

打开 Beken 原厂提供的烧录授权 bk_writer 工具,按照下图步骤将箭头 ① 指向的 烧录对象 选项改为对应的芯片。关于模组芯片型号,参考涂鸦 文档中心 的相关模组规格书。

三明治 SoC Beken 平台开发板介绍:

  • WB3S:烧录对象选择 BK7231
  • CBU:烧录对象选择 BK7231N
  • 起始地址:0x001EE000,操作长度:0x00012000

选择开发板烧录串口,单击 擦除 Flash 按钮,重启模块,开始擦除内存数据。

CB 系列模组烧录授权