Skip to content

Latest commit

 

History

History
156 lines (127 loc) · 4.54 KB

README.cn.md

File metadata and controls

156 lines (127 loc) · 4.54 KB
Raw

stc8prog - STC ISP 烧录工具

stc8prog 是一个用于STC 8051系列微控制器的命令行烧录工具, 用于解决在Linux下烧录 STC8H/STC8G/STC8A8K64D4 系列芯片的问题. 当前只支持 STC8H/STC8G/STC8A, STC15 (FWVER > 0x72) 系列型号.

STC微控制器有一个基于UART/USB的引导装入程序(BSL), 它在串口上利用基于包的协议来烧录代码储存器和IAP储存器, 这被称为在线系统编程(ISP). 这个工具是依据STC8H数据手册中ISP描述而制作的.

已测试通过的型号:

  • STC8A8K64S4A12
  • STC8A8K64D4
  • STC8G1K08A
  • STC8H1K08
  • STC8H3K32S2
  • STC8H3K64S4
  • STC8H8K64U
  • STC15W104
  • STC15F104W
  • STC15W408AS
  • STC15F2K60S2

使用

命令行工具

烧录时需要对MCU重新加电, 过程和stcgal, 以及官方的stc-isp工具是一样的.

Usage: stc8prog [options]...
  -h, --help                    display this message
  -p, --port <device>           set device path
  -s, --speed <baud>            set download baudrate
  -r, --reset <msec>            make reset sequence by pulling low dtr
  -r, --reset <cmd> [args] ;    command to perform reset or power cycle
  -f, --flash <file>            flash chip with data from hex file
  -e, --erase                   erase the entire chip
  -d, --debug                   enable debug output
  -v, --version                 display version information

Baudrate options: 
   4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 500000, 576000,
   921600, 1000000, 1152000, 1500000, 2000000, 2500000, 3000000, 3500000,
   4000000

检查

与MCU作握手通信, 过程不作任何写入. 过程中先通过2400波特率握手, 再切换到115200波特率握手

# 2400 baud -> 115200 baud
./stc8prog -p /dev/ttyUSB0

可以使用参数-s指定其它的波特率(必须在可选的波特率列表里)

# 2400 baud -> 1152000 baud
./stc8prog -p /dev/ttyUSB0 -s 1152000

擦除

擦除整块MCU

./stc8prog -p /dev/ttyUSB0 -e

烧录

建议在烧录时带上擦除参数

./stc8prog -p /dev/ttyUSB0 -e -f foo.hex

使用更高的波特率可以加速烧录

./stc8prog -p /dev/ttyUSB0 -s 1152000 -e -f foo.hex

集成到PlatformIO

1. 添加到 packages

PlatformIO的packages目录默认路径是 /home/[username]/.platformio/packages

  1. 在下面新建一个目录 tool-stc8prog
  2. 将可执行文件 stc8prog 复制到这个目录下

2. Configurate platformio.ini

在项目的platformio.ini中新建一个env, 可以用现有的env复制创建, 修改upload_protocol选项为custom, 并增加对应的配置参数, 下面是一个例子

[env:stc8h3k32s2-stc8prog]
platform = intel_mcs51
board = stc8h3k32s2
upload_protocol = custom
upload_port = /dev/ttyUSB0
upload_flags =
    -p
    $UPLOAD_PORT
    -s
    1152000
    -e
upload_command = ${platformio.packages_dir}/tool-stc8prog/stc8prog $UPLOAD_FLAGS -f $SOURCE

如果需要通过拉低DTR来复位MCU, 在 upload_flags 中添加-r 5
如果需要把这个env设置为默认, 把它修改为 default_envs

[platformio]
default_envs = stc8h3k32s2-stc8prog

更多说明和配置项请参考文档 platformio section_env_upload

3. 烧录

通过菜单或快捷键 Ctrl+Alt+U 开始烧录, 如果过程中出现错误, 需要看到更多的日志信息, 可以通过verbose方式

  1. 点击左侧导航栏中PlatformIO的图标
  2. 在PROJECT TASKS中, 点击展开[your env name]
  3. 在里面点击展开 Advanced
  4. 点击 Verbose Upload, 这样会输出完整的命令行信息

从源码构建

安装 DEV-tools

sudo apt install build-essential

检出项目

# GitHub
git clone https://github.com/IOsetting/stc8prog.git
# Gitee
git clone https://gitee.com/iosetting/stc8prog.git

编译

cd stc8prog
make

(可选)安装到系统

sudo make install

Gentoo linux

dev-embedded/stc8prog-9999 安装包位于 unoficial rasdark overlay. 二进制文件来源于 https://github.com/IOsetting/stc8prog.git 的最新提交

Windows: 使用 Cygwin 编译

  1. 安装 Cygwin
  2. 安装 'gcc-core' 和 'make'
  3. 使用命令行, 导出最新的 stc8prog 源代码
  4. 运行 Cygwin 命令行
  5. 导航至 stc8prog 源代码目录 (windows disks are mapped to /cygdrive; eg. to navigate to 'stc8prog' folder located on 'D' drive, use 'cd /cygdrive/d/stc8prog/')
  6. 运行make进行编译
  • 默认设置下, Cygwin 的 gcc binary 需要 cygwin1.dll 才能正常工作, 可以从 Cygwin 的安装目录复制.