STMicroelectronics UM3399 STM32Cube WiSE radijo kodų generatorius

Produkto naudojimo instrukcijos

• STM32CubeWiSE-RadioCodeGenerator programai reikia mažiausiai 2 Gbaitų RAM, USB prievadų ir Adobe Acrobat Reader 6.0.
• Išskleiskite stm32wise-cgwin.zip turinį file į laikiną katalogą.
• Paleiskite STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ir vykdykite ekrane pateikiamas instrukcijas.
• STM32CubeWiSE-RadioCodeGenerator SW paketas files yra suskirstyti į aplankus, įskaitant „app“ ir „examples'.
• Norėdami sukurti srauto grafiką STM32CubeWiSE-RadioCodeGenerator:
• Įtraukite SeqActions į srauto diagramą naudodami įrankių juostą arba visuotinį meniu.
• Sujunkite SeqActions su įėjimo tašku ir vienas su kitu, nubrėždami veiksmo perėjimo rodykles.
• Naršykite srauto diagramą vilkdami veiksmus ir prireikus pridėdami veiksmų perėjimų.

Įvadas

• Šiame dokumente aprašomas STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) SW paketas su STM32WL3x MRSUBG sekvencerio kodų generatoriumi.
• STM32CubeWiSE-RadioCodeGenerator yra kompiuterinė programa, naudojama kuriant srauto grafiką, kuris apibrėžia, kokius siųstuvo-imtuvo veiksmus reikia atlikti esant kokioms sąlygoms, naudojant MRSUBG sekvencerio tvarkyklę.
• STM32WL3x Sub-GHz radijas turi šį sekvencinį mechanizmą, kuris yra į būsenos mašiną panašus mechanizmas, leidžiantis autonomiškai valdyti RF perdavimą be jokio procesoriaus įsikišimo.
• Jei reikalingas procesoriaus įsikišimas, galima apibrėžti pertraukimus. Siųstuvo-imtuvo veiksmus galima išdėstyti srauto diagramoje. Šiame dokumente atskiri siųstuvo-imtuvo veiksmai vadinami SeqActions.
• Tačiau šaltinio kodas nėra geriausias srauto grafikų atvaizdas, nes jis slepia jų loginę ir laiko struktūrą.
• STM32CubeWiSE-RadioCodeGenerator išsprendžia šią problemą, pateikdamas grafinį metodą srautams kurti ir eksportuoti sugeneruotas srauto diagramas kaip C šaltinio kodą, kad būtų galima integruoti į vartotojo programas.
• Srauto grafiko apibrėžimas saugomas mikrovaldiklio RAM tokia forma:
  • ActionConfiguration RAM lentelių rinkinys, susietas viena su kita naudojant rodykles. Šios rodyklės apibrėžia SeqActions, ty veiksmo tipą (pvz.,ample, siuntimas, priėmimas, nutraukimas), taip pat SeqAction specifiniai radijo parametrai ir veiksmų perdavimo sąlygos.
  • Unikali GlobalConfiguration RAM lentelė. Tai apibrėžia srauto grafiko įvesties tašką (pirmą vykdytiną SeqAction), taip pat kai kurias numatytąsias vėliavėlės reikšmes ir bendruosius radijo parametrus.
• Radijo parametrai, kuriuos galima konfigūruoti atskirai kiekvienam SeqAction, yra saugomi viename iš dinaminių registrų, kurių turinys yra ActionConfiguration RAM lentelės dalis. Radijo ryšio parametrai, kurie yra fiksuoti per visą srauto grafiko vykdymą (nebent jie modifikuojami procesoriaus pertraukimo metu), yra saugomi statiniuose registruose, kurių turinys yra visuotinės konfigūracijos RAM lentelės dalis.

Bendra informacija

Licencijavimas
Šiame dokumente aprašoma programinė įranga, kuri veikia STM32WL3x Arm® Cortex ® -M0+ pagrindu veikiančiame mikrovaldiklyje.
Pastaba: „Arm“ yra registruotas „Arm Limited“ (arba jos dukterinių įmonių) prekės ženklas JAV ir (arba) kitur.

Susiję dokumentai

1 lentelė. Dokumentų nuorodos

Darbo pradžia

