Lisebelisoa tse nyenyane tsa STM32WL3x

Litaelo tsa Tšebeliso ea Sehlahisoa

• Sephutheloana sa STM32CubeWL3 se kenyelletsa li-API tsa "Loyer" tse tlase (LL) le "Hardware abstraction layer" (HAL) tse koahelang lisebelisoa tsa microcontroller.
• E boetse e fana ka lisebelisoa tsa mahareng tse kang SigfoxTM, FatFS, le FreeRTOS kernel.
• Pakete e tla le examples le likopo bakeng sa ts'ebetsong e bonolo.
• Mohaho oa STM32CubeWL3 o hahiloe ho pota-pota mekhahlelo e meraro: Likopo, HAL, le LL.
• HAL le LL APIs li koahela mefuta e mengata ea litlhoko tsa kopo.
• HAL e fana ka ts'ebeliso ea mantlha ea peripheral examples, mme LL e fana ka mekhoa ea maemo a tlase.
• Boemo bona bo kenyeletsa Boto ea Tšehetso Package (BSP) le li-sublayers tsa HAL.
• BSP e fana ka li-API bakeng sa likarolo tsa Hardware libotong, athe HAL e fana ka ts'ebeliso ea mantlha ea peripheral examples.
• Bakhanni ba BSP ba hokahanya bakhanni ba likarolo ho liboto tse itseng, ho etsa hore ho be bonolo ho tsamaisa lisebelisoa tse ling.
• STM32CubeWL3 HAL le LL lia tlatsana, li akaretsa litlhoko tse fapaneng tsa kopo.
• Basebelisi ba ka sebelisa li-API tsena ho sebelisana hantle le lisebelisoa tsa microcontroller.

Selelekela

STM32Cube ke mohato oa mantlha oa STMicroelectronics oa ho ntlafatsa tlhahiso ea baqapi haholo ka ho fokotsa boiteko ba nts'etsopele, nako le litšenyehelo. STM32Cube e akaretsa potefolio eohle ea STM32. STM32Cube e kenyelletsa:

STM32Cube e kenyelletsa:

• Letoto la lisebelisoa tsa ntlafatso ea software tse sebelisoang habonolo ho akaretsa nts'etsopele ea morero ho tloha kemolong ho fihlela ts'ebetsong, har'a tsona ke:
  • STM32CubeMX, sesebelisoa sa graphical software se lumellang ho iketsetsa khoutu ea ho qala C ho sebelisa li-graphical wizards.
  • STM32CubeIDE, sesebelisoa sa nts'etsopele sa tsohle-in-one se nang le tlhophiso ea peripheral, tlhahiso ea khoutu, pokello ea khoutu, le likarolo tsa debug.
  • STM32CubeCLT, sesebelisoa sa ntlafatso sa line-in-one se nang le likhoutu, mananeo a boto, le likarolo tsa ho lokisa liphoso.
  • STM32CubeProgrammer (STM32CubeProg), sesebelisoa sa lenaneo se fumanehang ka mefuta ea litšoantšo le line ea litaelo.
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), lisebelisoa tse matla tsa ho beha leihlo ho lokisa boits'oaro le ts'ebetso ea lits'ebetso tsa STM32 ka nako ea nnete.
• Liphutheloana tsa STM32Cube MCU le MPU, li-platform tsa software tse kenyellelitsoeng ka botlalo ho li-microcontroller le letoto la microprocessor (joalo ka STM32CubeWL3 bakeng sa mohala oa sehlahisoa oa STM32WL3x), tse kenyelletsang:
  • STM32Cube hardware abstraction layer (HAL), e netefatsang ts'ebetso e kholo ho pholletsa le potefolio ea STM32
  • STM32Cube low-layer APIs, ho netefatsa ts'ebetso e ntle ka ho fetisisa le mehato ea maoto ka tekanyo e phahameng ea taolo ea basebelisi holim'a hardware.
  • Sehlopha se ts'oanang sa lisebelisoa tsa mahareng tse kang FreeRTOS™ kernel, FatFS, le Sigfox™.
  • Lisebelisoa tsohle tsa software tse kenyellelitsoeng tse nang le lisebelisoa tse felletseng tsa lisebelisoa tsa khale le tse sebetsangamples
• Liphutheloana tsa Katoloso ea STM32Cube, tse nang le likarolo tsa software tse kentsoeng tse tlatselletsang tšebetso ea liphutheloana tsa STM32Cube MCU le MPU tse nang le:
  • Li-extensions tsa Middleware le likarolo tse sebetsang
  • Exampe sebetsa ho liboto tse itseng tsa nts'etsopele ea STMicroelectronics
• Bukana ena ea mosebelisi e hlalosa mokhoa oa ho qala ka Sephutheloana sa STM32CubeWL3 MCU.

Karolo ea 2 e hlalosa likarolo tsa mantlha tsa STM32CubeWL3 mme Karolo ea 3 e fana ka phetisoview ea meralo ea eona le ea sebopeho sa Pakete ea MCU.

Lintlha tse akaretsang

• Setšoantšo sa STM32CubeWL3 e sebelisa li-sub-GHz, ho kenyeletsoa le li-binaries tsa Sigfox™, ho li-microcontroller tsa mela ea lihlahisoa tsa STM32WL3x tse ipapisitseng le processor ea Arm® Cortex®‑M0+.
• Li-microcontrollers tsa STM32WL3x li kentse peripheral ea seea-le-moea ea RF ea boemo bo holimo ea STMicroelectronics, e ntlafalitsoeng bakeng sa tšebeliso ea matla a tlase haholo le ts'ebetso e ntle ea seea-le-moea, bakeng sa bophelo bohle ba betri.

Hlokomela: Arm ke letshwao la kgwebo le ngodisitsweng la Arm Limited (kapa makala a yona) ho la US le / kapa kae kapa kae.

