STMicroelectronics UM3399 STM32Cube WiSE Radiokodgeneratoro

Produktaj Uzado-Instrukcioj

• La aplikaĵo STM32CubeWiSE-RadioCodeGenerator postulas almenaŭ 2 Gbajtojn da RAM, USB-pordojn kaj Adobe Acrobat Reader 6.0.
• Eltiru la enhavon de la stm32wise-cgwin.zip file en provizoran dosierujon.
• Lanĉu la dosieron STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file kaj sekvu la surekranajn instrukciojn.
• La programara pakaĵo STM32CubeWiSE-RadioCodeGenerator fileoj estas organizitaj en dosierujojn inkluzive de 'app' kaj 'ex'amples'.
• Por konstrui fludiagramon en STM32CubeWiSE-RadioCodeGenerator:
• Aldonu SeqActions al la fludiagramo uzante la ilobreton aŭ tutmondan menuon.
• Konekti SeqActions al la enirejo kaj unu al la alia per desegnado de agtransiraj sagoj.
• Navigu la fluan grafeon trenante agojn kaj aldonante agajn transirojn laŭbezone.

Enkonduko

• Ĉi tiu dokumento priskribas la programaran pakaĵon STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) kun la sekvencila kodgenerilo STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator estas komputila aplikaĵo uzata por konstrui flugrafon kiu difinas kiujn ricevil-agojn plenumi sub kiuj kondiĉoj, uzante la sekvencilpelilon MRSUBG.
• La sub-GHz-radio STM32WL3x enhavas ĉi tiun sekvencilon, kiu estas statmaŝin-simila mekanismo, kiu ebligas aŭtonoman administradon de RF-translokigoj, sen ia bezono de CPU-interveno.
• Se necesas interveno de la CPU, interrompoj povas esti difinitaj. Sendricevilaj agoj povas esti aranĝitaj en fluografo. En ĉi tiu dokumento, la individuaj sendricevilaj agoj estas nomataj SeqActions.
• Tamen, fontkodo ne estas la plej bona prezento por flugrafoj, ĉar ĝi kaŝas ilian logikan kaj tempan strukturon.
• STM32CubeWiSE-RadioCodeGenerator traktas ĉi tiun problemon provizante grafikan metodon por konstrui flugrafojn kaj poste eksportante la generitajn flugrafojn kiel C-fontkodon por integriĝo en uzantajn aplikojn.
• La difino de la flugrafo estas stokita en la RAM-memoro de la mikroregilo en la formo de:
  • Aro de RAM-tabeloj ActionConfiguration, ligitaj unu al la alia per montriloj. Ĉi tiuj montriloj difinas la SeqActions, tio estas, la tipon de ago (ekz.ample, dissendo, ricevo, ĉesigo), same kiel SeqAction-specifaj radioparametroj kaj kondiĉoj por agdissendoj.
  • Unika tabelo de Tutmonda Agordo RAM. Ĉi tio difinas la enirejon de la flugrafo (la unua SeqAction efektivigota), kaj ankaŭ kelkajn defaŭltajn flagvalorojn kaj komunajn radioparametrojn.
• Radioparametroj, kiuj povas esti agorditaj individue por ĉiu SeqAction, estas konservitaj en unu el la dinamikaj registroj, kies enhavo estas parto de la ActionConfiguration RAM-tabelo. Radioparametroj, kiuj estas fiksitaj dum la tuta plenumo de la fludiagramo (krom se ili estas modifitaj dum CPU-interrompo), estas konservitaj en statikaj registroj, kies enhavo estas parto de la tutmonda agorda RAM-tabelo.

Ĝenerala informo

Licencado
Ĉi tiu dokumento priskribas programaron, kiu funkcias sur la STM32WL3x Arm® Cortex ® -M0+ mikroregilo.
Notu: Arm estas registrita varmarko de Arm Limited (aŭ ĝiaj filioj) en Usono kaj/aŭ aliloke.

Rilataj dokumentoj

Tablo 1. Dokumentaj referencoj

Numero	Referenco	Titolo
[1]	RM0511	STM32WL30xx/31xx/33xx Arm®-bazitaj sub-GHz mikrokontroliloj

