STM32WL3x Software Package

Fa'amatalaga

• Igoa Oloa: STM32CubeWL3 pusa polokalama
• Fegalegaleai: STM32WL3x microcontrollers
• Vaega Autu:
  • La'ei maualalo (LL) ma mea fa'apipi'i vaega (HAL) APIs
  • SigfoxTM, FatFS, ma FreeRTOSTM kernel middleware vaega
  • Talosaga ma faʻataʻitaʻiga

Fa'atonuga o le Fa'aaogaina o Mea

Amataina
Ina ia amata faʻaaoga le STM32CubeWL3 software package, mulimuli i laasaga nei:

1. La'u mai le pusa polokalame mai le ofisa aloaia webnofoaga.
2. Fa'apipi'i le si'osi'omaga o le atina'e talafeagai (fa'ata'ita'iga, STM32CubeIDE, EWARM, MDK-ARM).
3. Fa'asino i le examptusi ma talosaga ua saunia mo ta'iala.

STM32CubeWL3 Fa'ata'ita'iga Ua Umaview
O le STM32CubeWL3 software package o lo'o fausia ile tolu vaega autu

• Laasaga 0: Mea fa'apipi'i fa'apipi'i (HAL) ma aveta'avale BSP.
• Laasaga 1: Talosaga, faletusi, ma vaega fa'avae fa'avae.

Fesili e Fai soo (FAQ)

Q: O a uiga autu o le STM32CubeWL3 pusa polokalama?
A: O mea autu e aofia ai le maualalo-layer ma HAL APIs, vaega middleware e pei o SigfoxTM, FatFS, FreeRTOSTM kernel, talosaga, ma faʻataʻitaʻiga.

Folasaga

STM32Cube ose STMicroelectronics uluai fuafuaga e faʻaleleia atili ai le gaosiga o le mamanu e ala i le faʻaitiitia o taumafaiga atinaʻe, taimi, ma le tau. STM32Cube e aofia uma ai le STM32 portfolio.

STM32Cube e aofia ai:

• O se seti o mea faigaluega faʻaoga faʻaoga faʻaoga e faʻaogaina ai le atinaʻeina o poloketi mai le faʻavaeina i le faʻataunuʻuina, faatasi ai ma] ia:
  • STM32CubeMX, o se meafaigaluega faʻapipiʻi faʻakomepiuta kalafi e faʻatagaina ai le faʻatupuina otometi o le C initialization code e faʻaaoga ai togafiti faʻataʻitaʻi.
  • STM32CubeIDE, o se meafaigaluega atinaʻe uma i totonu o le tasi ma le faʻaogaina o le pito i luga, faʻasologa o tulafono, faʻasologa o tulafono, ma foliga faʻapipiʻi.
  • STM32CubeCLT, o se mea faigaluega faʻatulagaina uma-i-le-tasi faʻatonuga faʻatasi ma le tuʻufaʻatasia o tulafono, polokalame faʻapipiʻi, ma mea faʻapipiʻi
  • STM32CubeProgrammer (STM32CubeProg), o se meafaigaluega polokalame o loʻo maua i faʻasologa o ata ma laina laina.
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), meafaigaluega mataʻituina malosi e faʻafetaui ai le amio ma le faʻatinoga o talosaga STM32 i le taimi moni.
• STM32Cube MCU ma MPU Packages, faʻapipiʻi faʻapipiʻiina-polokalame faʻapipiʻi faʻapitoa mo microcontroller taʻitasi ma microprocessor faasologa (e pei o STM32CubeWL3 mo le STM32WL3x laina oloa), lea e aofia ai:
  • STM32Cube hardware abstraction layer (HAL), faʻamautinoa le faʻateleina o le feaveaʻi i luga o le STM32 portfolio
  • STM32Cube low-layer APIs, faʻamautinoa le sili ona lelei le faʻatinoga ma tulagavae faʻatasi ai ma le maualuga o le faʻaogaina o le faʻaogaina o meafaigaluega
  • Se seti faifaipea o vaega middleware e pei ole FreeRTOS ™ kernel, FatFS, ma Sigfox ™
  • O mea faigaluega uma fa'apipi'i fa'akomepiuta fa'atasi ma seti atoa o peripheral ma applicative examples
• STM32Cube Expansion Packages, o loʻo i ai vaega faʻapipiʻi faʻapipiʻi e faʻapipiʻiina galuega a le STM32Cube MCU ma MPU Packages ma:

• • Fa'aopoopoga Middleware ma fa'aoga fa'aoga
  • Exampo lo'o fa'agasolo i luga o nisi laupapa fa'apitoa STMicroelectronics atina'e

O loʻo faʻamatalaina e lenei tusi faʻaoga le auala e amata ai le STM32CubeWL3 MCU Package.
Vaega 2 o loʻo faʻamatalaina uiga autu o le STM32CubeWL3 ma le Vaega 3 o loʻo tuʻuina atu ai le sili atuview o lona fausaga ma le fausaga o le MCU Package.

Fa'amatalaga lautele

STM32CubeWL3 o lo'o fa'atautaia talosaga fa'ata'ita'iga i lalo-GHz, e aofia ai le Sigfox™ binaries, i luga ole STM32WL3x laina oloa microcontrollers fa'avae ile Arm® Cortex®‑M0+ processor.
O le STM32WL3x microcontrollers ua fa'apipi'i le STMicroelectronics's state-of-the-art sub-GHz compliant RF radio peripheral, fa'amanino mo le fa'aaogaina tele-maualalo-maualuga ma le fa'atinoga lelei o le leitio, mo le le mafaatusalia le ola o le maa.
Manatua: Arm ose fa'ailoga fa'amaufa'ailoga a Arm Limited (po'o ona lala) i le US ma/po'o se isi nofoaga.

