STM32WL3x Microcontrollers

Nga Tohutohu Whakamahi Hua

• Kei roto i te kete STM32CubeWL3 nga API papa-iti (LL) me te paparanga tango taputapu (HAL) e kapi ana i te taputapu moroiti.
• Kei te whakarato ano i nga waahanga waenga penei i te SigfoxTM, FatFS, me te FreeRTOS kernel.
• Ka tae mai te kete me te exampnga tono me nga tono kia ngawari te whakatinana.
• Ko te hoahoanga STM32CubeWL3 he mea hanga huri noa i nga taumata e toru: Nga tono, HAL, me te LL.
• Ko te HAL me te LL API e kapi ana i te whānuitanga o nga whakaritenga tono.
• Ko te HAL e tuku ana i te whakamahinga o te papamuriamples, a ka whakaratohia e te LL nga mahinga taumata-iti.
• Kei roto i tenei taumata ko te Poari Tautoko Poari (BSP) me nga taapiri HAL.
• Ka tukuna e te BSP nga API mo nga waahanga taputapu i runga i nga papa, ko te HAL e whakarato ana i nga whakamahinga o muaamples.
• Ko nga taraiwa BSP e hono ana i nga taraiwa waahanga ki nga papa motuhake, kia ngawari ai te kawe ki etahi atu taputapu.
• Ko te STM32CubeWL3 HAL me te LL he taapiri, e kapi ana i te whānuitanga o nga whakaritenga tono.
• Ka taea e nga kaiwhakamahi te whakamahi i enei API kia pai ai te taunekeneke me te taputapu microcontroller.

Kupu Whakataki

Ko te STM32Cube he kaupapa taketake STMicroelectronics hei whakapai ake i te hua o nga kaihoahoa ma te whakaiti i te whakapau kaha, te wa me te utu. Ko te STM32Cube te kapi katoa o te kōpaki STM32. STM32Cube kei roto:

STM32Cube kei roto:

• He huinga taputapu whanaketanga rorohiko pai-kaiwhakamahi hei kapi i te whanaketanga kaupapa mai i te whanautanga ki te whakatutukitanga, i roto i enei ko:
  • STM32CubeMX, he taputapu whirihoranga raupaparorohiko whakairoiro e taea ai te hanga aunoa o te waehere arawhiti C ma te whakamahi i nga ruānuku whakairoiro.
  • STM32CubeIDE, he taputapu whanaketanga katoa-i-kotahi me te whirihoranga papaahuri, te whakaputa waehere, te whakahiato waehere, me nga ahuatanga patuiro
  • STM32CubeCLT, he taputapu whanaketanga raina whakahau-katoa-i roto i te-kotahi me te whakahiato waehere, te whakatakotoranga poari, me nga ahuatanga patuiro.
  • STM32CubeProgrammer (STM32CubeProg), he taputapu hotaka e waatea ana i roto i nga putanga whakairoiro me te raina whakahau.
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), taputapu aroturuki kaha ki te whakatika i te whanonga me te mahi o nga tono STM32 i roto i te waa tuuturu
• STM32Cube MCU me MPU Packages, matawhānui tüäpapa-rorohiko whakauru motuhake mo ia raupapa microcontroller me te microprocessor (pēnei i te STM32CubeWL3 mo te raina hua STM32WL3x), kei roto:
  • Paparanga tangohanga taputapu STM32Cube (HAL), e whakarite ana kia nui ake te kawe puta noa i te kōpaki STM32
  • Ko nga API papa-iti STM32Cube, e whakarite ana i nga mahi tino pai me nga tapuwae me te mana whakahaere a te kaiwhakamahi ki nga taputapu.
  • He huinga riterite o nga waahanga middleware penei i te pata FreeRTOS™, FatFS, me Sigfox™
  • Ko nga taputapu rorohiko whakauru katoa me nga huinga katoa o te waahi me te tono o muaamples
• STM32Cube Expansion Packages, kei roto nga waahanga rorohiko kua whakauruhia hei whakakii i nga mahi o te STM32Cube MCU me te MPU Packages me:
  • Nga toronga Middleware me nga paparanga tono
  • Exampe rere ana i runga i etahi papa whanaketanga STMicroelectronics motuhake
• Ko tenei pukapuka kaiwhakamahi e whakaatu ana me pehea te tiimata me te STM32CubeWL3 MCU Package.

Ko te Wāhanga 2 e whakamārama ana i ngā āhuatanga matua o STM32CubeWL3 me te Wāhanga 3 e whakarato ana i te mutungaview o tona hoahoanga me te hanganga MCU Package.

Nga korero whanui

• STM32CubeWL3 ka whakahaere i nga tono whakaaturanga iti-GHz, tae atu ki nga rua Sigfox™, i runga i nga miihini miihini raina hua STM32WL3x i runga i te tukatuka Arm® Cortex®‑M0+.
• Ko nga microcontrollers STM32WL3x te whakauru i te papanga reo irirangi RF sub-GHz hou a STMicroelectronics, kua arotauhia mo te whakapau hiko-iti-iti me te mahi reo irirangi pai, mo te roanga o te pākahiko.

Tuhipoka: He tohu rehita a Arm na Arm Limited (me ona apiti ranei) i te US me/ranei i etahi atu waahi.

STM32CubeWL3 nga waahanga matua

