STMicroelectronics UM3399 STM32Cube Penjana Kod Radio WiSE

Arahan Penggunaan Produk

• Aplikasi STM32CubeWiSE-RadioCodeGenerator memerlukan sekurang-kurangnya 2 Gbytes RAM, port USB dan pembaca Adobe Acrobat 6.0.
• Ekstrak kandungan stm32wise-cgwin.zip file ke dalam direktori sementara.
• Lancarkan STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file dan ikut arahan pada skrin.
• Pakej STM32CubeWiSE-RadioCodeGenerator SW files disusun ke dalam folder termasuk 'app' dan 'examples'.
• Untuk membina graf alir dalam STM32CubeWiSE-RadioCodeGenerator:
• Tambahkan SeqActions pada graf alir menggunakan bar alat atau menu global.
• Sambungkan SeqActions ke titik masuk dan antara satu sama lain dengan melukis anak panah peralihan tindakan.
• Navigasi graf aliran dengan menyeret tindakan dan menambah peralihan tindakan mengikut keperluan.

pengenalan

• Dokumen ini menerangkan pakej STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) SW dengan penjana kod penjujukan STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator ialah aplikasi PC yang digunakan untuk membina graf alir yang mentakrifkan tindakan transceiver untuk dilaksanakan dalam keadaan yang mana, menggunakan pemacu penjujukan MRSUBG.
• Radio STM32WL3x Sub-GHz mengandungi penjujukan ini, yang merupakan mekanisme seperti mesin keadaan yang membenarkan pengurusan pemindahan RF secara autonomi, tanpa memerlukan campur tangan CPU.
• Jika campur tangan CPU diperlukan, gangguan boleh ditakrifkan. Tindakan transceiver boleh disusun dalam graf aliran. Dalam dokumen ini, tindakan transceiver individu dirujuk sebagai SeqActions.
• Walau bagaimanapun, kod sumber bukanlah perwakilan terbaik untuk graf alir, kerana ia menyembunyikan struktur logik dan temporalnya.
• STM32CubeWiSE-RadioCodeGenerator menangani isu ini dengan menyediakan kaedah grafik untuk membina graf alir dan kemudian mengeksport graf alir yang dijana sebagai kod sumber C untuk penyepaduan ke dalam aplikasi pengguna.
• Definisi graf alir disimpan dalam mikropengawal RAM dalam bentuk:
  • Satu set jadual RAM ActionConfiguration, dipautkan antara satu sama lain menggunakan penunjuk. Penunjuk ini mentakrifkan SeqActions, iaitu jenis tindakan (contohnyaample, penghantaran, penerimaan, pengguguran), serta parameter radio khusus SeqAction dan syarat untuk penghantaran tindakan.
  • Jadual RAM GlobalConfiguration yang unik. Ini mentakrifkan titik masuk graf alir (SeqAction pertama untuk dilaksanakan), serta beberapa nilai bendera lalai dan parameter radio biasa.
• Parameter radio, yang boleh dikonfigurasikan secara individu untuk setiap SeqAction, disimpan dalam salah satu daftar dinamik, yang kandungannya adalah sebahagian daripada jadual ActionConfiguration RAM. Parameter radio yang ditetapkan pada keseluruhan pelaksanaan graf alir (melainkan ia diubah suai semasa gangguan CPU), disimpan dalam daftar statik, yang kandungannya adalah sebahagian daripada jadual RAM konfigurasi global.

Maklumat am

Pelesenan
Dokumen ini menerangkan perisian yang berjalan pada mikropengawal berasaskan STM32WL3x Arm® Cortex ® -M0+.
Nota: Arm ialah tanda dagangan berdaftar Arm Limited (atau anak syarikatnya) di AS dan/atau di tempat lain.

Dokumen berkaitan

Jadual 1. Rujukan dokumen

Nombor	Rujukan	Tajuk
[1]	RM0511	MCU sub-GHz berasaskan STM32WL30xx/31xx/33xx Arm®

Bermula

