STMicroelectronics UM3399 STM32Cube WiSE Radio Code Generator

Notkunarleiðbeiningar fyrir vöru

• STM32CubeWiSE-RadioCodeGenerator forritið krefst að minnsta kosti 2 Gbæti af vinnsluminni, USB tengi og Adobe Acrobat reader 6.0.
• Dragðu út innihald stm32wise-cgwin.zip file inn í tímabundna skrá.
• Ræstu STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file og fylgdu leiðbeiningunum á skjánum.
• STM32CubeWiSE-RadioCodeGenerator SW pakkinn files eru skipulögð í möppur þar á meðal 'app' og 'examples'.
• Til að búa til flæðirit í STM32CubeWiSE-RadioCodeGenerator:
• Bættu SeqActions við flæðiritið með því að nota tækjastikuna eða alþjóðlega valmyndina.
• Tengdu SeqActions við inngangsstaðinn og við hvert annað með því að teikna aðgerðaskiptiörvar.
• Farðu í flæðiritið með því að draga aðgerðir og bæta við aðgerðabreytingum eftir þörfum.

Inngangur

• Þetta skjal lýsir STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) SW pakkanum með STM32WL3x MRSUBG röðunarkóðanum.
• STM32CubeWiSE-RadioCodeGenerator er tölvuforrit sem er notað til að búa til flæðirit sem skilgreinir hvaða sendimóttakaraaðgerðir á að framkvæma við hvaða aðstæður, með því að nota MRSUBG raðgreiningarstjórann.
• STM32WL3x Sub-GHz útvarp inniheldur þennan röðunarbúnað, sem er vélbúnaður eins og ástandsvél sem gerir kleift að stjórna RF flutningum sjálfvirkt, án þess að þörf sé á örgjörva íhlutun.
• Ef þörf er á inngripi CPU er hægt að skilgreina truflanir. Hægt er að raða aðgerðum senditækis í flæðisgraf. Í þessu skjali er vísað til einstakra senditækisaðgerða sem SeqActions.
• Hins vegar er frumkóði ekki besta framsetningin fyrir flæðirit, þar sem hann leynir rökréttri og tímabundinni uppbyggingu þeirra.
• STM32CubeWiSE-RadioCodeGenerator tekur á þessu vandamáli með því að bjóða upp á myndræna aðferð til að búa til flæðirit og flytja síðan út mynduð flæðirit sem C frumkóða til samþættingar í notendaforrit.
• Skilgreining flæðiritsins er geymd í vinnsluminni örstýringarinnar í formi:
  • Safn af ActionConfiguration RAM töflum, tengd við hvert annað með því að nota ábendingar. Þessar ábendingar skilgreina SeqActions, það er tegund aðgerða (tdample, sending, móttaka, hætta), sem og SeqAction-sértækar útvarpsfæribreytur og skilyrði fyrir aðgerðasendingar.
  • Einstök GlobalConfiguration RAM borð. Þetta skilgreinir inngangspunkt flæðiritsins (fyrsta SeqAction til að framkvæma), auk nokkurra sjálfgefna fánagilda og algengar útvarpsfæribreytur.
• Útvarpsfæribreytur, sem hægt er að stilla sérstaklega fyrir hverja SeqAction, eru geymdar í einni af kraftmiklu skránum, en innihald þeirra er hluti af ActionConfiguration RAM töflunni. Útvarpsfæribreytur sem eru fastar á allri framkvæmd flæðiritsins (nema þeim sé breytt við truflun á örgjörva) eru geymdar í kyrrstæðum skrám, en innihald þeirra er hluti af vinnsluminnistöflunni fyrir altæka stillingar.

Almennar upplýsingar

Leyfisveitingar
Þetta skjal lýsir hugbúnaði sem keyrir á STM32WL3x Arm® Cortex ® -M0+ örstýringunni.
Athugið: Arm er skráð vörumerki Arm Limited (eða dótturfélaga þess) í Bandaríkjunum og/eða annars staðar.

Tengd skjöl

Tafla 1. Skjalatilvísanir

