I-STM32WL3x Microcontrollers

Imiyalo yokusetshenziswa komkhiqizo

• Iphakheji ye-STM32CubeWL3 ihlanganisa i-low-layer (LL) kanye ne-hardware abstraction layer (HAL) APIs emboza i-microcontroller hardware.
• Iphinde inikeze izingxenye ze-middleware njenge-SigfoxTM, i-FatFS, ne-FreeRTOS kernel.
• Iphakheji iza ne-exampama-les kanye nezicelo ukuze kusetshenziswe kalula.
• Isakhiwo se-STM32CubeWL3 sakhiwe ngamazinga amathathu: Izicelo, i-HAL, ne-LL.
• I-HAL kanye ne-LL APIs ihlanganisa izinhlobonhlobo zezidingo zohlelo lokusebenza.
• I-HAL inikeza ukusetshenziswa okuyisisekelo kwe-peripheral examples, futhi i-LL inikeza izindlela ezisezingeni eliphansi.
• Leli zinga lihlanganisa Iphakheji Lokusekela Ibhodi (BSP) kanye nama-sublayers e-HAL.
• I-BSP inikeza ama-API wezingxenye zehadiwe emabhodini, kuyilapho i-HAL inikeza ukusetshenziswa okuyisisekelo kwe-peripheral exampLes.
• Abashayeli be-BSP baxhumanisa abashayeli bezingxenye kumabhodi athile, okwenza kube lula ukuthuthwa kwezinye izingxenyekazi zekhompyutha.
• I-STM32CubeWL3 HAL ne-LL ayahambisana, afaka izidingo eziningi zohlelo lokusebenza.
• Abasebenzisi bangasebenzisa lawa ma-API ukuze asebenzisane ne-microcontroller hardware kahle.

Isingeniso

I-STM32Cube iwuhlelo lokuqala lwe-STMicroelectronics lokuthuthukisa ukukhiqiza komklami kakhulu ngokunciphisa umzamo wokuthuthukisa, isikhathi, kanye nezindleko. I-STM32Cube ihlanganisa yonke iphothifoliyo ye-STM32. I-STM32Cube ihlanganisa:

I-STM32Cube ihlanganisa:

• Iqoqo lamathuluzi okuthuthukisa isofthiwe asebenziseka kalula ukumboza ukuthuthukiswa kwephrojekthi kusukela ekuqanjweni kuya ekufezekeni, phakathi kwawo okuhlanganisa:
  • I-STM32CubeMX, ithuluzi lokumisa isoftware elinemifanekiso evumela ukukhiqizwa okuzenzakalelayo kwekhodi yokuqalisa ye-C kusetshenziswa izangoma zegraphic.
  • I-STM32CubeIDE, ithuluzi lokuthuthukisa konke-in-one elinokucushwa kwe-peripheral, ukukhiqizwa kwekhodi, ukuhlanganisa amakhodi, nezici zokususa iphutha.
  • I-STM32CubeCLT, ithuluzi lokuthuthukisa umugqa womyalo we-in-one kanye nokuhlanganiswa kwekhodi, ukuhlelwa kwebhodi, nezici zokususa iphutha.
  • I-STM32CubeProgrammer (STM32CubeProg), ithuluzi lokuhlela elitholakala kuzinguqulo zegraphical kanye ne-command-line
  • I-STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), amathuluzi okuqapha anamandla okulungisa ukuziphatha nokusebenza kwezinhlelo zokusebenza ze-STM32 ngesikhathi sangempela.
• I-STM32Cube MCU kanye ne-MPU Packages, amapulatifomu esofthiwe ashumekiwe aphelele aqondene nochungechunge ngalunye lwe-microcontroller kanye ne-microprocessor (njenge-STM32CubeWL3 yomugqa womkhiqizo we-STM32WL3x), ohlanganisa:
  • I-STM32Cube hardware abstraction layer (HAL), eqinisekisa ukuphatheka okuphezulu kuyo yonke iphothifoliyo ye-STM32
  • I-STM32Cube low-layer APIs, iqinisekisa ukusebenza okungcono kakhulu nezinyathelo zezinyawo ezinezinga eliphezulu lokulawula komsebenzisi phezu kwehadiwe.
  • Isethi engaguquki yezingxenye ze-middleware ezifana ne-FreeRTOS™ kernel, i-FatFS, ne-Sigfox™
  • Zonke izinsiza zesofthiwe ezishumekiwe ezinamasethi agcwele we-peripheral kanye nama-ex asebenzayoampLes
• I-STM32Cube Expansion Packages, equkethe izingxenye zesofthiwe ezishumekiwe ezihambisana nokusebenza kwe-STM32Cube MCU kanye namaPhakheji e-MPU ane:
  • Izandiso ze-Middleware nezendlalelo ezisebenzayo
  • Exampisebenza kwamanye amabhodi okuthuthukisa ama-STMicroelectronics
• Le manuwali yomsebenzisi ichaza ukuthi ungaqala kanjani ngePhakheji ye-STM32CubeWL3 MCU.

Isigaba sesi-2 sichaza izici eziyinhloko ze-STM32CubeWL3 futhi Isigaba 3 sinikeza i-overview yezakhiwo zayo kanye nesakhiwo sePhakheji ye-MCU.

ulwazi oluvamile

• I-STM32CubeWL3 isebenzisa izinhlelo zokusebenza zokubonisa ezingaphansi kwe-GHz, okuhlanganisa okuhamba ngakubili kwe-Sigfox™, kuma-microcontrollers omugqa womkhiqizo we-STM32WL3x asekelwe ku-Arm® Cortex®‑M0+ processor.
• Izilawuli ezincane ze-STM32WL3x zishumeka i-STMicroelectronics's state-of-the-art sub-GHz sub-GHz radio peripheral, elungiselelwe ukusetshenziswa kwamandla aphansi nokusebenza okuhle kakhulu komsakazo, ukuphila kwebhethri okungenakuqhathaniswa.

Qaphela: I-Arm inguphawu lokuthengisa olubhalisiwe lwe-Arm Limited (noma izinkampani ezingaphansi kwayo) e-US kanye/noma kwenye indawo.