Komencante

• Ĉi tiu sekcio priskribas ĉiujn sistemajn postulojn por funkciigi STM32CubeWiSE-RadioCodeGenerator.
• Ĝi ankaŭ detaligas la proceduron por instali programarpakaĵon.

Sistempostuloj
La aplikaĵo STM32CubeWiSE-RadioCodeGenerator havas la jenajn minimumajn postulojn:

• Komputilo kun procesoro Intel® aŭ AMD® funkcianta per la operaciumo Microsoft® Windows 10
• Almenaŭ 2 Gbajtoj da RAM
• USB-havenoj
• Adobe Acrobat Reader 6.0

Agordo de la programara pakaĵo STM32CubeWiSE-RadioCodeGenerator
Plenumu la jenajn paŝojn:

1. Eltiru la enhavon de la stm32wise-cgwin.zip file en provizoran dosierujon.
2. Eltiru kaj lanĉu la STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe-dosieron file kaj sekvu la surekranajn instrukciojn.

STM32CubeWiSE-RadioCodeGenerator programara pakaĵo files
La programara pakaĵo STM32CubeWiSE-RadioCodeGenerator fileoj estas organizitaj en la jenajn dosierujojn:

• aplikaĵo: enhavas STM32CubeWiSE-RadioCodeGenerator.exe
• exampdosierujoj: ĉi tiu dosierujo estas organizita en la jenajn subdosierujojn:
• kodo: ĉi tiu dosierujo enhavas la fludiagramojn ekz.ampjam eksportita kiel C-kodo, preta por esti injektita en aplikaĵan projekton
• fludiagramoj: ĉi tiu dosierujo konservas iujn ekz.ampmalpli scenaroj de aŭtonomaj operacioj de MRSUBG-sekvencilo

Eldonnotoj kaj licenco files troviĝas en la radika dosierujo.

Priskribo de la programaro STM32CubeWiSE-RadioCodeGenerator

• Ĉi tiu sekcio priskribas la ĉefajn funkciojn de la aplikaĵo STM32CubeWiSE-RadioCodeGenerator. Por lanĉi ĉi tiun ilon, alklaku la ikonon STM32CubeWiSE-RadioCodeGenerator.

Post lanĉo de STM32CubeWiSE-RadioCodeGenerator, aperas la ĉefa aplikaĵa fenestro. Ĝi konsistas el:

• Tutmonda menuo kaj ilobreto
• La vida tren-kaj-faliga prezento de la flugrafo
• La agorda sekcio de SeqAction (videbla nur se SeqAction estas nuntempe redaktata)

Konstruante fludiagramon
Bazoj
Fluografoj estas konstruitaj en du paŝoj:

1. Aldonu Sekvencagojn al la fludiagramo. Tio povas esti farita per la butono "Aldoni Agon" en la ilobreto, per la tutmonda menuo (Redakti → Aldoni Agon) aŭ per la fulmoklavo "Ctrl+A".
2. Konekti SeqActions al la enirejo kaj unu al la alia per desegnado de agtransiraj sagoj.

La kondiĉoj sub kiuj tiuj transiroj okazas estas difinitaj poste (vidu Sekcion 3.2.1: Kontrolfluo).

Navigado tra la fluografo, trenado de agoj
Trenante la ŝaktabulan fonon de la fludiagramo per la musmontrilo (maldekstra klako), la viewhaveno sur la fludiagramo povas esti agordita. La musrulumrado povas esti uzata por zomi enen kaj eksteren. Alklaku ie ajn sur ago (krom la eliraj havenoj, la foriga butono kaj la redakta butono) por elekti agon. Agoj povas esti aranĝitaj en la fludiagramo trenante ilin per la maldekstra musbutono.

Aldonante agtransirojn