Lintlha tsa bohlokoa tsa STM32CubeWL3

• Sephutheloana sa STM32CubeWL3 MCU se sebetsa ho li-microcontroller tsa STM32 32-bit tse ipapisitseng le processor ea Arm® Cortex®‑M0+. E bokella, ka har'a sephutheloana se le seng, likarolo tsohle tsa software tse kentsoeng ka kakaretso tse hlokahalang ho theha kopo ea Lethathamo la lintlha tsa STM32WL3x li-microcontroller.
• Sephutheloana se kenyelletsa li-low-layer (LL) le hardware abstraction layer (HAL) APIs tse koahelang lisebelisoa tsa microcontroller, hammoho le sete e pharaletseng ea ex.amples ho sebetsa ho liboto tsa STMicroelectronics. HAL le LL API li fumaneha ka laesense ea BSD ea mohloli o bulehileng molemong oa basebelisi. E boetse e kenyelletsa likarolo tsa Sigfox™, FatFS, le FreeRTOS ™ kernel middleware.
• Sephutheloana sa STM32CubeWL3 MCU se boetse se fana ka lits'ebetso tse 'maloa le lipontšo tse kenyang tšebetsong likarolo tsohle tsa eona tsa mahareng.
• Sebopeho sa karolo ea Sephutheloana sa STM32CubeWL3 MCU se bontšitsoe setšoantšong sa 1.

meralo ea STM32CubeWL3 e felileview

• Tharollo ea Sephutheloana sa STM32CubeWL3 MCU e hahiloe ho potoloha maemo a mararo a ikemetseng a sebelisanang habonolo joalo ka ha ho hlalositsoe ho Setšoantšo sa 2.

Mohato 0
Boemo bona bo arotsoe ka li-sublayers tse tharo:

• Sephutheloana sa tšehetso sa boto (BSP).
• Hardware abstraction layer (HAL):
  • HAL bakhanni ba peripheral
  • Bakhanni ba maemo a tlase
• Tšebeliso ea mantlha ea peripheral examples.

Sephutheloana sa tšehetso sa boto (BSP)
Lera lena le fana ka sehlopha sa li-API tse amanang le likarolo tsa Hardware ka har'a liboto tsa Hardware (joalo ka li-LED, li-buttons le li-driver tsa COM). E entsoe ka likarolo tse peli:

Karolo:

• Ena ke mokhanni ea amanang le sesebelisoa sa kantle ho boto eseng ho STM32. Mokhanni oa karolo o fana ka li-API tse ikhethang ho likarolo tsa kantle tsa mokhanni oa BSP mme a ka nkeha ho boto efe kapa efe.
  • Mokhanni oa BSP:
• E lumella ho hokahanya bakhanni ba likarolo ho boto e itseng mme e fana ka sete ea li-API tse bonolo tsa basebelisi. Molao oa ho reha lebitso oa API ke BSP_FUNCT_Action().
• ExampLe: BSP_LED_Init(), BSP_LED_On()

BSP e ipapisitse le meralo ea modular e lumellang ho tsamaisoa habonolo ho Hardware efe kapa efe ka ho kenya ts'ebetsong mekhoa ea maemo a tlase.

Hardware abstraction layer (HAL) le low-layer (LL)

STM32CubeWL3 HAL le LL lia tlatsana ebile li fana ka litlhoko tse fapaneng tsa kopo:

• Bakhanni ba HAL ba fana ka li-API tse nkehang habonolo tsa maemo a holimo. Ba pata MCU le ho rarahana ha peripheral ho basebelisi ba ho qetela.
  Bakhanni ba HAL ba fana ka li-API tsa mefuta-futa tse amanang le likarolo tse ngata, tse nolofatsang ts'ebetso ea ts'ebeliso ea mosebelisi ka ho fana ka lits'ebetso tse seng li loketse ho sebelisoa. Bakeng sa mohlalaample, bakeng sa liphatlalatso tsa puisano (I2C, UART, le tse ling), e fana ka li-API tse lumellang ho qala le ho hlophisa peripheral, ho laola ho fetisoa ha data ho itšetlehile ka ho khetha, ho sitisa, kapa ts'ebetso ea DMA, le ho sebetsana le liphoso tsa puisano tse ka hlahang nakong ea puisano. HAL driver APIs li arotsoe ka mekhahlelo e 'meli:
  • Li-API tsa Generic, tse fanang ka mesebetsi e tloaelehileng le e akaretsang ho li-microcontroller tsohle tsa STM32.
  • Katoloso ea API, e fanang ka mesebetsi e ikhethileng le e etselitsoeng lelapa le itseng kapa karolo e itseng.
• Li-API tsa maemo a tlase li fana ka li-API tsa boemo bo tlase boemong ba ngoliso, tse nang le ts'ebetso e ntle empa li sa nkeha habonolo.
  Ba hloka tsebo e tebileng ea MCU le litlhaloso tsa peripheral.
  Bakhanni ba LL ba etselitsoe ho fana ka sekhahla se bobebe se potlakileng, se shebaneng le litsebi se haufi le lisebelisoa ho feta HAL. Ho fapana le HAL, LL APIs ha e fanoe bakeng sa li-peripheral moo phihlello e ntlafalitsoeng e seng karolo ea bohlokoa, kapa bakeng sa tse hlokang tlhophiso e boima ea software kapa stack e rarahaneng ea boemo bo holimo.
  Bakhanni ba LL ba na le:
• Sehlopha sa mesebetsi ea ho qala likarolo tsa mantlha tsa peripheral ho latela li-parameter tse boletsoeng meahong ea data.
• Sehlopha sa mesebetsi ho tlatsa meaho ea data ea ho qala ka litekanyetso tsa reset tse tsamaellanang le sebaka ka seng.
• Mosebetsi oa peripheral de-initialization (lirejistara tsa peripheral li khutliselitsoe ho boleng ba tsona ba kamehla).
• Sehlopha sa mesebetsi e ka har'a marang-rang bakeng sa phihlello ea ngoliso e tobileng le ea athomo.
• Ho ikemela ka botlalo ho tsoa ho HAL le bokhoni ba ho sebelisoa ka mokhoa o ikemetseng (ntle le bakhanni ba HAL).
• Tlhaloso e feletseng ea likarolo tsa peripheral tse tšehetsoeng.

Tšebeliso ea mantlha ea peripheral examples
Lera lena le kentse exampe hahiloeng holim'a peripherals ea STM32 e sebelisa feela lisebelisoa tsa HAL le BSP.
Hlokomela: Pontšo examples li fumaneha hape ho bonts'a ex e rarahanengample maemo a nang le peripherals e ikhethileng, joalo ka MRSUBG le LPAWUR.

Mohato 1
Boemo bona bo arotsoe ka li-sublayers tse peli:

• Likarolo tse bohareng
• Exampe thehiloe holim'a likarolo tsa middleware

Likarolo tse bohareng
Middleware ke sehlopha sa lilaebrari tse koahelang FreeRTOS™ kernel, FatFS, le Sigfox™ protocol laebrari.
Tšebelisano e tšekaletseng lipakeng tsa likarolo tsa lera lena e etsoa ka ho letsetsa li-API tse hlahang.
Tšebelisano e otlolohileng le bakhanni ba maemo a tlase e etsoa ka li-callback tse khethehileng le li-macros tse sa fetoheng tse kentsoeng tšebetsong ea mohala oa laeborari.
Likarolo tsa mantlha tsa karolo e 'ngoe le e' ngoe ea middleware ke tse latelang:

• FreeRTOS™ kernel: e sebelisa sistimi e sebetsang ea nako ea nnete (RTOS), e etselitsoeng lits'ebetso tse kentsoeng.
• Sigfox™: e sebelisa laebrari ea protocol ea Sigfox™ e tsamaellanang le marang-rang a Sigfox™ mme e kenyelletsa laeborari ea liteko tsa RF ho etsa liteko khahlano le lisebelisoa tsa RF Sigfox™.
• FatFS: e sebelisa FAT e tloaelehileng file module ea tsamaiso.

Exampe thehiloe holim'a likarolo tsa middleware

• Karolo e 'ngoe le e' ngoe ea middleware e tla le ex e le 'ngoe kapa ho fetaamples, eo hape e bitsoang lits'ebetso, e bonts'ang mokhoa oa ho e sebelisa.
• Ho kopanya mohlalaample tse sebelisang likarolo tse 'maloa tsa middleware li fanoa hape.

Sephutheloana sa firmware sa STM32CubeWL3 se felileview

Lisebelisoa tsa STM32WL3x tse tšehetsoeng le lisebelisoa

• Sehlopha sa STM32Cube e fana ka lera le nkehang habobebe la Hardware abstraction layer (HAL) le hahiloeng ho pota-pota meaho e akaretsang. E lumella molao-motheo oa ho aha holim'a mekhahlelo, joalo ka ho sebelisa sethala sa middleware ho kenya tšebetsong mesebetsi ea bona ntle le ho tseba, ka botebo, hore na MCU e sebelisoa eng. Sena se ntlafatsa ts'ebeliso ea khoutu ea laeborari hape 'me se netefatsa hore ho bonolo ho nkeha lisebelisoa tse ling.
• Ho feta moo, ka meaho ea eona e nang le layered, Setšoantšo sa STM32CubeWL3 e fana ka tšehetso e felletseng bakeng sa mela eohle ea lihlahisoa tsa STM32WL3x.
• Mosebelisi o tlameha ho hlalosa feela macro e nepahetseng ho stm32wl3x.h.
• Letlapa la 1 le bonts'a macro ho hlalosa ho latela sesebelisoa sa mohala oa sehlahisoa sa STM32WL3x se sebelisitsoeng. Macro ena e boetse e tlameha ho hlalosoa ho preprocessor ea compiler.

Letlapa la 1. Macros bakeng sa line ea lihlahisoa tsa STM32WL3x

Macro e hlalositsoe ka har'a Setšoantšo sa STM32WL3X.h	Lisebelisoa tsa line ea lihlahisoa tsa STM32WL3x
stm32wl3x	STM32WL30xx microcontrollers STM32WL31xx microcontrollers STM32WL33xx microcontrollers

Letlapa la 2. Maboto a lihlahisoa tsa lihlahisoa tsa STM32WL3x

Boto	STM32WL3x lisebelisoa tse tšehetsoeng ke boto
NUCLEO-WL33CC1	Setšoantšo sa STM32WL33CC
NUCLEO-WL33CC2	Setšoantšo sa STM32WL33CC

Sephutheloana sa STM32CubeWL3 MCU se ka sebetsa ho lisebelisoa life kapa life tse tsamaellanang. Basebelisi ba nchafatsa li-driver tsa BSP ho tsamaisa li-ex tse fanoengamples libotong tsa bona, haeba tsena li na le likarolo tse tšoanang tsa Hardware (joalo ka li-LED kapa likonopo).

Sephutheloana sa firmware se felileview

• Tharollo ea Sephutheloana sa STM32CubeWL3 MCU e fanoa ka har'a sephutheloana se le seng sa zip, ka sebopeho se bontšitsoeng ho Setšoantšo sa 3.

Tlhokomeliso: Mosebelisi ha a tlameha ho fetola likarolo files. Mosebelisi a ka hlophisa feela mehloli ea \Projects. Bakeng sa boto ka 'ngoe, sete ea examples e fanoe ka merero e reriloeng esale pele bakeng sa liketane tsa lisebelisoa tsa EWARM, MDK-ARM, le STM32CubeIDE.
Setšoantšo sa 4 se bontša sebopeho sa morero bakeng sa liboto tsa NUCLEO-WL33CCx.