• Ko te STM32CubeWL3 MCU Package e rere ana i runga i te STM32 32-bit microcontrollers i runga i te tukatuka Arm® Cortex®‑M0+. Ka kohia e ia, i roto i te kete kotahi, nga waahanga rorohiko whakauru katoa e hiahiatia ana hei whakawhanake i tetahi tono mo te STM32WL3x raina hua microcontrollers.
• Kei roto i te kete nga API papa-iti (LL) me te paparanga tangohanga taputapu (HAL) e kapi ana i te taputapu microcontroller, me te huinga o mua.ampe rere ana i runga i nga papa STMicroelectronics. Kei te waatea nga API HAL me LL i roto i te raihana BSD puna tuwhera mo te waatea o te kaiwhakamahi. Kei roto ano hoki nga waahanga Sigfox™, FatFS, me FreeRTOS™ kernel middleware.
• Ko te STM32CubeWL3 MCU Package hoki e whakarato ana i nga tono me nga whakaaturanga e whakatinana ana i ona waahanga waenga.
• Ko te tahora waahanga STM32CubeWL3 MCU Package e whakaatuhia ana i te Whakaahua 1.

STM32CubeWL3 hoahoanga kua mutuview

• Ko te otinga STM32CubeWL3 MCU Package he mea hanga huri noa i nga taumata motuhake e toru e ngawari ana te taunekeneke pera i te whakaahuatanga i te Whakaahua 2.

Taumata 0
Kua wehea tenei taumata kia toru nga paparanga iti:

• Te putea tautoko a te poari (BSP).
• Papanga tangohanga taputapu (HAL):
  • HAL taraiwa peripheral
  • Nga taraiwa papa-iti
• Whakamahinga papaaapapa taketake examples.

Mōkihi tautoko poari (BSP)
Ka tukuna e tenei paparanga he huinga API e pa ana ki nga waahanga taputapu i roto i nga papa taputapu (penei i nga LED, nga paatene, me nga taraiwa COM). E rua nga waahanga kei roto:

Wae:

• Ko te taraiwa tenei e pa ana ki te taputapu o waho i runga i te poari, kaua ki te STM32. Ka whakaratohia e te taraiwa wae etahi API motuhake ki te taraiwa BSP nga waahanga o waho ka taea te kawe i runga i tetahi atu papa.
  • taraiwa BSP:
• Ka taea e ia te hono i nga taraiwa waahanga ki tetahi poari motuhake me te whakarato i te huinga o nga API pai-kaiwhakamahi. Ko te ture whakaingoa API ko BSP_FUNCT_Action().
• Example: BSP_LED_Init(), BSP_LED_On()

Ko te BSP i ahu mai i te hoahoanga whakaraerae e taea ai te tauranga ngawari ki runga i nga taputapu ma te whakamahi noa i nga mahinga taumata-iti.

Papanga tangohanga taputapu (HAL) me te papa-iti (LL)

Ko te STM32CubeWL3 HAL me te LL he taapiri me te kapi i te whānuitanga o nga whakaritenga tono:

• Ko nga taraiwa HAL e tuku ana i nga API tino kawe-nui-a-te-mahi. Ka huna e ratou te MCU me te uaua o te taha ki te kaiwhakamahi mutunga.
  Ko nga taraiwa HAL e whakarato ana i nga API maha-a-ahua-ahuatanga-a-ahua, e whakamaarama ana i te whakatinanatanga tono a te kaiwhakamahi ma te whakarato i nga tikanga rite-ki-te whakamahi. Mo te example, mo nga taputapu whakawhitiwhiti (I2C, UART, me etahi atu), ka whakarato i nga API e tuku ana i te arataki me te whirihora i te waahi, te whakahaere i te whakawhiti raraunga i runga i te pooti, ​​te aukati, te tukanga DMA ranei, me te whakahaere i nga hapa korero ka puta ake i te wa o te whakawhitiwhiti korero. Ko nga API taraiwa HAL kua wehea kia rua nga waahanga:
  • Ko nga API whanui, e whakarato ana i nga mahi noa me nga mahi whanui ki nga miihini miihini STM32 raupapa katoa.
  • Ko nga API Toronga, e whakarato ana i nga mahi motuhake me te whakarite mo tetahi whanau motuhake, he nama waahanga motuhake ranei.
• Ko nga API papa-iti e whakarato ana i nga API taumata-iti i te taumata rehita, me te pai ake o te arotau engari he iti ake te kawe.
  Ka hiahia ratou ki te mohio hohonu mo te MCU me nga tohu taapiri.
  Ko nga taraiwa LL i hangaia ki te tuku i tetahi paparanga maamaa tere, he paparanga tohunga e tata atu ana ki te taputapu atu i te HAL. He rereke ki te HAL, karekau nga API LL e whakaratohia mo nga taputapu taapiri kaore he waahanga matua mo te urunga pai, mo te hunga e hiahia ana ki te whirihoranga raupaparorohiko taumaha, ki te taapiri taumata teitei ranei.
  Ko nga taraiwa LL e whakaatu ana:
