STMicroelectronics UM3399 STM32Cube WiSE Radio Code generator

Parentah Pamakéan Produk

• Aplikasi STM32CubeWiSE-RadioCodeGenerator merlukeun sahenteuna 2 Gbytes RAM, port USB, jeung Adobe Acrobat reader 6.0.
• Ekstrak eusi stm32wise-cgwin.zip file kana diréktori samentara.
• Jalankeun STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file tur turutan parentah dina-layar.
• Paket STM32CubeWiSE-RadioCodeGenerator SW files dikelompokeun kana polder kaasup 'aplikasi' sareng 'examples'.
• Pikeun ngawangun flowgraph dina STM32CubeWiSE-RadioCodeGenerator:
• Tambahkeun SeqActions kana flowgraph ngagunakeun toolbar atawa menu global.
• Sambungkeun SeqActions ka titik éntri sareng silih ku ngagambar panah transisi aksi.
• Napigasi grafik aliran ku cara nyéred lampah tur nambahkeun transisi Peta sakumaha diperlukeun.

Bubuka

• Dokumén ieu ngajelaskeun pakét STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) SW sareng generator kode sequencer STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator mangrupikeun aplikasi PC anu dianggo pikeun ngawangun flowgraph anu ngahartikeun tindakan transceiver anu kedah dieksekusi dina kaayaan anu mana, nganggo supir sequencer MRSUBG.
• Radio STM32WL3x Sub-GHz ngandung sequencer ieu, nu mangrupakeun mékanisme kaayaan-mesin-kawas anu ngamungkinkeun pikeun manajemén otonom mindahkeun RF, tanpa merlukeun campur CPU.
• Lamun campur CPU diperlukeun, interrupts bisa dihartikeun. Peta Transceiver bisa disusun dina grafik aliran. Dina dokumén ieu, tindakan transceiver individu disebut SeqActions.
• Sanajan kitu, kode sumber sanes representasi pangalusna pikeun flowgraphs, sabab conceals struktur logis tur temporal maranéhanana.
• STM32CubeWiSE-RadioCodeGenerator alamat masalah ieu ku cara nyadiakeun metoda grafis pikeun ngawangun flowgraphs lajeng exporting flowgraphs dihasilkeun salaku kode sumber C pikeun integrasi kana aplikasi pamaké.
• Definisi flowgraph disimpen dina mikrokontroler RAM dina wangun:
  • Hiji set tabel ActionConfiguration RAM, numbu ka silih maké pointers. Penunjuk ieu nangtukeun SeqActions, nyaéta, jinis tindakan (pikeun example, transmisi, panarimaan, abort), kitu ogé SeqAction-spésifik parameter radio jeung kaayaan pikeun transmisi Peta.
  • Méja RAM GlobalConfiguration unik. Ieu ngahartikeun titik éntri flowgraph (SeqAction pangheulana dieksekusi), kitu ogé sababaraha nilai bandéra standar sareng parameter radio umum.
• Parameter radio, nu bisa ngonpigurasi individual pikeun tiap SeqAction, disimpen dina salah sahiji registers dinamis, anu eusina mangrupa bagian tina tabel ActionConfiguration RAM. Parameter radio nu dibereskeun ngaliwatan sakabeh palaksanaan flowgraph nu (iwal aranjeunna dirobah salila ngaganggu CPU), disimpen dina registers statik, anu eusina mangrupa bagian tina tabel RAM konfigurasi global.

Inpormasi umum

Lisénsi
Dokumén ieu ngajelaskeun parangkat lunak anu dijalankeun dina mikrokontroler dumasar STM32WL3x Arm® Cortex ® -M0+.
Catetan: Arm mangrupikeun mérek dagang kadaptar ti Arm Limited (atanapi anak perusahaanna) di AS sareng/atanapi di tempat sanés.

Dokumén nu patali

Tabél 1. Rujukan Dokumén

Jumlah	Rujukan	Judul
[1]	RM0511	STM32WL30xx/31xx/33xx Arm® dumasar sub-GHz MCUs