STM32CubeWL3 uiga autu

• Ole STM32CubeWL3 MCU Package o lo'o fa'agaoioi ile STM32 32-bit microcontrollers fa'avae ile Arm® Cortex®‑M0+ processor. E fa'aputuina, i totonu o se afifi e tasi, uma vaega fa'apipi'i fa'akomepiuta e mana'omia e atia'e ai se talosaga mo le STM32WL3x product line microcontrollers.
• O le afifi e aofia ai le maualalo-layer (LL) ma le hardware abstraction layer (HAL) APIs e aofia ai masini microcontroller, faʻatasi ai ma se seti tele o ex.ampo lo'o ta'avale i luga o laupapa STMicroelectronics. O lo'o avanoa le HAL ma le LL API i se laisene BSD fa'amamafa mo le fa'aogagofie. E aofia ai foi le Sigfox™, FatFS, ma le FreeRTOS ™ kernel middleware vaega.
• Ole STM32CubeWL3 MCU Package o lo'o tu'uina atu ai fo'i le tele o talosaga ma fa'ata'ita'iga o lo'o fa'atinoina uma ona vaega middleware.
• O le STM32CubeWL3 MCU Package vaega faʻatulagaina o loʻo faʻaalia i le Ata 1.

Ata 1. STM32CubeWL3 MCU Vaega o afifi 

STM32CubeWL3 fausaga ua umaview

Ole STM32CubeWL3 MCU Package solution e fausia ile tolu tulaga tutoatasi e faigofie ona fegalegaleai e pei ona faamatalaina ile Ata 2. Laasaga 0
O lenei tulaga ua vaevaeina i ni sublayers se tolu:

• Fonotaga lagolago a le Komiti Fa'atonu (BSP).
• Mea fa'apipi'i vaega (HAL):
  • avetaavale peripheral HAL
  • Avetaavale maualalo
• Fa'aoga fa'aoga pito i luga e pei oamples.

Paket lagolago a le Komiti Fa'atonu (BSP)
O lenei laulau e ofoina atu se seti o API e fesoʻotaʻi ma mea faʻapipiʻi i totonu o laupapa masini (e pei o LED, faʻamau, ma taʻavale COM). E aofia ai vaega e lua:

• Vaega:
  Ole avetaavale lea e fa'atatau ile masini fafo ile laupapa ae le o le STM32. O le aveta'avale vaega e tu'uina atu API fa'apitoa i le aveta'avale BSP vaega i fafo ma e mafai ona feavea'i i so'o se isi laupapa.
• aveta'avale BSP:

E mafai ai ona fa'afeso'ota'i vaega ta'avale i se laupapa fa'apitoa ma tu'uina atu se seti o API fa'aoga-tagata. Ole tulafono ole igoa ole API ole BSP_FUNCT_Action().
Example: BSP_LED_Init(), BSP_LED_On()
O le BSP e fa'avae i luga o se fausaga fa'apitoa e mafai ai ona faigofie ona fa'apipi'i i so'o se meafaigaluega e ala i le fa'atinoina o faiga masani.

Fa'apipi'i fa'apalapala (HAL) ma le fa'apalapala maualalo (LL)
O le STM32CubeWL3 HAL ma le LL e faʻapipiʻi ma e aofia ai le tele o manaʻoga faʻaoga:

• O aveta'avale HAL latou te ofoina atu API e sili ona feavea'i e fa'atatau i galuega. Latou te natia le MCU ma le faʻalavelave faʻapitoa i le tagata faʻaaogaina.
  O aveta'avale a le HAL latou te tu'uina atu API e fa'atatau i le tele o fa'ata'ita'iga, lea e fa'afaigofie ai le fa'atinoina o le fa'atinoga o le fa'aogaina o le fa'aogaina e ala i le saunia o faiga fa'aoga. Mo example, mo fesoʻotaʻiga fesoʻotaʻiga (I2C, UART, ma isi), e tuʻuina atu ai API e faʻatagaina ai le amataina ma le faʻatulagaina o le peripheral, faʻatautaia le faʻaliliuina o faʻamatalaga e faʻavae i luga o faiga palota, faʻalavelave, poʻo le DMA, ma le faʻaogaina o fesoʻotaʻiga sese e ono tulaʻi mai i le taimi o fesoʻotaʻiga. O API aveta'avale HAL ua vaevaeina i ni vaega se lua:

1. Generic APIs, lea e maua ai galuega masani ma lautele i le STM32 faasologa microcontrollers.
2. Extension APIs, e maua ai galuega faʻapitoa ma faʻapitoa mo se aiga faʻapitoa poʻo se numera vaega faʻapitoa.

• O API la'ititi la'ititi e maua ai API la'ititi i le tulaga resitala, fa'atasi ai ma le fa'aleleia atili ae fa'aitiitia le fa'aogaina. Latou te manaʻomia se malamalama loloto i le MCU ma faʻamatalaga lautele.
  O aveta'avale LL ua mamanuina e ofoina atu se faʻataʻitaʻiga faʻapitoa faʻapitoa faʻapitoa e sili atu ona latalata i meafaigaluega nai lo le HAL. E ese mai i le HAL, LL API e leʻo tuʻuina atu mo peripherals lea e le o se mea taua le avanoa sili ona lelei, poʻo mo i latou e manaʻomia le faʻatulagaina o masini komepiuta poʻo le faʻapipiʻi lavelave pito i luga.