• He huinga mahi hei arawhiti i nga ahuatanga matua peripheral i runga i nga tawhā kua tohua i roto i nga hanganga raraunga.
• He huinga mahi hei whakaki i nga hanganga raraunga arawhiti me nga uara tautuhi e rite ana ki ia mara.
• Taumahi mo te whakamaaramatanga-a-te-a-roto (kua whakahokia nga rehita taiapa ki o raatau uara taunoa).
• He huinga mahi roraina mo te urunga rehita tika me te rehita ngota.
• Te tino motuhake mai i te HAL me te kaha ki te whakamahi i te aratau tuuturu (kaore he taraiwa HAL).
• Katoa te kapi o nga ahuatanga peripheral e tautokohia ana.

Whakamahinga papaaapapa taketake examples
Ko tenei paparanga e mau ana i te exampi hangaia i runga i nga taputapu STM32 ma te whakamahi i nga rauemi HAL me BSP anake.
Tuhipoka: Whakaaturanga exampKei te waatea hoki nga korero ki te whakaatu i nga mea uaua akeampnga ahuatanga me nga taputapu motuhake, penei i te MRSUBG me te LPAWUR.

Taumata 1
Kua wehea tenei taumata kia rua nga paparanga iti:

• Waehanga Waenganui
• Examples i runga i nga waahanga middleware

Waehanga Waenganui
Ko te middleware he huinga whare pukapuka e kapi ana i te pata FreeRTOS™, FatFS, me te whare pukapuka kawa Sigfox™.
Ko te taunekeneke whakapae i waenga i nga waahanga o tenei paparanga ka mahia ma te karanga i nga API kua whakaatuhia.
Ko te taunekeneke poutū me nga taraiwa papa-iti ka mahia ma roto i nga hokiwaea motuhake me nga tonotono pateko kua whakatinanahia ki te atanga waea punaha whare pukapuka.
Ko nga ahuatanga matua o ia waahanga middleware e whai ake nei:

• FreeRTOS ™ kernel: ka whakatinana i te punaha whakahaere-waahi (RTOS), i hangaia mo nga punaha whakauru.
• Sigfox™: ka whakatinana i te whare pukapuka kawa Sigfox™ e rite ana ki te whatunga kawa Sigfox™ me te whakauru i te whare pukapuka kawa whakamatautau RF hei whakamatautau ki nga taputapu RF Sigfox™.
• FatFS: whakatinana i te FAT whānui file kōwae pūnaha.

Examples i runga i nga waahanga middleware

• Ka tae mai ia wae middleware me tetahi, neke atu ranei o muaamples, e kiia ana ko nga tono, e whakaatu ana me pehea te whakamahi.
• Whakauru exampKo nga mea e whakamahi ana i te maha o nga waahanga waenga ka whakaratohia ano hoki.

STM32CubeWL3 mōkihi mārō kua mutuview

Ka tautokohia nga taputapu me nga taputapu STM32WL3x

• STM32Cube tuku he paparanga tangohanga taputapu tino kawe (HAL) i hangaia huri noa i te hoahoanga whanui. Ka taea e ia te maapono o te hanga-i runga i nga paparanga, penei i te whakamahi i te paparanga waenga ki te whakatinana i o raatau mahi me te kore e mohio, hohonu, he aha te MCU e whakamahia ana. Ma tenei ka pai ake te whakamahinga o te waehere whare pukapuka me te whakarite kia ngawari te kawe ki etahi atu taputapu.
• I tua atu, me ona hoahoanga paparanga, STM32CubeWL3 he tautoko katoa mo nga raina hua STM32WL3x katoa.
• Me tautuhi te kaiwhakamahi i te tonotono tika i stm32wl3x.h.
• Ko te Ripanga 1 e whakaatu ana i te tonotono hei tautuhi i runga i te taputapu raina hua STM32WL3x i whakamahia. Me tautuhi ano hoki tenei tonotono i roto i te kaitukatuka o mua.

Ripanga 1. Tonotono mo te raina hua STM32WL3x

Tonotono kua tautuhia ki STM32WL3X.h	STM32WL3x nga taputapu raina hua
stm32wl3x	STM32WL30xx microcontrollers STM32WL31xx microcontrollers STM32WL33xx microcontrollers

Ripanga 2. Nga papa mo te raina hua STM32WL3x

Poari	STM32WL3x papaa tautoko nga taputapu
NUCLEO-WL33CC1	STM32WL33CC
NUCLEO-WL33CC2	STM32WL33CC

Ka taea e te STM32CubeWL3 MCU Package te whakahaere i runga i nga taputapu hototahi. Ka whakahouhia e nga kaiwhakamahi nga taraiwa BSP ki te tauranga i te ex kua whakaratohiaampi runga i o raatau papa, mena he rite nga ahuatanga o enei taputapu (penei i nga rama rama, patene ranei).

Ka mutu te kete firmwareview

• Ko te otinga STM32CubeWL3 MCU Package e whakaratohia ana i roto i te kete kotahi, me te hanganga e whakaatuhia ana i te Whakaahua 3.

Tupato: Kaua te kaiwhakamahi e whakarereke i nga waahanga files. Ka taea e te kaiwhakamahi te whakatika i nga \Mapuna Kaupapa. Mo ia papa, he huinga exampKa whakaratohia nga kaupapa me nga kaupapa kua oti te whakarite mo nga mekameka taputapu EWARM, MDK-ARM, me STM32CubeIDE.
Ko te ahua 4 e whakaatu ana i te hanganga kaupapa mo nga papa NUCLEO-WL33CCx.