Exampli-les li arotsoe ho latela boemo ba STM32CubeWL3 boo ba sebetsang ho bona. Li bitsoa ka tsela e latelang:

• Boemo 0 mohlamples li bitsoa Examples, Examples_LL, le Examphanyane_MIX. Ba sebelisa ka ho latellana bakhanni ba HAL, bakhanni ba LL, le motsoako oa bakhanni ba HAL le LL ntle le karolo ea mahareng. Pontšo example tsona li fumaneha.
• Boemo 1 mohlamptse ling li bitsoa Lisebelisoa. Ba fana ka linyeoe tse tloaelehileng tsa tšebeliso ea karolo e 'ngoe le e' ngoe ea middleware.

Kopo efe kapa efe ea firmware bakeng sa boto e fanoeng e ka hahuoa kapele ho sebelisoa merero ea template e fumanehang ho li-directory tsa Templates le Templates_LL.
Examples, Examples_LL, le Exampless_MIX e na le sebopeho se ts'oanang:

• \Inc foldara e nang le lihlooho tsohle files.
• \ Src foldareng e nang le khoutu ea mohloli.
• \ EWARM, \ MDK-ARM, le \ STM32CubeIDE lifoldara tse nang le morero o hlophisitsoeng esale pele bakeng sa ketane ka 'ngoe ea lisebelisoa.
• readme.md le readme.html e hlalosang exampboitšoaro le tikoloho e hlokahalang ho etsa hore e sebetse.

Ho qala ka STM32CubeWL3

Ho matha ex ea peleample
Karolo ena e hlalosa kamoo ho leng bonolo ho tsamaisa ex ea peleample ka har'a STM32CubeWL3. E sebelisa e le papiso tlhahiso ea toggle e bonolo ea LED e sebetsang botong ea NUCLEO-WL33CC1:

1. Khoasolla Sephutheloana sa STM32CubeWL3 MCU.
2. E notlolle, kapa u tsamaise setlhophiso haeba se fanoe, bukeng ea khetho ea hau.
3. Etsa bonnete ba hore u se ke ua fetola sebopeho sa sephutheloana se bontšitsoeng Setšoantšong sa 3. Sebopeho sa sephutheloana sa firmware sa STM32CubeWL3. Hlokomela hore ho boetse ho kgothaletswa ho kopitsa sephutheloana sebakeng se haufi le molumo oa motso (e bolelang C: \ ST kapa G: \ Liteko), kaha li-IDE tse ling li kopana le mathata ha tsela e le telele haholo.

Mokhoa oa ho tsamaisa HAL example
Pele o kenya le ho tsamaisa example, e ka matla kgothaletswa ho bala example balame file bakeng sa tlhophiso efe kapa efe e khethehileng.

1. Batla ho \Projects\NUCLEO-WL33CC\Examples.
2. Bula \ GPIO, ebe \GPIO_EXTI lifoldara.
3. Bula morero ka sesebelisoa se ratoang. Ho feta kapeleview mabapi le mokhoa oa ho bula, ho haha, le ho tsamaisa example le liketane tse tšehetsoeng li fanoe ka tlase.
4. Aha tsohle bocha files ebe o kenya setšoantšo mohopolong oa sepheo.
5. Matha example. Bakeng sa lintlha tse ling, sheba ho example balame file.

Ho bula, ho haha, le ho tsamaisa example e 'ngoe le e' ngoe ea liketane tse tšehelitsoeng, latela mehato e ka tlase:

• EWARM:
  1. Tlas'a Example foldareng, bula foldara e tlase ea \EWARM.
  2. Qala sebaka sa mosebetsi sa Project.eww (lebitso la sebaka sa mosebetsi le ka fetoha ho tloha ho motho a le mongample ho emong).
  3. Aha tsohle bocha files: [Projeke]>[Haha tsohle bocha].
  4. Kenya setšoantšo sa morero: [Project]>[Debug].
  5. Tsamaisa lenaneo: [Debug]>[Eya (F5)].
• MDK-ARM:
  1. Tlas'a Example foldareng, bula foldara e nyane ea \ MDK-ARM.
  2. Bula sebaka sa mosebetsi sa Project.uvproj (lebitso la sebaka sa mosebetsi le ka fetoha ho tloha ho motho a le mongample ho emong).
  3. Aha tsohle bocha files: [Project]>[Aha bocha sepheo sohle files].
  4. Kenya setšoantšo sa projeke: [Debug]>[Qala/Emisa Session ea ho Lokisa].
  5. Tsamaisa lenaneo: [Debug]> [Matha (F5)].
• STM32CubeIDE:
  1. Bula sesebelisoa sa STM32CubeIDE.
  2. Tobetsa ho [File]>[Fetolela Sebaka sa Mosebetsi]>[Tse ling] ebe u sheba lethathamong la sebaka sa mosebetsi la STM32CubeIDE.
  3. Tobetsa ho [File]>[Import], khetha [Kakaretso]>[Merero e teng Sebakeng sa Mosebetsi], ebe u tobetsa [E latelang].
  4. Batla bukeng ea sebaka sa mosebetsi sa STM32CubeIDE ebe u khetha morero.
  5. Aha bocha merero eohle files: Khetha morero fensetereng ea Project Explorer ebe u tobetsa ho [Project]> [Build project] menu.
  6. Tsamaisa lenaneo: [Matha]> [Debug (F11)].

Ho theha sesebelisoa se ikhethileng

Ho sebelisa STM32CubeMX ho hlahisa kapa ho ntlafatsa sesebelisoa

