Ireo singa mifandraika amin'ny STM32WL3X

Torolàlana momba ny fampiasana vokatra

• Ny fonosana STM32CubeWL3 dia misy APIs ambany sosona (LL) sy sosona abstraction hardware (HAL) izay mandrakotra ny fitaovana microcontroller.
• Izy io koa dia manome singa midadasika toy ny SigfoxTM, FatFS, ary kernel FreeRTOS.
• Ny fonosana dia miaraka amin'ny examples sy fampiharana ho mora fampiharana.
• Ny maritrano STM32CubeWL3 dia naorina manodidina ny ambaratonga telo: Applications, HAL, ary LL.
• Ny API HAL sy LL dia mirakitra karazana fangatahana fampiharana maro.
• Ny HAL dia manolotra fampiasana periferika fototra examples, ary ny LL dia manome fomba fanao ambany.
• Ity ambaratonga ity dia ahitana ny Board Support Package (BSP) sy ny sublayers HAL.
• Ny BSP dia manolotra API ho an'ny singa fitaovana amin'ny boards, raha ny HAL kosa dia manome ny fampiasana periferika fototra examples.
• Ampifandraisin'ny mpamily BSP amin'ny solaitrabe manokana ny mpamily singa, ka mahatonga azy ho mora ny seranana amin'ny fitaovana hafa.
• Ny STM32CubeWL3 HAL sy LL dia mifameno, mandrakotra karazana fangatahana fampiharana.
• Afaka mampiasa ireo API ireo ny mpampiasa mba hifaneraserana amin'ny fitaovana microcontroller.

Sava lalana

STM32Cube dia STMicroelectronics voalohany hanatsara ny famokarana vokatra amin'ny alàlan'ny fampihenana ny ezaka fampandrosoana, ny fotoana ary ny vidiny. STM32Cube dia mandrakotra ny portfolio STM32 manontolo. STM32Cube dia misy:

STM32Cube dia misy:

• Fitaovam-pampandrosoana rindrambaiko ho an'ny mpampiasa mba handrakotra ny fivoaran'ny tetikasa manomboka amin'ny foto-kevitra ka hatramin'ny fanatanterahana, anisan'izany ny:
  • STM32CubeMX, fitaovana fanamafisam-peo rindrankajy izay mamela ny famokarana mandeha ho azy ny kaody fanombohana C amin'ny alàlan'ny mpamosavy grafika.
  • STM32CubeIDE, fitaovana fampivoarana rehetra miaraka amin'ny fanamafisana periferika, famoronana kaody, fanangonana kaody ary endri-javatra debug
  • STM32CubeCLT, fitaovana fampivoarana andalana iray manontolo miaraka amin'ny fanangonana kaody, fandaharana amin'ny board ary endri-javatra debug
  • STM32CubeProgrammer (STM32CubeProg), fitaovana fandaharana misy amin'ny dikan-tsary sy baiko
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), fitaovana fanaraha-maso mahery vaika hanamafisana ny fihetsika sy ny fanatanterahana ny fampiharana STM32 amin'ny fotoana tena izy
• STM32Cube MCU sy MPU Packages, sehatra rindrankajy feno embedded manokana ho an'ny andiany microcontroller sy microprocessor tsirairay (toy ny STM32CubeWL3 ho an'ny tsipika vokatra STM32WL3x), izay ahitana:
  • STM32Cube hardware abstraction layer (HAL), miantoka ny fivezivezena be indrindra manerana ny portfolio STM32
  • STM32Cube ambany sosona API, miantoka ny fampisehoana tsara indrindra sy ny dian-tongotra miaraka amin'ny ambaratonga ambony ny mpampiasa mifehy ny hardware
  • Sehatra midadasika tsy miovaova toy ny kernel FreeRTOS™, FatFS, ary Sigfox™
  • Fampiasa rindrambaiko tafiditra rehetra miaraka amin'ny andiana periferika sy applicative fenoampl'
• STM32Cube Expansion Packages, izay misy singa rindrambaiko napetraka izay mameno ny fiasan'ny STM32Cube MCU sy MPU Packages miaraka amin'ny:
  • Fanitarana Middleware sy sosona azo ampiharina
  • Examples mandeha amin'ny birao fampandrosoana STMicroelectronics manokana
• Ity boky torolalana ho an'ny mpampiasa ity dia mamaritra ny fomba hanombohana ny STM32CubeWL3 MCU Package.

Ny fizarana 2 dia mamaritra ny endri-javatra lehibe amin'ny STM32CubeWL3 ary ny fizarana 3 dia manome mihoatraview momba ny maritrano sy ny rafitra MCU Package.

Fampahalalana ankapobeny

• Sary STM32CubeWL3 dia mitantana fampiharana fampisehoana sub-GHz, ao anatin'izany ny binaries Sigfox™, amin'ny microcontrollers andalana vokatra STM32WL3x mifototra amin'ny processeur Arm® Cortex®‑M0+.
• Ny microcontrollers STM32WL3x dia mampiditra ny periferika radio RF sub-GHz mifanaraka amin'ny STMicroelectronics, natao ho an'ny fanjifana herinaratra faran'izay ambany sy fampisehoana radio tena tsara, mandritra ny androm-piainan'ny bateria tsy manam-paharoa.

Fanamarihana: Arm dia marika voasoratra anarana ao amin'ny Arm Limited (na ny sampany) any Etazonia sy/na any an-kafa.

Ireo singa mifandraika amin'ny STM32CubeWL3

