OpenOCD 代码学习（4）其它配置命令

最新推荐文章于 2024-09-30 07:30:00 发布

送南阳马生序

最新推荐文章于 2024-09-30 07:30:00 发布

阅读量685

点赞数 11

分类专栏： OpenOCD 嵌入式 # 单片机文章标签： openocd

本文链接：https://blog.csdn.net/MicroMehhh/article/details/142535251

版权

单片机同时被 3 个专栏收录

15 篇文章 1 订阅

订阅专栏

嵌入式

11 篇文章 0 订阅

订阅专栏

OpenOCD

5 篇文章 1 订阅

订阅专栏

文章目录

前言

1）上一节我们学习了 adapter 与 transport 命令，这一节我们接着学习配置文件中的其它命令。本文主要是对配置文件中用到的命令（如下图）进行解析，以在命令行运行如下命令的结果为准：
```
openocd -d3 -f board/airm2m_air001.cfg
-d3 也作 --debug-level=3。即指定输出日志级别。
-f  也作 --file。这里指定开发板为合宙 air001 芯片。
```
2）这一节主要是学习 air001.cfg 文件的内容。这里简单提一下加载的两个文件：swj-dp.tcl 和 mem_helper.tcl。
- swj-dp.tcl 文件首先执行了 transport select 命令（这个已经在 cmsis-dap.cfg 中执行过，所以无影响）。然后定义了 swj_memdap 调用过程。
- mem_helper.tcl 文件则定义了操作 memory 的多个调用过程：
  - mrw/mrh/mrb 分别是 memory read word/halfword/byte，读取 memory。
  - mmw 则是 memory modify word，修改 memory。
3）参考链接：
- 代码：https://gitee.com/luyaocf/openocd.git
- 官方文档：https://openocd.org/doc-release/html/

1 swj_newdap

1）完整的 swj_newdap 命令如下：

swj_newdap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_CPUTAPID
# 替换掉变量后为：
swj_newdap air001     cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id 0x2ba01477

2）其中使用的 swj_newdap 命令是一个定义在 /tcl/target/swj-dp.tcl 文件中的 proc 可调用过程，其实现为：

# /tcl/target/swj-dp.tcl
proc swj_newdap {chip tag args} {
 if [using_jtag] {
     eval jtag newtap $chip $tag $args
 } elseif [using_swd] {
     eval swd newdap $chip $tag $args
 } else {
     echo "Error: transport '[ transport select ]' not supported by swj_newdap"
     shutdown
 }
}

# /src/target/startup.tcl
proc using_jtag {} {
	set _TRANSPORT [ transport select ]
	expr { [ string first "jtag" $_TRANSPORT ] != -1 }
}

（1）transport select 命令当未指定传输方式时，OpenOCD 会在自动选择一种传输方式的同时，并通过 Jim_SetResultString() 函数会将当前选择的传输方式作为结果返回。

3）创建名为 air001.cpu 的 Tap 过程如下（尽管该命令名叫 swj_newdap，实际上却是创建的 Tap）：
- 最终的结果是创建了 struct jtag_tap 对象，并追加到名为 __jtag_all_taps 的 Tap 链表中。

2 dap create

1）真正的创建 dap 过程如下：
2）dap create 命令：
- 首先通过 dap_name 指定待创建的 dap 名称；
- 其次通过 -chain-position tap_name 选项将上一小节中创建的 Tap 赋值给该 dap。
- 然后验证 dap 的合法性
- 最后会将 dap 的子命令复制给新创建的 dap（这里为 air001.dap）一份，因此你既可以使用如 dap info 的命令，也可以使用 air001.dap info 命令。
3）最终的结果是创建 struct arm_dap_object 对象，并追加到名为 all_dap 的 dap 链表中。

3 target create

1）创建 target。

target create <name> <target_type> [<target_options> ...]

（1）target_type：可取 arm7tdmi、cortex_m、arm11、esp32、stm8、riscv 等

（2）target_options 可取：这些选项也可以后续通过 <target_name> configure 命令设置

-type                   -endian    
-event                  -coreid    
-work-area-virt         -chain-position   
-work-area-phys         -dbgbase      
-work-area-size         -rtos         
-work-area-backup       -defer-examine    
-gdb-port               -gdb-max-connections

2）执行逻辑：
- 通过给定的 target_type 找到对应的 target 类型，这里为 cortexm_target
- 通过 target_configure() 函数处理该命令指定的选项
- 注册 target_type 的内置命令
- 重写并注册 air001.cpu 命令

4 <target_name> configure

1）创建完名为 air001.cpu 的 target 后，还需要进行配置：

target_name configure [options]

（1）target_name：一般可以通过 target create 命令创建

（2）options：

-type             ：一般指 MCU 架构，如 arm7tdmi、arm9tdmi、cortexm、 riscv 等
-event            
-work-area-virt   
-work-area-phys   ：工作空间的物理起始地址
-work-area-size   ：工作空间的大小
-work-area-backup ：工作空间是否备份 
-endian           ：大小端
-coreid           
-chain-position   
-dbgbase          
-rtos             
-defer-examine    
-gdb-port         
-gdb-max-connections

2）target 配置逻辑：
- 这里有一个疑问，如果使用 -chain-position 选项指定 air001.dap，则启动时报错；可如果使用要求的 -dap 选项，target_configure() 函数又不支持该选项。

5 flash bank

1）flash bank 一般用来声明芯片的 bank。

flash bank <name> <driver> <base> <size> <chip_width> <bus_width> <target>

参数：
- name：bank name，一般可以自定义为 “芯片.flash”
- driver：driver name，声明在 /src/flash/nor/drivers.c 文件中的，struct flash_driver 类型的芯片驱动。用户需要实现其中的读、写、擦除、探测等方法。
- base：base address，芯片 flash 的起始地址
- size：size bytes，芯片 flash 的大小。如果可以从芯片的某个寄存器中读取，建议在 flash_driver 中实现，则这里默认写 0 即可；否则需要填写芯片的准确大小，单位为：字节。
- chip\_width：默认为 0
- bus\_width：默认为 0
- target：通过 target create 命令创建的目标名称

2）flash bank 执行逻辑：
- 根据给定的 target 名称找到通过 target create 命令创建的 target
- 根据给定的 flash_driver 名称找到用户编写的 flash 驱动，并注册该驱动中的相关命令
- 创建 flash_bank 对象，并为其 name、target、driver 等属性赋值
- 调用 flash_driver 的 flash_bank_command() 函数指针
- 最后将该 flash_bank 对象添加到全局 flash_banks 链表中

总结

1）至此，我们基本掌握了配置文件中的相关命令，其实主要是创建了几个对象：

对象类型	对象名称	联系
struct adapter_driver	cmsis-dap st-link jlink ulink
struct transport	swd/jtag dapdirect_swd/dapdirect_jtag hla_swd/hla_jtag swim	adapter_driver->transports
struct jtag_tap	air001.cpu	——
struct arm_dap_object	air001.dap	dap->dap.tap = air001.cpu
struct target	air001.cpu	target->tap = air001.cpu（-dap 选项，存疑）