• Ka har'a Sephutheloana sa STM32Cube MCU, hoo e ka bang merero eohle ea peleampli-les li hlahisoa ka sesebelisoa sa STM32CubeMX ho qala sistimi, li-peripherals, le middleware.

Tšebeliso e tobileng ea morero o teng example ho tsoa ho sesebelisoa sa STM32CubeMX se hloka STM32CubeMX 6.12.0 kapa ho feta:

• Ka mor'a ho kenya STM32CubeMX, bula 'me ha ho hlokahala u nchafatse morero o reriloeng.
  Mokhoa o bonolo oa ho bula projeke e teng ke ho penya habeli *.ioc file e le hore STM32CubeMX e bule morero le mohloli oa eona files. STM32CubeMX e hlahisa khoutu ea mohloli oa ho qala oa merero e joalo.
• Khoutu ea mantlha ea mohloli oa kopo e fumaneha ke maikutlo a "USER CODE BEGIN" le "USER CODE END". Haeba khetho ea peripheral le litlhophiso li fetotsoe, STM32CubeMX e ntlafatsa karolo ea ho qala ea khoutu ha e ntse e boloka khoutu ea mohloli o ka sehloohong oa kopo.
• Ho theha projeke ea tloaelo ka STM32CubeMX, latela mohato ka mohato:
  1. Hlophisa lisebelisoa tsohle tse kenyellelitsoeng tse kentsoeng u sebelisa pinout-conflict solver, thuso ea ho seta sefate sa oache, sebali sa tšebeliso ea matla, le sesebelisoa se etsang peripheral configuration (joalo ka GPIO kapa USART).
  2. Hlahisa khoutu ea C ea ho qala ho ipapisitse le tlhophiso e khethiloeng. Khoutu ena e se e loketse ho sebelisoa ka har'a libaka tse 'maloa tsa ntlafatso. Khoutu ea mosebelisi e bolokiloe tlhahisong e latelang ea khoutu.
     Bakeng sa tlhahisoleseding e eketsehileng mabapi le STM32CubeMX, sheba buka ea mosebedisi ea STM32CubeMX bakeng sa tlhophiso ea STM32 le ho qala tlhahiso ea khoutu ea C (UM1718).

Lisebelisoa tsa mokhanni
Sesebelisoa sa HAL
Karolo ena e hlalosa mehato e hlokahalang ho theha ts'ebeliso e tloaelehileng ea HAL o sebelisa STM32CubeWL3

1. Etsa morero
   Ho theha projeke e ncha, qala ho tsoa ho projeke ea Template e fanoeng bakeng sa boto ka 'ngoe tlasa \Projects\ \ Litempele kapa ho tsoa ho projeke efe kapa efe e fumanehang tlasa \Projects\ \Examples kapa \Proj ects\ \ Likopo (moo e bua ka lebitso la boto).
   Morero oa Template o fana ka ts'ebetso e se nang letho ea loop. Leha ho le joalo, ke ntlha e ntle ea ho qala ho utloisisa litlhophiso tsa projeke ea STM32CubeWL3. Template e na le litšobotsi tse latelang:
   • E na le khoutu ea mohloli oa HAL, CMSIS, le bakhanni ba BSP, e leng palo e fokolang ea likarolo tse hlokahalang ho hlahisa khoutu letlapeng le fanoeng.
   • E na le litsela tse kenyellelitsoeng bakeng sa likarolo tsohle tsa firmware.
   • E hlalosa lisebelisoa tsa mohala oa lihlahisoa tsa STM32WL3x tse tšehetsoeng, tse lumellang li-driver tsa CMSIS le HAL hore li hlophisoe ka nepo.
   • E fana ka mosebelisi ea seng a loketse ho sebelisoa files preconfigured joalokaha ho bontšitsoe ka tlase:
   • HAL e qalile ka nako ea kamehla ka Arm® core SysTick.
   • SysTick ISR e kentsoe tšebetsong molemong oa HAL_Delay().
   • Tlhokomeliso: Ha u kopitsa morero o teng sebakeng se seng, etsa bonnete ba hore litsela tsohle tse kenyellelitsoeng li nchafalitsoe.
2. Lokisa likarolo tsa firmware
   Likarolo tsa HAL le middleware li fana ka likhetho tsa tlhophiso ea nako ea ho haha ​​​​ho sebelisa macros #define e phatlalalitsoeng hloohong. file. Sebopeho sa template file e fanoa ka har'a karolo e 'ngoe le e' ngoe, e lokelang ho kopitsoa ho foldara ea projeke (hangata ke tlhophiso file e bitsoa xxx_conf_template.h, sekhechana
   • template e hloka ho tlosoa ha u e kopitsa ho foldara ea morero). Tlhophiso file e fana ka leseli le lekaneng ho utloisisa phello ea khetho e 'ngoe le e 'ngoe ea tlhophiso. Lintlha tse qaqileng haholoanyane li fumaneha litokomaneng tse fanoeng bakeng sa karolo ka 'ngoe.
3. Qala laeborari ea HAL
   Kamora ho tlolela lenaneong la mantlha, khoutu ea kopo e tlameha ho letsetsa HAL_Init() API ho qala laeborari ea HAL, e etsang mesebetsi e latelang:
   • Tlhophiso ea tlhahiso ea pele ea memori ea flash le SysTick e sitisa bohlokoa (ka li-macros tse hlalositsoeng ho stm32 wl3x_hal_conf.h).
   • Tlhophiso ea SysTick ho hlahisa tšitiso motsotsoana o mong le o mong ho SysTick tšitiso ea bohlokoa TICK_INT_PRIO e hlalositsoeng ho stm32wl3x_hal_conf.h.
   • Tlhophiso ea bohlokoa ba sehlopha sa NVIC ho 0.
   • Call of HAL_MspInit() callback ts'ebetso e hlalosoang ho stm32wl3x_hal_msp.c mosebelisi file ho etsa lits'ebetso tsa lefats'e tsa maemo a tlase a hardware.