• Šiame skyriuje aprašomi visi sistemos reikalavimai norint paleisti STM32CubeWiSE-RadioCodeGenerator.
• Taip pat išsamiai aprašoma programinės įrangos paketo diegimo procedūra.

Sistemos reikalavimai
Programai STM32CubeWiSE-RadioCodeGenerator taikomi šie minimalūs reikalavimai:

• Kompiuteris su Intel® arba AMD® procesoriumi, kuriame veikia Microsoft® Windows 10 operacinė sistema
• Mažiausiai 2 GB RAM
• USB prievadai
• Adobe Acrobat Reader 6.0

STM32CubeWiSE-RadioCodeGenerator SW paketo sąranka
Atlikite šiuos veiksmus:

1. Išskleiskite stm32wise-cgwin.zip turinį file į laikiną katalogą.
2. Išskleiskite ir paleiskite STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ir vykdykite ekrane pateikiamas instrukcijas.

STM32CubeWiSE-RadioCodeGenerator SW paketas files
STM32CubeWiSE-RadioCodeGenerator SW paketas files yra suskirstyti į šiuos aplankus:

• programa: yra STM32CubeWiSE-RadioCodeGenerator.exe
• examples: šis aplankas suskirstytas į šiuos poaplankius:
• kodas: šiame aplanke yra srauto grafikai, pvzample jau eksportuotas kaip C kodas, paruoštas įterpti į programos projektą
• flowgraphs: šiame aplanke saugomi kai kurie pvzamples autonominių MRSUBG sekvencinių operacijų scenarijus

Išleidimo pastabos ir licencija files yra šakniniame aplanke.

STM32CubeWiSE-RadioCodeGenerator programinės įrangos aprašymas

• Šiame skyriuje aprašomos pagrindinės programos STM32CubeWiSE-RadioCodeGenerator funkcijos. Norėdami paleisti šią priemonę, spustelėkite piktogramą STM32CubeWiSE-RadioCodeGenerator.

Paleidus STM32CubeWiSE-RadioCodeGenerator, pasirodo pagrindinis programos langas. Jį sudaro:

• Visuotinis meniu ir įrankių juosta
• Vaizdinis srauto grafiko nuvilkimas
• SeqAction konfigūracijos skyrius (matomas tik tuo atveju, jei SeqAction šiuo metu redaguojamas)

Srauto grafiko kūrimas
Pagrindai
Srauto grafikai sudaromi dviem etapais:

1. Pridėkite SeqActions į srauto grafiką. Tai galima padaryti naudojant mygtuką „Pridėti veiksmą“ įrankių juostoje, naudojant visuotinį meniu (Redaguoti → Pridėti veiksmą) arba naudojant spartųjį klavišą „Ctrl+A“.
2. Sujunkite SeqActions su įėjimo tašku ir vienas su kitu, nubrėždami veiksmo perėjimo rodykles.

Sąlygos, kurioms esant šie perėjimai įvyksta, yra apibrėžtos vėliau (žr. 3.2.1 skyrių: Valdymo srautas).

Naršymas srauto diagramoje, veiksmų vilkimas
Pelės žymekliu vilkdami srauto diagramos šaškių lentelę (spustelėkite kairiuoju pelės klavišu), viewsrauto grafiko prievadą galima reguliuoti. Pelės slinkties ratukas gali būti naudojamas priartinti ir nutolinti. Norėdami pasirinkti veiksmą, spustelėkite bet kurią veiksmo vietą (išskyrus išvesties prievadus, trynimo mygtuką ir redagavimo mygtuką). Veiksmus galima išdėstyti srauto diagramoje, vilkdami juos kairiuoju pelės mygtuku.

Veiksmų perėjimų pridėjimas

