STMicroelectronics STM32WBA Series Darba sākšana

Informācija par produktu

Specifikācijas:

• Produkta nosaukums: STM32CubeWBA MCU pakotne
• Ražotājs: STMikroelektronika
• Saderība: STM32WBA sērijas mikrokontrolleri
• Licencēšana: Atvērtā koda BSD licence

Produkta lietošanas instrukcijas

STM32CubeWBA MCU pakotnes galvenās iezīmes:
STM32CubeWBA MCU pakotne nodrošina visus nepieciešamos iegultās programmatūras komponentus lietojumprogrammu izstrādei STM32WBA sērijas mikrokontrolleros. Tas ir ļoti pārnēsājams STM32 sērijā, un tam ir HAL un LL API, piemamples, un starpprogrammatūras komponenti.

Arhitektūra beigusiesview:
STM32CubeWBA MCU pakotnes arhitektūra sastāv no trīs līmeņiem – lietojumprogrammas, bibliotēkas un protokolu komponenti, aparatūras abstrakcijas slānis, BSP draiveri, pamata draiveri un zema slāņa API.

FAQ

• Kas ir iekļauts STM32CubeWBA MCU pakotnē?
  Paketē ietilpst zema slāņa (LL) un aparatūras abstrakcijas slāņa (HAL) API, piemamples, lietojumprogrammas, starpprogrammatūras komponenti, piemēram FileX/LevelX, NetX Duo, mbed-crypto bibliotēkas un citas.
• Vai STM32CubeWBA MCU pakotne ir saderīga ar STM32CubeMX koda ģeneratoru?
  Jā, pakotne ir pilnībā savietojama ar STM32CubeMX koda ģeneratoru inicializācijas koda ģenerēšanai.

Ievads

• STM32Cube ir oriģināla STMicroelectronics iniciatīva, lai ievērojami uzlabotu dizaineru produktivitāti, samazinot izstrādes piepūli, laiku un izmaksas. STM32Cube aptver visu STM32 portfeli.
  STM32Cube ietver:
  • Lietotājam draudzīgu programmatūras izstrādes rīku komplekts, kas aptver projekta izstrādi no koncepcijas līdz realizācijai, tostarp:
    • STM32CubeMX, grafisks programmatūras konfigurācijas rīks, kas ļauj automātiski ģenerēt C inicializācijas kodu, izmantojot grafiskos vedņus
    • STM32CubeIDE, viss vienā izstrādes rīks ar perifērijas konfigurāciju, koda ģenerēšanu, koda kompilāciju un atkļūdošanas funkcijām
    • STM32CubeCLT — viss vienā komandrindas izstrādes rīku komplekts ar koda kompilācijas, plates programmēšanas un atkļūdošanas funkcijām
    • STM32CubeProgrammer (STM32CubeProg), programmēšanas rīks, kas pieejams grafiskajās un komandrindas versijās
    • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), jaudīgi uzraudzības rīki, lai precizētu STM32 lietojumprogrammu darbību un veiktspēju reāllaikā.
  • STM32Cube MCU un MPU pakotnes, visaptverošas iegultās programmatūras platformas, kas raksturīgas katrai mikrokontrolleru un mikroprocesoru sērijai (piemēram, STM32CubeWBA sērijai STM32WBA), kas ietver:
    • STM32Cube aparatūras abstrakcijas slānis (HAL), nodrošinot maksimālu pārnesamību visā STM32 portfelī
    • STM32Cube zema slāņa API, kas nodrošina vislabāko veiktspēju un pēdas ar augstu lietotāja kontroles līmeni pār aparatūru
    • Pastāvīgs starpprogrammatūras komponentu komplekts, piemēram, ThreadX, FileX/LevelX, NetX Duo, USBX, pieskārienu bibliotēka, mbed-crypto, TFM, MCUboot, OpenBL un STM32_WPAN (tostarp Bluetooth® Low Energy profiles un pakalpojumi, Mesh, Zigbee®, OpenThread, Matter un 802.15.4 MAC slānis)
    • Visas iegultās programmatūras utilītas ar pilniem perifērijas un lietojumprogrammatūru komplektiem, piemamples
  • STM32Cube paplašināšanas pakotnes, kas satur iegultos programmatūras komponentus, kas papildina STM32Cube MCU un MPU pakotņu funkcijas ar:
    • Starpprogrammatūras paplašinājumi un aplikācijas slāņi
    • Examples darbojas uz dažām īpašām STMicroelectronics izstrādes platēm
• Šajā lietotāja rokasgrāmatā ir aprakstīts, kā sākt darbu ar STM32CubeWBA MCU pakotni.
  • 2. sadaļā STM32CubeWBA galvenās iezīmes ir aprakstītas STM32CubeWBA MCU pakotnes galvenās iezīmes.
  • 3. sadaļa STM32CubeWBA arhitektūra beigusiesview nodrošina pāriview STM32CubeWBA arhitektūra un MCU pakotnes struktūra.

Vispārīga informācija

STM32CubeWBA MCU pakotne darbojas ar STM32 32 bitu mikrokontrolleriem, kuru pamatā ir Arm® Cortex®-M33 procesors ar Arm® TrustZone® un FPU.
Piezīme: Arm un TrustZone ir Arm Limited (vai tā meitasuzņēmumu) reģistrētas preču zīmes ASV un/vai citur.

STM32CubeWBA galvenās iezīmes

