Microcontrollers STM32WL3x

Stiùireadh airson cleachdadh bathar

• Tha am pasgan STM32CubeWL3 a’ toirt a-steach APIan ìre ìosal (LL) agus còmhdach tarraing bathar-cruaidh (HAL) a tha a’ còmhdach bathar-cruaidh microcontroller.
• Bidh e cuideachd a 'toirt seachad co-phàirtean meadhanach mar SigfoxTM, FatFS, agus FreeRTOS kernel.
• Tha am pasgan a’ tighinn le examples agus tagraidhean airson buileachadh furasta.
• Tha ailtireachd STM32CubeWL3 air a thogail timcheall air trì ìrean: Tagraidhean, HAL, agus LL.
• Tha na APIan HAL agus LL a’ còmhdach raon farsaing de riatanasan tagraidh.
• Tha an HAL a’ tabhann cleachdadh iomaill bunaiteach examples, agus tha an LL a’ toirt seachad cleachdaidhean ìre ìosal.
• Tha an ìre seo a’ toirt a-steach Pasgan Taic a’ Bhùird (BSP) agus sublayers HAL.
• Bidh am BSP a’ tabhann APIan airson co-phàirtean bathar-cruaidh air bùird, fhad ‘s a tha HAL a’ toirt seachad cleachdadh iomaill bunaiteach examples.
• Bidh draibhearan BSP a’ ceangal draibhearan co-phàirteach ri bùird sònraichte, ga dhèanamh furasta a ghiùlan gu bathar-cruaidh eile.
• Tha an STM32CubeWL3 HAL agus LL taiceil, a’ còmhdach raon farsaing de riatanasan tagraidh.
• Faodaidh luchd-cleachdaidh na APIan sin a luathachadh gus eadar-obrachadh leis a’ bhathar-cruaidh microcontroller gu h-èifeachdach.

Ro-ràdh

Tha STM32Cube na iomairt thùsail STMicroelectronics gus cinneasachd dealbhaiche adhartachadh gu mòr le bhith a’ lughdachadh oidhirp leasachaidh, ùine agus cosgais. Tha STM32Cube a’ còmhdach a’ phasgan STM32 gu lèir. Tha STM32Cube a’ toirt a-steach:

Tha STM32Cube a ’toirt a-steach:

• Seata de dh ’innealan leasachaidh bathar-bog a tha furasta a chleachdadh gus dèiligeadh ri leasachadh pròiseict bho bhun-bheachd gu coileanadh, am measg sin tha:
  • STM32CubeMX, inneal rèiteachaidh bathar-bog grafaigeach a leigeas le còd tòiseachaidh C a ghineadh gu fèin-ghluasadach a ’cleachdadh buidsich grafaigeach
  • STM32CubeIDE, inneal leasachaidh uile-ann-aon le rèiteachadh iomaill, gineadh còd, cur ri chèile còd, agus feartan deasbaid
  • STM32CubeCLT, inneal leasachaidh loidhne-àithne uile-ann-aon le cruinneachadh còd, prògramadh bùird, agus feartan deasbaid
  • STM32CubeProgrammer (STM32CubeProg), inneal prògramaidh ri fhaighinn ann an dreachan grafaigeach agus loidhne-àithne
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), innealan sgrùdaidh cumhachdach gus giùlan agus coileanadh thagraidhean STM32 ùrachadh ann an àm fìor
• Pacaidean STM32Cube MCU agus MPU, àrd-ùrlaran bathar-bog freumhaichte a tha sònraichte do gach sreath microcontroller agus microprocessor (leithid STM32CubeWL3 airson loidhne toraidh STM32WL3x), a tha a’ toirt a-steach:
  • Sreath toirt air falbh bathar-cruaidh STM32Cube (HAL), a ’dèanamh cinnteach gu bheil an comas giùlain as motha air feadh pasgan STM32
  • APIan ìre ìosal STM32Cube, a ’dèanamh cinnteach à coileanadh agus lorgan-coise as fheàrr le ìre àrd de smachd luchd-cleachdaidh air bathar-cruaidh
  • Seata cunbhalach de cho-phàirtean meadhan-bathair leithid kernel FreeRTOS ™, FatFS, agus Sigfox ™
  • A h-uile goireas bathar-bog freumhaichte le làn sheataichean de ex imeallach agus iomchaidhamples
• Pasgan leudachaidh STM32Cube, anns a bheil co-phàirtean bathar-bog freumhaichte a chuireas ri comasan pacaidean STM32Cube MCU agus MPU le:
  • Leudachain Middleware agus sreathan iomchaidh
  • Examples a ’ruith air cuid de bhùird leasachaidh sònraichte STMicroelectronics
• Tha an leabhar-làimhe cleachdaiche seo ag innse mar a thòisicheas tu leis a’ phasgan STM32CubeWL3 MCU.

Tha Roinn 2 a’ toirt cunntas air prìomh fheartan STM32CubeWL3 agus tha Earrann 3 a’ toirt seachad barrachdview den ailtireachd aige agus de structar Pasgan MCU.

Fiosrachadh coitcheann

• STM32CubeWL3 a’ ruith tagraidhean taisbeanaidh fo-GHz, a’ toirt a-steach binaries Sigfox ™, air microcontrollers loidhne toraidh STM32WL3x stèidhichte air pròiseasar Arm® Cortex®-M0+.
• Bidh na microcontrollers STM32WL3x a’ toirt a-steach iomall rèidio RF fo-GHz ùr-nodha a tha a ’gèilleadh ri STMicroelectronics, air a bharrrachadh airson caitheamh cumhachd ultra-ìosal agus coileanadh rèidio sàr-mhath, airson beatha bataraidh gun choimeas.

Thoir an aire: Tha Arm na chomharra-malairt clàraichte de Arm Earranta (no na fo-chompanaidhean aige) anns na SA agus / no an àite eile.

STM32CubeWL3 prìomh fheartan