• Kaip parodyta 2 paveiksle, kiekvienas veiksmas turi du „išvesties prievadus“, vadinamus „NextAction1“ (NA1) ir „NextAction2“ (NA2), kuriuos galima prijungti prie „SeqActions“, kurie vykdomi po to, kai veiksmas yra baigtas. Pavyzdžiui,ample, „NextAction1“ gali būti naudojamas tam tikram veiksmui atlikti, jei dabartinis veiksmas buvo sėkmingas, o „NextAction2“ gali būti suaktyvintas nesėkmės atveju.
• Norėdami sukurti veiksmo perėjimą, užveskite pelės žymeklį ant vieno iš išvesties prievadų, paspauskite kairįjį pelės mygtuką ir perkelkite pelės žymeklį, kad vilktumėte perėjimo rodyklę. Perkelkite pelės žymeklį ant įvesties prievado, esančio kito SeqAction kairėje, ir atleiskite kairįjį pelės mygtuką, kad ryšys būtų nuolatinis. Norėdami pašalinti veiksmo perėjimą, tiesiog pakartokite veiksmo perėjimo kūrimo veiksmus, bet atleiskite kairįjį pelės mygtuką kur nors virš šaškių lentos fono.
• Jei išvestis (NextAction1, NextAction2) paliekama neprijungta, sekvencinė nutrūksta, jei suaktyvinamas šis kitas veiksmas.
• Taip pat būtinai prijunkite „Entry Point“ prie kurio nors „SeqAction“ įvesties prievado. Šis „SeqAction“ veiksmas yra pirmasis, kuris įvykdomas, kai tik suaktyvinamas sekvencinis veiksmas.

Veiksmų redagavimas ir trynimas

• SeqActions galima redaguoti spustelėjus pieštuko mygtuką viršutiniame kairiajame SeqAction kampe. Jį galima ištrinti spustelėjus raudoną kryžiuką viršutiniame dešiniajame kampe (žr. 3 pav.). Ištrynus SeqAction taip pat pašalinami visi gaunami ir išeinantys veiksmo perėjimai.

SeqAction konfigūracija
SeqActions galima konfigūruoti naudojant skirtukų konfigūravimo sąsają, pasiekiamą per pieštuko mygtuką, esantį kiekvieno veiksmo viršutiniame kairiajame srauto grafike. Ši sąsaja iš esmės konfigūruoja ActionConfiguration RAM lentelės turinį konkrečiam veiksmui, kurį sudaro ir su valdymo srautu susijusios konfigūracijos parinktys, ir dinaminio registro turinys. Dinaminio registro turinį galima konfigūruoti rankiniu būdu visiškai valdant kiekvieną registro reikšmę (žr. 3.2.3 skyrių: Išplėstinė radijo konfigūracija) arba naudojant supaprastintą sąsają (žr. 3.2.2 skyrių: Pagrindinė radijo konfigūracija). Supaprastintos sąsajos turėtų pakakti beveik visais naudojimo atvejais.

Kontroliuoti srautą
Valdymo srauto skirtuke (žr. 4 pav.) yra keletas pagrindinių konfigūracijos parinkčių, tokių kaip veiksmo pavadinimas ir veiksmo skirtojo laiko intervalas. Veiksmo pavadinimas naudojamas ne tik rodyti srauto diagramoje, bet ir perkeliamas į sugeneruotą šaltinio kodą.

• Valdymo srauto skirtuke (žr. 4 pav.) yra keletas pagrindinių konfigūracijos parinkčių, tokių kaip veiksmo pavadinimas ir veiksmo skirtojo laiko intervalas. Veiksmo pavadinimas naudojamas ne tik rodyti srauto diagramoje, bet ir perkeliamas į sugeneruotą šaltinio kodą.
• Svarbiausia, kad valdymo srauto skirtukas sukonfigūruoja sąlygą, nuo kurios priklauso perėjimas prie NextAction1 / NextAction2, taip pat perėjimo intervalą ir vėliavėles. Perėjimo sąlygą galima sukonfigūruoti spustelėjus mygtuką, pažymėtą „…“, kuris atvers 5 pav. parodytą kaukės pasirinkimo dialogą. Perėjimo intervalas pakeitė RAM lentelės ypatybę NextAction1Interval / NextAction2Interval. Daugiau informacijos apie šio intervalo reikšmę ir SleepEn / ForceReload / ForceClear vėliavėlių reikšmę žr. STM32WL3x informaciniame vadove [1].
• Be to, šiame skirtuke galima pridėti trumpą SeqAction bloko aprašymą. Šis aprašas naudojamas tik dokumentacijos tikslais ir perkeliamas į sugeneruotą šaltinio kodą kaip šaltinio kodo komentaras.

Pagrindinė radijo konfigūracija

