蓝牙通讯开发python

转载

技术极客之光 2024-08-17 11:17:45

文章标签 蓝牙通讯开发python 开发语言物联网驱动开发固件 文章分类 Python 后端开发

固件开发完成后，需要将固件和授权码烧录到设备内，才可以连接云服务。涂鸦提供多种烧录授权方式供您使用，您可在不同的开发阶段选择合适的烧录授权方式。

一. 方案介绍

1.1 烧录授权一体方案

烧录授权一体方案指的是烧录和授权都通过涂鸦云模组烧录授权平台实现，涂鸦云模组烧录授权平台已经集成了涂鸦标准芯片的烧录软件，您需要将固件按规范传到涂鸦 IoT 平台，然后获取授权码 (生产凭证) 进行烧录授权。

1.2 烧录授权分立方案

烧录授权分立方案适用于开发调试阶段或涂鸦云模组烧录授权平台未集成芯片的烧录软件时，您可使用芯片烧录软件进行固件烧录，根据授权方式的不同可分为以下两种情况：

自行写入授权码：涂鸦以 MS Excel 文件形式提供授权码 (授权码清单)，您需要将其写入固件实现授权，然后通过芯片烧录软件完成烧录授权。
使用涂鸦上位机写入授权码：您需要将固件按规范传到涂鸦 IoT 平台，获取授权码 (生产凭证-仅授权) 后即可通过涂鸦云模组烧录授权平台完成授权，通过芯片烧录软件进行固件烧录。

二. 固件上传

如果选择通过涂鸦云模组烧录授权平台进行授权，需要先在涂鸦 IoT 平台的【硬件开发】页面上传固件。

新增固件。进入产品【硬件开发】页面，单击下图中的【新增自定义固件】。
填写固件信息。（点击各条目的 “?” 图标查看填写说明）

固件标识名：必须与步骤 3 中配置的固件标识名保持一致；
Flash 大小：可以在模组规格书的产品概述中找到；

填写完成后点击【生成固件 KEY】，如果提示【标识名已存在】，则需重新填写新的标识名。固件标识名具有唯一性，不可与已创建的固件重复，可根据产品规格或个人喜好进行命名，例如【芯片平台+产品类型+产品特性+厂商标识名/个人姓名缩写】。

蓝牙通讯开发python_蓝牙通讯开发python

配置固件。打开 SDK 中 tuya_ble_sdk_demo\app 路径下的 tuya_ble_sdk_demo.h 文件，修改产品 ID 、固件标识名和固件版本号，固件标识名必须与步骤 2 中填写的保持一致。固件版本的定义可以参考固件版本说明，蓝牙单点固件的版本号一般采用 bv.sv (0.0~99.99) 格式，对应于代码中 TY_DEVICE_FVER_NUM 的低 16 位，比如版本号为 1.10 时，TY_DEVICE_FVER_NUM 为 0x0000010A (00 00 01 0A)。

/* 将“xxxxxxxx”替换为在涂鸦IoT平台上创建的产品的PID */
#define TY_DEVICE_PID         "xxxxxxxx"

/* 修改固件名称和版本号，上传固件时填写的信息需与这里一致 */
#define TY_DEVICE_FIR_NAME    "ble_module_sdk_development_demo"
#define TY_DEVICE_FVER_NUM    0x00000001
#define TY_DEVICE_FVER_STR    "0.1"

打开 SDK 中 tuya_ble_sdk_demo\app 路径下的 tuya_ble_sdk_test.h 文件，将 TUYA_BLE_SDK_TEST 的值修改为 0，以关闭测试模式；

/* 将 1 修改为 0，关闭测试模式 */
#define TUYA_BLE_SDK_TEST     0

生成固件。对修改后的代码进行编译，生成用于烧录的固件。对于 TLSR825x 平台而言，代码编译前建议对工作区文件进行刷新后再编译，编译生成的固件为 ble_sdk_multimode\8258_module\8258_module.bin。
新增固件版本。在步骤 2 生成固件 KEY 后，可以看到【当前版本】中提示【！无生产版本】，点击下方的【新增固件版本】进入【上传固件】页面。
上传固件。（点击各条目的 “?” 图标查看填写说明）

固件版本：必须与步骤 3 中配置的固件版本保持一致。
生产固件：用于传递给工厂烧录的固件文件。
用户区固件：用于传递给工厂烧录的固件文件。
升级固件：用于固件升级 (OTA) 的固件文件，首次上传固件时可忽略。对于 TLSR825x 平台而言，生产固件、用户区固件、升级固件均为 8258_module\8258_module.bin。

