at.py 工具
at.py
工具用于修改打包好的 2 MB/4 MB AT 量产固件(即 build/factory
目录下的 factory_XXX.bin
)中的多种参数配置。这些配置包括 Wi-Fi 配置、证书和密钥配置、UART 配置、GATTS 配置等。当默认的固件无法满足您的需求时,您可以使用 at.py
工具修改固件中的这些参数配置。
详细步骤
请根据下方详细步骤,完成 at.py
工具下载、固件中的配置修改以及固件烧录。推荐您优先选择 Linux 系统开发。
第一步:Python 安装
如果您本地已经安装过 Python,则可以跳过此步骤。否则,请根据 Python 官方文档,完成 Python 的下载和安装。推荐您使用 Python 3.8.0 或更高版本。
安装完成后,您可以在命令行中输入 python --version
,查看 Python 版本。
第二步:at.py 下载
访问 at.py 页面,点击 Download raw file
按钮,将 at.py
文件下载到本地。
第三步:at.py 用法说明
当前 at.py
支持修改固件中的参数配置,请在命令行中输入 python at.py modify_bin --help
,查看支持的用法以及说明。
第四步:at.py 修改固件中的配置示例
备注
您可以混合修改多种参数配置,例如,您可以同时修改 Wi-Fi 配置和证书和密钥配置。
待修改的参数配置,脚本并不会检查其合法性,请确保您输入的参数配置是合法的。
修改后的参数配置,在当前 mfg_nvs 目录下的
mfg_nvs.csv
中,会有对应的记录。
修改 Wi-Fi 配置
当前可修改的 Wi-Fi 参数配置如下表所示:
参数 |
功能 |
说明 |
---|---|---|
--tx_power |
Wi-Fi 的最大发射功率 |
详情见 ESP32-C2 发射功率 |
--country_code |
Wi-Fi 国家代码 |
详情见 Wi-Fi 国家/地区代码 中的 cc 字段 |
--start_channel |
Wi-Fi 起始信道 |
详情见 Wi-Fi 国家/地区代码 中的 schan 字段 |
--channel_number |
Wi-Fi 的总信道数 |
详情见 Wi-Fi 国家/地区代码 中的 nchan 字段 |
例如,您可以使用以下命令,修改 Wi-Fi 的最大发射功率为 18 dBm,国家代码为 US,起始信道为 1,总信道数为 11:
python at.py modify_bin --tx_power 72 --country_code "US" --start_channel 1 --channel_number 11 --input factory_XXX.bin
--tx_power 72:单位是 0.25 dBm,72 表示 18 dBm
--input factory_XXX.bin:输入的固件文件
修改证书和密钥配置
当前可修改的证书和密钥配置如下表所示:
参数 |
功能 |
原始文件 |
---|---|---|
--server_ca |
TLS 服务器的 CA 证书 |
|
--server_cert |
TLS 服务器的证书 |
|
--server_key |
TLS 服务器的密钥 |
|
--client_ca0 |
第 0 套客户端的 CA 证书 |
|
--client_cert0 |
第 0 套客户端的证书 |
|
--client_key0 |
第 0 套客户端的密钥 |
|
--client_ca1 |
第 1 套客户端的 CA 证书 |
|
--client_cert1 |
第 1 套客户端的证书 |
|
--client_key1 |
第 1 套客户端的密钥 |
|
--mqtt_ca |
MQTT 客户端的 CA 证书 |
|
--mqtt_cert |
MQTT 客户端的证书 |
|
--mqtt_key |
MQTT 客户端的密钥 |
|
--wpa2_ca |
WPA2-Enterprise 客户端的 CA 证书 |
|
--wpa2_cert |
WPA2-Enterprise 客户端的证书 |
|
--wpa2_key |
WPA2-Enterprise 客户端的密钥 |
例如,您可以使用以下命令,修改 MQTT 客户端的 CA 证书、客户端的证书和密钥。
python at.py modify_bin --mqtt_ca mqtt/mqtt_ca.crt --mqtt_cert mqtt/mqtt.crt --mqtt_key mqtt/mqtt.key --input factory_XXX.bin
--input factory_XXX.bin:输入的固件文件
修改 UART 配置
可修改的 UART 配置,仅包括 AT 命令端口 的 UART 配置。可修改的参数配置如下表所示:
参数 |
功能 |
说明 |
---|---|---|
--uart_num |
AT 命令口的 UART 号 |
仅在 AT 日志口同时用作 AT 命令口时,需要修改此参数。同时需保证下面的 |
--baud |
AT 命令口的波特率 |
原始值:115200 |
--tx_pin |
AT 命令口的 TX 管脚 |
请保证待修改的管脚不会和其他管脚冲突 |
--rx_pin |
AT 命令口的 RX 管脚 |
请保证待修改的管脚不会和其他管脚冲突 |
--cts_pin |
AT 命令口的 CTS 管脚 |
请保证待修改的管脚不会和其他管脚冲突。不用流控时,修改此参数为 -1。 |
--rts_pin |
AT 命令口的 RTS 管脚 |
请保证待修改的管脚不会和其他管脚冲突。不用流控时,修改此参数为 -1。 |
例如,您可以使用以下命令,修改 AT 命令口的波特率为 921600,TX 管脚为 17,RX 管脚为 16,禁用流控。
python at.py modify_bin --baud 921600 --tx_pin 17 --rx_pin 16 --cts_pin -1 --rts_pin -1 --input factory_XXX.bin
--input factory_XXX.bin:输入的固件文件
修改 GATTS 配置
修改前,请先阅读 如何自定义低功耗蓝牙服务 文档,了解 GATTS 的配置文件 gatts_data.csv 中的各个字段的含义。
当前可修改的 GATTS 配置如下表所示:
参数 |
功能 |
---|---|
--gatts_cfg0 |
更新 gatts_data.csv 文件中 index 为 0 的一行数据 |
--gatts_cfg1 |
更新 gatts_data.csv 文件中 index 为 1 的一行数据 |
--gatts_cfg2 |
更新 gatts_data.csv 文件中 index 为 2 的一行数据 |
--gatts_cfg3 |
更新 gatts_data.csv 文件中 index 为 3 的一行数据 |
--gatts_cfg4 |
更新 gatts_data.csv 文件中 index 为 4 的一行数据 |
--gatts_cfg5 |
更新 gatts_data.csv 文件中 index 为 5 的一行数据 |
--gatts_cfg6 |
更新 gatts_data.csv 文件中 index 为 6 的一行数据 |
--gatts_cfg7 |
更新 gatts_data.csv 文件中 index 为 7 的一行数据 |
--gatts_cfg8 |
更新 gatts_data.csv 文件中 index 为 8 的一行数据 |
--gatts_cfg9 |
更新 gatts_data.csv 文件中 index 为 9 的一行数据 |
--gatts_cfg10 |
更新 gatts_data.csv 文件中 index 为 10 的一行数据 |
--gatts_cfg11 |
更新 gatts_data.csv 文件中 index 为 11 的一行数据 |
--gatts_cfg12 |
更新 gatts_data.csv 文件中 index 为 12 的一行数据 |
--gatts_cfg13 |
更新 gatts_data.csv 文件中 index 为 13 的一行数据 |
--gatts_cfg14 |
更新 gatts_data.csv 文件中 index 为 14 的一行数据 |
--gatts_cfg15 |
更新 gatts_data.csv 文件中 index 为 15 的一行数据 |
--gatts_cfg16 |
更新 gatts_data.csv 文件中 index 为 16 的一行数据 |
--gatts_cfg17 |
更新 gatts_data.csv 文件中 index 为 17 的一行数据 |
--gatts_cfg18 |
更新 gatts_data.csv 文件中 index 为 18 的一行数据 |
--gatts_cfg19 |
更新 gatts_data.csv 文件中 index 为 19 的一行数据 |
--gatts_cfg20 |
更新 gatts_data.csv 文件中 index 为 20 的一行数据 |
--gatts_cfg21 |
更新 gatts_data.csv 文件中 index 为 21 的一行数据 |
--gatts_cfg22 |
更新 gatts_data.csv 文件中 index 为 22 的一行数据 |
--gatts_cfg23 |
更新 gatts_data.csv 文件中 index 为 23 的一行数据 |
--gatts_cfg24 |
更新 gatts_data.csv 文件中 index 为 24 的一行数据 |
--gatts_cfg25 |
更新 gatts_data.csv 文件中 index 为 25 的一行数据 |
--gatts_cfg26 |
更新 gatts_data.csv 文件中 index 为 26 的一行数据 |
--gatts_cfg27 |
更新 gatts_data.csv 文件中 index 为 27 的一行数据 |
--gatts_cfg28 |
更新 gatts_data.csv 文件中 index 为 28 的一行数据 |
--gatts_cfg29 |
更新 gatts_data.csv 文件中 index 为 29 的一行数据 |
--gatts_cfg30 |
更新 gatts_data.csv 文件中 index 为 30 的一行数据 |
例如,您可以使用以下命令,修改 index 为 0 行的 perm 权限。
python at.py modify_bin --gatts_cfg0 "0,16,0x2800,0x011,2,2,A002" --input factory_XXX.bin
--input factory_XXX.bin:输入的固件文件
第五步:固件烧录
注意
修改后的 AT 固件,需要您根据自己的产品自行测试验证功能。
请保存好修改前和修改后的固件以及下载链接,用于后续可能的问题调试。
请根据 固件烧录指南,完成固件烧录。