Ko te exampKa whakarōpūhia nga mea i runga i te taumata STM32CubeWL3 e pa ana ki a raatau. Ko enei e whai ake nei:

• Taumata 0 exampe kiia ana ko Examples, Examples_LL, me Exampiti_MIX. Ka whakamahia e ratou nga taraiwa HAL, nga taraiwa LL, me te ranunga o nga taraiwa HAL me te LL kaore he waahanga waenga. Whakaaturanga exampKei te waatea hoki nga rei.
• Taumata 1 exampka kiia ko nga tono. Ka whakaratohia e ratou nga keehi whakamahi angamaheni o ia waahanga waenga.

Ka taea te hanga i tetahi tono firmware mo te poari kua whakaritea ma te whakamahi i nga kaupapa tauira e waatea ana i roto i nga raarangi Templates and Templates_LL.
Examples, Examples_LL, me ExampHe rite tonu te hanganga a les_MIX:

• \Inc kōpaki kei roto katoa te pane files.
• \Src kōpaki kei roto te waehere puna.
• \EWARM, \MDK-ARM, me \STM32CubeIDE kōpaki kei roto te kaupapa kua whirihorahia mo ia mekameka taputapu.
• readme.md me readme.html e whakaahua ana i te exampte whanonga me te taiao e hiahiatia ana kia pai ai.

Te tiimata me te STM32CubeWL3

Te whakahaere i te ex tuatahiample
Ko tenei waahanga e whakamarama ana i te ngawari o te whakahaere i tetahi o muaampi roto i te STM32CubeWL3. Ka whakamahia hei whakaahuatanga te whakatipuranga o te takahuri LED ngawari e rere ana i runga i te papa NUCLEO-WL33CC1:

1. Tangohia te STM32CubeWL3 MCU Package.
2. Wewetehia, ka whakahaere ranei i te kaiwhakauru mena ka tukuna, ki roto i te raarangi e pai ana koe.
3. Me whakarite kia kaua e whakarereketia te hanganga o te kete e whakaatuhia ana i te Whakaahua 3. STM32CubeWL3 te hanganga mokihi firmware. Kia mahara ka tūtohu ano kia kapehia te kete ki te waahi tata ki te rōrahi pakiaka (te tikanga ko C:\ST ko G:\Whakamātautau), i te mea ka raru etahi IDE ina he roa rawa te huarahi.

Me pehea te whakahaere i te HAL example
I mua i te uta me te whakahaere i te exampe, e tino tūtohu ana ki te pānui i te exampte panui file mo tetahi whirihoranga motuhake.

1. Tirotiro ki \Projects\NUCLEO-WL33CC\Examples.
2. Whakatuwheratia te \GPIO, ka \GPIO_EXTI kōpaki.
3. Whakatuwheratia te kaupapa me te mekameka taputapu pai. He tereview me pehea te whakatuwhera, te hanga, me te whakahaere i te example me nga mekameka taputapu tautoko kei raro nei.
4. Hangaia katoa files ka utaina te atahanga ki roto i te mahara kua whakaritea.
5. Whakahaerehia te example. Mo etahi atu korero, tirohia te exampte panui file.

Hei whakatuwhera, hanga, me te whakahaere i te exampme ia o nga mekameka taputapu tautoko, whai i nga taahiraa i raro nei:

• EWARM:
  1. I raro i te Examples kōpaki, whakatuwheratia te \EWARM kōpakiroto.
  2. Whakarewahia te mokowāmahi Project.eww (kei te huri pea te ingoa mokowāmahi mai i tetahi exampki tetahi atu).
  3. Hangaia katoa files: [Kaupapa]>[Hangaia katoa].
  4. Utaina te atahanga kaupapa: [Kaupapa]>[Debug].
  5. Whakahaerehia te papatono: [Debug]>[Haere (F5)].
• MDK-ARM:
  1. I raro i te Exampi te kōpaki, whakatuwheratia te \MDK-ARM kōpakiroto.
  2. Whakatuwheratia te mokowāmahi Project.uvproj (kei te huri pea te ingoa mokowāmahi mai i tetahi exampki tetahi atu).
  3. Hangaia katoa files: [Kaupapa]>[Hangaia nga whaainga katoa files].
  4. Utaina te ahua o te kaupapa: [Debug]>[Tīmata/Kati te Wātū Whakairo].
  5. Whakahaerehia te papatono: [Debug]>[Run (F5)].
• STM32CubeIDE:
  1. Whakatuwheratia te mekameka taputapu STM32CubeIDE.
  2. Patohia te [File]>[Whakawhiti Mokowāmahi]>[Atahi atu] ka tirotiro ki te raarangi mokowāmahi STM32CubeIDE.
  3. Patohia te [File]>[Kawemai], tohua [General]>[Tumahi o mua ki te Mokowāmahi], ka paato i te [Next].
  4. Tirotiro ki te raarangi mokowāmahi STM32CubeIDE ka kowhiri i te kaupapa.
  5. Hangaia te kaupapa katoa files: Tīpakohia te kaupapa ki te matapihi Project Explorer ka paato i te tahua [Kaupapa]>[Hanga kaupapa].
  6. Whakahaerehia te papatono: [Run]>[Debug (F11)].

Te whakawhanake tono ritenga

Ma te whakamahi i te STM32CubeMX hei whakawhanake, hei whakahou ranei i tetahi tono

