UM3088
STM32Cube-komentorivityökalusarjan pika-aloitusopas
Käyttöohje

Johdanto

Tämä asiakirja on lyhyt opas käyttäjille, jotta he voivat nopeasti aloittaa STM32CubeCLT:n, STMicroelectronics-komentorivityökalusarjan STM32 MCU:ille.
STM32CubeCLT tarjoaa kaikki STM32CubeIDE-ominaisuudet, jotka on pakattu kolmannen osapuolen IDE:iden komentokehotekäyttöön tai jatkuvaan integrointiin ja jatkuvaan kehittämiseen (CD/CI).

Virtaviivainen yksittäinen STM32CubeCLT-paketti sisältää:

• CLI (command-line interface) -versiot ST-työkaluista, kuten työkaluketju, anturiliitäntäapuohjelma ja flash-muistin ohjelmointiapuohjelma
• Ajantasainen järjestelmä view kuvaaja (SVD) files
• Kaikki muut IDE:n kannalta merkitykselliset metatiedot STM32CubeCLT sallivat:
• Ohjelman luominen STM32 MCU-laitteille käyttämällä parannettua GNU-työkaluketjua STM32:lle
• STM32 MCU:n sisäisten muistien (flash-muisti, RAM, OTP ja muut) ja ulkoisten muistien ohjelmointi
• Ohjelmoinnin sisällön tarkistaminen (tarkistussumma, varmentaminen ohjelmoinnin aikana ja sen jälkeen, vertailu file)
• STM32 MCU:n ohjelmoinnin automatisointi
• Sovellusten virheenkorjaus STM32 MCU -tuotteiden käyttöliittymän kautta, joka tarjoaa pääsyn MCU:n sisäisiin resursseihin käyttämällä perusvirheenkorjausominaisuuksia

Yleistä tietoa

STM32CubeCLT-komentorivityökalusarja STM32 MCU:ille tarjoaa työkalut Arm® Cortex® -M -prosessoriin perustuviin STM32-mikrokontrollereihin kohdistettujen sovellusten rakentamiseen, ohjelmointiin, suorittamiseen ja virheenkorjaukseen.
Huomautus:
Arm on Arm Limitedin (tai sen tytäryhtiöiden) rekisteröity tavaramerkki Yhdysvalloissa ja/tai muualla.

Viiteasiakirjat

• Komentorivityökalusarja STM32 MCU:ille (DB4839), STM32CubeCLT-tiedot
• STM32CubeCLT asennusopas (UM3089)
• STM32CubeCLT-julkaisutiedote (RN0132)

Kuvakaappaukset tässä asiakirjassa
Osioissa 2, 3 ja 4 annetut kuvakaappaukset ovat vain esimamptyökalun käytöstä komentokehotteessa.
Integrointia kolmannen osapuolen IDE:ihin tai käyttöä CD/CI-skripteissä ei kuvata tässä asiakirjassa.

Rakentaminen

STM32CubeCLT-paketti sisältää GNU-työkalut STM32-työkaluketjulle ohjelman rakentamiseksi STM32-mikrokontrollerille. Windows®-konsoli-ikkuna esimample on esitetty kuvassa 1.

1. Avaa konsoli projektikansiossa.
2. Suorita seuraava komento rakentaaksesi projektin: > make -j8 all -C .\Debug

Huomautus: Make-apuohjelma saattaa vaatia erillisen asennusvaiheen.

Lautaohjelmointi

STM32CubeCLT-paketti sisältää STM32CubeProgrammer-ohjelman (STM32CubeProg), jolla ohjelmoidaan aiemmin hankittu koonti kohde-STM32-mikrokontrolleriin.

1. Varmista, että ST-LINK-yhteys havaitaan
2. Valitse projektikansion sijainti konsoliikkunassa
3. Valinnaisesti tyhjennä kaikki flash-muistin sisältö (katso kuva 2): > STM32_Programmer_CLI.exe -c portti=SWD freq=4000 -e all
4. Lataa ohjelma file 0x08000000 flash-muistiosoitteeseen (katso kuva 3): > STM32_Programmer_CLI.exe -c portti=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

