STM32WL3x микроконтроллерууд

Бүтээгдэхүүнийг ашиглах заавар

• STM32CubeWL3 багц нь микроконтроллерийн техник хангамжийг хамарсан бага давхарга (LL) болон техник хангамжийн хийсвэрлэх давхарга (HAL) API-г агуулдаг.
• Мөн SigfoxTM, FatFS, FreeRTOS цөм зэрэг дунд програмын бүрэлдэхүүн хэсгүүдийг хангадаг.
• Багц нь хуучинampхялбар хэрэгжүүлэхэд зориулсан les болон програмууд.
• STM32CubeWL3 архитектур нь Програм, HAL, LL гэсэн гурван түвшинд бүтээгдсэн.
• HAL болон LL API нь өргөн хүрээний хэрэглээний шаардлагыг хамардаг.
• HAL нь захын үндсэн хэрэглээг санал болгодогamples, мөн LL нь доод түвшний горимуудыг хангадаг.
• Энэ түвшинд Зөвлөлийн дэмжлэгийн багц (BSP) болон HAL дэд давхарга орно.
• BSP нь самбар дээрх техник хангамжийн бүрэлдэхүүн хэсгүүдийн API-г санал болгодог бол HAL нь захын үндсэн хэрэглээг өгдөгamples.
• BSP драйверууд нь бүрэлдэхүүн хэсгийн драйверуудыг тодорхой самбарт холбосноор бусад техник хангамж руу холбоход хялбар болгодог.
• STM32CubeWL3 HAL болон LL нь нэмэлт бөгөөд өргөн хүрээний хэрэглээний шаардлагыг хамардаг.
• Хэрэглэгчид эдгээр API-г ашиглан микроконтроллерийн техник хангамжтай үр дүнтэй ажиллах боломжтой.

Танилцуулга

STM32Cube нь STMicroelectronics-ийн анхны санаачилга бөгөөд хөгжүүлэлтийн хүчин чармайлт, цаг хугацаа, зардлыг бууруулах замаар дизайнерын бүтээмжийг мэдэгдэхүйц нэмэгдүүлэх зорилготой юм. STM32Cube нь STM32 багцыг бүхэлд нь хамардаг. STM32Cube нь:

STM32Cube нь:

• Төсөл боловсруулахаас эхлээд хэрэгжүүлэх хүртэл ашиглахад зориулагдсан хэрэглэгчдэд ээлтэй програм хангамж хөгжүүлэх хэрэгслүүдийн багц бөгөөд үүнд:
  • STM32CubeMX нь график шидтэнг ашиглан C эхлүүлэх кодыг автоматаар үүсгэх боломжийг олгодог график програм хангамжийн тохиргооны хэрэгсэл юм.
  • STM32CubeIDE нь захын тохиргоо, код үүсгэх, код эмхэтгэх, дибаг хийх функц бүхий бүгдийг нэг дор хөгжүүлэх хэрэгсэл юм.
  • STM32CubeCLT нь код эмхэтгэх, самбарын програмчлал болон дибаг хийх функц бүхий командын мөрийг боловсруулах хэрэгслийн багц юм.
  • STM32CubeProgrammer (STM32CubeProg), график болон командын мөрийн хувилбаруудад байдаг програмчлалын хэрэгсэл
  • STM32CubeMonitor (STM32CubeMonitor, STM32CubeMonPwr, STM32CubeMonRF, STM32CubeMonUCPD), бодит цаг хугацаанд STM32 програмын зан байдал, гүйцэтгэлийг нарийн тохируулах хүчирхэг хяналтын хэрэгсэл.
• STM32Cube MCU болон MPU багцууд, микроконтроллер болон микропроцессорын цуврал тус бүрт тусгайлан зориулсан цогц програм хангамжийн платформууд (STM32WL3x бүтээгдэхүүний шугамд зориулсан STM32CubeWL3 гэх мэт), үүнд:
  • STM32Cube техник хангамжийн хийсвэр давхарга (HAL) нь STM32 багцын хамгийн их зөөврийг баталгаажуулдаг.
  • STM32Cube бага түвшний API-ууд нь техник хангамжийг хэрэглэгчийн өндөр түвшний хяналтаар хамгийн сайн гүйцэтгэл, ул мөрийг баталгаажуулдаг.
  • FreeRTOS™ цөм, FatFS, болон Sigfox™ зэрэг дундын програм хангамжийн бүрэлдэхүүн хэсгүүдийн тогтвортой багц
  • Захын болон хэрэглээний иж бүрэн багц бүхий бүх суулгагдсан програм хангамжийн хэрэгслүүдamples
• STM32Cube MCU болон MPU багцуудын функцийг нөхөх програм хангамжийн бүрэлдэхүүн хэсгүүдийг агуулсан STM32Cube өргөтгөлийн багцууд:
  • Дунд програмын өргөтгөлүүд болон хэрэглээний давхаргууд
  • Examples зарим тодорхой STMicroelectronics хөгжүүлэлтийн самбар дээр ажиллаж байна
• Энэхүү хэрэглэгчийн гарын авлага нь STM32CubeWL3 MCU багцыг хэрхэн ашиглаж эхлэх талаар тайлбарласан болно.

2-р бүлэгт STM32CubeWL3-ийн үндсэн шинж чанаруудыг тайлбарласан бөгөөд 3-р хэсэгт илүү дэлгэрэнгүй мэдээллийг өгдөг.view түүний архитектур болон MCU багц бүтэц.

Ерөнхий мэдээлэл

• STM32CubeWL3 Arm® Cortex®‑M32+ процессор дээр суурилсан STM3WL0x бүтээгдэхүүний шугамын микроконтроллерууд дээр Sigfox™ хоёртын файлуудыг багтаасан дэд GHz-ийн үзүүлэх програмуудыг ажиллуулдаг.
• STM32WL3x микроконтроллерууд нь STMicroelectronics-ийн хамгийн сүүлийн үеийн дэд GHz-д нийцсэн RF радио захын төхөөрөмжийг суурилуулсан бөгөөд энэ нь хэт бага эрчим хүч зарцуулалт, маш сайн радио гүйцэтгэл, батерейны ашиглалтын хугацааг уртасгах боломжийг олгодог.

Жич: Arm бол АНУ ба/эсвэл өөр газар дахь Arm Limited (эсвэл түүний охин компаниуд) компанийн бүртгэгдсэн худалдааны тэмдэг юм.

