STMicroelectronics UM3399 STM32Cube WiSE raadiokoodigeneraator

Toote kasutusjuhised

• Rakendus STM32CubeWiSE-RadioCodeGenerator nõuab vähemalt 2 Gbaiti muutmälu, USB-porte ja Adobe Acrobat Reader 6.0.
• Ekstraktige faili stm32wise-cgwin.zip sisu file ajutisse kataloogi.
• Käivitage STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ja järgige ekraanil kuvatavaid juhiseid.
• STM32CubeWiSE-RadioCodeGenerator SW pakett files on korraldatud kaustadesse, sealhulgas 'app' ja 'exampvähem’.
• Voograafiku loomiseks STM32CubeWiSE-RadioCodeGeneratoris tehke järgmist.
• Lisage SeqActions voograafikule tööriistariba või globaalse menüü abil.
• Ühendage SeqActions sisestuspunktiga ja üksteisega, joonistades tegevuse üleminekunooled.
• Liikuge voograafikul, lohistades toiminguid ja lisades vastavalt vajadusele tegevuste üleminekuid.

Sissejuhatus

• See dokument kirjeldab STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) SW paketti koos STM32WL3x MRSUBG järjestuskoodigeneraatoriga.
• STM32CubeWiSE-RadioCodeGenerator on arvutirakendus, mida kasutatakse voograafiku koostamiseks, mis määrab, milliseid transiiveri toiminguid millistel tingimustel teostada, kasutades MRSUBG sekventseri draiverit.
• STM32WL3x Sub-GHz raadio sisaldab seda sekvenaatorit, mis on olekumasinataoline mehhanism, mis võimaldab RF-edastusi iseseisvalt hallata, ilma et oleks vaja CPU sekkumist.
• Kui protsessori sekkumine on vajalik, saab määrata katkestused. Transiiveri toimingud saab korraldada voograafikus. Selles dokumendis nimetatakse üksikuid transiiveri toiminguid kui SeqActions.
• Kuid lähtekood ei ole voograafikute jaoks parim esitus, kuna see varjab nende loogilist ja ajalist struktuuri.
• STM32CubeWiSE-RadioCodeGenerator lahendab selle probleemi, pakkudes voograafikute koostamiseks graafilist meetodit ja eksportides seejärel loodud voograafikud C-lähtekoodina kasutajarakendustesse integreerimiseks.
• Voograafiku määratlus salvestatakse mikrokontrolleri RAM-i kujul:
  • ActionConfigurationi RAM-i tabelite komplekt, mis on omavahel seotud osutite abil. Need osutid määravad SeqActions, st toimingu tüübi (ntample, edastamine, vastuvõtt, katkestamine), samuti SeqAction-spetsiifilised raadioparameetrid ja tegevuse edastamise tingimused.
  • Unikaalne GlobalConfiguration RAM-i tabel. See määrab voograafi sisenemispunkti (esimene käivitatav SeqAction), samuti mõned lipu vaikeväärtused ja levinumad raadioparameetrid.
• Raadioparameetrid, mida saab iga SeqActioni jaoks eraldi konfigureerida, salvestatakse ühte dünaamilistesse registritesse, mille sisu on osa ActionConfiguration RAM-i tabelist. Raadioparameetrid, mis on fikseeritud kogu voograafi täitmise jooksul (kui neid ei muudeta CPU katkestuse ajal), salvestatakse staatilistesse registritesse, mille sisu on osa globaalsest konfiguratsiooni RAM-i tabelist.

Üldine teave

Litsentsi andmine
See dokument kirjeldab tarkvara, mis töötab STM32WL3x Arm® Cortex ® -M0+ põhises mikrokontrolleris.
Märkus. Arm on ettevõtte Arm Limited (või selle tütarettevõtete) registreeritud kaubamärk USA-s ja/või mujal.

Seotud dokumendid

Tabel 1. Dokumendiviited

Number	Viide	Pealkiri
[1]	0511 RM	STM32WL30xx/31xx/33xx Arm®-põhised subGHz MCU-d