O taʻavale LL faʻaalia:

• Se seti o galuega tauave e amata ai vaega autu peripheral e tusa ai ma tapulaʻa faʻamaoti i fausaga faʻamaumauga.
• Se seti o galuega tauave e faʻatumu ai faʻasologa faʻamaumauga faʻamaumauga ma le toe setiina o tau e fetaui ma fanua taʻitasi.
• Galuega mo le fa'amama fa'aulufale (fa'afo'i tusi resitala fa'apitonu'u i o latou tau fa'aletonu).
• O se seti o galuega fa'akomepiuta mo le avanoa tu'usa'o ma le resitara atomika.
• Tuto'atasi atoatoa mai le HAL ma le agava'a e fa'aoga i le tulaga tuto'atasi (e aunoa ma ta'avale HAL).
• Fa'ato'a fa'asalalauina o fa'ailoga pito i tua o lo'o lagolagoina.

Fa'aoga fa'aoga pito i luga e pei oamples
O lenei laulau e fa'apipi'i ai le example fausia i luga ole STM32 peripherals fa'aaoga na'o le HAL ma le BSP punaoa.
Fa'aaliga exampo lo'o avanoa fo'i e fa'aali atu fa'alavelave lavelaveampo fa'aaliga fa'atasi ma fa'apitoa fa'apitoa, e pei o le MRSUBG ma le LPAWUR.

Laasaga 1
O lenei tulaga ua vaevaeina i ni sublayers se lua:

• Vaega Middleware
• Example fa'avae i luga ole vaega ole middleware

Vaega Middleware
O le middleware o se seti o faletusi e ufiufi ai le FreeRTOS ™ kernel, FatFS, ma le Sigfox ™ protocol library. Feso'ota'iga fa'asaga i le va o vaega o lenei laulau e faia i le vala'au o API fa'aalia.
Feso'ota'iga tu'usa'o ma aveta'avale la'asaga maualalo e faia e ala i toe fa'afo'i fa'apitoa ma macros fa'ata'ita'i fa'atino i totonu o le fa'aoga telefoni fa'aoga.
O uiga autu o vaega ta'itasi middleware e fa'apea:

• FreeRTOS ™ kernel: faʻaaogaina se faiga faʻaogaina taimi moni (RTOS), faʻatulagaina mo faiga faʻapipiʻi.
• Sigfox™: fa'atino le faletusi o le Sigfox™ e fa'atatau i le Sigfox™ protocol network ma e aofia ai le RF test protocol library e fa'ata'ita'i ai RF Sigfox™ meafaigaluega.
• FatFS: faʻaaogaina le FAT lautele file faiga module.

Example fa'avae i luga ole vaega ole middleware
O vaega middleware ta'itasi e sau ma se tasi pe sili atu fo'iamples, e taʻua foi o talosaga, faʻaalia le faʻaogaina. Tu'ufa'atasi exampo lo'o tu'uina atu fo'i mea e fa'aogaina ai le tele o vaega middleware.

STM32CubeWL3 pusa firmware ua umaview

Lagolago STM32WL3x masini ma meafaigaluega
STM32Cube ofo atu se mea e sili ona feavea'i masini abstraction layer (HAL) fausia faataamilo i se fausaga lautele. E faʻatagaina ai le faʻavaeina o faʻavae faʻavae, e pei o le faʻaogaina o le middleware layer e faʻatino ai a latou galuega e aunoa ma le iloa, loloto, le mea o loʻo faʻaogaina ai le MCU. E fa'aleleia atili ai le fa'aogaina o le code code ma fa'amautinoa le faigofie ona feavea'i i isi masini.

• E le gata i lea, faʻatasi ai ma lona fausaga faʻapipiʻi, STM32CubeWL3 e ofoina atu le lagolago atoatoa mo laina uma o oloa STM32WL3x.
• E tatau i le tagata fa'aoga ona fa'amalamalamaina le macro sa'o ile stm32wl3x.h.

O le laulau 1 o lo'o fa'aalia ai le macro e fa'amatala e fa'atatau i le STM32WL3x masini laina oloa fa'aaogaina. O lenei macro e tatau foi ona faʻamalamalamaina i le compiler preprocessor.
Laulau 1. Macros mo STM32WL3x laina oloa

Macro faauigaina i stm32wl3x.h	STM32WL3x oloa laina masini
stm32wl33	STM32WL33xx microcontrollers

STM32CubeWL3 o loʻo faʻaalia se seti mauoa o examptusi ma fa'aoga i la'asaga uma, e fa'afaigofie ai ona malamalama ma fa'aoga so'o se ta'avale HAL po'o vaega middleware. O nei exampo lo'o ta'avale i luga o laupapa STMicroelectronics o lo'o lisiina i le Laulau 2.

Komiti Fa'atonu	STM32WL3x laupapa lagolago masini
NUCLEO-WL33CC1	STM32WL33CC
NUCLEO-WL33CC2	STM32WL33CC

O le STM32CubeWL3 MCU Package e mafai ona ta'avale i luga o so'o se mea faigaluega fetaui. O tagata fa'aoga na'o le fa'afouina o aveta'avale BSP e fa'aulu ai le fa'auluampi luga o latou laupapa, pe afai o nei mea e tutusa mea faʻapitoa (e pei o LED poʻo faʻamau).

Ua uma le pusa firmwareview
O le STM32CubeWL3 MCU Package solution o loʻo tuʻuina atu i le tasi pusa zip e iai le fausaga o loʻo faʻaalia i le Ata 3.
Ata 3. STM32CubeWL3 faʻapipiʻi faʻapipiʻi faʻapipiʻi

Lapata'iga:

E le tatau i le tagata fa'aoga ona suia vaega files. E mafai e le tagata fa'aoga ona fa'asa'o na'o le \Projects sources.
Mo laupapa taitasi, se seti o exampo lo'o tu'uina atu i ai galuega fa'atulagaina muamua mo le EWARM, MDK-ARM, ma STM32CubeIDE mea faigaluega.
Ata 4 o lo'o fa'aalia ai le fausaga o le poloketi mo laupapa NUCLEO-WL33CCx.

O le exampo lo'o fa'avasegaina e fa'atatau i le STM32CubeWL3 tulaga e fa'atatau i ai. Ua faaigoaina i latou e faapea:

• Laasaga 0 exampua ta'ua les Esoamples, Esoamples_LL, ma Esoamples_MIX. Latou te faʻaaogaina taʻavale HAL, avetaʻavale LL, ma faʻafefiloi o avetaʻavale HAL ma LL e aunoa ma se vaega middleware. Fa'aaliga exampo lo'o avanoa fo'i.
• Laasaga 1 exampe ta'ua o Talosaga. Latou te tuʻuina atu faʻaoga masani o vaega taʻitasi middleware.

So'o se talosaga fa'amautu mo se laupapa tu'uina atu e mafai ona vave fausia e fa'aaoga ai fa'ata'ita'iga poloketi o lo'o maua i totonu o le Templ ates ma Templates_LL directories.

Examples, Esoamples_LL, ma Esoamples_MIX e tutusa le fausaga:

• \Inc faila o lo'o iai uma ulutala files.
• \Src faila o lo'o iai le fa'ailoga puna.
• \EWARM, \MDK-ARM, ma \STM32CubeIDE faila o lo'o i ai le poloketi na muai faatulagaina mo filifili meafaigaluega taitasi.
• readme.md ma readme.html faʻamatalaina le example amio ma si'osi'omaga mana'omia e fa'atino ai.

Amata ile STM32CubeWL3

Tamomoe se muamua muamuaample
O lenei vaega o loʻo faʻamatalaina ai le faigofie o le faʻatinoina o se muamua muamuaample totonu STM32CubeWL3. E fa'aaogaina e fai ma fa'ata'ita'iga le fa'atupuina o se ta'avale fa'alelei faigofie o lo'o tamo'e ile laupapa NUCLEO-WL33CC1:

1. Sii mai le STM32CubeWL3 MCU Package.
2. Tatala, pe ta'e le installer pe a maua, i totonu o se lisi o lau filifiliga.
3. Ia mautinoa e aua le suia le fausaga o pusa o loʻo faʻaalia i le Ata 3. STM32CubeWL3 firmware faʻapipiʻi fausaga. Manatua e fautuaina foi e kopi le afifi i se nofoaga e latalata i le aʻa voluma (o lona uiga C: \ ST poʻo G: \ Tests), ona o nisi IDE e feagai ma faʻafitauli pe a umi tele le auala.

E faʻafefea ona faʻatautaia se HAL example
A'o le'i utaina ma fa'agasolo se example, e matua fautuaina e faitau le example faitau file mo so'o se fa'atulagaga fa'apitoa.

1. Su'e ile \Projects\NUCLEO-WL33CC\Examples.
2. Tatala le \GPIO, ona \GPIO_EXTI faila.
3. Tatala le poloketi i le filifili meafaigaluega sili. Ose vaveview i le auala e tatala ai, fausia, ma faʻatautaia se example faʻatasi ai ma filifili meafaigaluega lagolago o loʻo tuʻuina atu i lalo.
4. Toe fausia uma files ma uta le ata i totonu o le mea e manatua ai.
5. Tamomoe le example. Mo nisi fa'amatalaga, va'ai ile example faitau file.

E tatala, fau, ma fa'atautaia se exampfa'atasi ai ma filifili meafaigaluega lagolago ta'itasi, mulimuli i laasaga o lo'o i lalo:

• EWARM:

1. I lalo o le Examples folder, tatala le \EWARM subfolder.
2. Tatala le Project.eww workspace (e ono suia le igoa o galuega mai le tasi example i le isi).
3. Toe fausia uma files: [Poloketi]>[Toe fau uma].
4. Uta le ata o le galuega faatino: [Project]>[Debug].
5. Fa'agasolo le polokalame: [Debug]>[Alu (F5)].

• MDK-ARM:

1. I lalo o le Examples folder, tatala le \MDK-ARM subfolder.
2. Tatala le Project.uvproj workspace (e ono suia le igoa o galuega mai le tasi example i le isi).
3. Toe fausia uma files: [Project]>[Toe fau uma sini files].
4. U'u le ata o le poloketi: [Debug]>[Amata/Taofi le Debug Sauniga].
5. Fa'agasolo le polokalame: [Debug]>[Run (F5)].

• STM32CubeIDE:

1. Tatala le filifili meafaigaluega STM32CubeIDE.
2. Kiliki i luga [File]>[Sui Avanoa o Galuega]>[Isi] ma su'e ile STM32CubeIDE workspace directory.
3. Kiliki i luga [File]>[Auina mai], filifili [General]>[O Poloketi o iai i totonu o Galuega], ona kiliki lea [Next].
4. Su'e ile STM32CubeIDE workspace directory ma filifili le poloketi.
5. Toe fausia uma galuega files: Filifili le poloketi i le Project Explorer faamalama ona kiliki lea i le
   [Project]> [Fausia galuega] lisi.
6.  Fa'agasolo le polokalame: [Run]>[Debug (F11)].

Atina'e se fa'aoga masani

Fa'aaogā le STM32CubeMX e atia'e pe fa'afou se talosaga
I totonu ole STM32Cube MCU Package, toetoe lava o galuega uma fa'atasiampo lo'o fa'atupuina i le meafaigaluega STM32CubeMX e amata ai le faiga, peripheral, ma middleware.

Le fa'aogaina sa'o o se poloketi o lo'o iaiampLe mai le meafaigaluega STM32CubeMX mana'omia STM32CubeMX 6.12.0 po'o le maualuga:

• A maeʻa le faʻapipiʻiina o le STM32CubeMX, tatala ma pe a manaʻomia faʻafouina se poloketi fuafuaina.
  O le auala pito sili ona faigofie e tatala ai se poloketi o loʻo i ai nei o le kiliki-lua i luga o le *.ioc file ina ia otometi lava ona tatalaina e le STM32CubeMX le poloketi ma lona puna files. STM32CubeMX fa'atupuina le fa'ailoga fa'apogai o ia galuega.
• O le faʻailoga autu autu o loʻo i ai i faʻamatalaga "USER CODE BEGIN" ma le "USER CODE END". Afai e suia le filifiliga pito i luga ma faʻatulagaga, STM32CubeMX faʻafouina le vaega amata o le code aʻo faʻasaoina le faʻailoga autu o le faʻaogaina.

Ina ia atiaʻe se galuega faʻale-aganuʻu ma STM32CubeMX, mulimuli i laʻasaga taʻitasi:

1. Fa'atulaga uma polokalama fa'apipi'i mana'omia e fa'aaoga ai se fa'aputu-fete'ena'iga pinout, se fesoasoani fa'atulagaina o le uati, se calculator e fa'aaogaina ai le eletise, ma le fa'aoga e fa'atino ai le fa'aogaina o le MCU (e pei o le GPIO po'o le USART).
2. Fausia le fa'ailoga C code e fa'atatau i le fa'atulagaga filifilia. O lenei code ua sauni e fa'aoga i totonu o le tele o siosiomaga atina'e. O lo'o tausia le fa'aoga code i le isi fa'asologa o tulafono.
   Mo nisi fa'amatalaga e uiga i le STM32CubeMX, va'ai i le tusi fa'aoga STM32CubeMX mo le STM32 fa'atulagaina ma le amataga o le fa'asologa o le C code generation (UM1718).

Talosaga aveta'avale

HAL talosaga
O lenei vaega o loʻo faʻamatalaina laasaga e manaʻomia e fai ai se faʻaoga masani a le HAL e faʻaaoga ai le STM32CubeWL3:

1. Fausia se poloketi
   Ina ia faia se poloketi fou, amata mai le Poloketi Fa'ata'ita'i ua saunia mo laupapa ta'itasi i lalo ole \Projects\< STM32xxx_yyy>\Templates po'o so'o se poloketi avanoa i lalo o \Projects\ \Esoampl s po'o \Projects\ \ Applications (o fea e faasino i le igoa o le laupapa). O le Poloketi Fa'ata'ita'iga e maua ai se galuega fa'aoga autu gaogao. Ae ui i lea, o se amataga lelei e malamalama ai i le STM32CubeWL32 faʻatulagaina galuega. O le mamanu e iai uiga nei:
   • O loʻo i ai le HAL source code, CMSIS, ma le BSP avetaʻavale, o le seti pito i lalo o vaega e manaʻomia e atiaʻe ai se code i luga o se laupapa tuʻuina atu.
   • O loʻo i ai auala faʻapipiʻi mo vaega uma o le firmware.
   • O loʻo faʻamatalaina ai le STM32WL3x o loʻo lagolagoina masini laina oloa, faʻatagaina le CMSIS ma le HAL avetaʻavale e faʻapipiʻi saʻo.
   • E maua ai le tagata fa'aoga sauni files preconfigured pei ona faaalia i lalo:
   • O le HAL na amataina i le taimi fa'aletonu i le Arm® core SysTick.
   • SysTick ISR faʻatinoina mo le HAL_Delay() faʻamoemoega.
     Manatua: Pe a kopiina se poloketi o loʻo i ai i se isi nofoaga, ia mautinoa o auala uma e aofia ai ua faʻafouina.
2. Fa'atulaga vaega firmware
   O vaega o le HAL ma le middleware e ofoina atu se seti o filifiliga fa'atulagaina taimi-taimi e fa'aaoga ai macros #define fa'aalia i se ulutala. file. O se fa'atulagaga fa'ata'ita'iga file o loʻo tuʻuina atu i totonu o vaega taʻitasi, lea e tatau ona kopi i le faila o le poloketi (e masani lava o le configuration file ua faaigoaina xxx_conf_template.h, e tatau ona aveese le vaega _template pe a kopiina i le faila o le poloketi). Le faatulagaga file e lava faʻamatalaga e malamalama ai i le aʻafiaga o filifiliga taʻitasi. O lo'o maua nisi fa'amatalaga auiliili ile fa'amaumauga o lo'o tu'uina atu mo vaega ta'itasi.
3. Amata le faletusi HAL
   A maeʻa ona oso i le polokalame autu, e tatau i le numera o talosaga ona valaʻau le HAL_Init () API e faʻaulu ai le faletusi HAL, lea e faʻatinoina galuega nei:
   • Fa'atonuga o le flash memory prefetch ma SysTick interrupt priority (e ala i macros fa'amatala i le stm3 2wl3x_hal_conf.h).
   •  Fa'atonuga o le SysTick e fa'atupu ai se fa'alavelave ta'itasi millisecond i le fa'amuamua fa'alavelave a SysTick TICK_INT_PRIO fa'amatala i le stm32wl3x_hal_conf.h.
   • Fa'atulaga le fa'amuamua a le vaega NVIC ile 0.
   • Vala'au o le HAL_MspInit() galuega toe fo'i ua fa'amatalaina ile stm32wl3x_hal_msp.c tagata fa'aoga file e fa'atino ai fa'amatalaga masini tulaga maualalo i le lalolagi.
