stlink

Open-Source-Version der STMicroelectronics STLINK Tools

Aktuelle neue Funktionen und Bugfixes finden Sie im Changelog dieses Softwareprojekts.

Lizenz

Die Stlink-Bibliothek und -Tools sind unter der BSD-3-Lizenz lizenziert.

Einführung

stlink ist ein Open-Source-Toolset zum Programmieren und Debuggen von STM32-Geräten und -Boards von STMicroelectronics. Es unterstützt mehrere sogenannte STLINK-Programmierplatinen (und Klone davon), die einen Mikrocontroller-Chip verwenden, um Befehle von USB in JTAG/SWD zu übersetzen. Auf dem Markt sind vier Generationen verfügbar, die alle von diesem Toolset unterstützt werden:

• STLINK/V1 [veraltet seit 21.11.2019, weiterhin Unterstützung durch dieses Toolset]
  • Transportschicht: SCSI-Durchgangsbefehle über USB
  • eigenständiger Programmierer
  • On-Board auf STM32VL Discovery-Boards
• STLINK/V2
  • Transportschicht: rohe USB-Befehle
  • eigenständiger Programmierer
  • On-Board auf STM32L Discovery- und STM32 Nucleo-Boards
• STLINK/V2-1
  • Transportschicht: rohe USB-Befehle
  • On-Board auf einigen STM32 Nucleo-Boards
• STLINK-V3
  • Transportschicht: rohe USB-Befehle
  • eigenständiger Programmierer (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • On-Board auf einigen STM32 Nucleo-Boards (STLINK-V3E)

Auf Benutzerebene gibt es zwischen diesen verschiedenen Revisionen keinen Unterschied in der Handhabung oder Bedienung.

Das STlink-Toolset umfasst:

• st-info – ein Programmier- und Chip-Informationstool
• st-flash – ein Flash-Manipulationstool
• st-trace – ein Protokollierungstool zum Aufzeichnen von Informationen zur Ausführung
• st-util – ein GDB-Server (unterstützt in Visual Studio Code/VSCodium über das Cortex-Debug-Plugin)
• stlink-lib – eine Kommunikationsbibliothek
• stlink-gui – eine GUI-Schnittstelle [optional]

Unterstützte Betriebssysteme und Hardwarekombinationen

Derzeit bekannte funktionierende MCU-Ziele sind in „supported_devices.md“ aufgeführt.

Eine Liste der unterstützten Betriebssysteme finden Sie in version_support.md.

Tutorial & HOWTO

Unser Tutorial kann Ihnen mit einigen fortgeschrittenen Aufgaben und zusätzlichen Informationen weiterhelfen.

Installation

Windows :

Ab Release v1.6.1 stehen eigenständige Windows-Binärdateien (wieder) auf der Release-Seite des Projekts zur Verfügung. Bitte stellen Sie sicher, dass Sie die richtige Version für Ihr System auswählen (i686 oder x86_64). Die Archivdatei kann an einen beliebigen Ort entpackt werden, da sie keine fest codierten Pfade enthält. Wir empfehlen jedoch, den entpackten Anwendungsordner auf 32-Bit-Systemen nach C:Program Files und auf 64-Bit-Systemen nach C:Program Files (x86) zu verschieben (das Toolset ist 32-Bit).

Alternativ können Sie auch aus dem Quellcode kompilieren und installieren, wie in unserem Kompilierungshandbuch beschrieben.

Linux / Unix :

Wir empfehlen stlink-tools aus dem Paket-Repository der verwendeten Distribution zu installieren:

Hinweis: Da sich die über die Debian- und Ubuntu-Repositories verteilten Pakete von unserem selbst gepflegten Deb-Paket unterscheiden, empfehlen wir, stattdessen Letzteres zu verwenden (siehe Link unten). Es bietet die Möglichkeit, vom Benutzer gemeldete Paketprobleme direkt im Projekt zu bearbeiten und zu beheben und ist nicht überflüssig für Einschränkungen, die sich aus externen Wartungsrichtlinien ergeben.

• Debian Linux: (Link)
• Ubuntu Linux: (Link)
• Arch Linux: (Link)
• Alpine Linux: (Link)
• Fedora: (Link)
• FreeBSD: Benutzer können über Freshports installieren

macOS :

Die Unterstützung für macOS wurde mit v1.8.0 eingestellt.

Bitte verwenden Sie stattdessen v1.7.0, beachten Sie jedoch, dass diese Version nicht mehr gepflegt und unterstützt wird!

Installation von der Quelle (fortgeschrittene Benutzer)

Wenn für Ihre Plattform keine ausführbare Datei verfügbar ist oder Sie die neueste (möglicherweise instabile) Version benötigen, müssen Sie das Toolset selbst kompilieren. Dieses Vorgehen wird im Kompilierungshandbuch erläutert.

Mitwirken und Versionieren

• Es wird das semantische Versionierungsschema verwendet. Lesen Sie mehr unter semver.org
• Bevor Sie eine Pull-Anfrage erstellen, öffnen Sie bitte IMMER eine neue Ausgabe, um die beabsichtigten neuen Funktionen zu besprechen. Bugfixes erfordern keine Diskussion über ein Ticket-Problem. Sie sollten jedoch immer in wenigen Worten beschrieben werden, sobald sie den Anschein erwecken, auch anderen zu helfen.
• Mitwirkende und/oder Betreuer können Kommentare abgeben oder Änderungen an Patch-Vorschlägen und/oder Pull-Requests anfordern.
• ACHTUNG: Verwenden Sie NIEMALS das Zeichen „#“, um einzelne Punkte innerhalb einer Auflistung hochzuzählen, da „#“ ausschließlich für die Referenzierung von GitHub-Problemen und Pull-Requests reserviert ist. Andernfalls führen Sie versehentlich falsche Querverweise innerhalb des Projekts ein.
• Bitte starten Sie neue Forks im Entwicklungszweig, da Pull-Anfragen auch in diesen Zweig gehen.

Bitte beachten Sie auch unsere Beitragsrichtlinien.

Benutzerbewertungen

Ich hoffe, es ist nicht zu unangebracht, aber ich war so frustriert über AVR-bezogene Dinge unter OpenBSD, dass die Tatsache, dass Stlink sofort einsatzbereit war, ohne dass ich irgendetwas anfassen musste, eine große Erleichterung war. Es hat mein ganzes Wochenende buchstäblich besser gemacht! Ich gehe davon aus, dass es @Crest und auch dem stlink-org-Team (anscheinend (@Nightwalker-87 und @xor-gate) zu verdanken ist, dass sie eine Software entwickelt haben, die den „Rand“-Betriebssystemen nicht unfreundlich gegenübersteht. Vielen Dank <3“ – nbonfils, 11.12.2021