stlink

意法半导体 STLINK 工具的开源版本

最近的新功能和错误修复可以在该软件项目的变更日志中找到。

执照

stlink 库和工具根据BSD-3 许可证获得许可。

介绍

stlink 是一个开源工具集，用于编程和调试 STMicroElectronics 制造的 STM32 设备和板。它支持多个所谓的 STLINK 编程器板（及其克隆），这些编程器板使用微控制器芯片将命令从 USB 转换为 JTAG/SWD。市场上有四代产品，均受该工具集支持：

• STLINK/V1 [自 2019 年 11 月 21 日起已过时，该工具集继续支持]
  • 传输层：通过 USB 的 SCSI 直通命令
  • 独立程序员
  • 板载于 STM32VL Discovery 板上
• STLINK/V2
  • 传输层：原始USB命令
  • 独立程序员
  • 板载于 STM32L Discovery 和 STM32 Nucleo 板上
• STLINK/V2-1
  • 传输层：原始USB命令
  • 某些 STM32 Nucleo 板上板载
• STLINK-V3
  • 传输层：原始USB命令
  • 独立编程器（STLINK-V3SET、STLINK-V3MINI、STLINK-V3MODS）
  • 某些 STM32 Nucleo 板载 (STLINK-V3E)

在用户级别上，这些不同版本之间的处理或操作没有区别。

STlink 工具集包括：

• st-info - 编程器和芯片信息工具
• st-flash - 闪存操作工具
• st-trace - 记录执行信息的日志工具
• st-util - GDB 服务器（通过 Cortex-Debug 插件在 Visual Studio Code / VSCodium 中受支持）
• stlink-lib - 通信库
• stlink-gui - GUI 界面[可选]

支持的操作系统和硬件组合

support_devices.md 中列出了当前已知的工作 MCU 目标。

支持的操作列表可以在 version_support.md 中找到。

教程和操作指南

我们的教程可以帮助您完成一些高级任务和附加信息。

安装

窗户：

从版本 v1.6.1 开始，独立的 Windows 二进制文件（再次）在项目的发布页面上提供。请确保为您的系统选择正确的版本（i686 或 x86_64）。存档文件可以解压缩到任何所需位置，因为它不包含任何硬编码路径。但是，我们建议将解压缩的应用程序文件夹移动到 32 位系统上的C:Program Files和 64 位系统上的C:Program Files (x86) （工具集是 32 位）。

或者，可以按照我们的编译手册中所述从源代码进行编译和安装。

Linux / Unix ：

我们建议从所用发行版的软件包存储库安装stlink-tools ：

注意：由于通过 Debian 和 Ubuntu 存储库分发的软件包与我们自行维护的 deb-package 不同，我们建议使用后者（请参阅下面的链接）。它提供了直接在项目内处理和修复用户报告的包问题的机会，并且对于外部维护指南产生的任何限制并不多余。

• Debian Linux：（链接）
• Ubuntu Linux：（链接）
• Arch Linux：（链接）
• Alpine Linux：（链接）
• 费多拉：（链接）
• FreeBSD：用户可以从 freshports 安装

苹果系统：

v1.8.0 已取消对 macOS 的支持。

请改用 v1.7.0，但请注意，该版本不再维护和支持！

从源安装（高级用户）

当您的平台没有可用的可执行文件或者您需要最新（可能不稳定）版本时，您需要自己编译工具集。这个过程在编译手册中有解释。

贡献和版本控制

• 使用语义版本控制方案。欲了解更多信息，请访问 semver.org
• 在创建拉取请求之前，请始终打开一个新问题来讨论预期的新功能。错误修复不需要通过问题票进行讨论。然而，一旦它们似乎也能帮助别人，就应该用几句话来描述它们。
• 贡献者和/或维护者可以提交评论或请求更改补丁提案和/或拉取请求。
• 注意：切勿使用“#”字符来计算列表中的单个点，因为“#”专门保留用于引用 GitHub 问题和拉取请求。否则，您会不小心在项目中引入错误的交叉引用。
• 请从开发分支启动新的分支，因为拉取请求也将进入该分支。

另请参阅我们的贡献指南。

用户评论

我希望这不是脱离主题，但我对 OpenBSD 上与 AVR 相关的东西感到非常沮丧，事实上 stlink 是开箱即用的，不需要接触任何东西，这让我感到很轻松。确实让我的整个周末变得更好了！我认为这要感谢 @Crest 以及 stlink-org 团队（似乎是 @Nightwalker-87 和 @xor-gate），他们制作了一个对“边缘”操作系统并不不友好的软件。谢谢你 <3" - nbonfils, 11.12.2021