• STM32CubeWBA MCU pakotne darbojas ar STM32 32 bitu mikrokontrolleriem, kuru pamatā ir Arm® Cortex®-M33 procesors ar TrustZone® un FPU.
• STM32CubeWBA vienā pakotnē apkopo visus vispārīgos iegultos programmatūras komponentus, kas nepieciešami, lai izstrādātu lietojumprogrammu STM32WBA sērijas mikrokontrolleriem. Saskaņā ar STM32Cube iniciatīvu šis komponentu komplekts ir ļoti pārnēsājams ne tikai STM32WBA sērijas mikrokontrolleros, bet arī citās STM32 sērijās.
• STM32CubeWBA ir pilnībā savietojams ar STM32CubeMX koda ģeneratoru, lai ģenerētu inicializācijas kodu. Paketē ietilpst zema slāņa (LL) un aparatūras abstrakcijas slāņa (HAL) API, kas aptver mikrokontrollera aparatūru, kā arī plašs ex.amples darbojas uz STMicroelectronics plates. Lietotāju ērtībām HAL un LL API ir pieejamas atvērtā koda BSD licencē.
• STM32CubeWBA MCU pakotne satur arī visaptverošu starpprogrammatūras komponentu, kas izveidots ap Microsoft® Azure® RTOS starpprogrammatūru un citiem iekšējiem un atvērtā koda skursteņiem ar atbilstošo examples.
• Tiem ir pievienoti bezmaksas, lietotājam draudzīgi licences noteikumi:
  • Integrēts un pilnvērtīgs Azure® RTOS: Azure® RTOS ThreadX
  • CMSIS-RTOS ieviešana, izmantojot Azure® RTOS ThreadX
  • USB resursdatora un ierīču skursteņi ar daudzām klasēm: Azure® RTOS USBX
  • Papildu file sistēmas un zibatmiņas tulkošanas slānis: FileX / LevelX
  • Rūpnieciskā līmeņa tīkla steks: optimizēta veiktspējai ar daudziem IoT protokoliem: NetX Duo
  • OpenBootloader
  • Arm® Trusted Firmware-M (TF-M) integrācijas risinājums
  • mbed-crypto bibliotēkas
  • ST Netwok bibliotēka
  • STMTouch skārienjutības bibliotēkas risinājums
• STM32CubeWBA MCU pakotnē ir arī vairākas lietojumprogrammas un demonstrācijas, kas ievieš visus šos starpprogrammatūras komponentus.
• STM32CubeWBA MCU pakotnes komponentu izkārtojums ir parādīts 1. attēlā. STM32CubeWBA MCU pakotnes komponenti.

  

STM32CubeWBA arhitektūra beigusiesview

STM32CubeWBA MCU pakotnes risinājums ir veidots trīs neatkarīgi līmeņos, kas viegli mijiedarbojas, kā aprakstīts 2. attēlā. STM32CubeWBA MCU pakotnes arhitektūra.

0. līmenis

Šis līmenis ir sadalīts trīs apakšslāņos:

• Valdes atbalsta pakete (BSP).
• Aparatūras abstrakcijas slānis (HAL):
  • HAL perifērijas draiveri
  • Zema slāņa draiveri
• Pamata perifērijas lietošana, piemamples.

Valdes atbalsta pakotne (BSP)
Šis slānis piedāvā API kopu saistībā ar aparatūras komponentiem aparatūras platēs (piemēram, LCD, audio,\ microSD™ un MEMS draiveri). Tas sastāv no divām daļām:

• Komponentu draiveris:
  Šis draiveris ir saistīts ar ārējo ierīci uz paneļa, nevis ar STM32 ierīci. Komponentu draiveris nodrošina īpašus API BSP draivera ārējiem komponentiem, un to var pārnēsāt uz jebkura cita plates.
• BSP draiveris:
  BSP draiveris ļauj saistīt komponentu draiverus ar noteiktu plati un nodrošina lietotājam draudzīgu komplektu
  API. API nosaukšanas kārtula ir BSP_FUNCT_Action().
  Example: BSP_LED_Init(), BSP_LED_On()
  BSP pamatā ir modulāra arhitektūra, kas ļauj viegli pārnest jebkuru aparatūru, vienkārši ieviešot zema līmeņa rutīnas.

Aparatūras abstrakcijas slānis (HAL) un zemais slānis (LL)
STM32CubeWBA HAL un LL papildina viens otru un aptver plašu lietojuma prasību klāstu:

• HAL draiveri piedāvā augsta līmeņa funkcijas orientētas ļoti pārnēsājamas API. Tie gala lietotājam slēpj MCU un perifērijas sarežģītību.
  HAL draiveri nodrošina vispārīgas vairāku instanču uz funkcijām orientētas API, kas vienkāršo lietotāja lietojumprogrammu ieviešanu, nodrošinot lietošanai gatavus procesus. Piemēram,ample, sakaru perifērijas ierīcēm (I2S, UART un citām), tas nodrošina API, kas ļauj inicializēt un konfigurēt perifērijas ierīci, pārvaldīt datu pārsūtīšanu, pamatojoties uz aptauju, pārtraukšanu vai DMA procesu, un apstrādāt sakaru kļūdas, kas var rasties komunikācijas laikā. HAL draiveru API ir sadalītas divās kategorijās:
  1. Vispārējās API, kas nodrošina kopīgas un vispārīgas funkcijas visiem STM32 sērijas mikrokontrolleriem.
  2. Paplašinājuma API, kas nodrošina īpašas un pielāgotas funkcijas noteiktai saimei vai noteiktam daļas numuram.
• Zema līmeņa API nodrošina zema līmeņa API reģistra līmenī ar labāku optimizāciju, bet mazāku pārnesamību.
  • Viņiem ir nepieciešamas dziļas zināšanas par MCU un perifērijas specifikācijām.
  • LL draiveri ir izstrādāti, lai piedāvātu ātru, vieglu, uz ekspertiem orientētu slāni, kas ir tuvāk aparatūrai nekā HAL. Pretēji HAL, LL API netiek nodrošinātas perifērijas ierīcēm, kurām optimizēta piekļuve nav galvenā funkcija, vai tām, kurām nepieciešama smaga programmatūras konfigurācija vai sarežģīta augstākā līmeņa steks.
  • LL draiveru funkcijas:
    • Funkciju kopums perifērijas galveno funkciju inicializācijai atbilstoši datu struktūrās norādītajiem parametriem.
    • Funkciju kopa, lai aizpildītu inicializācijas datu struktūras ar atiestatīšanas vērtībām, kas atbilst katram laukam.
    • Perifērijas deinitializācijas funkcija (perifērijas reģistri ir atjaunoti to noklusējuma vērtībās).
    • Iekļauto funkciju kopums tiešai un atomu reģistra piekļuvei.
    • Pilnīga neatkarība no HAL un iespēja izmantot savrupajā režīmā (bez HAL draiveriem).
    • Pilns atbalstīto perifērijas līdzekļu pārklājums.

Pamata perifērijas lietošana, piemamples
Šis slānis aptver exampbūvēti pa STM32 perifērijas ierīcēm, izmantojot tikai HAL un BSP resursus.

1. līmenis

Šis līmenis ir sadalīts divos apakšslāņos:

• Starpprogrammatūras komponenti
• Exampbalstās uz starpprogrammatūras komponentiem

