STMicroelectronics UM3399 STM32Cube WiSE radyo kòd jeneratè manyèl itilizatè

Kontni kache

1 STMicroelectronics UM3399 STM32Cube WiSE dèlko Kòd radyo

2 Enstriksyon Itilizasyon Pwodwi

STMicroelectronics UM3399 STM32Cube WiSE dèlko Kòd radyo

Enstriksyon Itilizasyon Pwodwi

Aplikasyon STM32CubeWiSE-RadioCodeGenerator mande pou omwen 2 Go RAM, pò USB, ak Adobe Acrobat reader 6.0.
Ekstrè kontni stm32wise-cgwin.zip la file nan yon anyè tanporè.

Lanse STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe la file epi swiv enstriksyon ki sou ekran an.
Pake SW STM32CubeWiSE-RadioCodeGenerator fileyo òganize nan dosye ki gen ladan 'app' ak 'ansyenamples'.

Pou konstwi yon flowgraph nan STM32CubeWiSE-RadioCodeGenerator:
Ajoute SeqActions nan flowgraph la lè l sèvi avèk ba ikòn oswa meni mondyal la.

Konekte SeqActions ak pwen antre a ak youn ak lòt lè w trase flèch tranzisyon aksyon yo.
Navige graf koule a lè w trennen aksyon epi ajoute tranzisyon aksyon jan sa nesesè.

Entwodiksyon

Dokiman sa a dekri pake SW STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) ak dèlko kòd sekansè STM32WL3x MRSUBG.
STM32CubeWiSE-RadioCodeGenerator se yon aplikasyon PC ki itilize pou konstwi yon flowgraph ki defini ki aksyon transceiver pou egzekite nan ki kondisyon, lè l sèvi avèk chofè sekansè MRSUBG la.

STM32WL3x radyo Sub-GHz gen sekansè sa a, ki se yon mekanis eta-machin ki sanble ak ki pèmèt pou jesyon otonòm nan transfè RF, san okenn bezwen pou entèvansyon CPU.
Si entèvansyon CPU nesesè, entèwonp yo ka defini. Aksyon transceiver yo ka ranje nan yon graf koule. Nan dokiman sa a, aksyon endividyèl transceiver yo refere yo kòm SeqActions.

Sepandan, kòd sous se pa pi bon reprezantasyon pou flowgraphs, paske li kache estrikti lojik ak tanporèl yo.
STM32CubeWiSE-RadioCodeGenerator adrese pwoblèm sa a lè li bay yon metòd grafik pou konstwi flowgraphs ak Lè sa a, ekspòte flowgraph yo pwodwi kòm kòd sous C pou entegrasyon nan aplikasyon itilizatè yo.

Definisyon flowgraph la estoke nan RAM mikrokontroleur a nan fòm sa a:
- Yon seri tab ActionConfiguration RAM, ki lye youn ak lòt lè l sèvi avèk endikasyon. Endikasyon sa yo defini SeqActions yo, sa vle di ki kalite aksyon (pa egzanpample, transmisyon, resepsyon, abort), osi byen ke SeqAction-espesifik paramèt radyo ak kondisyon pou transmisyon aksyon.
- Yon tab inik RAM GlobalConfiguration. Sa a defini pwen antre nan flowgraph la (premye SeqAction pou egzekite), osi byen ke kèk valè drapo default ak paramèt radyo komen.
Paramèt radyo, ki ka konfigirasyon endividyèlman pou chak SeqAction, yo estoke nan youn nan rejis dinamik yo, ki gen sa ki fè pati tab la RAM ActionConfiguration. Paramèt radyo ki fikse sou tout ekzekisyon flowgraph la (sòf si yo modifye pandan yon entèwonp CPU), yo estoke nan rejis estatik, ki gen sa ki fè pati tablo RAM konfigirasyon mondyal la.

Enfòmasyon jeneral

Lisans
Dokiman sa a dekri lojisyèl ki kouri sou STM32WL3x Arm® Cortex ® -M0+ ki baze sou mikrokontroleur.
Nòt: Arm se yon mak ki anrejistre Arm Limited (oswa filiales li yo) nan peyi Etazini ak/oswa lòt kote.