• Ny STM32CubeWL3 MCU Package dia mandeha amin'ny STM32 32-bit microcontrollers miorina amin'ny Arm® Cortex®‑M0+ processeur. Izy io dia manangona, ao anatin'ny fonosana tokana, ny singa rehetra amin'ny logiciel mipetaka rehetra ilaina amin'ny famolavolana fampiharana ho an'ny STM32WL3X Toetran'ny vokatra microcontrollers.
• Ny fonosana dia misy API ambany sosona (LL) sy hardware abstraction layer (HAL) izay mandrakotra ny fitaovana microcontroller, miaraka amin'ny andian-tsarimihetsika taloha.amples mandeha amin'ny STMicroelectronics boards. Ny API HAL sy LL dia azo alaina amin'ny lisansa BSD misokatra ho an'ny mpampiasa. Ao anatin'izany koa ny singa afovoany kernel Sigfox™, FatFS, ary FreeRTOS™.
• Ny STM32CubeWL3 MCU Package dia manome fampiharana sy fihetsiketsehana maromaro amin'ny fampiharana ireo singa afovoany rehetra.
• Ny firafitry ny singa STM32CubeWL3 MCU Package dia aseho amin'ny sary 1.

STM32CubeWL3 Architectureview

• Ny vahaolana STM32CubeWL3 MCU Package dia natsangana manodidina ny ambaratonga tsy miankina telo izay mifandray mora foana araka ny voalaza ao amin'ny sary 2.

Ambaratonga 0
Ity ambaratonga ity dia mizara ho sublayers telo:

• Fonosana fanohanana board (BSP).
• Layer abstraction (HAL):
  • HAL periferika mpamily
  • Mpamily ambany sosona
• Fampiasana periferika fototra examples.

Fonosana fanohanana birao (BSP)
Ity sosona ity dia manolotra andiana API mifandraika amin'ny singa fitaovana ao amin'ny takelaka hardware (toy ny LED, bokotra, ary mpamily COM). Izy io dia ahitana ampahany roa:

singa:

• Io no mpamily mifandraika amin'ny fitaovana ivelany eo amin'ny solaitrabe fa tsy amin'ny STM32. Ny mpamily singa dia manome API manokana ho an'ny singa ivelany mpamily BSP ary azo entina amin'ny takelaka hafa.
  • mpamily BSP:
• Izy io dia mamela ny fampifandraisana ireo mpamily singa amin'ny birao manokana ary manome andiana API mora ampiasaina. Ny fitsipika nomena anarana API dia BSP_FUNCT_Action().
• Example: BSP_LED_Init(), BSP_LED_On()

Ny BSP dia miorina amin'ny maritrano modular izay mamela ny fandefasana mora amin'ny fitaovana rehetra amin'ny alàlan'ny fampiharana fotsiny ny fomba fanao ambany.

Sosona abstraction hardware (HAL) sy sosona ambany (LL)

Ny STM32CubeWL3 HAL sy LL dia mifameno ary mandrakotra karazana fangatahana fangatahana:

• Ny mpamily HAL dia manolotra API azo entina tena azo entina. Afenin'izy ireo amin'ny mpampiasa farany ny MCU sy ny fahasarotana periferika.
  Ny mpamily HAL dia manome API miompana amin'ny endri-javatra maro samihafa, izay manamora ny fampiharana ny rindranasa mpampiasa amin'ny alàlan'ny fanomezana dingana efa vonona. Ho an'ny example, ho an'ny periferika fifandraisana (I2C, UART, sy ny hafa), dia manome APIs mamela ny fanombohana sy ny fanamboarana ny periferika, ny fitantanana ny famindrana angon-drakitra mifototra amin'ny fandatsaham-bato, fanelingelenana, na DMA, ary fitantanana ny fahadisoana amin'ny fifandraisana izay mety hitranga mandritra ny fifandraisana. Ny API mpamily HAL dia mizara ho sokajy roa:
  • Generic APIs, izay manome fiasa mahazatra sy ankapobeny ho an'ny microcontrollers andiany STM32 rehetra.
  • Extension APIs, izay manome fiasa manokana sy namboarina ho an'ny fianakaviana manokana na laharan'ny ampahany manokana.
• Ny API ambany sosona dia manome API ambany amin'ny ambaratonga rejisitra, miaraka amin'ny fanatsarana tsara kokoa fa tsy dia azo entina.
  Mitaky fahalalana lalina momba ny MCU sy ny famaritana periferika izy ireo.
  Ny mpamily LL dia natao hanolotra sosona maivana haingana, miompana amin'ny manam-pahaizana izay akaiky kokoa ny fitaovana noho ny HAL. Mifanohitra amin'ny HAL, ny LL API dia tsy omena ho an'ny periferika izay tsy singa manan-danja ny fidirana optimized, na ho an'ireo izay mila fanamboarana rindrambaiko mavesatra na antontam-bato avo lenta.
  Ny mpamily LL dia manana:
• Andian-tsarimihetsika hanombohana ny endri-javatra fototra periferika araka ny mari-pamantarana voafaritra ao amin'ny rafitra data.
• Andian-asa hamenoana ny rafitra angon-drakitra fanombohana miaraka amin'ny sanda reset mifanaraka amin'ny saha tsirairay.
• Fampiasa ho an'ny de-initialization periferika (ny rejistra periferika naverina tamin'ny sandany mahazatra).
• Fiaraha-miasa inline ho an'ny fidirana mivantana sy atomika.
• Fahaleovantena feno amin'ny HAL sy ny fahafahana ampiasaina amin'ny fomba tokana (tsy misy mpamily HAL).
• Fandrakofana feno ny endri-javatra periferika tohana.