• I roto i te STM32Cube MCU Package, tata katoa kaupapa exampKa hangaia nga mea ki te taputapu STM32CubeMX hei arawhiti i te punaha, nga papaahuri, me nga taputapu waenga.

Te whakamahi tika i tetahi kaupapa o muaampmai i te taputapu STM32CubeMX me STM32CubeMX 6.12.0 teitei ake ranei:

• I muri i te whakaurunga o STM32CubeMX, whakatuwherahia, a, mehemea e tika ana, whakahouhia he kaupapa e whakaarohia ana.
  Ko te huarahi ngawari ki te whakatuwhera i tetahi kaupapa o naianei ko te paato-rua i te *.ioc file kia whakatuwhera aunoa a STM32CubeMX i te kaupapa me tona puna files. Ka hangaia e STM32CubeMX te waehere puna arawhiti o aua kaupapa.
• Ko te waehere puna tono matua kei roto i nga korero "USER CODE BEGIN" me te "USER CODE END". Mena ka whakarereketia te kowhiringa me nga tautuhinga taapiri, ka whakahouhia e STM32CubeMX te wahanga arawhiti o te waehere i te wa e pupuri ana i te waehere puna tono matua.
• Hei whakawhanake i tetahi kaupapa ritenga me STM32CubeMX, whai i te tukanga taahiraa-i-te-taahiraa:
  1. Whirihorahia nga rorohiko whakauru katoa e hiahiatia ana ma te whakamahi i te kai whakaoti paopao-pinout, he kaiawhina i te karaka-rakau, he tatau kai hiko, me te taputapu e mahi ana i te whirihoranga papaa MCU (pēnei i te GPIO, te USART ranei).
  2. Waihangahia te waehere C arawhiti i runga i te whirihoranga kua tohua. Kua reri tenei waehere ki te whakamahi i roto i nga taiao whanaketanga maha. Ka mau te waehere kaiwhakamahi ki te reanga waehere e whai ake nei.
     Mo etahi atu korero mo STM32CubeMX, tirohia te pukapuka kaiwhakamahi STM32CubeMX mo te whirihoranga STM32 me te whakangao waehere C (UM1718).

Nga tono taraiwa
tono HAL
Ko tenei waahanga e whakaatu ana i nga waahanga e hiahiatia ana hei hanga tono HAL ritenga ma te whakamahi i te STM32CubeWL3

1. Waihangahia he kaupapa
   Hei waihanga kaupapa hou, timata mai i te kaupapa Tauira kua whakaratohia mo ia papa i raro i te \Projects\ \Tairaira mai i tetahi kaupapa e waatea ana i raro i te \Projects\ \Examples ranei \Proj ects\ \Nga tono (kei hea e tohu ana ki te ingoa o te poari).
   Ko te kaupapa Tauira e whakarato ana i te mahinga kopiko matua putua. Heoi, he timatanga pai ki te mohio ki nga tautuhinga kaupapa STM32CubeWL3. Kei te tauira nga ahuatanga e whai ake nei:
   • Kei roto ko te waehere puna HAL, CMSIS, me nga taraiwa BSP, ko te waahanga iti rawa o nga waahanga e hiahiatia ana hei whakawhanake i tetahi waehere ki runga i te papa.
   • Kei roto nga huarahi whakauru mo nga waahanga firmware katoa.
   • Ka tautuhia nga taputapu raina hua STM32WL3x e tautokohia ana, ka taea te whirihora tika i nga taraiwa CMSIS me HAL.
   • Ka whakarato i te kaiwhakamahi rite-ki-te whakamahi files kua whirihorahia pera i raro nei:
   • I arawhitia te HAL me te turanga wa taunoa me te Arm® matua SysTick.
   • SysTick ISR i whakatinanahia mo te kaupapa HAL_Delay().
   • Kia mahara: I te kape i tetahi kaupapa o mua ki tetahi atu waahi, me mohio kei te whakahouhia nga huarahi katoa.
2. Whirihorahia nga waahanga firmware
   Ko nga waahanga HAL me nga waewaenga e tuku ana i te huinga o nga whiringa whirihoranga wa-hanga ma te whakamahi i nga tonotono #define i whakapuakihia i roto i te pane. file. He whirihoranga tauira file kei roto i ia waahanga, me kape ki te kōpaki kaupapa (te nuinga o te whirihoranga file ko te ingoa ko xxx_conf_template.h, te kongakonga
   • me tango te tauira ina kapea ki te kōpaki kaupapa). Te whirihoranga file he nui nga korero kia mohio ai koe ki te paanga o ia whiringa whirihoranga. Kei te waatea nga korero mo nga korero mo ia waahanga.
3. Tīmatahia te whare pukapuka HAL
   Whai muri i te peke ki te kaupapa matua, me waea te waehere tono ki te HAL_Init() API ki te arawhiti i te whare pukapuka HAL, e kawe ana i nga mahi e whai ake nei:
   • Te whirihoranga o te mahara flash tomua me te SysTick haukoti kaupapa matua (na roto i nga tonotono kua tautuhia ki stm32 wl3x_hal_conf.h).
   • Whirihoranga o te SysTick ki te whakaputa i te haukoti ia milihakona i te kaupapa matua haukoti SysTick TICK_INT_PRIO kua tautuhia ki stm32wl3x_hal_conf.h.
   • Te whakarite i te kaupapa matua o te roopu NVIC ki te 0.
   • Waea o HAL_MspInit() taumahi hokinga mai kua tautuhia ki te kaiwhakamahi stm32wl3x_hal_msp.c file ki te mahi i te arataki taputapu taumata-iti o te ao.