Dokiman ki gen rapò

Tablo 1. Referans dokiman yo

Nimewo	Referans	Tit
[1]	RM0511	STM32WL30xx/31xx/33xx Arm® ki baze sou sub-GHz MCU

Kòmanse

Seksyon sa a dekri tout kondisyon sistèm pou kouri STM32CubeWiSE-RadioCodeGenerator.
Li detay tou pwosedi enstalasyon pake lojisyèl an.

Kondisyon sistèm
Aplikasyon STM32CubeWiSE-RadioCodeGenerator gen kondisyon minimòm sa yo:

PC ak yon processeur Intel® oswa AMD® kap kouri sistèm operasyon Microsoft® Windows 10

Omwen 2 Go RAM
Pò USB

Adobe Acrobat reader 6.0

STM32CubeWiSE-RadioCodeGenerator SW konfigirasyon pake
Fè etap sa yo:

Ekstrè kontni stm32wise-cgwin.zip la file nan yon anyè tanporè.
Ekstrè epi lanse STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe la file epi swiv enstriksyon ki sou ekran an.

Pake SW STM32CubeWiSE-RadioCodeGenerator files
Pake SW STM32CubeWiSE-RadioCodeGenerator fileyo òganize nan dosye sa yo:

app: gen STM32CubeWiSE-RadioCodeGenerator.exe
examples: katab sa a òganize nan sousdosye sa yo:
kòd: katab sa a gen flowgraphs yo egzanpample deja ekspòte kòm kòd C, pare yo dwe sou fòm piki nan yon pwojè aplikasyon
flowgraphs: Katab sa a estoke kèk ansyenamples senaryo nan operasyon otonòm sekans MRSUBG

Nòt lage ak lisans fileyo sitiye nan katab la rasin.

STM32CubeWiSE-RadioCodeGenerator deskripsyon lojisyèl

Seksyon sa a dekri fonksyon prensipal aplikasyon STM32CubeWiSE-RadioCodeGenerator. Pou kouri sèvis piblik sa a, klike sou ikòn STM32CubeWiSE-RadioCodeGenerator.

Apre lanse STM32CubeWiSE-RadioCodeGenerator, fenèt aplikasyon prensipal la parèt. Li konsiste de:

Yon meni mondyal ak ba zouti
Reprezantasyon vizyèl trennen ak gout nan flowgraph la
Seksyon konfigirasyon SeqAction (sèlman vizib si yon SeqAction ap modifye kounye a)

Bati yon flowgraph
Basics
Flowgraph yo bati nan de etap:

Ajoute SeqActions nan flowgraph la. Sa a ka fè lè l sèvi avèk bouton "Ajoute Aksyon" nan ba zouti a, lè l sèvi avèk meni mondyal la (Edisyon → Ajoute Aksyon) oswa ak rakoursi "Ctrl + A".

Konekte SeqActions ak pwen antre a ak youn ak lòt lè w trase flèch tranzisyon aksyon yo.

Kondisyon kote tranzisyon sa yo fèt yo defini pita (gade Seksyon 3.2.1: Kontwòl koule).

Navige flowgraph la, trennen aksyon
Lè w trennen background nan damiye nan flowgraph la ak konsèy sourit la (klike sou bò gòch), la viewpò sou flowgraph la ka ajiste. Ou ka itilize wou woulo liv sourit la pou rale ak soti. Klike nenpòt kote sou yon aksyon (eksepte pou pò yo pwodiksyon, bouton an efase ak bouton an edite) yo chwazi yon aksyon. Aksyon yo ka ranje nan flowgraph la pa trenen yo ak bouton an sourit gòch.

Ajoute tranzisyon aksyon

Jan yo montre nan Figi 2, chak aksyon gen de "pò pwodiksyon", ki rele NextAction1 (NA1) ak NextAction2 (NA2), ki ka konekte ak SeqActions ke yo egzekite apre aksyon an te fini. Pou egzanpampLè sa a, NextAction1 ta ka itilize pou egzekite kèk aksyon si aksyon aktyèl la te reyisi epi NextAction2 ta ka deklanche nan ka ta gen echèk.

