stlink

Version open source des outils STMicroelectronics STLINK

Les nouvelles fonctionnalités et corrections de bugs récentes peuvent être trouvées dans le journal des modifications de ce projet logiciel.

Licence

La bibliothèque et les outils stlink sont sous licence BSD-3 .

Introduction

stlink est un ensemble d'outils open source pour programmer et déboguer les appareils et cartes STM32 fabriqués par STMicroelectronics. Il prend en charge plusieurs cartes de programmation dites STLINK (et leurs clones) qui utilisent une puce de microcontrôleur pour traduire les commandes USB vers JTAG/SWD. Il existe quatre générations disponibles sur le marché, toutes prises en charge par cet ensemble d'outils :

• STLINK/V1 [obsolète depuis le 21-11-2019, prise en charge continue par cet ensemble d'outils]
  • couche de transport : commandes passthru SCSI via USB
  • programmeur autonome
  • intégré sur les cartes Discovery STM32VL
• STLINK/V2
  • couche de transport : commandes USB brutes
  • programmeur autonome
  • intégré aux cartes STM32L Discovery et STM32 Nucleo
• STLINK/V2-1
  • couche de transport : commandes USB brutes
  • intégré à certaines cartes STM32 Nucleo
• STLINK-V3
  • couche de transport : commandes USB brutes
  • programmateur autonome (STLINK-V3SET, STLINK-V3MINI, STLINK-V3MODS)
  • intégré sur certaines cartes STM32 Nucleo (STLINK-V3E)

Au niveau de l'utilisateur, il n'y a aucune différence de manipulation ou de fonctionnement entre ces différentes révisions.

L'ensemble d'outils STlink comprend :

• st-info - un programmeur et un outil d'information sur les puces
• st-flash - un outil de manipulation du flash
• st-trace - un outil de journalisation pour enregistrer des informations sur l'exécution
• st-util - un serveur GDB (pris en charge dans Visual Studio Code / VSCodium via le plugin Cortex-Debug)
• stlink-lib - une bibliothèque de communication
• stlink-gui - une interface GUI [facultatif]

Systèmes d'exploitation et combinaisons matérielles pris en charge

Les cibles MCU fonctionnelles actuellement connues sont répertoriées dans support_devices.md.

Une liste des opérations prises en charge peut être trouvée dans version_support.md.

Tutoriel et HOWTO

Notre didacticiel peut vous aider avec certaines tâches avancées et des informations supplémentaires.

Installation

Fenêtres :

À partir de la version v1.6.1, les binaires Windows autonomes sont (à nouveau) disponibles sur la page de publication du projet. Veuillez vous assurer de sélectionner la version appropriée pour votre système (i686 ou x86_64). Le fichier d'archive peut être décompressé à n'importe quel emplacement souhaité car il ne contient aucun chemin codé en dur. Cependant, nous suggérons de déplacer le dossier de l'application décompressé vers C:Program Files sur les systèmes 32 bits et vers C:Program Files (x86) sur les systèmes 64 bits (l'ensemble d'outils est de 32 bits).

Alternativement, on peut compiler et installer à partir des sources comme décrit dans notre manuel de compilation.

Linux/Unix :

Nous vous recommandons d'installer stlink-tools à partir du référentiel de packages de la distribution utilisée :

Remarque : Comme les packages distribués via les référentiels Debian et Ubuntu diffèrent de notre package deb auto-maintenu, nous vous recommandons d'utiliser ce dernier à la place (voir lien ci-dessous). Il offre la possibilité de gérer et de résoudre les problèmes de packages signalés par les utilisateurs directement dans le projet et n'est pas redondant par rapport aux limitations découlant des directives de maintenance externes.

• Debian Linux : (Lien)
• Ubuntu Linux : (Lien)
• Arch Linux : (Lien)
• Linux alpin : (Lien)
• Fedora : (Lien)
• FreeBSD : les utilisateurs peuvent installer à partir de Freshports

macOS :

La prise en charge de macOS a été abandonnée avec la v1.8.0.

Veuillez utiliser la v1.7.0 à la place, mais notez que cette version n'est plus maintenue et supportée !

Installation à partir des sources (utilisateurs avancés)

Lorsqu'aucun exécutable n'est disponible pour votre plate-forme ou que vous avez besoin de la dernière version (éventuellement instable), vous devez compiler l'ensemble d'outils vous-même. Cette procédure est expliquée dans le manuel de compilation.

Contribuer et versionner

• Le schéma de versionnement sémantique est utilisé. En savoir plus sur semver.org
• Avant de créer une pull request, veuillez TOUJOURS ouvrir un nouveau numéro pour discuter des nouvelles fonctionnalités prévues. Les corrections de bugs ne nécessitent pas de discussion via un ticket-issue. Cependant, ils doivent toujours être décrits en quelques mots dès qu’ils semblent également aider les autres.
• Les contributeurs et/ou les responsables peuvent soumettre des commentaires ou demander des modifications aux propositions de correctifs et/ou aux demandes d'extraction.
• ATTENTION : N'utilisez JAMAIS le caractère « # » pour compter des points uniques dans une liste, car « # » est exclusivement réservé au référencement des problèmes et des demandes d'extraction GitHub. Sinon, vous introduisez accidentellement de fausses références croisées dans le projet.
• Veuillez démarrer de nouveaux forks à partir de la branche de développement, car les demandes d'extraction seront également envoyées dans cette branche.

Veuillez également vous référer à nos directives de contribution.

Avis des utilisateurs

J'espère que ce n'est pas trop hors sujet, mais j'ai été tellement frustré par les choses liées à AVR sur OpenBSD, le fait que stlink soit construit immédiatement sans avoir besoin de toucher à quoi que ce soit était tellement soulageant. J'ai littéralement amélioré mon week-end ! Je suppose que c'est grâce à @Crest et aussi à l'équipe stlink-org (@Nightwalker-87 et @xor-gate semble-t-il) d'avoir créé un logiciel qui n'est pas hostile aux systèmes d'exploitation "marginaux". Merci <3" - nbonfils, 11.12.2021