• Bidh am Pasgan MCU STM32CubeWL3 a ’ruith air microcontrollers STM32 32-bit stèidhichte air pròiseasar Arm® Cortex®-M0 +. Bidh e a’ cruinneachadh, ann an aon phacaid, a h-uile pàirt de bhathar-bog freumhaichte a dh’ fheumar gus tagradh a leasachadh airson an Loidhne toraidh STM32WL3x microcontrollers.
• Tha am pasgan a’ toirt a-steach APIan ìre ìosal (LL) agus còmhdach tarraing bathar-cruaidh (HAL) a tha a’ còmhdach bathar-cruaidh microcontroller, còmhla ri seata farsaing de exampnas lugha a' ruith air bùird STMicroelectronics. Tha na APIan HAL agus LL rim faighinn ann an cead stòr fosgailte BSD airson goireasachd luchd-cleachdaidh. Tha e cuideachd a’ toirt a-steach na pàirtean meadhan-inneal Sigfox ™, FatFS, agus FreeRTOS ™.
• Tha am Pasgan MCU STM32CubeWL3 cuideachd a’ toirt seachad grunn thagraidhean agus thaisbeanaidhean a’ buileachadh a h-uile pàirt de bhathar-meadhain.
• Tha cruth pàirt pacaid STM32CubeWL3 MCU ri fhaicinn ann am Figear 1.

STM32CubeWL3 ailtireachd seachadview

• Tha fuasgladh Pasgan STM32CubeWL3 MCU air a thogail timcheall air trì ìrean neo-eisimeileach a bhios ag eadar-obrachadh gu furasta mar a chaidh a mhìneachadh ann am Figear 2.

Ìre 0
Tha an ìre seo air a roinn ann an trì sublayers:

• Pasgan taic bùird (BSP).
• Sreath toirt air falbh bathar-cruaidh (HAL):
  • Draibhearan peripheral HAL
  • Draibhearan ìre ìosal
• Cleachdadh iomaill bunaiteach examples.

Pasgan taic bùird (BSP)
Tha an còmhdach seo a’ tabhann seata de APIan an coimeas ris na pàirtean bathar-cruaidh anns na bùird bathar-cruaidh (leithid LEDs, putanan, agus draibhearan COM). Tha e air a dhèanamh suas de dhà phàirt:

Co-phàirt:

• Is e seo an draibhear an coimeas ris an inneal a-muigh air a’ bhòrd agus chan ann ris an STM32. Bidh an draibhear co-phàirteach a’ toirt APIan sònraichte do phàirtean taobh a-muigh draibhear BSP agus dh’ fhaodadh iad a bhith air an giùlan air bòrd sam bith eile.
  • Driver BSP:
• Leigidh e leis na draibhearan co-phàirteach a cheangal ri bòrd sònraichte agus a’ toirt seachad seata de APIan a tha furasta a chleachdadh. Is e an riaghailt ainmeachaidh API BSP_FUNCT_Action().
• Example: BSP_LED_Init(), BSP_LED_On()

Tha BSP stèidhichte air ailtireachd modular a leigeas le bhith a’ giùlain bathar-cruaidh sam bith gu furasta le bhith dìreach a’ cur an gnìomh cleachdaidhean ìre ìosal.

Còmhdach tarraing bathar-cruaidh (HAL) agus còmhdach ìosal (LL)

Tha an STM32CubeWL3 HAL agus LL co-phàirteach agus a’ còmhdach raon farsaing de riatanasan tagraidh:

• Bidh na draibhearan HAL a’ tabhann APIan so-ghiùlain àrd-ìre stèidhichte air gnìomh. Bidh iad a’ falach an MCU agus iom-fhillteachd iomaill don neach-cleachdaidh deireannach.
  Bidh na draibhearan HAL a’ toirt seachad APIan gnèitheach ioma-ìre stèidhichte air feart, a bhios a’ sìmpleachadh buileachadh tagradh neach-cleachdaidh le bhith a’ toirt seachad pròiseasan deiseil airson a chleachdadh. Airson example, airson na h-iomaill conaltraidh (I2C, UART, agus feadhainn eile), bidh e a’ toirt seachad APIan a leigeas le bhith a’ tòiseachadh agus a’ rèiteachadh an iomaill, a’ riaghladh gluasad dàta stèidhichte air pròiseas bhòtaidh, briseadh, no DMA, agus a’ làimhseachadh mhearachdan conaltraidh a dh’ fhaodadh èirigh rè conaltradh. Tha na APIan draibhear HAL air an roinn ann an dà roinn:
  • APIan coitcheann, a bheir seachad gnìomhan coitcheann agus coitcheann dha na microcontrollers sreath STM32 gu lèir.
  • API leudachaidh, a bheir seachad gnìomhan sònraichte agus gnàthaichte airson teaghlach sònraichte no àireamh pàirt sònraichte.
• Bidh na APIan ìre ìosal a’ toirt seachad APIan aig ìre ìosal aig ìre a’ chlàir, le optimization nas fheàrr ach nas lugha de chomas giùlain.
  Feumaidh iad eòlas domhainn air an MCU agus mion-chomharrachadh iomaill.
  Tha na draibhearan LL air an dealbhadh gus còmhdach luath aotrom, stèidhichte air eòlaiche a thabhann a tha nas fhaisge air a’ bhathar-cruaidh na an HAL. A dh’ aindeoin HAL, chan eil APIan LL air an toirt seachad airson iomaill far nach eil ruigsinneachd làn-leasaichte na phrìomh fheart, no dhaibhsan a dh’ fheumas rèiteachadh bathar-bog trom no stac iom-fhillte àrd-ìre.
  Feart nan draibhearan LL:
