STMicroelectronics UM3399 STM32Cube WiSE Radio Code Generator

Upute za upotrebu proizvoda

• Aplikacija STM32CubeWiSE-RadioCodeGenerator zahtijeva najmanje 2 GB RAM-a, USB portove i Adobe Acrobat Reader 6.0.
• Izvucite sadržaj stm32wise-cgwin.zip file u privremeni direktorij.
• Pokrenite STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file i pratite uputstva na ekranu.
• STM32CubeWiSE-RadioCodeGenerator SW paket filesu organizirani u mape, uključujući 'app' i 'ex'amples'.
• Da biste napravili grafikon toka u STM32CubeWiSE-RadioCodeGenerator:
• Dodajte SeqActions u dijagram toka pomoću alatne trake ili globalnog menija.
• Povežite SeqActions sa ulaznom tačkom i međusobno crtanjem strelica za prelaz akcija.
• Navigirajte grafom toka prevlačenjem akcija i dodavanjem prelaza akcija po potrebi.

Uvod

• Ovaj dokument opisuje softverski paket STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) sa generatorom koda sekvencera STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator je PC aplikacija koja se koristi za izgradnju grafa toka koji definira koje radnje primopredajnika treba izvršiti pod kojim uvjetima, koristeći MRSUBG sekvencer drajver.
• STM32WL3x Sub-GHz radio sadrži ovaj sekvencer, mehanizam sličan mašini stanja koji omogućava autonomno upravljanje RF transferima, bez potrebe za intervencijom CPU-a.
• Ako je potrebna intervencija CPU-a, mogu se definirati prekidi. Akcije primopredajnika mogu se organizirati u graf toka. U ovom dokumentu, pojedinačne akcije primopredajnika nazivaju se SeqActions.
• Međutim, izvorni kod nije najbolja reprezentacija za grafove toka, jer prikriva njihovu logičku i vremensku strukturu.
• STM32CubeWiSE-RadioCodeGenerator rješava ovaj problem pružanjem grafičke metode za izgradnju grafova toka, a zatim izvozom generiranih grafova toka kao C izvornog koda za integraciju u korisničke aplikacije.
• Definicija grafa toka se pohranjuje u RAM memoriji mikrokontrolera u obliku:
  • Skup RAM tabela ActionConfiguration, povezanih jedna s drugom pomoću pokazivača. Ovi pokazivači definiraju SeqActions, odnosno tip akcije (na primjerample, prijenos, prijem, prekid), kao i radio parametre i uslove specifične za SeqAction za prijenose akcija.
  • Jedinstvena tabela GlobalConfiguration RAM-a. Ona definira ulaznu tačku grafa toka (prva SeqAction koja se izvršava), kao i neke zadane vrijednosti zastavica i uobičajene radio parametre.
• Radio parametri, koji se mogu konfigurisati pojedinačno za svaku SeqAction, pohranjeni su u jednom od dinamičkih registara, čiji je sadržaj dio ActionConfiguration RAM tabele. Radio parametri koji su fiksni tokom cijelog izvršavanja grafa toka (osim ako se ne modificiraju tokom prekida CPU-a), pohranjeni su u statičkim registrima, čiji je sadržaj dio globalne konfiguracijske RAM tabele.

Opće informacije

Licenciranje
Ovaj dokument opisuje softver koji radi na mikrokontroleru baziranom na STM32WL3x Arm® Cortex® -M0+.
Napomena: Arm je registrirani zaštitni znak kompanije Arm Limited (ili njenih podružnica) u SAD -u i/ili drugdje.

Povezani dokumenti

Tabela 1. Reference dokumenata

Broj	Referenca	Naslov
[1]	RM0511	STM32WL30xx/31xx/33xx MCU bazirani na Arm® sub-GHz

Početak

• Ovaj odjeljak opisuje sve sistemske zahtjeve za pokretanje STM32CubeWiSE-RadioCodeGeneratora.
• Također detaljno opisuje postupak instalacije softverskog paketa.

Sistemski zahtjevi
Aplikacija STM32CubeWiSE-RadioCodeGenerator ima sljedeće minimalne zahtjeve:

• Računar sa Intel® ili AMD® procesorom pod operativnim sistemom Microsoft® Windows 10
• Najmanje 2 Gbajta RAM-a
• USB portovi
• Adobe Acrobat reader 6.0

STM32CubeWiSE-RadioCodeGenerator SW podešavanje paketa
Izvršite sljedeće korake:

1. Izvucite sadržaj stm32wise-cgwin.zip file u privremeni direktorij.
2. Raspakujte i pokrenite datoteku STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file i pratite uputstva na ekranu.