4. Fa'atulaga le uati o le faiga
   E faia le fa'atulagaina o le uati i le vala'au i API e lua o lo'o fa'amatalaina i lalo:
   • HAL_RCC_OscConfig (): o lenei API e faʻapipiʻiina le oscillators i totonu ma fafo. E filifili le tagata fa'aoga e fa'atulaga se tasi po'o uma oscillators.
   • HAL_RCC_ClockConfig (): o lenei API e faʻapipiʻiina le puna o le uati, le faʻaogaina o le flash memory, ma le AHB ma le APB prescalers.
5. Fa'amatamata le peripheral
   •  Muamua tusi le galuega amata peripheral. Fa'agasolo fa'apea:
   • Fa'aaga le uati pito.
   • Fa'atulaga GPIO pito i luga.
   • Fa'atulaga le ala DMA ma fa'atagaina le DMA fa'alavelave (pe a mana'omia).
   • Fa'aaga le fa'alavelave fa'apitonu'u (pe a mana'omia).
   • Fa'asa'o le stm32xxx_it.c e vala'au ai tagata fa'alavelave mana'omia ( peripheral ma DMA), pe a mana'omia.
   •  Tusi galuega fa'ato'a toe fa'afo'i fa'atino pe a fa'aoga se fa'alavelave fa'apitonu'u po'o le DMA.
   •  I le tagata fa'aoga main.c file, fa'amataina le fa'atulagaina o le au'au fa'apitoa ona vala'au lea o le galuega fa'aulufale e fa'amata ai le fa'aoga.
6. Fausia se talosaga
   I lenei stagu, ua saunia le faiga ma e mafai ona amata le atinaʻeina o tulafono a le tagata faʻaoga.
   O le HAL o loʻo tuʻuina atu API faʻapitoa ma sauni-e faʻaoga e faʻapipiʻi ai le pito. E lagolagoina le palota, faʻalavelave, ma se faʻataʻitaʻiga polokalame DMA, e faʻaogaina soʻo se manaʻoga. Mo nisi fa'amatalaga ile fa'aogaina ole peripheral ta'itasi, tagai ile rich example seti ua saunia i le STM32CubeWL3 MCU Package.

Lapata'iga:
I le fa'aogaina o le HAL, o le SysTick timer e fa'aaogaina e fai ma fa'amaumauga taimi: e fa'atupu fa'alavelave i taimi masani. Afai o le HAL_Delay() e vala'au mai le peripheral ISR process, ia mautinoa o le SysTick interrupt e maualuga lona fa'amuamua (numera maualalo) nai lo le peripheral interrupt. A leai, o le valaau ISR faagasologa o
poloka. O galuega e a'afia ai le fa'atulagaina o timebase ua fa'ailoaina o le __vaivai e fa'ato'a mafai ai pe a iai isi fa'atinoga i le tagata fa'aoga. file (fa'aogaina o se taimi fa'amoemoe lautele, mo se fa'ata'ita'igaample, poʻo se isi punaoa taimi).
Mo nisi fa'amatalaga, tagai ile HAL_TimeBase example.