Izici eziphambili ze-STM32CubeWL3

• Iphakheji ye-STM32CubeWL3 MCU isebenza kuma-STM32 32-bit microcontrollers asekelwe ku-Arm® Cortex®‑M0+ processor. Iqoqa, kuphakheji eyodwa, zonke izingxenye zesofthiwe ezishunyekiwe ezidingekayo ukuze kuthuthukiswe uhlelo lokusebenza Umugqa womkhiqizo we-STM32WL3x ama-microcontroller.
• Iphakheji ihlanganisa ungqimba oluphansi (LL) kanye ne-hardware abstraction layer (HAL) APIs emboza i-microcontroller hardware, kanye nesethi ebanzi ye-ex.ampLes esebenza kumabhodi e-STMicroelectronics. I-HAL kanye ne-LL APIs ayatholakala kulayisensi ye-BSD yomthombo ovulekile ukuze kube lula umsebenzisi. Kufaka phakathi izingxenye ze-Sigfox™, FatFS, kanye neFreeRTOS™ kernel middleware.
• I-STM32CubeWL3 MCU Package futhi ihlinzeka ngezinhlelo zokusebenza ezimbalwa nemibukiso isebenzisa zonke izingxenye zayo ze-middleware.
• Isakhiwo sengxenye yephakheji ye-STM32CubeWL3 MCU sikhonjiswe kuMfanekiso 1.

Ukwakhiwa kwe-STM32CubeWL3 ngaphezuluview

• Isixazululo sePhakheji ye-STM32CubeWL3 MCU sakhiwe ngamaleveli amathathu azimele asebenzisana kalula njengoba kuchazwe kuMfanekiso 2.

Ileveli 0
Leli zinga lihlukaniswe ngama-sublayers amathathu:

• Iphakheji yokusekela ibhodi (BSP).
• Isendlalelo se-Hardware abstraction (HAL):
  • HAL abashayeli be-peripheral
  • Abashayeli bezinga eliphansi
• Ukusetshenziswa okuyisisekelo kwe-peripheral exampLes.

Iphakheji yosekelo lwebhodi (BSP)
Lesi sendlalelo sinikeza isethi yama-API ahlobene nezingxenyekazi zehadiwe kumabhodi wehadiwe (njengama-LED, izinkinobho, nezishayeli ze-COM). Yakhiwe izingxenye ezimbili:

Isakhi:

• Lona umshayeli ohlobene nedivayisi yangaphandle ebhodini hhayi ku-STM32. Umshayeli wengxenye uhlinzeka ngama-API athile kumshayeli we-BSP izingxenye zangaphandle futhi angaphatheka kunoma yiliphi elinye ibhodi.
  • Umshayeli we-BSP:
• Ivumela ukuxhumanisa abashayeli bengxenye ebhodini elithile futhi inikeza isethi yama-API asebenziseka kalula. Umthetho wokuqamba we-API uthi BSP_FUNCT_Action().
• Exampi-le: BSP_LED_Init(), BSP_LED_On()

I-BSP isuselwe ekwakhiweni kwe-modular evumela ukuthuthwa kalula kunoma iyiphi ihadiwe ngokuvele isebenzise imizila yezinga eliphansi.

Isendlalelo se-Hardware abstraction (HAL) kanye nesendlalelo esiphansi (LL)

I-STM32CubeWL3 HAL ne-LL iyahambisana futhi ihlanganisa izidingo eziningi zohlelo lokusebenza:

• Abashayeli be-HAL banikeza ama-API aphathekayo asezingeni eliphezulu agxile ekusebenzeni. Bafihla i-MCU nobunkimbinkimbi be-peripheral kumsebenzisi wokugcina.
  Izishayeli ze-HAL zihlinzeka ngama-API ajwayelekile anezici eziningi, enza kube lula ukusetshenziswa kohlelo lokusebenza ngokuhlinzeka ngezinqubo ezilungele ukusetshenziswa. Okwesiboneloample, kuma-peripherals okuxhumana (i-I2C, i-UART, nezinye), ihlinzeka ngama-API avumela ukuqalisa nokulungisa i-peripheral, ukuphatha ukudluliswa kwedatha okusekelwe ekuvoteni, ukuphazamisa, noma inqubo ye-DMA, kanye nokusingatha amaphutha okuxhumana angase avele ngesikhathi sokuxhumana. I-HAL driver APIs ihlukaniswe izigaba ezimbili:
  • Ama-Generic API, ahlinzeka ngemisebenzi evamile nejwayelekile kuwo wonke ama-microcontroller ochungechunge lwe-STM32.
  • Ama-API Esandiso, ahlinzeka ngemisebenzi ethile futhi eyenziwe ngendlela oyifisayo yomndeni othile noma inombolo ethile yengxenye.
• Ama-API anesendlalelo esiphansi ahlinzeka ngama-API asezingeni eliphansi ezingeni lokubhalisa, ngokulungiselelwa okungcono kodwa ukuphatheka kancane.
  Badinga ulwazi olujulile lwe-MCU kanye nokucaciswa kwe-peripheral.
  Amashayeli e-LL aklanyelwe ukunikeza isendlalelo esisheshayo esingasindi, esigxile kuchwepheshe esiseduze nehadiwe kune-HAL. Ngokuphambene ne-HAL, ama-LL API awanikeziwe kuma-peripherals lapho ukufinyelela okulungiselelwe kungesona isici esiyinhloko, noma kulawo adinga ukulungiselelwa kwesofthiwe esindayo noma isitaki sezinga eliphezulu.
  Abashayeli be-LL bafaka:
• Isethi yemisebenzi yokuqalisa izici eziyinhloko ze-peripheral ngokuya ngamapharamitha acaciswe kuzakhiwo zedatha.
• Isethi yemisebenzi yokugcwalisa izakhiwo zedatha yokuqalisa ngamavelu okusetha kabusha ahambisana nenkambu ngayinye.
• Umsebenzi wokukhishwa kwe-peripheral de-initialization (amarejista aseduze abuyiselwe kumanani awo azenzakalelayo).
• Iqoqo lemisebenzi esemgqeni wokufinyelela okuqondile nerejista ye-athomu.
• Ukuzimela okugcwele ku-HAL kanye namandla okusetshenziswa kumodi ezimele (ngaphandle kwamashayeli e-HAL).
• Ukufakwa okugcwele kwezici ezisekelwa yi-peripheral.