Ngamimitian

• Bagian ieu ngajelaskeun sakabéh sarat sistem pikeun ngajalankeun STM32CubeWiSE-RadioCodeGenerator.
• Ogé rinci prosedur instalasi pakét software.

syarat Sistim
Aplikasi STM32CubeWiSE-RadioCodeGenerator ngagaduhan syarat minimum ieu:

• PC sareng prosesor Intel® atanapi AMD® ngajalankeun sistem operasi Microsoft® Windows 10
• Sahenteuna 2 Gbytes RAM
• palabuhan USB
• Adobe Acrobat maca 6.0

STM32CubeWiSE-RadioCodeGenerator SW pakét setelan
Laksanakeun léngkah-léngkah ieu:

1. Ekstrak eusi stm32wise-cgwin.zip file kana diréktori samentara.
2. Ekstrak sareng peluncuran STM32CubeWiSE-RadioCodeGenerator_Vx.xxxe file tur turutan parentah dina-layar.

STM32CubeWiSE-RadioCodeGenerator SW pakét files
Paket STM32CubeWiSE-RadioCodeGenerator SW files diatur kana polder ieu:

• aplikasi: ngandung STM32CubeWiSE-RadioCodeGenerator.exe
• examples: folder ieu diatur kana subfolders handap:
• kode: folder ieu ngandung flowgraphs example geus diékspor salaku kode C, siap jadi nyuntik kana hiji proyék aplikasi
• flowgraphs: folder ieu nyimpen sababaraha examples skenario operasi sequencer MRSUBG otonom

Catetan pelepasan sareng lisénsi files aya dina folder root.

STM32CubeWiSE-RadioCodeGenerator pedaran software

• Bagian ieu ngajelaskeun fungsi utama aplikasi STM32CubeWiSE-RadioCodeGenerator. Pikeun ngajalankeun utiliti ieu, klik dina STM32CubeWiSE-RadioCodeGenerator ikon.

Saatos ngaluncurkeun STM32CubeWiSE-RadioCodeGenerator, jandela aplikasi utama némbongan. Ieu diwangun ku:

• Menu global sareng toolbar
• Répréséntasi sered-sareng-serelek visual tina flowgraph
• Bagian konfigurasi SeqAction (ngan katingali upami SeqAction ayeuna nuju diédit)

Ngawangun flowgraph
Dasar
Flowgraphs diwangun dina dua léngkah:

1. Tambahkeun SeqActions kana flowgraph. Ieu tiasa dilakukeun nganggo tombol "Tambahkeun Aksi" dina tulbar, nganggo ménu global (Édit → Tambah Aksi) atanapi nganggo potong kompas "Ctrl + A".
2. Sambungkeun SeqActions ka titik éntri sareng silih ku ngagambar panah transisi aksi.

Kaayaan dimana transisi ieu lumangsung didefinisikeun engké (tingali Bagéan 3.2.1: Aliran kontrol).

Napigasi flowgraph, nyéred lampah
Ku nyéred tukang checkerboard tina flowgraph kalawan pointer mouse (klik kénca), nu viewport on flowgraph nu bisa disaluyukeun. Kabayang ngagugulung beurit bisa dipaké pikeun ngazum gede jeung leutik. Ngaklik di mana waé dina hiji aksi (iwal port kaluaran, tombol ngahapus sareng tombol édit) pikeun milih tindakan. Aksi tiasa diatur dina flowgraph ku cara nyéred aranjeunna nganggo tombol beurit kénca.

Nambahkeun transisi aksi

