Generator radijskih kod STMicroelectronics UM3399 STM32Cube WiSE

Navodila za uporabo izdelka

• Aplikacija STM32CubeWiSE-RadioCodeGenerator zahteva vsaj 2 Gbajta RAM-a, vrata USB in bralnik Adobe Acrobat 6.0.
• Ekstrahirajte vsebino datoteke stm32wise-cgwin.zip file v začasni imenik.
• Zaženite STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file in sledite navodilom na zaslonu.
• Paket SW STM32CubeWiSE-RadioCodeGenerator fileso organizirani v mape, vključno z 'app' in 'examples'.
• Če želite zgraditi diagram poteka v STM32CubeWiSE-RadioCodeGenerator:
• Dodajte SeqActions diagramu poteka z orodno vrstico ali globalnim menijem.
• Povežite SeqActions z vstopno točko in drug z drugim tako, da narišete puščice za prehod dejanj.
• Krmarite po grafu poteka tako, da povlečete dejanja in po potrebi dodate prehode dejanj.

Uvod

• Ta dokument opisuje paket SW STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) z generatorjem kode sekvencerja STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator je aplikacija za osebni računalnik, ki se uporablja za izdelavo diagrama toka, ki definira, katera dejanja oddajnika-sprejemnika je treba izvesti pod katerim pogojem, z uporabo gonilnika sekvencerja MRSUBG.
• Sub-GHz radio STM32WL3x vsebuje ta sekvencer, ki je mehanizem, podoben stanju stroja, ki omogoča avtonomno upravljanje prenosov RF, brez kakršnega koli posredovanja CPE.
• Če je potrebna intervencija procesorja, je mogoče definirati prekinitve. Dejanja oddajnika je mogoče razporediti v graf poteka. V tem dokumentu se posamezna dejanja oddajnika-sprejemnika imenujejo SeqActions.
• Vendar izvorna koda ni najboljša predstavitev diagramov toka, saj prikrije njihovo logično in časovno strukturo.
• STM32CubeWiSE-RadioCodeGenerator obravnava to težavo z zagotavljanjem grafične metode za izdelavo diagramov poteka in nato izvozom ustvarjenih diagramov poteka kot izvorno kodo C za integracijo v uporabniške aplikacije.
• Definicija diagrama poteka je shranjena v RAM mikrokrmilnika v obliki:
  • Niz tabel ActionConfiguration RAM, ki so med seboj povezane s kazalci. Ti kazalci definirajo SeqActions, to je vrsto dejanja (nprample, prenos, sprejem, prekinitev), kot tudi radijske parametre, specifične za SeqAction, in pogoje za prenose dejanj.
  • Edinstvena tabela RAM GlobalConfiguration. To definira vstopno točko diagrama poteka (prvo izvedeno SeqAction), pa tudi nekatere privzete vrednosti zastavic in skupne radijske parametre.
• Radijski parametri, ki jih je mogoče konfigurirati posebej za vsako SeqAction, so shranjeni v enem od dinamičnih registrov, katerih vsebina je del tabele RAM ActionConfiguration. Radijski parametri, ki so določeni med celotnim izvajanjem diagrama toka (razen če so spremenjeni med prekinitvijo procesorja), so shranjeni v statičnih registrih, katerih vsebina je del tabele globalne konfiguracije RAM.

Splošne informacije

Licenciranje
Ta dokument opisuje programsko opremo, ki deluje na mikrokrmilniku STM32WL3x Arm® Cortex ® -M0+.
Opomba: Arm je registrirana blagovna znamka Arm Limited (ali njenih podružnic) v ZDA in/ali drugje.

Sorodni dokumenti

Tabela 1. Reference dokumentov

številka	Referenca	Naslov
[1]	RM0511	Sub-GHz mikrokontrolerji STM32WL30xx/31xx/33xx Arm®

Začetek

• V tem razdelku so opisane vse sistemske zahteve za zagon STM32CubeWiSE-RadioCodeGenerator.
• Opisuje tudi postopek namestitve programskega paketa.

Sistemske zahteve
Aplikacija STM32CubeWiSE-RadioCodeGenerator ima naslednje minimalne zahteve:

• Računalnik s procesorjem Intel® ali AMD® z operacijskim sistemom Microsoft® Windows 10
• Vsaj 2 Gbajta RAM-a
• vrata USB
• Adobe Acrobat Reader 6.0

Nastavitev paketa programske opreme STM32CubeWiSE-RadioCodeGenerator
Izvedite naslednje korake:

1. Ekstrahirajte vsebino datoteke stm32wise-cgwin.zip file v začasni imenik.
2. Ekstrahirajte in zaženite STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file in sledite navodilom na zaslonu.

Paket programske opreme STM32CubeWiSE-RadioCodeGenerator files
Paket SW STM32CubeWiSE-RadioCodeGenerator fileso organizirani v naslednje mape:

• aplikacija: vsebuje STM32CubeWiSE-RadioCodeGenerator.exe
• examples: ta mapa je organizirana v naslednje podmape:
• koda: ta mapa vsebuje diagrame toka nprampže izvožena kot koda C, pripravljena za vnos v projekt aplikacije
• flowgraphs: ta mapa shranjuje nekaj examples scenarijev avtonomnih operacij sekvencerja MRSUBG

Opombe ob izdaji in licenca files se nahajajo v korenski mapi.

Opis programske opreme STM32CubeWiSE-RadioCodeGenerator

• V tem razdelku so opisane glavne funkcije aplikacije STM32CubeWiSE-RadioCodeGenerator. Za zagon tega pripomočka kliknite ikono STM32CubeWiSE-RadioCodeGenerator.

Po zagonu STM32CubeWiSE-RadioCodeGenerator se prikaže glavno okno aplikacije. Sestavljen je iz:

• Globalni meni in orodna vrstica
• Vizualna predstavitev diagrama toka s funkcijo povleci in spusti
• Konfiguracijski razdelek SeqAction (viden le, če se SeqAction trenutno ureja)

Izdelava diagrama toka
Osnove
Grafi poteka so zgrajeni v dveh korakih:

1. Grafu poteka dodajte SeqActions. To lahko storite z gumbom »Dodaj dejanje« v orodni vrstici, z uporabo globalnega menija (Uredi → Dodaj dejanje) ali z bližnjico »Ctrl+A«.
2. Povežite SeqActions z vstopno točko in drug z drugim tako, da narišete puščice za prehod dejanj.

Pogoji, pod katerimi pride do teh prehodov, so opredeljeni pozneje (glejte razdelek 3.2.1: Kontrolni tok).

Krmarjenje po diagramu poteka, dejanja vlečenja
Če z miškinim kazalcem (levi klik) povlečete ozadje šahovnice diagrama toka, se viewvrata na diagramu toka je mogoče prilagoditi. Kolešček miške lahko uporabite za povečavo in pomanjšanje. Kliknite kjer koli na dejanje (razen na izhodna vrata, gumb za brisanje in gumb za urejanje), da izberete dejanje. Dejanja lahko uredite v diagramu toka tako, da jih povlečete z levim gumbom miške.

Dodajanje prehodov dejanj

• Kot je prikazano na sliki 2, ima vsako dejanje dve »izhodni vrati«, imenovani NextAction1 (NA1) in NextAction2 (NA2), ki ju je mogoče povezati s SeqActions, ki se izvedejo, ko je dejanje končano. Na primerample, bi lahko NextAction1 uporabili za izvedbo nekega dejanja, če je bilo trenutno dejanje uspešno, NextAction2 pa bi lahko sprožili v primeru neuspeha.
• Če želite ustvariti akcijski prehod, premaknite kazalec miške nad eno od izhodnih vrat, pritisnite levi gumb miške in premaknite kazalec miške, da povlečete puščico prehoda. Premaknite kazalec miške nad vhodna vrata na levi strani katerega koli drugega dejanja SeqAction in spustite levi gumb miške, da bo povezava trajna. Če želite odstraniti prehod dejanja, samo ponovite korake za ustvarjanje prehoda dejanj, vendar spustite levi gumb miške nekje nad ozadjem šahovnice.
• Če izhod (NextAction1, NextAction2) ostane nepovezan, se sekvencer prekine, če se sproži to naslednje dejanje.
• Prepričajte se tudi, da ste »Entry Point« povezali z nekaterimi vhodnimi vrati SeqAction. To SeqAction je prvo, ki se izvede takoj, ko se sproži sekvencer.

Urejanje in brisanje dejanj

• SeqAction lahko urejate s klikom na gumb svinčnika v zgornjem levem kotu SeqAction. Izbrišemo ga s klikom na rdeči križ desno zgoraj (glej sliko 3). Z brisanjem SeqAction odstranite tudi vse dohodne in odhodne prehode dejanj.