• Kiel montrite en Figuro 2, ĉiu ago havas du "eligajn pordojn", nomitajn SekvaAgo1 (NA1) kaj SekvaAgo2 (NA2), kiuj povas esti konektitaj al Sekvencaj Agoj, kiuj estas plenumitaj post kiam la ago estas kompletigita. Ekzempleampekzemple, SekvaAgo1 povus esti uzata por plenumi iun agon se la aktuala ago estus sukcesa kaj SekvaAgo2 povus esti ekigita en kazo de malsukceso.
• Por krei agan transiron, ŝvebigu la musmontrilon super unu el la eliraj pordoj, premu la maldekstran musbutonon kaj movu la musmontrilon por treni transiran sagon. Movu la musmontrilon super la eniran pordon maldekstre de iu alia SeqAction kaj liberigu la maldekstran musbutonon por igi la konekton permanenta. Por forigi agan transiron, simple ripetu la paŝojn por krei agan transiron, sed liberigu la maldekstran musbutonon ie super la ŝaktabula fono.
• Se eligo (SekvaAgo1, SekvaAgo2) restas nekonektita, la sekvencilo finiĝas se ĉi tiu sekva ago estas ekigita.
• Certigu ankaŭ konekti la "Enirejan Punkton" al iu eniga pordo de SeqAction. Ĉi tiu SeqAction estas la unua efektivigota tuj kiam la sekvencilo estas ekigita.

Redaktado kaj forigo de agoj

• Sekvenc-Agoj povas esti redaktataj per klakado sur la krajonbutono supre maldekstre de Sekvenc-Ago. Ĝi povas esti forigita per klakado sur la ruĝa kruco supre dekstre (vidu Figuron 3). Forigo de Sekvenc-Ago ankaŭ forigas ĉiujn alvenantajn kaj elirantajn agajn transirojn.

Agordo de SeqAction
SeqActions povas esti agorditaj per langeta agorda interfaco alirebla per la krajona butono supre maldekstre de ĉiu ago en la fludiagramo. Ĉi tiu interfaco esence agordas la enhavon de la RAM-tabelo ActionConfiguration por la specifa ago, konsistante kaj el la agordaj opcioj rilataj al la stirfluo kaj la dinamika registro-enhavo. La dinamika registro-enhavo povas esti agordita aŭ permane kun kompleta kontrolo super ĉiu registro-valoro (vidu Sekcion 3.2.3: Altnivela radio-agordo) aŭ per simpligita interfaco (vidu Sekcion 3.2.2: Baza radio-agordo). La simpligita interfaco devus sufiĉi por preskaŭ ĉiuj uzkazoj.

Kontrolfluo
La langeto pri kontrola fluo (vidu Figuron 4) enhavas kelkajn bazajn agordajn opciojn kiel ekzemple la nomon de la ago kaj la tempolimon de la ago. La nomo de la ago ne nur estas uzata por montriĝo en la fluodiagramo, sed ankaŭ transdoniĝas al la generita fontkodo.

• La langeto pri kontrola fluo (vidu Figuron 4) enhavas kelkajn bazajn agordajn opciojn kiel ekzemple la nomon de la ago kaj la tempolimon de la ago. La nomo de la ago ne nur estas uzata por montriĝo en la fluodiagramo, sed ankaŭ transdonita al la generita fontkodo.
• Plej grave, la langeto pri kontrola fluo agordas la kondiĉon, de kiu dependas transiro al SekvaAgo1 / SekvaAgo2, same kiel la transiran intervalon kaj flagojn. La transira kondiĉo povas esti agordita per alklako de la butono etikedita "...", kiu aperigas la dialogon pri masko-elekto montritan en Figuro 5. La transira intervalo modifis la econ SekvaAgo1Intervalo / SekvaAgo2Intervalo de la RAM-tabelo. Vidu la referencan manlibron de STM32WL3x [1] por pliaj informoj pri la signifo de ĉi tiu intervalo kaj la signifo de la flagoj SleepEn / ForceReload / ForceClear.
• Krome, mallonga priskribo de la bloko SeqAction povas esti aldonita sur ĉi tiu langeto. Ĉi tiu priskribo estas uzata nur por dokumentaj celoj kaj transdonita al la generita fontkodo kiel komento pri la fontkodo.

Baza radiokonfiguracio

La langeto pri baza radioagordo povas esti subdividita en tri partojn:

1. Sekcio supre kie du el la plej gravaj parametroj de iu ajn ago estas agorditaj: la plenumota komando (TX, RX, NOP, SABORT, kaj tiel plu) kaj, se aplikeble, la longo de la transdonota pakaĵo.
2. Sekcio maldekstre kie la faktaj radioparametroj kiel: portantofrekvenco, datenrapideco, moduladaj ecoj, datenbufraj sojloj kaj tempigiloj estas agorditaj.
3. Sekcio dekstre kie la CPU-interrompoj povas esti individue ebligitaj. Interrompotraktilo estas generita por ĉiu el la markitaj interrompoj. Ĉi tio esence agordas la enhavon de la registro RFSEQ_IRQ_ENABLE.

Vidu la referencmanlibron de STM32WL3x [1] por la signifo de la diversaj radioparametroj.

Altnivela radiokonfiguracio

• Se la agordaj opcioj montritaj per la langeto "baza radioagordo" (Sekcio 3.2.2: Baza radioagordo) ne sufiĉas, la langeto "altnivela radioagordo" de STM32WL3x permesas agordi arbitrajn dinamikajn registro-enhavojn. La langeto "altnivela agordo" estas ebligita per markado de la markobutono "Altnivela Agordo" supre dekstre de la langeta agorda interfaco.
• Ne eblas uzi kaj bazajn kaj progresintajn agordojn samtempe, la uzanto devas elekti unu aŭ la alian. Tamen, kompreneble ankaŭ eblas mane redakti la generitan fontkodon poste kaj aldoni eble mankantajn agordajn opciojn.

Tutmonda agorda dialogo

• La dialogo "Tutmondaj Projektaj Agordoj" estas alirebla per la ilobreta butono "Tutmondaj Agordoj". La dialogo enhavas kaj agordajn opciojn por la enhavo de la statika registro kaj ankaŭ pliajn projektajn agordojn. Notu, ke nur malgranda parto de la agordaj opcioj por la statika registro povas esti agorditaj per ĉi tiu dialogo. Ĉi tiuj opcioj estas provizitaj nur por rapidigi prototipajn aplikaĵojn per STM32CubeWiSE-RadioCodeGenerator.
• Kutime oni atendas, ke la enhavo de la statika registro estas agordita en la mane skribita fontkodo de la aplikaĵo.
• La signifo de la aliaj projektaj agordoj estas klarigita en la dialogo mem.
• Plia C-kodo, kiu estas enigita ĝuste antaŭ la kreado de la tabelo de Tutmonda Agorda RAM el la enhavo de la statika registro, ankaŭ povas esti provizita. Ĉi tiu kampo povas esti uzata por agordi statikajn registrovalorojn, kiuj estas neatingeblaj per la provizita statika registro-agorda masko.

Kodgenerado
La fludiagramo povas esti tradukita en kompletan projektan C-fontkodon premante la butonon Generi Kodon en la ilobreto. La generita projekta dosierujo ne enhavas projektajn datumojn. files por IAR, Keil®, aŭ GCC. Ĉi tiuj files devas esti aldonitaj permane al la STMWL3x-projekto.
Jen la generita strukturo de la dosierujoj de la projekto:

Projekto dosierujo

• inc
• SequencerFlowgraph.h: kaplinio file por SequencerFlowgraph.c, statika. Ne redaktu ĉi tion.
• stm32wl3x_hal_conf.h: STM32WL3x HAL-agordo file, statika.
• src
• SequencerFlowgraph.c: difino de fluografo. Jen la grava file kiu uzas la sekvencilan pelilon por difini la tabelojn de tutmonda agordo kaj ago-agordo de la RAM. Aŭtomate generita, ne redaktu.
• main.c: Projekto main file tio montras kiel ŝargi kaj apliki la difinon de fluografo. Statika, modifu ĉi tion laŭbezone.
• Por redakti main.c aŭ stm32wl3x_hal_conf.h, elektu la anstataŭigan konduton "Konservu" en la projektaj agordoj. Tiel, nur SequencerFlowgraph.c estos anstataŭigita.

Kiel importi generitan kodon en CubeMX example
Por importi projekton generitan de STM32CubeWiSE-RadioCodeGenerator en CubeMX-eksanample (MRSUBG_Skeleton), necesas sekvi la jenajn paŝojn:

1. Malfermu la dosierujon enhavantan la files generitaj de STM32CubeWiSE-RadioCodeGenerator kaj kopii la dosierujojn "Inc" kaj "Src".
2. Algluu la du dosierujojn en la dosierujon "MRSUBG_Skeleton", anstataŭigante la du jam ĉeestantajn.
3. Malfermu la projekton “MRSUBG_Skeleton” en unu el la jenaj IDE-oj:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Ene de la projekto “MRSUBG_Skeleton”, aldonu la dosieron “SequencerFlowghraph.c” file:
   • Por EWARM-projekto, la vojo por aldoni la file estas la jena: MRSUBG_Skeleton\Application\User
   • Por MDK-ARM-projekto, la vojo por aldoni la file estas la jena: MRSUBG_Skeleton\Application/User
   • Por STM32CubeIDE-projekto, la vojo por aldoni la file estas la sama:
     MRSUBG_Skeleto\Aplikaĵo\Uzanto
5. Ene de la projekto MRSUBG_Skeleton, aldonu stm32wl3x_hal_uart.c kaj stm32wl3x_hal_uart_ex.c files al la sekva vojo: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. La vojo estas la sama por ĉiuj IDE-oj. La du files troviĝas en Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Por uzi COM-funkciojn, stm32wl3x_nucleo_conf.h file, situanta sur Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, devas esti modifita agordante USE_BSP_COM_FEATURE kaj USE_COM_LOG al 1U:
7. Kopiu la jenan kodon en "stm32wl3x_it.c", kiu troviĝas en MRSUBG_Skeleton\Application\User.

Fludiagramo ekz.amples

• Kvar eks-ampFludiagramoj estas provizitaj kune kun la fontkodo. Ĉi tiuj ekzemplerojampDosieroj povas esti ŝargitaj en STM32CubeWiSE-RadioCodeGenerator alklakante la butonon "Ŝargi" en la ilobreto.

Aŭtomata ACK_RX

• La demonstraĵo de Auto-ACK ilustras kiel du STM32WL3x-aparatoj povas aŭtomate komuniki unu kun la alia kun minimuma CPU-interveno, helpe de la sekvencila aparataro.
• Ĉi tiu fludiagramo realigas la konduton (Aŭtomata-Transsendo-ACK) de aparato A. En aparato A, la sekvencilo estas inicialigita en ricevanta stato (AtenduMesaĝon), en kiu ĝi atendas la alvenon de mesaĝo.
• Kiam valida mesaĝo alvenas, la sekvencilo aŭtomate transiras al elsenda stato (TransmitACK), en kiu ACK-pakaĵeto estas sendita kiel respondo, sen interveno de la CPU. Post kiam tio finiĝas, la sekvencilo estas restarigita al sia komenca WaitForMessage-stato.
• Ĉi tiu fludiagramo efektivigas la saman konduton kiel la MRSUBG_SequencerAutoAck_Rx ekz.ample de la Eksampdosierujo les\MRSUBG de la programara pakaĵo STM32Cube WL3. Se AutoACK_RX estas ekbrilita sur unu aparato
  A, kaj AutoACK_TX estas ekbrilita sur iu aparato, B, la du aparatoj sendas mesaĝojn tien kaj reen, kiel en tablotenisludo.

Aŭtomata ACK_TX

• La demonstraĵo "Auto-ACK" ilustras kiel du STM32WL3x-aparatoj povas aŭtomate komuniki unu kun la alia kun minimuma CPU-interveno helpe de la sekvencila aparataro.
• Ĉi tiu fludiagramo realigas la konduton ("Auto-Wait-for-ACK") de aparato B. En aparato B, la sekvencilo estas inicialigita en elsenda stato (TransmitMessage), en kiu ĝi elsendas mesaĝon. Post kiam la dissendo finiĝas, ĝi aŭtomate transiras al riceva stato, kie ĝi atendas konfirmon de aparato A (WaitForACK). Post kiam valida konfirmo alvenas, la sekvencilo estas restarigita al sia komenca TransmitMessage stato kaj la tuta procezo rekomenciĝas. Se neniu ACK estas ricevita ene de 4 sekundoj, tempolimo estas ekigita kaj la sekvencilo revenas al stato TransmitMessage ĉiuokaze.
• Ĉi tiu fludiagramo efektivigas la saman konduton kiel la ekz. "MRSUBG_SequencerAutoAck_Tx".ample de la Eksampdosierujo les\MRSUBG de la programarpakaĵo STM32Cube WL3. Se AutoACK_RX estas ekbrilita sur unu aparato, A, kaj AutoACK_TX estas ekbrilita sur iu alia aparato, B, la du aparatoj sendas mesaĝojn tien kaj reen, kiel en tablotenisludo.