STM32CubeWL3 үндсэн шинж чанарууд

• STM32CubeWL3 MCU багц нь Arm® Cortex®‑M32+ процессор дээр суурилсан STM32 0 битийн микроконтроллерууд дээр ажилладаг. Энэ нь програм боловсруулахад шаардлагатай бүх ерөнхий суулгагдсан програм хангамжийн бүрэлдэхүүн хэсгүүдийг нэг багцад цуглуулдаг. STM32WL3x бүтээгдэхүүний шугам микроконтроллерууд.
• Багц нь микроконтроллерийн техник хангамжийг хамарсан бага давхарга (LL) ба техник хангамжийн хийсвэрлэх давхарга (HAL) API-ууд болон өргөн хүрээний багцуудыг агуулдаг.ampSTMicroelectronics самбар дээр ажиллаж байгаа les. HAL болон LL API-уудыг хэрэглэгчдэд тав тухтай байлгах үүднээс нээлттэй эхийн BSD лицензээр авах боломжтой. Энэ нь мөн Sigfox™, FatFS, болон FreeRTOS™ цөмийн дундын програм хангамжийн бүрэлдэхүүн хэсгүүдийг агуулдаг.
• STM32CubeWL3 MCU багц нь мөн түүний бүх дунд програмын бүрэлдэхүүн хэсгүүдийг хэрэгжүүлэх хэд хэдэн програм, үзүүлэнгүүдийг өгдөг.
• STM32CubeWL3 MCU багцын бүрэлдэхүүн хэсгийн бүтцийг 1-р зурагт үзүүлэв.

STM32CubeWL3 архитектур дууссанview

• STM32CubeWL3 MCU багц шийдэл нь Зураг 2-т тайлбарласны дагуу хялбар харилцан үйлчилдэг бие даасан гурван түвшний эргэн тойронд бүтээгдсэн.

0-р түвшин
Энэ түвшинг гурван дэд давхаргад хуваадаг.

• Зөвлөлийн дэмжлэгийн багц (BSP).
• Техник хангамжийн хийсвэр давхарга (HAL):
  • HAL захын драйверууд
  • Бага түвшний драйверууд
• Үндсэн захын хэрэглээ жишээ ньamples.

Зөвлөлийн дэмжлэгийн багц (BSP)
Энэ давхарга нь техник хангамжийн самбар дээрх техник хангамжийн бүрэлдэхүүн хэсгүүдтэй (LED, товчлуурууд, COM драйверууд гэх мэт) хамааралтай API багцуудыг санал болгодог. Энэ нь хоёр хэсгээс бүрдэнэ:

Бүрэлдэхүүн хэсэг:

• Энэ нь STM32 биш харин самбар дээрх гадаад төхөөрөмжтэй холбоотой драйвер юм. Бүрэлдэхүүн хэсгийн драйвер нь BSP драйверын гадаад бүрэлдэхүүн хэсгүүдэд тусгай API-уудыг өгдөг бөгөөд бусад самбар дээр зөөврийн байж болно.
  • BSP драйвер:
• Энэ нь бүрэлдэхүүн хэсгийн драйверуудыг тодорхой самбарт холбох боломжийг олгодог бөгөөд хэрэглэгчдэд ээлтэй API-уудын багцыг өгдөг. API нэрлэх дүрэм нь BSP_FUNCT_Action().
• Example: BSP_LED_Init(), BSP_LED_On()

BSP нь модульчлагдсан архитектур дээр суурилдаг бөгөөд зөвхөн доод түвшний горимуудыг хэрэгжүүлснээр ямар ч техник хангамжийг хялбархан шилжүүлэх боломжийг олгодог.

Техник хангамжийн хийсвэр давхарга (HAL) ба бага давхарга (LL)

STM32CubeWL3 HAL болон LL нь нэмэлт бөгөөд өргөн хүрээний хэрэглээний шаардлагыг хамардаг:

• HAL драйверууд нь өндөр түвшний функцэд чиглэсэн өндөр зөөврийн API-г санал болгодог. Тэд эцсийн хэрэглэгчдэд MCU болон захын нарийн төвөгтэй байдлыг нуудаг.
  HAL драйверууд нь ашиглахад бэлэн процессуудыг бий болгосноор хэрэглэгчийн програмын хэрэгжилтийг хялбаршуулдаг ерөнхий олон тохиолдолт онцлогт чиглэсэн API-уудыг өгдөг. Жишээ ньample, холбооны захын төхөөрөмжүүдийн хувьд (I2C, UART болон бусад) энэ нь захын төхөөрөмжийг эхлүүлэх, тохируулах, санал асуулга, тасалдал эсвэл DMA процесс дээр үндэслэн өгөгдөл дамжуулах, харилцааны явцад гарч болзошгүй харилцааны алдааг зохицуулах боломжийг олгодог API-уудыг өгдөг. HAL драйвер API нь хоёр ангилалд хуваагдана:
  • Бүх STM32 цуврал микроконтроллеруудад нийтлэг болон ерөнхий функцүүдийг хангадаг ерөнхий API-ууд.
  • Тодорхой гэр бүл эсвэл тодорхой хэсгийн дугаарт тусгайлан тохируулсан функцуудыг хангадаг өргөтгөлийн API.
• Доод түвшний API-ууд нь бүртгэлийн түвшинд доод түвшний API-г өгдөг бөгөөд илүү оновчтой боловч зөөвөрлөх чадвар багатай.
  Тэд MCU болон захын техникийн үзүүлэлтүүдийн талаар гүнзгий мэдлэг шаарддаг.
  LL драйверууд нь HAL-аас илүү техник хангамжид ойр, хурдан хөнгөн жинтэй, шинжээчдэд чиглэсэн давхаргыг санал болгохоор бүтээгдсэн. HAL-аас ялгаатай нь LL API нь оновчтой хандалт нь гол шинж чанар биш, эсвэл хүнд програм хангамжийн тохиргоо эсвэл нарийн төвөгтэй дээд түвшний стек шаарддаг захын төхөөрөмжүүдэд зориулагдсангүй.
  LL драйверуудын онцлог нь:
• Өгөгдлийн бүтцэд заасан параметрийн дагуу захын үндсэн функцуудыг эхлүүлэх функцүүдийн багц.
• Эхлэх өгөгдлийн бүтцийг талбар бүрт тохирох дахин тохируулах утгуудаар дүүргэх функцүүдийн багц.
• Захын төхөөрөмжийг идэвхгүй болгох функц (захын регистрүүдийг анхдагч утгаараа сэргээсэн).
• Шууд болон атомын бүртгэлд хандах зориулалттай шугаман функцүүдийн багц.
• HAL-аас бүрэн хараат бус, бие даасан горимд (HAL драйвергүйгээр) ашиглах боломжтой.
• Дэмжигдсэн захын функцүүдийн бүрэн хамрах хүрээ.

Үндсэн захын хэрэглээ жишээ ньamples
Энэ давхарга нь өмнөх давхаргыг хамардагampЗөвхөн HAL болон BSP нөөцийг ашиглан STM32 захын төхөөрөмж дээр бүтээгдсэн.
Жич: Жагсаал өмнөхamples нь илүү төвөгтэй экс харуулах боломжтойampMRSUBG болон LPAWUR зэрэг тусгай дагалдах төхөөрөмжтэй хувилбарууд.

1-р түвшин
Энэ түвшинг хоёр дэд давхаргад хуваадаг.

• Дунд програмын бүрэлдэхүүн хэсгүүд
• Exampдунд програмын бүрэлдэхүүн хэсгүүд дээр суурилсан les

Дунд програмын бүрэлдэхүүн хэсгүүд
Дунд програм нь FreeRTOS™ цөм, FatFS, Sigfox™ протоколын санг хамарсан сангуудын багц юм.
Энэ давхаргын бүрэлдэхүүн хэсгүүдийн хоорондох хэвтээ харилцан үйлчлэл нь онцолсон API-г дуудах замаар хийгддэг.
Доод түвшний драйверуудтай босоо харилцан үйлчлэл нь номын сангийн системийн дуудлагын интерфейс дээр хэрэгжсэн тодорхой буцаан дуудлагууд болон статик макронуудаар хийгддэг.
Дунд зэргийн програм хангамжийн бүрэлдэхүүн хэсэг бүрийн үндсэн шинж чанарууд нь дараах байдалтай байна.

• FreeRTOS™ цөм: суулгагдсан системд зориулагдсан бодит цагийн үйлдлийн системийг (RTOS) хэрэгжүүлдэг.
• Sigfox ™: Sigfox ™ протоколын сүлжээнд нийцсэн Sigfox ™ протоколын санг хэрэгжүүлдэг ба RF Sigfox ™ хэрэгслүүдийн эсрэг тест хийх RF тестийн протоколын санг агуулдаг.
• FatFS: ерөнхий FAT-ийг хэрэгжүүлдэг file системийн модуль.

Exampдунд програмын бүрэлдэхүүн хэсгүүд дээр суурилсан les

• Дунд програмын бүрэлдэхүүн хэсэг бүр нэг буюу хэд хэдэн экс-тэй ирдэгamples, мөн програм гэж нэрлэдэг, хэрхэн ашиглахыг харуулж байна.
• Интеграци жишээлбэлampДундын програм хангамжийн хэд хэдэн бүрэлдэхүүн хэсгүүдийг ашигладаг.

STM32CubeWL3 програм хангамжийн багц дууссанview

STM32WL3x төхөөрөмж болон техник хангамжийг дэмждэг

• STM32Cube нь ерөнхий архитектурын эргэн тойронд баригдсан өндөр зөөврийн техник хангамжийн хийсвэр давхарга (HAL) -ийг санал болгодог. Энэ нь MCU-г юунд ашигладаг болохыг мэдэхгүй, гүнзгийрүүлэн мэдэхгүйгээр давхаргын давхаргыг ашиглах гэх мэт давхаргыг бий болгох зарчмыг зөвшөөрдөг. Энэ нь номын сангийн кодыг дахин ашиглах боломжийг сайжруулж, бусад төхөөрөмжид хялбар зөөвөрлөх боломжийг олгодог.
• Үүнээс гадна давхаргат архитектураараа STM32CubeWL3 STM32WL3x бүтээгдэхүүний бүх шугамд бүрэн дэмжлэг үзүүлдэг.
• Хэрэглэгч зөвхөн stm32wl3x.h дээр зөв макро тодорхойлох ёстой.
• Хүснэгт 1-д ашигласан STM32WL3x бүтээгдэхүүний шугамын төхөөрөмжөөс хамааран тодорхойлох макрог харуулав. Энэ макро нь хөрвүүлэгчийн урьдчилсан процессорт мөн тодорхойлогдсон байх ёстой.

Хүснэгт 1. STM32WL3x бүтээгдэхүүний шугамын макро

Макро-д тодорхойлсон STM32WL3X.h	STM32WL3x бүтээгдэхүүний шугамын төхөөрөмжүүд
stm32wl3x	STM32WL30xx микроконтроллерууд STM32WL31xx микроконтроллерууд STM32WL33xx микроконтроллерууд

Хүснэгт 2. STM32WL3x бүтээгдэхүүний шугамын самбар

Удирдах зөвлөл	STM32WL3x хавтанг дэмждэг төхөөрөмжүүд
NUCLEO-WL33CC1	STM32WL33CC
NUCLEO-WL33CC2	STM32WL33CC

STM32CubeWL3 MCU багц нь ямар ч нийцтэй техник хангамж дээр ажиллах боломжтой. Хэрэглэгчид BSP драйверуудыг шинэчилж, өгөгдсөн хуучин хувилбарыг порт руу шилжүүлдэгampхэрэв тэдгээр нь ижил техник хангамжийн шинж чанартай бол (LED эсвэл товчлуур гэх мэт) самбар дээр байгаа бол.

Програм хангамжийн багц дууссанview

• STM32CubeWL3 MCU багцын шийдэл нь Зураг 3-т үзүүлсэн бүтэцтэй, нэг зип багцаар хангагдсан болно.

Анхааруулга: Хэрэглэгч бүрэлдэхүүн хэсгүүдийг өөрчлөх ёсгүй fileс. Хэрэглэгч зөвхөн \Projects эх сурвалжийг засах боломжтой. Самбар бүрийн хувьд хуучин багцamples нь EWARM, MDK-ARM болон STM32CubeIDE хэрэгслийн гинжин хэлхээнд зориулж урьдчилан тохируулсан төслүүдээр хангагдсан.
Зураг 4-т NUCLEO-WL33CCx хавтангийн төслийн бүтцийг харуулав.