LL talosaga
O lenei vaega o loʻo faʻamatalaina laasaga e manaʻomia e fai ai se faʻaoga masani LL e faʻaaoga ai le STM32CubeWL3.

1. Fausia se poloketi
   Ina ia faia se galuega fou, pe amata mai le Templates_LL poloketi ua saunia mo laupapa taʻitasi i lalo ole \Projects\ \Templates_LL pe mai so'o se poloketi avanoa i lalo o \Projects\ \E xamples_LL ( e faasino ile igoa ole laupapa, pei ole NUCLEO-WL32CC33).
   O le poloketi faʻataʻitaʻiga e maua ai se galuega faʻaoga autu gaogao, o se amataga lelei e malamalama ai i le faʻatulagaina o poloketi mo STM32CubeWL3. O uiga autu o mamanu o mea nei:
   • O loʻo i ai faʻamaumauga autu o le LL ma CMSIS avetaʻavale, o seti pito maualalo ia o vaega e manaʻomia e atiaʻe ai le code i luga o se laupapa tuʻuina atu.
   • O loʻo i ai auala faʻapipiʻi mo vaega uma o le firmware e manaʻomia.
   • Na te filifilia le STM32WL3x faʻapipiʻi laina oloa ma faʻatagaina le faʻatulagaina saʻo o le CMSIS ma le LL avetaavale.
   • E maua ai le tagata fa'aoga sauni files o loʻo faʻapipiʻiina e pei ona taua i lalo:
   • main.h: LED ma USER_BUTTON fa'auigaga fa'a'ese'esega.
   • main.c: Fa'atulagaina o le uati mo le maualuga o taimi.