Starpprogrammatūras komponenti

• Starpprogrammatūra ir bibliotēku kopa, kas aptver Bluetooth® Low Energy (Linklayer, HCI, Stack), Thread®, Zigbee®,
• Matter, OpenBootloader, Microsoft® Azure® RTOS, TF‑M, MCUboot un mbed-crypto.
• Horizontālā mijiedarbība starp šī slāņa komponentiem tiek veikta, izsaucot piedāvātās API.
• Vertikālā mijiedarbība ar zemā slāņa draiveriem tiek veikta, izmantojot īpašus atzvanus un statiskos makro, kas ieviesti bibliotēkas sistēmas izsaukuma saskarnē.
• Katra starpprogrammatūras komponenta galvenās iezīmes ir šādas:
  • Microsoft® Azure® RTOS
    • Azure® RTOS ThreadX: reāllaika operētājsistēma (RTOS), kas paredzēta iegultām sistēmām ar diviem funkcionāliem režīmiem.
      • Kopējais režīms: izplatītas RTOS funkcijas, piemēram, pavedienu pārvaldība un sinhronizācija, atmiņas pūla pārvaldība, ziņojumapmaiņa un notikumu apstrāde.
      • Moduļa režīms: uzlabots lietotāja režīms, kas ļauj ielādēt un izlādēt iepriekš saistītos ThreadX moduļus, izmantojot moduļu pārvaldnieku.
    • NetX Duo
    • FileX
    • USBX
  • Bluetooth® Low Energy (BLE): ievieš Bluetooth® Low Energy protokolu Link un Stack slāņiem.
  • MCUboot (atvērtā koda programmatūra)
  • Zigbee® protokoli stekam un saistītajiem klasteriem.
  • Thread® protokolu steks un saites slānis.
  • Arm® uzticamā programmaparatūra-M, TF-M (atvērtā pirmkoda programmatūra): uzziņas par Arm® platformas drošības arhitektūras (PSA) ieviešanu TrustZone® ar saistītajiem drošajiem pakalpojumiem.
  • mbed-crypto (atvērtā koda programmatūra): mbed-crypto starpprogrammatūra nodrošina PSA kriptogrāfijas API ieviešanu.
  • STM32 pieskāriena sensoru bibliotēka: izturīgs STMTouch kapacitatīvās skārienjutības risinājums, kas atbalsta tuvuma, skārientaustiņu, lineāros un rotācijas pieskārienu sensorus. Tas ir balstīts uz pārbaudītu virsmas lādiņa pārneses iegūšanas principu.

Exampbalstās uz starpprogrammatūras komponentiem
Katram starpprogrammatūras komponentam ir viens vai vairāki examples (sauktas arī par lietojumprogrammām), kas parāda, kā to izmantot. Integrācija, piemamptiek nodrošināti arī tie, kas izmanto vairākus starpprogrammatūras komponentus.

STM32CubeWBA programmaparatūras pakotne ir beigusiesview

Atbalstītās STM32WBA sērijas ierīces un aparatūra

• STM32Cube piedāvā ļoti pārnēsājamu aparatūras abstrakcijas slāni (HAL), kas veidots ap vispārēju arhitektūru. Tas ļauj izmantot slāņu veidošanas principu, piemēram, izmantojot starpprogrammatūras slāni, lai īstenotu to funkcijas, padziļināti nezinot, kāds MCU tiek izmantots. Tas uzlabo bibliotēkas koda atkārtotu izmantošanu un nodrošina vieglu pārnesamību uz citām ierīcēm.
• Turklāt, pateicoties tā slāņu arhitektūrai, STM32CubeWBA piedāvā pilnu atbalstu visām STM32WBA sērijām.
• Lietotājam ir tikai jādefinē pareizais makro failā stm32wbaxx.h.
• 1. tabulā parādīts makro, kas jādefinē atkarībā no izmantotās STM32WBA sērijas ierīces. Šis makro ir jādefinē arī kompilatora priekšprocesorā.
  1. tabula. STM32WBA sērijas makro

  Makro, kas definēts stm32wbaxx.h	STM32WBA sērijas ierīces
  stm32wba52xx	STM32WBA52CGU6, STM32WBA52KGU6, STM32WBA52CEU6, STM32WBA52KEU6
  stm32wba55xx	STM32WBA55CGU6, STM32WBA55CGU6U, STM32WBA55CGU7, STM32WBA55CEU6, STM32WBA55CEU7

   
• STM32CubeWBA piedāvā bagātīgu examples un lietojumprogrammas visos līmeņos, kas ļauj viegli saprast un lietot jebkuru HAL draiveri vai starpprogrammatūras komponentus. Šie bijušieamples darbojas uz STMicroelectronics platēm, kas norādītas 2. tabulā.
  2. tabula. STM32WBA sērijas dēļi

  Valde	Ievadiet STM32WBA atbalstītās ierīces
  NUCLEO-WBA52CG	STM32WBA52CGU6
  NUCLEO-WBA55CG	STM32WBA55CGU6
  STM32WBA55-DK1	STM32WBA55CGU7

• STM32CubeWBA MCU pakotni var darbināt ar jebkuru saderīgu aparatūru. Lietotājs vienkārši atjaunina BSP draiverus, lai portētu sniegto examples uz tāfeles, ja pēdējam ir tādas pašas aparatūras funkcijas (piemēram, LED, LCD displejs un pogas).

Programmaparatūras pakotne beigusiesview

• STM32CubeWBA pakotnes risinājums tiek nodrošināts vienā zip pakotnē, kuras struktūra ir parādīta 3. attēlā. STM32CubeWBA programmaparatūras pakotnes struktūra.

  

• Katram dēlim komplekts examples ir nodrošināts ar iepriekš konfigurētiem projektiem EWARM, MDK-ARM un STM32CubeIDE rīku ķēdēm.
• 4. attēls. STM32CubeWBA piemamples beigusiesview parāda NUCLEO-WBA52CG, NUCLEO-WBA55CG un STM32WBA55G-DK1 plātņu projekta struktūru.

  

