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