STM32CubeWiSE-RadioCodeGenerator SW paket files
STM32CubeWiSE-RadioCodeGenerator SW paket files su organizirani u sljedeće foldere:

• aplikacija: sadrži STM32CubeWiSE-RadioCodeGenerator.exe
• examples: ova fascikla je organizovana u sledeće podfoldere:
• kod: ova mapa sadrži flowgraphs exampje već izvezen kao C kod, spreman za ubacivanje u projekt aplikacije
• dijagrami toka: ova mapa pohranjuje neke bivšeampmanje scenarija autonomnih operacija sekvencera MRSUBG

Napomene o izdanju i licenca files se nalaze u root folderu.

Opis softvera STM32CubeWiSE-RadioCodeGenerator

• Ovaj odjeljak opisuje glavne funkcije aplikacije STM32CubeWiSE-RadioCodeGenerator. Da biste pokrenuli ovaj uslužni program, kliknite na ikonu STM32CubeWiSE-RadioCodeGenerator.

Nakon pokretanja STM32CubeWiSE-RadioCodeGenerator, pojavljuje se glavni prozor aplikacije. Sastoji se od:

• Globalni meni i traka sa alatkama
• Vizuelni drag-and-drop prikaz dijagrama toka
• Odjeljak za konfiguraciju SeqAction (vidljiv samo ako se SeqAction trenutno uređuje)

Izgradnja grafikona toka
Osnove
Grafovi toka se grade u dva koraka:

1. Dodajte SeqActions u dijagram toka. To se može uraditi pomoću dugmeta „Dodaj akciju“ u traci sa alatkama, pomoću globalnog menija (Uredi → Dodaj akciju) ili pomoću prečice „Ctrl+A“.
2. Povežite SeqActions sa ulaznom tačkom i međusobno crtanjem strelica za prelaz akcija.

Uslovi pod kojima se ovi prelazi dešavaju definisani su kasnije (videti Odeljak 3.2.1: Tok upravljanja).

Navigacija kroz dijagram toka, prevlačenje akcija
Povlačenjem pozadine dijagrama toka u obliku šahovnice pokazivačem miša (lijevi klik), viewport na grafikonu toka može se podesiti. Točak miša se može koristiti za uvećanje i umanjivanje. Klikom bilo gdje na radnju (osim izlaznih portova, dugmeta za brisanje i dugmeta za uređivanje) da biste izabrali radnju. Radnje se mogu rasporediti u dijagramu toka tako što ćete ih prevući lijevom tipkom miša.

Dodavanje prijelaza radnji

• Kao što je prikazano na Slici 2, svaka akcija ima dva "izlazna porta", nazvana NextAction1 (NA1) i NextAction2 (NA2), koji se mogu povezati sa SeqActions koje se izvršavaju nakon što je akcija završena. Na primjerampLe, NextAction1 se može koristiti za izvršavanje neke akcije ako je trenutna akcija bila uspješna i NextAction2 bi se mogla pokrenuti u slučaju neuspjeha.
• Da biste kreirali prijelaz akcije, zadržite pokazivač miša iznad jednog od izlaznih portova, pritisnite lijevi taster miša i pomaknite pokazivač miša da biste povukli strelicu prijelaza. Pomaknite pokazivač miša preko ulaznog porta s lijeve strane neke druge SeqAction i otpustite lijevi taster miša da biste vezu učinili trajnom. Da biste uklonili prijelaz akcije, samo ponovite korake za kreiranje prijelaza akcije, ali otpustite lijevi taster miša negdje iznad pozadine šahovske ploče.
• Ako izlaz (SljedećaAkcija1, SljedećaAkcija2) ostane nepovezan, sekvencer se završava ako se ova sljedeća akcija aktivira.
• Obavezno povežite i "Ulaznu tačku" na ulazni port neke SeqAction akcije. Ova SeqAction akcija će se prva izvršiti čim se sekvencer pokrene.

Radnje uređivanja i brisanja

• SeqActions se može uređivati ​​klikom na dugme olovke u gornjem levom uglu SeqAction-a. Može se izbrisati klikom na crveni krst u gornjem desnom uglu (vidi sliku 3). Brisanje SeqAction-a također uklanja sve dolazne i odlazne prijelaze radnje.