• Bijušaisamples tiek klasificētas atkarībā no STM32Cube līmeņa, uz kuru tie attiecas, un to nosaukumi ir šādi:
  • 0. līmenis, piemamples sauc Examples, Piemamples_LL un Piemamples_MIX. Tie izmanto attiecīgi HAL draiverus, LL draiverus un HAL un LL draiveru kombināciju bez starpprogrammatūras komponenta.
  • 1. līmenis, piemamples sauc par lietojumprogrammām. Tie nodrošina tipiskus katra starpprogrammatūras komponenta lietošanas gadījumus. Jebkuru programmaparatūras lietojumprogrammu konkrētai platei var ātri izveidot, pateicoties veidņu projektiem, kas pieejami katalogos Templ ates un Templates_LL.

TrustZone® iespējoti projekti

• TrustZone® iespējots Piemamples nosaukumos ir prefikss _TrustZone. Noteikums tiek piemērots arī lietojumprogrammām (izņemot TFM un SBSFU, kas sākotnēji ir paredzētas TrustZone®).
• TrustZone® iespējots Piemamples un Lietojumprogrammas ir nodrošinātas ar vairāku projektu struktūru, kas sastāv no drošiem un nedrošiem apakšprojektiem, kā parādīts 5. attēlā. Vairāku projektu droša un nedroša projekta struktūra.
• TrustZone® iespējotie projekti ir izstrādāti saskaņā ar CMSIS-5 ierīces veidni, kas paplašināta, iekļaujot sistēmas nodalījuma galveni file nodalījums_ .h, kurš galvenokārt ir atbildīgs par drošā atribūta vienības (SAU), FPU un drošo/nedrošo pārtraukumu piešķiršanu drošās izpildes stāvoklī.
• Šī iestatīšana tiek veikta drošajā CMSIS SystemInit() funkcijā, kas tiek izsaukta startēšanas laikā pirms drošās lietojumprogrammas main() funkcijas ievadīšanas. Skatiet Arm® TrustZone®-M programmatūras vadlīniju dokumentāciju.

  

• STM32CubeWBA pakotnes programmaparatūras pakotne nodrošina noklusējuma atmiņas sadalīšanu nodalījumā _ .h fileir pieejams šeit: \Drivers\CMSIS\Device\ST\STM32WBAxx\Include\T emplates
• Šajā nodalījumā files, SAU pēc noklusējuma ir atspējots. Līdz ar to IDAU atmiņas kartēšana tiek izmantota drošības attiecinājumam. Skatiet attēlu Droša/nedroša sadalīšana, izmantojot TrustZone® tehnoloģiju RM0495 atsauces rokasgrāmatā.
• Ja lietotājs iespējo SAU, nodalījumā ir iepriekš definēta noklusējuma SAU reģionu konfigurācija files šādi:
  • SAU reģions 0: 0x08080000 – 0x081FFFFF (nedroša droša puse zibatmiņas (512 KB))
  • SAU 1. reģions: 0x0BF88000 – 0x0BF97FFF (nedroša sistēmas atmiņa)
  • SAU 2. reģions: 0x0C07E000 – 0x0C07FFFF (izsaucams drošs, nedroši)
  • SAU 3. reģions: 0x20010000 – 0x2001FFFF (nedroša SRAM2 (64 KB))
  • SAU 4. reģions: 0x40000000 – 0x4FFFFFFFF (nedroša perifērijas kartēta atmiņa)
• Lai atbilstu noklusējuma nodalījumam, STM32WBAxx sērijas ierīcēm ir jābūt iestatītiem šādiem lietotāja opciju baitiem:
  • TZEN = 1 (ierīce ar iespējotu TrustZone®)
  • SECWM1_PSTRT = 0x0 SECWM1_PEND = 0x3F (64 no 128 iekšējās zibatmiņas lappusēm ir iestatītas kā drošas) Piezīme. Iekšējā zibatmiņa pēc noklusējuma ir pilnībā droša TZEN = 1. Lietotāja opciju baiti SECWM1_PSTRT/ SECWM1_PEND ir jāiestata atbilstoši lietojumprogrammai. atmiņas konfigurācija (SAU reģioni, ja SAU ir iespējots). Drošu/nedrošu lietojumprogrammu projektu saistītājs files arī ir jāsaskaņo.
• Visas examples ir tāda pati struktūra:
  • \Inc mape, kurā ir visa galvene files.
  • Src mape, kurā ir avota kods.
  • \EWARM, \MDK-ARM un \STM32CubeIDE mapes, kurās ir katras rīku ķēdes iepriekš konfigurēts projekts.
  • readme.md un readme.html, kas apraksta exampuzvedību un nepieciešamo vidi, lai tā darbotos.
  • ioc file kas ļauj lietotājiem atvērt lielāko daļu programmaparatūras, piemēram,amples STM32CubeMX ietvaros.

Darba sākšana ar STM32CubeWBA

Vada pirmo HAL example

Šajā sadaļā ir paskaidrots, cik vienkārši ir palaist pirmo example STM32CubeWBA ietvaros. Tajā kā ilustrācija izmantota vienkārša LED pārslēgšanas ģenerēšana, kas darbojas uz NUCLEO-WBA52CG plates:

1. Lejupielādējiet STM32CubeWBA MCU pakotni.
2. Izsaiņojiet to izvēlētā direktorijā.
3. Nepārveidojiet pakotnes struktūru, kas parādīta 1. attēlā. Ieteicams arī kopēt pakotni vietā, kas atrodas tuvu jūsu saknes sējumam (tas nozīmē C:\ST vai G:\Tests), jo daži IDE saskaras ar problēmām, kad ceļš garums ir pārāk garš.

Palaižot pirmo TrustZone® iespējotu example

• Pirms TrustZone® iespējotas ielādes un palaišanas, piemample, obligāti jāizlasa example readme file jebkurai konkrētai konfigurācijai, kas nodrošina, ka drošība ir iespējota, kā aprakstīts sadaļā 4.2.1 TrustZone® iespējotie projekti (TZEN=1 (lietotāja opcijas baits)).
  1. Pārlūkojiet sadaļu \Projects\NUCLEO-WBA52CG\Examples.
  2. Atveriet \GPIO, pēc tam \GPIO_IOToggle_TrustZone mapes.
  3. Atveriet projektu ar vēlamo rīku ķēdi. Ātrs beigasview par to, kā atvērt, izveidot un vadīt bijušoample ar atbalstītajām instrumentu ķēdēm ir norādīts zemāk.
  4. Pēc kārtas pārbūvējiet visus drošos un nedrošos projektus files un ielādējiet drošos un nedrošos attēlus mērķa atmiņā.
  5. Palaidiet bijušoample: regulāri drošā lietojumprogramma pārslēdz LD2 ik sekundi, bet nedrošā lietojumprogramma pārslēdz LD3 divreiz ātrāk. Lai iegūtu sīkāku informāciju, skatiet readme file no bijušāample.