Virheenkorjaus

STM32-työkaluketjun GNU-työkalujen lisäksi STM32CubeCLT-paketti sisältää myös ST-LINK GDB -palvelimen. Molempia tarvitaan virheenkorjausistunnon aloittamiseen.

1. Käynnistä ST-LINK GDB -palvelin toisessa Windows® PowerShell® -ikkunassa (katso kuva 4): > ST-LINK_gdbserver.exe -d -v -t -cp C:\ST\STM32CubeCLT\STM32CubeProgrammer\bin
2. Käytä STM32-työkaluketjun GNU-työkaluja käynnistääksesi GDB-asiakkaan PowerShell®-ikkunassa:
   > arm-none-eabi-gdb.exe
   > (gdb) target remote localhost:port (käytä GDB-palvelimen avatussa yhteydessä ilmoitettua porttia)
   Yhteys muodostetaan ja GDB-palvelimen istunnon viestit näytetään kuvan 5 mukaisesti. Sitten on mahdollista suorittaa GDB-komentoja virheenkorjausistunnossa, esimerkiksi ladata .elf-ohjelma uudelleen GDB:n avulla: > (gdb) load YOUR_PROGRAM.elf

Versiohistoria

Taulukko 1. Asiakirjan versiohistoria

Päivämäärä	Tarkistus	Muutokset
16. helmikuuta 23	1	Alkuperäinen julkaisu.

TÄRKEÄ HUOMAUTUS – LUE HUOLELLISESTI
STMicroelectronics NV ja sen tytäryhtiöt ("ST") varaavat oikeuden tehdä muutoksia, korjauksia, parannuksia, muunnoksia ja parannuksia ST-tuotteisiin ja/tai tähän asiakirjaan milloin tahansa ilman erillistä ilmoitusta. Ostajien tulee saada viimeisimmät asiaankuuluvat tiedot ST-tuotteista ennen tilauksen tekemistä. ST-tuotteita myydään tilausvahvistushetkellä voimassa olevien ST:n myyntiehtojen mukaisesti.
Ostajat ovat yksin vastuussa ST-tuotteiden valinnasta, valinnasta ja käytöstä, eikä ST ota vastuuta sovellusavusta tai ostajien tuotteiden suunnittelusta.
ST ei myönnä tässä asiakirjassa mitään nimenomaista tai epäsuoraa lisenssiä millekään immateriaalioikeuksille.
ST-tuotteiden jälleenmyynti, jossa on poikkeavia ehtoja kuin tässä esitetyt tiedot, mitätöi kaikki ST:n kyseiselle tuotteelle myöntämät takuut.
ST ja ST-logo ovat ST:n tavaramerkkejä. Lisätietoja ST-tavaramerkeistä on kohdassa www.st.com/trademarks. Kaikki muut tuotteiden tai palveluiden nimet ovat omistajiensa omaisuutta.
Tämän asiakirjan tiedot korvaavat ja korvaavat tämän asiakirjan aiemmissa versioissa aiemmin annetut tiedot.

UM3088 – versio 1 – helmikuu 2023
Lisätietoja saat paikalliselta STMicroelectronics-myyntitoimistolta.
www.st.com
© 2023 STMicroelectronics – Kaikki oikeudet pidätetään

Asiakirjat / Resurssit

	ST STM32Cube Command Line Toolset [pdfKäyttöopas UM3088, STM32Cube Command Line Toolset, STM32Cube, Command Line Toolset, Toolset
	ST STM32Cube Command Line Toolset [pdfKäyttöopas RN0132, STM32Cube-komentorivityökalusarja, STM32Cube, komentorivityökalusarja, rivityökalusarja, työkalusarja

Viitteet

• Käyttöopas