Fampiasana periferika fototra exampl'
Ity sosona ity dia mandrakotra ny examples naorina teo ambonin'ny STM32 periferika amin'ny fampiasana ny loharanon-karena HAL sy BSP.
Fanamarihana: Demonstration exampmisy ihany koa ny les mba hampisehoana ex complexes kokoaample scenario misy periferika manokana, toy ny MRSUBG sy LPAWUR.

Ambaratonga 1
Ity ambaratonga ity dia mizara ho sublayers roa:

• Middleware singa
• Examples mifototra amin'ny singa middleware

Middleware singa
Ny middleware dia fitambarana tranomboky mandrakotra ny kernel FreeRTOS™, FatFS, ary Sigfox™ protocol library.
Ny fifandraisana marindrano eo amin'ireo singa amin'ity sosona ity dia atao amin'ny fiantsoana ireo API nasongadina.
Ny fifaneraserana mitsangana amin'ny mpamily ambany sosona dia atao amin'ny alàlan'ny antso an-tariby manokana sy ny macro static napetraka ao amin'ny interface interface an'ny rafitra famakiam-boky.
Ny singa fototra amin'ny singa middleware tsirairay dia toy izao manaraka izao:

• Kernel FreeRTOS™: mametraka rafitra miasa amin'ny fotoana tena izy (RTOS), natao ho an'ny rafitra tafiditra.
• Sigfox ™: mametraka ny tranomboky protocol Sigfox ™ mifanaraka amin'ny tambajotra protocol Sigfox ™ ary misy ny tranomboky protocol test RF mba hitsapana ny fitaovana RF Sigfox ™.
• FatFS: mampihatra ny FAT generic file rafitra module.

Examples mifototra amin'ny singa middleware

• Ny singa middleware tsirairay dia misy ex iray na maromaroamples, antsoina koa hoe applications, mampiseho ny fomba fampiasana azy.
• Integration exampIreo izay mampiasa singa middleware maromaro dia omena ihany koa.

Tapitra ny fonosana firmware STM32CubeWL3view

Fitaovana sy fitaovana STM32WL3x manohana

• STM32Cube dia manolotra sosona abstraction hardware (HAL) azo entina be dia be naorina manodidina ny maritrano mahazatra. Izy io dia mamela ny fitsipiky ny fananganana sosona, toy ny fampiasana ny sosona middleware hampihatra ny asany nefa tsy mahafantatra, amin'ny lalina, inona no MCU ampiasaina. Izany dia manatsara ny fampiasana indray ny kaody famakiam-boky ary miantoka ny fandefasana mora amin'ny fitaovana hafa.
• Ankoatra izany, miaraka amin'ny architecture layered, Sary STM32CubeWL3 Manolotra fanohanana feno ho an'ny tsipika vokatra STM32WL3x rehetra.
• Ny mpampiasa dia tsy maintsy mamaritra ny macro marina ao amin'ny stm32wl3x.h.
• Ny tabilao 1 dia mampiseho ny macro hamaritana miankina amin'ny fitaovana tsipika vokatra STM32WL3x ampiasaina. Ity macro ity dia tsy maintsy faritana ao amin'ny preprocessor compiler.

Tabilao 1. Macro ho an'ny tsipika vokatra STM32WL3x

Macro voafaritra ao amin'ny STM32WL3X.h	Ireo singa mifandraika amin'ny STM32WL3x
stm32wl3x	Ireo singa mifandraika amin'ny STM32WL30xx STM32WL31xx Microcontrollers

Tabilao 2. Boards ho an'ny tsipika vokatra STM32WL3x

BIRAO, BIRAO	Ireo singa mifandraika amin'ny STM32WL3x
Sary NUCLEO-WL33CC1	Sary STM32WL33CC
Sary NUCLEO-WL33CC2	Sary STM32WL33CC

Ny STM32CubeWL3 MCU Package dia afaka mandeha amin'ny fitaovana mifanentana rehetra. Ny mpampiasa dia manavao ny mpamily BSP mba handefasana ny ex nomenaamples eo amin'ny solaitrabe, raha toa ka mitovy ny endri-javatra fitaovana (toy ny LED na bokotra).

Tapitra ny fonosana firmwareview

• Ny vahaolana STM32CubeWL3 MCU Package dia omena ao anaty fonosana zip iray, miaraka amin'ny rafitra aseho amin'ny sary 3.

Tandremo: Ny mpampiasa dia tsy tokony hanova ny singa files. Ny loharanon'ny \Projects ihany no azon'ny mpampiasa atao. Ho an'ny birao tsirairay dia misy andiana exampNy les dia omena tetikasa efa nomanina ho an'ny rojo fitaovana EWARM, MDK-ARM, ary STM32CubeIDE.
Ny sary 4 dia mampiseho ny firafitry ny tetikasa ho an'ny boards NUCLEO-WL33CCx.

Ny exampNy vidiny sy ny fotoana nitarika ny STM32CubeWL3 arakaraka ny habetsahany takiana, ny fahazoana sy ny toerana fivarotana. Izy ireo dia nomena ireto manaraka ireto:

• Ambaratonga 0 examples atao hoe Eksamples, Eksamples_LL, ary Eksamples_MIX. Mampiasa mpamily HAL izy ireo, mpamily LL, ary fifangaroan'ny mpamily HAL sy LL tsy misy singa middleware. Demonstration exampmisy koa ny les.
• Ambaratonga 1 examples dia antsoina hoe Applications. Izy ireo dia manome tranga fampiasa mahazatra amin'ny singa middleware tsirairay.

Ny fampiharana firmware ho an'ny birao nomena dia azo amboarina haingana amin'ny alàlan'ny tetik'asa môdely misy ao amin'ny lahatahiry Templates sy Templates_LL.
Examples, Eksamples_LL, ary Eksamples_MIX dia manana rafitra mitovy:

• \Inc lahatahiry misy ny lohapejy rehetra files.
• \Src lahatahiry misy ny kaody loharano.
• \EWARM, \MDK-ARM, ary \STM32CubeIDE lahatahiry misy ny tetikasa efa voarindra ho an'ny rojom-pitaovana tsirairay.
• readme.md sy readme.html mamaritra ny example fitondran-tena sy ny tontolo ilaina mba hampahomby azy.

Manomboka amin'ny STM32CubeWL3

Mihazakazaka ex voalohanyample
Ity fizarana ity dia manazava ny fomba tsotra amin'ny fampandehanana ny ex voalohanyampSary STM32CubeWL3. Ampiasainy ho fanoharana ny famokarana jiro LED tsotra mandeha amin'ny solaitrabe NUCLEO-WL33CC1:

1. Ampidino ny fonosana STM32CubeWL3 MCU.
2. Sokafy izany, na mandehana ny installer raha omena, ao anaty lahatahiry tianao.
3. Ataovy azo antoka fa tsy hanova ny rafitra fonosana aseho amin'ny sary 3. STM32CubeWL3 firafitry ny fonosana firmware. Mariho fa ilaina ihany koa ny mandika ny fonosana amin'ny toerana akaikin'ny haben'ny faka (midika hoe C:\ST na G:\Tests), satria misy IDE miatrika olana rehefa lavitra loatra ny lalana.

Ahoana ny fomba fitantanana HAL example
Alohan'ny hampidirana sy hampandehanana ny example, tena asaina mamaky ny example readme file ho an'ny configuration manokana.

1. Jereo ny \Projects\NUCLEO-WL33CC\Examples.
2. Sokafy ny \GPIO, avy eo \GPIO_EXTI lahatahiry.
3. Sokafy ny tetikasa miaraka amin'ny rojo fitaovana tiana. Vita hainganaview momba ny fomba fanokafana, fananganana ary fitantanana ny example miaraka amin'ireo rojom-pitaovana tohanana omena etsy ambany.
4. Avereno daholo files ary ampidiro ao amin'ny fahatsiarovana kendrena ny sary.
5. Manaova ny example. Raha mila fanazavana fanampiny dia jereo ny example readme file.

Hanokatra, hanorina ary hampandeha ny exampmiaraka amin'ireo rojom-pitaovana tohanana tsirairay, araho ireto dingana manaraka ireto:

• EWARM:
  1. Eo ambanin'ny Examples folder, sokafy ny \EWARM subfolder.
  2. Alefaso ny toeram-piasana Project.eww (mety hiova avy amin'ny iray example amin'ny hafa).
  3. Avereno daholo files: [Tetikasa]>[Amboary daholo].
  4. Ampidiro ny sarin'ny tetikasa: [Project]>[Debug].
  5. Alefaso ny programa: [Debug]>[Go (F5)].
• MDK-ARM:
  1. Eo ambanin'ny Examples folder, sokafy ny subfolder \MDK-ARM.
  2. Sokafy ny toeram-piasana Project.uvproj (mety hiova avy amin'ny example amin'ny hafa).
  3. Avereno daholo files: [Tetikasa]>[Amboary ny tanjona rehetra files].
  4. Ampidiro ny sarin'ny tetikasa: [Debug]>[Start/Stop Debug Session].
  5. Alefaso ny programa: [Debug]>[Run (F5)].