Konfiguracija SeqAction
SeqActions je mogoče konfigurirati prek konfiguracijskega vmesnika z zavihki, ki je dostopen prek gumba svinčnika v zgornjem levem kotu vsakega dejanja v diagramu poteka. Ta vmesnik v bistvu konfigurira vsebino tabele RAM ActionConfiguration za določeno dejanje, sestavljeno tako iz konfiguracijskih možnosti, povezanih s krmilnim tokom, kot tudi dinamične vsebine registra. Vsebino dinamičnega registra je mogoče konfigurirati ročno s popolnim nadzorom nad vsako vrednostjo registra (glejte razdelek 3.2.3: Napredna konfiguracija radia) ali prek poenostavljenega vmesnika (glejte razdelek 3.2.2: Osnovna konfiguracija radia). Poenostavljen vmesnik bi moral zadostovati za skoraj vse primere uporabe.

Krmilni pretok
Zavihek toka nadzora (glejte sliko 4) vsebuje nekaj osnovnih konfiguracijskih možnosti, kot sta ime dejanja in interval časovne omejitve dejanja. Ime dejanja se ne uporablja le za prikaz v diagramu poteka, ampak se prenese tudi v ustvarjeno izvorno kodo.

• Zavihek toka nadzora (glejte sliko 4) vsebuje nekaj osnovnih konfiguracijskih možnosti, kot sta ime dejanja in interval časovne omejitve dejanja. Ime dejanja se ne uporablja samo za prikaz v diagramu toka, temveč se prenese tudi v ustvarjeno izvorno kodo.
• Najpomembneje je, da zavihek toka nadzora konfigurira pogoj, od katerega je odvisen prehod na NextAction1 / NextAction2, ter interval prehoda in zastavice. Pogoj prehoda je mogoče konfigurirati s klikom na gumb z oznako »…«, zaradi česar se prikaže pogovorno okno za izbiro maske, prikazano na sliki 5. Interval prehoda je spremenil lastnost NextAction1Interval / NextAction2Interval tabele RAM. Glejte referenčni priročnik STM32WL3x [1] za več informacij o pomenu tega intervala in pomenu zastavic SleepEn / ForceReload / ForceClear.
• Poleg tega lahko na tem zavihku dodate kratek opis bloka SeqAction. Ta opis se uporablja samo za namene dokumentacije in se prenese v ustvarjeno izvorno kodo kot komentar izvorne kode.

Osnovna konfiguracija radia

Zavihek osnovne radijske konfiguracije lahko razdelimo na tri dele:

1. Razdelek na vrhu, kjer sta konfigurirana dva najpomembnejša parametra katerega koli dejanja: ukaz za izvedbo (TX, RX, NOP, SABORT itd.) in, če je primerno, dolžina paketa za prenos.
2. Razdelek na levi, kjer so konfigurirani dejanski radijski parametri, kot so: nosilna frekvenca, hitrost prenosa podatkov, modulacijske lastnosti, pragovi medpomnilnika podatkov in časovniki.
3. Oddelek na desni, kjer je mogoče individualno omogočiti prekinitve procesorja. Za vsako od označenih prekinitev se generira upravljalnik prekinitev. To v bistvu konfigurira vsebino registra RFSEQ_IRQ_ENABLE.

Za pomen različnih radijskih parametrov glejte referenčni priročnik STM32WL3x [1].

Napredna konfiguracija radia

• Če konfiguracijske možnosti, izpostavljene prek zavihka osnovne radijske konfiguracije (razdelek 3.2.2: Osnovna radijska konfiguracija), ne zadoščajo, napredni zavihek radijske konfiguracije STM32WL3x omogoča nastavitev poljubne dinamične vsebine registra. Zavihek napredne konfiguracije omogočite tako, da označite potrditveno polje Napredna konfiguracija v zgornjem desnem kotu konfiguracijskega vmesnika z zavihki.
• Ni mogoče hkrati uporabljati osnovnih in naprednih konfiguracij, uporabnik mora izbrati eno ali drugo. Vendar pa je seveda mogoče tudi ročno naknadno urediti ustvarjeno izvorno kodo in dodati potencialno manjkajoče konfiguracijske možnosti.

Globalno konfiguracijsko pogovorno okno

• Do pogovornega okna »Globalne nastavitve projekta« lahko dostopate prek gumba v orodni vrstici »Globalne nastavitve«. Pogovorno okno vsebuje tako konfiguracijske možnosti za vsebino statičnega registra kot tudi dodatne nastavitve projekta. Upoštevajte, da je v tem pogovornem oknu mogoče konfigurirati le majhen del možnosti konfiguracije statičnega registra. Te možnosti so na voljo samo za pospešitev aplikacij za izdelavo prototipov s STM32CubeWiSE-RadioCodeGenerator.
• Običajno se pričakuje, da je vsebina statičnega registra nastavljena v ročno napisani izvorni kodi aplikacije.
• Pomen drugih nastavitev projekta je razložen v samem pogovornem oknu.
• Na voljo je lahko tudi dodatna koda C, ki je vstavljena tik pred ustvarjanjem tabele RAM globalne konfiguracije iz vsebine statičnega registra. To polje se lahko uporablja za nastavitev vrednosti statičnega registra, ki so nedostopne prek ponujene konfiguracijske maske statičnega registra.