Ukusetshenziswa okuyisisekelo kwe-peripheral exampLes
Lesi sendlalelo sifaka i-exampLes eyakhelwe phezu kwama-peripherals e-STM32 kusetshenziswa izinsiza ze-HAL ne-BSP kuphela.
Qaphela: Isibampama-les ayatholakala ukuze abonise i-ex eyinkimbinkimbiample zimo ezinama-peripherals athile, njenge-MRSUBG ne-LPAWUR.

Ileveli 1
Leli zinga lihlukaniswe ngama-sublayers amabili:

• Izingxenye ze-Middleware
• Exampkancane ngokusekelwe ezingxenyeni ze-middleware

Izingxenye ze-Middleware
I-middleware iqoqo lemitapo yolwazi emboza i-FreeRTOS™ kernel, i-FatFS, nelabhulali yephrothokholi ye-Sigfox™.
Ukusebenzisana okuvundlile phakathi kwezingxenye zalesi sendlalelo kwenziwa ngokubiza ama-API afakiwe.
Ukusebenzisana okuqondile namashayeli asezingeni eliphansi kwenziwa ngokuphinda kushayelwe okuthile kanye namamakhro amile asetshenziswa kusixhumi sezingcingo sesistimu yelabhulali.
Izici eziyinhloko zengxenye ngayinye ye-middleware yilezi ezilandelayo:

• I-FreeRTOS™ kernel: isebenzisa isistimu yokusebenza yesikhathi sangempela (RTOS), eyenzelwe amasistimu ashumekiwe.
• I-Sigfox™: isebenzisa ilabhulali yephrothokholi ye-Sigfox™ ehambisana nenethiwekhi yephrothokholi ye-Sigfox™ futhi ihlanganisa nomtapo wezincwadi we-RF wokuhlola wephrothokholi ukuhlola ngamathuluzi e-RF Sigfox™.
• I-FatFS: isebenzisa i-FAT ejwayelekile file module yesistimu.

Exampkancane ngokusekelwe ezingxenyeni ze-middleware

• Ingxenye ngayinye ye-middleware iza ne-ex eyodwa noma ngaphezuluamples, ebizwa nangokuthi izinhlelo zokusebenza, ekhombisa ukuthi isetshenziswa kanjani.
• Ukuhlanganisa examples ezisebenzisa izingxenye eziningana ze-middleware zinikezwa futhi.

Iphakheji ye-firmware ye-STM32CubeWL3 isiphelileview

Amadivayisi we-STM32WL3x asekelwe nehadiwe

• I-STM32Cube inikeza ungqimba oluphathekayo lwe-hardware abstraction (HAL) olwakhiwe eduze kwesakhiwo esijwayelekile. Ivumela isimiso sezendlalelo ezakhelwe phezu, njengokusebenzisa isendlalelo se-middleware ukwenza imisebenzi yazo ngaphandle kokwazi, ngokujulile, ukuthi i-MCU isetshenziswa ini. Lokhu kuthuthukisa ukusetshenziswa kabusha kwekhodi yelabhulali futhi kuqinisekisa ukuphatheka kalula kwamanye amadivaysi.
• Ngaphezu kwalokho, nge-architecture yayo enezingqimba, I-STM32CubeWL3 inikeza ukwesekwa okugcwele kwawo wonke umugqa womkhiqizo we-STM32WL3x.
• Umsebenzisi kufanele achaze kuphela i-macro elungile kokuthi stm32wl3x.h.
• Ithebula 1 libonisa i-macro okufanele ichazwe kuye ngedivayisi yomugqa womkhiqizo we-STM32WL3x esetshenzisiwe. Le macro kumele futhi ichazwe ku-preprocessor ye-compiler.

Ithebula 1. Ama-Macros omugqa womkhiqizo we-STM32WL3x

Imakhro ichazwe ku I-STM32WL3X.h	STM32WL3x amadivayisi womugqa womkhiqizo
stm32wl3x	STM32WL30xx microcontrollers STM32WL31xx microcontrollers STM32WL33xx microcontrollers

Ithebula 2. Amabhodi omugqa womkhiqizo we-STM32WL3x

Ibhodi	Ibhodi le-STM32WL3x amadivayisi asekelwayo
I-NUCLEO-WL33CC1	Idatha ye-STM32WL33CC
I-NUCLEO-WL33CC2	Idatha ye-STM32WL33CC

I-STM32CubeWL3 MCU Iphakheji ingasebenza kunoma iyiphi ihadiwe ehambisanayo. Abasebenzisi babuyekeza abashayeli be-BSP ukuze bafake i-ex enikeziweampamabhodi abo, uma lezi zinezici zehadiwe ezifanayo (njengama-LED noma izinkinobho).

Iphakheji ye-Firmware iphelileview

• Isixazululo sePhakheji ye-STM32CubeWL3 MCU sinikezwa ngephakheji ye-zip eyodwa, nesakhiwo esiboniswe kuMfanekiso 3.

Isexwayiso: Umsebenzisi akufanele aguqule izingxenye files. Umsebenzisi angahlela kuphela imithombo \Amaphrojekthi. Ebhodini ngalinye, isethi ye-exampI-les ihlinzekwa ngamaphrojekthi alungiselelwe kusengaphambili we-EWARM, MDK-ARM, kanye ne-STM32CubeIDE yamathuluzi.
Umfanekiso wesi-4 ubonisa isakhiwo sephrojekthi samabhodi e-NUCLEO-WL33CCx.

I-exampama-les ahlukaniswa kuya ngezinga le-STM32CubeWL3 asebenza kulo. Aqanjwe kanje:

• Ileveli 0 isibamplezi zibizwa ngokuthi Eksamplesi, EksampLes_LL, kanye ne-Exampokuncane_MIX. Basebenzisa ngokulandelana abashayeli be-HAL, abashayeli be-LL, kanye nengxube yabashayeli be-HAL ne-LL ngaphandle kwengxenye ye-middleware. Isibamples nazo ziyatholakala.
• Ileveli 1 isibamplezi zibizwa ngokuthi Izinhlelo. Banikeza izimo zokusetshenziswa ezijwayelekile zengxenye ngayinye ye-middleware.