• Lai atvērtu, izveidotu un palaistu bijušoample ar atbalstītajām rīku ķēdēm, veiciet tālāk norādītās darbības.
  • EWARM:
    1. Zem bijušāample mapi, atveriet apakšmapi \EWARM.
    2. Palaidiet darbvietu Project.eww
    3. Pārbūvējiet xxxxx_S drošo projektu files: [Projekts]> [Pārbūvēt visu].
    4. Iestatiet xxxxx_NS nedrošo projektu kā aktīvu lietojumprogrammu (ar peles labo pogu noklikšķiniet uz xxxxx_NS projekta [Iestatīt kā aktīvu])
    5. Pārbūvējiet xxxxx_NS nedrošo projektu files: [Projekts]> [Pārbūvēt visu].
    6. Flash nedrošo bināro failu ar [Projekts]> [Lejupielādēt]> [Lejupielādēt aktīvo lietojumprogrammu] .
    7. Iestatiet xxxxx_S kā aktīvo lietojumprogrammu (ar peles labo pogu noklikšķiniet uz xxxxx_S projekta [Iestatīt kā aktīvu]).
    8. Flash drošo bināro failu, izmantojot [Lejupielādēt un atkļūdot] (Ctrl+D).
    9. Palaidiet programmu: [Debug]> [Go(F5)]
  • MDK-ARM:
    1. Atveriet \MDK-ARM rīku ķēdi.
    2. Atveriet darbvietu Vairāki projekti file Project.uvmpw.
    3. Atlasiet projektu xxxxx_s kā aktīvo lietojumprogrammu ([Iestatīt kā aktīvo projektu]).
    4. Izveidojiet projektu xxxxx_s.
    5. Atlasiet projektu xxxxx_ns kā aktīvo projektu ([Iestatīt kā aktīvo projektu]).
    6. Izveidojiet projektu xxxxx_ns.
    7. Ielādējiet nedrošo bināro failu ([F8]). Tas lejupielādē \MDK-ARM\xxxxx_ns\Exe\xxxxx_ns.axf zibatmiņā)
    8. Atlasiet projektu Project_s kā aktīvo projektu ([Iestatīt kā aktīvo projektu]).
    9. Ielādējiet drošo bināro failu ([F8]). Tas lejupielādē \MDK-ARM\xxxxx_s\Exe\xxxxx_s.axf zibatmiņā).
    10. Palaidiet bijušoample.
  • STM32CubeIDE:
    1. Atveriet STM32CubeIDE rīku ķēdi.
    2. Atveriet darbvietu Vairāki projekti file .projekts.
    3. Pārbūvējiet projektu xxxxx_Secure.
    4. Pārbūvējiet projektu xxxxx_NonSecure.
    5. Palaidiet drošā projekta lietojumprogrammu [Debug as STM32 Cortex-M C/C++].
    6. Logā [Rediģēt konfigurāciju] atlasiet paneli [Startup] un pievienojiet ielādes attēlu un nedrošā projekta simbolus.
       Svarīgi: Nedrošais projekts ir jāielādē pirms drošā projekta.
    7. Noklikšķiniet uz [OK].
    8. Palaidiet bijušoamppar atkļūdošanas perspektīvu.

Palaižot pirmo TrustZone® atspējotu example

• Pirms TrustZone® atspējošanas ielādes un palaišanas, piemample, obligāti jāizlasa example readme file jebkurai konkrētai konfigurācijai. Ja nav īpašu pieminējumu, pārliecinieties, vai plates ierīcei ir atspējota drošība (TZEN=0 (lietotāja opcijas baits)). Skatiet sadaļu FAQ par izvēles regresijas veikšanu līdz TZEN = 0
  1. Pārlūkojiet sadaļu \Projects\NUCLEO-WBA52CG\Examples.
  2. Atveriet mapes \GPIO, pēc tam \GPIO_EXTI.
  3. Atveriet projektu ar vēlamo rīku ķēdi. Ātrs beigasview par to, kā atvērt, izveidot un vadīt bijušoample ar atbalstītajām instrumentu ķēdēm ir norādīts zemāk.
  4. Pārbūvēt visu files un ielādējiet attēlu mērķa atmiņā.
  5. Palaidiet bijušoample: katru reizi, kad tiek nospiesta spiedpoga [USER], LD1 gaismas diode pārslēdzas. Lai iegūtu sīkāku informāciju, skatiet readme file no bijušāample.
• Lai atvērtu, izveidotu un palaistu bijušoample ar atbalstītajām rīku ķēdēm, veiciet tālāk norādītās darbības.
  • EWARM:
    1. Zem bijušāample mapi, atveriet apakšmapi \EWARM.
    2. Palaidiet darbvietu Project.eww (darbvietas nosaukums var mainīties no viena piemample citam).
    3. Pārbūvēt visu files: [Projekts]> [Pārbūvēt visu].
    4. Ielādējiet projekta attēlu: [Projekts]> [Atkļūdošana].
    5. Palaidiet programmu: [Atkļūdot]> [Go (F5)].
  • MDK-ARM:
    1. Zem bijušāample mapi, atveriet apakšmapi \MDK-ARM.
    2. Palaidiet darbvietu Project.uvproj (darbvietas nosaukums var mainīties no viena piemample citam).
    3. Pārbūvēt visu files:[Projekts]>[Pārbūvēt visu mērķi files].
    4. Ielādējiet projekta attēlu: [Atkļūdošana]> [Sākt/pārtraukt atkļūdošanas sesiju].
    5. Palaidiet programmu: [Atkļūdot]> [Palaist (F5)].
  • STM32CubeIDE:
    1. Atveriet STM32CubeIDE rīku ķēdi.
    2. Klikšķis [File]>[Pārslēgt darbvietu]>[Cits] un pārlūkojiet STM32CubeIDE darbvietas direktoriju.
    3. Klikšķis [File]> [Importēt] , atlasiet [Vispārīgi]> [Esošie projekti darbvietā] un pēc tam noklikšķiniet uz [Nākamais].
    4. Pārlūkojiet uz STM32CubeIDE darbvietas direktoriju un atlasiet projektu.
    5. Pārbūvēt visu projektu files: logā [Project Explorer] atlasiet projektu, pēc tam noklikšķiniet uz izvēlnes [Project]> [Build project].
    6. Palaidiet programmu: [Palaist]> [Atkļūdot (F11)]