Alustamine

• Selles jaotises kirjeldatakse kõiki süsteeminõudeid STM32CubeWiSE-RadioCodeGeneratori käitamiseks.
• See kirjeldab ka tarkvarapaketi installimise protseduuri.

Süsteeminõuded
Rakendusel STM32CubeWiSE-RadioCodeGenerator on järgmised miinimumnõuded.

• Intel®- või AMD®-protsessoriga arvuti, mis töötab operatsioonisüsteemiga Microsoft® Windows 10
• Vähemalt 2 Gbaiti RAM-i
• USB-pordid
• Adobe Acrobat Reader 6.0

STM32CubeWiSE-RadioCodeGenerator SW paketi seadistamine
Tehke järgmised sammud:

1. Ekstraktige faili stm32wise-cgwin.zip sisu file ajutisse kataloogi.
2. Ekstraktige ja käivitage STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ja järgige ekraanil kuvatavaid juhiseid.

STM32CubeWiSE-RadioCodeGenerator SW pakett files
STM32CubeWiSE-RadioCodeGenerator SW pakett files on korraldatud järgmistesse kaustadesse:

• rakendus: sisaldab STM32CubeWiSE-RadioCodeGenerator.exe
• examples: see kaust on korraldatud järgmistesse alamkaustadesse:
• kood: see kaust sisaldab voograafikuid ntample juba eksporditud C-koodina, valmis rakendusprojekti sisestamiseks
• voograafikud: see kaust salvestab mõned ntamples autonoomsete MRSUBG sekvenseri operatsioonide stsenaariumid

Väljalaskemärkmed ja litsents files asuvad juurkaustas.

STM32CubeWiSE-RadioCodeGenerator tarkvara kirjeldus

• Selles jaotises kirjeldatakse rakenduse STM32CubeWiSE-RadioCodeGenerator põhifunktsioone. Selle utiliidi käitamiseks klõpsake ikooni STM32CubeWiSE-RadioCodeGenerator.

Pärast STM32CubeWiSE-RadioCodeGeneratori käivitamist kuvatakse rakenduse peaaken. See koosneb:

• Globaalne menüü ja tööriistariba
• Voograafiku visuaalne pukseerimine
• SeqActioni seadistuste jaotis (nähtav ainult siis, kui SeqActioni parajasti redigeeritakse)

Voograafiku koostamine
Põhitõed
Voograafikud koostatakse kahes etapis:

1. Lisage voograafikule SeqActions. Seda saab teha kasutades tööriistaribal nuppu "Lisa toiming", globaalset menüüd (Redigeerimine → Lisa toiming) või kiirklahvi "Ctrl+A".
2. Ühendage SeqActions sisestuspunktiga ja üksteisega, joonistades tegevuse üleminekunooled.

Tingimused, mille korral need üleminekud toimuvad, määratletakse hiljem (vt jaotis 3.2.1: Juhtvoog).

Voograafikus navigeerimine, toimingute lohistamine
Lohistage hiirekursoriga voograafi ruudukujulist tausta (vasakklõps), viewvoolugraafiku porti saab reguleerida. Hiire kerimisratast saab kasutada sisse- ja väljasuumimiseks. Toimingu valimiseks klõpsake suvalises kohas toimingul (välja arvatud väljundpordid, kustutamisnupp ja redigeerimisnupp). Toiminguid saab voograafikus korraldada hiire vasaku nupuga lohistades.

Toimingute üleminekute lisamine