Pagrindinės radijo konfigūracijos skirtukas gali būti suskirstytas į tris dalis:

1. Viršuje esanti skiltis, kurioje sukonfigūruojami du svarbiausi bet kokio veiksmo parametrai: vykdoma komanda (TX, RX, NOP, SABORT ir t. t.) ir, jei taikoma, perduodamo paketo ilgis.
2. Skyrius kairėje, kuriame sukonfigūruojami tikrieji radijo parametrai, tokie kaip: nešlio dažnis, duomenų perdavimo sparta, moduliavimo savybės, duomenų buferio slenksčiai ir laikmačiai.
3. Dešinėje esantį skyrių, kuriame CPU pertraukia, galima įjungti atskirai. Kiekvienam pažymėtam pertraukimui sugeneruojamas pertraukimų tvarkytuvas. Tai iš esmės sukonfigūruoja RFSEQ_IRQ_ENABLE registro turinį.

Įvairių radijo parametrų reikšmes rasite STM32WL3x informaciniame vadove [1].

Išplėstinė radijo konfigūracija

• Jei pagrindinės radijo konfigūracijos skirtuke pateiktų konfigūravimo parinkčių (3.2.2 skirsnis: Pagrindinė radijo konfigūracija) nepakanka, išplėstinės STM32WL3x radijo konfigūracijos skirtukas leidžia nustatyti savavališką dinaminio registro turinį. Išplėstinės konfigūracijos skirtukas įgalinamas pažymėjus žymimąjį laukelį Išplėstinė konfigūracija skirtukų konfigūracijos sąsajos viršuje, dešinėje.
• Neįmanoma vienu metu naudoti ir pagrindinės, ir išplėstinės konfigūracijos, vartotojas turi pasirinkti vieną ar kitą. Tačiau, žinoma, vėliau galima rankiniu būdu redaguoti sugeneruotą šaltinio kodą ir pridėti galimai trūkstamas konfigūracijos parinktis.

Visuotinis konfigūracijos dialogas

• Dialogo langą „Visuotiniai projekto nustatymai“ galima pasiekti per įrankių juostos mygtuką „Visuotiniai nustatymai“. Dialogo lange yra tiek statinio registro turinio konfigūracijos parinktys, tiek papildomi projekto parametrai. Atminkite, kad šiame dialogo lange galima konfigūruoti tik nedidelę statinio registro konfigūravimo parinkčių dalį. Šios parinktys pateikiamos tik norint pagreitinti programų prototipų kūrimą naudojant STM32CubeWiSE-RadioCodeGenerator.
• Paprastai tikimasi, kad statinio registro turinys bus nustatytas rankiniu būdu įrašytame programos šaltinio kode.
• Kitų projekto parametrų reikšmė paaiškinama pačiame dialogo lange.
• Taip pat gali būti pateiktas papildomas C kodas, kuris įterpiamas prieš pat kuriant visuotinės konfigūracijos RAM lentelę iš statinio registro turinio. Šis laukas gali būti naudojamas statinėms registro reikšmėms, kurios nepasiekiamos naudojant pateiktą statinio registro konfigūracijos kaukę, nustatyti.

Kodo generavimas
Srauto grafiką galima išversti į pilną projekto C šaltinio kodą paspaudus įrankių juostoje esantį mygtuką Generuoti kodą. Sukurtame projekto aplanke projekto nėra files IAR, Keil® arba GCC. Šios files turi būti rankiniu būdu įtrauktos į STMWL3x projektą.
Tai sugeneruota projekto aplanko struktūra:

Projekto aplankas

• inc
• SequencerFlowgraph.h: antraštė file SequencerFlowgraph.c, statinis. Neredaguokite šio.
• stm32wl3x_hal_conf.h: STM32WL3x HAL konfigūracija file, statinis.
• src
• SequencerFlowgraph.c: srauto diagramos apibrėžimas. Tai yra svarbiausia file kuri naudoja sekos tvarkyklę, kad nustatytų visuotinės konfigūracijos ir veiksmų konfigūracijos RAM lenteles. Sukurta automatiškai, neredaguoti.
• main.c: Projekto pagrindinis file kuri parodo, kaip įkelti ir taikyti srauto grafiko apibrėžimą. Statinis, jei reikia, pakeiskite.
• Norėdami redaguoti main.c arba stm32wl3x_hal_conf.h, projekto nustatymuose pasirinkite perrašymo elgseną Keep. Tokiu būdu perrašoma tik SequencerFlowgraph.c.