4. Whirihorahia te karaka punaha
   Ka mahia te whirihoranga karaka punaha ma te waea atu ki nga API e rua e whakaahuatia ana i raro nei:
   • HAL_RCC_OscConfig(): ka whirihorahia e tenei API nga oscillator o roto me waho. Ka whiriwhiri te kaiwhakamahi
     whirihora i tetahi oscillators katoa ranei.
   • HAL_RCC_ClockConfig(): whirihorahia e tenei API te puna karaka punaha, te roanga mahara kohiko, me nga AHB me te APB prescalers.
5. Arawhiti i te papamuri
   • Tuhia tuatahi te mahi arawhiti peripheral. Haere penei:
   • Whakahohehia te karaka taha.
   • Whirihorahia nga GPIO peripheral.
   • Whirihorahia te hongere DMA ka taea te aukati DMA (mehemea ka hiahiatia).
   • Whakahohehia te haukoti peripheral (ki te hiahiatia).
   • Whakatikahia te stm32xxx_it.c ki te waea atu ki nga kaikawe haukoti e hiahiatia ana (te taha me te DMA), mena ka hiahiatia.
   • Tuhia nga mahi waea whakahoki katoa ki te mea ka whakamahia he haukoti peripheral, DMA ranei.
   • Kei te matua kaiwhakamahi.c file, arawhiti te hanganga kakau peripheral ka karanga i te mahi arawhiti peripheral ki te arawhiti i te peripheral.
6. Whakawhanakehia he tono
   I tenei stage, kua reri te punaha, ka timata te whanaketanga waehere tono kaiwhakamahi.
   Ko te HAL e whakarato ana i nga API mohio me te rite-ki-te whakamahi hei whirihora i te peripheral. E tautoko ana i te pooti, ​​i te haukoti, me te tauira hotaka DMA, hei whakatutuki i nga whakaritenga tono. Mo etahi atu korero mo te whakamahi i ia peripheral, tirohia te taonga o muaampte huinga e whakaratohia ana i roto i te STM32CubeWL3 MCU Package.

Tupato: I roto i te whakatinanatanga HAL taunoa, ka whakamahia te taima SysTick hei turanga waahi: ka puta he haukoti i nga waa waahi. Mēnā ka karangahia te HAL_Delay() mai i te hātepe ISR peripheral, me whakarite he kaupapa matua teitei ake te haukoti SysTick (he iti ake te nama) i te haukoti peripheral. Ki te kore, ka aukatihia te tukanga ISR kaiwaea. Ko nga mahi e pa ana ki nga whirihoranga papa-waahi ka kiia he __ngoikore kia taea ai te whakakore i etahi atu whakatinanatanga i roto i te kaiwhakamahi file (ma te whakamahi i te taima kaupapa whanui, hei tauiraample, tetahi atu puna wa ranei). Mo etahi atu korero, tirohia te HAL_TimeBase example.

tono LL
Ko tenei waahanga e whakaatu ana i nga waahanga hei hanga i tetahi tono LL ritenga ma te whakamahi i te STM32CubeWL3.

1. Waihangahia he kaupapa
   Hei waihanga kaupapa hou, me timata mai i te kaupapa Templates_LL kua whakaratohia mo ia papa i raro i te \Projects\ \Templates_LL mai i tetahi kaupapa e waatea ana i raro i te \Projects\ \Exampiti_ LL ( e tohu ana ki te ingoa o te poari, penei i te NUCLEO-WL32CC33).
   Ko te kaupapa tauira e whakarato ana i te mahi putunga matua, he timatanga pai ki te mohio ki nga tautuhinga kaupapa mo STM32CubeWL3. Ko nga ahuatanga matua o te tauira e whai ake nei:
   • Kei roto ko nga waehere puna o nga taraiwa LL me CMSIS, ko te huinga iti rawa o nga waahanga e hiahiatia ana hei whakawhanake i te waehere ki runga i te papa.
   • Kei roto nga huarahi whakauru mo nga waahanga firmware katoa e hiahiatia ana.
   • Ka tohua e ia te taputapu raina hua STM32WL3x e tautokohia ana, ka taea te whirihoranga tika o nga taraiwa CMSIS me LL.
   • E whakarato ana i te kaiwhakamahi rite-ki-te whakamahi files kua whirihora i mua e whai ake nei:
   • main.h: LED me USER_BUTTON paparanga tangohanga whakamārama.
   • main.c: Te whirihoranga karaka punaha mo te auau teitei.