• STM32CubeIDE:
  1. Sokafy ny rojom-pitaovana STM32CubeIDE.
  2. Tsindrio ny [File]>[Switch Workspace]>[Other] ary jereo ny lahatahiry STM32CubeIDE workspace.
  3. Tsindrio ny [File]>[Import], fidio [General]>[Tetikasa efa misy ao amin'ny Workspace], ary tsindrio avy eo [Next].
  4. Tsidiho ny lahatahiry STM32CubeIDE ary safidio ny tetikasa.
  5. Avereno indray ny tetikasa rehetra files: Fidio ny tetikasa ao amin'ny varavarankelin'ny Project Explorer ary tsindrio ny menu [Project]>[Build project].
  6. Alefaso ny programa: [Run]>[Debug (F11)].

Famolavolana fampiharana manokana

Mampiasa STM32CubeMX hamolavola na hanavao fampiharana

• Ao amin'ny STM32Cube MCU Package, saika ny tetikasa rehetra examples dia novokarina tamin'ny fitaovana STM32CubeMX mba hanombohana ny rafitra, ny periferika ary ny middleware.

Ny fampiasana mivantana ny tetikasa efa misy exampNy fitaovana STM32CubeMX dia mila STM32CubeMX 6.12.0 na ambony kokoa:

• Aorian'ny fametrahana ny STM32CubeMX, sokafy ary raha ilaina dia manavao ny tetikasa natolotra.
  Ny fomba tsotra indrindra hanokafana tetikasa efa misy dia ny manindry indroa ny *.ioc file ka STM32CubeMX dia manokatra ho azy ny tetikasa sy ny loharano files. STM32CubeMX dia mamorona ny kaody loharano fanombohana ny tetikasa toy izany.
• Ny kaody loharanon'ny fampiharana lehibe dia voarakitra amin'ny fanehoan-kevitra "USER CODE BEGIN" sy "USER CODE END". Raha ovaina ny fifantenana periferika sy ny fikandrana, STM32CubeMX dia manavao ny ampahany amin'ny fanombohana ny kaody sady mitahiry ny kaody loharanon'ny fampiharana.
• Raha hamolavola tetikasa manokana miaraka amin'ny STM32CubeMX, araho ny dingana manaraka:
  1. Ampifanaraho amin'ny alàlan'ny famahana olana amin'ny pinout, mpanampy amin'ny fametrahana hazo famantaranandro, kajy fanjifana herinaratra, ary ny fitaovana manatanteraka ny fandrindrana periferika MCU (toy ny GPIO na USART).
  2. Mamorona ny kaody C initialization mifototra amin'ny configuration voafantina. Ity kaody ity dia vonona hampiasaina ao anatin'ny tontolo fampandrosoana maro. Ny kaody mpampiasa dia tazonina amin'ny taranaka kaody manaraka.
     Raha mila fanazavana fanampiny momba ny STM32CubeMX dia jereo ny boky torolalana ho an'ny mpampiasa STM32CubeMX ho an'ny tefy STM32 sy ny fanombohana ny kaody C (UM1718).

Fampiharana mpamily
Fampiharana HAL
Ity fizarana ity dia mamaritra ny dingana ilaina amin'ny famoronana fampiharana HAL mahazatra mampiasa STM32CubeWL3

1. Mamorona tetikasa
   Mba hamoronana tetikasa vaovao dia manomboka amin'ny tetikasa Template omena isaky ny birao eo ambanin'ny \Projects\ \Templates na avy amin'ny tetikasa misy eo ambanin'ny \Projects\ \Examples na \Proj ects\ \Applications (aiza manondro ny anaran'ny birao).
   Ny tetikasa Template dia manome fiasa tsy misy dikany. Na izany aza, dia tsara fanombohana ny fahatakarana ny STM32CubeWL3 tetikasa toe-javatra. Ny môdely dia manana ireto toetra manaraka ireto:
   • Ahitana ny kaody loharano HAL, CMSIS, ary BSP mpamily, izay singa kely indrindra ilaina amin'ny famolavolana kaody eo amin'ny solaitrabe iray.
   • Izy io dia ahitana ny lalana tafiditra ho an'ny singa firmware rehetra.
   • Izy io dia mamaritra ny fitaovana tsipika vokatra STM32WL3x tohanana, mamela ny mpamily CMSIS sy HAL ho voarindra tsara.
   • Izy io dia manome mpampiasa vonona hampiasaina files preconfigured araka ny aseho eto ambany:
   • Ny HAL dia natomboka tamin'ny tobin'ny fotoana default miaraka amin'ny Arm® core SysTick.
   • SysTick ISR nampiharina ho an'ny tanjona HAL_Delay().
   • Fanamarihana: Rehefa mandika tetik'asa efa misy any amin'ny toerana hafa dia ataovy azo antoka fa havaozina daholo ny lalana tafiditra.
2. Ampifanaraho ny singa firmware
   Ny singa HAL sy middleware dia manolotra andian-tsafidy fanamboarana fotoana amin'ny fampiasana ny macro #define voalaza ao anaty lohapejy. file. Fanofanana môdely file dia omena ao anatin'ny singa tsirairay, izay tsy maintsy adika amin'ny lahatahiry tetikasa (matetika ny configuration file dia atao hoe xxx_conf_template.h, ilay sombiny
   • mila esorina ny môdely rehefa mandika azy ao amin'ny lahatahiry tetikasa). Ny configuration file manome fampahafantarana ampy hahatakarana ny fiantraikan'ny safidy fandrindrana tsirairay. Ny fampahalalana amin'ny antsipiriany bebe kokoa dia hita ao amin'ny antontan-taratasy omena ho an'ny singa tsirairay.
3. Atombohy ny tranomboky HAL
   Rehefa avy nitsambikina tany amin'ny programa lehibe, ny kaody fampiharana dia tsy maintsy miantso ny HAL_Init () API mba hanombohana ny tranomboky HAL, izay manatanteraka ireto asa manaraka ireto:
   • Fandrindrana ny prefetch fahatsiarovana tselatra sy ny laharam-pahamehan'ny SysTick interrupt (amin'ny macros voafaritra ao amin'ny stm32 wl3x_hal_conf.h).
   • Fanamboarana ny SysTick mba hamoronana fiatoana isaky ny milisegondra amin'ny laharam-pahamehana fanelanelanana SysTick TICK_INT_PRIO voafaritra ao amin'ny stm32wl3x_hal_conf.h.
   • Ny fametrahana ny laharam-pahamehan'ny vondrona NVIC ho 0.
   • Antso an'ny HAL_MspInit() fiantsoana miverina voafaritra ao amin'ny mpampiasa stm32wl3x_hal_msp.c file mba hanatanterahana ny fanombohana fitaovana eran-tany ambany.
4. Amboary ny famantaranandron'ny rafitra
   Ny fametrahana famantaranandron'ny rafitra dia atao amin'ny fiantsoana ireo API roa voalaza etsy ambany:
   • HAL_RCC_OscConfig (): ity API ity dia manamboatra ny oscillator anatiny sy ivelany. Ny mpampiasa dia misafidy
     amboary ny oscillator iray na rehetra.
   • HAL_RCC_ClockConfig (): ity API ity dia manitsy ny loharanon'ny famantaranandron'ny rafitra, ny fahatarana fahatsiarovana tselatra, ary ny prescalers AHB sy APB.
5. Manomboka ny periferika
   • Soraty aloha ny asa fanombohana periferika. Tohizo toy izao manaraka izao:
   • Alefaso ny famantaranandro periferika.
   • Ampifanaraho ny GPIO periferika.
   • Ampifanaraho ny fantsona DMA ary avelao ny fanelingelenana DMA (raha ilaina).
   • Alefaso ny fanelanelanana periferika (raha ilaina).
   • Amboary ny stm32xxx_it.c mba hiantsoana ireo mpikirakira interruption ilaina (periferika sy DMA), raha ilaina.
   • Soraty ny fampandehanana ny antso miverina feno raha toa ka misy fiatoana periferika na DMA natao hampiasaina.
   • Ao amin'ny mpampiasa main.c file, atombohy ny firafitry ny tantana periferika avy eo antsoy ny asa fanombohana periferika mba hanombohana ny periferika.
6. Mamorona fampiharana
   Amin'ity stage, vonona ny rafitra ary afaka manomboka ny fampandrosoana ny kaody fampiharana mpampiasa.
   Ny HAL dia manome API intuitive sy vonona hampiasaina hanamboarana ny periferika. Izy io dia manohana ny fandatsaham-bato, ny fanelanelanana ary ny maodely fandaharana DMA, mba handraisana izay fepetra takiana rehetra. Raha mila fanazavana fanampiny momba ny fampiasana ny periferika tsirairay dia jereo ny rich exampIreo singa mifandraika amin'ny STM32CubeWL3 MCU.

Tandremo: Amin'ny fampiharana HAL default, ny fameram-potoana SysTick dia ampiasaina ho toy ny foto-potoana: miteraka fahatapahana amin'ny fotoana tsy tapaka. Raha HAL_Delay() dia antsoina avy amin'ny fizotry ny ISR periferika, ataovy azo antoka fa manana laharam-pahamehana ambony kokoa (ambany isa) ny fanelingelenana SysTick noho ny fahatapahana periferika. Raha tsy izany dia voasakana ny dingana ISR mpiantso. Ambara ho __weak ny fiasa misy fiantraikany amin'ny fanefena timebase mba ahafahana manafoana raha misy fampiharana hafa ao amin'ny mpampiasa file (mampiasa famerana tanjona ankapobeny, ohatraample, na loharanom-potoana hafa). Raha mila fanazavana fanampiny dia jereo ny HAL_TimeBase example.

LL fampiharana
Ity fizarana ity dia mamaritra ny dingana ilaina amin'ny famoronana fampiharana LL mahazatra amin'ny fampiasana STM32CubeWL3.

1. Mamorona tetikasa
   Mba hamoronana tetikasa vaovao, na manomboka amin'ny tetikasa Templates_LL omena ho an'ny birao tsirairay eo ambanin'ny \Projects\ \Templates_LL na avy amin'ny tetikasa misy eo ambanin'ny \Projects\ \Examples_ LL ( dia manondro ny anaran'ny birao, toy ny NUCLEO-WL32CC33).
   Ny tetik'asa môdely dia manome asa famoriam-bola lehibe tsy misy na inona na inona, izay toerana fanombohana tsara hahafantarana ny firafitry ny tetikasa ho an'ny STM32CubeWL3. Ny toetra mampiavaka ny môdely dia ireto manaraka ireto:
   • Ahitana ny kaody loharanon'ny mpamily LL sy CMSIS, izay singa kely indrindra ilaina amin'ny famolavolana ny kaody eo amin'ny solaitrabe iray.
   • Izy io dia ahitana ny lalana tafiditra ho an'ny singa firmware ilaina rehetra.
   • Izy io dia misafidy ny fitaovana tsipika vokatra STM32WL3x tohanana ary mamela ny fanamafisana marina ny mpamily CMSIS sy LL.
   • Izy io dia manome mpampiasa vonona hampiasaina files izay preconfigured toy izao manaraka izao:
   • main.h: sosona abstraction famaritana LED sy USER_BUTTON.
   • main.c: Fametrahana famantaranandro rafitra ho an'ny matetika indrindra.
2. Port ny LL example:
   • Adikao/apetaho ny lahatahiry Templates_LL - mba hitazonana ny loharano voalohany - na hanavao mivantana ny tetikasa Template s_LL efa misy.
   • Avy eo, ny fanoloana ny Templates_LL dia ny fanoloana files ny Examptetikasa kendrena les_LL.
   • Tehirizo ny ampahany manokana amin'ny board rehetra. Ho an'ny antony mazava, ny ampahany manokana amin'ny board dia asiana marika manokana tags:
   • Noho izany, ny dingana lehibe amin'ny porting dia ireto manaraka ireto:
   • Soloy ny stm32wl3x_it.h file.
   • Soloy ny stm32wl3x_it.c file.
   • Soloy ny lehibe.h file ary havaozy izany: Tazony eo ambanin'ny BOARD SPECIFIC CONFIGURATION ny famaritana ny bokotra LED sy ny mpampiasa an'ny môdely LL. tags.
   • Soloy ny lehibe.c file ary manavao azy:
   • Tazony eo ambanin'ny BOARD SPECIFIC CONFIGURATION ny fandrindrana famantaranandro an'ny SystemClock_Config() LL tags.
   • Miankina amin'ny famaritana LED, soloy ny fisehoan-javatra LDx tsirairay amin'ny LDy hafa misy ao amin'ny file main.h.
   • Miaraka amin'ireo fanovana ireo, ny example mihazakazaka eo amin'ny solaitrabe kendrena.

Fampiharana RF, fihetsiketsehana ary exampl'
Karazana fampiharana RF samihafa, fihetsiketsehana ary exampIreo singa mifandraika amin'ny STM32CubeWL3.
Izy ireo dia voatanisa ao amin'ny fizarana roa etsy ambany.

Sub-GHz examples sy fihetsiketsehana
Ireo examples dia mampiseho ny endri-javatra fototra amin'ny periferika radio MRSUBG sy LPAWUR. Ireo examples dia misy amin'ny:

• Projects\NUCLEO-WL33CC\Examples\MRSUBG
• Projects\NUCLEO-WL33CC\Examples\LPAWUR
• Projects\NUCLEO-WL33CC\Demonstrations\MRSUBG
• Projects\NUCLEO-WL33CC\Demonstrations\LPAWUR

Ny example na demonstration amin'ny ankapobeny dia misy programa roa antsoina hoe Tx sy Rx miasa ho mpandefa sy mpandray:

Examples/MRSUBG

• MRSUBG_802_15_4: fampiharana ny sosona ara-batana voafaritry ny fenitra 802.15.4. Mampiseho ny fomba fanamboarana ny onjam-peo mba handefasana na handray fonosana 802.15.4.
• MRSUBG_BasicGeneric: Fifanakalozana fonosana fototra STM32WL3x MR_SUBG.
• MRSUBG_Chat: Fampiharana tsotra mampiseho ny fampiasana Tx sy Rx amin'ny fitaovana iray ihany.
• MRSUBG_DatabufferHandler: Example izay mampiseho ny fomba swap avy amin'ny Databuffer 0 sy 1.
• MRSUBG_Sequencer AutoAck: Example izay mandefa sy mandray ny packet acknowledgements (ACKs) ho azy.
• MRSUBG_WMBusSTD: Fifanakalozana hafatra WM-Bus.
• WakeupRadio: Example mba hitsapana ny LPAWUR radio periferika.

Fampisehoana/MRSUBG

• MRSUBG_RTC_Button_TX: Ity exampAsehoy ny fomba fametrahana ny SoC amin'ny fomba fijanonana lalina ary ny MRSUBG hamoha ny SoC amin'ny fanindriana ny PB2 handefasana frame na aorian'ny fahataperan'ny famerana RTC.
• MRSUBG_Sequencer_Sniff: Ity example mampiseho ny fomba fametrahana ny MRSUBG sequencer mba hiasa amin'ny fomba sniff. Ity example mampiseho ny lafiny mpandray ary mitaky fitaovana hafa ho mpanentana.
• MRSUBG_Timer: Ny fampiharana dia mandamina fotoana maromaro amin'ny fameram-potoana MRSUBG (miaraka amin'ny autoreload) miaraka amin'ny elanelan'ny fotoana samihafa.
• MRSUBG_WakeupRadio_Tx: Ity example dia manazava ny fomba fametrahana ny SoC amin'ny fomba fiatoana lalina ary amboary ny MRSUBG hamoha ny SoC amin'ny fanindriana ny PB2 handefa frame. Ity example mampiseho ny lafiny mpanentana ary mitaky fitaovana hafa ho mpandray LPAWUR. Ny mpandray example dia hita eo ambanin'ny lahatahiry NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx.