• Ditémbongkeun saperti dina Gambar 2, unggal aksi boga dua "port output", disebut NextAction1 (NA1) jeung NextAction2 (NA2), nu bisa disambungkeun kana SeqActions nu dieksekusi sanggeus aksi geus réngsé. Pikeun exampLe, NextAction1 bisa dipaké pikeun ngaéksekusi sababaraha aksi lamun aksi ayeuna suksés tur NextAction2 bisa dipicu bisi gagal.
• Pikeun nyieun transisi aksi, hover pointer beurit dina salah sahiji palabuhan kaluaran, pencét tombol beurit kénca jeung pindahkeun pointer beurit pikeun nyered panah transisi. Pindahkeun pointer beurit ngaliwatan port input di kénca sababaraha SeqAction sejen tur leupaskeun tombol beurit kénca pikeun nyieun sambungan permanén. Pikeun mupus hiji transisi aksi, ngan ngulang léngkah pikeun nyieun hiji transisi aksi, tapi leupaskeun tombol beurit kénca tempat leuwih tukang checkerboard.
• Lamun kaluaran (NextAction1, NextAction2) ditinggalkeun unconnected, terminates sequencer lamun aksi salajengna ieu dipicu.
• Pastikeun ogé nyambungkeun "Entry Point" ka sababaraha port input SeqAction. SeqAction ieu anu munggaran dieksekusi pas sequencer dipicu.

Ngédit sareng ngahapus tindakan

• SeqActions tiasa diédit ku ngaklik tombol pensil di belah kénca luhur SeqAction. Ieu bisa dihapus ku ngaklik on cross beureum dina katuhu luhur (tingali Gambar 3). Ngahapus SeqAction ogé ngaleungitkeun transisi aksi anu asup sareng kaluar.

Konfigurasi SeqAction
SeqActions bisa ngonpigurasi ngaliwatan panganteur konfigurasi tabbed diaksés ngaliwatan tombol pensil di kénca luhur unggal aksi dina flowgraph nu. Antarbeungeut ieu dasarna ngonpigurasikeun eusi tabel ActionConfiguration RAM pikeun aksi nu tangtu, diwangun ku duanana pilihan konfigurasi patali aliran kontrol ogé eusi register dinamis. Eusi register dinamis bisa boh jadi ngonpigurasi sacara manual jeung kontrol lengkep unggal nilai register (tingali Bagéan 3.2.3: Konfigurasi radio canggih) atawa ngaliwatan panganteur saderhana (tingali Bagéan 3.2.2: Konfigurasi radio dasar). Antarbeungeut anu disederhanakeun kedah cekap pikeun ampir sadaya kasus pamakean.

Aliran kontrol
Tab aliran kontrol (tingali Gambar 4) ngandung sababaraha pilihan konfigurasi dasar sapertos nami aksi sareng interval waktos waktos tindakan. Ngaran aksi henteu ngan dipaké pikeun tampilan dina flowgraph tapi ogé dibawa kana kode sumber dihasilkeun.

• Tab aliran kontrol (tingali Gambar 4) ngandung sababaraha pilihan konfigurasi dasar sapertos nami aksi sareng interval waktos waktos tindakan. Ngaran aksi henteu ngan dipaké pikeun tampilan dina flowgraph tapi ogé dibawa kana kode sumber dihasilkeun.
• Anu paling penting, tab aliran kontrol ngonpigurasikeun kaayaan dimana transisi ka NextAction1 / NextAction2 gumantung kana ogé interval transisi sareng bandéra. Kaayaan transisi tiasa dikonpigurasi ku ngaklik tombol anu dilabélan "...", anu ngajantenkeun dialog pamilihan topéng anu dipidangkeun dina Gambar 5 muncul. Interval transisi dirobah sipat NextAction1Interval / NextAction2Interval tabel RAM. Ningali manual rujukan STM32WL3x [1] kanggo inpormasi anu langkung lengkep ihwal harti interval ieu sareng pentingna bendera SleepEn / ForceReload / ForceClear.
• Saterusna, pedaran pondok tina blok SeqAction bisa ditambahkeun kana tab ieu. Pedaran ieu ngan dipaké pikeun kaperluan dokuméntasi jeung dibawa ka kode sumber dihasilkeun salaku komentar kode sumber.

Konfigurasi radio dasar

Tab konfigurasi radio dasar bisa dibagi jadi tilu bagian:

1. Bagian di luhur dimana dua parameter anu paling penting tina tindakan naon waé dikonpigurasi: paréntah pikeun ngaéksekusi (TX, RX, NOP, SABORT, sareng saterasna) sareng, upami tiasa, panjang pakét anu ditransfer.
2. Bagian di kénca dimana parameter radio anu saleresna sapertos: frekuensi pamawa, laju data, sipat modulasi, ambang panyangga data sareng timer dikonpigurasi.
3. Hiji bagian di katuhu mana CPU interrupts bisa individual diaktipkeun. Handler interupsi dihasilkeun pikeun tiap interrupts ticked. Ieu dasarna ngonpigurasikeun eusi RFSEQ_IRQ_ENABLE register.

Tingal manual rujukan STM32WL3x [1] pikeun harti rupa-rupa parameter radio.

Konfigurasi radio canggih

• Lamun pilihan konfigurasi kakeunaan ngaliwatan tab konfigurasi radio dasar (Bagian 3.2.2: Konfigurasi radio dasar) teu cukup, tab konfigurasi radio canggih STM32WL3x ngamungkinkeun setelan eusi register dinamis sawenang. Tab konfigurasi canggih diaktipkeun ku centang kotak centang Advanced Configuration ka katuhu luhur antarmuka konfigurasi tab.
• Teu mungkin ngagunakeun duanana konfigurasi dasar tur canggih dina waktos anu sareng, pamaké kudu milih hiji atawa lianna. Nanging, tangtosna ogé tiasa sacara manual ngédit kode sumber anu dihasilkeun saatosna sareng nambihan pilihan konfigurasi anu berpotensi leungit.

Dialog konfigurasi global

• Dialog "Setélan Proyék Global" tiasa diaksés ngalangkungan tombol toolbar "Setélan Global". Dialog ngandung duanana pilihan konfigurasi pikeun eusi register statik ogé setélan proyék tambahan. Catet yén ngan sabagian leutik pilihan konfigurasi register statik bisa ngonpigurasi ngaliwatan dialog ieu. Pilihan ieu ngan disadiakeun pikeun nyepetkeun aplikasi prototyping aplikasi kalawan STM32CubeWiSE-RadioCodeGenerator.
• Biasana diperkirakeun yén eusi register statik disetél dina kode sumber anu ditulis sacara manual.
• Harti setélan proyék séjén dipedar dina dialog sorangan.
• Kode C tambahan anu diselapkeun sateuacan ngadamel tabel RAM Konfigurasi Global tina eusi register statik ogé tiasa disayogikeun. Widang ieu tiasa dianggo pikeun nyetél nilai register statik anu teu tiasa diaksés ngalangkungan topéng konfigurasi register statik anu disayogikeun.

Generasi kode
Flowgraph tiasa ditarjamahkeun kana kode sumber proyék C lengkep ku mencét tombol Generate Code dina tulbar. Folder proyék anu dihasilkeun henteu ngandung proyék files pikeun IAR, Keil®, atawa GCC. Ieu files kudu ditambahkeun sacara manual kana proyék STMWL3x.
Ieu mangrupikeun struktur folder proyék anu dihasilkeun:

Folder folder

• Nyarita
• SequencerFlowgraph.h: lulugu file pikeun SequencerFlowgraph.c, statik. Ulah edit ieu.
• stm32wl3x_hal_conf.h: konfigurasi HAL STM32WL3x file, statik.
• src
• SequencerFlowgraph.c: harti flowgraph. Ieu nu penting file anu ngagunakeun supir sequencer pikeun nangtukeun tabel RAM global-konfigurasi jeung aksi-konfigurasi. Autogenerated, ulah diédit.
• main.c: Proyék utama file anu nunjukkeun kumaha ngamuat sareng nerapkeun definisi grafik aliran. Statis, modifikasi ieu sakumaha diperlukeun.
• Pikeun ngédit main.c atanapi stm32wl3x_hal_conf.h, pilih nimpa kabiasaan Simpen dina setélan proyék. Ku cara ieu, ngan SequencerFlowgraph.c anu ditimpa.