Noma yiluphi uhlelo lokusebenza lwe-firmware lwebhodi elinikeziwe lungakhiwa ngokushesha kusetshenziswa amaphrojekthi esifanekiso atholakala kunkhombandlela Yezifanekiso Nezifanekiso_LL.
Examplesi, EksampLes_LL, kanye ne-ExampI-less_MIX inesakhiwo esifanayo:

• \Inc ifolda equkethe wonke unhlokweni files.
• \Src ifolda equkethe ikhodi yomthombo.
• \EWARM, \MDK-ARM, kanye \STM32CubeIDE amafolda aqukethe iphrojekthi elungiselelwe kusengaphambili yochungechunge lwamathuluzi ngalunye.
• readme.md kanye ne-readme.html echaza i-exampukuziphatha kanye nendawo edingekayo ukuze kusebenze.

Ukuqalisa nge-STM32CubeWL3

Ukugijima i-ex yokuqalaample
Lesi sigaba sichaza ukuthi kulula kangakanani ukuqhuba i-ex yokuqalaampngaphakathi kwe-STM32CubeWL3. Isebenzisa njengomfanekiso ukukhiqizwa koguquko olulula lwe-LED olusebenza ebhodini le-NUCLEO-WL33CC1:

1. Landa iphakheji ye-STM32CubeWL3 MCU.
2. Yivule, noma sebenzisa isifaki uma sihlinzekiwe, kuhla lwemibhalo oluthandayo.
3. Qiniseka ukuthi awuguquli ukwakheka kwephakheji eboniswe kuMfanekiso 3. Isakhiwo sephakheji ye-firmware ye-STM32CubeWL3. Qaphela ukuthi kuyanconywa futhi ukukopisha iphakheji endaweni eseduze nevolumu yempande (okusho C:\ST noma G:\Tests), njengoba amanye ama-IDE ahlangabezana nezinkinga lapho indlela yinde kakhulu.

Isebenza kanjani i-HAL example
Ngaphambi kokulayisha nokusebenzisa i-example, kunconywa kakhulu ukufunda i-exampngifunde file nganoma yikuphi ukucushwa okuthile.

1. Phequlula kokuthi \Projects\NUCLEO-WL33CC\ExampLes.
2. Vula \GPIO, bese \GPIO_EXTI amafolda.
3. Vula iphrojekthi ngochungechunge lwamathuluzi olukhethwayo. Ukudlula ngokusheshaview mayelana nendlela yokuvula, ukwakha, nokusebenzisa i-exampI-le enamaketanga amathuluzi asekelwayo inikezwe ngezansi.
4. Yakha kabusha konke files bese ulayisha isithombe kumemori eqondiwe.
5. Gijimani i-example. Ukuze uthole imininingwane eyengeziwe, bheka i-exampngifunde file.

Ukuvula, ukwakha, nokusebenzisa i-example ngochungechunge lwamathuluzi asekelwayo, landela lezi zinyathelo ezingezansi:

• I-EWARM:
  1. Ngaphansi kwe-Examples ifolda, vula ifolda engaphansi \EWARM.
  2. Yethula indawo yokusebenza ye-Project.eww (igama lendawo yokusebenza lingase lishintshe lisuka kwelinye example komunye).
  3. Yakha kabusha konke files: [Iphrojekthi]>[Yakha kabusha konke].
  4. Layisha isithombe sephrojekthi: [Iphrojekthi]>[Susa iphutha].
  5. Qalisa uhlelo: [Susa iphutha]>[Hamba (F5)].
• I-MDK-ARM:
  1. Ngaphansi kwe-Examples ifolda, vula ifolda engaphansi \MDK-ARM.
  2. Vula indawo yokusebenza ye-Project.uvproj (igama lendawo yokusebenza lingase lishintshe kusukela kumuntu oyedwaample komunye).
  3. Yakha kabusha konke files: [Iphrojekthi]>[Yakha kabusha konke okuhlosiwe files].
  4. Layisha isithombe sephrojekthi: [Susa iphutha]>[Qala/Misa Iseshini Yokususa iphutha].
  5. Qalisa uhlelo: [Susa iphutha]>[Sebenzisa (F5)].
• I-STM32CubeIDE:
  1. Vula i-STM32CubeIDE toolchain.
  2. Chofoza ku-[File]>[Shintsha Indawo Yokusebenzela]>[Okunye] bese upheqa ohlwini lwemibhalo lwendawo yokusebenza ye-STM32CubeIDE.
  3. Chofoza ku-[File]>[Ngenisa], khetha okuthi [Okuvamile]>[Amaphrojekthi Akhona Endaweni Yokusebenzela], bese uchofoza [Okulandelayo].
  4. Phequlula kumkhombandlela wendawo yokusebenza ye-STM32CubeIDE bese ukhetha iphrojekthi.
  5. Yakha kabusha yonke iphrojekthi files: Khetha iphrojekthi kuwindi le-Project Explorer bese uchofoza kumenyu ethi [Project]>[Yakha iphrojekthi].
  6. Qalisa uhlelo: [Qalisa]>[Susa iphutha (F11)].

Ukwakha uhlelo lokusebenza olungokwezifiso

Ukusebenzisa i-STM32CubeMX ukuthuthukisa noma ukubuyekeza uhlelo lokusebenza

• KuPhakheji ye-STM32Cube MCU, cishe wonke amaphrojekthi exampama-les akhiqizwa ngethuluzi le-STM32CubeMX ukuqalisa uhlelo, ama-peripherals, kanye ne-middleware.

Ukusetshenziswa okuqondile kwephrojekthi ekhona example kusuka kuthuluzi le-STM32CubeMX idinga i-STM32CubeMX 6.12.0 noma ngaphezulu:

• Ngemva kokufakwa kwe-STM32CubeMX, vula futhi uma kunesidingo ubuyekeze iphrojekthi ehlongozwayo.
  Indlela elula yokuvula iphrojekthi ekhona ukuchofoza kabili ku-*.ioc file ukuze i-STM32CubeMX ivule ngokuzenzakalelayo iphrojekthi kanye nomthombo wayo files. I-STM32CubeMX ikhiqiza ikhodi yomthombo yokuqalisa yamaphrojekthi anjalo.
• Ikhodi yomthombo wohlelo lokusebenza eyinhloko iqukethe amazwana "USER CODE BEGIN" kanye "USER CODE END". Uma okukhethiwe nezilungiselelo kushintshwa, i-STM32CubeMX ibuyekeza ingxenye yokuqalisa yekhodi kuyilapho ilondoloza ikhodi yomthombo wohlelo lokusebenza eyinhloko.
• Ukwakha iphrojekthi yangokwezifiso nge-STM32CubeMX, landela inqubo yesinyathelo nesinyathelo:
  1. Lungiselela yonke isofthiwe eshumekiwe edingekayo usebenzisa isixazululi sengxabano ye-pinout, umsizi wokusetha isihlahla sewashi, isibali sokusebenzisa amandla, kanye nensiza eyenza ukulungiselelwa okuzungezile kwe-MCU (okufana ne-GPIO noma i-USART).
  2. Khiqiza ikhodi yokuqalisa C ngokusekelwe ekucushweni okukhethiwe. Le khodi isilungele ukusetshenziswa ngaphakathi kwezimo ezimbalwa zokuthuthukiswa. Ikhodi yomsebenzisi igcinwa ekukhiqizeni ikhodi elandelayo.
     Ukuze uthole ulwazi olwengeziwe mayelana ne-STM32CubeMX, bheka imanuwali yomsebenzisi i-STM32CubeMX yokucushwa kwe-STM32 nokuqalisa ukukhiqiza ikhodi ye-C (UM1718).

Izinhlelo zokusebenza zomshayeli
Uhlelo lokusebenza lwe-HAL
Lesi sigaba sichaza izinyathelo ezidingekayo ukuze udale uhlelo lwe-HAL ngokwezifiso usebenzisa i-STM32CubeWL3

1. Dala iphrojekthi
   Ukuze udale iphrojekthi entsha, qala kusukela kuphrojekthi yesifanekiso enikezwe ibhodi ngalinye ngaphansi kokuthi \Amaphrojekthi\ \Izifanekiso noma kunoma iyiphi iphrojekthi etholakalayo ngaphansi kokuthi \Amaphrojekthi\ \Eksamples noma \Proj ects\ \Izicelo (lapho ibhekisela egameni lebhodi).
   Iphrojekthi Yesifanekiso inikeza umsebenzi weluphu oyinhloko ongenalutho. Nokho, kuyisiqalo esihle ukuqonda izilungiselelo zephrojekthi ye-STM32CubeWL3. Isifanekiso sinezici ezilandelayo:
   • Iqukethe ikhodi yomthombo ye-HAL, i-CMSIS, nezishayeli ze-BSP, okuyisethi encane yezingxenye ezidingekayo ukuze kwakhiwe ikhodi ebhodini elinikeziwe.
   • Iqukethe izindlela ezifakiwe zazo zonke izingxenye ze-firmware.
   • Ichaza amadivayisi womugqa womkhiqizo we-STM32WL3x asekelwayo, ovumela abashayeli be-CMSIS ne-HAL ukuthi bacushwe ngendlela efanele.
   • Ihlinzeka ngomsebenzisi olungele ukusetshenziswa filekulungiselelwe ngaphambili njengoba kukhonjisiwe ngezansi:
   • I-HAL iqaliswe ngesisekelo sesikhathi esimisiwe nge-Arm® core SysTick.
   • I-SysTick ISR isetshenziselwa i-HAL_Delay() injongo.
   • Qaphela: Uma ukopisha iphrojekthi ekhona kwenye indawo, qiniseka ukuthi zonke izindlela ezifakiwe zibuyekeziwe.
2. Lungiselela izingxenye ze-firmware
   Izingxenye ze-HAL ne-middleware zinikeza isethi yezinketho zokumisa isikhathi sokwakha kusetshenziswa ama-macros #define amenyezelwe kunhlokweni. file. Ukucushwa kwesifanekiso file inikezwa ngaphakathi kwengxenye ngayinye, okufanele ikopishelwe kufolda yephrojekthi (imvamisa ukucushwa file ibizwa ngokuthi xxx_conf_template.h, ucezu
   • isifanekiso sidinga ukususwa lapho sikopishwa kufolda yephrojekthi). Ukucushwa file inikeza ulwazi olwanele ukuqonda umthelela wenketho ngayinye yokumisa. Ulwazi oluningiliziwe luyatholakala kumadokhumenti anikezwe ingxenye ngayinye.
3. Qala umtapo wezincwadi we-HAL
   Ngemva kokugxumela kuhlelo oluyinhloko, ikhodi yohlelo lokusebenza kufanele ibize i-HAL_Init() API ukuze iqalise umtapo wezincwadi we-HAL, owenza imisebenzi elandelayo:
   • Ukucushwa kokulanda kuqala kwememori ye-flash kanye nokubalulekile kokuphazamisa kwe-SysTick (ngama-macros achazwe ku-stm32 wl3x_hal_conf.h).
   • Ukucushwa kwe-SysTick ukuze kukhiqizwe ukuphazamiseka njalo nge-millisecond ekuphazamiseni okubalulekile kwe-SysTick TICK_INT_PRIO okuchazwe kokuthi stm32wl3x_hal_conf.h.
   • Ukusetha okubalulekile kweqembu le-NVIC ku-0.
   • Ikholi ye-HAL_MspInit() umsebenzi wokuphinda ushaye ichazwe kumsebenzisi we-stm32wl3x_hal_msp.c file ukwenza ukuqaliswa kwezingxenyekazi zekhompuyutha ezingeni eliphansi lomhlaba jikelele.