4. Lokisa oache ea sistimi
   Tlhophiso ea oache ea sistimi e etsoa ka ho bitsa li-API tse peli tse hlalositsoeng ka tlase:
   • HAL_RCC_OscConfig(): API ena e hlophisa li-oscillator tsa kahare le kantle. Mosebelisi o khetha ho
     lokisa oscillator e le 'ngoe kapa kaofela.
   • HAL_RCC_ClockConfig(): API ena e hlophisa mohloli oa oache ea sistimi, latency ea memori ea flash, le li-prescaler tsa AHB le APB.
5. Qala karolo ea peripheral
   • Pele ngola tšebetso ea peripheral initialization. Tsoela pele ka tsela e latelang:
   • Lumella oache e potolohileng.
   • Lokisa li-GPIO tsa peripheral.
   • Lokisa kanale ea DMA 'me u lumelle ho sitisa DMA (ha ho hlokahala).
   • Lumella ho sitisoa ha peripheral (ha ho hlokahala).
   • Fetola stm32xxx_it.c ho letsetsa batho ba hlokehang ba sitisoeng ke letho (peripheral le DMA), ha ho hlokahala.
   • Ngola ts'ebetso e felletseng ea lits'ebetso tsa ho khutlisa haeba ho na le tšitiso ea pheriferale kapa DMA e reretsoe ho sebelisoa.
   • Ho basebelisi ba mantlha.c file, qala sebopeho sa ho sebetsana le peripheral ebe o letsetsa tšebetso ea peripheral initialization ho qala peripheral.
6. Etsa kopo
   Ho sena stage, sistimi e se e lokile mme nts'etsopele ea khoutu ea ts'ebeliso ea mosebelisi e ka qala.
   HAL e fana ka li-API tse hlakileng le tse itokiselitseng ho sebelisoa ho hlophisa peripheral. E ts'ehetsa likhetho, litšitiso, le mofuta oa lenaneo la DMA, ho amohela litlhoko life kapa life tsa kopo. Bakeng sa lintlha tse ling mabapi le mokhoa oa ho sebelisa peripheral e 'ngoe le e' ngoe, sheba ex ea moruiample sete e fanoeng ka har'a Sephutheloana sa STM32CubeWL3 MCU.

Tlhokomeliso: Ts'ebetsong ea kamehla ea HAL, nako ea SysTick e sebelisoa e le setsi sa nako: e hlahisa litšitiso ka linako tse itseng. Haeba HAL_Delay() e bitsoa ho tsoa ts'ebetsong ea peripheral ISR, etsa bonnete ba hore tšitiso ea SysTick e na le ntho e tlang pele (ka palo e tlase) ho feta tšitiso ea peripheral. Ho seng joalo, ts'ebetso ea ISR ea letsetsa e koetsoe. Mesebetsi e amang tlhophiso ea nako e phatlalatsoa e le __e fokolang ho etsa hore ho fetellehe haeba ho ka ba le lits'ebetso tse ling ho mosebelisi. file (ho sebelisa sebali sa nako ea sepheo se akaretsang, mohlalaample, kapa mohloli o mong oa nako). Ho fumana lintlha tse ling, sheba HAL_TimeBase example.

Sesebelisoa sa LL
Karolo ena e hlalosa mehato e hlokahalang ho theha ts'ebeliso ea tloaelo ea LL ho sebelisa STM32CubeWL3.

1. Etsa morero
   Ho theha projeke e ncha, qala ho tsoa ho projeke ea Templates_LL e fanoeng bakeng sa boto ka 'ngoe tlasa \Projects\ \Templates_LL kapa morero ofe kapa ofe o teng tlas'a \Projects\ \Examphanyane_ LL ( e bua ka lebitso la boto, joalo ka NUCLEO-WL32CC33).
   Morero oa template o fana ka ts'ebetso ea mantlha e se nang letho, e leng sebaka se setle sa ho qala ho utloisisa litlhophiso tsa projeke bakeng sa STM32CubeWL3. Litšobotsi tse ka sehloohong tsa template ke tse latelang:
   • E na le likhoutu tsa mohloli oa bakhanni ba LL le CMSIS, e leng palo e fokolang ea likarolo tse hlokahalang ho hlahisa khoutu letlapeng le fanoeng.
   • E na le litsela tse kenyellelitsoeng bakeng sa likarolo tsohle tse hlokahalang tsa firmware.
   • E khetha sesebelisoa sa line sa sehlahisoa sa STM32WL3x se tšehetsoeng 'me se lumella tlhophiso e nepahetseng ea bakhanni ba CMSIS le LL.
   • E fana ka mosebelisi ea seng a loketse ho sebelisoa filetse lokiselitsoeng esale pele ka tsela e latelang:
   • main.h: LED le USER_BUTTON lera la tlhaloso e akaretsang.
   • main.c: Tlhophiso ea oache ea sistimi bakeng sa maqhubu a mangata.