эксamples-г хэрэглэх STM32CubeWL3 түвшингээс хамааран ангилдаг. Тэдгээрийг дараах байдлаар нэрлэсэн.

• 0-р түвшний өмнөхamples-ийг Ex гэж нэрлэдэгamples, Examples_LL болон Examples_MIX. Тэд HAL драйверууд, LL драйверууд болон HAL болон LL драйверуудын холимогийг ямар ч дундын програм хангамжийн бүрэлдэхүүн хэсэггүйгээр ашигладаг. Жагсаал өмнөхamples бас боломжтой.
• 1-р түвшний өмнөхampпрограмууд гэж нэрлэдэг. Эдгээр нь дунд програмын бүрэлдэхүүн хэсэг бүрийн ердийн хэрэглээний тохиолдлыг өгдөг.

Өгөгдсөн самбарт зориулсан ямар ч програм хангамжийн програмыг Templates болон Templates_LL лавлах хэсэгт байгаа загвар төслүүдийг ашиглан хурдан бүтээх боломжтой.
Examples, Examples_LL болон Examples_MIX ижил бүтэцтэй:

• Бүх толгой хэсгийг агуулсан \Inc хавтас files.
• Эх код агуулсан \Src хавтас.
• \EWARM, \MDK-ARM болон \STM32CubeIDE хавтаснууд нь багажны хэлхээ тус бүрийн урьдчилан тохируулсан төслийг агуулсан.
• readme.md болон readme.html эксийг тайлбарласанample зан байдал, түүнийг ажиллуулахад шаардлагатай орчин.

STM32CubeWL3-ийг ашиглаж эхэлж байна

Анхны эксийг ажиллуулж байнаample
Энэ хэсэгт анхны экс-ыг ажиллуулах нь хичнээн энгийн болохыг тайлбарладагample STM32CubeWL3 дотор. Энэ нь NUCLEO-WL33CC1 самбар дээр ажилладаг энгийн LED унтраалга үүсгэх жишээг ашигласан болно.

1. STM32CubeWL3 MCU багцыг татаж аваарай.
2. Үүнийг задлах эсвэл суулгагчийг суулгасан бол өөрийн сонгосон лавлах руу ажиллуул.
3. Зураг 3-т үзүүлсэн багцын бүтцийг өөрчлөхгүй байхыг анхаарна уу. STM32CubeWL3 програмын багцын бүтцийг. Зарим IDE-д зам хэт урт байвал асуудалтай тулгардаг тул багцыг эх эзлэхүүнтэй ойрхон (C:\ST эсвэл G:\Tests гэсэн үг) хуулахыг зөвлөж байна.

HAL экс-г хэрхэн ажиллуулах вэample
Ачаалах, ажиллуулахын өмнө эксampле, эксийг уншихыг зөвлөж байнаampнамайг унш file ямар нэгэн тодорхой тохиргооны хувьд.

1. \Projects\NUCLEO-WL33CC\Жишamples.
2. \GPIO, дараа нь \GPIO_EXTI фолдеруудыг нээнэ үү.
3. Төслийг сонгосон хэрэгслийн гинжээр нээнэ үү. Түргэн дууслааview экс-ыг хэрхэн нээх, бүтээх, ажиллуулах талаарampДэмжигдсэн хэрэгслийн гинж бүхий le-г доор өгөв.
4. Бүгдийг нь сэргээ files ба дүрсийг зорилтот санах ойд ачаална.
5. Эксийг ажиллуулample. Дэлгэрэнгүй мэдээллийг экс-ээс авна ууampнамайг унш file.

Эксийг нээх, бүтээх, ажиллуулахampДэмжигдсэн хэрэгслийн гинж тус бүрийг ашиглан дараах алхмуудыг дагана уу.

• EWARM:
  1. Экс доорamples хавтас руу ороод \EWARM дэд хавтасыг нээнэ үү.
  2. Project.eww ажлын талбарыг ажиллуулна уу (ажлын талбарын нэр нэг өмнөхөөс өөрчлөгдөж магадгүйampнөгөө рүү).
  3. Бүгдийг нь сэргээ files: [Төсөл]>[Бүгдийг дахин бүтээх].
  4. Төслийн зургийг ачаална уу: [Төсөл]> [Дабаг].
  5. Програмыг ажиллуулна уу: [Debug]>[Go (F5)].
• MDK-ARM:
  1. Экс доорamples хавтас руу ороод \MDK-ARM дэд хавтасыг нээнэ үү.
  2. Project.uvproj ажлын талбарыг нээнэ үү (ажлын талбарын нэр нэг хуучин байснаас өөрчлөгдөж магадгүйampнөгөө рүү).
  3. Бүгдийг нь сэргээ files: [Төсөл]>[Бүх зорилтыг дахин бүтээх files].
  4. Төслийн зургийг ачаална уу: [Дбаг]>[Дабаг хийх сессийг эхлүүлэх/ зогсоох].
  5. Програмыг ажиллуулна уу: [Debug]>[Run (F5)].
• STM32CubeIDE:
  1. STM32CubeIDE хэрэгслийн сүлжээг нээнэ үү.
  2. Дээр товшино уу [File]>[Ажлын талбарыг сэлгэх]>[Бусад] руу ороод STM32CubeIDE ажлын талбарын лавлах руу очно уу.
  3. Дээр товшино уу [File]>[Импорт], [Ерөнхий]> [Ажлын талбарт байгаа төслүүд]-г сонгоод, [Дараах] дээр дарна уу.
  4. STM32CubeIDE ажлын талбарын лавлах руу орж төслийг сонго.
  5. Бүх төслийг дахин бүтээх files: Project Explorer цонхноос төслөө сонгоод [Project]>[Build project] цэсийг дарна уу.
  6. Програмыг ажиллуулна уу: [Run]> [Debug (F11)].

Захиалгат програм боловсруулах

STM32CubeMX ашиглан программыг хөгжүүлэх эсвэл шинэчлэх

• STM32Cube MCU багцад бараг бүх төслийн өмнөхamples нь STM32CubeMX хэрэглүүрийн тусламжтайгаар систем, захын төхөөрөмж болон дунд програмыг эхлүүлэхэд зориулагдсан.