Kaip importuoti sugeneruotą kodą į CubeMX example
Norėdami importuoti STM32CubeWiSE-RadioCodeGenerator sugeneruotą projektą į CubeMX example (MRSUBG_Skeleton), būtina atlikti šiuos veiksmus:

1. Atidarykite aplanką, kuriame yra files sugeneravo STM32CubeWiSE-RadioCodeGenerator ir nukopijuokite „Inc“ ir „Src“ aplankus.
2. Įklijuokite du aplankus į aplanką „MRSUBG_Skeleton“, perrašydami du jau esančius.
3. Atidarykite projektą „MRSUBG_Skeleton“ vienoje iš šių IDE:
   • ŠILTAS
   • MDK-ARM
   • STM32CubeIDE
4. Projekte „MRSUBG_Skeleton“ pridėkite „SequencerFlowghraph.c“ file:
   • EWARM projekto atveju kelias, kuriuo reikia pridėti file yra toks: MRSUBG_Skeleton\Application\User
   • MDK-ARM projekto atveju kelias, kuriuo reikia pridėti file yra toks: MRSUBG_Skeleton\Application/User
   • STM32CubeIDE projektui – kelias, kuriuo reikia pridėti file yra tas pats:
     MRSUBG_Skeletas\Application\User
5. Projekte MRSUBG_Skeleton pridėkite stm32wl3x_hal_uart.c ir stm32wl3x_hal_uart_ex.c files į šį kelią: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Kelias yra vienodas visoms IDE. Du files yra Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Norėdami naudoti COM funkcijas, stm32wl3x_nucleo_conf.h file, esantis Firmware\Projects\NUCLEOWL33CC\Examples\MRSUBG\MRSUBG_Skeleton\Inc, reikia pakeisti nustatant USE_BSP_COM_FEATURE ir USE_COM_LOG į 1U:
7. Nukopijuokite šį kodą į „stm32wl3x_it.c“, esantį MRSUBG_Skeleton\Application\User.

Flowgraph examples

• Keturi buvęample flowgraphs pateikiami kartu su šaltinio kodu. Šie buvęamples galima įkelti į STM32CubeWiSE-RadioCodeGenerator įrankių juostoje spustelėjus mygtuką „Įkelti“.

AutoACK_RX

• „Auto-ACK“ demonstracinė versija iliustruoja, kaip du STM32WL3x įrenginiai gali automatiškai susikalbėti vienas su kitu su minimaliu procesoriaus įsikišimu, naudojant sekvencinę aparatinę įrangą.
• Šis srauto grafikas įgyvendina įrenginio A elgseną (Auto-Transmit-ACK). Įrenginyje A sekvencinė inicijuojama priėmimo būsenoje (WaitForMessage), kurioje laukiama pranešimo.
• Kai tik gaunamas tinkamas pranešimas, sekvencinis įrenginys automatiškai pereina į perdavimo būseną (TransmitACK), kurioje ACK paketas siunčiamas kaip atsakas, be procesoriaus įsikišimo. Kai tai bus baigta, sekvencinė būsena iš naujo nustatoma į pradinę WaitForMessage būseną.
• Šis srauto grafikas veikia taip pat, kaip ir MRSUBG_SequencerAutoAck_Rx example iš buvusioampSTM32Cube WL3 programinės įrangos paketo aplankas les\MRSUBG. Jei „AutoACK_RX“ mirksi viename įrenginyje
  A ir AutoACK_TX yra mirksi kai kuriuose įrenginiuose, B, abu įrenginiai siunčia pranešimus pirmyn ir atgal, kaip stalo teniso žaidime.

AutoACK_TX

