UM3088
Guide de démarrage rapide de l'ensemble d'outils de ligne de commande STM32Cube
Manuel d'utilisation

Introduction

Ce document est un bref guide permettant aux utilisateurs de démarrer rapidement avec STM32CubeCLT, l'ensemble d'outils de ligne de commande de STMicroelectronics pour les microcontrôleurs STM32.
STM32CubeCLT offre toutes les fonctionnalités STM32CubeIDE packagées pour une utilisation à l'invite de commande par des IDE tiers, ou l'intégration continue et le développement continu (CD/CI).

Le package simplifié STM32CubeCLT unique comprend :

• Versions CLI (interface de ligne de commande) des outils ST tels que la chaîne d'outils, l'utilitaire de connexion de sonde et l'utilitaire de programmation de mémoire flash
• Système à jour view descripteur (SVD) files
• Toute autre métadonnée pertinente de l'IDE STM32CubeCLT permet :
• Création d'un programme pour les périphériques MCU STM32 à l'aide d'une chaîne d'outils GNU améliorée pour STM32
• Programmation des mémoires internes du MCU STM32 (mémoire flash, RAM, OTP et autres) et des mémoires externes
• Vérification du contenu de la programmation (somme de contrôle, vérification pendant et après la programmation, comparaison avec file)
• Automatisation de la programmation du MCU STM32
• Débogage des applications via l'interface des produits STM32 MCU, qui permet d'accéder aux ressources internes du MCU à l'aide des fonctionnalités de débogage de base

informations générales

L'ensemble d'outils de ligne de commande STM32CubeCLT pour microcontrôleurs STM32 fournit des outils pour créer, programmer, exécuter et déboguer des applications ciblant les microcontrôleurs STM32 basés sur le processeur Arm® Cortex® ‑M.
Note:
Arm est une marque déposée d'Arm Limited (ou de ses filiales) aux États-Unis et/ou ailleurs.

Documents de référence

• Ensemble d'outils de ligne de commande pour MCU STM32 (DB4839), fiche de données STM32CubeCLT
• Guide d'installation STM32CubeCLT (UM3089)
• Note de version STM32CubeCLT (RN0132)

Captures d'écran dans ce document
Les captures d'écran fournies dans la section 2, la section 3 et la section 4 ne sont qu'exampFichiers de l'utilisation de l'outil à partir d'une invite de commande.
L'intégration dans des IDE tiers ou l'utilisation dans des scripts CD/CI n'est pas illustrée dans ce document.

Bâtiment

Le package STM32CubeCLT contient les outils GNU pour la chaîne d'outils STM32 permettant de créer un programme pour un microcontrôleur STM32. Une fenêtre de console Windows® example fichier est représenté sur la figure 1.

1. Ouvrez une console dans le dossier du projet.
2. Exécutez la commande suivante pour compiler le projet : > make -j8 all -C .\Debug

Note: L'utilitaire make peut nécessiter une étape d'installation distincte.

Programmation de la carte

Le package STM32CubeCLT contient le STM32CubeProgrammer (STM32CubeProg), qui est utilisé pour programmer la version obtenue précédemment dans le microcontrôleur STM32 cible.

1. Assurez-vous que la connexion ST-LINK est détectée
2. Sélectionnez l'emplacement du dossier du projet dans la fenêtre de la console
3. Éventuellement, effacez tout le contenu de la mémoire flash (reportez-vous à la figure 2) : > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. Télécharger le programme file à l'adresse de mémoire flash 0x08000000 (voir Figure 3) : > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Débogage

En plus des outils GNU pour la chaîne d'outils STM32, le package STM32CubeCLT contient également le serveur ST-LINK GDB. Les deux sont nécessaires pour démarrer une session de débogage.

1. Démarrez le serveur ST-LINK GDB dans une autre fenêtre Windows® PowerShell® (voir Figure 4) : > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Utilisez les outils GNU pour la chaîne d'outils STM32 pour démarrer le client GDB dans la fenêtre PowerShell® :
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (utilisez le port indiqué dans la connexion ouverte du serveur GDB)
   La connexion est établie et les messages de session du serveur GDB s'affichent comme illustré à la Figure 5. Il est alors possible d'exécuter des commandes GDB dans la session de débogage, par exemple pour recharger un programme .elf à l'aide de GDB : > (gdb) load YOUR_PROGRAM.elf

Historique des révisions

Tableau 1. Historique des révisions du document

Date	Révision	Changements
16-févr.-23	1	Version initiale.

AVIS IMPORTANT – À LIRE ATTENTIVEMENT
STMicroelectronics NV et ses filiales (« ST ») se réservent le droit d'apporter des modifications, des corrections, des améliorations et des perfectionnements aux produits ST et/ou au présent document à tout moment et sans préavis. Les acheteurs doivent se procurer les dernières informations pertinentes sur les produits ST avant de passer commande. Les produits ST sont vendus conformément aux conditions générales de vente de ST en vigueur au moment de l'accusé de réception de la commande.
Les acheteurs sont seuls responsables du choix, de la sélection et de l'utilisation des produits ST et ST n'assume aucune responsabilité pour l'assistance à l'application ou la conception des produits des acheteurs.
Aucune licence, expresse ou implicite, sur aucun droit de propriété intellectuelle n'est accordée par ST ici.
La revente de produits ST avec des dispositions différentes des informations énoncées dans le présent document annulera toute garantie accordée par ST pour ce produit.
ST et le logo ST sont des marques déposées de ST. Pour plus d'informations sur les marques déposées de ST, consultez www.st.com/marques. Tous les autres noms de produits ou de services sont la propriété de leurs propriétaires respectifs.
Les informations contenues dans ce document remplacent et annulent les informations précédemment fournies dans toutes les versions antérieures de ce document.

UM3088 – Rév 1 – Février 2023
Pour plus d'informations, contactez votre bureau de vente STMicroelectronics local.
www.st.com
© 2023 STMicroelectronics – Tous droits réservés

Documents / Ressources

	Ensemble d'outils de ligne de commande ST STM32Cube [pdf] Manuel de l'utilisateur UM3088, ensemble d'outils de ligne de commande STM32Cube, STM32Cube, ensemble d'outils de ligne de commande, ensemble d'outils
	Ensemble d'outils de ligne de commande ST STM32Cube [pdf] Manuel du propriétaire RN0132, Ensemble d'outils de ligne de commande STM32Cube, STM32Cube, Ensemble d'outils de ligne de commande, Ensemble d'outils de ligne, Ensemble d'outils

Références

• Manuel d'utilisation