SeqAction konfiguracija
SeqActions se može konfigurirati preko konfiguracijskog interfejsa sa karticama kojem se pristupa preko dugmeta olovke u gornjem levom uglu svake akcije u dijagramu toka. Ovo sučelje u suštini konfigurira sadržaj ActionConfiguration RAM tablice za određenu radnju, koja se sastoji od opcija konfiguracije koje se odnose na tok kontrole, kao i od sadržaja dinamičkog registra. Sadržaj dinamičkog registra može se konfigurisati ručno uz potpunu kontrolu nad svakom vrijednošću registra (pogledajte odjeljak 3.2.3: Napredna konfiguracija radija) ili putem pojednostavljenog sučelja (pogledajte odjeljak 3.2.2: Osnovna konfiguracija radija). Pojednostavljeni interfejs bi trebao biti dovoljan za gotovo sve slučajeve upotrebe.

Kontrolni tok
Kartica toka upravljanja (vidi sliku 4) sadrži neke osnovne opcije konfiguracije kao što su naziv akcije i interval vremenskog ograničenja akcije. Naziv akcije se ne koristi samo za prikaz u grafu toka, već se prenosi i u generirani izvorni kod.

• Kartica toka upravljanja (vidi sliku 4) sadrži neke osnovne opcije konfiguracije kao što su naziv akcije i interval vremenskog ograničenja akcije. Naziv akcije se ne koristi samo za prikaz u grafu toka, već se prenosi i u generirani izvorni kod.
• Najvažnije je da kartica toka kontrole konfiguriše uslov od kojeg zavisi prelaz na NextAction1 / NextAction2, kao i interval prelaza i zastavice. Uslov prelaza se može konfigurisati klikom na dugme označeno sa "...", što će prikazati dijalog za odabir maske prikazan na slici 5. Interval prelaza je modificirao svojstvo NextAction1Interval / NextAction2Interval RAM tabele. Za više informacija o značenju ovog intervala i značaju zastavica SleepEn / ForceReload / ForceClear pogledajte referentni priručnik STM32WL3x [1].
• Nadalje, na ovoj kartici se može dodati kratak opis bloka SeqAction. Ovaj opis se koristi samo u svrhu dokumentacije i prenosi se u generirani izvorni kod kao komentar izvornog koda.

Osnovna konfiguracija radija

Osnovna kartica za konfiguraciju radija može se podijeliti na tri dijela:

1. Odjeljak na vrhu gdje se konfigurišu dva najvažnija parametra bilo koje akcije: naredba koju treba izvršiti (TX, RX, NOP, SABORT, itd.) i, ako je primjenjivo, dužina paketa koji treba prenijeti.
2. Odjeljak s lijeve strane gdje se konfiguriraju stvarni radio parametri kao što su: frekvencija nosača, brzina prijenosa podataka, svojstva modulacije, pragovi međuspremnika podataka i tajmeri.
3. Dio s desne strane gdje se prekidi CPU-a mogu pojedinačno omogućiti. Za svaki od označenih prekida generira se program za obradu prekida. Ovo u osnovi konfigurira sadržaj registra RFSEQ_IRQ_ENABLE.

Za značenje različitih radio parametara pogledajte referentni priručnik za STM32WL3x [1].

Napredna konfiguracija radija

• Ako su opcije konfiguracije izložene kroz karticu osnovne konfiguracije radija (Odjeljak 3.2.2: Osnovna konfiguracija radija) nedovoljne, napredna kartica konfiguracije radija STM32WL3x dozvoljava postavljanje proizvoljnog dinamičkog sadržaja registra. Kartica napredne konfiguracije je omogućena tako što ćete označiti polje za potvrdu Napredna konfiguracija u gornjem desnom uglu interfejsa konfiguracije sa karticama.
• Nije moguće istovremeno koristiti i osnovne i napredne konfiguracije, korisnik mora odabrati jednu ili drugu. Međutim, naravno, moguće je i ručno naknadno urediti generirani izvorni kod i dodati potencijalno nedostajuće opcije konfiguracije.

Dijalog globalne konfiguracije

• Dijalogu „Globalne postavke projekta“ može se pristupiti putem dugmeta „Globalne postavke“ na alatnoj traci. Dijalog sadrži i opcije konfiguracije za sadržaj statičkog registra, kao i dodatne postavke projekta. Imajte na umu da se samo mali dio opcija konfiguracije statičkog registra može konfigurirati putem ovog dijaloga. Ove opcije su obezbijeđene samo kako bi se ubrzalo izradu prototipova aplikacija pomoću STM32CubeWiSE-RadioCodeGeneratora.
• Obično se očekuje da je sadržaj statičkih registara postavljen u ručno napisanom izvornom kodu aplikacije.
• Značenje ostalih postavki projekta objašnjeno je u samom dijalogu.
• Može se obezbijediti i dodatni C kod koji se ubacuje neposredno prije kreiranja tabele globalne konfiguracije RAM-a iz sadržaja statičkog registra. Ovo polje se može koristiti za postavljanje vrijednosti statičkog registra koje nisu dostupne putem date maske konfiguracije statičkog registra.