蓝牙通讯开发python_驱动开发_02

如果是在步骤 2 直接点击【上传固件】进入步骤 6 的，那么可能会在点击【保存】后才提示【标识名已存在】，可以点击【返回上一步】回到步骤 2 所示页面，修改固件标识名，同时要修改本地固件中的标识名。然后再点击【上传固件】进入步骤 6 所示页面，并将鼠标移至已上传的 8258_module.bin 上，点击右侧出现的删除图标，再上传新的固件。

进行固件上架。
设置上架内容和上架范围后上架固件。
固件管理。可在左侧导航栏【固件管理】中找到固件，点击【详情】可查看更多固件信息。

三. 授权码获取

3.1 模组

在【硬件开发】页面选择好云模组后即可获取授权码，操作步骤如下：

点击【立即购买】进入购买详情页。（新用户可免费申请 2 个授权码，参考步骤 5）
设置数量后，点击【立即购买】进入订单信息确认页面，确认信息无误后提交订单完成购买。
如果仅购买授权码，可点击右上角“×”号退出模组的购买详情页，并在通用备货采购页面选择授权码-通用版进行购买。该页面也可通过左侧导航栏的采购 - 采购商品 - 生产研发采购中进入。
在购买详情页设置产品和交付形式后完成授权码购买。

蓝牙通讯开发python_物联网_03

蓝牙通讯开发python_固件_04

如果选择 “免费领取 2 个激活码”，在免费领取授权码页面设置好交付形式后下单即可。
订单提交后，可在采购 - 订单管理 - 采购订单中进入调试样品&样品订单页面，下载产品对应的授权码。

3.2 三明治开发板

如果使用涂鸦三明治开发板进行开发，获取授权码的步骤如下：

进入三明治开发板管理界面，绑定开发板。
单击【申请新的授权码】，选择对应的产品后，单击【确定】即可获得授权码。

如果申请失败并提示“您需要先申请到烧录软件专门的账号”，请先在涂鸦PMS 系统注册页面完成账号申请，申请的手机号 (账号) 要与 IoT 平台的手机号 (账号) 保持一致。

四. 固件烧录授权

在烧录授权之前，请确认是否已按照第 3 课：环境搭建中的方法准备好了以下烧录环境：

已注册了 PMS 账号；
已安装了生产解决方案和原厂烧录软件 ( BTU模组：Telink BDT )；
已准备了安装有涂鸦蓝牙模组的的开发板、芯片专用烧录器和 USB 转串口工具。

下面根据授权码的三种交付形式进行固件烧录授权的操作步骤说明。

4.1 生产凭证

将开发板与 USB 转串口工具及烧录器 (Telink) 连接。

有些芯片平台只需要连接 USB 转串口工具，TLSR825x 芯片平台必须两个都连接！

打开生产解决方案软件，登录 PMS 账号。
点击云模组进入涂鸦云模组烧录授权平台。
选择端口号，输入生产凭证，工位选择烧录授权。
点击运行完成烧录授权。

4.2 授权码清单

将开发板与烧录器 (Telink) 连接。
从授权码清单中选取一组 uuid、authkey 和 mac 地址填入 tuya_ble_sdk_demo.h 中的对应位置。

#define TY_DEVICE_PID         "xxxxxxxx" /* PID */
#define TY_DEVICE_MAC         "xxxxxxxx" /* mac */
#define TY_DEVICE_DID         "xxxxxxxx" /* uuid */
#define TY_DEVICE_AUTH_KEY    "xxxxxxxx" /* authkey */

在 tuya_ble_sdk_demo.c 中的将初始化参数 use_ext_license_key 和 device_id_len 分别修改为 1 和 DEVICE_ID_LEN (即 16)，以使上述授权码生效。

static tuya_ble_device_param_t tuya_ble_device_param = {
    .use_ext_license_key = 1,             /* 1-info in tuya_ble_sdk_demo.h, 0-auth info */
    .device_id_len       = DEVICE_ID_LEN, /* DEVICE_ID_LEN-info in tuya_ble_type.h, 0-auth info */
    .p_type              = TUYA_BLE_PRODUCT_ID_TYPE_PID,
    .product_id_len      = 8,
    .adv_local_name_len  = 4,
    .firmware_version    = TY_DEVICE_FVER_NUM,
    .hardware_version    = TY_DEVICE_HVER_NUM,
};