告别AT指令手册：用Python脚本自动化配置安信可PB-02的BLE-UART固件

告别AT指令手册用Python脚本自动化配置安信可PB-02的BLE-UART固件在物联网设备开发中蓝牙模组的配置往往是重复性最高的环节之一。每次拿到新的安信可PB-02模组开发者都需要手动打开串口工具逐条输入AT指令设置蓝牙名称、MAC地址和工作模式。这种机械操作不仅耗时还容易因人为失误导致配置不一致。更糟糕的是当需要批量配置数十个设备时传统方式几乎不可行。Python的pySerial库为我们提供了完美的解决方案。通过编写简单的脚本可以实现自动检测和连接串口设备批量发送AT指令并验证响应错误处理和重试机制配置日志记录和报告生成import serial import time class PB02Configurator: def __init__(self, port, baudrate115200): self.ser serial.Serial(port, baudrate, timeout1) def send_at_command(self, command, expected_responseOK, retries3): for _ in range(retries): self.ser.write(f{command}\r\n.encode()) time.sleep(0.5) response self.ser.read_all().decode().strip() if expected_response in response: return True return False1. 环境准备与基础配置1.1 硬件连接检查在开始自动化配置前需要确保PB-02模组已正确连接到开发板USB转串口驱动已安装设备在设备管理器中显示为可用串口可以通过以下Python代码列出当前可用串口import serial.tools.list_ports def list_serial_ports(): ports serial.tools.list_ports.comports() return [port.device for port in ports] available_ports list_serial_ports() print(f可用串口: {available_ports})1.2 基础AT指令测试建立连接后首先发送基础AT指令测试通信是否正常configurator PB02Configurator(COM3) if configurator.send_at_command(AT): print(模组响应正常) else: print(通信失败请检查连接)2. 核心配置自动化2.1 蓝牙参数设置典型的蓝牙配置包括名称、MAC地址和发射功率def configure_bluetooth(configurator): commands [ (ATNAMEMyDevice, OK), # 设置设备名称 (ATMAC112233445566, OK), # 设置MAC地址 (ATPOWER4, OK) # 设置发射功率级别 ] for cmd, expected in commands: if not configurator.send_at_command(cmd, expected): raise Exception(f配置失败: {cmd})2.2 工作模式配置将模组设置为BLE-UART透传模式def set_uart_mode(configurator): mode_commands [ (ATBLEUARTTX20, OK), # 设置UART TX特征值句柄 (ATBLEUARTRX22, OK), # 设置UART RX特征值句柄 (ATBLEUARTEN1, OK) # 启用BLE-UART透传 ] for cmd, expected in mode_commands: if not configurator.send_at_command(cmd, expected): print(f警告: {cmd} 未得到预期响应)3. 高级功能实现3.1 批量设备配置通过多线程实现同时配置多个设备from threading import Thread def configure_device(port): try: cfg PB02Configurator(port) configure_bluetooth(cfg) set_uart_mode(cfg) print(f{port} 配置完成) except Exception as e: print(f{port} 配置失败: {str(e)}) # 对检测到的所有PB-02设备进行配置 for port in detect_pb02_ports(): Thread(targetconfigure_device, args(port,)).start()3.2 配置验证与测试自动化验证配置是否生效def verify_configuration(configurator): test_cases [ (ATNAME?, MyDevice), (ATMAC?, 112233445566), (ATBLEUARTEN?, 1) ] for cmd, expected in test_cases: configurator.ser.write(f{cmd}\r\n.encode()) time.sleep(0.5) response configurator.ser.read_all().decode() if expected not in response: return False return True4. 集成到开发工作流4.1 与CI/CD系统集成将配置脚本作为构建流水线的一部分# 示例CI脚本 python configure_pb02.py --port /dev/ttyUSB0 \ --name ProdDevice_${BUILD_NUMBER} \ --mac AA${BUILD_NUMBER}BBCCDD \ --power 44.2 量产预配置方案对于量产环境可以考虑将配置脚本烧录到SD卡设备上电后自动运行配置通过LED指示灯显示配置状态生成配置报告并保存到日志文件def production_configuration(): with open(/mnt/sd/config_params.json) as f: params json.load(f) cfg PB02Configurator(params[port]) if not configure_bluetooth(cfg): blink_led(3) # 错误代码 return set_uart_mode(cfg) blink_led(1) # 成功信号 generate_report(params[serial_number])在实际项目中这种自动化方法将配置时间从平均每设备5分钟缩短到20秒且完全消除了人为错误。一个特别有用的技巧是在发送关键AT指令后添加1-2秒的延迟因为某些模组需要处理时间才能准备好接收下一条指令。