Генератор радио кода STMicroelectronics UM3399 STM32Cube WiSE

Упутства за употребу производа

• Апликација STM32CubeWiSE-RadioCodeGenerator захтева најмање 2 GB RAM меморије, USB портове и Adobe Acrobat Reader 6.0.
• Извуците садржај датотеке stm32wise-cgwin.zip file у привремени именик.
• Покрените STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file и пратите упутства на екрану.
• Софтверски пакет STM32CubeWiSE-RadioCodeGenerator fileДатотеке су организоване у фасцикле, укључујући „апликације“ и „екс“ampлес'.
• Да бисте направили дијаграм тока у STM32CubeWiSE-RadioCodeGenerator-у:
• Додајте SeqActions у графикон тока помоћу траке са алаткама или глобалног менија.
• Повежите SeqActions са улазном тачком и једни са другима цртањем стрелица за прелаз акција.
• Крећите се кроз графикон тока превлачењем акција и додавањем прелаза акција по потреби.

Увод

• Овај документ описује софтверски пакет STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) са генератором кода секвенцера STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator је PC апликација која се користи за изградњу графа тока који дефинише које акције примопредајника треба извршити под којим условима, користећи драјвер секвенцера MRSUBG.
• STM32WL3x Sub-GHz радио садржи овај секвенцер, који је механизам сличан машини стања који омогућава аутономно управљање РФ преносима, без потребе за интервенцијом процесора.
• Ако је потребна интервенција процесора, могу се дефинисати прекиди. Акције примопредајника могу се организовати у графу тока. У овом документу, појединачне акције примопредајника се називају SeqActions.
• Међутим, изворни код није најбоља репрезентација за графове тока, јер прикрива њихову логичку и временску структуру.
• STM32CubeWiSE-RadioCodeGenerator решава овај проблем пружањем графичке методе за изградњу графова тока, а затим извозом генерисаних графова тока као C изворног кода за интеграцију у корисничке апликације.
• Дефиниција графа тока се чува у RAM меморији микроконтролера у облику:
  • Скуп RAM табела конфигурације акција (ActionConfiguration), повезаних једна са другом помоћу показивача. Ови показивачи дефинишу SeqActions, односно тип акције (нпр.ampле, пренос, пријем, прекид), као и радио параметре и услове специфичне за SeqAction за преносе акција.
  • Јединствена табела GlobalConfiguration RAM меморије. Она дефинише улазну тачку графа тока (прва SeqAction која се извршава), као и неке подразумеване вредности заставица и уобичајене радио параметре.
• Радио параметри, који се могу конфигурисати појединачно за сваку SeqAction, чувају се у једном од динамичких регистара, чији је садржај део табеле ActionConfiguration RAM меморије. Радио параметри који су фиксирани током целог извршавања графа тока (осим ако се не модификују током прекида процесора), чувају се у статичким регистрима, чији је садржај део глобалне табеле конфигурације RAM меморије.

Опште информације

Лиценцирање
Овај документ описује софтвер који ради на микроконтролеру базираном на STM32WL3x Arm® Cortex ® -M0+.
Напомена: Арм је регистровани заштитни знак компаније Арм Лимитед (или њених подружница) у САД -у и/или другдје.

Повезани документи

Табела 1. Референце докумената

Број	Референца	Наслов
[1]	РМ0511	STM32WL30xx/31xx/33xx Arm® микроконтролери са суб-GHz фреквенцијом

Почетак рада

• Овај одељак описује све системске захтеве за покретање STM32CubeWiSE-RadioCodeGenerator-а.
• Такође детаљно описује поступак инсталације софтверског пакета.

Системски захтеви
Апликација STM32CubeWiSE-RadioCodeGenerator има следеће минималне захтеве:

• Рачунар са Intel® или AMD® процесором који користи оперативни систем Microsoft® Windows 10
• Најмање 2 Гбајта РАМ-а
• УСБ портови
• Adobe Acrobat Reader 6.0

Подешавање софтверског пакета STM32CubeWiSE-RadioCodeGenerator
Извршите следеће кораке:

1. Извуците садржај датотеке stm32wise-cgwin.zip file у привремени именик.
2. Распакујте и покрените STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file и пратите упутства на екрану.

Софтверски пакет STM32CubeWiSE-RadioCodeGenerator files
Софтверски пакет STM32CubeWiSE-RadioCodeGenerator fileсу организовани у следеће фасцикле:

• апликација: садржи STM32CubeWiSE-RadioCodeGenerator.exe
• exampлес: ова фасцикла је организована у следеће подфасцикле:
• код: ова фасцикла садржи flowgraphs exampвећ је извезен као C код, спреман за убризгавање у пројекат апликације
• графикони тока: ова фасцикла чува неке нпр.ampмање сценарија аутономних операција секвенцера MRSUBG

Белешке о издању и лиценца fileс се налазе у основној фасцикли.

Опис софтвера STM32CubeWiSE-RadioCodeGenerator

• Овај одељак описује главне функције апликације STM32CubeWiSE-RadioCodeGenerator. Да бисте покренули овај услужни програм, кликните на икону STM32CubeWiSE-RadioCodeGenerator.

Након покретања STM32CubeWiSE-RadioCodeGenerator-а, појављује се главни прозор апликације. Он се састоји од:

• Глобални мени и трака са алаткама
• Визуелни приказ дијаграма тока методом превлачења и испуштања
• Одељак за конфигурацију SeqAction (видљив само ако се SeqAction тренутно уређује)

Изградња дијаграма тока
Основе
Графови тока се граде у два корака:

1. Додајте SeqActions у графикон тока. То се може урадити помоћу дугмета „Додај акцију“ у траци са алаткама, коришћењем глобалног менија (Уреди → Додај акцију) или помоћу пречице „Ctrl+A“.
2. Повежите SeqActions са улазном тачком и једни са другима цртањем стрелица за прелаз акција.

Услови под којима се ови прелази дешавају дефинисани су касније (видети одељак 3.2.1: Ток управљања).

Навигација кроз графикон тока, превлачење радњи
Превлачењем шаховске позадине дијаграма тока показивачем миша (леви клик), viewПорт на графикону тока може се подесити. Точкић за померање миша може се користити за зумирање. Кликом било где на радњу (осим на излазне портове, дугме за брисање и дугме за уређивање) можете изабрати радњу. Радње се могу распоредити на графикону тока превлачењем левим тастером миша.

Додавање прелаза акција

• Као што је приказано на слици 2, свака акција има два „излазна порта“, названа СледећаАкција1 (NA1) и СледећаАкција2 (NA2), који се могу повезати са СекАкцијама које се извршавају након што је акција завршена. На примерampНа пример, NextAction1 би могла да се користи за извршавање неке акције ако је тренутна акција била успешна, а NextAction2 би могла да се покрене у случају неуспеха.
• Да бисте креирали прелаз акције, задржите показивач миша изнад једног од излазних портова, притисните леви тастер миша и померите показивач миша да бисте повукли стрелицу прелаза. Померите показивач миша изнад улазног порта лево од неке друге SeqAction и отпустите леви тастер миша да бисте везу учинили трајном. Да бисте уклонили прелаз акције, само поновите кораке за креирање прелаза акције, али отпустите леви тастер миша негде изнад позадине шаховске табле.
• Ако излаз (СледећаАкција1, СледећаАкција2) остане неповезан, секвенцер се завршава ако се ова следећа акција покрене.
• Обавезно повежите и „Улазну тачку“ са улазним портом неке SeqAction. Ова SeqAction је прва која се извршава чим се секвенцер покрене.

Уређивање и брисање радњи

• СекАкције се могу уређивати кликом на дугме оловке у горњем левом углу СекАкције. Могу се обрисати кликом на црвени крст у горњем десном углу (погледајте слику 3). Брисањем СекАкције се такође уклањају сви долазни и одлазни прелази акција.