Одоо байгаа төслийг шууд ашиглах жишээлбэлampSTM32CubeMX хэрэглүүрийн хувьд STM32CubeMX 6.12.0 буюу түүнээс дээш хувилбар шаардлагатай:

• STM32CubeMX суулгасны дараа санал болгож буй төслийг нээж, шаардлагатай бол шинэчилнэ үү.
  Одоо байгаа төслийг нээх хамгийн энгийн арга бол *.ioc дээр давхар товших явдал юм file Ингэснээр STM32CubeMX нь төсөл болон түүний эх сурвалжийг автоматаар нээдэг fileс. STM32CubeMX нь ийм төслүүдийн эхлүүлэх эх кодыг үүсгэдэг.
• Програмын үндсэн эх код нь "ХЭРЭГЛЭГЧИЙН КОД ЭХЛҮҮЛЭХ" болон "ХЭРЭГЛЭГЧИЙН КОД Төгсгөл" гэсэн тайлбаруудаас бүрдэнэ. Хэрэв захын сонголт болон тохиргоог өөрчилсөн бол STM32CubeMX нь үндсэн програмын эх кодыг хадгалахын зэрэгцээ кодын эхлүүлэх хэсгийг шинэчилдэг.
• STM32CubeMX ашиглан захиалгат төсөл боловсруулахын тулд алхам алхмаар үйл явцыг дагана уу:
  1. Зөрчилдөөнийг шийдэгч, цагийн модыг тохируулах туслах, эрчим хүчний хэрэглээний тооцоолуур болон MCU захын тохиргоог гүйцэтгэдэг хэрэгсэл (GPIO эсвэл USART гэх мэт) ашиглан шаардлагатай бүх суулгагдсан програм хангамжийг тохируулна уу.
  2. Сонгосон тохиргоонд үндэслэн эхлүүлэх C кодыг үүсгэнэ. Энэ код нь хэд хэдэн хөгжүүлэлтийн орчинд ашиглахад бэлэн байна. Хэрэглэгчийн код нь дараагийн код үүсгэх үед хадгалагдана.
     STM32CubeMX-ийн талаар нэмэлт мэдээлэл авахыг хүсвэл STM32-г тохируулах болон эхлүүлэх C код үүсгэх (UM32) STM1718CubeMX хэрэглэгчийн гарын авлагаас үзнэ үү.

Жолооч програмууд
HAL програм
Энэ хэсэгт STM32CubeWL3 ашиглан тусгай HAL програм үүсгэхэд шаардагдах алхмуудыг тайлбарласан

1. Төсөл үүсгэх
   Шинэ төсөл үүсгэхийн тулд \Projects\ хэсэгт байгаа самбар тус бүрийн загвар төслөөс эхлүүлнэ үү. \Загварууд эсвэл \Projects\ хэсэгт байгаа боломжтой төслүүдээс \Жишээ ньamples эсвэл \Proj ects\ \Програмууд (хаана самбарын нэрийг хэлнэ).
   Загвар төсөл нь хоосон үндсэн давталтын функцээр хангадаг. Гэсэн хэдий ч, энэ нь STM32CubeWL3 төслийн тохиргоог ойлгоход сайн эхлэл юм. Загвар нь дараахь шинж чанартай байдаг.
   • Энэ нь HAL эх код, CMSIS болон BSP драйверуудыг агуулдаг бөгөөд эдгээр нь тухайн самбар дээр код боловсруулахад шаардагдах хамгийн бага бүрэлдэхүүн хэсэг юм.
   • Энэ нь програм хангамжийн бүх бүрэлдэхүүн хэсгүүдийн замуудыг агуулдаг.
   • Энэ нь дэмжигдсэн STM32WL3x бүтээгдэхүүний шугамын төхөөрөмжүүдийг тодорхойлж, CMSIS болон HAL драйверуудыг зөв тохируулах боломжийг олгодог.
   • Энэ нь ашиглахад бэлэн хэрэглэгчээр хангадаг fileдоор үзүүлсэн шиг урьдчилан тохируулсан:
   • HAL-г Arm® core SysTick-ээр анхдагч цагийн суурьтай болгосон.
   • SysTick ISR нь HAL_Delay() зорилгоор хэрэгжсэн.
   • Тайлбар: Одоо байгаа төслийг өөр байршилд хуулахдаа оруулсан бүх замууд шинэчлэгдсэн эсэхийг шалгаарай.
2. Програм хангамжийн бүрэлдэхүүн хэсгүүдийг тохируулна уу
   HAL болон дунд програмын бүрэлдэхүүн хэсгүүд нь толгой хэсэгт зарласан #define макронуудыг ашиглан бүтээх цагийн тохиргооны багц сонголтыг санал болгодог. file. Загварын тохиргоо file Бүрэлдэхүүн хэсэг тус бүрд өгөгдсөн бөгөөд үүнийг төслийн хавтсанд (ихэвчлэн тохиргоо file фрагментийг xxx_conf_template.h гэж нэрлэдэг
   • Загварыг төслийн хавтас руу хуулахдаа устгах шаардлагатай). Тохиргоо file тохиргооны сонголт бүрийн нөлөөллийг ойлгох хангалттай мэдээллийг өгдөг. Бүрэлдэхүүн хэсэг тус бүрээр өгөгдсөн баримт бичигт илүү нарийвчилсан мэдээллийг авах боломжтой.
3. HAL номын санг эхлүүлнэ үү
   Үндсэн програм руу шилжсэний дараа програмын код нь HAL_Init() API-г дуудаж, дараах ажлуудыг гүйцэтгэдэг HAL номын санг эхлүүлэх шаардлагатай.
   • Флэш санах ойг урьдчилан татах болон SysTick тасалдлын тэргүүлэх чиглэлийн тохиргоо (stm32 wl3x_hal_conf.h-д тодорхойлсон макрогоор).
   • stm32wl3x_hal_conf.h-д тодорхойлсон TICK_INT_PRIO SysTick тасалдлын тэргүүлэх чиглэлд миллисекунд тутамд тасалдал үүсгэх SysTick-ийн тохиргоо.
   • NVIC бүлгийн тэргүүлэх чиглэлийг 0 болгож тохируулна уу.
   • stm32wl3x_hal_msp.c хэрэглэгчдэд тодорхойлсон HAL_MspInit() буцаан дуудах функцийн дуудлага file дэлхийн доод түвшний техник хангамжийг эхлүүлэх.