Númer	Tilvísun	Titill
[1]	RM0511	STM32WL30xx/31xx/33xx Arm® byggðir undir-GHz MCUs

Að byrja

• Þessi hluti lýsir öllum kerfiskröfum til að keyra STM32CubeWiSE-RadioCodeGenerator.
• Það lýsir einnig uppsetningarferli hugbúnaðarpakkans.

Kerfiskröfur
STM32CubeWiSE-RadioCodeGenerator forritið hefur eftirfarandi lágmarkskröfur:

• Tölva með Intel® eða AMD® örgjörva sem keyrir Microsoft® Windows 10 stýrikerfið
• Að minnsta kosti 2 Gbæti af vinnsluminni
• USB tengi
• Adobe Acrobat reader 6.0

STM32CubeWiSE-RadioCodeGenerator SW pakkauppsetning
Framkvæmdu eftirfarandi skref:

1. Dragðu út innihald stm32wise-cgwin.zip file inn í tímabundna skrá.
2. Dragðu út og ræstu STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file og fylgdu leiðbeiningunum á skjánum.

STM32CubeWiSE-RadioCodeGenerator SW pakki files
STM32CubeWiSE-RadioCodeGenerator SW pakkinn files eru skipulögð í eftirfarandi möppur:

• app: inniheldur STM32CubeWiSE-RadioCodeGenerator.exe
• examples: þessi mappa er skipulögð í eftirfarandi undirmöppur:
• kóða: þessi mappa inniheldur flæðiritin tdample þegar flutt út sem C kóða, tilbúið til að vera sprautað inn í umsóknarverkefni
• flowgraphs: þessi mappa geymir nokkur tdampminna atburðarás af sjálfstæðum MRSUBG röðunaraðgerðum

Útgáfuskýrslur og leyfi files eru staðsett í rótarmöppunni.

STM32CubeWiSE-RadioCodeGenerator hugbúnaðarlýsing

• Þessi hluti lýsir helstu aðgerðum STM32CubeWiSE-RadioCodeGenerator forritsins. Til að keyra þetta tól, smelltu á STM32CubeWiSE-RadioCodeGenerator táknið.

Eftir að STM32CubeWiSE-RadioCodeGenerator hefur verið ræst birtist aðalforritsglugginn. Það samanstendur af:

• Alheimsvalmynd og tækjastika
• Sjónræn drag-og-sleppa framsetning flæðiritsins
• SeqAction stillingarhlutinn (aðeins sýnilegur ef verið er að breyta SeqAction)

Byggja flæðirit
Grunnatriði
Flæðirit eru byggð í tveimur skrefum:

1. Bættu SeqActions við flæðiritið. Þetta er hægt að gera með því að nota „Bæta við aðgerð“ hnappinn á tækjastikunni, með því að nota alþjóðlega valmyndina (Breyta → Bæta við aðgerð) eða með „Ctrl+A“ flýtileiðinni.
2. Tengdu SeqActions við inngangsstaðinn og við hvert annað með því að teikna aðgerðaskiptiörvar.

Skilyrðin þar sem þessi umskipti eiga sér stað eru skilgreind síðar (sjá kafla 3.2.1: Stýriflæði).

Vafra um flæðiritið, draga aðgerðir
Með því að draga skákborðsbakgrunn flæðiritsins með músarbendlinum (vinstri smellur), viewport á flæðiritinu er hægt að stilla. Skrunahjól músarinnar er hægt að nota til að auka og minnka aðdrátt. Smelltu hvar sem er á aðgerð (nema úttakstengurnar, eyðahnappinn og breytahnappinn) til að velja aðgerð. Hægt er að raða aðgerðum í flæðiritið með því að draga þær með vinstri músarhnappi.

Bætir við aðgerðaskiptum