Pou kreye yon tranzisyon aksyon, pase pwent sourit la sou youn nan pò pwodiksyon yo, peze bouton gòch sourit la epi deplase pointeur sourit la pou trennen yon flèch tranzisyon. Deplase pwent sourit la sou pò opinyon ki sou bò gòch kèk lòt SeqAction epi lage bouton gòch sourit la pou fè koneksyon an pèmanan. Pou retire yon tranzisyon aksyon, jis repete etap sa yo pou kreye yon tranzisyon aksyon, men lage bouton gòch la sourit yon kote sou background nan damye.
Si yon pwodiksyon (NextAction1, NextAction2) pa konekte, sekansè a fini si pwochen aksyon sa a deklanche.
Asire w ou konekte tou "Pwen Antre" a nan pò D' kèk SeqAction. SeqAction sa a se premye moun ki egzekite le pli vit ke sekansè a deklanche.

Edit ak efase aksyon yo

SeqActions ka modifye lè w klike sou bouton kreyon ki anlè SeqAction. Li ka efase lè w klike sou kwa wouj ki anlè adwat (gade Figi 3). Efase yon SeqAction tou retire nenpòt tranzisyon aksyon fèk ap rantre ak sortan.

SeqAction konfigirasyon
SeqActions ka konfigirasyon atravè yon koòdone konfigirasyon ongle ki aksesib atravè bouton kreyon ki anlè a gòch chak aksyon nan flowgraph la. Koòdone sa a esansyèlman konfigirasyon sa ki nan tab la RAM ActionConfiguration pou aksyon an patikilye, ki gen ladan tou de opsyon kontwòl koule ki gen rapò ak konfigirasyon kòm byen ke sa ki enskri dinamik. Kontni rejis dinamik yo ka swa konfigirasyon manyèlman ak kontwòl konplè sou chak valè rejis (gade Seksyon 3.2.3: Konfigirasyon radyo avanse) oswa atravè yon koòdone senplifye (gade Seksyon 3.2.2: Konfigirasyon radyo debaz). Koòdone senplifye a ta dwe ase pou prèske tout ka itilize.

Kontwole koule
Tab kontwòl koule a (gade Figi 4) gen kèk opsyon konfigirasyon debaz tankou non aksyon ak entèval delè aksyon. Non aksyon an pa sèlman itilize pou ekspozisyon nan flowgraph la, men tou li pote sou kòd sous ki te pwodwi a.

Tab kontwòl koule a (gade Figi 4) gen kèk opsyon konfigirasyon debaz tankou non aksyon ak entèval delè aksyon. Non aksyon an pa sèlman itilize pou ekspozisyon nan flowgraph la, men tou pote sou kòd sous la pwodwi.
Sa ki pi enpòtan, tab la koule kontwòl konfigirasyon kondisyon an sou ki yon tranzisyon nan NextAction1 / NextAction2 depann de osi byen ke entèval tranzisyon ak drapo. Kondisyon tranzisyon an ka konfigirasyon lè w klike sou bouton ki make "...", sa ki fè dyalòg seleksyon mask ki montre nan Figi 5 parèt. Entèval tranzisyon an te modifye pwopriyete NextAction1Interval / NextAction2Interval nan tablo RAM la. Ale nan manyèl referans STM32WL3x [1] pou plis enfòmasyon sou siyifikasyon entèval sa a ak siyifikasyon drapo SleepEn / ForceReload / ForceClear yo.
Anplis de sa, ou ka ajoute yon deskripsyon kout sou blòk SeqAction sou tab sa a. Yo itilize deskripsyon sa a sèlman pou rezon dokimantasyon epi yo pote l nan kòd sous ki te pwodwi a kòm yon kòmantè kòd sous.

Konfigirasyon radyo debaz

Tab konfigirasyon radyo debaz la ka divize an twa pati:

Yon seksyon nan tèt kote de paramèt ki pi enpòtan nan nenpòt aksyon yo konfigirasyon: lòd pou egzekite (TX, RX, NOP, SABORT, ak sou sa) ak, si sa aplikab, longè pake a transfere.
Yon seksyon sou bò gòch kote paramèt radyo aktyèl yo tankou: frekans konpayi asirans, pousantaj done, pwopriyete modulasyon, papòt tanpon done ak revèy yo configuré.
Yon seksyon sou bò dwat kote CPU entèwonp yo ka endividyèlman pèmèt. Yon moun k ap okipe entèwonp yo pwodwi pou chak entèwonp ki make yo. Sa a fondamantalman configured sa ki nan rejis RFSEQ_IRQ_ENABLE.

Gade nan manyèl referans STM32WL3x [1] pou siyifikasyon divès paramèt radyo yo.

Konfigirasyon radyo avanse

Si opsyon konfigirasyon yo ekspoze atravè tab konfigirasyon radyo debaz la (Seksyon 3.2.2: Konfigirasyon radyo debaz) yo ensifizan, tab konfigirasyon radyo STM32WL3x avanse pèmèt anviwònman abitrè kontni rejis dinamik. Se tab la konfigirasyon avanse aktive lè w tcheke kaz Konfigirasyon avanse anlè anlè adwat nan koòdone konfigirasyon onglet la.
Li pa posib pou itilize tou de konfigirasyon debaz ak avanse an menm tan, itilizatè a dwe chwazi youn oswa lòt. Sepandan, li se posib tou pou manyèlman edite kòd sous pwodwi a apre sa epi ajoute opsyon konfigirasyon ki kapab manke yo.

Dyalòg konfigirasyon mondyal la

Ou ka jwenn dyalòg "Anviwònman Pwojè Global" nan bouton ba ikòn "Anviwònman Global". Dyalòg la gen tou de opsyon konfigirasyon pou kontni rejis estatik la ansanm ak lòt anviwònman pwojè. Remake byen ke se sèlman yon ti fraksyon nan opsyon konfigirasyon rejis estatik ka configuré nan dyalòg sa a. Yo bay opsyon sa yo sèlman pou pi vit aplikasyon pwototip aplikasyon ak STM32CubeWiSE-RadioCodeGenerator.
Anjeneral li espere ke kontni rejis estatik yo mete nan kòd sous aplikasyon an ki ekri manyèlman.

Siyifikasyon lòt paramèt pwojè yo eksplike nan dyalòg li menm.
Lòt kòd C ki antre jis anvan yo kreye tab la RAM Global Configuration soti nan kontni rejis estatik yo ka bay tou. Yo ka itilize jaden sa a pou mete kanpe valè rejis estatik ki pa aksesib atravè mask konfigirasyon rejis estatik yo bay la.

Kòd jenerasyon
Ka flowgraph la ka tradui nan yon kòd sous pwojè konplè C lè w peze bouton Jenere Kòd la nan ba zouti a. Katab pwojè pwodwi a pa gen pwojè files pou IAR, Keil®, oswa GCC. Sa yo files dwe ajoute manyèlman nan pwojè STMWL3x la.
Sa a se estrikti nan katab pwojè pwodwi:

Katab Pwojè

inc
SequencerFlowgraph.h: header file pou SequencerFlowgraph.c, estatik. Pa edite sa.

stm32wl3x_hal_conf.h: STM32WL3x HAL konfigirasyon file, estatik.
src
SequencerFlowgraph.c: definisyon flowgraph. Sa a se enpòtan an file ki itilize chofè sekansè a pou defini tab RAM global-konfigirasyon ak aksyon-konfigirasyon. Otogénére, pa modifye.

main.c: Pwojè prensipal file ki montre kijan pou chaje ak aplike definisyon flow-graf la. Estatik, modifye sa a jan sa nesesè.
Pou modifye main.c oswa stm32wl3x_hal_conf.h, chwazi remplacer konpòtman Kenbe nan anviwònman pwojè yo. Nan fason sa a, sèlman SequencerFlowgraph.c vin ranplase.

