ckware/ti-cc-tool

ti-cc-tool Docker镜像文档

镜像概述

ti-cc-tool是集成cc2538-bsl引导加载程序工具的Docker镜像，专为TI CC系列无线MCU（如CC2538、CC2652、CC1352等）的固件刷写设计。该镜像将工具及其依赖打包，用户无需本地配置开发环境，通过Docker容器即可快速实现对目标设备的固件擦除、写入与验证操作，适用于物联网开发与设备批量编程场景。

核心功能与特性

• 工具集成：完整包含cc2538-bsl工具，支持TI CC系列主流无线MCU的引导加载程序交互
• 环境隔离：容器化封装Python依赖及串口通信组件，避免本地环境冲突
• 跨平台兼容：支持Linux、macOS、Windows（需Docker Desktop）等主流操作系统
• 设备支持：兼容CC2538、CC2652、CC1352、CC2530等多款TI CC系列无线MCU
• 串口访问：通过Docker设备挂载机制，直接访问宿主机串口设备（如/dev/ttyUSB0）

使用场景

• 物联网设备开发中TI CC系列MCU的固件更新与调试
• 批量生产环境下的设备固件统一刷写
• 开发团队内标准化工具版本，确保操作一致性
• 临时环境快速部署cc2538-bsl工具，减少环境配置时间

使用方法与配置说明

前提条件

• 已安装Docker Engine（v19.03+）
• 宿主机已识别目标串口设备（需确认设备路径，如Linux下的/dev/ttyUSB0，Windows下的COM3）
• 目标设备通过串口连接至宿主机，并处于引导加载模式（通常通过硬件复位或引脚配置进入）

基础使用命令

通过docker run命令启动容器，挂载串口设备与固件目录，执行刷写操作：

bash
docker run --rm --device=/dev/ttyUSB0 -v $(pwd):/firmware git-developer/ti-cc-tool \
  -p /dev/ttyUSB0 -b 115200 -e -w -v /firmware/target_firmware.bin

参数说明

• --device=/dev/ttyUSB0：将宿主机串口设备挂载至容器（需替换为实际设备路径）
• -v $(pwd):/firmware：挂载当前目录至容器内/firmware，用于访问本地固件文件
• -p /dev/ttyUSB0：指定容器内串口设备路径（需与--device参数一致）
• -b 115200：设置串口通信波特率（默认***，可根据设备手册调整）
• -e：擦除设备flash
• -w：写入固件文件（路径为容器内路径，如/firmware/target_firmware.bin）
• -v：验证写入的固件完整性

常用操作示例

1. 擦除设备Flash

bash
docker run --rm --device=/dev/ttyUSB0 git-developer/ti-cc-tool -p /dev/ttyUSB0 -e

2. 写入并验证固件

bash
docker run --rm --device=/dev/ttyUSB0 -v $(pwd):/firmware git-developer/ti-cc-tool \
  -p /dev/ttyUSB0 -w -v /firmware/cc2652_firmware.bin

3. 读取设备Flash内容

bash
docker run --rm --device=/dev/ttyUSB0 -v $(pwd):/output git-developer/ti-cc-tool \
  -p /dev/ttyUSB0 -r /output/flash_backup.bin

高级配置参数

cc2538-bsl工具支持的主要参数如下（完整列表见https://github.com/JelmerT/cc2538-bsl%EF%BC%89%EF%BC%9A

参考文档

• https://github.com/git-developer/ti-cc-tool
• https://github.com/JelmerT/cc2538-bsl