• Bahagian ini menerangkan semua keperluan sistem untuk menjalankan STM32CubeWiSE-RadioCodeGenerator.
• Ia juga memperincikan prosedur pemasangan pakej perisian.

Keperluan sistem
Aplikasi STM32CubeWiSE-RadioCodeGenerator mempunyai keperluan minimum berikut:

• PC dengan pemproses Intel® atau AMD® yang menjalankan sistem pengendalian Microsoft® Windows 10
• Sekurang-kurangnya 2 Gbytes RAM
• Port USB
• Pembaca Adobe Acrobat 6.0

Persediaan pakej STM32CubeWiSE-RadioCodeGenerator SW
Lakukan langkah-langkah berikut:

1. Ekstrak kandungan stm32wise-cgwin.zip file ke dalam direktori sementara.
2. Ekstrak dan lancarkan STM32CubeWiSE-RadioCodeGenerator_Vx.xxxe file dan ikut arahan pada skrin.

Pakej STM32CubeWiSE-RadioCodeGenerator SW files
Pakej STM32CubeWiSE-RadioCodeGenerator SW files disusun ke dalam folder berikut:

• app: mengandungi STM32CubeWiSE-RadioCodeGenerator.exe
• examples: folder ini disusun ke dalam subfolder berikut:
• kod: folder ini mengandungi graf aliran example sudah dieksport sebagai kod C, sedia untuk disuntik ke dalam projek aplikasi
• flowgraphs: folder ini menyimpan beberapa bekasamples senario operasi penjujukan MRSUBG autonomi

Nota keluaran dan lesen files terletak dalam folder akar.

Perihalan perisian STM32CubeWiSE-RadioCodeGenerator

• Bahagian ini menerangkan fungsi utama aplikasi STM32CubeWiSE-RadioCodeGenerator. Untuk menjalankan utiliti ini, klik pada ikon STM32CubeWiSE-RadioCodeGenerator.

Selepas melancarkan STM32CubeWiSE-RadioCodeGenerator, tetingkap aplikasi utama muncul. Ia terdiri daripada:

• Menu global dan bar alat
• Perwakilan drag-and-drop visual graf alir
• Bahagian konfigurasi SeqAction (hanya kelihatan jika SeqAction sedang diedit)

Membina graf alir
Asas
Graf alir dibina dalam dua langkah:

1. Tambahkan SeqActions pada graf alir. Ini boleh dilakukan menggunakan butang "Tambah Tindakan" dalam bar alat, menggunakan menu global (Edit → Tambah Tindakan) atau dengan pintasan "Ctrl+A".
2. Sambungkan SeqActions ke titik masuk dan antara satu sama lain dengan melukis anak panah peralihan tindakan.

Keadaan di mana peralihan ini berlaku ditakrifkan kemudian (lihat Bahagian 3.2.1: Aliran kawalan).

Menavigasi graf alir, menyeret tindakan
Dengan menyeret latar belakang papan dam bagi graf alir dengan penuding tetikus (klik kiri), viewport pada graf alir boleh dilaraskan. Roda skrol tetikus boleh digunakan untuk mengezum masuk dan keluar. Mengklik mana-mana sahaja pada tindakan (kecuali port output, butang padam dan butang edit) untuk memilih tindakan. Tindakan boleh diatur dalam graf alir dengan menyeretnya dengan butang tetikus kiri.

Menambah peralihan tindakan