Ki jan yo enpòte kòd pwodwi nan yon ansyen CubeMXample
Pou enpòte yon pwojè ki te pwodwi pa STM32CubeWiSE-RadioCodeGenerator nan yon ansyen CubeMXample (MRSUBG_Skeleton), li nesesè pou swiv etap sa yo:

Louvri katab la ki gen la fileSTM32CubeWiSE-RadioCodeGenerator te pwodwi epi kopi dosye "Inc" ak "Src".
Kole de dosye yo sou katab "MRSUBG_Skeleton" ki ranplase de ki deja prezan.
Louvri pwojè "MRSUBG_Skeleton" nan youn nan IDE sa yo:
- EWARM
- MDK-ARM
- STM32CubeIDE

Anndan pwojè "MRSUBG_Skeleton", ajoute "SequencerFlowghraph.c" la. file:
- Pou yon pwojè EWARM, chemen pou ajoute a file se sa ki annapre yo: MRSUBG_Skeleton\Application\User
- Pou yon pwojè MDK-ARM, chemen pou ajoute a file se sa ki annapre yo: MRSUBG_Skeleton\Aplikasyon/Itilizatè
- Pou yon pwojè STM32CubeIDE, chemen pou ajoute a file se menm bagay la:
  MRSUBG_Skeleton\Aplikasyon\Itilizatè
Anndan pwojè MRSUBG_Skeleton, ajoute stm32wl3x_hal_uart.c ak stm32wl3x_hal_uart_ex.c files nan chemen sa a: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Chemen an se menm pou tout IDE yo. De la fileyo sitiye sou Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
Pou itilize karakteristik COM, stm32wl3x_nucleo_conf.h file, ki chita sou Firmware\Projects\NUCLEOWL33CC\ Egzamples\MRSUBG\MRSUBG_Skeleton\Inc, yo dwe modifye anviwònman USE_BSP_COM_FEATURE ak USE_COM_LOG nan 1U:

Kopi kòd sa a nan "stm32wl3x_it.c", ki sitiye nan MRSUBG_Skeleton\Application\User.

Flowgraph ekzamples

Kat ansyenampLe flowgraphs yo bay ansanm ak kòd sous la. Sa yo ansyenampLes yo ka chaje nan STM32CubeWiSE-RadioCodeGenerator lè w klike sou bouton "Chajman" ki nan ba zouti a.

AutoACK_RX

Demo Auto-ACK montre kouman de aparèy STM32WL3x ka otomatikman pale youn ak lòt ak entèvansyon CPU minim, avèk èd pyès ki nan konpitè sekans.
Flowgraph sa a aplike konpòtman (Auto-Transmit-ACK) aparèy A. Nan aparèy A, sekansè a inisyalize nan yon eta k ap resevwa (WaitForMessage), kote li tann pou yon mesaj rive.
Yon fwa yon mesaj valab rive, sekansè a otomatikman tranzisyon nan yon eta transmèt (TransmitACK), kote yo voye yon pake ACK kòm yon repons, san entèvansyon CPU. Yon fwa sa a fini, sekansè a retabli nan eta WaitForMessage inisyal li.

Flowgraph sa a aplike menm konpòtman ak egzanp MRSUBG_SequencerAutoAck_Rxample soti nan Examples\MRSUBG katab pakè lojisyèl STM32Cube WL3 la. Si AutoACK_RX parèt sou yon aparèy
A, epi AutoACK_TX parèt sou kèk aparèy, B, de aparèy yo voye mesaj ale vini, tankou nan yon jwèt ping-pong.

AutoACK_TX