4. Lungiselela iwashi lesistimu
   Ukucushwa kwewashi lesistimu kwenziwa ngokubiza ama-API amabili achazwe ngezansi:
   • HAL_RCC_OscConfig(): le API ilungiselela ama-oscillator angaphakathi nangaphandle. Umsebenzisi uyakhetha
     lungisa i-oscillator eyodwa noma zonke.
   • HAL_RCC_ClockConfig(): le API ilungiselela umthombo wewashi lesistimu, ukubambezeleka kwememori ye-flash, kanye nezikali ze-AHB ne-APB.
5. Qalisa i-peripheral
   • Okokuqala bhala umsebenzi wokuqalisa we-peripheral. Qhubeka kanje:
   • Nika amandla iwashi elijikelezayo.
   • Lungiselela i-peripheral GPIOs.
   • Lungiselela isiteshi se-DMA futhi unike amandla ukuphazamiseka kwe-DMA (uma kudingeka).
   • Nika amandla ukuphazamiseka kwe-peripheral (uma kudingeka).
   • Hlela i-stm32xxx_it.c ukuze ushayele izibambi zokuphazamisa ezidingekayo (i-peripheral ne-DMA), uma kudingeka.
   • Bhala inqubo ephelele yokuphinda ushayele imisebenzi uma ukuphazamisa kwe-peripheral noma i-DMA ihloselwe ukusetshenziswa.
   • Kumsebenzisi oyinhloko.c file, qalisa isakhiwo sesibambo se-peripheral bese ubiza umsebenzi wokuqalisa we-peripheral ukuze uqalise i-peripheral.
6. Yakha uhlelo lokusebenza
   Kulokhu stage, isistimu isilungile futhi ukuthuthukiswa kwekhodi yesicelo somsebenzisi kungaqala.
   I-HAL ihlinzeka ngama-API anembile futhi alungele ukusetshenziswa ukuze kulungiselelwe i-peripheral. Isekela ukuvota, iziphazamiso, kanye nemodeli yokuhlela ye-DMA, ukuze kuhlangatshezwane nanoma yiziphi izidingo zohlelo lokusebenza. Ukuze uthole imininingwane eyengeziwe mayelana nendlela yokusebenzisa i-peripheral ngayinye, bheka i-ex ecebileample setha inikezwe kuPhakheji ye-STM32CubeWL3 MCU.

Isexwayiso: Ekusetshenzisweni okuzenzakalelayo kwe-HAL, isibali sikhathi se-SysTick sisetshenziswa njengesisekelo sesikhathi: sidala ukuphazamiseka ngezikhathi ezithile. Uma i-HAL_Delay() ibizwa ngenqubo ye-ISR ye-peripheral, qiniseka ukuthi ukuphazamiseka kwe-SysTick kunokubaluleka okuphezulu (okuphansi ngenombolo) kunokuphazanyiswa kwe-peripheral. Uma kungenjalo, inqubo ye-ISR yomshayeli ivinjiwe. Imisebenzi ethinta ukulungiselelwa kwesizinda sesikhathi ibizwa ngokuthi __ibuthakathaka ukwenza ukukhishwa kube khona esimweni lapho kuba khona okunye ukusetshenziswa kumsebenzisi. file (usebenzisa isibali sikhathi senhloso evamile, isiboneloample, noma omunye umthombo wesikhathi). Ukuze uthole imininingwane eyengeziwe, bheka i-HAL_TimeBase example.

LL isicelo
Lesi sigaba sichaza izinyathelo ezidingekayo ukuze udale uhlelo lwe-LL lwangokwezifiso usebenzisa i-STM32CubeWL3.

1. Dala iphrojekthi
   Ukuze udale iphrojekthi entsha, qala kuphrojekthi ye-Templates_LL enikezwe ibhodi ngalinye ngaphansi kokuthi \Projects\ \Templates_LL noma kunoma iyiphi iphrojekthi etholakalayo ngaphansi kokuthi \Projects\ \Eksampngaphansi_ LL ( ibhekisela egameni lebhodi, njenge-NUCLEO-WL32CC33).
   Iphrojekthi yesifanekiso inikeza umsebenzi weluphu oyinhloko ongenalutho, okuyisiqalo esihle sokuqonda izilungiselelo zephrojekthi ze-STM32CubeWL3. Izici eziyinhloko zesifanekiso yilezi ezilandelayo:
   • Iqukethe amakhodi omthombo wezishayeli ze-LL kanye ne-CMSIS, okuyisethi encane yezingxenye ezidingekayo ukuze kuthuthukiswe ikhodi ebhodini elinikeziwe.
   • Iqukethe izindlela ezifakiwe zazo zonke izingxenye ze-firmware ezidingekayo.
   • Ikhetha idivayisi yomugqa womkhiqizo we-STM32WL3x esekelwayo futhi ivumela ukucushwa okulungile kwamashayeli e-CMSIS kanye ne-LL.
   • Inikeza umsebenzisi osekulungele ukusetshenziswa fileezimiswe ngaphambili ngale ndlela elandelayo:
   • main.h: I-LED kanye ne-USER_BUTTON yencazelo yokukhipha isendlalelo.
   • main.c: Ukucushwa kwewashi lesistimu ukuze uthole imvamisa ephezulu.
2. Imbobo ye-LL example:
   • Kopisha/namathisela ifolda ye-Templates_LL - ukugcina umthombo wokuqala - noma ubuyekeze ngokuqondile iphrojekthi ekhona ye-Template s_LL.
   • Bese, ukuthuthwa kuhlanganisa ngokuyinhloko ukufaka esikhundleni se-Templates_LL files nge-ExampLes_LL iphrojekthi eqondisiwe.
   • Gcina zonke izingxenye zebhodi eziqondile. Ngenxa yezizathu zokucaca, izingxenye ezithile zebhodi zimakwe ngendlela ethile tags:
   • Ngakho, izinyathelo eziyinhloko zokuthutha yilezi ezilandelayo:
   • Shintshanisa amasheya stm32wl3x_it.h file.
   • Shintshanisa amasheya stm32wl3x_it.c file.
   • Faka esikhundleni esikhulu.h file futhi uyibuyekeze: Gcina i-LED nenkinobho yomsebenzisi incazelo yesifanekiso se-LL ngaphansi kwe-BOARD Specific CONFIGURATION tags.
   • Faka esikhundleni okuyinhloko.c file futhi uyibuyekeze:
   • Gcina ukucushwa kwewashi kwesifanekiso se-SystemClock_Config() LL ngaphansi kwe-BOARD Specific CONFIGURATION tags.
   • Ngokuya ngencazelo ye-LED, buyisela isenzeko ngasinye se-LDx ngenye i-LDy etholakala ku- file okuyinhloko.h.
   • Ngalezi zinguquko, i-example igijima ebhodini eliqondiwe.