4. Системийн цагийг тохируулна уу
   Системийн цагийн тохиргоог доор тайлбарласан хоёр API-г дуудах замаар хийдэг.
   • HAL_RCC_OscConfig(): энэ API нь дотоод болон гадаад осцилляторыг тохируулдаг. Хэрэглэгч өөрөө сонгоно
     нэг буюу бүх осцилляторыг тохируулах.
   • HAL_RCC_ClockConfig(): энэ API нь системийн цагийн эх үүсвэр, флаш санах ойн хоцрогдол, AHB болон APB тохируулагчийг тохируулдаг.
5. Захын төхөөрөмжийг эхлүүлэх
   • Эхлээд захын төхөөрөмжийг эхлүүлэх функцийг бичнэ үү. Дараах байдлаар гүйцэтгэнэ.
   • Захын цагийг идэвхжүүлнэ үү.
   • Захын GPIO-г тохируулна уу.
   • DMA сувгийг тохируулж, DMA тасалдлыг идэвхжүүлнэ (шаардлагатай бол).
   • Захын тасалдлыг идэвхжүүлэх (шаардлагатай бол).
   • Шаардлагатай бол stm32xxx_it.c-г засварлаж, шаардлагатай тасалдал зохицуулагчийг (захын болон DMA) дуудна уу.
   • Хэрэв захын тасалдал эсвэл DMA ашиглахаар төлөвлөж байгаа бол процессын бүрэн дуудлагын функцуудыг бичнэ үү.
   • Хэрэглэгчийн үндсэн хэсэгт.c file, захын бариулын бүтцийг эхлүүлж, захын төхөөрөмжийг эхлүүлэхийн тулд захын эхлүүлэх функцийг дууд.
6. Аппликейшн боловсруулах
   Энэ үед сtage, систем бэлэн болсон бөгөөд хэрэглэгчийн програмын код боловсруулж эхлэх боломжтой.
   HAL нь захын төхөөрөмжийг тохируулахад хялбар, ашиглахад бэлэн API-уудыг өгдөг. Энэ нь санал асуулга, тасалдал, DMA програмчлалын загварыг дэмждэг бөгөөд аливаа програмын шаардлагыг хангадаг. Дагалдах төхөөрөмж тус бүрийг хэрхэн ашиглах талаар дэлгэрэнгүй мэдээллийг rich ex-ээс авна ууample багцыг STM32CubeWL3 MCU багцад өгсөн.

Анхааруулга: Анхдагч HAL хэрэгжилтэд SysTick таймерыг цагийн суурь болгон ашигладаг: энэ нь тогтмол хугацааны интервалаар тасалдлыг үүсгэдэг. Хэрэв HAL_Delay() нь захын ISR процессоос дуудагдсан бол SysTick тасалдал захын тасалдлаас өндөр ач холбогдолтой (тоон хувьд бага) байгаа эсэхийг шалгаарай. Үгүй бол дуудагч ISR процесс хаагдана. Хугацааны сангийн тохиргоонд нөлөөлж буй функцуудыг __сул гэж зарласан бөгөөд ингэснээр хэрэглэгч бусад хэрэгжүүлэлтийн үед хүчингүй болгох боломжтой болно. file (ерөнхий зориулалтын таймер ашиглан, жишээ ньample, эсвэл өөр цаг хугацааны эх сурвалж). Дэлгэрэнгүй мэдээллийг HAL_TimeBase-с үзнэ үүample.

LL програм
Энэ хэсэгт STM32CubeWL3 ашиглан захиалгат LL программ үүсгэхэд шаардлагатай алхмуудыг тайлбарласан болно.

1. Төсөл үүсгэх
   Шинэ төсөл үүсгэхийн тулд \Projects\ хэсэгт самбар тус бүрд өгсөн Templates_LL төслөөс эхэлнэ үү. \Templates_LL эсвэл \Projects\ доор байгаа аль ч боломжтой төслөөс \Жишээ ньamples_ LL ( NUCLEO-WL32CC33 гэх мэт самбарын нэрийг хэлнэ).
   Загварын төсөл нь хоосон гол давталтын функцээр хангадаг бөгөөд энэ нь STM32CubeWL3-ийн төслийн тохиргоог ойлгоход сайн эхлэл юм. Загварын үндсэн шинж чанарууд нь дараах байдалтай байна.
   • Энэ нь LL болон CMSIS драйверуудын эх кодыг агуулдаг бөгөөд энэ нь тухайн самбар дээрх кодыг боловсруулахад шаардагдах хамгийн бага бүрэлдэхүүн хэсэг юм.
   • Энэ нь шаардлагатай бүх програм хангамжийн бүрэлдэхүүн хэсгүүдийн замуудыг агуулдаг.
   • Энэ нь дэмжигдсэн STM32WL3x бүтээгдэхүүний шугамын төхөөрөмжийг сонгож, CMSIS болон LL драйверуудыг зөв тохируулах боломжийг олгодог.
   • Энэ нь хэрэглэгчийг ашиглахад бэлэн болгодог fileдараах байдлаар урьдчилан тохируулсан байна:
   • main.h: LED ба USER_BUTTON тодорхойлолтын хийсвэр давхарга.
   • main.c: Хамгийн их давтамжийн системийн цагийн тохиргоо.
2. LL хуучин портampле:
   • Анхны эх сурвалжийг хадгалахын тулд Templates_LL фолдерыг хуулах/оруулах эсвэл одоо байгаа Template s_LL төслийг шууд шинэчлэх.
   • Дараа нь зөөвөрлөх нь үндсэндээ Templates_LL-ийг орлуулахаас бүрдэнэ files by Examples_LL зорилтот төсөл.
   • Самбарын бүх тусгай хэсгүүдийг хадгал. Тодорхой болгох үүднээс самбарын тодорхой хэсгүүдийг тусгайлан тэмдэглэсэн болно tags:
   • Тиймээс зөөвөрлөх үндсэн алхамууд нь дараах байдалтай байна.
   • stm32wl3x_it.h-г солино уу file.
   • stm32wl3x_it.c-г солино уу file.
   • Үндсэн.h-г солих file болон үүнийг шинэчлэх: LL загварын LED болон хэрэглэгчийн товчлуурын тодорхойлолтыг ЗӨВЛӨГИЙН ТУСГАЙ ТОХИРУУЛГА доор хадгална уу. tags.
   • Үндсэн хэсгийг солих.c file мөн шинэчлэх:
   • SystemClock_Config() LL загварын функцийн цагийн тохиргоог ЗӨВЛӨГИЙН ТУСГАЙ ТОХИРУУЛГА дор хадгална уу. tags.
   • LED-ийн тодорхойлолтоос хамааран LDx тохиолдол бүрийг өөр LDy-ээр солино file гол.х.
   • Эдгээр өөрчлөлтүүдээр эксample зорилтот самбар дээр гүйдэг.

