STM32CubeIDE ST-LINK 服务器

[复制链接]

STMCU小助手发布时间：2023-2-13 20:54

文章
文章封面:
文章简介:	STM32CubeIDE ST-LINK 服务器

引言 STM32CubeIDE ST-LINK GDB server 也被称为 GDB server，是通过 ST-LINK JTAG 探头在与 Arm® Cortex®-M 目标设备连接的PC 上运行的命令行应用程序。
ST-LINK GDB server 启动时会通过 ST-LINK JTAG 连接至 STM32 Arm® Cortex®-M 目标设备。与目标设备侧建立通信之后，将等待客户端连接至 TCP 监听套接字。客户端连接至 TCP 监听套接字之后，ST-LINK GDB server 将处理客户端发送的远程串行通信协议（RSP）消息，并对目标设备侧执行适当操作，随后向客户端回复 RSP。
图 1 展示了使用 ST-LINK GDB server 和 STMicroelectronic ST-LINK 探头调试 Arm® Cortex®-M 目标设备的标准调试会话。

FV@2P[8TW2G42C$J6SUCT9H.png

该图展示了如何利用 TCP 套接字接口将 GDB 客户端连接至 ST-LINK GDB server,以便对 ST-LINK JTAG 上所连接的Arm® Cortex®-M 目标进行调试。

1 GDB server 使用
STM32CubeIDEST-LINK GDB 服务器是命令行应用程序，该应用程序可通过以下方式启动
• 输入一组命令行选项
• 指示 GDB server 从配置文件中加载选项
若未指定任何选项， GDB server 将以预配置默认选项启动。启动选项及对应的默认值列于第 1.1 节 GDB server启动选项中。
STM32CubeIDEST-LINK GDB 服务器利用 STM32CubeProgrammer (STM32CubeProg)对需要调试的设备进行flash 下载。当 gdb 发出 load 命令时， GDB server 将自动使用 STM32CubeProgrammer 软件。
当需要进行高级设备控制（例如 Flash 擦除或者设置选项字节）时，可以使用 STM32CubeProgrammer(STM32CubeProg)。它包含在 STM32CubeIDE 中并且可以从 STMicroelectronics 网站 www.st.com 单独下载。
STM32CubeIDE 支持基于 Arm® Cortex®处理器的 STM32 32 位产品。提示 Arm 是 Arm Limited（或其子公司）在美国和/或其他地区的注册商标。

1.1 GDB server 启动选项
GDB 服务器可以利用以下命令启动：
ST-LINK_gdbserver.exe [options]
大多数选项有长格式和短格式两种格式。以下将介绍 GDB server 支持的选项组，其中默认模式和配置以粗体表示：
• -h, --help使 ST-LINK_gdbserver 显示使用信息。
• -c , --config-file 指示 GDB server 从配置文件中读取选项。附录 B 中提供了有关语法分析的配置文件示例。• -f , --log-file 指定日志文件名称。默认名称为 debug_log.txt。
• -l , --log-level 指定记录级别。记录级别分为 0 至 31 级。将记录级别指定为 0 时将关闭记录功能，将记录级别指定为 31 时将启用完全记录。默认记录级别为 31。记录级别可以根据以下列表进行设置：
– = 0：禁用记录。
– ≥ 1：启用错误消息记录。
– ≥ 2：增加警告消息。
– ≥ 4：增加通信特定消息。
– ≥ 8：增加所有信息消息
– ≥ 16：增加所有 HW 特定消息。
因此若未指定选项–f 和-l，服务器将以默认的 31 级记录级别（完全记录）启动，默认日志文件为 debug_log.txt。
• -p , --port-number
指定服务器监听客户端连接对应的 TCP 端口号。服务器监听的默认端口号为 61234。
• -v, --verbose
在命令行中指定-v 将启用详细模式；此外，还将打印服务器调试日志标准输出。默认情况下，详细模式处于禁用状态。
• -r , --refresh-delay
指定调试日志文件中硬件状态更新的间隔时间（单位秒）。注意，状态更新间隔时间很短会导致调试日志文件扩大。默认状态刷新延迟时间为 5 秒。
• -s, --verify
启用 Flash 下载验证。
• -e, --persistant指定选项-e 后将在持续模式下启动服务器。
默认情况下，持续模式将处于禁用状态，这意味着服务器将在非持续模式下启动。
• -d, --swd启用串行线调试（SWD）模式指定使用 SWD 而非使用 JTAG。[对 SWV 使用此选项。]
• -z , --swo-port 指定服务器输出原始 SWO 数据对应的 TCP 端口号[对 SWV 使用此选项。]
• -a , --cpu-clock 指定 CPU 的时钟频率，单位 Hz。[对 SWV 使用此选项。]
• -b , --swo-clock-div 指定 SWO 时钟分频器。利用–a 选项可以使其作用于给定的 CPU 时钟速度。[对 SWV 使用此选项。]同时使用–z、–a 和–b 选项可指定 SWO 速度。例如当核心以 168 Mhz 频率运行，目标 SWO 频率为 1 Mhz时，将按照以下方式配置上述选项： -z 61235 -a 168000000 –b 168。当核心以 72 Mhz 频率运行，SWO 频率为 125 kHz 时，将使用-z 61235 –a 72000000 –b 576。
• -k, --initialize-reset在复位状态下将设备初始化。
• -q, --debuggers列出已连接的调试器，ST-LINK 序列号。
• -i , --serial-number 指定服务器应连接的 ST-LINK 序列号。
• -m , --apid 定义需要调试的 apID。[对多内核使用此选项。]
• -g, --attach连接正在运行的目标。
• -t, --shared允许使用一个 ST-LINK 探头将两个或以上程序连接至同一台设备。[对 ST-LINK server 使用此选项。]
• --erase-all
擦除所有存储内容。
• --memory-map
显示给定设备标识符对应的存储器映射例如 0x410。
• --ext-memory-loaders
提供可供使用的外部存储器加载程序列表。
• -el , --extload
选择自定义外部存储器加载程序。
• -cp , --stm32cubeprogrammer-path
STM32CubeProgrammer (STM32CubeProg)安装路径。
• --temp-path
启动调试会话的临时文件存储在此前提供的路径下。
• --licenses
提供已使用的工具和许可列表。
• --, --ignore-rest
忽略剩余的、后跟此标志的标签参数。
• --版本
显示版本信息并退出。

1.2 GDB server 工作模式
此服务器可以在持续模式或非持续模式下运行 - 具体由配置选项决定。在持续模式下，服务器将在客户端断开连接后继续运行并等待新连接，而在非持续模式下客户端关闭连接后服务器将直接退出。但如果服务器与目标进行通信时出现错误，无论服务器处于哪一种模式，服务器都将关闭所有连接并关机。

1.3 启动 GDB server
GDB server 可以在命令窗口中以下列方式启动：
1. cd
C:\ST\STM32CubeIDE_1.0.0.19w12patch\STM32CubeIDE\plugins\com.st.stm32cube.ide.mcu.externaltools.stlink-gdb-server.win32_1.0.0.201903011553\tools\bin\STLINK_gdbserver
2. 利用–cp 和 STM32_Programmer_CLI.exe 路径启动 GDB server
例如：ST-LINK_gdbserver.exe -d -v -cp"C:\ST\STM32CubeIDE_1.0.0.19w12patch\STM32CubeIDE\plugins\com.st.stm32cube.ide.mcu.externaltools.cubeprogrammer.win32_1.0.0.201903011553\tools\bin"
3. 随后 GDB server 将通过 ST-LINK JTAG 与 STM32 设备相连，并等待 GDB 调试会话命令。

完整版请查看：附件