Izinhlelo zokusebenza ze-RF, imiboniso, kanye nesibampLes
Izinhlobo ezihlukene zezinhlelo zokusebenza ze-RF, imibukiso, nesibampama-les ayatholakala kuphakheji ye-STM32CubeWL3.
Ahlelwe ezigabeni ezimbili ezingezansi.

I-sub-GHz exampizifundo kanye nemiboniso
Lezi exampLes ibonisa izici eziyinhloko ze-MRSUBG kanye ne-LPAWUR yomsakazo we-peripherals. Lezi examples iyatholakala ngaphansi:

• Amaphrojekthi\NUCLEO-WL33CC\Examples\MRSUBG
• Amaphrojekthi\NUCLEO-WL33CC\Exampkancane\LPAWUR
• Amaphrojekthi\NUCLEO-WL33CC\Demonstrations\MRSUBG
• Amaphrojekthi\NUCLEO-WL33CC\Demonstrations\LPAWUR

Exampi-le noma i-demonstration ngokuvamile iqukethe izinhlelo ezimbili ezibizwa ngokuthi i-Tx ne-Rx esebenza njengesidlulisi nomamukeli, ngokulandelanayo:

Exampngaphansi/MRSUBG

• MRSUBG_802_15_4: ukusetshenziswa kwesendlalelo esibonakalayo esichazwe yizinga elingu-802.15.4. Ibonisa indlela yokumisa umsakazo ukuthi udlulise noma wamukele amaphakethe angu-802.15.4.
• MRSUBG_BasicGeneric: Ukushintshaniswa kwamaphakethe ayisisekelo e-STM32WL3x MR_SUBG.
• MRSUBG_Chat: Uhlelo lokusebenza olulula olubonisa indlela yokusebenzisa i-Tx ne-Rx kudivayisi efanayo.
• MRSUBG_DatabufferHandler: Example ekhombisa ukuthi ungashintsha kanjani kusuka ku-Databuffer 0 kanye no-1.
• MRSUBG_Sequencer AutoAck: Isibample edlulisa futhi yamukele i-acknowledgement yephakethe (ama-ACK) ngokuzenzakalelayo.
• MRSUBG_WMBusSTD: Ukushintshana kwemilayezo ye-WM-Bus.
• I-WakeupRadio: I-example ukuhlola i-peripheral yomsakazo we-LPAWUR.

Imibukiso/MRSUBG

• MRSUBG_RTC_Button_TX: Lesi siboneloampI-le ikhombisa ukuthi isetha kanjani i-SoC kumodi yokuma ejulile futhi ulungiselele i-MRSUBG ukuze ivuse i-SoC ngokucindezela u-PB2 ukuze uthumele uhlaka noma ngemva kokuphelelwa yisikhathi kwe-RTC timer.
• MRSUBG_Sequencer_Sniff: Lesi siboneloampI-le ibonisa ukuthi isetha kanjani isilandeleli se-MRSUBG ukuthi sisebenze kumodi yokuhogela. Lesi exampi-le ibonisa uhlangothi lomamukeli futhi idinga enye idivayisi njengesidlulisi.
• MRSUBG_Timer: Uhlelo lokusebenza lushejula izikhathi ezimbalwa ze-MRSUBG timer (nokulayisha okuzenzakalelayo) ngezikhawu zesikhathi ezihlukile.
• MRSUBG_WakeupRadio_Tx: Lesi siboneloample ichaza indlela yokusetha i-SoC kumodi yokuma ejulile futhi ulungiselele i-MRSUBG ukuze ivuse i-SoC ngokucindezela u-PB2 ukuze uthumele uhlaka. Lesi exampi-le ibonisa uhlangothi lwesidluliseli futhi idinga enye idivayisi njengesamukeli se-LPAWUR. Umamukeli example itholakala ngaphansi kwe-NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx ifolda.

Imibukiso/LPAWUR

• LPAWUR_WakeupRadio_Rx: Lesi siboneloample ichaza indlela yokusetha i-SoC kumodi yokuma ejulile futhi ulungiselele i-LPAWUR ukuze ivuse i-SoC lapho uhlaka lufika futhi lwamukelwe ngendlela efanele. Lesi exampi-le ibonisa uhlangothi lomamukeli futhi idinga enye idivayisi njengesidlulisi. I-transmitter example itholakala ngaphansi kwe-NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx ifolda.

Uhlelo lokusebenza lwe-Sigfox™
Lezi zinhlelo zokusebenza zibonisa ukuthi ungasifaka kanjani isimo se-Sigfox™ futhi usebenzise ama-API we-Sigfox™ atholakalayo. Ayatholakala endleleni yephrojekthi Amaphrojekthi\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: Lolu hlelo lokusebenza lubonisa indlela yokusebenzisa isixhumi esibonakalayo somugqa womyalo (CLI) ukuthumela imiyalo esebenzisa iphrothokholi ye-Sigfox™ ukuthumela imilayezo nokwenza izivivinyo zokuqinisekisa.
• Sigfox_PushButton: Lolu hlelo lokusebenza luvumela ukuhlolwa kwamakhono omsakazo wedivayisi ye-STM32WL33xx Sigfox™. Ukucindezela i-PB1 kudlulisa uhlaka lokuhlola lwe-Sigfox™.

Umlando wokubuyekeza

Ithebula 3. Umlando wokubuyekeza idokhumenti