Pielāgotas lietojumprogrammas izstrāde

Piezīme: Programmatūrai ir jāiespējo instrukciju kešatmiņa (ICACHE), lai no zibatmiņas iegūtu 0 gaidīšanas stāvokļa izpildi un sasniegtu maksimālo veiktspēju un labāku enerģijas patēriņu.

STM32CubeMX izmantošana lietojumprogrammas izstrādei vai atjaunināšanai

• STM32CubeWBA MCU pakotnē gandrīz visi projekti examples tiek ģenerēti ar STM32CubeMX rīku, lai inicializētu sistēmu, perifērijas ierīces un starpprogrammatūru.
• Esoša projekta tieša izmantošana, piemēram,ampSTM32CubeMX rīkam nepieciešama STM32CubeMX 6.10.0 vai jaunāka versija:
  • Pēc STM32CubeMX instalēšanas atveriet un, ja nepieciešams, atjauniniet piedāvāto projektu. Vienkāršākais veids, kā atvērt esošu projektu, ir dubultklikšķis uz *.ioc file lai STM32CubeMX automātiski atvērtu projektu un tā avotu files.
  • STM32CubeMX ģenerē šādu projektu inicializācijas pirmkodu. Galvenās lietojumprogrammas pirmkods ir ietverts komentāros “USER CODE BEGIN” un “USER CODE END”. Ja IP atlase un iestatījums tiek mainīts, STM32CubeMX atjaunina koda inicializācijas daļu, bet saglabā galvenās lietojumprogrammas avota kodu.
• Lai izstrādātu pielāgotu projektu STM32CubeMX, veiciet soli pa solim norādīto procesu:
  1. Izvēlieties STM32 mikrokontrolleri, kas atbilst nepieciešamajam perifērijas ierīču komplektam.
  2. Konfigurējiet visu nepieciešamo iegulto programmatūru, izmantojot pinout-konfliktu risinātāju, pulksteņa koka iestatījumu palīgu, enerģijas patēriņa kalkulatoru un utilītu, kas veic MCU perifērijas konfigurāciju (piemēram, GPIO vai USART) un starpprogrammatūras stekus (piemēram, USB).
  3. Ģenerējiet inicializācijas C kodu, pamatojoties uz atlasīto konfigurāciju. Šis kods ir gatavs lietošanai vairākās izstrādes vidēs. Lietotāja kods tiek saglabāts nākamajā koda paaudzē.
• Papildinformāciju par STM32CubeMX skatiet lietotāja rokasgrāmatā STM32CubeMX par STM32 konfigurāciju un inicializācijas C koda ģenerēšanu (UM1718).
• Lai iegūtu pieejamo projektu sarakstu, piemampSTM32CubeWBA, skatiet pieteikuma piezīmi STM32Cube programmaparatūras exampmazāk STM32WBA sērijai (AN5929).

Draiveri lietojumprogrammas

HAL pieteikums
Šajā sadaļā ir aprakstītas darbības, kas jāveic, lai izveidotu pielāgotu HAL lietojumprogrammu, izmantojot STM32CubeWBA:

1. Izveidojiet projektu
   • Lai izveidotu jaunu projektu, sāciet vai nu no veidnes projekta, kas paredzēts katrai tāfelei sadaļā \Projekti\ \Veidnes vai no jebkura pieejamā projekta sadaļā \Projekti\ \Piemēri vai \Projekti\ \Aplikācijas (kur attiecas uz plates nosaukumu, piemēram, STM32CubeWBA).
   • Veidnes projekts nodrošina tukšas galvenās cilpas funkciju. Tomēr tas ir labs sākumpunkts, lai izprastu STM32CubeWBA projekta iestatījumus. Šai veidnei ir šādas īpašības:
     • Tajā ir HAL pirmkods, CMSIS un BSP draiveri, kas ir minimālais komponentu kopums, kas nepieciešams, lai izstrādātu kodu noteiktā platē.
     • Tajā ir iekļauti visu programmaparatūras komponentu ceļi.
     • Tas nosaka atbalstītās STM32WBA sērijas ierīces, ļaujot pareizi konfigurēt CMSIS un HAL draiverus.
     • Tas nodrošina lietošanai gatavu lietotāju fileir iepriekš konfigurēts, kā parādīts zemāk:
       HAL inicializēts ar noklusējuma laika bāzi ar Arm® kodolu SysTick. SysTick ISR ieviests HAL_Delay() mērķim.
       Piezīme: Kopējot esošu projektu uz citu vietu, pārliecinieties, vai ir atjaunināti visi iekļautie ceļi.
2. Pievienojiet lietotāja projektam nepieciešamo starpprogrammatūru (pēc izvēles)
   Lai identificētu avotu files jāpievieno projektam file sarakstu, skatiet katras starpprogrammatūras dokumentāciju. Skatiet lietojumprogrammas sadaļā \Projects\STM32xxx_yyy\Applications\ (kur attiecas uz starpprogrammatūras steku, piemēram, ThreadX), lai uzzinātu, kurš avots files un iekļaut ceļi ir jāpievieno.
3. Konfigurējiet programmaparatūras komponentus
   HAL un starpprogrammatūras komponenti piedāvā izveides laika konfigurācijas opciju kopu, izmantojot makro #define, kas deklarēti galvenē. file. Veidnes konfigurācija file tiek nodrošināts katrā komponentā, kas ir jāiekopē projekta mapē (parasti konfigurācijā file ir nosaukts xxx_conf_template.h, vārds _template ir jānoņem, kopējot to projekta mapē). Konfigurācija file sniedz pietiekami daudz informācijas, lai izprastu katras konfigurācijas opcijas ietekmi. Sīkāka informācija ir pieejama katras sastāvdaļas dokumentācijā.