Aŭskultu antaŭ ol paroli (LBT)

• Ĉi tiu ekzample estas prenita el la referenca manlibro STM32WL3x [1]. Vidu tiun manlibron por pliaj detaloj pri ĉi tiu ekzemplo.ample.

Snufa reĝimo

• Ĉi tiu ekzample estas prenita el la referenca manlibro STM32WL3x [1]. Vidu tiun manlibron por pliaj detaloj pri ĉi tiu ekzemplo.ample.

Historio de revizioj

Tabelo 2. Dokumenta reviziohistorio

Dato	Versio	Ŝanĝoj
21-nov-2024	1	Komenca eldono.
10-feb-2025	2	Ĝisdatigita aparatnomo al amplekso STM32WL3x.

GRAVA AVIZO – LEGU ATENTE

• STMicroelectronics NV kaj ĝiaj filioj ("ST") rezervas la rajton fari ŝanĝojn, korektojn, plibonigojn, modifojn kaj plibonigojn al ST-produktoj kaj/aŭ al ĉi tiu dokumento iam ajn sen avizo. Aĉetantoj devas akiri la plej novajn rilatajn informojn pri ST-produktoj antaŭ ol fari mendojn. ST-produktoj estas venditaj laŭ la vendkondiĉoj de ST en la tempo de mendo agnosko.
• Aĉetantoj respondecas nur pri la elekto, elekto kaj uzo de ST-produktoj kaj ST supozas neniun respondecon pri aplika helpo aŭ la dezajno de produktoj de aĉetantoj.
• Neniu licenco, esprima aŭ implicita, al iu ajn intelekta proprieta rajto estas donita de ST ĉi tie.
• Revendo de ST-produktoj kun dispozicioj malsamaj ol la informoj ĉi tie prezentitaj nuligos ajnan garantion donitan de ST por tia produkto.
• ST kaj la ST-emblemo estas varmarkoj de ST. Por pliaj informoj pri ST-varmarkoj, konsultu www.st.com/trademarks. Ĉiuj aliaj produktaj aŭ servonomoj estas la posedaĵo de siaj respektivaj posedantoj.
• Informoj en ĉi tiu dokumento anstataŭas kaj anstataŭigas informojn antaŭe provizitajn en iuj antaŭaj versioj de ĉi tiu dokumento.
• © 2025 STMicroelectronics - Ĉiuj rajtoj rezervitaj

Oftaj Demandoj

• D: Kiuj estas la minimumaj sistempostuloj por STM32CubeWiSE-RadioCodeGenerator?
  • A: La minimumaj sistempostuloj inkluzivas almenaŭ 2 Gbajtojn da RAM, USB-pordojn kaj Adobe Acrobat Reader 6.0.
• D: Kiel mi povas agordi la programarpakaĵon STM32CubeWiSE-RadioCodeGenerator?
  • A: Por starigi la programarpakaĵon, eltiru la enhavon de la provizita zip-dosiero file en provizoran dosierujon kaj lanĉu la ruleblan dosieron file sekvante la surekranajn instrukciojn.

Dokumentoj/Rimedoj

STMicroelectronics UM3399 STM32Cube WiSE Radiokodgeneratoro [pdf] Uzanto-manlibro UM3399, UM3399 STM32 Cube WiSE Radiokodgenerilo, UM3399, STM32, Cube WiSE Radiokodgenerilo, Radiokodgenerilo, Kodgenerilo, Generilo

Referencoj

• Uzanto Manlibro