• Eins og sést á mynd 2 hefur hver aðgerð tvö „úttaksport“, sem kallast NextAction1 (NA1) og NextAction2 (NA2), sem hægt er að tengja við SeqActions sem eru framkvæmdar eftir að aðgerðinni er lokið. Til dæmisample, NextAction1 gæti verið notað til að framkvæma einhverja aðgerð ef núverandi aðgerð heppnaðist og NextAction2 gæti verið ræst ef bilun verður.
• Til að búa til aðgerðaskipti skaltu sveima músarbendilinn yfir eina af úttaksportunum, ýta á vinstri músarhnappinn og færa músarbendilinn til að draga umbreytingarör. Færðu músarbendilinn yfir inntaksportið vinstra megin við aðra SeqAction og slepptu vinstri músarhnappi til að gera tenginguna varanlega. Til að fjarlægja aðgerðaskipti, endurtaktu bara skrefin til að búa til aðgerðaskipti, en slepptu vinstri músarhnappi einhvers staðar yfir skákborðinu.
• Ef úttak (NextAction1, NextAction2) er skilið eftir ótengd, lýkur raðaranum ef þessi næsta aðgerð er ræst.
• Gakktu úr skugga um að þú tengir líka „Aðgangspunktinn“ við inntaksgátt SeqAction. Þessi SeqAction er sú fyrsta sem er keyrð um leið og röðarinn er ræstur.

Breyta og eyða aðgerðum

• SeqActions er hægt að breyta með því að smella á blýantshnappinn efst til vinstri á SeqAction. Hægt er að eyða því með því að smella á rauða krossinn efst til hægri (sjá mynd 3). Með því að eyða SeqAction er einnig fjarlægt allar aðgerðir sem koma inn og út.

SeqAction stillingar
SeqActions er hægt að stilla í gegnum flipastillingarviðmót sem er aðgengilegt í gegnum blýantshnappinn efst til vinstri á hverri aðgerð í flæðiritinu. Þetta viðmót stillir í meginatriðum innihald ActionConfiguration RAM töflunnar fyrir tiltekna aðgerð, sem samanstendur af bæði stjórnflæðistengdum stillingarvalkostum sem og kraftmiklu innihaldi skrárinnar. Innihald krafta skrárinnar er annaðhvort hægt að stilla handvirkt með fullri stjórn á hverju skráargildi (sjá kafla 3.2.3: Ítarleg útvarpsstillingar) eða í gegnum einfaldað viðmót (sjá kafla 3.2.2: Grunnstillingar útvarps). Einfaldað viðmót ætti að duga fyrir næstum öll notkunartilvik.

Stjórna flæði
Stýringarflæðisflipi (sjá mynd 4) inniheldur nokkra grunnstillingarvalkosti eins og heiti aðgerða og tímamörk aðgerða. Aðgerðarheitið er ekki aðeins notað til að birta í flæðiritinu heldur er það einnig flutt yfir í myndaða frumkóðann.

• Stýringarflæðisflipi (sjá mynd 4) inniheldur nokkra grunnstillingarvalkosti eins og heiti aðgerða og tímamörk aðgerða. Aðgerðarheitið er ekki bara notað til að birta í flæðiritinu heldur einnig flutt yfir í myndaða frumkóðann.
• Mikilvægast er að stjórnflæðisflipi stillir ástandið sem umskipti yfir í NextAction1 / NextAction2 eru háð á sem og millibili og fánum. Hægt er að stilla umbreytingarástandið með því að smella á hnappinn merktan „...“ sem gerir valgluggann fyrir grímu sem sýndur er á mynd 5 birtast. Umskiptabilið breytti eiginleikum NextAction1Interval / NextAction2Interval í vinnsluminni töflunni. Skoðaðu STM32WL3x tilvísunarhandbókina [1] fyrir frekari upplýsingar um merkingu þessa bils og mikilvægi SleepEn / ForceReload / ForceClear fánanna.
• Ennfremur er hægt að bæta við stuttri lýsingu á SeqAction kubbnum á þessum flipa. Þessi lýsing er aðeins notuð í skjalaskyni og færð yfir í myndaða frumkóðann sem athugasemd við frumkóðann.

Grunnstilling útvarps

Grunnútvarpsstillingarflipanum má skipta í þrjá hluta:

1. Hluti efst þar sem tvær af mikilvægustu færibreytum hvers kyns aðgerða eru stilltar: skipunin til að framkvæma (TX, RX, NOP, SABORT, og svo framvegis) og, ef við á, lengd pakkans sem á að flytja.
2. Hluti til vinstri þar sem raunverulegar útvarpsfæribreytur eins og: burðartíðni, gagnahraði, mótunareiginleikar, gagnamagnsþröskuldar og tímamælir eru stilltir.
3. Hluti til hægri þar sem CPU truflar er hægt að virkja sérstaklega. Truflastjórnun er myndaður fyrir hverja truflun sem merkt er við. Þetta stillir í grundvallaratriðum innihald RFSEQ_IRQ_ENABLE skrárinnar.

Sjá STM32WL3x tilvísunarhandbók [1] fyrir merkingu hinna ýmsu útvarpsfæribreyta.

Ítarleg útvarpsstilling

• Ef stillingarvalkostir sem sýndir eru í gegnum grunnútvarpsstillingaflipann (kafli 3.2.2: Grunnútvarpsstillingar) eru ófullnægjandi, gerir háþróaður STM32WL3x útvarpsstillingaflipi kleift að stilla handahófskenndu innihaldi kraftmikilla skrárinnar. Ítarlegri stillingarflipi er virkjaður með því að haka í Advanced Configuration gátreitinn efst til hægri á stillingarviðmóti flipa.
• Það er ekki hægt að nota bæði grunn- og háþróaða stillingar á sama tíma, notandinn verður að velja eina eða hina. Hins vegar er auðvitað líka hægt að breyta frumkóðanum sem myndast handvirkt eftir á og bæta við stillingarvalkostum sem hugsanlega vantar.

Alþjóðleg stillingargluggi

• Hægt er að opna gluggann „Global Project Settings“ í gegnum hnappinn „Global Settings“ á tækjastikunni. Glugginn inniheldur bæði stillingarvalkosti fyrir innihald kyrrstöðuskrárinnar sem og viðbótarverkefnastillingar. Athugaðu að aðeins er hægt að stilla lítið brot af stillingarvalkostum fyrir kyrrstöðu skrár í gegnum þennan glugga. Þessir valkostir eru aðeins veittir til að flýta fyrir frumgerð forrita með STM32CubeWiSE-RadioCodeGenerator.
• Venjulega er gert ráð fyrir að innihald kyrrstöðu skrárinnar sé sett upp í handvirkum frumkóða forritsins.
• Merking annarra verkefnastillinga er útskýrð í glugganum sjálfum.
• Viðbótar C-kóði sem er settur inn rétt áður en þú býrð til Global Configuration RAM-töfluna úr kyrrstöðuskránni gæti einnig verið veittur. Hægt er að nota þennan reit til að setja upp kyrrstöðugildi sem eru óaðgengileg í gegnum meðfylgjandi stillingargrímu fyrir kyrrstöðuskrár.

Kóða kynslóð
Hægt er að þýða flæðiritið í heilan frumkóða fyrir verkefni C með því að ýta á Búa til kóða hnappinn á tækjastikunni. Mynduð verkefnismappa inniheldur ekki verkefni files fyrir IAR, Keil® eða GCC. Þessar files verður að bæta handvirkt við STMWL3x verkefnið.
Þetta er mynduð verkefnismöppubygging:

Verkefnamappa

• hf
• SequencerFlowgraph.h: haus file fyrir SequencerFlowgraph.c, static. Ekki breyta þessu.
• stm32wl3x_hal_conf.h: STM32WL3x HAL stillingar file, kyrrstöðu.
• src
• SequencerFlowgraph.c: skilgreining flæðirits. Þetta er það mikilvæga file sem notar röðunardrifinn til að skilgreina vinnsluminnistöflurnar fyrir alþjóðlega stillingar og aðgerðastillingar. Sjálfvirk mynduð, ekki breyta.
• main.c: Aðalverkefni file sem sýnir hvernig á að hlaða og beita flæðiritsskilgreiningunni. Static, breyttu þessu eftir þörfum.
• Til að breyta main.c eða stm32wl3x_hal_conf.h skaltu velja yfirskrifahegðun Halda í verkefnastillingunum. Þannig er aðeins SequencerFlowgraph.c skrifað yfir.