• Seata de dhleastanasan gus prìomh fheartan iomaill a thòiseachadh a rèir nam paramadairean a tha air an sònrachadh ann an structaran dàta.
• Seata de ghnìomhan gus structaran dàta tòiseachaidh a lìonadh leis na luachan ath-shuidheachadh a fhreagras air gach raon.
• Gnìomh airson dì-thòiseachadh iomaill (clàran iomaill air an toirt air ais gu na luachan bunaiteach aca).
• Seata de ghnìomhan in-loidhne airson ruigsinneachd dìreach agus clàr atamach.
• Neo-eisimeileachd iomlan bho HAL agus comas a chleachdadh ann am modh leis fhèin (às aonais draibhearan HAL).
• Còmhdach iomlan de na feartan iomaill le taic.

Cleachdadh iomaill bunaiteach examples
Tha an còmhdach seo a’ cuairteachadh an t-seannampnas lugha air a thogail thairis air iomaill STM32 a’ cleachdadh dìreach goireasan HAL agus BSP.
Thoir an aire: Taisbeanadh examples rim faighinn cuideachd gus example suidheachaidhean le iomaill sònraichte, leithid an MRUBG agus LPAWUR.

Ìre 1
Tha an ìre seo air a roinn ann an dà sublayers:

• Co-phàirtean meadhan-bathair
• Exampnas lugha stèidhichte air na co-phàirtean middleware

Co-phàirtean meadhan-bathair
Tha am bathar meadhanach na sheata de leabharlannan a tha a’ còmhdach leabharlann pròtacal FreeRTOS ™ kernel, FatFS, agus Sigfox ™.
Bithear a’ dèanamh eadar-obrachadh còmhnard eadar co-phàirtean an t-sreath seo le bhith a’ gairm nan APIan sònraichte.
Tha eadar-obrachadh dìreach leis na draibhearan ìre ìosal air a dhèanamh tro ghairm air ais sònraichte agus macros statach air an cur an gnìomh ann an eadar-aghaidh gairm siostam an leabharlainn.
Tha prìomh fheartan gach co-phàirt meadhan-bathair mar a leanas:

• kernel FreeRTOS™: a’ cur an gnìomh siostam obrachaidh fìor-ùine (RTOS), air a dhealbhadh airson siostaman freumhaichte.
• Sigfox ™: a ’buileachadh leabharlann protocol Sigfox ™ a tha a’ gèilleadh ri lìonra protocol Sigfox ™ agus a ’toirt a-steach leabharlann protocol deuchainn RF gus deuchainn a dhèanamh an aghaidh innealan RF Sigfox ™.
• FatFS: a 'cur an gnìomh an FAT coitcheann file modal siostam.

Exampnas lugha stèidhichte air na co-phàirtean middleware

• Bidh gach pàirt meadhan-bathair a’ tighinn le aon no barrachd examples, ris an canar cuideachd tagraidhean, a 'sealltainn mar a chleachdas tu e.
• Amalachadh exampagus tha sin a 'cleachdadh grunn phàirtean meadhanach air an toirt seachad cuideachd.

Pasgan firmware STM32CubeWL3 seachadview

Innealan agus bathar-cruaidh STM32WL3x le taic

• Ciùb STM32 a’ tabhann còmhdach tarraing bathar-cruaidh fìor ghluasadach (HAL) air a thogail timcheall air ailtireachd coitcheann. Tha e a’ ceadachadh prionnsapal sreathan togail, leithid a bhith a’ cleachdadh an còmhdach meadhan-bathair gus na gnìomhan aca a bhuileachadh gun fhios, gu domhainn, dè an MCU a thathas a’ cleachdadh. Leasaichidh seo comas ath-chleachdadh còd an leabharlainn agus nì e cinnteach gum bi e furasta a ghluasad gu innealan eile.
• A bharrachd air an sin, leis an ailtireachd sreathach aige, STM32CubeWL3 a’ tabhann làn thaic don loidhne toraidh STM32WL3x gu lèir.
• Feumaidh an cleachdaiche dìreach am macro ceart a mhìneachadh ann an stm32wl3x.h.
• Tha Clàr 1 a’ sealltainn am macro ri mhìneachadh a rèir an inneal loidhne toraidh STM32WL3x a chaidh a chleachdadh. Feumaidh am macro seo a bhith air a mhìneachadh cuideachd anns an ro-phròiseas cruinneachaidh.

Clàr 1. Macros airson loidhne toraidh STM32WL3x

Macro air a mhìneachadh ann an STM32WL3X.h	Innealan loidhne toraidh STM32WL3x
stm32wl3x	STM32WL30xx microcontrollers STM32WL31xx microcontrollers STM32WL33xx microcontrollers

Clàr 2. Bùird airson loidhne toraidh STM32WL3x

Bòrd	Innealan le taic bòrd STM32WL3x
NUCLEO-WL33CC1	STM32WL33CC
NUCLEO-WL33CC2	STM32WL33CC

Faodaidh am Pasgan MCU STM32CubeWL3 ruith air bathar-cruaidh co-chosmhail sam bith. Bidh an luchd-cleachdaidh ag ùrachadh na draibhearan BSP gus port a thoirt seachad exampnas lugha air na bùird aca, ma tha na h-aon fheartan bathar-cruaidh aca (leithid LEDs no putanan).

Pasgan firmware seachadview

• Tha am fuasgladh pacaid STM32CubeWL3 MCU air a thoirt seachad ann an aon phasgan zip singilte, leis an structar air a shealltainn ann am Figear 3.

Rabhadh: Chan fhaod an neach-cleachdaidh na co-phàirtean atharrachadh files. Chan urrainn dhan neach-cleachdaidh ach na stòran \Projects a dheasachadh. Airson gach bòrd, seata de examples air a thoirt seachad le pròiseactan ro-shuidhichte airson na slabhraidhean inneal EWARM, MDK-ARM, agus STM32CubeIDE.
Tha Figear 4 a’ sealltainn structar a’ phròiseict airson bùird NUCLEO-WL33CCx.

Tha an t-examptha les air an seòrsachadh a rèir na h-ìre STM32CubeWL3 ris a bheil iad a’ buntainn. Tha iad air an ainmeachadh mar a leanas:

• Ìre 0 examptha iad ris an canar Examples, Examples_LL, agus Examples_MIX. Bidh iad a’ cleachdadh draibhearan HAL fa leth, draibhearan LL, agus measgachadh de dhraibhearan HAL agus LL às aonais pàirt bathar meadhanach sam bith. Taisbeanadh examptha les ri fhaighinn cuideachd.
• Ìre 1 examples canar Tagraidhean. Bidh iad a’ toirt seachad cùisean cleachdaidh àbhaisteach de gach pàirt meadhan-bathair.

Faodar tagradh firmware sam bith airson bòrd sònraichte a thogail gu sgiobalta a’ cleachdadh na pròiseactan teamplaid a tha rim faighinn anns na clàran Templates agus Templates_LL.
Examples, Examples_LL, agus Examptha an aon structar aig les_MIX:

• \Inc pasgan anns a bheil a h-uile bann-cinn files.
• \Src pasgan anns a bheil an còd tùsail.
• \ EWARM, \ MDK-ARM, agus \ STM32 CubeIDE pasgannan anns a bheil am pròiseact ro-shuidhichte airson gach inneal-slabhraidh.
• readme.md agus readme.html a’ toirt cunntas air an t-seannample giùlan agus an àrainneachd a tha a dhìth gus toirt air obrachadh.

A’ tòiseachadh le STM32CubeWL3

A 'ruith a' chiad example
Tha an earrann seo a’ mìneachadh cho sìmplidh ‘s a tha e a’ chiad example taobh a-staigh STM32CubeWL3. Bidh e a’ cleachdadh mar eisimpleir gineadh toggle LED sìmplidh a’ ruith air bòrd NUCLEO-WL33CC1:

1. Luchdaich sìos Pasgan MCU STM32CubeWL3.
2. Unzip e, no ruith an stàlaichear ma tha e air a sholarachadh, ann an eòlaire de do roghainn.
3. Dèan cinnteach nach atharraich thu structar a’ phacaid a chithear ann am Figear 3. Structar pacaid firmware STM32CubeWL3. Thoir an aire gu bheilear cuideachd a’ moladh am pasgan a chopaigeadh aig àite faisg air an tomhas-lìonaidh (a’ ciallachadh C: \ ST no G: \ Tests), leis gu bheil duilgheadasan aig cuid de IDEan nuair a tha an t-slighe ro fhada.

Mar a ruitheas tu HAL example
Mus tèid a luchdachadh agus a ruith example, thathas a’ moladh gu làidir an example leughadh file airson rèiteachadh sònraichte sam bith.

1. Dèan brobhsadh gu \Projects\NUCLEO-WL33CC\Examples.
2. Fosgail na pasganan \GPIO, an uairsin \GPIO_EXTI.
3. Fosgail am pròiseact leis an inneal as fheàrr leotha. Gu sgiobalta seachadview air mar a dh’fhosglas, a thogas, agus a ruitheas tu example leis na slabhraidhean innealan le taic air a thoirt seachad gu h-ìosal.
4. Ath-thog na h-uile files agus luchdaich an ìomhaigh a-steach don chuimhne targaid.
5. Ruith an example. Airson tuilleadh fiosrachaidh, thoir sùil air an example leughadh file.

Gus fosgladh, togail, agus ruith example gach aon de na slabhraidhean innealan le taic, lean na ceumannan gu h-ìosal:

• EWARM:
  1. Fon Examples pasgan, fosgail am fo-phasgan \ EWARM.
  2. Cuir air bhog àite-obrach Project.eww (dh’ fhaodadh an t-ainm àite-obrach atharrachadh bho aon example fear eile).
  3. Ath-thog na h-uile files: [Pròiseact]>[Ath-thog a h-uile].
  4. Luchdaich dealbh a’ phròiseict: [Project]>[Debug].
  5. Ruith am prògram: [Debug]>[Rach (F5)].
• MDK-ARM:
  1. Fon Examples pasgan, fosgail am fo-phasgan \ MDK-ARM.
  2. Fosgail àite-obrach Project.uvproj (dh’ fhaodadh gun atharraich ainm an àite-obrach bho aon example fear eile).
  3. Ath-thog na h-uile files: [Pròiseact]> [Ath-thog a h-uile targaid files].
  4. Luchdaich ìomhaigh a’ phròiseict: [Debug]>[Tòisich/Stop Debug Session].
  5. Ruith am prògram: [Debug]>[Run (F5)].
• STM32 CubeIDE:
  1. Fosgail an inneal STM32CubeIDE.
  2. Cliog air [File]>[Atharraich Àite-obrach]> [Eile] agus thoir sùil air an eòlaire àite-obrach STM32CubeIDE.
  3. Cliog air [File]>[Import], tagh [Coitcheann]> [Pròiseactan gnàthaichte a-steach don Àite-obrach], agus an uairsin cliog air [Air adhart].
  4. Dèan brobhsadh air an eòlaire àite-obrach STM32CubeIDE agus tagh am pròiseact.
  5. Ath-thogail a h-uile pròiseact files: Tagh am pròiseact ann an uinneag Project Explorer agus an uairsin cliog air a’ chlàr [Project]>[Build project].
  6. Ruith am prògram: [Ruith]>[Debug (F11)].

A’ leasachadh tagradh gnàthaichte

A’ cleachdadh STM32CubeMX gus tagradh a leasachadh no ùrachadh

• Ann am Pasgan MCU STM32Cube, tha cha mhòr a h-uile pròiseact examples air an gineadh leis an inneal STM32CubeMX gus an siostam, iomaill, agus bathar meadhanach a thòiseachadh.

Cleachdadh dìreach de phròiseact a th’ ann mar-thà exampFeumaidh le bhon inneal STM32CubeMX STM32CubeMX 6.12.0 no nas àirde:

• Às deidh STM32CubeMX a chuir a-steach, fosgail agus ma tha sin riatanach ùraich am pròiseact a tha san amharc.
  Is e an dòigh as sìmplidh air pròiseact a tha ann mu thràth fhosgladh le bhith a’ briogadh dùbailte air an *.ioc file gus am bi STM32CubeMX gu fèin-ghluasadach a’ fosgladh a ’phròiseict agus an stòr aige files. Bidh STM32CubeMX a’ gineadh còd tùsail tòiseachaidh phròiseactan mar sin.
• Tha prìomh chòd stòr an tagraidh anns na beachdan “USER CODE BEGIN” agus “USER CODE END”. Ma thèid an taghadh iomaill agus na roghainnean atharrachadh, bidh STM32CubeMX ag ùrachadh a’ phàirt tòiseachaidh den chòd fhad ‘s a tha e a’ gleidheadh ​​​​prìomh chòd stòr an tagraidh.
• Gus pròiseact àbhaisteach a leasachadh le STM32CubeMX, lean am pròiseas ceum air cheum:
  1. Dèan rèiteachadh air a h-uile bathar-bog freumhaichte a tha a dhìth a’ cleachdadh inneal fuasglaidh pinout-conflict, neach-cuideachaidh suidheachadh craobh-cloc, àireamhair caitheamh cumhachd, agus an goireas a’ coileanadh rèiteachadh iomaill MCU (leithid GPIO no USART).
  2. Cruthaich an còd tòiseachaidh C stèidhichte air an rèiteachadh taghte. Tha an còd seo deiseil airson a chleachdadh ann an grunn àrainneachdan leasachaidh. Tha an còd cleachdaiche air a chumail aig an ath ghinealach còd.
     Airson tuilleadh fiosrachaidh mu STM32CubeMX, thoir sùil air an leabhar-làimhe neach-cleachdaidh STM32CubeMX airson rèiteachadh STM32 agus tòiseachadh ginealach còd C (UM1718).

Iarrtasan driver
Iarrtas HAL
Tha an roinn seo a’ toirt cunntas air na ceumannan a dh’fheumar gus tagradh àbhaisteach HAL a chruthachadh a’ cleachdadh STM32CubeWL3

1. Cruthaich pròiseact
   Gus pròiseact ùr a chruthachadh, tòisich an dàrna cuid bhon phròiseact Teamplaid a chaidh a sholarachadh airson gach bòrd fo \Projects\ \Templates no bho phròiseact sam bith a tha ri fhaighinn fo \Projects\ \examples no \Proj ects\ \ Tagraidhean (far a bheil a’ toirt iomradh air ainm a’ bhùird).
   Tha am pròiseact Template a’ toirt seachad gnìomh prìomh lùb falamh. Ach, tha e na dheagh àite tòiseachaidh a bhith a’ tuigsinn roghainnean pròiseict STM32CubeWL3. Tha na feartan a leanas aig an teamplaid:
   • Tha còd stòr HAL ann, CMSIS, agus draibhearan BSP, a tha mar an seata as lugha de cho-phàirtean a dh’ fheumar gus còd a leasachadh air bòrd sònraichte.
   • Tha na slighean ann airson na pàirtean firmware gu lèir.
   • Bidh e a’ mìneachadh na h-innealan loidhne toraidh STM32WL3x le taic, a’ leigeil leis na draibhearan CMSIS agus HAL a bhith air an rèiteachadh gu ceart.
   • Tha e a 'toirt seachad cleachdaiche deiseil airson a chleachdadh files ro-shuidhichte mar a chithear gu h-ìosal:
   • Thòisich HAL leis a’ bhunait ùine àbhaisteach leis an Arm® core SysTick.
   • SysTick ISR air a chuir an gnìomh airson adhbhar HAL_Delay().
   • Nota: Nuair a bhios tu a’ dèanamh lethbhreac de phròiseact a th’ ann mar-thà gu àite eile, dèan cinnteach gu bheil na slighean uile air an ùrachadh.
2. Dèan rèiteachadh air na co-phàirtean firmware
   Bidh na pàirtean HAL agus middleware a’ tabhann seata de roghainnean rèiteachaidh ùine togail a ’cleachdadh macros #define air ainmeachadh ann am bann-cinn file. A rèiteachadh teamplaid file air a thoirt seachad taobh a-staigh gach pàirt, a dh’ fheumar a chopaigeadh gu pasgan a ’phròiseict (mar as trice an rèiteachadh file air ainmeachadh xxx_conf_template.h, a' chriomag
   • feumar an teamplaid a thoirt air falbh nuair a thèid a chopaigeadh gu pasgan a’ phròiseict). An rèiteachadh file a’ toirt seachad fiosrachadh gu leòr gus buaidh gach roghainn rèiteachaidh a thuigsinn. Tha fiosrachadh nas mionaidiche ri fhaighinn anns na sgrìobhainnean a tha air an toirt seachad airson gach pàirt.
3. Tòisich leabharlann HAL
   Às deidh dha leum chun phrìomh phrògram, feumaidh an còd tagraidh fios a chuir gu HAL_Init() API gus an leabharlann HAL a thòiseachadh, a bhios a’ coileanadh nan gnìomhan a leanas:
   • Rèiteachadh an prefetch cuimhne flash agus prìomhachas casg SysTick (tro macros air am mìneachadh ann an stm32 wl3x_hal_conf.h).
   • Rèiteachadh an SysTick gus casg a chuir air a h-uile millisecond aig prìomhachas brisidh SysTick TICK_INT_PRIO air a mhìneachadh ann an stm32wl3x_hal_conf.h.
   • A’ suidheachadh prìomhachas buidheann NVIC gu 0.
   • Gairm gairm air ais HAL_MspInit() gnìomh air a mhìneachadh anns a’ chleachdaiche stm32wl3x_hal_msp.c file gus tòiseachadh air bathar-cruaidh ìre ìosal cruinneil a thòiseachadh.