2. Tausi le LL exampLe:
   • Kopi/pa'i le faila Templates_LL - e teu ai le puna muamua - pe fa'afou sa'o se poloketi Templa tes_LL.
   • Ma, o le porting e aofia ai le sui o Templates_LL files e le Examples_LL galuega fa'atatau.
   • Taofi uma vaega o le laupapa. Mo mafuaʻaga o le manino, o le laupapa vaega faʻapitoa e faʻailogaina ma faʻapitoa tags:
     

O lea la, o laasaga autu o le faʻapipiʻiina o mea nei:

• Suia le stm32wl3x_it.h file.
• Suia le stm32wl3x_it.c file.
• Sui le autu.h file ma fa'afouina: Taofi le fa'amalamalamaga o le LED ma le fa'aoga o le fa'ata'ita'iga o le LL i lalo ole BOARD SPECIFIC CONFIGURATION tags.
• Sui le autu.c file ma faafou:
• Taofi le fa'atulagaina o le uati o le SystemClock_Config() LL fa'ata'ita'iga galuega i lalo ole BOARD SPECIFIC CONFIGURATION tags.
• Fa'alagolago i le fa'amalamalamaga o le LED, sui ta'itasi LDx mea tutupu i se isi LDy o lo'o maua ile file autu.h.