Hvernig á að flytja inn myndaðan kóða inn í CubeMX tdample
Til að flytja inn verkefni sem er búið til af STM32CubeWiSE-RadioCodeGenerator í CubeMX fyrrverandiample (MRSUBG_Skeleton), er nauðsynlegt að fylgja eftirfarandi skrefum:

1. Opnaðu möppuna sem inniheldur files búið til af STM32CubeWiSE-RadioCodeGenerator og afritaðu „Inc“ og „Src“ möppur.
2. Límdu möppurnar tvær á „MRSUBG_Skeleton“ möppuna og skrifar yfir þær tvær sem þegar eru til staðar.
3. Opnaðu „MRSUBG_Skeleton“ verkefnið í einni af eftirfarandi IDE:
   • VARM
   • MDK-ARM
   • STM32CubeIDE
4. Inni í „MRSUBG_Skeleton“ verkefninu skaltu bæta við „SequencerFlowghraph.c“ file:
   • Fyrir EWARM verkefni, leiðin til að bæta við file er eftirfarandi: MRSUBG_Skeleton\Application\User
   • Fyrir MDK-ARM verkefni, leiðin til að bæta við file er eftirfarandi: MRSUBG_Skeleton\Application/User
   • Fyrir STM32CubeIDE verkefni, slóðin til að bæta við file er það sama:
     MRSUBG_Skeleton\Application\User
5. Inni í MRSUBG_Skeleton verkefninu skaltu bæta við stm32wl3x_hal_uart.c og stm32wl3x_hal_uart_ex.c files á eftirfarandi slóð: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Leiðin er sú sama fyrir alla IDE. Þau tvö files eru staðsett á Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Til að nota COM eiginleika, stm32wl3x_nucleo_conf.h file, staðsett á Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, verður að breyta stillingu USE_BSP_COM_FEATURE og USE_COM_LOG í 1U:
7. Afritaðu eftirfarandi kóða inn í „stm32wl3x_it.c“, staðsettur í MRSUBG_Skeleton\Application\User.

Flæðirit tdamples

• Fjórir fyrrvampflæðirit eru veitt við hlið frumkóðans. Þessir fyrrvampHægt er að hlaða lesum inn í STM32CubeWiSE-RadioCodeGenerator með því að smella á „Load“ hnappinn á tækjastikunni.

AutoACK_RX

• Auto-ACK kynningin sýnir hvernig tvö STM32WL3x tæki geta sjálfkrafa talað saman með lágmarks inngripi örgjörva, með hjálp röðunarvélbúnaðarins.
• Þetta flæðirit útfærir hegðun (Auto-Transmit-ACK) tækis A. Í tæki A er röðunarbúnaðurinn frumstilltur í móttökuástandi (WaitForMessage), þar sem hann bíður eftir að skilaboð berist.
• Þegar gild skilaboð hafa borist, fer röðunartækið sjálfkrafa yfir í sendingarástand (TransmitACK), þar sem ACK pakki er sendur sem svar, án inngrips CPU. Þegar þessu er lokið er röðunarkerfið endurstillt í upphaflegt WaitForMessage ástand.
• Þetta flæðirit útfærir sömu hegðun og MRSUBG_SequencerAutoAck_Rx tdample frá fyrrvamples\MRSUBG möppuna í STM32Cube WL3 hugbúnaðarpakkanum. Ef AutoACK_RX blikkar á einu tæki
  A, og AutoACK_TX blikkar á einhverju tæki, B, tækin tvö senda skilaboð fram og til baka, eins og í borðtennisleik.

AutoACK_TX