4. Dèan rèiteachadh air gleoc an t-siostaim
   Tha rèiteachadh gleoc an t-siostaim air a dhèanamh le bhith a’ gairm an dà API a tha air am mìneachadh gu h-ìosal:
   • HAL_RCC_OscConfig(): bidh an API seo a’ rèiteachadh na h-oscillators a-staigh agus a-muigh. Bidh an neach-cleachdaidh a’ taghadh
     rèiteachadh aon no a h-uile oscillators.
   • HAL_RCC_ClockConfig (): bidh an API seo a’ rèiteachadh stòr gleoc an t-siostaim, an latency cuimhne flash, agus na prescalers AHB agus APB.
5. Tòisich an iomall
   • An toiseach sgrìobh an gnìomh tòiseachaidh iomaill. Lean air adhart mar a leanas:
   • Dèan comas air an uaireadair iomaill.
   • Dèan rèiteachadh air na GPIOan iomaill.
   • Dèan rèiteachadh air an t-sianal DMA agus leig leis a’ bhriseadh DMA (ma tha feum air).
   • Dèan comas air a 'bhriseadh iomallach (ma tha feum air).
   • Deasaich an stm32xxx_it.c gus fios a chuir chun luchd-làimhseachaidh eadar-aghaidh a tha a dhìth (iomall agus DMA), ma tha feum air.
   • Sgrìobh pròiseas cuir crìoch air gnìomhan gairm air ais ma tha dùil gun tèid stad a chuir air iomall no DMA a chleachdadh.
   • Ann am prìomh neach-cleachdaidh.c file, cuir a-steach an structar làimhseachaidh iomaill agus an uairsin cuir fios gu gnìomh tòiseachaidh iomaill gus an iomall a thòiseachadh.
6. Leasaich tagradh
   Aig seo stage, tha an siostam deiseil agus faodaidh leasachadh còd tagraidh luchd-cleachdaidh tòiseachadh.
   Tha an HAL a’ toirt seachad APIan intuitive agus deiseil airson an cleachdadh gus an iomall a rèiteachadh. Bidh e a’ toirt taic do bhòtadh, brisidhean, agus modal prògramadh DMA, gus gabhail ri riatanasan tagraidh sam bith. Airson tuilleadh fiosrachaidh mu mar a chleachdas tu gach iomall, thoir sùil air an neach beairteach example seata air a thoirt seachad ann am Pasgan MCU STM32CubeWL3.

Rabhadh: Ann am buileachadh àbhaisteach HAL, thathas a’ cleachdadh an timer SysTick mar chlàr-ama: bidh e a’ gineadh brisidhean aig amannan cunbhalach. Ma thèid HAL_Delay () a ghairm bhon phròiseas ISR iomaill, dèan cinnteach gu bheil prìomhachas nas àirde aig a’ bhriseadh SysTick (àireamh nas ìsle) na am briseadh iomaill. Rud eile, tha pròiseas ISR an neach-fios air a bhacadh. Tha gnìomhan a tha a’ toirt buaidh air rèiteachaidhean clàr-ama air an ainmeachadh mar __lag gus faighinn seachad air gun fhios nach bi gnìomhan eile san neach-cleachdaidh file (a’ cleachdadh timer adhbhar coitcheann, airson example, no tùs uair eile). Airson tuilleadh fiosrachaidh, thoir sùil air an HAL_TimeBase example.

Iarrtas LL
Tha an roinn seo a’ toirt cunntas air na ceumannan a dh’fheumar gus tagradh LL àbhaisteach a chruthachadh a’ cleachdadh STM32CubeWL3.

1. Cruthaich pròiseact
   Gus pròiseact ùr a chruthachadh, tòisich an dàrna cuid bhon phròiseact Templates_LL a chaidh a sholarachadh airson gach bòrd fo \Projects\ \Templates_LL no o phròiseact sam bith a tha ri làimh fo \Projects\ \examples_ LL ( a’ toirt iomradh air ainm a’ bhùird, leithid NUCLEO-WL32CC33).
   Tha am pròiseact teamplaid a’ toirt seachad gnìomh prìomh lùb falamh, a tha na dheagh àite tòiseachaidh airson roghainnean pròiseict airson STM32CubeWL3 a thuigsinn. Tha na prìomh fheartan teamplaid mar a leanas:
   • Tha còdan stòr nan draibhearan LL agus CMSIS ann, a tha mar an seata as lugha de cho-phàirtean a dh’ fheumar gus an còd a leasachadh air bòrd sònraichte.
   • Tha na slighean ann airson na pàirtean firmware a tha a dhìth.
   • Bidh e a’ taghadh an inneal loidhne toraidh STM32WL3x le taic agus a’ ceadachadh rèiteachadh ceart nan draibhearan CMSIS agus LL.
   • Tha e a 'toirt seachad cleachdaiche deiseil airson a chleachdadh files a tha ro-shuidhichte mar a leanas:
   • main.h: còmhdach tarraing mìneachadh LED agus USER_BUTTON.
   • main.c: Rèiteachadh gleoc an t-siostaim airson an tricead as motha.
2. Port an LL example:
   • Dèan lethbhreac / pasg air pasgan Templates_LL - gus an tùs tùsail a chumail - no ùraich gu dìreach pròiseact Template s_LL a tha ann mu thràth.
   • An uairsin, tha an ion-phortadh gu ìre mhòr an àite Templates_LL files leis an Examples_LL pròiseact cuimsichte.
   • Cùm a h-uile pàirt den bhòrd sònraichte. Airson adhbharan soilleireachd, tha pàirtean sònraichte den bhòrd air an comharrachadh le sònraichte tags:
   • Mar sin, is iad na prìomh cheumannan tar-chuir:
   • Cuir an àite an stm32wl3x_it.h file.
   • Cuir an àite an stm32wl3x_it.c file.
   • Cuir an àite am prìomh.h file agus ùraich e: Cùm am mìneachadh LED agus putan cleachdaiche air an teamplaid LL fo rèiteachadh SÒNRAICHTE BÒRD tags.
   • Cuir an àite am prìomh.c file agus ùraich e:
   • Cùm rèiteachadh gleoc na h-obrach teamplaid SystemClock_Config() LL fo rèiteachaidhean SÒNRAICHTE BHOARD tags.
   • A rèir mìneachadh LED, cuir LDy eile an àite gach tachartas LDx a tha ri fhaighinn anns an file prìomh.h.
   • Leis na h-atharrachaidhean sin, tha an example a 'ruith air a' bhòrd cuimsichte.