Faatasi ai ma nei suiga, o le example tamoe i luga o le laupapa taulai.

RF talosaga, faʻataʻitaʻiga, ma examples
Ituaiga eseese o talosaga RF, faʻataʻitaʻiga, ma exampo lo'o maua i le STM32CubeWL3 afifi. O lo'o lisiina i vaega e lua o lo'o i lalo.

Sub-GHz examples ma fa'ata'ita'iga
O nei exampo lo'o fa'aalia uiga autu o le MRSUBG ma le LPAWUR uaea leitio. O nei exampo lo'o maua i lalo:

• Poloketi\NUCLEO-WL33CC\Examples\MRSUBG
• Poloketi\NUCLEO-WL33CC\Examples\LPAWUR
• Poloketi\NUCLEO-WL33CC\Fa'aaliga\MRSUBG
• Poloketi\NUCLEO-WL33CC\Fa'aaliga\LPAWUR

O example poʻo faʻataʻitaʻiga masani e aofia ai polokalame e lua e taʻua o Tx ma Rx o loʻo avea ma transmitter ma receiver, i le faasologa:

• Examples/MRSUBG
  • MRSUBG_802_15_4: o se faʻatinoga o le faʻaogaina o le tino o loʻo faʻamatalaina e le tulaga masani 802.15.4. O loʻo faʻaalia ai le faʻaogaina o le leitio e faʻasalalau pe maua 802.15.4 pepa.
  • MRSUBG_BasicGeneric: O se fesuiaiga o STM32WL3x MR_SUBG pepa autu.
  • MRSUBG_Chat: O se talosaga faigofie e faʻaalia ai le faʻaogaina o le Tx ma le Rx i le masini lava e tasi.
  • MRSUBG_DatabufferHandler: O se exampLe faʻaalia pe faʻafefea ona sui mai le Databuffer 0 ma le 1.
  • MRSUBG_Sequencer AutoAck: O se example fa'asalalauina ma maua fa'ailoga pepa (ACKs) otometi.
  • MRSUBG_WMBusSTD: O se fesuiaiga o fe'au WM-Bus.
  • WakeupRadio: O se example e su'e le LPAWUR leitio peripheral.
• Fa'aaliga/MRSUBG
  • MRSUBG_RTC_Button_TX: O lenei exampLe faʻaalia pe faʻafefea ona seti le SoC i le loloto-stop mode ma faʻapipiʻi le MRSUBG e fafagu le SoC e ala i le oomi PB2 e lafo se faʻavaa poʻo le maeʻa o le taimi ole RTC.
  • MRSUBG_Sequencer_Sniff: O lenei exampO lo'o fa'aalia ai le fa'atulagaina o le fa'asologa o le MRSUBG e fa'agaoioi i le faiga sogisogi. O lenei example faʻaalia le itu e taliaina ma manaʻomia se isi masini e fai ma transmitter.
  • MRSUBG_Timer: O le talosaga e faʻatulagaina le tele o taimi ole MRSUBG timer (faʻatasi ai ma le autoreload) faʻatasi ai ma taimi eseese.
  • MRSUBG_WakeupRadio_Tx: O lenei exampLe faʻamatalaina pe faʻafefea ona seti le SoC i le loloto taofi ma faʻapipiʻi le MRSUBG e fafagu le SoC e ala i le oomi PB2 e lafo se faʻavaa. O lenei example fa'aalia le itu o le transmitter ma mana'omia se isi masini e pei o se LPAWUR receiver. Le tagata e taliaina example o lo'o i lalo ole NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRad io_Rx folder.
• Fa'aaliga/LPAWUR
  • LPAWUR_WakeupRadio_Rx: O lenei exampLe fa'amatalaina pe fa'afefea ona seti le SoC i le loloto-stop mode ma fa'atulaga le LPAWUR e fafagu le SoC pe a o'o mai se fa'avaa ma maua sa'o. O lenei example faʻaalia le itu e taliaina ma manaʻomia se isi masini e fai ma transmitter. Le transmitter example o lo'o i lalo ole NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRad io_Tx folder.