Kumaha ngimpor kode anu dihasilkeun kana CubeMX example
Pikeun ngimpor proyék anu dihasilkeun ku STM32CubeWiSE-RadioCodeGenerator kana mantan CubeMXample (MRSUBG_Skeleton), anjeun kedah nuturkeun léngkah-léngkah ieu:

1. Buka folder anu ngandung files dihasilkeun ku STM32CubeWiSE-RadioCodeGenerator sarta nyalin folder "Inc" jeung "Src".
2. Tempelkeun dua polder dina folder "MRSUBG_Skeleton" nimpa dua anu parantos aya.
3. Buka proyék "MRSUBG_Skeleton" dina salah sahiji IDE ieu:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Dina proyék "MRSUBG_Skeleton", tambahkeun "SequencerFlowghraph.c" file:
   • Pikeun proyék EWARM, jalur pikeun nambahkeun file nyaéta kieu: MRSUBG_Skeleton \ Aplikasi \ pamaké
   • Pikeun proyék MDK-ARM, jalur pikeun nambahkeun file nyaéta kieu: MRSUBG_Skeleton \ Aplikasi / pamaké
   • Pikeun proyék STM32CubeIDE, jalur pikeun nambahkeun file sarua:
     MRSUBG_Skeleton\Application\User
5. Di jero proyék MRSUBG_Skeleton, tambahkeun stm32wl3x_hal_uart.c sareng stm32wl3x_hal_uart_ex.c files ka jalur handap: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. jalur anu sarua pikeun sakabéh IDEs. Duanana files aya dina firmware \ Drivers \ STM32WL3x_HAL_Driver \ Src.
6. Pikeun ngagunakeun fitur COM, stm32wl3x_nucleo_conf.h file, ayana dina Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, kudu dirobah setelan USE_BSP_COM_FEATURE jeung USE_COM_LOG kana 1U:
7. Salin kodeu di handap ieu kana "stm32wl3x_it.c", ayana di MRSUBG_Skeleton\Application\User.

Flowgraph examples

• Opat example flowgraphs disadiakeun barengan kodeu sumber. Ieu examples bisa dimuat kana STM32CubeWiSE-RadioCodeGenerator ku ngaklik tombol "Beban" dina toolbar.

AutoACK_RX

• Auto-ACK demo illustrates kumaha dua alat STM32WL3x otomatis bisa ngobrol silih kalawan campur CPU minimal, kalayan bantuan hardware sequencer.
• flowgraph Ieu implements paripolah (Otomatis-Transmit-ACK) alat A. Dina alat A, sequencer ieu initialized dina kaayaan narima (WaitForMessage), nu ngantosan pesen datangna.
• Sakali pesen sah sumping, sequencer otomatis transisi kana kaayaan ngirimkeun (TransmitACK), nu hiji pakét ACK dikirim salaku respon, tanpa campur CPU. Sakali ieu réngsé, sequencer direset kana kaayaan WaitForMessage awal na.
• flowgraph Ieu implements paripolah sarua salaku MRSUBG_SequencerAutoAck_Rx example ti Examples \ MRSUBG folder pakét STM32Cube WL3 Software. Lamun AutoACK_RX flashed dina hiji alat
  A, sarta AutoACK_TX ieu flashed on sababaraha alat, B, dua alat ngirim pesen deui mudik, sakumaha dina kaulinan ping-pong.

AutoACK_TX