2. Tauranga te LL example:
   • Tārua/whakapiri te kōpaki Templates_LL – hei pupuri i te puna tuatahi – whakahōu tika rānei i tētahi kaupapa Tauira s_LL.
   • Na, ko te tauranga ko te whakakapi i a Templates_LL files na te Examples_LL kaupapa kua whakaritea.
   • Kia mau ki nga waahanga motuhake o te papa. Mo nga take o te marama, ka tohuhia nga waahanga motuhake o te papa ki te tohu motuhake tags:
   • Na, ko nga waahanga matua o te tauranga e whai ake nei:
   • Whakakapihia te stm32wl3x_it.h file.
   • Whakakapihia te stm32wl3x_it.c file.
   • Whakakapia te matua.h file me te whakahōu: Pupurihia te whakamaramatanga o te rama rama me te patene kaiwhakamahi o te tauira LL i raro i te WHAKATAURANGA PAPU. tags.
   • Whakakapia te matua.c file me te whakahou ake:
   • Puritia te whirihoranga karaka o te mahinga tauira SystemClock_Config() LL i raro i te WHAKATAURANGA PAPA. tags.
   • I runga i te whakamaramatanga LED, whakakapihia ia LDx me tetahi atu LDy e waatea ana i te file matua.h.
   • Na enei whakarereketanga, ko te exampka rere i runga i te papa kua whakaritea.

Nga tono RF, whakaaturanga, me te examples
Nga momo rereke o nga tono RF, whakaaturanga, me te exampKei te waatea nga taonga i roto i te kete STM32CubeWL3.
Kua whakarārangihia ki ngā wāhanga e rua i raro nei.

Sub-GHz examples me nga whakaaturanga
Ko enei exampE whakaatu ana nga ahuatanga matua o nga taputapu reo irirangi MRSUBG me LPAWUR. Ko enei exampe wātea ana i raro i:

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

Ia exampKo te whakaaturanga ranei e rua nga kaupapa e kiia nei ko Tx me te Rx hei kaiwhakawhiti me te kaiwhiwhi, ia:

Examples/MRSUBG

• MRSUBG_802_15_4: he whakatinanatanga o te paparanga tinana kua tautuhia e te paerewa 802.15.4. E whakaatu ana me pehea te whirihora i te reo irirangi ki te tuku, ki te tango ranei i nga paatete 802.15.4.
• MRSUBG_BasicGeneric: He whakawhiti mo STM32WL3x MR_SUBG mokete taketake.
• MRSUBG_Chat: He tono ngawari e whakaatu ana me pehea te whakamahi i te Tx me te Rx i runga i te taputapu kotahi.
• MRSUBG_DatabufferHandler: He tawhitoampe whakaatu ana me pehea te huri mai i te Databuffer 0 me te 1.
• MRSUBG_SequencerAunoaAck: He exampte tuku me te whiwhi i nga whakamohiotanga paakete (ACKs) aunoa.
• MRSUBG_WMBusSTD: He whakawhitinga o nga karere WM-Bus.
• WakeupRadio: He exampki te whakamatautau i te LPAWUR reo irirangi peripheral.

Whakaaturanga/MRSUBG

• MRSUBG_RTC_Button_TX: Tenei exampE whakaatu ana me pehea te whakatakoto i te SoC ki te aratau-hohonu me te whirihora i te MRSUBG ki te whakaoho i te SoC ma te pehi i te PB2 ki te tuku anga, i muri ranei i te paunga o te taima RTC.
• MRSUBG_Sequencer_Sniff: Ko tenei o muaampE whakaatu ana me pehea te whakarite i te raupapa MRSUBG kia mahi i roto i te aratau hongi. Ko tenei exampKa whakaatu a le i te taha kaiwhiwhi me te tono i tetahi atu taputapu hei tuku.
• MRSUBG_Timer: He maha nga waahanga o te tono mo te MRSUBG timer (me te autoreload) me nga waa rereke.
• MRSUBG_WakeupRadio_Tx: Tenei exampKa whakamāramahia e ia me pehea te whakanoho i te SoC ki te aratau mutu hohonu me te whirihora i te MRSUBG hei whakaoho i te SoC ma te pehi i te PB2 ki te tuku anga. Ko tenei exampKa whakaatu a le i te taha kaiwhakawhiti me te tono i tetahi atu taputapu hei kaiwhiwhi LPAWUR. Ko te kaiwhiwhi exampkei raro te NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx kōpaki.

Whakaaturanga/LPAWUR

• LPAWUR_WakeupRadio_Rx: This exampKa whakamāramahia e ia me pehea te whakatakoto i te SoC i roto i te aratau tu-hohonu me te whirihora i te LPAWUR hei whakaoho i te SoC ina tae mai he anga ka tae tika mai. Ko tenei exampKa whakaatu a le i te taha kaiwhiwhi me te tono i tetahi atu taputapu hei tuku. Ko te kaiwhakawhiti exampKei raro te NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx kōpaki.

Tono Sigfox™
Ko enei tono e whakaatu ana me pehea te whakatinana i tetahi ahuatanga Sigfox™ me te whakamahi i nga API Sigfox™ e waatea ana. Kei te waatea i te ara kaupapa Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: Ko tenei tono e whakaatu ana me pehea te whakamahi i te atanga raina-whakahau (CLI) ki te tuku whakahau e whakamahi ana i te kawa Sigfox™ ki te tuku karere me te mahi i nga whakamatautau tiwhikete.
• Sigfox_PushButton: Ma tenei tono ka taea te arotake i nga kaha reo irirangi taputapu STM32WL33xx Sigfox™. Ko te pehi i te PB1 ka tukuna he anga Sigfox™ whakamatautau.

Hītori arotakenga

Ripanga 3. Tuhinga o mua whakahounga