2. Port the LL exampLe:
   • Kopitsa / beha fensetere ea Templates_LL - ho boloka mohloli oa pele - kapa ho ntlafatsa ka ho toba morero o teng oa Template s_LL.
   • Joale, porting e kenyelletsa haholo-holo ho nkela Templates_LL sebaka files ka Examples_LL morero o lebisitsoeng.
   • Boloka likarolo tsohle tse khethehileng tsa boto. Bakeng sa mabaka a ho hlaka, likarolo tse khethehileng tsa boto li tšoailoe ka tse khethehileng tags:
   • Kahoo, mehato e ka sehloohong ea ho tsamaisa ke tse latelang:
   • Kenya sebaka sa stm32wl3x_it.h file.
   • Kenya sebaka sa stm32wl3x_it.c file.
   • Ho nkela sebaka se seholo.h file 'me u e ntlafatse: Boloka leseli la LED le konopo ea mosebedisi ea template ea LL tlas'a BOARD Specific CONFIGURATION tags.
   • Nka sebaka sa mantlha.c file 'me u e ntlafatse:
   • Boloka tlhophiso ea oache ea ts'ebetso ea template ea SystemClock_Config() LL tlasa BOARD SPEICIFIC CONFIGURATION. tags.
   • Ho latela tlhaloso ea LED, nka sebaka se seng le se seng sa LDx ka LDy e 'ngoe e fumanehang ho file ka sehloohong.h.
   • Ka liphetoho tsena, example matha holim'a letlapa le lebisitsoeng.

Lisebelisoa tsa RF, lipontšo, le mohlalaamples
Mefuta e fapaneng ea lits'ebetso tsa RF, lipontšo, le mohlalaampli fumaneha ka har'a sephutheloana sa STM32CubeWL3.
Li thathamisitsoe likarolong tse peli tse ka tlase.

Sub-GHz examples le lipontšo
Tsena exampre bonts'a likarolo tsa mantlha tsa liphatlalatso tsa radio tsa MRSUBG le LPAWUR. Tsena examptse ling li fumaneha ka tlase:

• Merero\NUCLEO-WL33CC\Exampjoalo\MRSUBG
• Merero\NUCLEO-WL33CC\Exampjoalo\LPAWUR
• Merero\NUCLEO-WL33CC\Demonstrations\MRSUBG
• Merero\NUCLEO-WL33CC\Demonstrations\LPAWUR

Example kapa pontšo ka kakaretso e na le mananeo a mabeli a bitsoang Tx le Rx a sebetsang e le transmitter le receiver, ka ho latellana:

Examptse/MRSUBG

• MRSUBG_802_15_4: ts'ebetsong ea lera la 'mele le hlalositsoeng ke standard 802.15.4. E bontša mokhoa oa ho lokisa seea-le-moea hore se fetisoe kapa se fumane lipakete tsa 802.15.4.
• MRSUBG_BasicGeneric: Phapanyetsano ea lipakete tsa mantlha tsa STM32WL3x MR_SUBG.
• MRSUBG_Chat: Sesebelisoa se bonolo se bonts'ang mokhoa oa ho sebelisa Tx le Rx sesebelisoa se le seng.
• MRSUBG_DatabufferHandler: An example e bonts'ang mokhoa oa ho fapanyetsana ho tloha ho Databuffer 0 le 1.
• MRSUBG_Sequencer AutoAck: Mohlalaampe fetisang le ho amohela lipakete tsa liteboho (ACKs) ka bo eona.
• MRSUBG_WMBusSTD: Phapanyetsano ea melaetsa ea WM-Bus.
• WakeupRadio: An example ho leka LPAWUR radio peripheral.

Lipontšo/MRSUBG

• MRSUBG_RTC_Button_TX: Mohlala onaample e bonts'a mokhoa oa ho beha SoC ka mokhoa o tebileng oa ho emisa le ho lokisa MRSUBG ho tsosa SoC ka ho tobetsa PB2 ho romela foreimi kapa ka mor'a ho fela ha nako ea RTC.
• MRSUBG_Sequencer_Sniff: Mohlala onaampe bonts'a mokhoa oa ho seta sequencer ea MRSUBG hore e sebetse ka mokhoa oa ho fofonela. Example e bonts'a lehlakore la moamoheli mme e hloka sesebelisoa se seng joalo ka transmitter.
• MRSUBG_Timer: Sesebelisoa se hlophisa linako tse 'maloa tsa MRSUBG timer (ka autoreload) ka linako tse fapaneng.
• MRSUBG_WakeupRadio_Tx: Mohlala onaample hlalosa mokhoa oa ho beha SoC boemong bo tebileng ba ho emisa le ho lokisa MRSUBG ho tsosa SoC ka ho tobetsa PB2 ho romela foreimi. Example e bonts'a lehlakore la transmitter mme e hloka sesebelisoa se seng joalo ka moamoheli oa LPAWUR. Moamoheli example e fumaneha tlasa NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx foldara.

Lipontšo/LPAWUR

• LPAWUR_WakeupRadio_Rx: Mohlala onaampe hlalosa mokhoa oa ho beha SoC ka mokhoa o tebileng oa ho emisa le ho lokisa LPAWUR ho tsosa SoC ha foreimi e fihla 'me e amoheloa ka nepo. Example e bonts'a lehlakore la moamoheli mme e hloka sesebelisoa se seng joalo ka transmitter. Mofetisi example e fumaneha tlas'a NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx foldara.

Sesebelisoa sa Sigfox™
Lisebelisoa tsena li bonts'a mokhoa oa ho kenya ts'ebetsong boemo ba Sigfox™ le ho sebelisa Sigfox™ APIs e fumanehang. Li fumaneha tseleng ea morero Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: Sesebelisoa sena se bonts'a mokhoa oa ho sebelisa sebopeho sa line-taelo (CLI) ho romella litaelo tse sebelisang Sigfox™ protocol ho romella melaetsa le ho etsa liteko tsa precertification.
• Sigfox_PushButton: Sesebelisoa sena se lumella tlhahlobo ea bokhoni ba seea-le-moea ba sesebelisoa sa STM32WL33xx Sigfox™. Ho tobetsa PB1 ho fetisa foreimi ea Sigfox™ ea teko.

Nalane ea ntlafatso

Lethathamo la 3. Histori ea ntlafatso ea litokomane