• Seperti yang ditunjukkan dalam Rajah 2, setiap tindakan mempunyai dua "port output", dipanggil NextAction1 (NA1) dan NextAction2 (NA2), yang boleh disambungkan kepada SeqActions yang dilaksanakan selepas tindakan telah selesai. Untuk exampOleh itu, NextAction1 boleh digunakan untuk melaksanakan beberapa tindakan jika tindakan semasa berjaya dan NextAction2 boleh dicetuskan sekiranya berlaku kegagalan.
• Untuk mencipta peralihan tindakan, tuding penuding tetikus pada salah satu port output, tekan butang kiri tetikus dan gerakkan penuding tetikus untuk menyeret anak panah peralihan. Gerakkan penuding tetikus ke atas port input di sebelah kiri beberapa SeqAction lain dan lepaskan butang tetikus kiri untuk membuat sambungan kekal. Untuk mengalih keluar peralihan tindakan, hanya ulangi langkah untuk membuat peralihan tindakan, tetapi lepaskan butang kiri tetikus di suatu tempat di atas latar belakang papan dam.
• Jika output (NextAction1, NextAction2) dibiarkan tidak bersambung, penjujukan ditamatkan jika tindakan seterusnya ini dicetuskan.
• Pastikan anda juga menyambungkan "Entry Point" ke beberapa port input SeqAction. SeqAction ini adalah yang pertama dilaksanakan sebaik sahaja penjujukan dicetuskan.

Mengedit dan memadam tindakan

• SeqActions boleh diedit dengan mengklik pada butang pensel di bahagian atas sebelah kiri SeqAction. Ia boleh dipadamkan dengan mengklik pada palang merah di bahagian atas sebelah kanan (lihat Rajah 3). Memadamkan SeqAction juga mengalih keluar sebarang peralihan tindakan masuk dan keluar.

Konfigurasi SeqAction
SeqActions boleh dikonfigurasikan melalui antara muka konfigurasi tab yang boleh diakses melalui butang pensel di sebelah kiri atas setiap tindakan dalam graf alir. Antara muka ini pada asasnya mengkonfigurasi kandungan jadual ActionConfiguration RAM untuk tindakan tertentu, yang terdiri daripada kedua-dua pilihan konfigurasi berkaitan aliran kawalan serta kandungan daftar dinamik. Kandungan daftar dinamik boleh sama ada dikonfigurasikan secara manual dengan kawalan penuh ke atas setiap nilai daftar (lihat Bahagian 3.2.3: Konfigurasi radio lanjutan) atau melalui antara muka yang dipermudahkan (lihat Bahagian 3.2.2: Konfigurasi radio asas ). Antara muka yang dipermudahkan sepatutnya mencukupi untuk hampir semua kes penggunaan.

Mengawal aliran
Tab aliran kawalan (lihat Rajah 4) mengandungi beberapa pilihan konfigurasi asas seperti nama tindakan dan selang masa tamat tindakan. Nama tindakan bukan sahaja digunakan untuk paparan dalam graf alir tetapi juga dibawa ke kod sumber yang dijana.

• Tab aliran kawalan (lihat Rajah 4) mengandungi beberapa pilihan konfigurasi asas seperti nama tindakan dan selang masa tamat tindakan. Nama tindakan bukan sahaja digunakan untuk paparan dalam graf alir tetapi juga dibawa ke kod sumber yang dijana.
• Paling penting, tab aliran kawalan mengkonfigurasi keadaan yang bergantung pada peralihan kepada NextAction1 / NextAction2 serta selang peralihan dan bendera. Keadaan peralihan boleh dikonfigurasikan dengan mengklik pada butang berlabel "...", yang menjadikan dialog pemilihan topeng yang ditunjukkan dalam Rajah 5 muncul. Selang peralihan mengubah suai sifat NextAction1Interval / NextAction2Interval pada jadual RAM. Rujuk manual rujukan STM32WL3x [1] untuk mendapatkan maklumat lanjut tentang maksud selang ini dan kepentingan bendera SleepEn / ForceReload / ForceClear.
• Tambahan pula, penerangan ringkas tentang blok SeqAction boleh ditambah pada tab ini. Penerangan ini hanya digunakan untuk tujuan dokumentasi dan dibawa ke kod sumber yang dijana sebagai ulasan kod sumber.

Konfigurasi radio asas

Tab konfigurasi radio asas boleh dibahagikan kepada tiga bahagian:

1. Bahagian di bahagian atas di mana dua daripada parameter paling penting bagi sebarang tindakan dikonfigurasikan: arahan untuk dilaksanakan (TX, RX, NOP, SABORT dan sebagainya) dan, jika berkenaan, panjang paket untuk dipindahkan.
2. Bahagian di sebelah kiri di mana parameter radio sebenar seperti: kekerapan pembawa, kadar data, sifat modulasi, ambang penimbal data dan pemasa dikonfigurasikan.
3. Bahagian di sebelah kanan tempat gangguan CPU boleh didayakan secara individu. Pengendali gangguan dijana untuk setiap gangguan yang ditanda. Ini pada asasnya mengkonfigurasi kandungan daftar RFSEQ_IRQ_ENABLE.

Rujuk manual rujukan STM32WL3x [1] untuk maksud pelbagai parameter radio.

Konfigurasi radio lanjutan

• Jika pilihan konfigurasi yang didedahkan melalui tab konfigurasi radio asas (Bahagian 3.2.2: Konfigurasi radio asas) tidak mencukupi, tab konfigurasi radio STM32WL3x lanjutan membenarkan penetapan kandungan daftar dinamik sewenang-wenangnya. Tab konfigurasi lanjutan didayakan dengan menandakan kotak semak Konfigurasi Lanjutan di bahagian atas sebelah kanan antara muka konfigurasi tab.
• Tidak mustahil untuk menggunakan kedua-dua konfigurasi asas dan lanjutan pada masa yang sama, pengguna mesti memilih satu atau yang lain. Walau bagaimanapun, sudah tentu mungkin juga untuk mengedit kod sumber yang dihasilkan secara manual selepas itu dan menambah pilihan konfigurasi yang berpotensi hilang.

Dialog konfigurasi global

• Dialog "Tetapan Projek Global" boleh diakses melalui butang bar alat "Tetapan Global". Dialog mengandungi kedua-dua pilihan konfigurasi untuk kandungan daftar statik serta tetapan projek tambahan. Ambil perhatian bahawa hanya sebahagian kecil daripada pilihan konfigurasi daftar statik boleh dikonfigurasikan melalui dialog ini. Pilihan ini hanya disediakan untuk mempercepatkan aplikasi prototaip aplikasi dengan STM32CubeWiSE-RadioCodeGenerator.
• Ia biasanya dijangka bahawa kandungan daftar statik disediakan dalam kod sumber yang ditulis secara manual aplikasi.
• Maksud tetapan projek lain dijelaskan dalam dialog itu sendiri.
• Kod C tambahan yang dimasukkan sejurus sebelum mencipta jadual RAM Konfigurasi Global daripada kandungan daftar statik juga boleh disediakan. Medan ini boleh digunakan untuk menyediakan nilai daftar statik yang tidak boleh diakses melalui topeng konfigurasi daftar statik yang disediakan.

Penjanaan kod
Graf alir boleh diterjemahkan ke dalam kod sumber projek C yang lengkap dengan menekan butang Jana Kod dalam bar alat. Folder projek yang dijana tidak mengandungi projek files untuk IAR, Keil® atau GCC. Ini files mesti ditambah secara manual pada projek STMWL3x.
Ini ialah struktur folder projek yang dihasilkan:

Folder Projek

• inc
• SequencerFlowgraph.h: pengepala file untuk SequencerFlowgraph.c, statik. Jangan edit ini.
• stm32wl3x_hal_conf.h: konfigurasi HAL STM32WL3x file, statik.
• src
• SequencerFlowgraph.c: definisi flowgraph. Ini yang penting file yang menggunakan pemacu penjujukan untuk mentakrifkan jadual RAM konfigurasi global dan konfigurasi tindakan. Dijana secara automatik, jangan edit.
• utama.c: Projek utama file yang menunjukkan cara memuatkan dan menggunakan definisi graf aliran. Statik, ubah suai ini mengikut keperluan.
• Untuk mengedit main.c atau stm32wl3x_hal_conf.h, pilih kelakuan tulis ganti Simpan dalam tetapan projek. Dengan cara ini, hanya SequencerFlowgraph.c akan ditimpa.