• Nagu on näidatud joonisel 2, on igal toimingul kaks väljundporti, mida nimetatakse NextAction1 (NA1) ja NextAction2 (NA2), mida saab ühendada SeqActionidega, mis käivitatakse pärast toimingu lõpetamist. Näiteksample, NextAction1 saab kasutada mõne toimingu sooritamiseks, kui praegune toiming oli edukas, ja NextAction2 saab käivitada ebaõnnestumise korral.
• Toimingu ülemineku loomiseks hõljutage hiirekursorit ühe väljundpordi kohal, vajutage hiire vasakut nuppu ja liigutage hiirekursorit, et lohistada üleminekunoolt. Liigutage hiirekursor mõne muu SeqActioni vasakul asuva sisendpordi kohale ja vabastage hiire vasak nupp, et ühendus muutuks püsivaks. Toimingu ülemineku eemaldamiseks korrake lihtsalt toiminguülemineku loomise samme, kuid vabastage hiire vasak nupp kuskil malelaua tausta kohal.
• Kui väljund (NextAction1, NextAction2) jäetakse ühendamata, siis järgmise toimingu käivitamisel sekventser lõpetab.
• Ühendage kindlasti ka "Entry Point" mõne SeqActioni sisendpordiga. See SeqAction on esimene, mis käivitatakse kohe, kui sekventseerija käivitatakse.

Toimingute muutmine ja kustutamine

• SeqActionsi saab redigeerida, klõpsates SeqActioni vasakus ülanurgas oleval pliiatsi nupul. Seda saab kustutada, klõpsates paremas ülanurgas punasel ristil (vt joonis 3). SeqActioni kustutamine eemaldab ka kõik sissetulevad ja väljaminevad toimingute üleminekud.

SeqActioni konfiguratsioon
SeqActionsi saab konfigureerida vahekaartidega konfiguratsiooniliidese kaudu, millele pääseb juurde voograafikus iga toimingu vasakus ülanurgas oleva pliiatsi nupu kaudu. See liides konfigureerib sisuliselt konkreetse toimingu jaoks tabeli ActionConfiguration RAM sisu, mis koosneb nii juhtimisvooga seotud konfiguratsioonisuvanditest kui ka dünaamilise registri sisust. Dünaamilise registri sisu saab konfigureerida käsitsi, kontrollides täielikult iga registriväärtust (vt jaotis 3.2.3: Raadio täpsem konfiguratsioon) või lihtsustatud liidese kaudu (vt jaotis 3.2.2: Raadio põhikonfiguratsioon). Lihtsustatud liidesest peaks piisama peaaegu kõikidel kasutusjuhtudel.

Voolu juhtimine
Juhtvoo vahekaart (vt joonis 4) sisaldab mõningaid põhikonfiguratsioonisuvandeid, nagu toimingu nimi ja toimingu ajalõpu intervall. Toimingu nime ei kasutata mitte ainult voograafikus kuvamiseks, vaid see kantakse üle ka loodud lähtekoodi.

• Juhtvoo vahekaart (vt joonis 4) sisaldab mõningaid põhikonfiguratsioonisuvandeid, nagu toimingu nimi ja toimingu ajalõpu intervall. Toimingu nime ei kasutata mitte ainult voograafikus kuvamiseks, vaid see kantakse üle ka loodud lähtekoodi.
• Kõige tähtsam on see, et juhtvoo vahekaart konfigureerib tingimused, millest sõltub üleminek NextAction1 / NextAction2-le, samuti üleminekuintervall ja lipud. Üleminekutingimust saab konfigureerida, klõpsates nupul “…”, mis kuvab joonisel 5 näidatud maski valimise dialoogi. Üleminekuintervall muutis RAM-i tabeli atribuuti NextAction1Interval / NextAction2Interval. Lisateavet selle intervalli tähenduse ja lippude SleepEn / ForceReload / ForceClear tähenduse kohta leiate STM32WL3x teatmejuhendist [1].
• Lisaks saab sellele vahekaardile lisada SeqActioni ploki lühikirjelduse. Seda kirjeldust kasutatakse ainult dokumenteerimise eesmärgil ja see kantakse üle loodud lähtekoodi lähtekoodi kommentaarina.

Raadio põhikonfiguratsioon

Raadio põhikonfiguratsiooni vahekaardi saab jagada kolmeks osaks:

1. Ülaosas olev jaotis, kus on konfigureeritud mis tahes toimingu kaks kõige olulisemat parameetrit: käivitatav käsk (TX, RX, NOP, SABORT ja nii edasi) ja vajaduse korral edastatava paketi pikkus.
2. Vasakpoolne jaotis, kus on konfigureeritud tegelikud raadioparameetrid, nagu kandesagedus, andmeedastuskiirus, modulatsiooni omadused, andmepuhvri läved ja taimerid.
3. Parempoolse osa, kus CPU katkestab, saab eraldi lubada. Iga märgistatud katkestuse jaoks genereeritakse katkestuste töötleja. Põhimõtteliselt konfigureerib see registri RFSEQ_IRQ_ENABLE sisu.

Erinevate raadioparameetrite tähenduste kohta vaadake STM32WL3x teatmejuhendit [1].

Täiustatud raadio konfiguratsioon

• Kui raadio põhikonfiguratsiooni vahekaardil (jaotis 3.2.2: raadio põhikonfiguratsioon) kuvatavad konfiguratsioonisuvandid on ebapiisavad, võimaldab täiustatud raadiokonfiguratsiooni vahekaart STM32WL3x määrata suvalise dünaamilise registri sisu. Täpsema konfiguratsiooni vahekaart on lubatud, märkides vahekaartidega konfiguratsiooniliidese paremas ülanurgas märkeruudu Täpsem konfiguratsioon.
• Nii põhi- kui ka täpsemaid konfiguratsioone korraga kasutada pole võimalik, kasutaja peab valima ühe või teise. Kuid loomulikult on võimalik genereeritud lähtekoodi hiljem ka käsitsi redigeerida ja lisada potentsiaalselt puuduvaid konfiguratsioonivalikuid.

Globaalne seadistustedialoog

• Dialoogiaknale „Globaalsed projekti sätted” pääseb juurde tööriistariba nupu „Globaalsed sätted” kaudu. Dialoog sisaldab nii staatilise registri sisu konfiguratsioonivalikuid kui ka täiendavaid projekti sätteid. Pange tähele, et selle dialoogi kaudu saab konfigureerida ainult väikest osa staatiliste registri konfiguratsioonisuvanditest. Neid valikuid pakutakse ainult rakenduste prototüüpide loomise kiirendamiseks STM32CubeWiSE-RadioCodeGeneratoriga.
• Tavaliselt eeldatakse, et staatilise registri sisu on seadistatud rakenduse käsitsi kirjutatud lähtekoodis.
• Muude projekti sätete tähendust selgitatakse dialoogis endas.
• Võib pakkuda ka täiendavat C-koodi, mis sisestatakse vahetult enne globaalse konfiguratsiooni RAM-i tabeli loomist staatilise registri sisust. Seda välja saab kasutada staatiliste registriväärtuste seadistamiseks, millele pole kaasasoleva staatilise registri konfiguratsioonimaski kaudu juurdepääsetav.

Koodi genereerimine
Voograafi saab tõlkida täielikuks projekti C lähtekoodiks, vajutades tööriistaribal nuppu Generate Code. Loodud projektikaust ei sisalda projekti files IAR, Keil® või GCC jaoks. Need files tuleb STMWL3x projekti käsitsi lisada.
See on loodud projekti kausta struktuur:

Projekti kaust

• inc
• SequencerFlowgraph.h: päis file SequencerFlowgraph.c jaoks, staatiline. Ärge muutke seda.
• stm32wl3x_hal_conf.h: STM32WL3x HAL-i konfiguratsioon file, staatiline.
• src
• SequencerFlowgraph.c: voograafiku definitsioon. See on oluline file mis kasutab sekventseri draiverit globaalse konfiguratsiooni ja toimingu konfiguratsiooni RAM-i tabelite määratlemiseks. Automaatselt genereeritud, ärge muutke.
• main.c: Projekti põhi file mis näitab, kuidas laadida ja rakendada voograafiku määratlust. Staatiline, muutke seda vastavalt vajadusele.
• Main.c või stm32wl3x_hal_conf.h muutmiseks valige projekti sätetes ülekirjutamise käitumine Keep. Nii kirjutatakse üle ainult SequencerFlowgraph.c.