• Demo "Otomatis-ACK" illustrates kumaha dua alat STM32WL3x otomatis bisa ngobrol silih kalawan campur CPU minimal kalayan bantuan hardware sequencer.
• flowgraph Ieu implements kabiasaan ("Otomatis-Tunggu-pikeun-ACK") alat B. Dina alat B, sequencer ieu initialized dina kaayaan ngirimkeun (TransmitMessage), nu ngirimkeun pesen. Sakali pangiriman rengse, eta otomatis transisi kana kaayaan narima dimana ngantosan hiji pangakuan ti alat A (WaitForACK). Sakali pangakuan sah sumping, sequencer direset kana kaayaan TransmitMessage awalna sareng sadayana prosésna dimimitian deui. Upami teu aya ACK anu ditampi dina 4 detik, waktos waktosna dipicuna sareng sequencer balik deui ka kaayaan TransmitMessage.
• Flowgraph ieu ngalaksanakeun paripolah anu sami sareng "MRSUBG_SequencerAutoAck_Tx" example ti Examples \ MRSUBG folder pakét STM32Cube WL3 Software. Mun AutoACK_RX flashed on hiji alat, A, sarta AutoACK_TX flashed on sababaraha alat sejen, B, dua alat ngirim pesen deui mudik, sakumaha dina kaulinan ping-pong.

Dengekeun saméméh Obrolan (LBT)

• Mantan ieuample dicokot tina manual rujukan STM32WL3x [1]. Tingal manual éta pikeun detil salajengna ngeunaan ex ieuample.

Modus ngambeu

• Mantan ieuample dicokot tina manual rujukan STM32WL3x [1]. Tingal manual éta pikeun detil salajengna ngeunaan ex ieuample.

Riwayat révisi

Méja 2. Sajarah révisi dokumén

titimangsa	Vérsi	Parobahan
21-Nopémber-2024	1	Pelepasan awal.
10-Feb-2025	2	Ngaran alat diropéa pikeun wengkuan STM32WL3x.

PERHATOSAN PENTING – BACA TELITI

• STMicroelectronics NV sareng anak perusahaanna ("ST") ngagaduhan hak pikeun ngarobih, koréksi, perbaikan, modifikasi, sareng perbaikan produk ST sareng / atanapi dokumen ieu iraha waé tanpa aya bewara. Purchasers kudu ménta inpo relevan panganyarna dina produk ST saméméh nempatkeun pesenan. Produk ST dijual dumasar kana sarat sareng kaayaan penjualan ST di tempat nalika pangakuan pesenan.
• Purchasers téh solely jawab pilihan, seleksi, sarta pamakéan produk ST sarta ST nganggap euweuh liability pikeun bantuan aplikasi atawa desain produk purchasers '.
• Henteu aya lisénsi, terang atanapi tersirat, kana hak cipta intelektual anu dipasihkeun ku ST di dieu.
• Dijual deui produk ST kalayan katangtuan anu béda ti inpormasi anu dijelaskeun di dieu bakal ngabatalkeun jaminan anu dipasihkeun ku ST pikeun produk sapertos kitu.
• ST jeung logo ST mangrupakeun mérek dagang ti ST. Pikeun émbaran tambahan ngeunaan mérek dagang ST, tingal www.st.com/trademarks. Sadaya nami produk atanapi jasa sanés mangrupikeun milik anu gaduhna.
• Inpormasi dina dokumén ieu ngagentos sareng ngagentos inpormasi anu disayogikeun saacanna dina versi sateuacanna tina dokumén ieu.
• © 2025 STMicroelectronics – Sadaya hak ditangtayungan

FAQ

• Q: Naon syarat sistem minimum pikeun STM32CubeWiSE-RadioCodeGenerator?
  • A: Sarat sistem minimum kalebet sahenteuna 2 Gbytes RAM, palabuhan USB, sareng Adobe Acrobat reader 6.0.
• Q: Kumaha carana abdi tiasa nyetél pakét software STM32CubeWiSE-RadioCodeGenerator?
  • A: Pikeun nyetél pakét parangkat lunak, ekstrak eusi pos anu disayogikeun file kana diréktori samentawis sareng ngajalankeun executable file nuturkeun pitunjuk dina layar.

Dokumén / Sumberdaya

STMicroelectronics UM3399 STM32Cube WiSE Radio Code generator [pdf] Manual pamaké UM3399, UM3399 STM32 Cube WiSE Radio Code Generator, UM3399, STM32, Cube WiSE Radio Code Generator, Radio Code Generator, Code Generator, Generator

Rujukan

• Manual pamaké