RF-ийн програмууд, жагсаалууд, жишээлбэлamples
Төрөл бүрийн RF-ийн хэрэглээ, жагсаал, жишээлбэлamples STM32CubeWL3 багцад байдаг.
Тэдгээрийг доорх хоёр хэсэгт жагсаав.

Дэд GHz жишээлбэлamples болон жагсаал
Эдгээр өмнөхamples нь MRSUBG болон LPAWUR радио нэмэлт төхөөрөмжүүдийн үндсэн шинж чанаруудыг харуулдаг. Эдгээр өмнөхamples доор байдаг:

• Төслүүд\NUCLEO-WL33CC\Жишamples\MRSUBG
• Төслүүд\NUCLEO-WL33CC\Жишamples\LPAWUR
• Төслүүд\NUCLEO-WL33CC\Жагсаал\MRSUBG
• Төслүүд \ NUCLEO-WL33CC \ Жагсаал \ LPAWUR

Хуучин бүрample эсвэл үзүүлэн нь ерөнхийдөө Tx болон Rx гэсэн хоёр программаас бүрдэх ба дамжуулагч болон хүлээн авагчийн үүрэг гүйцэтгэдэг:

Examples/MRSUBG

• MRSUBG_802_15_4: 802.15.4 стандартаар тодорхойлсон физик давхаргын хэрэгжилт. Энэ нь 802.15.4 пакетуудыг дамжуулах эсвэл хүлээн авах радиог хэрхэн тохируулахыг харуулж байна.
• MRSUBG_BasicGeneric: STM32WL3x MR_SUBG үндсэн пакетуудын солилцоо.
• MRSUBG_Chat: Tx болон Rx-ийг нэг төхөөрөмж дээр хэрхэн ашиглахыг харуулсан энгийн программ.
• MRSUBG_DatabufferHandler: Хуучинample нь Databuffer 0 ба 1-ээс хэрхэн солигдохыг харуулдаг.
• MRSUBG_Sequencer AutoAck: Жишээ ньample нь пакет хүлээн зөвшөөрлийг (ACKs) автоматаар дамжуулж, хүлээн авдаг.
• MRSUBG_WMBusSTD: WM-Bus мессеж солилцох.
• WakeupRadio: Хуучинample LPAWUR радио захын төхөөрөмжийг турших.

Жагсаал/MRSUBG

• MRSUBG_RTC_Button_TX: Энэ жишээ ньample нь SoC-г гүн зогсолтын горимд хэрхэн тохируулах, MRSUBG-г PB2 товчийг дарж фрейм илгээх эсвэл RTC таймерын хугацаа дууссаны дараа SoC-г сэрээхээр тохируулахыг харуулж байна.
• MRSUBG_Sequencer_Sniff: Энэ жишээ ньample нь MRSUBG дараалагчийг үнэрлэх горимд хэрхэн тохируулахыг харуулж байна. Энэ эксample нь хүлээн авагч талыг харуулж, дамжуулагчийн хувьд өөр төхөөрөмж шаарддаг.
• MRSUBG_Timer: Аппликешн нь өөр өөр хугацааны интервалтай MRSUBG таймерын хэд хэдэн тохиолдлыг (автоматаар дахин ачаалах) хуваарьтай.
• MRSUBG_WakeupRadio_Tx: Энэ жишээ ньample нь SoC-г гүн зогсолтын горимд хэрхэн тохируулах, MRSUBG-г PB2 товчийг дарж фрэйм ​​илгээх замаар SoC-г сэрээх тохиргоог тайлбарлана. Энэ эксample нь дамжуулагчийн талыг харуулсан бөгөөд LPAWUR хүлээн авагчийн хувьд өөр төхөөрөмж шаарддаг. Хүлээн авагч өмнөхample нь NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRadio_Rx хавтас дор байрладаг.

Жагсаал/LPAWUR

• LPAWUR_WakeupRadio_Rx: Энэ жишээ ньample нь SoC-г гүн зогсолтын горимд хэрхэн тохируулах, LPAWUR-ийг фрэйм ​​ирж, зөв ​​хүлээн авах үед SoC-г сэрээхийн тулд хэрхэн тохируулахыг тайлбарладаг. Энэ эксample нь хүлээн авагч талыг харуулж, дамжуулагчийн хувьд өөр төхөөрөмж шаарддаг. Дамжуулагч өмнөхample нь NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRadio_Tx хавтасны доор байрладаг.

Sigfox™ програм
Эдгээр програмууд нь Sigfox™ хувилбарыг хэрхэн хэрэгжүүлэх, боломжтой Sigfox™ API-г ашиглахыг харуулдаг. Тэдгээрийг Projects\NUCLEO-WL33CC\Applications\Sigfox\ төслийн замд авах боломжтой:

• Sigfox_CLI: Энэхүү програм нь Sigfox™ протоколыг ашиглан мессеж илгээж, баталгаажуулалтын тест хийх командын мөрийн интерфейсийг (CLI) хэрхэн ашиглахыг харуулж байна.
• Sigfox_PushButton: Энэхүү програм нь STM32WL33xx Sigfox ™ төхөөрөмжийн радио чадавхийг үнэлэх боломжийг олгодог. PB1-ийг дарснаар Sigfox™-ийн туршилтын хүрээ дамжуулагдана.

Хяналтын түүх

Хүснэгт 3. Баримт бичгийн засварын түүх