Kuidas importida loodud koodi CubeMX example
STM32CubeWiSE-RadioCodeGeneratori poolt genereeritud projekti importimine CubeMX ex-sseample (MRSUBG_Skeleton), on vaja järgida järgmisi samme:

1. Avage kaust, mis sisaldab fileSTM32CubeWiSE-RadioCodeGenerator genereeritud s ja kopeerige kaustad "Inc" ja "Src".
2. Kleepige need kaks kausta kausta "MRSUBG_Skeleton", kirjutades need kaks juba olemasolevat üle.
3. Avage projekt "MRSUBG_Skeleton" ühes järgmistest IDE-dest:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Lisage projekti "MRSUBG_Skeleton" sisse "SequencerFlowghraph.c" file:
   • EWARM-projekti puhul tee lisamiseks file on järgmine: MRSUBG_Skeleton\Application\User
   • MDK-ARM projekti puhul tee lisamiseks file on järgmine: MRSUBG_Skeleton\Application/User
   • STM32CubeIDE projekti puhul tee lisamiseks file on sama:
     MRSUBG_Skeleton\Application\User
5. Lisage projekti MRSUBG_Skeleton sisse stm32wl3x_hal_uart.c ja stm32wl3x_hal_uart_ex.c files järgmisele teele: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Tee on kõigi IDE-de jaoks sama. Need kaks files asuvad jaotises Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. COM-i funktsioonide kasutamiseks stm32wl3x_nucleo_conf.h file, mis asub aadressil Firmware\Projects\NUCLEOWL33CC\Examples\MRSUBG\MRSUBG_Skeleton\Inc, tuleb muuta, seades USE_BSP_COM_FEATURE ja USE_COM_LOG väärtusele 1U:
7. Kopeerige järgmine kood faili "stm32wl3x_it.c", mis asub kaustas MRSUBG_Skeleton\Application\User.

Voograafik ntamples

• Neli endistampkoos lähtekoodiga on esitatud voograafikud. Need examplesid saab laadida STM32CubeWiSE-RadioCodeGeneratorisse, klõpsates tööriistaribal nuppu Laadi.

AutoACK_RX

• Auto-ACK-demo illustreerib, kuidas kaks STM32WL3x seadet saavad järjestikuse riistvara abil minimaalse CPU sekkumisega üksteisega automaatselt rääkida.
• See voograafik rakendab seadme A käitumist (Auto-Transmit-ACK). Seadmes A initsialiseeritakse sekventseerija vastuvõtuolekusse (WaitForMessage), kus see ootab sõnumi saabumist.
• Kui kehtiv sõnum saabub, lülitub sekveneerija automaatselt edastusolekusse (TransmitACK), kus vastusena saadetakse ACK-pakett ilma CPU sekkumiseta. Kui see on lõpetatud, lähtestatakse sekventseerija algsesse WaitForMessage olekusse.
• See voograafik rakendab sama käitumist nagu MRSUBG_SequencerAutoAck_Rx example ExampSTM32Cube WL3 tarkvarapaketi kaust les\MRSUBG. Kui ühes seadmes vilgub AutoACK_RX
  A ja AutoACK_TX vilguvad mõnel seadmel, B, need kaks seadet saadavad sõnumeid edasi-tagasi, nagu lauatennisemängus.

AutoACK_TX