Cara mengimport kod yang dijana ke dalam CubeMX example
Untuk mengimport projek yang dijana oleh STM32CubeWiSE-RadioCodeGenerator ke dalam bekas CubeMXample (MRSUBG_Skeleton), adalah perlu untuk mengikuti langkah-langkah berikut:

1. Buka folder yang mengandungi files dijana oleh STM32CubeWiSE-RadioCodeGenerator dan salin folder "Inc" dan "Src".
2. Tampalkan dua folder pada folder "MRSUBG_Skeleton" dengan menimpa dua folder yang sudah ada.
3. Buka projek "MRSUBG_Skeleton" dalam salah satu IDE berikut:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. Di dalam projek "MRSUBG_Skeleton", tambahkan "SequencerFlowghraph.c" file:
   • Untuk projek EWARM, laluan untuk menambah file adalah yang berikut: MRSUBG_Skeleton\Application\User
   • Untuk projek MDK-ARM, laluan untuk menambah file adalah yang berikut: MRSUBG_Skeleton\Application/User
   • Untuk projek STM32CubeIDE, laluan untuk menambah file adalah sama:
     MRSUBG_Skeleton\Application\User
5. Di dalam projek MRSUBG_Skeleton, tambahkan stm32wl3x_hal_uart.c dan stm32wl3x_hal_uart_ex.c files ke laluan berikut: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. Laluan adalah sama untuk semua IDE. Kedua-duanya files terletak pada Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. Untuk menggunakan ciri COM, stm32wl3x_nucleo_conf.h file, terletak pada Perisian Tegar\Projek\NUCLEOWL33CC\ Cthamples\MRSUBG\MRSUBG_Skeleton\Inc, mesti diubah suai tetapan USE_BSP_COM_FEATURE dan USE_COM_LOG kepada 1U:
7. Salin kod berikut ke dalam "stm32wl3x_it.c", yang terdapat dalam MRSUBG_Skeleton\Application\User.

Graf alir examples

• Empat bekasample flowgraphs disediakan bersama kod sumber. Bekas iniamples boleh dimuatkan ke dalam STM32CubeWiSE-RadioCodeGenerator dengan mengklik butang "Muat" dalam bar alat.

AutoACK_RX

• Demo Auto-ACK menggambarkan bagaimana dua peranti STM32WL3x boleh bercakap antara satu sama lain secara automatik dengan campur tangan CPU yang minimum, dengan bantuan perkakasan penjujukan.
• Graf alir ini melaksanakan gelagat (Auto-Transmit-ACK) peranti A. Dalam peranti A, penjujukan dimulakan dalam keadaan menerima (WaitForMessage), di mana ia menunggu mesej tiba.
• Sebaik sahaja mesej yang sah tiba, penjujukan secara automatik beralih ke keadaan penghantaran (TransmitACK), di mana paket ACK dihantar sebagai tindak balas, tanpa campur tangan CPU. Setelah ini selesai, penjujukan ditetapkan semula ke keadaan WaitForMessage awalnya.
• Graf alir ini melaksanakan kelakuan yang sama seperti MRSUBG_SequencerAutoAck_Rx example daripada Exampfolder les\MRSUBG bagi pakej Perisian STM32Cube WL3. Jika AutoACK_RX dipancarkan pada satu peranti
  A, dan AutoACK_TX dipancarkan pada sesetengah peranti, B, kedua-dua peranti menghantar mesej ke sana ke mari, seperti dalam permainan ping-pong.

AutoACK_TX