Iarrtasan RF, taisbeanaidhean, agus examples
Diofar sheòrsan de thagraidhean RF, taisbeanaidhean, agus examptha les ri fhaighinn sa phasgan STM32CubeWL3.
Tha iad air an liostadh anns an dà earrann gu h-ìosal.

Fo-GHz examples agus taisbeanaidhean
Tha na seanamples a’ nochdadh prìomh fheartan peripherals rèidio MRSUBG agus LPAWUR. Tha na seanamptha les ri fhaighinn fo:

• Pròiseactan\NUCLEO-WL33CC\Examples\MRSUBG
• Pròiseactan\NUCLEO-WL33CC\Examples\LPAWUR
• Pròiseactan\NUCLEO-WL33CC\Demonstrations\MRSUBG
• Pròiseactan\NUCLEO-WL33CC\Demonstations\LPAWUR

Tha gach exampTha le no taisbeanadh mar as trice air a dhèanamh suas de dhà phrògram ris an canar Tx agus Rx ag obair mar inneal-sgaoilidh agus cuidhteas, fa leth:

Examples/MRSUBG

• MRSUBG_802_15_4: buileachadh an t-sreath chorporra a tha air a mhìneachadh le inbhe 802.15.4. Tha e a’ sealltainn mar a rèiticheas tu an rèidio gus pacaidean 802.15.4 a thar-chuir no fhaighinn.
• MRSUBG_BasicGeneric: Iomlaid de phasgan bunaiteach STM32WL3x MR_SUBG.
• MRSUBG_Chat: Iarrtas sìmplidh a sheallas mar a chleachdas tu Tx agus Rx air an aon inneal.
• MRSUBG_DatabufferHandler: Tha fear a bha roimheample a sheallas mar a nì thu iomlaid bho Databuffer 0 agus 1.
• MRSUBG_Sequencer AutoAck: example a bhios a’ tar-chuir agus a’ faighinn aithne pacaid (ACKn) gu fèin-ghluasadach.
• MRUBG_WMBusSTD: Iomlaid de theachdaireachdan WM-Bus.
• WakeupRadio: seannample gus deuchainn a dhèanamh air iomall rèidio LPAWUR.

Taisbeanaidhean/MRSUBG

• MRSUBG_RTC_Button_TX: Tha an t-seann seoample a ’sealltainn mar a shuidhicheas tu an SoC ann am modh stad domhainn agus an MRSUBG a rèiteachadh gus an SoC a dhùsgadh le bhith a’ putadh PB2 gus frèam a chuir no às deidh don timer RTC tighinn gu crìch.
• MRSUBG_Sequencer_Sniff: Tha an t-seann seoample a’ sealltainn mar a shuidhicheas tu an t-sreathadair MRSUBG gus obrachadh ann am modh sniff. Tha an t-example a’ taisbeanadh taobh an ghlacadair agus feumach air inneal eile mar inneal-sgaoilidh.
• MRSUBG_Timer: Bidh an aplacaid a’ clàradh grunn thursan de timer MRSUBG (le fèin-luchdachadh) le amannan eadar-dhealaichte.
• MRSUBG_WakeupRadio_Tx: Tha an t-seann seoample a’ mìneachadh mar a shuidhicheas tu an SoC ann am modh stad domhainn agus an MRSUBG a rèiteachadh gus an SoC a dhùsgadh le bhith a’ putadh PB2 gus frèam a chuir. Tha an t-example a’ nochdadh taobh an inneal-sgaoilidh agus feumach air inneal eile mar ghlacadair LPAWUR. Tha an neach-gabhail example suidhichte fon phasgan NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx.

Taisbeanaidhean/LPAWUR

• LPAWUR_WakeupRadio_Rx: Tha an t-seann seoample a ’mìneachadh mar a shuidhicheas tu an SoC ann am modh stad domhainn agus an LPAWUR a rèiteachadh gus an SoC a dhùsgadh nuair a ruigeas frèam agus a gheibhear gu ceart. Tha an t-example a’ taisbeanadh taobh an ghlacadair agus feumach air inneal eile mar inneal-sgaoilidh. Tha an inneal-sgaoilidh example suidhichte fon phasgan NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx.

Iarrtas Sigfox™
Bidh na tagraidhean sin a’ sealltainn mar a chuireas tu suidheachadh Sigfox ™ an gnìomh agus mar a chleachdas tu na APIan Sigfox ™ a tha rim faighinn. Tha iad rim faighinn ann an slighe a’ phròiseict Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: Tha an aplacaid seo a’ sealltainn mar a chleachdas tu eadar-aghaidh loidhne-àithne (CLI) gus òrdughan a chuir a chleachdas protocol Sigfox™ gus teachdaireachdan a chuir agus deuchainnean ro-theisteanas a dhèanamh.
• Sigfox_PushButton: Leigidh an aplacaid seo le measadh a dhèanamh air comasan rèidio inneal STM32WL33xx Sigfox ™. Le bhith a’ brùthadh PB1 bheir e seachad frèam deuchainn Sigfox ™.

Eachdraidh ath-sgrùdaidhean

Clàr 3. Eachdraidh ath-sgrùdadh sgrìobhainnean