Fampisehoana/LPAWUR

• LPAWUR_WakeupRadio_Rx: Ity example dia manazava ny fomba fametrahana ny SoC amin'ny fomba fijanonana lalina ary manamboatra ny LPAWUR hamoha ny SoC rehefa tonga ny frame ary voaray tsara. Ity example mampiseho ny lafiny mpandray ary mitaky fitaovana hafa ho mpanentana. Ny transmitter example dia hita eo ambanin'ny lahatahiry NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx.

Fampiharana Sigfox™
Ireo fampiharana ireo dia mampiseho ny fomba fampiharana ny scenario Sigfox™ sy ny fampiasana ireo API Sigfox™ misy. Izy ireo dia hita ao amin'ny lalan'ny tetikasa Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: Ity fampiharana ity dia mampiseho ny fomba fampiasana interface-line (CLI) handefasana baiko mampiasa ny protocol Sigfox™ handefasana hafatra sy hanaovana andrana fanamarinana mialoha.
• Sigfox_PushButton: Ity fampiharana ity dia mamela ny fanombanana ny fahaizan'ny radio fitaovana STM32WL33xx Sigfox ™. Ny fanindriana ny PB1 dia mamindra firafitra Sigfox™ fitsapana.

Tantara fanavaozana

Tabilao 3. Tantaran'ny fanavaozana ny antontan-taratasy