• Demo "Auto-ACK" menggambarkan bagaimana dua peranti STM32WL3x boleh bercakap antara satu sama lain secara automatik dengan campur tangan CPU yang minimum dengan bantuan perkakasan penjujukan.
• Graf alir ini melaksanakan gelagat ("Auto-Tunggu-untuk-ACK") peranti B. Dalam peranti B, penjujukan dimulakan dalam keadaan penghantaran (TransmitMessage), di mana ia menghantar mesej. Setelah penghantaran selesai, ia secara automatik beralih ke keadaan menerima di mana ia menunggu pengakuan daripada peranti A (WaitForACK). Sebaik sahaja pengakuan yang sah tiba, penjujukan ditetapkan semula ke keadaan TransmitMessage awalnya dan keseluruhan proses bermula semula. Sekiranya tiada ACK diterima dalam masa 4 saat, tamat masa akan dicetuskan dan penjujukan kembali kepada keadaan TransmitMessage.
• Graf alir ini melaksanakan kelakuan yang sama seperti "MRSUBG_SequencerAutoAck_Tx" example daripada Exampfolder les\MRSUBG bagi pakej Perisian STM32Cube WL3. Jika AutoACK_RX dipancarkan pada satu peranti, A, dan AutoACK_TX dipancarkan pada beberapa peranti lain, B, kedua-dua peranti menghantar mesej ke sana ke mari, seperti dalam permainan ping-pong.

Dengar sebelum bercakap (LBT)

• bekas iniample diambil daripada manual rujukan STM32WL3x [1]. Rujuk manual itu untuk butiran lanjut tentang bekas iniample.

Mod menghidu

• bekas iniample diambil daripada manual rujukan STM32WL3x [1]. Rujuk manual itu untuk butiran lanjut tentang bekas iniample.

Sejarah semakan

Jadual 2. Sejarah semakan dokumen

tarikh	Versi	Perubahan
21-Nov-2024	1	Keluaran awal.
10-Feb-2025	2	Nama peranti dikemas kini kepada skop STM32WL3x.

NOTIS PENTING – BACA DENGAN TELITI

• STMicroelectronics NV dan anak syarikatnya (“ST”) berhak untuk membuat perubahan, pembetulan, penambahbaikan, pengubahsuaian dan penambahbaikan pada produk ST dan/atau pada dokumen ini pada bila-bila masa tanpa notis. Pembeli hendaklah mendapatkan maklumat terkini berkaitan produk ST sebelum membuat pesanan. Produk ST dijual menurut terma dan syarat jualan ST yang ada pada masa penerimaan pesanan.
• Pembeli bertanggungjawab sepenuhnya untuk pilihan, pemilihan dan penggunaan produk ST dan ST tidak bertanggungjawab untuk bantuan permohonan atau reka bentuk produk pembeli.
• Tiada lesen, nyata atau tersirat, kepada mana-mana hak harta intelek diberikan oleh ST di sini.
• Jualan semula produk ST dengan peruntukan yang berbeza daripada maklumat yang dinyatakan di sini akan membatalkan sebarang waranti yang diberikan oleh ST untuk produk tersebut.
• ST dan logo ST ialah tanda dagangan ST. Untuk maklumat tambahan tentang tanda dagangan ST, rujuk www.st.com/trademarks. Semua nama produk atau perkhidmatan lain adalah hak milik pemilik masing-masing.
• Maklumat dalam dokumen ini menggantikan dan menggantikan maklumat yang dibekalkan sebelum ini dalam mana-mana versi terdahulu dokumen ini.
• © 2025 STMicroelectronics – Hak cipta terpelihara

Soalan Lazim

• S: Apakah keperluan sistem minimum untuk STM32CubeWiSE-RadioCodeGenerator?
  • A: Keperluan sistem minimum termasuk sekurang-kurangnya 2 Gbytes RAM, port USB dan pembaca Adobe Acrobat 6.0.
• S: Bagaimanakah saya boleh menyediakan pakej perisian STM32CubeWiSE-RadioCodeGenerator?
  • A: Untuk menyediakan pakej perisian, ekstrak kandungan zip yang disediakan file ke dalam direktori sementara dan lancarkan boleh laku file mengikut arahan pada skrin.

Dokumen / Sumber

STMicroelectronics UM3399 STM32Cube Penjana Kod Radio WiSE [pdf] Manual Pengguna UM3399, UM3399 STM32 Cube WiSE Penjana Kod Radio, UM3399, STM32, Cube WiSE Penjana Kod Radio, Penjana Kod Radio, Penjana Kod, Penjana

Rujukan

• Manual Pengguna