Огноо	Хяналт	Өөрчлөлтүүд
29 оны 2024-р сарын XNUMX	1	Анхны хувилбар.
30 оны 2024-р сарын XNUMX	2	STM32CubeWL3-ийг STM32Cube-д бүрэн нэгтгэх. Шинэчлэгдсэн: •         Танилцуулга •         2-р хэсэг: STM32CubeWL3 үндсэн шинж чанарууд •         Хэсэг 3.2.1: Дунд програмын бүрэлдэхүүн хэсгүүд •         4-р хэсэг: STM32CubeWL3 програм хангамжийн багц дууссанview •         Хэсэг 5.1: Эхний экс-ыг ажиллуулахample •         5.3-р хэсэг: RF-ийн хэрэглээ, жагсаал, жишээлбэлamples Нэмсэн: •         Хэсэг 5.1.1: HAL-г хэрхэн ажиллуулах вэ example •         Хэсэг 5.2.1: STM32CubeMX програмыг хөгжүүлэх эсвэл шинэчлэхэд ашиглах • Схэсэг 6.4: MRSUBG/LPAWUR захын загвар төсөл байгаа эсэхamples? •         Хэсэг 6.5: STM32CubeMX хэрхэн суулгагдсан программ хангамж дээр тулгуурлан код үүсгэх вэ? Устгасан: •         PC хэрэгсэл, үүнд Навигатор, STM32WL3 GUI, ба MR-SUBG Sequencer GUI •         WiSE-Studio IOMapper хэрхэн суулгагдсан программ хангамж дээр суурилсан код үүсгэх вэ? •         Navigator програм хангамжийн багцын нөөцөд хандахыг зөвшөөрдөг үү?
22-р сарын 2025-XNUMX	3	Хүснэгт 32 дэх STM30WL32xx болон STM31WL1xx микроконтроллеруудад холбогдох төхөөрөмжүүдийн хүрээг өргөтгөсөн. STM32WL3x бүтээгдэхүүний шугамын макро.

ЧУХАЛ МЭДЭГДЭЛ – АНХААРАЛТАЙ уншина уу

• STMicroelectronics NV болон түүний охин компаниуд (“ST”) нь ST бүтээгдэхүүн болон/эсвэл энэхүү баримт бичигт ямар ч үед мэдэгдэлгүйгээр өөрчлөлт, залруулга, сайжруулалт, өөрчлөлт, сайжруулалт хийх эрхтэй. Худалдан авагчид захиалга өгөхөөс өмнө ST бүтээгдэхүүний талаарх хамгийн сүүлийн үеийн мэдээллийг авах ёстой. ST-ийн бүтээгдэхүүнийг захиалгын хүлээн зөвшөөрөгдөх үеийн ST-ийн борлуулалтын нөхцөл, нөхцлийн дагуу зардаг.
• Худалдан авагчид ST бүтээгдэхүүний сонголт, сонголт, ашиглалтыг дангаараа хариуцах бөгөөд ST нь хэрэглээний тусламж, худалдан авагчийн бүтээгдэхүүний дизайныг хариуцахгүй.
• СТ-ээс оюуны өмчийн аливаа эрхийг шууд болон далд хэлбэрээр олгох ямар ч тусгай зөвшөөрөл олгохгүй.
• Энд дурдсан мэдээллээс өөр заалт бүхий ST бүтээгдэхүүнийг дахин худалдах нь тухайн бүтээгдэхүүнд ST-аас олгосон аливаа баталгааг хүчингүй болгоно.
• ST ба ST лого нь ST-ийн худалдааны тэмдэг юм. ST барааны тэмдгийн талаарх нэмэлт мэдээллийг эндээс авна уу www.st.com/trademarks. Бусад бүх бүтээгдэхүүн, үйлчилгээний нэр нь тус тусын эзэмшигчийн өмч юм.
• Энэ баримт бичигт байгаа мэдээлэл нь энэ баримт бичгийн өмнөх хувилбаруудад өгсөн мэдээллийг орлож, орлоно.
• © 2025 STMicroelectronics – Бүх эрх хуулиар хамгаалагдсан

Түгээмэл асуултууд

Би хэзээ LL драйверуудын оронд HAL ашиглах ёстой вэ?

HAL драйверууд нь өндөр түвшний зөөвөрлөх чадвартай, өндөр түвшний, функцэд чиглэсэн API-уудыг санал болгодог. Бүтээгдэхүүн эсвэл захын нарийн төвөгтэй байдал нь эцсийн хэрэглэгчдэд нуугддаг. LL драйверууд нь илүү оновчтой боловч зөөврийн чадвар багатай доод түвшний бүртгэлийн түвшний API-г санал болгодог. Тэд бүтээгдэхүүн эсвэл IP техникийн үзүүлэлтүүдийн талаар гүнзгий мэдлэг шаарддаг.

LL эхлүүлэх API-г хэрхэн идэвхжүүлсэн бэ?

LL эхлүүлэх API болон холбогдох нөөцийн бүтцийн литералууд болон прототипүүдийн тодорхойлолтыг USE_FULL_LL_DRIVER эмхэтгэлийн шилжүүлэгчээр нөхцөл болгодог. LL эхлүүлэх API-г ашиглахын тулд энэ шилжүүлэгчийг багажийн хөрвүүлэгчийн урьдчилсан процессорт нэмнэ үү.

MRSUBG/LPAWUR зах зээлд зориулсан загвар төсөл байна ууamples?

Шинэ MRSUBG эсвэл LPAWUR хуучин үүсгэхample төсөл, эсвэл Pr ojectsNUCLEO- 33CC Ex-ийн дагуу өгөгдсөн араг яс төслөөс эхэлнэ.amples MRSUBG эсвэл ProjectsNUCLEO-WL33CC Examples LPAWUR эсвэл эдгээр ижил сангуудын доор байгаа аливаа төслөөс.

STM32CubeMX суулгагдсан программ хангамж дээр суурилсан кодыг хэрхэн үүсгэх вэ?

STM32CubeMX нь STM32 микроконтроллерууд, тэдгээрийн дагалдах төхөөрөмж, программ хангамжийн талаар суурилагдсан мэдлэгтэй бөгөөд энэ нь хэрэглэгчдэд график дүрслэл үзүүлж, .h эсвэл .c үүсгэх боломжийг олгодог. files нь хэрэглэгчийн тохиргоонд тулгуурласан.

Баримт бичиг / нөөц

ST STM32WL3x микроконтроллерууд [pdf] Хэрэглэгчийн гарын авлага STM32WL3x Микроконтроллер, STM32WL3x, Микроконтроллер

Лавлагаа

• Хэрэглэгчийн гарын авлага