Конфигурација SeqAction-а
СекАкције се могу конфигурисати путем интерфејса за конфигурацију са картицама, доступног преко дугмета оловке у горњем левом углу сваке акције у графу тока. Овај интерфејс у ​​суштини конфигурише садржај табеле ActionConfiguration RAM за одређену акцију, која се састоји од опција конфигурације везаних за контролу тока, као и од садржаја динамичких регистра. Садржај динамичких регистра може се конфигурисати ручно са потпуном контролом над сваком вредношћу регистра (видети одељак 3.2.3: Напредна конфигурација радија) или путем поједностављеног интерфејса (видети одељак 3.2.2: Основна конфигурација радија). Поједностављени интерфејс би требало да буде довољан за скоро све случајеве употребе.

Контрола тока
Картица тока контроле (видети слику 4) садржи неке основне опције конфигурације као што су назив акције и интервал временског ограничења акције. Назив акције се не користи само за приказ у графикону тока, већ се преноси и у генерисани изворни код.

• Картица тока контроле (видети слику 4) садржи неке основне опције конфигурације као што су назив акције и интервал временског ограничења акције. Назив акције се не користи само за приказ у графикону тока, већ се преноси и у генерисани изворни код.
• Најважније је да картица тока контроле конфигурише услов од ког зависи прелаз на NextAction1 / NextAction2, као и интервал прелаза и заставице. Услов прелаза се може конфигурисати кликом на дугме означено са „…“, што покреће дијалог за избор маске приказан на слици 5. Интервал прелаза је изменио својство NextAction1Interval / NextAction2Interval RAM табеле. За више информација о значењу овог интервала и значају заставица SleepEn / ForceReload / ForceClear погледајте референтни приручник за STM32WL3x [1].
• Штавише, на овој картици се може додати кратак опис блока SeqAction. Овај опис се користи само у сврху документације и преноси се у генерисани изворни код као коментар изворног кода.

Основна радио конфигурација

Картица за основну конфигурацију радија може се поделити на три дела:

1. Одељак на врху где су конфигурисана два најважнија параметра било које акције: команда која се извршава (TX, RX, NOP, SABORT, итд.) и, ако је применљиво, дужина пакета који се преноси.
2. Одељак са леве стране где се конфигуришу стварни радио параметри као што су: носећа фреквенција, брзина преноса података, својства модулације, прагови бафера података и тајмери.
3. Одељак са десне стране где се прекиди процесора могу појединачно омогућити. За сваки од означених прекида генерише се програм за обраду прекида. Ово у основи конфигурише садржај регистра RFSEQ_IRQ_ENABLE.

Погледајте референтни приручник за STM32WL3x [1] за значење различитих радио параметара.

Напредна конфигурација радија

• Ако опције конфигурације приказане преко картице за основну конфигурацију радија (Одељак 3.2.2: Основна конфигурација радија) нису довољне, напредна картица за конфигурацију радија STM32WL3x омогућава подешавање произвољног садржаја динамичких регистара. Картица за напредну конфигурацију се омогућава означавањем поља за потврду „Напредна конфигурација“ у горњем десном углу интерфејса за конфигурацију са картицама.
• Није могуће користити и основне и напредне конфигурације истовремено, корисник мора да изабере једну или другу. Међутим, наравно, могуће је и ручно изменити генерисани изворни код накнадно и додати потенцијално недостајуће опције конфигурације.

Дијалог за глобалну конфигурацију

• Дијалогу „Глобална подешавања пројекта“ може се приступити преко дугмета „Глобална подешавања“ на траци са алаткама. Дијалог садржи и опције конфигурације за садржај статичког регистра, као и додатна подешавања пројекта. Имајте на уму да се само мали део опција конфигурације статичког регистра може конфигурисати преко овог дијалога. Ове опције су обезбеђене само да би се убрзало израда прототипова апликација помоћу STM32CubeWiSE-RadioCodeGenerator-а.
• Обично се очекује да је садржај статичких регистра подешен у ручно написаном изворном коду апликације.
• Значење осталих подешавања пројекта објашњено је у самом дијалогу.
• Може се обезбедити и додатни C код који се убацује непосредно пре креирања табеле глобалне конфигурације RAM меморије из садржаја статичког регистра. Ово поље се може користити за подешавање вредности статичког регистра које нису доступне преко дате маске конфигурације статичког регистра.

