Bayanan Bayani na STM32WL3x
Ƙayyadaddun bayanai
- Sunan samfur: Kunshin software na STM32CubeWL3
- karfinsu: STM32WL3x microcontrollers
- Babban fasali:
- Low-Layer (LL) da hardware abstraction Layer (HAL) APIs
- SigfoxTM, FatFS, da FreeRTOSTM kernel middleware abubuwan
- Aikace-aikace da zanga-zanga
Umarnin Amfani da samfur
Farawa
Don fara amfani da kunshin software na STM32CubeWL3, bi waɗannan matakan:
- Zazzage fakitin software daga hukuma website.
- Shigar da yanayin ci gaban da ake buƙata (misali, STM32CubeIDE, EWARM, MDK-ARM).
- Koma zuwa ga tsohonamples da aikace-aikacen da aka bayar don jagora.
STM32CubeWL3 Architecture Overview
Kunshin software na STM32CubeWL3 an gina shi a kusa da manyan matakai uku
- Mataki na 0: Hardware abstraction Layer (HAL) da direbobin BSP.
- Mataki na 1: Aikace-aikace, dakunan karatu, da abubuwan da suka dogara da tsari.
Tambayoyin da ake yawan yi (FAQ)
Tambaya: Menene babban fasali na kunshin software na STM32CubeWL3?
A: Babban fasali sun haɗa da ƙananan Layer da HAL APIs, abubuwan tsakiya kamar Sigfox TM, FatFS, FreeRTOSTM kernel, aikace-aikace, da zanga-zangar.
Gabatarwa
STM32Cube wani yunƙuri ne na STMMicroelectronics na asali don haɓaka yawan aikin ƙira ta hanyar rage ƙoƙarin haɓakawa, lokaci, da farashi. STM32Cube ya rufe dukkan fayil ɗin STM32.
STM32Cube ya hada da:
- Saitin kayan aikin haɓaka software na abokantaka don rufe ci gaban aikin daga tunani zuwa ganewa, daga cikin] waɗanda sune:
- STM32CubeMX, kayan aikin daidaitawa na software mai hoto wanda ke ba da damar ƙirƙira ta atomatik na lambar ƙaddamar da C ta amfani da wizards na hoto.
- STM32CubeIDE, kayan aikin ci gaba gabaɗaya tare da daidaitawar gefe, tsara lamba, harhada lambobin, da fasalulluka na gyara kuskure.
- STM32CubeCLT, kayan aikin haɓaka layin umarni duka-cikin-ɗaya tare da haɗa lamba, shirye-shiryen allo, da fasalin gyara kuskure.
- STM32CubeProgrammer (STM32CubeProg), kayan aikin shirye-shirye da ake samu a cikin zane-zane da sigogin layin umarni.
- STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), kayan aikin sa ido masu ƙarfi don daidaita ɗabi'a da aiwatar da aikace-aikacen STM32 a cikin ainihin lokaci.
- Fakitin STM32Cube MCU da MPU, cikakkun dandamali-software dandamali na musamman ga kowane microcontroller da jerin microprocessor (kamar STM32CubeWL3 don layin samfurin STM32WL3x), waɗanda suka haɗa da:
- STM32Cube hardware abstraction Layer (HAL), yana tabbatar da girman iya ɗauka a cikin fayil ɗin STM32
- APIs na ƙananan Layer STM32Cube, yana tabbatar da mafi kyawun aiki da sawun ƙafa tare da babban matakin sarrafa mai amfani akan kayan aiki.
- Daidaitaccen saiti na abubuwan haɗin tsakiya kamar FreeRTOS™ kernel, FatFS, da Sigfox™
- Duk kayan aikin software da aka haɗa tare da cikakkun saituna na gefe da na aikace-aikace examples
- Fakitin Faɗaɗɗen STM32Cube, waɗanda ke ƙunshe da kayan aikin software waɗanda suka dace da ayyukan STM32Cube MCU da Fakitin MPU tare da:
-
- Middleware kari da aikace-aikace yadudduka
- Examples yana gudana akan wasu takamaiman allunan ci gaban STMicroelectronics
Wannan jagorar mai amfani yana bayyana yadda ake farawa da Kunshin STM32CubeWL3 MCU.
Sashe na 2 yana bayyana manyan abubuwan STM32CubeWL3 da Sashe na 3 yana ba da ƙari.view na gine-ginensa da na tsarin Kunshin MCU.
Janar bayani
STM32CubeWL3 yana gudanar da aikace-aikacen nuni na sub-GHz, gami da Sigfox™ binaries, akan microcontrollers layin samfur STM32WL3x dangane da na'urar sarrafa Arm® Cortex®‑M0+.
STM32WL3x microcontrollers sun haɗa STMicroelectronics's-art-the-art sub-GHz complient RF radio peripheral, wanda aka inganta don amfani mai ƙarancin ƙarfi da ingantaccen aikin rediyo, don rayuwar baturi mara misaltuwa.
LuraArm alamar kasuwanci ce mai rijista ta Arm Limited (ko rassan sa) a cikin Amurka da/ko wani wuri.
STM32CubeWL3 babban fasali
- Kunshin STM32CubeWL3 MCU yana gudana akan STM32 32-bit microcontrollers bisa na'urar sarrafa Arm® Cortex®‑M0+. Yana tattara, a cikin fakiti ɗaya, duk abubuwan haɗin software na gama gari da ake buƙata don haɓaka aikace-aikace don microcontrollers layin samfurin STM32WL3x.
- Kunshin ya haɗa da ƙananan Layer (LL) da hardware abstraction Layer (HAL) APIs waɗanda ke rufe kayan aikin microcontroller, tare da babban saitin tsohon.amples yana gudana akan allunan STMicroelectronics. Ana samun HAL da LL APIs a cikin buɗaɗɗen tushen lasisin BSD don dacewa da mai amfani. Hakanan ya haɗa da Sigfox™, FatFS, da FreeRTOS™ kernel ɓangarorin tsakiya.
- Kunshin na STM32CubeWL3 MCU kuma yana ba da aikace-aikace da yawa da nunin aiwatar da duk abubuwan da aka haɗa na tsakiya.
- An kwatanta shimfiɗin ɓangaren Kunshin STM32CubeWL3 MCU a Hoto 1.
Hoto 1. STM32CubeWL3 MCU Kunshin abubuwan da aka gyara
Saukewa: STM32CubeWL3view
Maganin Kunshin STM32CubeWL3 MCU an gina shi a kusa da matakai masu zaman kansu guda uku waɗanda ke yin hulɗa cikin sauƙi kamar yadda aka kwatanta a cikin Hoto 2. 
Mataki na 0
Wannan matakin ya kasu kashi uku:
- Kunshin tallafin allo (BSP).
- Layer Abstraction Layer (HAL):
- HAL na gefe direbobi
- Direbobi masu ƙananan Layer
- Asalin amfani na gefe misaliamples.
Kunshin tallafin allo (BSP)
Wannan Layer yana ba da saitin APIs dangane da abubuwan haɗin kayan masarufi a cikin allunan kayan aikin (kamar LEDs, maɓalli, da direbobin COM). Ya ƙunshi sassa biyu:
- Bangaren:
Wannan shine direban dangi da na'urar waje akan allo kuma ba ga STM32 ba. Direban bangaren yana ba da takamaiman APIs zuwa abubuwan waje na direba na BSP kuma yana iya zama mai ɗaukar hoto akan kowane allo. - Direban BSP:
Yana ba da damar haɗa abubuwan direbobi zuwa takamaiman allo kuma yana ba da saitin APIs masu aminci. Ka'idodin API suna BSP_FUNCT_Action().
Example: BSP_LED_Init(), BSP_LED_On()
BSP ya dogara ne akan tsarin gine-gine na zamani wanda ke ba da damar sauƙin jigilar kaya akan kowane kayan aiki ta hanyar aiwatar da ƙananan matakan yau da kullun.
Hardware abstraction Layer (HAL) da ƙananan Layer (LL)
STM32CubeWL3 HAL da LL sun dace kuma suna rufe kewayon buƙatun aikace-aikacen:
- Direbobin HAL ɗin suna ba da babban matakin aiki-daidaitacce APIs masu ɗaukar nauyi. Suna ɓoye MCU da haɗaɗɗen gefe ga mai amfani na ƙarshe.
Direbobin HAL ɗin suna ba da APIs masu dacewa da fasali iri-iri, waɗanda ke sauƙaƙe aiwatar da aikace-aikacen mai amfani ta hanyar samar da shirye-shiryen aiwatarwa. Domin misaliample, don hanyoyin sadarwa (I2C, UART, da sauransu), yana ba da APIs da ke ba da izinin farawa da daidaitawa na gefe, sarrafa canja wurin bayanai dangane da jefa kuri'a, katsewa, ko tsarin DMA, da kuma kula da kurakuran sadarwa waɗanda zasu iya tasowa yayin sadarwa. API ɗin direban HAL sun kasu kashi biyu:
- Generic APIs, waɗanda ke ba da ayyukan gama-gari da na gama-gari ga duk jerin microcontrollers na STM32.
- APIs Extension, waɗanda ke ba da takamaiman ayyuka na musamman don takamaiman dangi ko takamaiman lambar sashe.
- API ɗin ƙananan Layer yana ba da ƙananan APIs a matakin rajista, tare da ingantawa mafi kyau amma ƙarancin ɗauka. Suna buƙatar zurfin ilimin MCU da ƙayyadaddun bayanai.
An ƙirƙira direbobin LL don ba da ƙwararren ƙwararriyar nauyi mai sauri wanda ke kusa da kayan aikin fiye da HAL. Sabanin HAL, LL APIs ba a bayar da su don abubuwan da ke kewaye ba inda ingantaccen damar shiga ba shine mahimmin fasalin ba, ko kuma ga waɗanda ke buƙatar saitin software mai nauyi ko hadaddun tari na matakin sama.
Direbobin LL sun haɗa da:
- Saitin ayyuka don fara manyan fasalulluka bisa ga sigogi da aka kayyade a tsarin bayanai.
- Saitin ayyuka don cike tsarin bayanan farawa tare da sake saitin ƙimar daidai da kowane filin.
- Aiki don de-initialization na gefe (an mayar da rijistar na gefe zuwa ga tsoffin ƙimarsu).
- Saitin ayyukan layi don shiga kai tsaye da rajistar atomic.
- Cikakken 'yancin kai daga HAL da damar da za a yi amfani da shi a cikin keɓantaccen yanayi (ba tare da direbobin HAL ba).
- Cikakken kewayon fasalulluka masu goyan bayan.
Asalin amfani na gefe misaliamples
Wannan Layer yana rufe exampLes an gina shi akan abubuwan STM32 ta amfani da albarkatun HAL da BSP kawai.
Zanga-zangar examples kuma akwai don nuna ƙarin hadaddun example al'amuran tare da takamaiman na'urori, kamar MRSUBG da LPAWUR.
Mataki na 1
Wannan matakin ya kasu kashi biyu:
- Abubuwan da aka gyara na Middleware
- Examples dangane da middleware aka gyara
Abubuwan da aka gyara na Middleware
Matsakaicin saitin ɗakunan karatu ne da ke rufe FreeRTOS™ kwaya, FatFS, da ɗakin karatu na yarjejeniya na Sigfox™. Ana yin hulɗar kai tsaye tsakanin sassan wannan Layer ta hanyar kiran APIs da aka bayyana.
A tsaye hulɗa tare da ƙananan direbobi ana yin ta ta takamaiman kiraye-kiraye da macros masu tsayi waɗanda aka aiwatar a cikin tsarin kiran laburare.
Babban fasali na kowane bangaren tsakiya sune kamar haka:
- FreeRTOS™ kernel: yana aiwatar da tsarin aiki na ainihi (RTOS), wanda aka ƙera don tsarin da aka haɗa.
- Sigfox™: yana aiwatar da ɗakin karatu na ladabi na Sigfox™ wanda ya dace da hanyar sadarwar Sigfox™ kuma ya haɗa da ɗakin karatu na ƙa'idar gwajin RF don gwada kayan aikin RF Sigfox™.
- FatFS: yana aiwatar da nau'in FAT file tsarin tsarin.
Examples dangane da middleware aka gyara
Kowane bangaren tsakiya yana zuwa da ɗaya ko fiye da examples, wanda kuma ake kira aikace-aikace, yana nuna yadda ake amfani da shi. Haɗin kai exampdon haka ana ba da abubuwan da ke amfani da kayan tsakiya da yawa.
STM32CubeWL3 fakitin firmware ya ƙareview
Goyan bayan na'urori da kayan masarufi na STM32WL3x
STM32Cube yana ba da ɗorewa mai ɗaukar hoto mai ɗaukar nauyi (HAL) wanda aka gina a kusa da gine-ginen gine-gine. Yana ba da damar ƙa'idar ginawa akan yadudduka, kamar yin amfani da tsaka-tsakin tsaka-tsakin don aiwatar da ayyukansu ba tare da sanin, zurfin zurfin abin da ake amfani da MCU ba. Wannan yana haɓaka sake amfani da lambar ɗakin karatu kuma yana tabbatar da sauƙin ɗauka zuwa wasu na'urori.
- Bugu da ƙari, tare da tsarin gine-ginen sa, STM32CubeWL3 yana ba da cikakken goyon baya ga duk layin samfurin STM32WL3x.
- Dole ne mai amfani ya ayyana macro da ya dace kawai a cikin stm32wl3x.h.
Tebur 1 yana nuna macro don ayyana dangane da na'urar layin samfur STM32WL3x da aka yi amfani da ita. Wannan macro dole ne kuma a ayyana shi a cikin mahaɗar preprocessor.
Tebur 1. Macros don layin samfurin STM32WL3x
| Macro ya bayyana a cikin stm32wl3x.h | Saukewa: STM32WL3X |
| stm32wl33 | Saukewa: STM32WL33XX |
STM32CubeWL3 yana da fa'idodi masu yawa na examples da aikace-aikace a kowane matakai, yana sauƙaƙa fahimta da amfani da kowane direban HAL ko abubuwan haɗin gwiwa. Wadannan examples gudu akan allunan STMicroelectronics da aka jera a cikin Tebu 2.
| Hukumar | STM32WL3x na'urori masu goyan bayan |
| NUCLEO-WL33CC1 | Saukewa: STM32WL33CC |
| NUCLEO-WL33CC2 | Saukewa: STM32WL33CC |
Kunshin STM32CubeWL3 MCU na iya gudana akan kowane kayan aiki masu jituwa. Masu amfani kawai suna sabunta direbobin BSP zuwa tashar jiragen ruwa da aka bayarampLes a kan allunan su, idan waɗannan suna da fasalulluka iri ɗaya (kamar LEDs ko maɓalli).
Kunshin Firmware ya ƙareview
Ana samar da Maganin Kunshin STM32CubeWL3 MCU a cikin fakitin zip guda ɗaya wanda ke da tsarin da aka nuna a Hoto 3.
Hoto 3. Tsarin fakitin firmware STM32CubeWL3
Tsanaki:
Dole ne mai amfani kada ya gyara abubuwan da aka gyara files. Mai amfani zai iya gyara tushen ayyukan \Projects kawai.
Ga kowane allo, saitin exampLes an bayar da shi tare da shirye-shiryen da aka riga aka tsara don EWARM, MDK-ARM, da STM32CubeIDE kayan aiki.
Hoto na 4 yana nuna tsarin aikin don allon NUCLO-WL33CCx. 
The exampLes ana rarraba su dangane da matakin STM32CubeWL3 da suke nema. Sunayen su kamar haka:
- Mataki na 0 exampana kiran su Exampku, Examples_LL, da Exampkasa_MIX. Suna amfani da direbobin HAL bi da bi, direbobin LL, da cakuɗen direbobin HAL da LL ba tare da wani ɓangaren tsakiya ba. Zanga-zangar examples kuma akwai.
- Mataki na 1 exampAna kiran su Applications. Suna ba da yanayin amfani na yau da kullun na kowane ɓangaren tsakiya.
Duk wani aikace-aikacen firmware na hukumar da aka ba za a iya gina shi cikin sauri ta amfani da ayyukan samfuri da ke cikin kundayen adireshi na Templ da Templates_LL.
Exampku, Examples_LL, da Examples_MIX suna da tsari iri ɗaya:
- \Inc babban fayil ɗin da ke ɗauke da duk taken files.
- \Src babban fayil mai dauke da lambar tushe.
- \EWARM, \ MDK-ARM, da STM32CubeIDE manyan fayiloli masu ɗauke da aikin da aka riga aka tsara don kowane sarkar kayan aiki.
- readme.md da readme.html suna kwatanta tsohonamphali da yanayin da ake buƙata don yin aiki.
Farawa tare da STM32CubeWL3
Gudun tsohon tsohonample
Wannan sashe yana bayanin yadda sauƙi yake tafiyar da tsohon na farkoampSaukewa: STM32CubeWL3. Yana amfani da azaman misali ƙarni na mai sauƙin LED toggle yana gudana akan allon NUCLO-WL33CC1:
- Zazzage Kunshin STM32CubeWL3 MCU.
- Cire shi, ko gudanar da mai sakawa idan an bayar, cikin kundin adireshi da kuke so.
- Tabbatar cewa kar a canza tsarin fakitin da aka nuna a Hoto 3. STM32CubeWL3 tsarin fakitin firmware. Lura cewa ana ba da shawarar yin kwafin kunshin a wani wuri kusa da tushen girma (ma'ana C: \ ST ko G: \ Tests), saboda wasu IDEs suna fuskantar matsaloli lokacin da hanya ta yi tsayi da yawa.
Yadda ake gudanar da HAL example
Kafin lodawa da gudanar da tsohonample, ana bada shawarar sosai don karanta tsohonampda karatu file ga kowane takamaiman tsari.
- Nemo zuwa \Projects\NUCLEO-WL33CC\Examples.
- Bude \GPIO, sannan \GPIO_EXTI manyan fayiloli.
- Bude aikin tare da kayan aiki da aka fi so. Da sauri ya wuceview kan yadda ake budewa, ginawa, da gudanar da tsohonample tare da goyan bayan kayan aiki ana ba da su a ƙasa.
- Sake gina duka files kuma loda hoton zuwa ƙwaƙwalwar ajiyar manufa.
- Gudu da example. Don ƙarin bayani, koma ga tsohonampda karatu file.
Don buɗewa, ginawa, da gudanar da tsohonamptare da kowane nau'in kayan aiki masu goyan baya, bi matakan da ke ƙasa:
- EWARM:
- Karkashin Examples babban fayil, buɗe babban fayil na EWARM.
- Kaddamar da filin aikin Project.eww (sunan filin aiki zai iya canzawa daga tsohonample ga wani).
- Sake gina duka files: [Project]>[Sake gina duka].
- Load da hoton aikin: [Project]>[Debug].
- Gudanar da shirin: [Debug]>[Tafi (F5)].
- MDK-ARM:
- Karkashin Examples babban fayil, buɗe babban fayil \ MDK-ARM.
- Bude filin aikin Project.uvproj (sunan filin aiki zai iya canzawa daga tsohonample ga wani).
- Sake gina duka files: [Project]>[Sake gina duk manufa files].
- Load da hoton aikin: [Debug]>[Fara/Dakatar da Zama na gyara kuskure].
- Gudanar da shirin: [Debug]>[Run (F5)].
- STM32CubeIDE:
- Bude sarkar kayan aikin STM32CubeIDE.
- Danna [File>> [Canja Wurin Aiki]>[Sauran] kuma bincika zuwa STM32CubeIDE directory sarari.
- Danna [File>>[Ishigowa], zaɓi [General]>[Ayyukan da suke da su zuwa Wurin Aiki], sannan danna [Next].
- Nemo zuwa STM32CubeIDE directory sarari kuma zaɓi aikin.
- Sake gina duk aikin files: Zaɓi aikin a cikin taga Project Explorer sannan danna kan
[Project]> [Gina aikin] menu. - Gudanar da shirin: [Run]> [Debug (F11)].
Ƙirƙirar aikace-aikacen al'ada
Amfani da STM32CubeMX don haɓakawa ko sabunta aikace-aikacen
A cikin Kunshin STM32Cube MCU, kusan duk aikin examples ana haifar da su tare da kayan aikin STM32CubeMX don fara tsarin, na'urori, da tsaka-tsaki.
Amfani kai tsaye na aikin da ake ciki example daga kayan aikin STM32CubeMX yana buƙatar STM32CubeMX 6.12.0 ko sama:
- Bayan shigarwa na STM32CubeMX, buɗe kuma idan ya cancanta sabunta aikin da aka tsara.
Hanya mafi sauƙi don buɗe aikin data kasance shine danna sau biyu akan * .ioc file don haka STM32CubeMX ta atomatik buɗe aikin da tushen sa files. STM32CubeMX yana haifar da lambar tushen farawa na irin waɗannan ayyukan. - Babban lambar tushen aikace-aikacen yana ƙunshe da sharhin "USER CODE BEGIN" da " END CODE CODE ". Idan an canza zaɓi na gefe da saituna, STM32CubeMX yana ɗaukaka ɓangaren farawa na lambar yayin da ake adana babban lambar tushen aikace-aikacen.
Don haɓaka aikin al'ada tare da STM32CubeMX, bi tsarin mataki-mataki:
- Saita duk abin da aka haɗa software da ake buƙata ta amfani da mai warware rikici-pinout, mai taimako saitin itacen agogo, ma'aunin amfani da wutar lantarki, da kayan aikin da ke aiwatar da daidaitawar MCU (kamar GPIO ko USART).
- Ƙirƙirar lambar farko ta C bisa tsarin da aka zaɓa. Wannan lambar tana shirye don amfani da ita a cikin mahallin ci gaba da yawa. Ana adana lambar mai amfani a ƙarni na gaba.
Don ƙarin bayani game da STM32CubeMX, koma zuwa littafin mai amfani STM32CubeMX don daidaitawar STM32 da ƙaddamar da lambar code C (UM1718).
Aikace-aikacen direba
HAL aikace-aikace
Wannan sashe yana bayyana matakan da ake buƙata don ƙirƙirar aikace-aikacen HAL na al'ada ta amfani da STM32CubeWL3:
- Ƙirƙiri aiki
Don ƙirƙirar sabon aiki, fara ko dai daga aikin Samfurin da aka tanada don kowane allo a ƙarƙashin \Projects\< STM32xxx_yyy> Samfuran ko kuma daga kowane aiki da ke ƙarƙashin \Projects\ \Exampl es ko \Projects\ \Aikace-aikace (inda yana nufin sunan allo). Aikin Samfurin yana ba da babban aikin madauki mara komai. Koyaya, yana da kyau wurin farawa don fahimtar saitunan aikin STM32CubeWL32. Samfurin yana da halaye masu zuwa:- Ya ƙunshi lambar tushen HAL, CMSIS, da direbobin BSP, waɗanda su ne mafi ƙarancin saiti na abubuwan da ake buƙata don haɓaka lamba akan allon da aka ba.
- Ya ƙunshi hanyoyin da aka haɗa don duk abubuwan haɗin firmware.
- Yana bayyana goyan bayan na'urorin layin samfur na STM32WL3x, yana ba da damar daidaita direbobin CMSIS da HAL daidai.
- Yana ba da mai amfani da shirye-shiryen amfani files preconfigured kamar yadda aka nuna a kasa:
- HAL an fara shi tare da tsayayyen lokaci tare da Arm® core SysTick.
- An aiwatar da SysTick ISR don HAL_Delay() manufa.
Lura: Lokacin yin kwafin aikin da ke akwai zuwa wani wuri, tabbatar da sabunta duk hanyoyin da aka haɗa.
- Sanya abubuwan haɗin firmware
Abubuwan HAL da na tsakiya suna ba da saiti na zaɓuɓɓukan daidaitawa na lokaci ta amfani da macros #define da aka ayyana a cikin kai. file. Tsarin samfuri file an bayar da shi a cikin kowane bangare, wanda dole ne a kwafi zuwa babban fayil ɗin aikin (yawanci daidaitawa file suna xxx_conf_template.h, guntun _template yana buƙatar cirewa lokacin yin kwafi zuwa babban fayil ɗin aikin). Tsarin tsari file yana ba da isassun bayanai don fahimtar tasirin kowane zaɓi na daidaitawa. Ana samun ƙarin cikakkun bayanai a cikin takaddun da aka tanadar don kowane bangare. - Fara ɗakin karatu na HAL
Bayan tsalle zuwa babban shirin, dole ne lambar aikace-aikacen ta kira HAL_Init() API don fara laburare HAL, wanda ke aiwatar da ayyuka masu zuwa:- Haɓaka prefetch ɗin ƙwaƙwalwar walƙiya da fifikon SysTick (ta hanyar macros da aka ayyana a cikin stm3 2wl3x_hal_conf.h).
- Tsarin SysTick don samar da katse kowane millisecond a SysTick katse fifiko TICK_INT_PRIO da aka ayyana a cikin stm32wl3x_hal_conf.h.
- Saitin fifikon rukunin NVIC zuwa 0.
- Kira na HAL_MspInit() aikin sake kiran da aka ayyana a cikin mai amfani da stm32wl3x_hal_msp.c file don aiwatar da ƙaƙƙarfan ƙaƙƙarfan farawar kayan aikin duniya.
- Saita agogon tsarin
Tsarin agogon tsarin ana yin shi ta hanyar kiran APIs guda biyu da aka kwatanta a ƙasa:- HAL_RCC_OscConfig(): wannan API ɗin yana daidaita oscillators na ciki da na waje. Mai amfani ya zaɓi don saita ɗaya ko duk oscillators.
- HAL_RCC_ClockConfig(): wannan API yana daidaita tushen agogon tsarin, latency memori, da AHB da APB prescalers.
- Fara na gefe
- Da farko rubuta aikin farawa na gefe. Ci gaba kamar haka:
- Kunna agogon gefe.
- Sanya GPIO na gefe.
- Sanya tashar DMA kuma kunna katsewar DMA (idan an buƙata).
- Kunna katsewar gefe (idan an buƙata).
- Shirya stm32xxx_it.c don kiran masu kula da katse da ake buƙata (na gefe da DMA), idan an buƙata.
- Rubuta cikakken aikin sake kira idan katsewar gefe ko DMA ana nufin amfani da shi.
- A cikin mai amfani main.c file, fara tsarin rikewa na gefe sannan a kira aikin farawa na gefe don fara na gefe.
- Ƙirƙirar aikace-aikace
A wannan stage, tsarin yana shirye kuma ci gaban lambar aikace-aikacen mai amfani na iya farawa.
HAL yana ba da APIs masu fa'ida da shirye-shiryen amfani don saita mahallin. Yana goyan bayan jefa ƙuri'a, katsewa, da ƙirar shirye-shiryen DMA, don ɗaukar kowane buƙatun aikace-aikacen. Don ƙarin cikakkun bayanai kan yadda ake amfani da kowane yanki, koma ga attajiri tsohonampAn bayar da saitin a cikin Kunshin STM32CubeWL3 MCU.
Tsanaki:
A cikin tsohuwar aiwatar da HAL, ana amfani da mai ƙidayar lokaci ta SysTick azaman tushen lokaci: yana haifar da katsewa a cikin tazarar lokaci na yau da kullun. Idan an kira HAL_Delay() daga tsarin ISR na gefe, tabbatar da cewa katsewar SysTick yana da fifiko mafi girma (ƙananan lambobi) fiye da katsewar gefe. In ba haka ba, tsarin ISR mai kira shine
an katange. Ana ayyana ayyukan da ke da alaƙa da daidaitawar lokaci a matsayin __rauni don yin yuwuwar ƙetare idan an sami wasu aiwatarwa a cikin mai amfani. file (ta amfani da na'urar ƙidayar manufa ta gaba ɗaya, ga misaliample, ko wani lokaci tushen).
Don ƙarin cikakkun bayanai, koma zuwa HAL_TimeBase example.
LL aikace-aikace
Wannan sashe yana bayyana matakan da ake buƙata don ƙirƙirar aikace-aikacen LL na al'ada ta amfani da STM32CubeWL3.
- Ƙirƙiri aiki
Don ƙirƙirar sabon aiki, ko dai a fara daga aikin Templates_LL da aka tanada don kowane allo a ƙarƙashin \Projects\ Templates_LL ko daga kowane aiki da ke ƙarƙashin \Projects\ \E xampkasa_LL ( yana nufin sunan allo, kamar NUCLO-WL32CC33).
Aikin samfuri yana ba da babban aikin madauki na fanko, wanda shine kyakkyawan wurin farawa don fahimtar saitunan aikin don STM32CubeWL3. Babban halayen samfuri sune kamar haka:- Yana ƙunshe da lambobin tushe na direbobin LL da CMSIS, waɗanda su ne mafi ƙarancin saitin abubuwan da ake buƙata don haɓaka lambar akan allon da aka bayar.
- Ya ƙunshi hanyoyin da aka haɗa don duk abubuwan haɗin firmware da ake buƙata.
- Yana zaɓar na'urar layin samfur STM32WL3x mai goyan bayan kuma yana ba da damar daidaita daidaitattun direbobin CMSIS da LL.
- Yana ba da mai amfani da shirye-shiryen amfani files waɗanda aka riga aka tsara su kamar haka:
- main.h: LED da USER_BUTTON ma'anar abstraction Layer.
- main.c: Tsarin agogon tsarin don matsakaicin mitar.
- Port da LL exampda:
- Kwafi/manna babban fayil ɗin Samfura_LL - don kiyaye tushen farko - ko sabunta aikin Samfura tes_LL kai tsaye.
- Sa'an nan, da porting ya ƙunshi musamman a maye gurbin Templates_LL files ta hanyar Examples_LL aikin da aka yi niyya.
- Ajiye duk takamaiman sassa na allon. Don dalilai na tsabta, takamaiman sassa na allon ana tuta su da takamaiman tags:
Don haka, manyan matakan jigilar kaya sune kamar haka:
- Sauya stm32wl3x_it.h file.
- Sauya stm32wl3x_it.c file.
- Sauya babban.h file kuma sabunta shi: Kiyaye ma'anar maɓallin LED da maɓallin mai amfani na samfurin LL a ƙarƙashin BOARD SPECIFIC CONFIGURATION tags.
- Sauya babban.c file kuma sabunta shi:
- Kiyaye daidaitawar agogon aikin samfurin SystemClock_Config() LL a ƙarƙashin BOARD SPECIFIC CONFIGURATION tags.
- Dangane da ma'anar LED, maye gurbin kowane abin da ya faru na LDx tare da wani LDy da ke cikin file main.h.
Tare da waɗannan gyare-gyare, example yana gudana akan allon da aka yi niyya.
Aikace-aikacen RF, zanga-zangar, da misaliamples
Nau'o'in aikace-aikacen RF daban-daban, zanga-zangar, da misaliampAna samun les a cikin kunshin STM32CubeWL3. An jera su a cikin sassan biyu da ke ƙasa.
Sub-GHz examples da zanga-zanga
Wadannan exampmu nuna manyan fasalulluka na MRSUBG da LPAWUR rafukan rediyo. Wadannan examples suna samuwa a ƙarƙashin:
- Ayyuka\NUCLEO-WL33CC\Exampda MRSUBG
- Ayyuka\NUCLEO-WL33CC\Example\LPAWUR
- Ayyuka\NUCLEO-WL33CCMunanan zanga-zangar MRSUBG
- Ayyuka\NUCLEO-WL33CC \ Muzahara\LPAWUR
Kowane example ko zanga-zanga gabaɗaya ya ƙunshi shirye-shirye guda biyu da ake kira Tx da Rx suna aiki azaman mai aikawa da karɓa, bi da bi:
- Examples/MRSUBG
- MRSUBG_802_15_4: aiwatar da Layer na zahiri wanda aka ayyana ta daidaitaccen 802.15.4. Yana nuna yadda ake saita rediyo don aikawa ko karɓar fakiti 802.15.4.
- MRSUBG_BasicGeneric: musayar fakiti na asali na STM32WL3x MR_SUBG.
- MRSUBG_Chat: Aikace-aikace mai sauƙi wanda ke nuna yadda ake amfani da Tx da Rx akan na'ura ɗaya.
- MRSUBG_DatabufferHandler: ExampWannan yana nuna yadda ake musanya daga Databuffer 0 da 1.
- MRSUBG_Sequencer AutoAck: Exampwanda ke watsawa da karɓar takaddun fakiti (ACKs) ta atomatik.
- MRSUBG_WBusSTD: Musayar saƙon WM-Bus.
- WakeupRadio: Exampdon gwada kewayen rediyon LPAWUR.
- Zanga-zangar/MRSUBG
- MRSUBG_RTC_Button_TX: Wannan misaliample yana nuna yadda ake saita SoC cikin yanayin tsayawa mai zurfi kuma saita MRSUBG don tada SoC ta latsa PB2 don aika firam ko bayan ƙarewar lokacin RTC.
- MRSUBG_Sequencer_Sniff: Wannan tsohonample yana nuna yadda ake saita mabiyin MRSUBG don yin aiki a yanayin sniff. Wannan example yana nuna gefen mai karɓa kuma yana buƙatar wata na'ura azaman mai watsawa.
- MRSUBG_Timer: Aikace-aikacen yana tsara lokuta da yawa na mai ƙidayar lokaci na MRSUBG (tare da ɗaukar nauyi) tare da tazarar lokaci daban-daban.
- MRSUBG_WakeupRadio_Tx: Wannan misaliample yayi bayanin yadda ake saita SoC cikin yanayin tsayawa mai zurfi kuma saita MRSUBG don tada SoC ta latsa PB2 don aika firam. Wannan example yana nuna gefen watsawa kuma yana buƙatar wata na'ura azaman mai karɓar LPAWUR. Mai karɓa example yana ƙarƙashin NUCLO-WL33CC\Demonstrations\LPAWURLPAWUR_WakeupRad io_Rx babban fayil.
- Muzaharar/LPAWUR
- LPAWUR_WakeupRadio_Rx: Wannan misaliample yayi bayanin yadda ake saita SoC cikin yanayin tsayawa mai zurfi kuma saita LPAWUR don tada SoC lokacin da firam ɗin ya zo kuma an karɓi shi daidai. Wannan example yana nuna gefen mai karɓa kuma yana buƙatar wata na'ura azaman mai watsawa. Mai watsawa example yana ƙarƙashin NUCLO-WL33CC\DemonstrationsMRSUBGMRSUBG_WakeupRad io_Tx babban fayil.
Sigfox™ aikace-aikacen
Waɗannan aikace-aikacen suna nuna yadda ake aiwatar da yanayin Sigfox™ da amfani da APIs na Sigfox™. Ana samun su a hanyar aikin ProjectsNUCLEO-WL33CCApplicationsSigfox:
- Sigfox_CLI: Wannan aikace-aikacen yana nuna yadda ake amfani da ƙirar layin umarni (CLI) don aika umarni waɗanda ke amfani da ka'idar Sigfox™ don aika saƙonni da yin gwajin tantancewa.
- Sigfox_PushButton: Wannan aikace-aikacen yana ba da damar kimanta ƙarfin rediyon na'urar STM32WL33xx Sigfox™. Danna PB1 yana watsa firam ɗin gwaji Sigfox™.
FAQ
- Yaushe zan yi amfani da HAL maimakon direbobin LL?
Direbobin HAL suna ba da babban matakin APIs masu dogaro da aiki, tare da babban matakin ɗauka. Abun ɓoyayyiyar samfur ko sarƙaƙƙiya ce ga masu amfani na ƙarshe.
Direbobin LL suna ba da APIs matakin rijistar ƙananan Layer, tare da ingantacciyar haɓakawa amma ƙasa da šaukuwa. Suna buƙatar zurfin ilimin samfur ko ƙayyadaddun IP. - Za a iya amfani da direbobin HAL da LL tare? Idan eh, menene takura?
Yana yiwuwa a yi amfani da duka direbobin HAL da LL. Yi amfani da HAL don lokacin farawa na gefe sannan kuma sarrafa ayyukan I/O tare da direbobin LL.
Babban bambanci tsakanin HAL da LL shine cewa direbobin HAL suna buƙatar ƙirƙira da amfani da hannaye don gudanar da aiki yayin da direbobin LL ke aiki kai tsaye akan rijistar gefe. An kwatanta hada HAL da LL a cikin Examples_MIX misaliamples. - Ta yaya ake kunna APIs na farawa?
Ma'anar APIs na farawa na LL da albarkatun da ke da alaƙa (tsari, na zahiri, da samfuri) an tsara shi ta hanyar sauya haɗar USE_FULL_LL_DRIVER.
Don samun damar amfani da APIs na farko, ƙara wannan canji a cikin mai haɗa kayan aiki. - Shin akwai wani aikin samfuri na MRSUBG/LPAWUR na gefen examples?
Don ƙirƙirar sabon MRSUBG ko LPAWUR exampaikin, ko dai a fara daga aikin kwarangwal da aka bayar a ƙarƙashin \Pr ojects\NUCLEO-WL33CC\Ex.amples \MRSUBG ko \Projects\NUCLEO-WL33CC\Examples\LPAWUR, ko kuma daga kowane aiki da ke ƙarƙashin waɗannan kundayen adireshi iri ɗaya. - Ta yaya STM32CubeMX zai iya samar da lamba bisa software da aka saka?
STM32CubeMX yana da ilimin ginanniyar ilimin microcontrollers STM32, gami da na'urori da software, wanda ke ba shi damar samar da wakilcin hoto ga mai amfani da samar da * .h ko * .c files bisa tsarin mai amfani.
Tarihin bita
Tebur 3. Tarihin bitar daftarin aiki
| Kwanan wata | Bita | Canje-canje |
| 29-Maris-2024 | 1 | Sakin farko. |
| 30-Oktoba-2024 | 2 | Cikakken haɗin kai na Saukewa: STM32CubeWL3 in Saukewa: STM32Cube. An sabunta:
An cire:
|
Takardu / Albarkatu
 |
Bayanan Bayani na ST STM32WL3x [pdf] Umarni Kunshin Software STM32WL3x, STM32WL3x, Kunshin Software, Kunshin |