Sigfox™ talosaga
O nei talosaga e faʻaalia ai le faʻatinoina o se Sigfox™ faʻaaliga ma faʻaoga avanoa Sigfox™ API. O lo'o avanoa i le ala o le poloketi Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: O lenei tusi talosaga o loʻo faʻaalia ai le faʻaogaina o se laina faʻatonuga (CLI) e lafo ai faʻatonuga e faʻaogaina ai le Sigfox™ protocol e lafo ai feʻau ma faia suʻega faʻamaonia.
• Sigfox_PushButton: O lenei talosaga e faʻatagaina ai le iloiloga o le STM32WL33xx Sigfox ™ masini leitio gafatia. O le omiina o le PB1 e fa'asalalauina ai se fa'ata'ita'iga Sigfox™.

FAQ

1. O afea e tatau ai ona ou faʻaogaina le HAL nai lo le avetaʻavale LL?
   O aveta'avale HAL latou te ofoina atu APIs maualuga ma fa'atino galuega, fa'atasi ai ma se tulaga maualuga o le feavea'i. O oloa po'o fa'alavelave fa'apitoa o lo'o natia mo tagata fa'aoga.
   O aveta'avale LL latou te ofoina atu APIs tulaga maualalo, fa'atasi ai ma le fa'aleleia atili ae itiiti le feavea'i. Latou te manaʻomia le malamalama loloto o oloa poʻo faʻamatalaga IP.
2. E mafai ona fa'aoga fa'atasi aveta'avale HAL ma LL? Afai e ioe, o a ni fa'alavelave?
   E mafai ona fa'aoga uma aveta'avale HAL ma LL. Fa'aoga le HAL mo le vaega o le fa'aulufalega fa'apitoa ona fa'atautaia lea o galuega I/O ma aveta'avale LL.
   O le eseesega tele i le va o le HAL ma le LL e manaʻomia e avetaʻavale HAL le fatuina ma le faʻaogaina o au mo le faʻafoega o galuega aʻo taʻavale LL e faʻagaioia saʻo i luga o tusi resitala. Fa'afefiloi HAL ma LL o lo'o fa'aalia i le Examples_MIX examples.
3. E fa'afefea ona fa'aogaina LL initialization APIs?
   O le fa'amatalaga o LL initialization APIs ma punaoa e feso'otai i ai (fa'atulagaina, fa'ata'ita'iga, ma fa'ata'ita'iga) o lo'o fa'atulagaina e le USE_FULL_LL_DRIVER sui tu'ufa'atasi.
   Ina ia mafai ona fa'aoga LL initialization APIs, fa'aopoopo le ki lea i le toolchain compiler preprocessor.
4. E i ai se fa'ata'ita'iga poloketi mo le MRSUBG/LPAWUR peripheral examples?
   Le faia o se MRSUBG fou poʻo LPAWUR example poloketi, pe amata mai i le auivi poloketi o lo'o tu'uina atu i lalo o le \Pr ojects\NUCLEO-WL33CC\Examples\MRSUBG poʻo \Projects\NUCLEO-WL33CC\Examples\LPAWUR, pe mai so'o se poloketi avanoa i lalo o nei lava fa'atonuga.
5. E fa'afefea ona fa'atupuina e STM32CubeMX le fa'ailoga e fa'avae i luga o polokalama fa'apipi'i?
   STM32CubeMX o loʻo i ai se malamalama faʻapipiʻi i totonu ole STM32 microcontrollers, e aofia ai a latou peripheral ma polokalama faakomepiuta, lea e mafai ai ona tuʻuina atu se ata faʻataʻitaʻi i le tagata faʻaoga ma gaosia *.h poʻo *.c files fa'avae ile fa'atulagaina ole tagata fa'aoga.

Toe iloilo tala'aga

Laulau 3. Tala'aga o le toe iloiloga o pepa

Aso	Toe Iloiloga	Suiga
29-Mat-2024	1	Fa'asalalauga muamua.
30-Oke-2024	2	Tuufaatasiga atoatoa o STM32CubeWL3 in STM32Cube. Fa'afouina: Folasaga Vaega 2: STM32CubeWL3 vaega autu Vaega 3.2.1: Vaega o mea e fa'aogaina Vaega 4: STM32CubeWL3 pusa firmware ua umaview Vaega 5.1: Fa'atino se muamua muamuaample Vaega 5.3: Talosaga RF, faʻataʻitaʻiga, ma faʻataʻitaʻigaamples Fa'aopoopo: Vaega 5.1.1: Fa'afefea ona fai se HAL example Vaega 5.2.1: Fa'aaoga STM32CubeMX e atia'e pe fa'afouina se talosaga Vaega 6.4: E iai se polokalame fa'ata'ita'i mo MRSUBG/LPAWUR peripheral examples? Vaega 6.5: Fa'afefea ona STM32CubeMX fa'atupu fa'ailoga e fa'atatau i polokalama fa'apipi'i? Ave'esea: Meafaigaluega PC, e aofia ai Tautai, STM32WL3 GUI, ma MR-SUBG Sequencer GUI E mafai faapefea e WiSE-Studio IOMapper ona gaosia le code e faʻavae i luga o polokalama faʻapipiʻi? E fa'atagaina e le Navigator le avanoa i puna'oa fa'apipi'i polokalame?

Pepa / Punaoa

ST STM32WL3x Software Package [pdf] Faatonuga STM32WL3x Software Package, STM32WL3x, Software Package, Package

Fa'asinomaga

• Tusi Taiala