Генерисање кода
График тока се може превести у комплетан изворни код пројекта у C језику притиском на дугме „Генериши код“ у траци са алаткама. Генерисана фасцикла пројекта не садржи пројекат fileза IAR, Keil® или GCC. Ови files морају се ручно додати у STMWL3x пројекат.
Ово је генерисана структура фасцикли пројекта:

Фолдер пројекта

• инц
• SequencerFlowgraph.h: заглавље file за SequencerFlowgraph.c, статички. Не мењајте ово.
• stm32wl3x_hal_conf.h: STM32WL3x HAL конфигурација file, статички.
• срц
• SequencerFlowgraph.c: дефиниција графа тока. Ово је важно file који користи драјвер секвенцера за дефинисање RAM табела глобалне конфигурације и конфигурације акција. Аутоматски генерисано, не мењајте.
• main.c: Пројекат main file што показује како се учитава и примењује дефиниција графа тока. Статички, измените ово по потреби.
• Да бисте изменили main.c или stm32wl3x_hal_conf.h, изаберите понашање преписивања Keep у подешавањима пројекта. На овај начин, само SequencerFlowgraph.c ће бити преписан.

Како увести генерисани код у CubeMX example
Да бисте увезли пројекат генерисан помоћу STM32CubeWiSE-RadioCodeGenerator-а у CubeMX exampле (MRSUBG_Skeleton), потребно је пратити следеће кораке:

1. Отворите фасциклу која садржи fileгенерисане помоћу STM32CubeWiSE-RadioCodeGenerator-а и копирајте фасцикле „Inc“ и „Src“.
2. Налепите две фасцикле у фасциклу „MRSUBG_Skeleton“ преписујући две које већ постоје.
3. Отворите пројекат „MRSUBG_Skeleton“ у једном од следећих IDE-а:
   • ЕВАРМ
   • МДК-АРМ
   • СТМ32ЦубеИДЕ
4. Унутар пројекта „MRSUBG_Skeleton“, додајте „SequencerFlowghraph.c“ file:
   • За EWARM пројекат, путања за додавање file је следеће: MRSUBG_Skeleton\Application\User
   • За MDK-ARM пројекат, путања за додавање file је следеће: MRSUBG_Skeleton\Application/User
   • За STM32CubeIDE пројекат, путања за додавање file је исто:
     MRSUBG_Skeleton\Application\User
5. Унутар пројекта MRSUBG_Skeleton, додајте stm32wl3x_hal_uart.c и stm32wl3x_hal_uart_ex.c fileс на следећу путању: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Путања је иста за све IDE-ове. Два fileДатотеке се налазе на Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Да бисте користили COM функције, stm32wl3x_nucleo_conf.h file, налази се на Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, мора се изменити подешавањем USE_BSP_COM_FEATURE и USE_COM_LOG на 1U:
7. Копирајте следећи код у „stm32wl3x_it.c“, који се налази у MRSUBG_Skeleton\Application\User.

Флоуграф екampлес

• Четири бившаampГрафикони тока су дати уз изворни код. Ови нпр.ampДатотеке се могу учитати у STM32CubeWiSE-RadioCodeGenerator кликом на дугме „Учитај“ у траци са алаткама.

AutoACK_RX

• Демонстрација аутоматског потврђивања потврде (Auto-ACK) илуструје како два STM32WL3x уређаја могу аутоматски да комуницирају један са другим уз минималну интервенцију процесора, уз помоћ хардвера секвенцера.
• Овај графикон тока имплементира понашање (Auto-Transmit-ACK) уређаја А. У уређају А, секвенцер је иницијализован у стању пријема (WaitForMessage), у којем чека да порука стигне.
• Када стигне валидна порука, секвенцер аутоматски прелази у стање преноса (TransmitACK), у којем се ACK пакет шаље као одговор, без интервенције процесора. Када се ово заврши, секвенцер се ресетује у почетно стање WaitForMessage.
• Овај графикон тока имплементира исто понашање као и MRSUBG_SequencerAutoAck_Rx exampле из екampФолдер les\MRSUBG софтверског пакета STM32Cube WL3. Ако је AutoACK_RX флешован на једном уређају
  А, а AutoACK_TX је флешован на неком уређају, Б, два уређаја шаљу поруке напред-назад, као у игри пинг-понга.