Generiranje kode
Diagram poteka lahko prevedete v celotno izvorno kodo projekta C s pritiskom na gumb Generate Code v orodni vrstici. Ustvarjena projektna mapa ne vsebuje projekta files za IAR, Keil® ali GCC. te files je treba dodati ročno v projekt STMWL3x.
To je ustvarjena struktura mape projekta:

Mapa projekta

• inc
• SequencerFlowgraph.h: glava file za SequencerFlowgraph.c, statično. Ne urejajte tega.
• stm32wl3x_hal_conf.h: Konfiguracija HAL STM32WL3x file, statično.
• src
• SequencerFlowgraph.c: definicija diagrama toka. To je pomembno file ki uporablja gonilnik sekvencerja za definiranje tabel RAM globalne konfiguracije in konfiguracije dejanj. Samodejno ustvarjeno, ne urejajte.
• main.c: glavni projekt file ki prikazuje, kako naložiti in uporabiti definicijo grafa toka. Statično, po potrebi spremenite to.
• Če želite urediti main.c ali stm32wl3x_hal_conf.h, izberite vedenje prepisovanja Ohrani v nastavitvah projekta. Na ta način se prepiše samo SequencerFlowgraph.c.

Kako uvoziti ustvarjeno kodo v CubeMX example
Za uvoz projekta, ki ga ustvari STM32CubeWiSE-RadioCodeGenerator, v CubeMX example (MRSUBG_Skeleton), morate slediti naslednjim korakom:

1. Odprite mapo z filegenerira STM32CubeWiSE-RadioCodeGenerator in kopira mape »Inc« in »Src«.
2. Prilepite dve mapi v mapo »MRSUBG_Skeleton« in prepišite obe, ki sta že prisotni.
3. Odprite projekt »MRSUBG_Skeleton« v enem od naslednjih IDE-jev:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Znotraj projekta »MRSUBG_Skeleton« dodajte »SequencerFlowghraph.c« file:
   • Za projekt EWARM je pot za dodajanje file je naslednje: MRSUBG_Skeleton\Application\User
   • Za projekt MDK-ARM je pot za dodajanje file je naslednje: MRSUBG_Skeleton\Application/User
   • Za projekt STM32CubeIDE je pot za dodajanje file je enako:
     MRSUBG_Skeleton\Application\User
5. Znotraj projekta MRSUBG_Skeleton dodajte stm32wl3x_hal_uart.c in stm32wl3x_hal_uart_ex.c files na naslednjo pot: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Pot je enaka za vse IDE. Dva files se nahajajo na Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Če želite uporabljati funkcije COM, stm32wl3x_nucleo_conf.h file, ki se nahaja na Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, je treba spremeniti nastavitev USE_BSP_COM_FEATURE in USE_COM_LOG na 1U:
7. Kopirajte naslednjo kodo v »stm32wl3x_it.c«, ki se nahaja v MRSUBG_Skeleton\Application\User.

Flowgraph examples

• Štirje bivšiampdiagrami poteka so na voljo poleg izvorne kode. Ti bivšiampdatoteke lahko naložite v STM32CubeWiSE-RadioCodeGenerator s klikom na gumb »Naloži« v orodni vrstici.

AutoACK_RX

• Predstavitev Auto-ACK ponazarja, kako se lahko dve napravi STM32WL3x samodejno pogovarjata druga z drugo z minimalnim posredovanjem procesorja s pomočjo strojne opreme sekvencerja.
• Ta diagram poteka izvaja vedenje (Auto-Transmit-ACK) naprave A. V napravi A je sekvencer inicializiran v sprejemnem stanju (WaitForMessage), v katerem čaka na sporočilo.
• Ko prispe veljavno sporočilo, sekvencer samodejno preide v stanje prenosa (TransmitACK), v katerem je kot odgovor poslan paket ACK, brez posredovanja CPU. Ko je to končano, se sekvencer ponastavi v začetno stanje WaitForMessage.
• Ta diagram poteka izvaja enako vedenje kot MRSUBG_SequencerAutoAck_Rx example iz Exampmapa les\MRSUBG programskega paketa STM32Cube WL3. Če je AutoACK_RX utripan na eni napravi
  A, in AutoACK_TX utripa na neki napravi, B, obe napravi pošiljata sporočila naprej in nazaj, kot pri igri namizni tenis.