• „Auto-ACK“ kynningin sýnir hvernig tvö STM32WL3x tæki geta sjálfkrafa talað saman með lágmarks örgjörva íhlutun með hjálp röðunarvélbúnaðarins.
• Þetta flæðirit útfærir hegðun („Auto-Wait-for-ACK“) tækis B. Í tæki B er röðunarbúnaðurinn frumstilltur í sendingarástandi (TransmitMessage), þar sem hann sendir skilaboð. Þegar sendingu er lokið fer hún sjálfkrafa yfir í móttökustöðu þar sem hún bíður eftir staðfestingu frá tæki A (WaitForACK). Þegar gild staðfesting berst er röðunarkerfið endurstillt í upphaflegt SendMessage ástand og allt ferlið byrjar aftur. Ef ekkert ACK er móttekið innan 4 sekúndna, er tímamörk sett af stað og röðunarmaðurinn snýr samt aftur í TransmitMessage.
• Þetta flæðirit útfærir sömu hegðun og „MRSUBG_SequencerAutoAck_Tx“ fyrrverandiample frá fyrrvamples\MRSUBG möppuna í STM32Cube WL3 hugbúnaðarpakkanum. Ef AutoACK_RX blikkar á einu tæki, A, og AutoACK_TX blikkar á öðru tæki, B, senda tækin tvö skilaboð fram og til baka, eins og í borðtennisleik.

Hlustaðu áður en talað er (LBT)

• Þetta frvample er tekið úr STM32WL3x tilvísunarhandbókinni [1]. Skoðaðu þá handbók fyrir frekari upplýsingar um þetta frvample.

Sniff háttur

• Þetta frvample er tekið úr STM32WL3x tilvísunarhandbókinni [1]. Skoðaðu þá handbók fyrir frekari upplýsingar um þetta frvample.

Endurskoðunarsaga

Tafla 2. Endurskoðunarferill skjala

Dagsetning	Útgáfa	Breytingar
21-nóv-2024	1	Upphafleg útgáfa.
10-febrúar-2025	2	Uppfært heiti tækis í umfang STM32WL3x.

MIKILVÆG TILKYNNING - LESIÐU VARLEGA

• STMicroelectronics NV og dótturfélög þess („ST“) áskilja sér rétt til að gera breytingar, leiðréttingar, endurbætur, breytingar og endurbætur á ST vörum og/eða þessu skjali hvenær sem er án fyrirvara. Kaupendur ættu að fá nýjustu viðeigandi upplýsingar um ST vörur áður en þeir leggja inn pantanir. ST vörur eru seldar í samræmi við söluskilmála ST sem eru í gildi þegar pöntun er staðfest.
• Kaupendur bera einir ábyrgð á vali, vali og notkun ST vara og ST tekur enga ábyrgð á umsóknaraðstoð eða hönnun vöru kaupenda.
• Ekkert leyfi, óbeint eða óbeint, til nokkurs hugverkaréttar er veitt af ST hér.
• Endursala á ST vörum með öðrum ákvæðum en upplýsingarnar sem settar eru fram hér ógilda alla ábyrgð sem ST veitir fyrir slíka vöru.
• ST og ST merkið eru vörumerki ST. Frekari upplýsingar um ST vörumerki er að finna á www.st.com/trademarks. Öll önnur vöru- eða þjónustuheiti eru eign viðkomandi eigenda.
• Upplýsingar í þessu skjali koma í stað og koma í stað upplýsinga sem áður hafa verið gefnar í fyrri útgáfum þessa skjals.
• © 2025 STMicroelectronics – Allur réttur áskilinn

Algengar spurningar

• Sp.: Hverjar eru lágmarkskerfiskröfur fyrir STM32CubeWiSE-RadioCodeGenerator?
  • A: Lágmarkskerfiskröfur innihalda að minnsta kosti 2 Gbæti af vinnsluminni, USB tengi og Adobe Acrobat reader 6.0.
• Sp.: Hvernig get ég sett upp STM32CubeWiSE-RadioCodeGenerator hugbúnaðarpakkann?
  • A: Til að setja upp hugbúnaðarpakkann skaltu draga út innihald meðfylgjandi zip file inn í tímabundna möppu og ræstu keyrsluna file eftir leiðbeiningunum á skjánum.

Skjöl / auðlindir

STMicroelectronics UM3399 STM32Cube WiSE Radio Code Generator [pdfNotendahandbók UM3399, UM3399 STM32 Cube WiSE Radio Code Generator, UM3399, STM32, Cube WiSE Radio Code Generator, Radio Code Generator, Code Generator, Rafall

Heimildir

• Notendahandbók