Daty	fanitsiana	FIOVANA
29-Mar-2024	1	Famoahana voalohany.
30-Oct-2024	2	Fampidirana feno ny STM32CubeWL3 amin'ny STM32Cube. Nohavaozina: •         Sava lalana •         Fizarana 2: STM32CubeWL3 endri-javatra lehibe •         Fizarana 3.2.1: singa afovoany •         Fizarana 4: tapitra ny fonosana firmware STM32CubeWL3view •         Fizarana 5.1: Fampandehanana ny ex voalohanyample •         Fizarana 5.3: Fampiharana RF, fihetsiketsehana ary exampl' Nampiana: •         Fizarana 5.1.1: Ahoana ny fametrahana HAL example •         Fizarana 5.2.1: Mampiasa STM32CubeMX hamolavola na hanavao fampiharana • Sfizarana 6.4: Misy tetikasa môdely ho an'ny periferika MRSUBG/LPAWUR examples? •         Fizarana 6.5: Ahoana no ahafahan'ny STM32CubeMX mamorona kaody mifototra amin'ny rindrambaiko napetraka? nesorina: •         Fitaovana PC, anisan'izany tantsambo, Sary STM32WL3 GUI, ary MR-SUBG Sequencer GUI •         Ahoana no ahafahan'ny WiSE-Studio IOMapper mamorona kaody mifototra amin'ny rindrambaiko napetraka? •         Moa ve ny Navigator dia mamela ny fidirana amin'ny loharanon'ny fonosana rindrambaiko?
22-Jano-2025	3	Nanitatra ny fitaovana azo ampiharina amin'ny microcontrollers STM32WL30xx sy STM32WL31xx ao amin'ny tabilao 1. Macros ho an'ny tsipika vokatra STM32WL3x.