Ceann-latha	Ath-sgrùdadh	Atharrachaidhean
29-Màrt-2024	1	Sgaoileadh tùsail.
30-Dàmhair-2024	2	Amalachadh iomlan de STM32CubeWL3 ann an STM32Cube. Ùraichte: •         Ro-ràdh •         Earrann 2: STM32CubeWL3 prìomh fheartan •         Earrann 3.2.1: Co-phàirtean meadhan-bathair •         Earrann 4: Pasgan firmware STM32CubeWL3 thairisview •         Earrann 5.1: A’ ruith a’ chiad example •         Earrann 5.3: Iarrtasan RF, taisbeanaidhean, agus examples Air a chur ris: •         Earrann 5.1.1: Mar a ruitheas tu HAL example •         Earrann 5.2.1: A’ cleachdadh STM32CubeMX gus tagradh a leasachadh no ùrachadh • SEarrann 6.4: A bheil pròiseact teamplaid sam bith ann airson MRUBG/LPAWUR peripheral exampnas lugha? •         Earrann 6.5: Ciamar as urrainn do STM32CubeMX còd a ghineadh stèidhichte air bathar-bog freumhaichte? Air a thoirt air falbh: •         Innealan PC, a 'gabhail a-steach Navigator, STM32WL3 GUI, agus GUI Sequencer MR-SUBG •         Ciamar as urrainn do WiSE-Studio IOMapper còd a ghineadh stèidhichte air bathar-bog freumhaichte? •         A bheil Navigator a’ toirt cothrom air goireasan pacaid bathar-bog?
22-Faoilleach-2025	3	Leudaich an raon de dh'innealan iomchaidh gu microcontrollers STM32WL30xx agus STM32WL31xx ann an Clàr 1. Macros airson loidhne toraidh STM32WL3x.

FIOSRACHADH CUDROMACH - Leugh gu faiceallach

• Tha STMicroelectronics NV agus na fo-chompanaidhean (“ST”) a’ gleidheadh ​​na còrach atharrachaidhean, ceartachaidhean, leasachaidhean, atharrachaidhean agus leasachaidhean a dhèanamh air toraidhean ST agus/no air an sgrìobhainn seo aig àm sam bith gun rabhadh. Bu chòir do luchd-ceannach am fiosrachadh buntainneach as ùire fhaighinn mu thoraidhean ST mus cuir iad òrdughan. Bithear a’ reic thoraidhean ST a rèir teirmichean is cumhaichean reic ST a tha nan àite aig àm aithneachaidh an òrduigh.
• Tha uallach air luchd-ceannach a-mhàin airson taghadh, taghadh agus cleachdadh thoraidhean ST agus chan eil ST a’ gabhail uallach sam bith airson taic tagraidh no dealbhadh thoraidhean ceannaichean.
• Chan eil cead, soilleir no so-thuigsinn, airson còir seilbh inntleachdail sam bith air a thoirt seachad le ST an seo.
• Bidh ath-reic thoraidhean ST le ullachaidhean eadar-dhealaichte bhon fhiosrachadh a tha air a mhìneachadh an seo a’ falmhachadh barantas sam bith a thug ST airson a leithid de thoradh.
• Tha ST agus suaicheantas ST nan comharran-malairt de ST. Airson fiosrachadh a bharrachd mu chomharran-malairt ST, thoir sùil air www.st.com/trademarks. Is ann leis an luchd-seilbh aca a tha a h-uile ainm toraidh no seirbheis eile.
• Tha fiosrachadh san sgrìobhainn seo a’ dol an àite agus a’ dol an àite fiosrachadh a chaidh a thoirt seachad roimhe seo ann an dreachan sam bith den sgrìobhainn seo.
• © 2025 STMicroelectronics – Gach còir glèidhte

Ceistean Cumanta

Cuin a bu chòir dhomh HAL a chleachdadh an àite draibhearan LL?

Bidh draibhearan HAL a’ tabhann APIan àrd-ìre agus gnìomh, le ìre àrd de chomas giùlain. Tha iom-fhillteachd toraidh no iomaill falaichte airson luchd-cleachdaidh deireannach. Bidh draibhearan LL a’ tabhann APIan ìre clàraidh ìre ìosal le optimization nas fheàrr ach nas lugha so-ghiùlain. Feumaidh iad eòlas domhainn air mion-chomharrachadh toraidh no IP.

Ciamar a tha APIan tòiseachaidh LL air an comasachadh?

Tha am mìneachadh air APIan tòiseachaidh LL agus structairean ghoireasan co-cheangailte riutha, litrichean agus prototypes air an suidheachadh leis an tionndadh cruinneachaidh USE_FULL_LL_DRIVER. Gus a bhith comasach air APIan tòiseachaidh LL a chleachdadh, cuir an tionndadh seo ann an ro-phròiseas cruinneachaidh inneal-inneal.

A bheil pròiseact teamplaid sam bith ann airson MRSUBG / LPAWUR peripheral exampnas lugha?

Gus MRSUBG no LPAWUR ex ùr a chruthachadhample pròiseact, an dàrna cuid tòiseachadh bhon phròiseact cnàimhneach a chaidh a thoirt seachad fo Ph ojectsNUCLEO- 33CC Examples MRSUBG no PròiseactanNUCLEO-WL33CC Examples LPAWUR no bho phròiseact sam bith a tha ri fhaighinn fo na h-aon eòlairean sin.

Ciamar as urrainn do STM32CubeMX còd a ghineadh stèidhichte air bathar-bog freumhaichte?

Tha eòlas stèidhichte aig STM32CubeMX air microcontrollers STM32, a’ toirt a-steach an iomaill agus am bathar-bog, a leigeas leis riochdachadh grafaigeach a thoirt don neach-cleachdaidh agus gineadh .h no .c files stèidhichte air rèiteachadh an neach-cleachdaidh.

Sgrìobhainnean/Goireasan

Microcontrollers ST STM32WL3x [pdfLeabhar-làimhe an neach-cleachdaidh Microcontrollers STM32WL3x, STM32WL3x, microcontrollers

Iomraidhean

• Leabhar-làimhe cleachdaiche