Generisanje koda
Grafikon toka se može prevesti u kompletan izvorni kod projekta u C jeziku pritiskom na dugme Generiraj kod u traci sa alatkama. Generisana fascikla projekta ne sadrži projekat. files za IAR, Keil® ili GCC. Ove files se moraju ručno dodati u STMWL3x projekat.
Ovo je generirana struktura foldera projekta:

Mapa projekta

• inc
• SequencerFlowgraph.h: zaglavlje file za SequencerFlowgraph.c, statički. Nemojte uređivati ​​ovo.
• stm32wl3x_hal_conf.h: STM32WL3x HAL konfiguracija file, statički.
• src
• SequencerFlowgraph.c: definicija dijagrama toka. Ovo je važno file koji koristi drajver sekvencera za definisanje RAM tabela globalne konfiguracije i konfiguracije akcija. Automatski generisano, ne uređujte.
• main.c: Glavni projekat file koji pokazuje kako učitati i primijeniti definiciju grafa toka. Statički, izmijenite ovo po potrebi.
• Za uređivanje main.c ili stm32wl3x_hal_conf.h, odaberite ponašanje prepisivanja Zadrži u postavkama projekta. Na ovaj način, samo SequencerFlowgraph.c se prepisuje.

Kako uvesti generirani kod u CubeMX example
Da biste uvezli projekat koji je generisao STM32CubeWiSE-RadioCodeGenerator u CubeMX example (MRSUBG_Skeleton), potrebno je slijediti sljedeće korake:

1. Otvorite mapu koja sadrži filegenerirane pomoću STM32CubeWiSE-RadioCodeGeneratora i kopirajte mape „Inc“ i „Src“.
2. Zalijepite dvije mape u mapu „MRSUBG_Skeleton“ i prepišite dvije koje već postoje.
3. Otvorite projekat „MRSUBG_Skeleton“ u jednom od sljedećih IDE-ova:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Unutar projekta „MRSUBG_Skeleton“ dodajte datoteku „SequencerFlowghraph.c“ file:
   • Za EWARM projekat, putanja za dodavanje file je sljedeće: MRSUBG_Skeleton\Application\User
   • Za MDK-ARM projekat, putanja za dodavanje file je sljedeće: MRSUBG_Skeleton\Aplikacija/Korisnik
   • Za STM32CubeIDE projekat, putanja za dodavanje file je isto:
     MRSUBG_Skelet\Aplikacija\Korisnik
5. Unutar projekta MRSUBG_Skeleton, dodajte stm32wl3x_hal_uart.c i stm32wl3x_hal_uart_ex.c files na sljedeću putanju: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Putanja je ista za sva IDE-a. Dva fileDatoteke se nalaze na lokaciji Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Da biste koristili COM funkcije, stm32wl3x_nucleo_conf.h file, koji se nalazi na Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, mora se izmijeniti postavljanjem USE_BSP_COM_FEATURE i USE_COM_LOG na 1U:
7. Kopirajte sljedeći kod u datoteku "stm32wl3x_it.c", koja se nalazi u MRSUBG_Skeleton\Application\User.

Flowgraph examples

• Četiri exampgrafovi toka su dati uz izvorni kod. Ove exampdatoteke se mogu učitati u STM32CubeWiSE-RadioCodeGenerator klikom na dugme “Učitaj” na traci sa alatkama.

AutoACK_RX

• Demo Auto-ACK-a ilustruje kako dva STM32WL3x uređaja mogu automatski međusobno komunicirati uz minimalnu intervenciju CPU-a, uz pomoć hardvera sekvencera.
• Ovaj dijagram toka implementira ponašanje (Auto-Transmit-ACK) uređaja A. U uređaju A, sekvencer je inicijaliziran u stanju prijema (WaitForMessage), u kojem čeka dolazak poruke.
• Nakon što stigne validna poruka, sekvencer automatski prelazi u stanje slanja (TransmitACK), u kojem se ACK paket šalje kao odgovor, bez intervencije CPU-a. Nakon što se ovo završi, sekvencer se resetuje u svoje početno stanje WaitForMessage.
• Ovaj dijagram toka implementira isto ponašanje kao i MRSUBG_SequencerAutoAck_Rx example iz ExampFolder les\MRSUBG softverskog paketa STM32Cube WL3. Ako je AutoACK_RX flešovan na jednom uređaju
  A, a AutoACK_TX je flešovan na nekom uređaju, B, dva uređaja šalju poruke naprijed-nazad, kao u igri ping-ponga.