Letsatsi	Khatiso	Liphetoho
29-Mar-2024	1	Tokollo ea pele.
30-Oct-2024	2	Khokahano e felletseng ea STM32CubeWL3 ho STM32Cube. E ntlafalitsoe: •         Selelekela •         Karolo ea 2: Lintlha tse ka sehloohong tsa STM32CubeWL3 •         Karolo ea 3.2.1: Lisebelisoa tse bohareng •         Karolo ea 4: Sephutheloana sa firmware sa STM32CubeWL3 se felileview •         Karolo ea 5.1: Ho tsamaisa example •         Karolo ea 5.3: Likopo tsa RF, lipontšo, le mohlalaamples E kentsoe: •         Karolo ea 5.1.1: Mokhoa oa ho tsamaisa HAL example •         Karolo ea 5.2.1: Ho sebelisa STM32CubeMX ho hlahisa kapa ho ntlafatsa kopo • Skarolo 6.4: Na ho na le morero oa template oa MRSUBG/LPAWUR peripheral examples? •         Karolo ea 6.5: STM32CubeMX e ka hlahisa khoutu joang ho latela software e kentsoeng? E tlositsoe: •         Lisebelisoa tsa PC, ho kenyeletsa Navigator, Setšoantšo sa STM32WL3, le MR-SUBG Sequencer GUI •         WiSE-Studio IOMapper e ka hlahisa khoutu joang ho latela software e kentsoeng? •         Na Navigator e lumella ho fihlella lisebelisoa tsa sephutheloana sa software?
22-Jan-2025	3	E atolositse mefuta e mengata ea lisebelisoa tse sebetsang ho STM32WL30xx le STM32WL31xx microcontrollers ho Lethathamo la 1. Macros bakeng sa STM32WL3x line ea sehlahisoa.

TSEBISO EA BOHLOKOA – BALA KA HLOKO

• STMicroelectronics NV le li-subsidiary tsa eona ("ST") li na le tokelo ea ho etsa liphetoho, litokiso, lintlafatso, lintlafatso, le lintlafatso ho lihlahisoa tsa ST le/kapa tokomaneng ena ka nako efe kapa efe ntle le tsebiso. Bareki ba lokela ho fumana lintlha tsa morao-rao tse amanang le lihlahisoa tsa ST pele ba fana ka litaelo. Lihlahisoa tsa ST li rekisoa ho latela lipehelo le maemo a thekiso ea ST ka nako ea tumello ea taelo.
• Bareki ke bona feela ba ikarabellang bakeng sa khetho, khetho, le tšebeliso ea lihlahisoa tsa ST mme ST ha e nke e le molato bakeng sa thuso ea kopo kapa moralo oa lihlahisoa tsa bareki.
• Ha ho laesense, e hlalositsoeng kapa e boletsoeng, ea tokelo efe kapa efe ea thepa ea mahlale e fanoeng ke ST mona.
• Ho rekisoa ha lihlahisoa tsa ST ka litokisetso tse fapaneng le tlhahisoleseding e boletsoeng mona ho tla hlakola waranti leha e le efe e fanoeng ke ST bakeng sa sehlahisoa se joalo.
• ST le logo ea ST ke matšoao a khoebo a ST. Bakeng sa lintlha tse ling mabapi le matšoao a khoebo a ST, sheba ho www.st.com/trademarks. Mabitso a mang kaofela a lihlahisoa kapa litšebeletso ke thepa ea beng ba tsona.
• Lintlha tse tokomaneng ena li nkela sebaka le ho nkela tlhahisoleseding e neng e fanoe pele liphetolelong tsa pele tsa tokomane ena.
• © 2025 STMicroelectronics – Litokelo tsohle li sirelelitsoe

LBH

Ke lokela ho sebelisa HAL neng sebakeng sa bakhanni ba LL?

Bakhanni ba HAL ba fana ka li-API tsa boemo bo holimo le tse shebaneng le tšebetso, tse khonang ho nkeha habonolo. Sehlahisoa kapa ho rarahana ha peripheral ho patiloe basebelisi ba ho qetela. Bakhanni ba LL ba fana ka li-API tsa boemo bo tlase ba ngoliso e nang le ts'ebetso e ntle empa e sa nkeha habonolo. Ba hloka tsebo e tebileng ea sehlahisoa kapa litlhaloso tsa IP.

Li-API tsa ho qala tsa LL li thusa joang?

Tlhaloso ea li-API tsa ho qala tsa LL le meaho ea lisebelisoa tse amanang le eona le li-prototype li hlophisoa ke sesebelisoa sa ho kopanya sa USE_FULL_LL_DRIVER. Ho khona ho sebelisa li-API tsa ho qala tsa LL, eketsa sesebelisoa sena ho sesebelisoa sa "toolchain compiler preprocessor".

Na ho na le projeke ea template ea MRSUBG/LPAWUR ea peripheral examples?

Ho theha MRSUBG kapa LPAWUR example projeke, e ka qala ho tsoa ho projeke ea skeleton e fanoeng tlasa Pr ojectsNUCLEO- 33CC Examples MRSUBG kapa ProjectsNUCLEO-WL33CC Examples LPAWUR kapa ho tsoa ho projeke efe kapa efe e fumanehang tlasa li-directory tsona tsena.

STM32CubeMX e ka hlahisa khoutu joang ho latela software e kentsoeng?

STM32CubeMX e na le tsebo e hahelletsoeng ka har'a li-microcontrollers tsa STM32, ho kenyeletsoa lisebelisoa tsa bona le software, e e lumellang ho fana ka setšoantšo sa setšoantšo ho mosebelisi le ho hlahisa .h kapa .c files e ipapisitse le tlhophiso ea mosebelisi.

Litokomane / Lisebelisoa

STM32WL3x Microcontrollers [pdf] Bukana ea Mosebelisi STM32WL3x Microcontrollers, STM32WL3x, Microcontrollers

Litšupiso

• Bukana ea Mosebelisi