Usuku	Buyekeza	Izinguquko
29-Mar-2024	1	Ukukhishwa kokuqala.
30-Oct-2024	2	Ukuhlanganiswa okugcwele kwe-STM32CubeWL3 ku-STM32Cube. Kubuyekeziwe: •         Isingeniso •         Isigaba 2: Izici eziyinhloko ze-STM32CubeWL3 •         Isigaba 3.2.1: Izingxenye ze-Middleware •         Isigaba 4: STM32CubeWL3 iphakheji ye-firmware isiphelileview •         Isigaba 5.1: Ukugijima i-ex yokuqalaample •         Isigaba 5.3: Izicelo ze-RF, imiboniso, kanye nesibampLes Kwengezwe: •         Isigaba 5.1.1: Isetshenziswa kanjani i-HAL example •         Isigaba 5.2.1: Ukusebenzisa i-STM32CubeMX ukuthuthukisa noma ukubuyekeza uhlelo lokusebenza • SIsigaba 6.4: Ingabe ikhona iphrojekthi yesifanekiso ye-MRSUBG/LPAWUR ye-peripheral exampLes? •         Isigaba 6.5: I-STM32CubeMX ingayenza kanjani ikhodi ngokusekelwe kusofthiwe eshumekiwe? Kususiwe: •         Amathuluzi e-PC, kuhlanganise I-Navigator, Idatha ye-STM32WL3, futhi I-MR-SUBG Sequencer GUI •         I-WiSE-Studio IOMapper ingayenza kanjani ikhodi ngokusekelwe kusofthiwe eshumekiwe? •         Ingabe i-Navigator ivumela ukufinyelela kuzinsiza zephakheji yesofthiwe?
22-Jan-2025	3	Kunwetshwe ububanzi bamadivayisi asebenzayo ku-STM32WL30xx kanye ne-STM32WL31xx microcontrollers kuThebula 1. Amamakhro e-STM32WL3x yomugqa womkhiqizo.

ISAZISO ESIBALULEKILE – FUNDA NGOKUQAPHELA

• I-STMicroelectronics NV nezinkampani ezingaphansi kwayo (“ST”) igodla ilungelo lokwenza izinguquko, ukulungisa, izithuthukisi, ukuguqulwa, nokuthuthukiswa kwemikhiqizo ye-ST kanye/noma kulo mbhalo nganoma yisiphi isikhathi ngaphandle kwesaziso. Abathengi kufanele bathole ulwazi lwakamuva olufanele ngemikhiqizo ye-ST ngaphambi kokufaka ama-oda. Imikhiqizo ye-ST ithengiswa ngokulandela imigomo nemibandela ye-ST yokuthengisa ekhona ngesikhathi sokuvunywa kwe-oda.
• Abathengi banomthwalo wemfanelo kuphela ekukhetheni, ekukhethweni, nasekusetshenzisweni kwemikhiqizo ye-ST futhi i-ST ayithathi sikweletu sosizo lwesicelo noma idizayini yemikhiqizo yabathengi.
• Ayikho ilayisensi, eshiwo noma eshiwoyo, kunoma yiliphi ilungelo lempahla yengqondo elinikezwa i-ST lapha.
• Ukudayiswa kabusha kwemikhiqizo ye-ST nezinhlinzeko ezihlukile kulwazi olubekwe lapha kuzovala noma yisiphi isiqinisekiso esinikezwe i-ST salowo mkhiqizo.
• Ilogo ye-ST kanye ne-ST yizimpawu zokuthengisa ze-ST. Ukuze uthole ulwazi olwengeziwe mayelana nezimpawu zokuthengisa ze-ST, bheka ku www.st.com/trademarks. Wonke amanye amagama omkhiqizo noma wesevisi ayimpahla yabanikazi abafanele.
• Ulwazi olukule dokhumenti luthatha indawo futhi luthatha indawo yolwazi olwalunikezwe ngaphambilini kunoma yiziphi izinguqulo zangaphambili zalo mbhalo.
• © 2025 STMicroelectronics – Wonke amalungelo agodliwe

FAQ

Kufanele ngisebenzise nini i-HAL esikhundleni sezishayeli ze-LL?

Abashayeli be-HAL banikela ngama-API ezinga eliphezulu nagxile ekusebenzeni, anezinga eliphezulu lokuphatheka. Ubunkimbinkimbi bomkhiqizo noma be-peripheral bufihliwe kubasebenzisi bokugcina. Abashayeli be-LL banikeza ama-API eleveli yerejista yezinga eliphansi esebenzisa kangcono kodwa ephathekayo kancane. Badinga ulwazi olujulile lomkhiqizo noma imininingwane ye-IP.

Avulwa kanjani ama-API wokuqalisa we-LL?

Incazelo yama-API okuqalisa e-LL kanye nezinhlaka zezinsiza ezihlotshaniswayo ngokoqobo kanye nama-prototypes kumiswe ukushintsha kokuhlanganiswa kwe-USE_FULL_LL_DRIVER. Ukuze ukwazi ukusebenzisa ama-API okuqalisa e-LL, engeza le swishi ku-preprocessor ye-toolchain compiler.

Ingabe ikhona iphrojekthi yesifanekiso ye-MRSUBG/LPAWUR ye-peripheral exampLes?

Ukuze udale i-MRSUBG entsha noma i-LPAWUR example phrojekthi, noma iqale kuphrojekthi yamathambo ehlinzekwe ngaphansi kwe-Pr ojectsNUCLEO- 33CC Exampi-MRSUBG noma i-ProjectsNUCLEO-WL33CC Examples LPAWUR noma kunoma iyiphi iphrojekthi etholakalayo ngaphansi kwalezi zinkombandlela ezifanayo.

I-STM32CubeMX ingayenza kanjani ikhodi ngokusekelwe kusofthiwe eshumekiwe?

I-STM32CubeMX inolwazi olwakhelwe ngaphakathi lwezilawuli ezincane ze-STM32, okuhlanganisa nezinto eziphathelene nomngcele nesofthiwe yazo, eyivumela ukuthi inikeze ukumelwa okuyisithombe kumsebenzisi futhi ikhiqize .h noma .c files ngokusekelwe ekucushweni komsebenzisi.

Amadokhumenti / Izinsiza

I-STM32WL3x Microcontrollers [pdf] Imaniwali yosebenzisayo I-STM32WL3x Microcontrollers, STM32WL3x, Microcontrollers

Izithenjwa

• Imaniwali yosebenzisayo