4. Sāciet HAL bibliotēku
   Pēc pāriešanas uz galveno programmu lietojumprogrammas kodam ir jāizsauc HAL_Init() API, lai inicializētu HAL bibliotēku, kas veic šādus uzdevumus:
   • Zibatmiņas sākotnējās ielādes un SysTick pārtraukuma prioritātes konfigurācija (izmantojot makro, kas definēti st m32wbaxx_hal_conf.h).
   • SysTick konfigurācija, lai ik pēc milisekundes ģenerētu pārtraukumu ar SysTick pārtraukuma prioritāti TICK_INT_PRIO, kas definēta stm32wbaxx_hal_conf.h.
   • NVIC grupas prioritātes iestatījums uz 0.
   • HAL_MspInit() atzvanīšanas funkcijas izsaukums, kas definēts lietotāja stm32wbaxx_hal_msp.c file lai veiktu globālas zema līmeņa aparatūras inicializācijas.
5. Konfigurējiet sistēmas pulksteni
   Sistēmas pulksteņa konfigurācija tiek veikta, izsaucot divas tālāk aprakstītās API:
   • HAL_RCC_OscConfig(): šī API konfigurē iekšējos un ārējos oscilatorus. Lietotājs izvēlas konfigurēt vienu vai visus oscilatorus.
   • HAL_RCC_ClockConfig(): šī API konfigurē sistēmas pulksteņa avotu, zibatmiņas latentumu un AHB un APB priekšskalotājus.
6. Inicializējiet perifērijas ierīci
   • Vispirms ierakstiet perifērijas funkciju HAL_PPP_MspInit. Rīkojieties šādi:
     • Iespējot perifērijas pulksteni.
     • Konfigurējiet perifērijas GPIO.
     • Konfigurējiet DMA kanālu un iespējojiet DMA pārtraukumu (ja nepieciešams).
     • Iespējot perifērijas pārtraukumu (ja nepieciešams).
   • Rediģējiet failu stm32xxx_it.c, lai vajadzības gadījumā izsauktu nepieciešamos pārtraukumu apstrādātājus (perifēro un DMA).
   • Rakstīt procesa pilnīgas atzvanīšanas funkcijas, ja tiek plānots izmantot perifērijas pārtraukumu vai DMA.
   • Lietotājā galvenajā.c file, inicializējiet perifērijas roktura struktūru un pēc tam izsauciet funkciju HAL_PPP_Init(), lai inicializētu perifērijas ierīci.
7. Izstrādāt lietojumprogrammu
   • Šajā stage, sistēma ir gatava un var sākties lietotāja lietojumprogrammas koda izstrāde.
   • HAL nodrošina intuitīvus un lietošanai gatavus API, lai konfigurētu perifērijas ierīci. Tā atbalsta aptauju, pārtraukumus un DMA programmēšanas modeli, lai pielāgotos visām lietojumprogrammu prasībām. Lai iegūtu papildinformāciju par katras perifērijas ierīces lietošanu, skatiet bagātīgo exampkomplekts, kas iekļauts STM32CubeWBA MCU pakotnē.
     Uzmanību: Noklusējuma HAL ieviešanā SysTick taimeris tiek izmantots kā laika bāze: tas ģenerē pārtraukumus ar regulāriem laika intervāliem. Ja HAL_Delay() tiek izsaukts no perifērijas ISR procesa, pārliecinieties, vai SysTick pārtraukumam ir augstāka prioritāte (skaitliski zemāka) nekā perifērijas pārtraukumam. Pretējā gadījumā zvanītāja ISR process tiek bloķēts. Funkcijas, kas ietekmē laika bāzes konfigurācijas, tiek deklarētas kā __vājas, lai lietotājam būtu iespējams ignorēt citas implementācijas. file (izmantojot vispārējas nozīmes taimeri, piemēram,ample vai citu laika avotu). Plašāku informāciju skatiet HAL_TimeBase example.

LL pieteikums
Šajā sadaļā ir aprakstītas darbības, kas jāveic, lai izveidotu pielāgotu LL lietojumprogrammu, izmantojot STM32CubeWBA.

1. Izveidojiet projektu
   • Lai izveidotu jaunu projektu, vai nu sāciet no projekta Templates_LL, kas ir paredzēts katrai platei sadaļā \Projects\ \Templates_LL vai no jebkura pieejamā projekta sadaļā \Projects\ \Piemamples_LL ( attiecas uz paneļa nosaukumu, piemēram, NUCLEO-WBA32CG).
   • Veidnes projekts nodrošina tukšas galvenās cilpas funkciju, kas ir labs sākumpunkts, lai izprastu STM32CubeWBA projekta iestatījumus. Veidnes galvenās īpašības ir šādas:
     • Tajā ir LL un CMSIS draiveru pirmkodi, kas ir minimālais komponentu kopums, kas nepieciešams, lai izstrādātu kodu noteiktā platē.
     • Tajā ir iekļauti ceļi visiem nepieciešamajiem programmaparatūras komponentiem.
     • Tas atlasa atbalstīto STM32WBA sērijas ierīci un ļauj pareizi konfigurēt CMSIS un LL draiverus.
     • Tas nodrošina lietošanai gatavu lietotāju files, kas ir iepriekš konfigurēti šādi:
       ◦ main.h: LED un USER_BUTTON definīcijas abstrakcijas slānis.
       ◦ main.c: sistēmas pulksteņa konfigurācija maksimālai frekvencei.
2. Portējiet esošu projektu uz citu plati
   Lai atbalstītu esošu projektu citā mērķa panelī, sāciet ar projektu Templates_LL, kas nodrošināts katrai platei un pieejams sadaļā \Projects\ \Veidnes_LL.
   • Izvēlieties LL example: Lai atrastu tāfeli, uz kura LL examples ir izvietotas, skatiet LL ex sarakstuamples STM32CubeProjectsList.html.
3. Pieslēgt LL example:
   • Kopējiet/ielīmējiet mapi Templates_LL — lai saglabātu sākotnējo avotu — vai tieši atjauniniet esošo Templates_LL projektu.
   • Tad pārnešana galvenokārt sastāv no Templates_LL aizstāšanas files bijušaisamples_LL mērķprojekts.
   • Saglabājiet visas dēļa īpašās daļas. Skaidrības labad atsevišķas dēļa daļas ir atzīmētas ar īpašām tags:

     

   • Tādējādi galvenie pārnešanas soļi ir šādi:
     • Nomainiet failu stm32wbaxx_it.h file
     • Nomainiet failu stm32wbaxx_it.c file
     • Nomainiet galveno.h file un atjauniniet to: saglabājiet LL veidnes LED un lietotāja pogas definīciju sadaļā DĒĻA KONFIGURĀCIJA tags.
     • Nomainiet galveno.c file un atjauniniet to:
   • Saglabājiet SystemClock_Config() LL veidnes funkcijas pulksteņa konfigurāciju sadaļā BOARD SECIFIC CONFIGURATION tags.
   • Atkarībā no LED definīcijas katru LDx gadījumu nomainiet ar citu LDy, kas pieejams galvenajā.h file.
   • Ar šīm modifikācijām bijušaisample tagad darbojas uz mērķa dēļa