AutoACK_TX

• “Auto-ACK” demo ilustruje kako dva STM32WL3x uređaja mogu automatski razgovarati jedan s drugim uz minimalnu CPU intervenciju uz pomoć hardvera sekvencera.
• Ovaj dijagram toka implementira ponašanje („Auto-Wait-for-ACK“) uređaja B. U uređaju B, sekvencer je inicijaliziran u stanju odašiljanja (TransmitMessage), u kojem prenosi poruku. Nakon što je prijenos završen, automatski prelazi u stanje prijema gdje čeka potvrdu od uređaja A (WaitForACK). Nakon što stigne važeća potvrda, sekvencer se resetuje u svoje početno stanje TransmitMessage i cijeli proces počinje ispočetka. U slučaju da se ACK ne primi u roku od 4 sekunde, aktivira se timeout i sekvencer se ipak vraća u stanje TransmitMessage.
• Ovaj dijagram toka implementira isto ponašanje kao "MRSUBG_SequencerAutoAck_Tx" example iz bivšegampFolder les\MRSUBG softverskog paketa STM32Cube WL3. Ako je AutoACK_RX flešovan na jednom uređaju, A, a AutoACK_TX na nekom drugom uređaju, B, dva uređaja šalju poruke naprijed-nazad, kao u igri ping-ponga.

Slušajte prije razgovora (LBT)

• Ovaj exampPreuzeto je iz referentnog priručnika STM32WL3x [1]. Pogledajte taj priručnik za više detalja o ovom nprample.

Sniff mode

• Ovaj exampPreuzeto je iz referentnog priručnika STM32WL3x [1]. Pogledajte taj priručnik za više detalja o ovom nprample.

Istorija revizija

Tabela 2. Istorija revizije dokumenta

Datum	Verzija	Promjene
21-2024-XNUMX	1	Prvo izdanje.
10-feb-2025	2	Naziv uređaja ažuriran na opseg STM32WL3x.

VAŽNA NAPOMENA – PAŽLJIVO PROČITAJTE

• STMicroelectronics NV i njegove podružnice (“ST”) zadržavaju pravo na izmjene, ispravke, poboljšanja, modifikacije i poboljšanja ST proizvoda i/ili ovog dokumenta u bilo koje vrijeme bez prethodne najave. Kupci bi trebali dobiti najnovije relevantne informacije o ST proizvodima prije nego što daju narudžbu. ST proizvodi se prodaju u skladu sa ST-ovim odredbama i uslovima prodaje koji su na snazi ​​u trenutku potvrde narudžbe.
• Kupci su isključivo odgovorni za izbor, odabir i korištenje ST proizvoda, a ST ne preuzima nikakvu odgovornost za pomoć u primjeni ili dizajn proizvoda kupaca.
• ST ovdje ne daje nikakvu licencu, izričitu ili impliciranu, za bilo koje pravo intelektualne svojine.
• Preprodaja ST proizvoda sa odredbama koje se razlikuju od informacija navedenih ovde poništava svaku garanciju koju ST daje za takav proizvod.
• ST i ST logo su zaštitni znakovi ST. Za dodatne informacije o ST zaštitnim znakovima, pogledajte www.st.com/trademarks. Svi ostali nazivi proizvoda ili usluga vlasništvo su njihovih vlasnika.
• Informacije u ovom dokumentu zamjenjuju i zamjenjuju informacije koje su prethodno date u prethodnim verzijama ovog dokumenta.
• © 2025 STMicroelectronics – Sva prava zadržana

FAQ

• P: Koji su minimalni sistemski zahtjevi za STM32CubeWiSE-RadioCodeGenerator?
  • A: Minimalni sistemski zahtjevi uključuju najmanje 2 GB RAM-a, USB portove i Adobe Acrobat Reader 6.0.
• P: Kako mogu postaviti softverski paket STM32CubeWiSE-RadioCodeGenerator?
  • A: Da biste instalirali softverski paket, izdvojite sadržaj priložene zip datoteke file u privremeni direktorij i pokrenite izvršnu datoteku file prateći uputstva na ekranu.

Dokumenti / Resursi

STMicroelectronics UM3399 STM32Cube WiSE Radio Code Generator [pdf] Korisnički priručnik UM3399, UM3399 STM32 Cube WiSE Radio Code Generator, UM3399, STM32, Cube WiSE Radio Code Generator, Radio Code Generator, Code Generator, Generator

Reference

• Uputstvo za upotrebu