• “Auto-ACK” demo illustreerib, kuidas kaks STM32WL3x seadet saavad sekventseri riistvara abil minimaalse CPU sekkumisega üksteisega automaatselt rääkida.
• See voograafik rakendab seadme B käitumist (Auto-Wait-for-ACK). Seadmes B initsialiseeritakse sekventseerija edastusolekusse (TransmitMessage), milles ta edastab sõnumi. Kui edastamine on lõppenud, läheb see automaatselt üle vastuvõtuolekusse, kus see ootab kinnitust seadmelt A (WaitForACK). Kui saabub kehtiv kinnitus, lähtestatakse sekveneerija esialgsesse TransmitMessage olekusse ja kogu protsess algab uuesti. Kui 4 sekundi jooksul ACK-i vastu ei võeta, käivitub ajalõpp ja sekvenser naaseb niikuinii olekusse TransmitMessage.
• See voograafik rakendab sama käitumist nagu "MRSUBG_SequencerAutoAck_Tx" example ExampSTM32Cube WL3 tarkvarapaketi kaust les\MRSUBG. Kui AutoACK_RX vilgub ühes seadmes, A ja AutoACK_TX mõnes teises seadmes, B, saadavad need kaks seadet sõnumeid edasi-tagasi, nagu pingpongimängus.

Kuula enne rääkimist (LBT)

• See eksample on võetud STM32WL3x viitejuhendist [1]. Selle ex kohta lisateabe saamiseks vaadake seda juhenditample.

Nuusutamisrežiim

• See eksample on võetud STM32WL3x viitejuhendist [1]. Selle ex kohta lisateabe saamiseks vaadake seda juhenditample.

Läbivaatamise ajalugu

Tabel 2. Dokumendi redaktsioonide ajalugu

Kuupäev	Versioon	Muudatused
21. november 2024	1	Esialgne vabastamine.
10. veebruar 2025	2	Seadme nime värskendati ulatusele STM32WL3x.

TÄHTIS MÄRKUS – LUGEGE HOOLIKAS

• STMicroelectronics NV ja selle tütarettevõtted („ST”) jätavad endale õiguse teha ST-toodetes ja/või selles dokumendis igal ajal ilma ette teatamata muudatusi, parandusi, täiendusi, modifikatsioone ja täiendusi. Ostjad peaksid enne tellimuste esitamist hankima uusima asjakohase teabe ST-toodete kohta. ST tooteid müüakse vastavalt ST müügitingimustele, mis kehtisid tellimuse kinnitamise ajal.
• Ostjad vastutavad ainuisikuliselt ST-toodete valiku, valiku ja kasutamise eest ning ST ei vastuta rakendusabi ega ostjate toodete disaini eest.
• ST ei anna siinkohal mingit otsest ega kaudset litsentsi ühelegi intellektuaalomandi õigusele.
• ST-toodete edasimüük, mille sätted erinevad siin esitatud teabest, tühistab ST-i antud tootele antud garantii.
• ST ja ST logo on ST kaubamärgid. ST-kaubamärkide kohta lisateabe saamiseks vaadake www.st.com/trademarks. Kõik muud toote- või teenusenimed kuuluvad nende vastavatele omanikele.
• Selles dokumendis sisalduv teave asendab ja asendab selle dokumendi varasemates versioonides esitatud teabe.
• © 2025 STMicroelectronics – kõik õigused kaitstud

KKK

• K: Millised on minimaalsed süsteeminõuded STM32CubeWiSE-RadioCodeGeneratori jaoks?
  • A: Minimaalsed süsteeminõuded hõlmavad vähemalt 2 Gbaiti RAM-i, USB-porte ja Adobe Acrobat Reader 6.0.
• K: Kuidas saan seadistada tarkvarapaketti STM32CubeWiSE-RadioCodeGenerator?
  • A: Tarkvarapaketi seadistamiseks eraldage kaasasoleva ZIP-faili sisu file ajutisse kataloogi ja käivitage käivitatav fail file järgides ekraanil kuvatavaid juhiseid.

Dokumendid / Ressursid

STMicroelectronics UM3399 STM32Cube WiSE raadiokoodigeneraator [pdfKasutusjuhend UM3399, UM3399 STM32 Cube WiSE raadiokoodigeneraator, UM3399, STM32, Cube WiSE raadiokoodigeneraator, raadiokoodigeneraator, koodigeneraator, generaator

Viited

• Kasutusjuhend