Drošības lietojumprogrammas
Šī pakete tiek piegādāta kopā ar drošības lietojumprogrammām.

SBSFU lietojumprogrammas

• SBSFU nodrošina Root of Trust risinājumu, tostarp Secure Boot un Secure Firmware Update funkcijas (pamatojoties uz MCUboot).
• Risinājums tiek izmantots pirms lietojumprogrammas izpildes.
• Risinājums nodrošina exampdroša pakalpojuma (GPIO pārslēgšanas slēdzis), kas ir izolēts no nedrošas lietojumprogrammas. Nedrošā lietojumprogramma izpildlaikā joprojām var izmantot šo risinājumu.

TFM lietojumprogrammas
TFM nodrošina Root of Trust risinājumu, tostarp drošas sāknēšanas un drošas programmaparatūras atjaunināšanas funkcijas
(pamatojoties uz MCUboot). Risinājums tiek izmantots pirms lietojumprogrammas izpildes. Risinājums nodrošina TFM drošus pakalpojumus, kas ir izolēti no nedrošas lietojumprogrammas. Nedrošā lietojumprogramma izpildlaikā joprojām var izmantot šo risinājumu.

RF lietojumprogrammas
RF lietojumprogramma ir aprakstīta šajā pieteikuma piezīmē: Bezvadu lietojumprogrammu izveide ar STM32WBA sērijas mikrokontrolleriem (AN5928).

STM32CubeWBA laidiena atjauninājumu iegūšana
Jaunākie STM32CubeWBA MCU pakotņu laidieni un ielāpi ir pieejami no STM32WBA sērijas. Tos var izgūt, izmantojot STM32CubeMX pogu CHECK FOR UPDATE. Papildinformāciju skatiet lietotāja rokasgrāmatas STM3CubeMX 32. sadaļā par STM32 konfigurāciju un inicializācijas C koda ģenerēšanu (UM1718).

FAQ

• Kad man vajadzētu izmantot HAL, nevis LL draiverus?
  • HAL draiveri piedāvā augsta līmeņa un uz funkcijām orientētas API ar augstu pārnesamības līmeni. Produkta vai perifērijas sarežģītība galalietotājiem ir paslēpta.
  • LL draiveri piedāvā zema līmeņa reģistra līmeņa API ar labāku optimizāciju, bet mazāk pārnēsājamu. Viņiem ir nepieciešamas padziļinātas zināšanas par produkta vai IP specifikācijām.
• Vai es varu izmantot HAL un LL draiverus kopā? Ja es varu, kādi ir ierobežojumi?
  • Ir iespējams izmantot gan HAL, gan LL draiverus. Izmantojiet HAL IP inicializācijas fāzei un pēc tam pārvaldiet I/O darbības ar LL draiveriem.
  • Galvenā atšķirība starp HAL un LL ir tāda, ka HAL draiveriem ir jāizveido un jāizmanto rokturi operāciju pārvaldībai, savukārt LL draiveri darbojas tieši perifērijas reģistros. Bijušaisamples_MIX example ilustrē, kā sajaukt HAL un LL.
• Kā tiek iespējotas LL inicializācijas API?
  • LL inicializācijas API un saistīto resursu (struktūru, literāļu un prototipu) definīciju nosaka kompilācijas slēdzis USE_FULL_LL_DRIVER.
  • Lai varētu izmantot LL inicializācijas API, pievienojiet šo slēdzi rīkķēdes kompilatora priekšprocesoram.
• Kā STM32CubeMX var ģenerēt kodu, pamatojoties uz iegulto programmatūru?
  STM32CubeMX ir iebūvētas zināšanas par STM32 mikrokontrolleriem, tostarp to perifērijas ierīcēm un programmatūru, kas ļauj nodrošināt lietotājam grafisku attēlojumu un ģenerēt *.h vai *.c files, pamatojoties uz lietotāja konfigurāciju.

SVARĪGS PAZIŅOJUMS – UZMANĪGI IZLASIET

• STMicroelectronics NV un tā meitasuzņēmumi (“ST”) patur tiesības jebkurā laikā bez brīdinājuma veikt izmaiņas, labojumus, uzlabojumus, modifikācijas un uzlabojumus ST izstrādājumos un/vai šajā dokumentā. Pirms pasūtījuma veikšanas pircējiem jāiegūst jaunākā atbilstošā informācija par ST produktiem. ST produkti tiek pārdoti saskaņā ar ST pārdošanas noteikumiem un nosacījumiem, kas ir spēkā pasūtījuma apstiprināšanas brīdī.
• Pircēji ir pilnībā atbildīgi par ST produktu izvēli, izvēli un lietošanu, un ST neuzņemas nekādu atbildību par palīdzību pielietošanā vai pircēja produktu dizainu.
• ST šeit nepiešķir nekādas tiešas vai netiešas licences jebkādām intelektuālā īpašuma tiesībām.
• ST produktu tālākpārdošana ar noteikumiem, kas atšķiras no šeit norādītās informācijas, anulē jebkādu ST piešķirto garantiju šādam produktam.
• ST un ST logotips ir ST preču zīmes. Papildinformāciju par ST preču zīmēm skatiet vietnē www.st.com/trademarks. Visi pārējie produktu vai pakalpojumu nosaukumi ir to attiecīgo īpašnieku īpašums.
• Informācija šajā dokumentā aizstāj un aizstāj informāciju, kas iepriekš sniegta jebkurās iepriekšējās šī dokumenta versijās.
• © 2023 STMicroelectronics – visas tiesības paturētas

Dokumenti / Resursi

STMicroelectronics STM32WBA Series Darba sākšana [pdfLietotāja rokasgrāmata STM32WBA Series Darba sākšana, Darba sākšana, Darba sākšana

Atsauces

• Lietotāja rokasgrāmata