AutoACK_TX

• Демо „Auto-ACK“ илуструје како два STM32WL3x уређаја могу аутоматски да комуницирају један са другим уз минималну интервенцију процесора уз помоћ хардвера секвенцера.
• Овај графикон тока имплементира понашање („Auto-Wait-for-ACK“) уређаја Б. У уређају Б, секвенцер је иницијализован у стању преноса (TransmitMessage), у којем преноси поруку. Када је пренос завршен, аутоматски прелази у стање пријема где чека потврду од уређаја А (WaitForACK). Када стигне валидна потврда, секвенцер се ресетује у своје почетно стање TransmitMessage и цео процес почиње изнова. У случају да се ACK не прими у року од 4 секунде, активира се тајм-аут и секвенцер се ипак враћа у стање TransmitMessage.
• Овај графикон тока имплементира исто понашање као и „MRSUBG_SequencerAutoAck_Tx“ exampле из бившегampФолдер les\MRSUBG софтверског пакета STM32Cube WL3. Ако је AutoACK_RX флешован на једном уређају, А, а AutoACK_TX је флешован на неком другом уређају, Б, два уређаја шаљу поруке напред-назад, као у игри пинг-понга.

Слушај пре него што причаш (LBT)

• Овај бившиampДатум је преузет из референтног приручника за STM32WL3x [1]. За више детаља о овом примеру погледајте тај приручник.ampле.

Режим њушкања

• Овај бившиampДатум је преузет из референтног приручника за STM32WL3x [1]. За више детаља о овом примеру погледајте тај приручник.ampле.

Историја ревизија

Табела 2. Историја ревизије документа

Датум	Версион	Промене
21-Нов-2024	1	Првобитно издање.
10-феб-2025	2	Ажурирано име уређаја на scope STM32WL3x.

ВАЖНО ОБАВЕШТЕЊЕ – ПАЖЉИВО ПРОЧИТАЈТЕ

• СТМицроелецтроницс НВ и његове подружнице („СТ“) задржавају право да у било ком тренутку без претходног обавештења унесу измене, исправке, побољшања, модификације и побољшања СТ производа и/или овог документа. Купци би требало да добију најновије релевантне информације о СТ производима пре наручивања. СТ производи се продају у складу са СТ условима продаје који су на снази у тренутку потврде поруџбине.
• Купци су искључиво одговорни за избор, избор и употребу СТ производа и СТ не преузима никакву одговорност за помоћ у примени или дизајн производа купаца.
• СТ овде не даје никакву лиценцу, изричиту или имплицирану, за било које право интелектуалне својине.
• Препродаја СТ производа са одредбама другачијим од информација наведених овде поништава сваку гаранцију коју СТ даје за такав производ.
• СТ и СТ лого су заштитни знакови компаније СТ. За додатне информације о СТ заштитним знаковима, погледајте ввв.ст.цом/традемаркс. Сви остали називи производа или услуга су власништво њихових власника.
• Информације у овом документу замењују и замењују информације које су претходно дате у претходним верзијама овог документа.
• © 2025 СТМицроелецтроницс – Сва права задржана

ФАК

• П: Који су минимални системски захтеви за STM32CubeWiSE-RadioCodeGenerator?
  • A: Минимални системски захтеви укључују најмање 2 ГБ РАМ-а, УСБ портове и Adobe Acrobat Reader 6.0.
• П: Како могу да подесим софтверски пакет STM32CubeWiSE-RadioCodeGenerator?
  • A: Да бисте подесили софтверски пакет, извуците садржај приложене zip датотеке file у привремени директоријум и покрените извршну датотеку file пратећи упутства на екрану.

Документи / Ресурси

Генератор радио кода STMicroelectronics UM3399 STM32Cube WiSE [пдф] Упутство за употребу UM3399, UM3399 STM32 Cube WiSE генератор радио кода, UM3399, STM32, Cube WiSE генератор радио кода, генератор радио кода, генератор кода, генератор

Референце

• Упутство за употребу