FANAMARIHANA MANDRAKIZAY – vakio tsara

• Ny STMicroelectronics NV sy ny sampany (“ST”) dia manana zo hanao fanovana, fanitsiana, fanatsarana, fanovana ary fanatsarana ny vokatra ST sy/na ity antontan-taratasy ity amin'ny fotoana rehetra tsy misy filazana. Ny mpividy dia tokony hahazo ny vaovao farany mifandraika amin'ny vokatra ST alohan'ny hametrahana baiko. Ny vokatra ST dia amidy araka ny fepetra sy fepetra momba ny fivarotana ST amin'ny fotoana fanekena ny kaomandy.
• Ny mpividy dia tompon'andraikitra amin'ny safidy, ny fisafidianana ary ny fampiasana ny vokatra ST ary ny ST dia tsy mandray andraikitra amin'ny fanampiana amin'ny fampiharana na ny famolavolana ny vokatra avy amin'ny mpividy.
• Tsy misy fahazoan-dàlana, na mazava na an-kolaka, amin'ny zon'ny fananana ara-tsaina omen'ny ST eto.
• Ny fivarotana indray ny vokatra ST miaraka amin'ny fepetra hafa amin'ny fampahalalana voalaza eto dia hanafoana ny fiantohana omen'ny ST ho an'ny vokatra toy izany.
• ST sy ny logo ST dia marika famantarana ny ST. Raha mila fanazavana fanampiny momba ny marika ST, jereo ny www.st.com/trademarks. Ny anaran'ny vokatra na serivisy hafa rehetra dia fananan'ny tompony tsirairay avy.
• Ny fampahalalana ato amin'ity antontan-taratasy ity dia manolo sy manolo ny fampahalalana efa nomena tamin'ny dikan-teny teo aloha amin'ity antontan-taratasy ity.
• © 2025 STMicroelectronics – Zo rehetra voatokana

FAQ

Rahoviana aho no tokony hampiasa HAL fa tsy mpamily LL?

Ny mpamily HAL dia manolotra API avo lenta sy miompana amin'ny asa, miaraka amin'ny fahaiza-mitondra avo lenta. Nafenina ho an'ny mpampiasa farany ny fahasarotan'ny vokatra na periferika. Ny mpamily LL dia manolotra API amin'ny ambaratonga ambany kokoa miaraka amin'ny fanatsarana tsara kokoa fa tsy dia azo entina. Mitaky fahalalana lalina momba ny vokatra na ny famaritana IP izy ireo.

Ahoana no ahafahan'ny LL initialization APIs?

Ny famaritana ny API fanombohana LL sy ny rafitry ny loharanon-karena mifandraika amin'ny litera sy ny prototype dia voafehin'ny USE_FULL_LL_DRIVER switch compilation. Mba hahafahana mampiasa API fanombohana LL, ampio ity switch ity ao amin'ny preprocessor compiler toolchain.

Misy tetikasa môdely ho an'ny periferika MRSUBG/LPAWUR examples?

Mba hamoronana MRSUBG na LPAWUR ex vaovaoampny tetikasa, na manomboka amin'ny tetikasa skeleton nomena eo ambanin'ny Pr ojectsNUCLEO- 33CC Examples MRSUBG na ProjectsNUCLEO-WL33CC Examples LPAWUR na avy amin'ny tetikasa misy eo ambanin'ireo lahatahiry ireo.

Ahoana no ahafahan'ny STM32CubeMX mamorona kaody mifototra amin'ny rindrambaiko napetraka?

STM32CubeMX dia manana fahalalana naorina ao amin'ny STM32 microcontrollers, ao anatin'izany ny periferika sy ny lozisialy, izay ahafahany manome fanehoana an-tsary ho an'ny mpampiasa sy mamorona .h na .c files mifototra amin'ny firafitry ny mpampiasa.

Documents / Loharano

Vidio ny ST STM32WL3x Microcontrollers [pdf] Boky Torolàlana STM32WL3x Microcontrollers, STM32WL3x, Microcontrollers

References

• User Manual