AutoACK_TX

• Predstavitev »Auto-ACK« ponazarja, kako se lahko dve napravi STM32WL3x samodejno pogovarjata druga z drugo z minimalnim posegom CPE s pomočjo strojne opreme sekvencerja.
• Ta diagram poteka izvaja vedenje (»Auto-Wait-for-ACK«) naprave B. V napravi B je sekvencer inicializiran v oddajnem stanju (TransmitMessage), v katerem oddaja sporočilo. Ko je prenos končan, samodejno preide v sprejemno stanje, kjer čaka na potrditev naprave A (WaitForACK). Ko prispe veljavna potrditev, se sekvencer ponastavi v začetno stanje TransmitMessage in celoten postopek se začne znova. Če v 4 sekundah ni prejet noben ACK, se sproži časovna omejitev in sekvencer se vseeno vrne v stanje TransmitMessage.
• Ta diagram poteka izvaja enako vedenje kot »MRSUBG_SequencerAutoAck_Tx« example iz Exampmapa les\MRSUBG programskega paketa STM32Cube WL3. Če je AutoACK_RX utripan na eni napravi, A, in AutoACK_TX utripa na neki drugi napravi, B, obe napravi pošiljata sporočila naprej in nazaj, kot pri igri namizni tenis.

Poslušaj, preden govoriš (LBT)

• Ta bivšiampdatoteka je vzeta iz referenčnega priročnika STM32WL3x [1]. Glejte ta priročnik za nadaljnje podrobnosti o tem primeruample.

Način vohanja

• Ta bivšiampdatoteka je vzeta iz referenčnega priročnika STM32WL3x [1]. Glejte ta priročnik za nadaljnje podrobnosti o tem primeruample.

Zgodovina revizij

Tabela 2. Zgodovina revizij dokumenta

Datum	Različica	Spremembe
21-2024	1	Začetna izdaja.
10-2025.feb	2	Posodobljeno ime naprave za obseg STM32WL3x.

POMEMBNO OBVESTILO – POZORNO PREBERITE

• STMicroelectronics NV in njegove hčerinske družbe (»ST«) si pridržujejo pravico do sprememb, popravkov, izboljšav, modifikacij in izboljšav izdelkov ST in/ali tega dokumenta kadar koli brez predhodnega obvestila. Kupci morajo pred oddajo naročil pridobiti najnovejše ustrezne informacije o izdelkih ST. Izdelki ST se prodajajo v skladu s prodajnimi pogoji ST, ki veljajo v času potrditve naročila.
• Kupci so izključno odgovorni za izbiro, izbiro in uporabo izdelkov ST in ST ne prevzema nobene odgovornosti za pomoč pri uporabi ali oblikovanje izdelkov kupcev.
• ST v tem dokumentu ne podeljuje nobene licence, izrecne ali implicitne, za katero koli pravico do intelektualne lastnine.
• Nadaljnja prodaja izdelkov ST z določbami, ki se razlikujejo od informacij, navedenih v tem dokumentu, razveljavi vsako garancijo, ki jo ST odobri za tak izdelek.
• ST in logotip ST sta blagovni znamki ST. Za dodatne informacije o blagovnih znamkah ST glejte www.st.com/trademarks. Vsa druga imena izdelkov ali storitev so last njihovih lastnikov.
• Informacije v tem dokumentu prevladajo in nadomeščajo informacije, ki so bile predhodno navedene v kateri koli prejšnji različici tega dokumenta.
• © 2025 STMicroelectronics – Vse pravice pridržane

pogosta vprašanja

• V: Kakšne so minimalne sistemske zahteve za STM32CubeWiSE-RadioCodeGenerator?
  • A: Minimalne sistemske zahteve vključujejo vsaj 2 Gbajta RAM-a, vrata USB in bralnik Adobe Acrobat 6.0.
• V: Kako lahko nastavim programski paket STM32CubeWiSE-RadioCodeGenerator?
  • A: Če želite nastaviti programski paket, ekstrahirajte vsebino priloženega zip file v začasni imenik in zaženite izvršljivo datoteko file po navodilih na zaslonu.

Dokumenti / Viri

Generator radijskih kod STMicroelectronics UM3399 STM32Cube WiSE [pdfUporabniški priročnik UM3399, UM3399 STM32 Generator radijskih kod Cube WiSE, UM3399, STM32, Generator radijskih kod Cube WiSE, Generator radijskih kod, Generator kod, Generator

Reference

• Uporabniški priročnik