Rā	Arotakenga	Huringa
29-Maehe-2024	1	Tukunga tuatahi.
30-Oketopa-2024	2	Ko te whakauru katoa o STM32CubeWL3 ki STM32Cube. Whakahoutia: •         Kupu Whakataki •         Wāhanga 2: STM32CubeWL3 āhuatanga matua •         Wāhanga 3.2.1: Waehanga Waenganui •         Wāhanga 4: STM32CubeWL3 mōkihi mārō kua mutuview •         Wāhanga 5.1: Te whakahaere i te ex tuatahiample •         Wāhanga 5.3: Nga tono RF, whakaaturanga, me te examples Kua taapiri: •         Wāhanga 5.1.1: Me pehea te whakahaere i te HAL example •         Wāhanga 5.2.1: Te whakamahi i te STM32CubeMX hei whakawhanake, hei whakahou ranei i tetahi tono • Swahanga 6.4: He kaupapa tauira mo MRSUBG/LPAWUR peripheral examples? •         Wāhanga 6.5: Me pehea e taea ai e STM32CubeMX te whakaputa waehere i runga i te rorohiko whakauru? Kua tangohia: •         Nga taputapu PC, tae atu ki Kaiwhakatere, STM32WL3 GUI, a MR-SUBG Sequencer GUI •         Me pehea e taea ai e WiSE-Studio IOMapper te whakaputa waehere i runga i te rorohiko whakauru? •         Ka whakaaetia e Navigator te uru atu ki nga rauemi kete rorohiko?
22-Kohi-2025	3	I whakawhānuihia te awhe o nga taputapu e tika ana ki te STM32WL30xx me te STM32WL31xx microcontrollers i te Ripanga 1. Tonotono mo te raina hua STM32WL3x.

WHAKAMAHI WHAKAMAHI - KAUPAPA KAUPAPA

• Ko te STMicroelectronics NV me ona apiti ("ST") te mana ki te whakarereke, whakatikatika, whakapainga, whakarereke me nga whakapainga ki nga hua ST me tenei tuhinga ranei i nga wa katoa kaore he panui. Me whiwhi nga kaihoko i nga korero hou e pa ana ki nga hua ST i mua i te tuku ota. Ka hokona nga hua ST i runga i nga tikanga me nga tikanga o te hokonga a ST i te wa o te ota whakaae.
• Ko nga Kaihoko anake te kawenga mo te kowhiringa, te kowhiringa me te whakamahi i nga hua ST me te ST karekau he kawenga mo te awhina tono me te hoahoa o nga hua a nga kaihoko.
• Karekau he raihana, he mea whakaatu, he tohu ranei, ki tetahi mana taonga hinengaro ka tukuna e ST i konei.
• Ko te hokonga ano o nga hua ST me nga tikanga rereke mai i nga korero kua whakatakotoria i konei ka whakakorehia he raihana kua tukuna e ST mo taua hua.
• Ko te ST me te tohu ST he tohu tohu na ST. Mo etahi atu korero mo nga tohu hokohoko ST, tirohia www.st.com/marks. Ko etahi atu ingoa hua, ingoa ratonga ranei no ratou ake rangatira.
• Ko nga korero kei roto i tenei tuhinga ka whakakapi me te whakakapi i nga korero i tukuna i mua i nga momo putanga o mua o tenei tuhinga.
• © 2025 STMicroelectronics – Pūmau te mana

FAQ

Ahea me whakamahi ahau i te HAL hei utu mo nga taraiwa LL?

Ka tukuna e nga taraiwa HAL nga API taumata-tiketike me te mahi-mahi, me te taumata teitei o te kawe. He mea huna te hua, te uaua taapiri ranei mo nga kaiwhakamahi mutunga. Ka tukuna e nga taraiwa LL nga API taumata rehita papa-iti me te pai ake o te arotau engari he iti ake te kawe. E hiahia ana ratou ki te matauranga hohonu mo nga hua, IP ranei.

Me pehea te whakahohea o nga API arawhiti LL?

Ko te whakamaramatanga o nga API arawhitinga LL me nga hanganga rauemi e hono ana nga kupu me nga tauira ka whakatauhia e te USE_FULL_LL_DRIVER whakakao whakahiato. Kia taea ai te whakamahi i nga API arawhitinga LL, taapirihia tenei whakahuri ki roto i te kaitukatuka whakahiato mekameka taputapu.

He kaupapa tauira mo MRSUBG/LPAWUR peripheral examples?

Hei hanga i tetahi MRSUBG hou, LPAWUR ranei o muaampte kaupapa, me timata mai i te kaupapa anga kōiwi i whakaratohia i raro i te kaupapa PrNUCLEO- 33CC Examples MRSUBG or ProjectsNUCLEO-WL33CC Examples LPAWUR mai i tetahi kaupapa e waatea ana i raro i enei raarangi.

Me pehea e taea ai e STM32CubeMX te whakaputa waehere i runga i te rorohiko whakauru?

Kei a STM32CubeMX te mohiotanga o STM32 microcontrollers, tae atu ki o raatau taputapu me o raatau rorohiko, e taea ai e ia te whakaatu whakaahua ki te kaiwhakamahi me te whakaputa .h, .c ranei. files i runga i te whirihoranga o te kaiwhakamahi.

Tuhinga / Rauemi

ST STM32WL3x Microcontrollers [pdf] Pukapuka Kaiwhakamahi STM32WL3x Microcontrollers, STM32WL3x, Microcontrollers

Tohutoro

• Pukapuka Kaiwhakamahi