Demo "Auto-ACK" montre kouman de aparèy STM32WL3x ka otomatikman pale youn ak lòt ak entèvansyon CPU minim avèk èd pyès ki nan konpitè sekans.
Flowgraph sa a aplike konpòtman ("Auto-Wait-for-ACK") aparèy B. Nan aparèy B, sekansè a inisyalize nan yon eta transmèt (TransmitMessage), kote li transmèt yon mesaj. Yon fwa transmisyon an fini, li otomatikman tranzisyon nan yon eta k ap resevwa kote li tann pou yon rekonesans soti nan aparèy A (WaitForACK). Yon fwa ke yon rekonesans valab rive, sekansè a reset nan eta TransmitMessage inisyal li yo ak tout pwosesis la kòmanse ankò. Nan ka pa resevwa ACK nan 4 segonn, yon timeout deklanche epi sekansè a retounen nan eta TransmitMessage de tout fason.
Flowgraph sa a aplike menm konpòtman ak "MRSUBG_SequencerAutoAck_Tx" egzanpample soti nan Examples\MRSUBG katab pakè lojisyèl STM32Cube WL3 la. Si AutoACK_RX parèt sou yon aparèy, A, epi AutoACK_TX parèt sou kèk lòt aparèy, B, de aparèy yo voye mesaj ale vini, tankou nan yon jwèt ping-pong.

Koute anvan pale (LBT)

Ansyen sa aample yo pran nan manyèl referans STM32WL3x [1]. Gade manyèl sa a pou plis detay sou ansyen sa aample.

Sniff mòd

Ansyen sa aample yo pran nan manyèl referans STM32WL3x [1]. Gade manyèl sa a pou plis detay sou ansyen sa aample.

Istwa revizyon

Tablo 2. Istwa revizyon dokiman yo

Dat	Version	Chanjman
21-Nov-2024	1	Premye lage.
10-fevriye-2025	2	Mete ajou non aparèy nan sijè ki abòde STM32WL3x.

AVI ENPÒTAN – LI AK ATANSYON

STMicroelectronics NV ak filiales li yo ("ST") rezève dwa pou fè chanjman, koreksyon, amelyorasyon, modifikasyon, ak amelyorasyon nan pwodwi ST ak/oswa nan dokiman sa a nenpòt ki lè san avètisman. Achtè yo ta dwe jwenn dènye enfòmasyon enpòtan sou pwodwi ST yo anvan yo mete lòd. Pwodwi ST yo vann daprè tèm ak kondisyon pou vann ST ki an plas nan moman rekonesans lòd la.

Achtè yo se sèl responsab pou chwa, seleksyon, ak itilizasyon pwodwi ST yo epi ST pa sipoze okenn responsablite pou asistans aplikasyon oswa konsepsyon pwodwi achtè yo.
Pa gen okenn lisans, eksprime oswa implicite, sou okenn dwa pwopriyete entelektyèl akòde pa ST nan la a.
Revann pwodwi ST ak dispozisyon ki diferan de enfòmasyon ki endike nan la a pral anile nenpòt garanti ST akòde pou pwodui sa a.

ST ak logo ST a se mak komèsyal ST. Pou jwenn plis enfòmasyon sou mak ST, al gade nan www.st.com/trademarks. Tout lòt non pwodwi oswa sèvis yo se pwopriyete pwopriyetè respektif yo.
Enfòmasyon ki nan dokiman sa a ranplase epi ranplase enfòmasyon yo te bay anvan nan nenpòt vèsyon anvan dokiman sa a.

FAQ

K: Ki kondisyon minimòm sistèm pou STM32CubeWiSE-RadioCodeGenerator?
- A: Kondisyon sistèm minimòm yo gen ladan omwen 2 Go RAM, pò USB, ak Adobe Acrobat reader 6.0.
K: Kouman mwen ka mete sou pye pakè lojisyèl STM32CubeWiSE-RadioCodeGenerator?
- A: Pou mete sou pye pakè lojisyèl, extrait contenu postal bay la file antre nan yon anyè tanporè epi lanse ègzekutabl la file swiv enstriksyon ki sou ekran an.

Dokiman / Resous

STMicroelectronics UM3399 STM32Cube WiSE dèlko Kòd radyo [pdfManyèl Itilizatè
UM3399, UM3399 STM32 Cube WiSE dèlko kòd radyo, UM3399, STM32, dèlko kòd radyo kib WiSE, dèlko kòd radyo, dèlko kòd, dèlko

Referans

Manyèl itilizatè