• „Auto-ACK“ demonstracinė versija iliustruoja, kaip du STM32WL3x įrenginiai gali automatiškai susikalbėti vienas su kitu su minimaliu procesoriaus įsikišimu, naudodami sekvencinės aparatinę įrangą.
• Šis srauto grafikas įgyvendina įrenginio B elgseną („Auto-Wait-for-ACK“). Įrenginyje B sekvencija inicijuojama perdavimo būsenoje (TransmitMessage), kurioje perduoda pranešimą. Kai siuntimas baigtas, jis automatiškai pereina į priėmimo būseną, kur laukia patvirtinimo iš įrenginio A (WaitForACK). Kai gaunamas galiojantis patvirtinimas, sekvencinė sistema iš naujo nustatoma į pradinę TransmitMessage būseną ir visas procesas prasideda iš naujo. Jei per 4 sekundes negaunamas ACK, suveikia skirtasis laikas ir sekvencinė programa vis tiek grįžta į TransmitMessage būseną.
• Šis srauto grafikas veikia taip pat, kaip ir „MRSUBG_SequencerAutoAck_Tx“, pvzample iš buvusioampSTM32Cube WL3 programinės įrangos paketo aplankas les\MRSUBG. Jei AutoACK_RX mirksi viename įrenginyje, A ir AutoACK_TX kitame įrenginyje, B, abu įrenginiai siunčia pranešimus pirmyn ir atgal, kaip žaidžiant stalo tenisą.

Klausykite prieš kalbėdami (LBT)

• Šis buvęsample paimtas iš STM32WL3x informacinio vadovo [1]. Daugiau informacijos apie šį example.

Uostymo režimas

• Šis buvęsample paimtas iš STM32WL3x informacinio vadovo [1]. Daugiau informacijos apie šį example.

Revizijų istorija

2 lentelė. Dokumento taisymo istorija

SVARBI PRANEŠIMAS – ATIDŽIAI SKAITYKITE

• STMicroelectronics NV ir jos dukterinės įmonės („ST“) pasilieka teisę bet kuriuo metu be įspėjimo keisti, taisyti, patobulinti, modifikuoti ir tobulinti ST gaminius ir (arba) šį dokumentą. Prieš pateikdami užsakymą pirkėjai turėtų gauti naujausią atitinkamą informaciją apie ST gaminius. ST gaminiai parduodami pagal ST pardavimo sąlygas, galiojančias užsakymo patvirtinimo metu.
• Pirkėjai yra išimtinai atsakingi už ST gaminių pasirinkimą, pasirinkimą ir naudojimą, o ST neprisiima jokios atsakomybės už pagalbą taikant ar pirkėjų gaminių dizainą.
• ST nesuteikia jokios tiesioginės ar numanomos licencijos jokioms intelektinės nuosavybės teisėms.
• Perpardavus ST gaminius, kurių nuostatos skiriasi nuo čia pateiktos informacijos, panaikina bet kokią ST tokiam produktui suteiktą garantiją.
• ST ir ST logotipas yra ST prekių ženklai. Daugiau informacijos apie ST prekių ženklus rasite www.st.com/trademarks. Visi kiti produktų ar paslaugų pavadinimai yra atitinkamų savininkų nuosavybė.
• Informacija šiame dokumente pakeičia ir pakeičia informaciją, anksčiau pateiktą bet kokiose ankstesnėse šio dokumento versijose.
• © 2025 STMicroelectronics – Visos teisės saugomos

DUK

• Kl.: Kokie yra minimalūs sistemos reikalavimai STM32CubeWiSE-RadioCodeGenerator?
  • A: Minimalūs sistemos reikalavimai apima bent 2 Gbaitus RAM, USB prievadus ir „Adobe Acrobat Reader 6.0“.
• K: Kaip galiu nustatyti STM32CubeWiSE-RadioCodeGenerator programinės įrangos paketą?
  • A: Norėdami nustatyti programinės įrangos paketą, išskleiskite pateikto ZIP turinį file į laikinąjį katalogą ir paleiskite vykdomąjį failą file vadovaudamiesi ekrane pateikiamomis instrukcijomis.

Dokumentai / Ištekliai

STMicroelectronics UM3399 STM32Cube WiSE radijo kodų generatorius [pdf] Naudotojo vadovas UM3399, UM3399 STM32 Cube WiSE radijo kodų generatorius, UM3399, STM32, Cube WiSE radijo kodų generatorius, radijo kodų generatorius, kodų generatorius, generatorius

Nuorodos

• Vartotojo vadovas