STM32WL3x سافټویر بسته

مشخصات

• د محصول نوم: STM32CubeWL3 سافټویر بسته
• مطابقت: STM32WL3x مایکرو کنټرولرونه
• اصلي ځانګړتیاوې:
  • ټیټ پرت (LL) او د هارډویر خلاصون پرت (HAL) APIs
  • SigfoxTM، FatFS، او FreeRTOSTM کرنل د منځني وسایلو برخې
  • غوښتنلیکونه او مظاهرې

د محصول کارولو لارښوونې

پیل کول
د STM32CubeWL3 سافټویر کڅوړې کارولو پیل کولو لپاره ، دا مرحلې تعقیب کړئ:

1. د رسمي څخه د سافټویر کڅوړه ډاونلوډ کړئ webسایټ
2. اړین پرمختیایي چاپیریال نصب کړئ (د بیلګې په توګه، STM32CubeIDE، EWARM، MDK-ARM).
3. پخواني ته مراجعه وکړئamples او غوښتنلیکونه د لارښوونې لپاره چمتو شوي.

د STM32CubeWL3 آرکیټیکچر اوورview
د STM32CubeWL3 سافټویر کڅوړه شاوخوا درې اصلي کچې رامینځته شوې

• کچه 0: د هارډویر خلاصون پرت (HAL) او BSP چلوونکي.
• کچه 1: غوښتنلیکونه، کتابتونونه، او د پروتوکول پر بنسټ برخې.

ډیری پوښتل شوي پوښتنې (FAQ)

پوښتنه: د STM32CubeWL3 سافټویر کڅوړې اصلي ځانګړتیاوې څه دي؟
A: په اصلي ځانګړتیاو کې د ټیټ پرت او HAL APIs شامل دي، د منځني وییر اجزا لکه SigfoxTM، FatFS، FreeRTOSTM kernel، غوښتنلیکونه، او مظاهرې.

پیژندنه

STM32Cube د STMicroelectronics اصلي نوښت دی چې د پراختیا هڅې، وخت او لګښت کمولو سره د ډیزاینر تولیداتو ته وده ورکوي. STM32Cube ټول STM32 پورټ فولیو پوښي.

STM32Cube کې شامل دي:

• د کاروونکي دوستانه سافټویر پرمختیایی وسیلو سیټ چې د پروژې پراختیا له تصور څخه تر احساس پورې پوښي، په منځ کې یې دي:
  • STM32CubeMX، د ګرافیکي سافټویر ترتیب کولو وسیله چې د ګرافیکي جادوگرو په کارولو سره د C ابتدايي کوډ اتوماتیک نسل ته اجازه ورکوي
  • STM32CubeIDE، د پردیو ترتیب، د کوډ تولید، د کوډ تالیف، او د ډیبګ ځانګړتیاوو سره په ټوله کې د پراختیا وسیله
  • STM32CubeCLT، د کوډ تالیف، د بورډ پروګرام کولو، او ډیبګ ځانګړتیاو سره د ټولو په یوه کې د کمانډ لاین پرمختیا وسیله
  • STM32CubeProgrammer (STM32CubeProg)، د پروګرام کولو وسیله چې په ګرافیکي او کمانډ لاین نسخو کې شتون لري
  • STM32CubeMonitor (STM32CubeMonitor، STM32CubeMonPwr، STM32CubeMonRF، STM32CubeMonUCPD)، په ریښتیني وخت کې د STM32 غوښتنلیکونو چلند او فعالیت ښه کولو لپاره د څارنې ځواکمن وسیلې
• د STM32Cube MCU او MPU کڅوړې، د هر مایکروکنټرولر او مایکرو پروسیسر لړۍ (لکه STM32CubeWL3 د STM32WL3x محصول لاین لپاره) لپاره ځانګړي سرایت شوي سافټویر پلیټ فارمونه، چې پدې کې شامل دي:
  • د STM32Cube هارډویر خلاصون پرت (HAL)، د STM32 پورټ فولیو په اوږدو کې د اعظمي پورټ وړتیا تضمین کول
  • د STM32Cube ټیټ پرت APIs، د هارډویر په اړه د کاروونکي کنټرول لوړې درجې سره غوره فعالیت او د پښو نښې ډاډمن کوي
  • د منځني وسایلو اجزاو منظم سیټ لکه FreeRTOS™ کرنل، FatFS، او Sigfox™
  • ټول امبیډ شوي سافټویر اسانتیاوې د پرفیریل او پلي کولو بشپړ سیټونو سرهamples
• د STM32Cube توسعې کڅوړې، چې د سافټویر برخې لري چې د STM32Cube MCU او MPU کڅوړو فعالیت بشپړوي:

• • د مینځني وسیلو غزول او پلي کونکي پرتونه
  • Examples په ځینو ځانګړو STMicroelectronics پراختیایی بورډونو کې روان دي

دا کارن لارښود تشریح کوي چې څنګه د STM32CubeWL3 MCU بسته سره پیل کړئ.
برخه 2 د STM32CubeWL3 اصلي ځانګړتیاوې بیانوي او برخه 3 یو اوور وړاندې کويview د دې جوړښت او د MCU بسته جوړښت.

عمومي معلومات

STM32CubeWL3 د STM32WL3x محصول لاین مایکرو کنټرولرونو کې د Arm® Cortex®‑M0+ پروسیسر پراساس د Sigfox™ بائنریونو په شمول د فرعي GHz مظاهرې غوښتنلیکونه چلوي.
د STM32WL3x مایکرو کنټرولر د STMicroelectronics د عصري فرعي GHz سره مطابقت لرونکی RF راډیو پرفیریل سرایت کوي ، د خورا ټیټ بریښنا مصرف او غوره راډیو فعالیت لپاره غوره شوی ، د بې ساري بیټرۍ ژوند لپاره.
نوټ: آرم په متحده ایالاتو او/یا نورو ځایونو کې د آرم لمیټډ (یا د هغې فرعي شرکتونو) راجسټر شوی سوداګریز نښه ده.

STM32CubeWL3 اصلي ځانګړتیاوې

• د STM32CubeWL3 MCU بسته د Arm® Cortex®-M32+ پروسیسر پراساس د STM32 0-bit مایکرو کنټرولرونو باندې چلیږي. دا په یوه کڅوړه کې راټولوي، ټول عمومي ایمبیډ شوي سافټویر اجزا چې د STM32WL3x محصول لاین مایکرو کنټرولرونو لپاره غوښتنلیک رامینځته کولو لپاره اړین دي.
• په کڅوړه کې د ټیټ پرت (LL) او د هارډویر خلاصون پرت (HAL) APIs شامل دي چې د مایکرو کنټرولر هارډویر پوښي ، د پخوانۍ پراخه سیټ سره یوځایamples په STMicroelectronics بورډونو کې روان دي. HAL او LL APIs د کارونکي اسانتیا لپاره د خلاصې سرچینې BSD جواز کې شتون لري. په دې کې د Sigfox™، FatFS، او FreeRTOS™ د کرنل منځني وسایل برخې هم شاملې دي.
• د STM32CubeWL3 MCU بسته هم ډیری غوښتنلیکونه او مظاهرې چمتو کوي چې د دې د مینځلو ټول برخې پلي کوي.
• د STM32CubeWL3 MCU د بسته بندي برخې ترتیب په 1 شکل کې ښودل شوی.

شکل 1. STM32CubeWL3 MCU د بسته بندۍ برخې 

د STM32CubeWL3 جوړښت پای ته ورسیدview

د STM32CubeWL3 MCU بسته حل د دریو خپلواکو کچو شاوخوا جوړ شوی چې په اسانۍ سره تعامل کوي لکه څنګه چې په 2 شکل کې تشریح شوي. کچه 0
دا کچه په دریو فرعي پرتونو ویشل شوې ده:

• د بورډ ملاتړ کڅوړه (BSP).
• د هارډویر خلاصون پرت (HAL):
  • د HAL پرفیریل چلوونکي
  • د ټیټ پوړ چلوونکي
• بنسټیز پرفیریل کارول examples.

د بورډ ملاتړ کڅوړه (BSP)
دا پرت د هارډویر بورډونو (لکه LEDs، تڼۍ، او COM ډرایورونو) کې د هارډویر اجزاوو سره تړاو لري د APIs سیټ وړاندې کوي. دا د دوو برخو څخه جوړه ده:

• جز:
  دا په بورډ کې د بهرني وسیلې پورې اړوند ډرایور دی نه STM32 ته. د برخې ډرایور د BSP ډرایور بهرني اجزاو ته ځانګړي APIs چمتو کوي او په کوم بل بورډ کې د پورټ وړ کیدی شي.
• د BSP چلوونکی:

دا اجازه ورکوي د اجزاو چلوونکي یو ځانګړي بورډ سره وصل کړي او د کاروونکي دوستانه APIs سیټ چمتو کوي. د API نومولو قاعده BSP_FUNCT_Action().
Example: BSP_LED_Init(), BSP_LED_On()
BSP د ماډلر جوړښت پراساس دی چې یوازې د ټیټې کچې معمولونو پلي کولو سره په هر هارډویر کې اسانه پورټینګ ته اجازه ورکوي.

د هارډویر خلاصون پرت (HAL) او ټیټ پرت (LL)
STM32CubeWL3 HAL او LL بشپړونکي دي او د غوښتنلیک اړتیاو پراخه لړۍ پوښي:

• د HAL چلوونکي د لوړې کچې فعالیت پر بنسټ خورا پورټ ایبل APIs وړاندیز کوي. دوی د پای کارونکي ته MCU او پردی پیچلتیا پټوي.
  د HAL ډرایورونه د عمومي څو مثالونو ځانګړتیاو لرونکی APIs چمتو کوي ، کوم چې د کارونې لپاره چمتو پروسې چمتو کولو سره د کارونکي غوښتنلیک پلي کول ساده کوي. د مثال لپارهampد مخابراتو لپاره (I2C، UART، او نور)، دا APIs چمتو کوي چې د پریفیرال پیل او تنظیم کولو اجازه ورکوي، د رایې ورکولو، مداخلې، یا DMA پروسې پراساس د معلوماتو لیږد اداره کول، او د مخابراتو غلطیو اداره کول چې ممکن د اړیکو په جریان کې رامنځته شي. د HAL ډرایور APIs په دوه کټګوریو ویشل شوي دي:

1. عمومي APIs، کوم چې د STM32 لړۍ ټولو مایکرو کنټرولرونو ته عام او عمومي دندې چمتو کوي.
2. د توسیع APIs، کوم چې د یوې ځانګړې کورنۍ یا ځانګړي برخې شمیرې لپاره ځانګړي او دودیز فعالیتونه وړاندې کوي.

• د ټیټ پرت APIs د راجستر په کچه د ټیټ کچې APIs چمتو کوي، د ښه اصلاح سره مګر لږ پورټ وړتیا سره. دوی د MCU او پردیو مشخصاتو ژورې پوهې ته اړتیا لري.
  د LL ډرایورونه ډیزاین شوي ترڅو د ګړندي سپک وزن متخصص پرت وړاندې کړي چې د HAL په پرتله هارډویر ته نږدې وي. د HAL برعکس، LL APIs د پردیو لپاره ندي چمتو شوي چیرې چې مطلوب لاسرسی کلیدي ځانګړتیا نه وي، یا د هغو کسانو لپاره چې د درنو سافټویر ترتیب یا پیچلي لوړې کچې سټیک ته اړتیا لري.

د LL ډرایور ځانګړتیاوې:

• د ډیټا جوړښتونو کې مشخص شوي پیرامیټرو سره سم د پردې اصلي ځانګړتیاو پیل کولو لپاره د دندو یوه ټولګه.
• د دندو یوه ټولګه چې د ابتدايي ډیټا جوړښتونو ډکولو لپاره د هرې ساحې سره ورته ری سیٹ ارزښتونو سره.
• د پریفیریل ډی-انسیټالیزیشن لپاره فعالیت (پریفیرل راجسترونه د دوی ډیفالټ ارزښتونو ته راستانه شوي).
• د مستقیم او اټومي راجستر لاسرسي لپاره د انلاین افعالونو سیټ.
• د HAL څخه بشپړه خپلواکي او وړتیا چې په سټنډرډ حالت کې وکارول شي (پرته د HAL چلونکي).
• د ملاتړ شوي پریفیریل ځانګړتیاو بشپړ پوښښ.

بنسټیز پرفیریل کارول examples
دا پرت د پخواني سره تړلی دیamples یوازې د HAL او BSP سرچینو په کارولو سره د STM32 پردیو کې جوړ شوی.
مظاهره examples هم شتون لري ترڅو نور پیچلي سابقه وښييampد ځانګړو برخو سره سناریوګانې، لکه MRSUBG او LPAWUR.

کچه 1
دا کچه په دوه فرعي پرتونو ویشل شوې ده:

• د منځنیو برخو اجزا
• Examples د منځنیو برخو اجزاو پر بنسټ

د منځنیو برخو اجزا
Middleware د کتابتونونو یوه مجموعه ده چې د FreeRTOS™ کرنل، FatFS، او Sigfox™ پروتوکول کتابتون پوښي. د دې پرت د اجزاوو تر مینځ افقی تعامل د ځانګړو APIs په زنګ وهلو سره ترسره کیږي.
د ټیټ پوړ ډرایورانو سره عمودی تعامل د ځانګړي کال بیکس او جامد میکرو له لارې ترسره کیږي چې د کتابتون سیسټم کال انٹرفیس کې پلي کیږي.
د هر منځنۍ ویور برخې اصلي ځانګړتیاوې په لاندې ډول دي:

• FreeRTOS™ کرنل: د ریښتیني وخت عملیاتي سیسټم (RTOS) پلي کوي ، د ایمبیډ شوي سیسټمونو لپاره ډیزاین شوی.
• Sigfox™: د Sigfox™ پروتوکول کتابتون پلي کوي چې د Sigfox™ پروتوکول شبکې سره مطابقت لري او د RF Sigfox™ وسیلو په وړاندې د ازموینې لپاره د RF ازموینې پروتوکول کتابتون هم شاملوي.
• FatFS: عمومي FAT پلي کوي file د سیسټم ماډل.

Examples د منځنیو برخو اجزاو پر بنسټ
هر د منځني پوښ اجزا د یو یا ډیرو پخوانیو سره راځيamples، چې د غوښتنلیکونو په نوم هم یادیږي، د دې کارولو څرنګوالی ښیې. ادغام examples چې د منځني وسایلو ډیری برخې کاروي هم چمتو شوي.

د STM32CubeWL3 فرم ویئر کڅوړه پای ته ورسیدهview

ملاتړ شوی STM32WL3x وسایل او هارډویر
STM32Cube د لوړ پورټ ایبل هارډویر خلاصون پرت (HAL) وړاندیز کوي چې د عمومي جوړښت شاوخوا جوړ شوی. دا د جوړیدو پرتونو اصولو ته اجازه ورکوي ، لکه د مینځني وییر پرت کارول ترڅو د دوی دندو پلي کولو لپاره پرته له دې چې پوه شي ، ژور ، کوم MCU کارول کیږي. دا د کتابتون کوډ بیا کارونې وړتیا ته وده ورکوي او نورو وسیلو ته اسانه لیږد یقیني کوي.

• سربیره پردې ، د دې پرت شوي جوړښت سره ، STM32CubeWL3 د ټولو STM32WL3x محصول لاین لپاره بشپړ ملاتړ وړاندیز کوي.
• کارونکي باید یوازې په stm32wl3x.h کې سم میکرو تعریف کړي.

جدول 1 د کارول شوي STM32WL3x محصول لاین وسیلې پورې اړه لري تعریف کولو لپاره میکرو ښیې. دا میکرو باید د کمپیلر پری پروسیسر کې هم تعریف شي.
جدول 1. د STM32WL3x محصول لاین لپاره میکرو

میکرو کې تعریف شوی stm32wl3x.h	د STM32WL3x محصول لاین وسایل
stm32wl33	STM32WL33xx مایکرو کنټرولرونه

STM32CubeWL3 د پخوانیو بډایه سیټ ځانګړتیاوې لريampپه ټولو کچو کې les او غوښتنلیکونه، د هر ډول HAL ډرایور یا د منځني وسایلو اجزاوو پوهیدل او کارول اسانه کوي. دا پخوانيampپه جدول 2 کې لیست شوي د STMicroelectronics بورډونو باندې چلیږي.

بورډ	د STM32WL3x بورډ ملاتړ شوي وسایل
NUCLEO-WL33CC1	STM32WL33CC
NUCLEO-WL33CC2	STM32WL33CC

د STM32CubeWL3 MCU بسته کولی شي په هر مناسب هارډویر کې پرمخ بوځي. کاروونکي په ساده ډول د BSP ډرایورونه تازه کوي ترڅو چمتو شوي پخواني پورټ کړيampپه بورډونو کې، که دا ورته هارډویر ځانګړتیاوې ولري (لکه LEDs یا بټن).

د فرم ویئر کڅوړه پای ته ورسیدهview
د STM32CubeWL3 MCU بسته حل په یو واحد زپ بسته کې چمتو شوی چې جوړښت یې په 3 شکل کې ښودل شوی.
شکل 3. د STM32CubeWL3 فرم ویئر بسته جوړښت

احتیاط:

کارونکي باید اجزا بدل نه کړي files. کارن کولی شي یوازې د پروژې سرچینې ترمیم کړي.
د هر بورډ لپاره، د پخوانیو سیټamples د EWARM، MDK-ARM، او STM32CubeIDE Toolchains لپاره د مخکې ترتیب شوي پروژو سره چمتو شوي.
شکل 4 د NUCLEO-WL33CCx بورډونو لپاره د پروژې جوړښت ښیي.

د پخوانيamples د STM32CubeWL3 کچې پورې اړه لري چې دوی یې پلي کوي طبقه بندي شوي. دوی په لاندې ډول نومول شوي دي:

• کچه 0 examples د Ex په نوم یادیږيamples، Examples_LL، او Examples_MIX. دوی په ترتیب سره د HAL ډرایورونه، LL ډرایورونه، او د HAL او LL ډرایورونو مخلوط کاروي پرته له کوم منځني برخې برخې. مظاهره examples هم شتون لري.
• کچه 1 examples غوښتنلیکونه بلل کیږي. دوی د هر منځنی وییر اجزاو عادي کارونې قضیې چمتو کوي.

د ورکړل شوي بورډ لپاره هر ډول فرم ویئر غوښتنلیک په چټکۍ سره د ټیمپلیټ پروژې په کارولو سره رامینځته کیدی شي چې په Templ ates او Templates_LL لارښودونو کې شتون لري.

Examples، Examples_LL، او Examples_MIX ورته جوړښت لري:

• \Inc فولډر ټول سرلیک لري files.
• \Src فولډر چې د سرچینې کوډ لري.
• \EWARM، \MDK-ARM، او \STM32CubeIDE فولډرونه چې د هرې وسیلې چین لپاره دمخه ترتیب شوې پروژه لري.
• readme.md او readme.html د پخواني تشریح کولampد کار کولو لپاره چلند او اړین چاپیریال.

د STM32CubeWL3 سره پیل کول

د لومړي پخوانی چلولample
دا برخه تشریح کوي چې د لومړي پخواني چلول څومره ساده ديampد STM32CubeWL3 دننه. دا د مثال په توګه کاروي د ساده LED توګل نسل چې په NUCLEO-WL33CC1 بورډ کې روان دی:

1. د STM32CubeWL3 MCU بسته ډاونلوډ کړئ.
2. دا خلاص کړئ، یا انسټالر چل کړئ که چمتو شوی وي، ستاسو د خوښې لارښود ته.
3. ډاډ ترلاسه کړئ چې په 3 شکل کې ښودل شوي د بسته بندۍ جوړښت بدل نه کړئ. د STM32CubeWL3 فرم ویئر بسته جوړښت. په یاد ولرئ چې دا هم سپارښتنه کیږي چې بسته د روټ حجم ته نږدې موقعیت کې کاپي کړئ (معنی C:\ST یا G:\Tests) ، ځکه چې ځینې IDEs د ستونزو سره مخ کیږي کله چې لاره خورا اوږده وي.

د HAL پخوانی چلولو څرنګوالیample
د پورته کولو او چلولو دمخه یو پخوانیample، دا په کلکه سپارښتنه کیږي چې پخوانی ولولئampزه ولولئ file د هر ځانګړي ترتیب لپاره.

1. \Projects\NUCLEO-WL33CC\Ex ته لټون وکړئamples.
2. \GPIO، بیا \GPIO_EXTI فولډر خلاص کړئ.
3. پروژه د غوره شوي وسیلې چین سره خلاص کړئ. یو چټک پایview د پخواني خلاصولو ، جوړولو او چلولو څرنګوالي په اړهampد ملاتړ شوي وسیلې چین سره لاندې ورکړل شوی.
4. ټول بیا جوړ کړئ files او انځور د هدف حافظې ته پورته کړئ.
5. پخوانی چل کړئample. د نورو جزیاتو لپاره، پخوانی ته مراجعه وکړئampزه ولولئ file.

د پرانیستلو، جوړولو او چلولو لپاره پخوانیampد هر ملاتړ شوي وسیلې چین سره ، لاندې مرحلې تعقیب کړئ:

• EWARM:

1. د Examples فولډر، د EWARM فرعي فولډر خلاص کړئ.
2. د Project.eww کاري ځای پیل کړئ (د کار ځای نوم ممکن له یو پخواني څخه بدل شيampبل ته).
3. ټول بیا جوړ کړئ files: [پروژه]>[ټول بیا رغول].
4. د پروژې عکس پورته کړئ: [پروژه]> [ډیبګ].
5. برنامه پرمخ وړئ: [Debug]> [Go (F5)].

• MDK-ARM:

1. د Exampپه فولډر کې، د \MDK-ARM فرعي فولډر خلاص کړئ.
2. د Project.uvproj کاري ځای پرانیزئ (د کار ځای نوم ممکن د یو پخواني څخه بدل شيampبل ته).
3. ټول بیا جوړ کړئ files: [پروژه]>[ټول هدف بیا رغول files].
4. د پروژې عکس پورته کړئ: [Debug]> [د ډیبګ سیشن پیل/بند کړئ].
5. برنامه پرمخ وړئ: [Debug]> [چلول (F5)].

• STM32CubeIDE:

1. د STM32CubeIDE اوزار چین خلاص کړئ.
2. کلیک وکړه [File]>[د کار ځای بدل کړئ]>[نور] او د STM32CubeIDE کاري ځای لارښود ته وګرځئ.
3. کلیک وکړه [File]>[واردات]، غوره کړئ [عمومي]>[موجوده پروژې په کاري ځای کې]، او بیا [بل] کلیک وکړئ.
4. د STM32CubeIDE کاري ځای لارښود ته لټون وکړئ او پروژه غوره کړئ.
5. ټولې پروژې بیا رغول files: د پروژې اکسپلورر کړکۍ کې پروژه غوره کړئ بیا په کلیک وکړئ
   [پروژه]>[د پروژې جوړول] مینو.
6.  برنامه پرمخ وړئ: [چلول]>[Debug (F11)].

د دودیز غوښتنلیک رامینځته کول

د غوښتنلیک جوړولو یا تازه کولو لپاره د STM32CubeMX کارول
په STM32Cube MCU بسته کې، نږدې ټولې پروژې examples د STM32CubeMX وسیلې سره رامینځته شوي ترڅو سیسټم ، پیری فیرلز ، او مینځني توکي پیل کړي.

د موجوده پروژې مستقیم کارول exampد STM32CubeMX وسیلې څخه د STM32CubeMX 6.12.0 یا لوړ ته اړتیا لري:

• د STM32CubeMX نصبولو وروسته، خلاص کړئ او که اړتیا وي وړاندیز شوې پروژه تازه کړئ.
  د موجوده پروژې د خلاصولو لپاره ترټولو ساده لاره په *.ioc باندې دوه ځله کلیک کول دي file نو STM32CubeMX په اوتومات ډول پروژه او د هغې سرچینه خلاصوي files. STM32CubeMX د داسې پروژو د ابتدايي سرچینې کوډ تولیدوي.
• د اصلي غوښتنلیک سرچینې کوډ د "کارونکي کوډ پیل" او "د کارونکي کوډ پای" په نظرونو کې شتون لري. که د پردې انتخاب او تنظیمات تعدیل شي، STM32CubeMX د کوډ ابتدايي برخه تازه کوي پداسې حال کې چې د اصلي غوښتنلیک سرچینې کوډ ساتل کیږي.

د STM32CubeMX سره د ګمرک پروژې رامینځته کولو لپاره، ګام په ګام پروسه تعقیب کړئ:

1. ټول اړین ایمبیډ شوي سافټویر د pinout-conflict solver، د ساعت د ونې تنظیم کولو مرستندویه، د بریښنا مصرف محاسبه کونکي، او د MCU پرفیریل ترتیب (لکه GPIO یا USART) ترسره کولو کارولو سره تنظیم کړئ.
2. د ټاکل شوي ترتیب پراساس د پیل کولو C کوډ رامینځته کړئ. دا کوډ د ډیری پرمختیایي چاپیریالونو کې کارولو لپاره چمتو دی. د کارونکي کوډ په راتلونکي کوډ نسل کې ساتل کیږي.
   د STM32CubeMX په اړه د نورو معلوماتو لپاره، د STM32 ترتیب او ابتدايي C کوډ نسل (UM32) لپاره د کارونکي لارښود STM1718CubeMX ته مراجعه وکړئ.

د چلونکي غوښتنلیکونه

د HAL غوښتنلیک
دا برخه د STM32CubeWL3 په کارولو سره د دودیز HAL غوښتنلیک رامینځته کولو لپاره اړین ګامونه بیانوي:

1. یوه پروژه جوړه کړئ
   د یوې نوې پروژې د جوړولو لپاره، یا هم د هر بورډ لپاره د \Projects\< STM32xxx_yyy>\Templates لاندې چمتو شوي ټیمپلیټ پروژې څخه یا د \Projects\ لاندې هرې موجودې پروژې څخه پیل کړئ. \مثالampl es یا \ پروژې\ غوښتنلیکونه (چیرې د بورډ نوم ته اشاره کوي). د ټیمپلیټ پروژه یو خالي اصلي لوپ فعالیت چمتو کوي. په هرصورت، دا د STM32CubeWL32 پروژې ترتیباتو پوهیدو لپاره یو ښه پیل ټکی دی. کينډۍ لاندې ځانګړتياوې لري:
   • دا د HAL سرچینې کوډ، CMSIS، او BSP ډرایورونه لري، کوم چې په ورکړل شوي بورډ کې د کوډ جوړولو لپاره د اجزاو لږترلږه سیټ دی.
   • دا د ټولو فرم ویئر برخو لپاره شاملې لارې لري.
   • دا د ملاتړ شوي STM32WL3x محصول لاین وسایل تعریفوي، د CMSIS او HAL ډرایورانو ته اجازه ورکوي چې په سمه توګه تنظیم شي.
   • دا د کارونې لپاره چمتو کارونکي چمتو کوي files مخکې ترتیب شوی لکه څنګه چې لاندې ښودل شوي:
   • HAL د آرم® کور سیسټیک سره د ډیفالټ وخت اساس سره پیل شوی.
   • SysTick ISR د HAL_Delay() هدف لپاره پلي شوی.
     یادونه: کله چې یوه موجوده پروژه بل ځای ته کاپي کړئ، ډاډ ترلاسه کړئ چې ټولې شاملې لارې تازه شوي.
2. د فرم ویئر اجزا تنظیم کړئ
   د HAL او د مینځلو برخو برخې د میکرو په کارولو سره د جوړیدو وخت ترتیب کولو اختیارونو سیټ وړاندیز کوي # په سرلیک کې اعلان شوي تعریف file. د ټیمپلیټ ترتیب file د هرې برخې دننه چمتو شوي، کوم چې باید د پروژې فولډر ته کاپي شي (معمولا ترتیب file xxx_conf_template.h نومیږي، ټوټه _template باید لرې شي کله چې دا د پروژې فولډر ته کاپي شي). تشکیلات file د هر ترتیب انتخاب اغیزې د پوهیدو لپاره کافي معلومات چمتو کوي. نور تفصيلي معلومات د هرې برخې لپاره چمتو شوي اسنادو کې شتون لري.
3. د HAL کتابتون پیل کړئ
   اصلي پروګرام ته د کود کولو وروسته، د غوښتنلیک کوډ باید د HAL_Init() API ته زنګ ووهي ترڅو د HAL کتابتون پیل کړي، کوم چې لاندې دندې ترسره کوي:
   • د فلش حافظې پری فیچ او د SysTick مداخلې لومړیتوب ترتیب کول (د میکرو له لارې چې په stm3 2wl3x_hal_conf.h کې تعریف شوي).
   •  د SysTick ترتیب د SysTick مداخلې لومړیتوب TICK_INT_PRIO کې چې په stm32wl3x_hal_conf.h کې تعریف شوی په هر ملی ثانیه کې مداخله رامینځته کوي.
   • د NVIC ګروپ لومړیتوب 0 ته ترتیب کول.
   • د HAL_MspInit() کال بیک فنکشن کال په stm32wl3x_hal_msp.c کاروونکي کې تعریف شوی file د نړیوالې ټیټې کچې هارډویر ابتکاراتو ترسره کولو لپاره.
4. د سیسټم ساعت تنظیم کړئ
   د سیسټم ساعت ترتیب د لاندې تشریح شوي دوه APIs په زنګ وهلو سره ترسره کیږي:
   • HAL_RCC_OscConfig(): دا API داخلي او خارجي oscillators ترتیبوي. کارونکي غوره کوي چې یو یا ټول oscillators تنظیم کړي.
   • HAL_RCC_ClockConfig(): دا API د سیسټم ساعت سرچینه، د فلش حافظې ځنډول، او د AHB او APB prescalers ترتیبوي.
5. پردی پیل کړئ
   •  لومړی د پریفیریل ابتکار فعالیت ولیکئ. په لاندې ډول عمل وکړئ:
   • پرفیریل ساعت فعال کړئ.
   • پرفیریل GPIOs تنظیم کړئ.
   • د DMA چینل تنظیم کړئ او د DMA مداخله فعاله کړئ (که اړتیا وي).
   • پرفیریل مداخله فعاله کړئ (که اړتیا وي).
   • stm32xxx_it.c ایډیټ کړئ ترڅو د اړتیا په صورت کې اړین مداخله کونکي (پریفیرل او DMA) ته زنګ ووهئ.
   •  د پروسې بشپړ کال بیک افعال ولیکئ که چیرې یو پریفیریل مداخله یا DMA د کارولو لپاره وي.
   •  په کارن main.c file، د پریفیرال هینډل جوړښت پیل کړئ بیا د پریفیریل ابتدایی کولو فنکشن ته زنګ ووهئ ترڅو د پریفیریل پیل کړي.
6. یو غوښتنلیک جوړ کړئ
   په دې کې سtage، سیسټم چمتو دی او د کاروونکي غوښتنلیک کوډ پراختیا پیل کیدی شي.
   HAL د پریفیرال تنظیم کولو لپاره هوښیار او د کارونې لپاره چمتو APIs چمتو کوي. دا د رایې ورکولو، مداخلو، او د DMA پروګرام کولو ماډل مالتړ کوي، ترڅو د غوښتنلیک اړتیاوې پوره کړي. د هر پیریفیریل کارولو څرنګوالي په اړه د نورو توضیحاتو لپاره ، بډایه پخوانی ته مراجعه وکړئampلی سیټ د STM32CubeWL3 MCU بسته کې چمتو شوی.

احتیاط:
په ډیفالټ HAL تطبیق کې، د SysTick ټایمر د مهال ویش په توګه کارول کیږي: دا په منظم وخت وقفو کې مداخلې رامینځته کوي. که HAL_Delay() د پرفیریل ISR پروسې څخه بلل کیږي، ډاډ ترلاسه کړئ چې د SysTick مداخله د پریفیریل مداخلې په پرتله لوړ لومړیتوب لري (د شمیر له پلوه ټیټ). که نه نو، د زنګ وهونکي ISR پروسه ده
بلاک شوی هغه دندې چې د مهال ویش ترتیب اغیزه کوي د __ ضعیف په توګه اعلان شوي ترڅو په کارونکي کې د نورو پلي کولو په صورت کې د بیرته راګرځیدو امکان ولري file (د عمومي هدف ټایمر کارول، د مثال لپارهample، یا د بل وخت سرچینه).
د نورو جزیاتو لپاره، د HAL_TimeBase پخوانی ته مراجعه وکړئample.

د ایل ایل غوښتنلیک
دا برخه د STM32CubeWL3 په کارولو سره د دودیز LL غوښتنلیک جوړولو لپاره اړین ګامونه بیانوي.

1. یوه پروژه جوړه کړئ
   د یوې نوې پروژې د جوړولو لپاره، یا د Templates_LL پروژې څخه پیل کړئ چې د هر بورډ لپاره د \Projects\ لاندې چمتو شوي. \Templates_LL یا د \Projects\ لاندې هرې موجودې پروژې څخه \E xamples_LL ( د بورډ نوم ته اشاره کوي، لکه NUCLEO-WL32CC33).
   د ټیمپلیټ پروژه یو خالي اصلي لوپ فعالیت چمتو کوي ، کوم چې د STM32CubeWL3 لپاره د پروژې ترتیباتو پوهیدو لپاره یو ښه پیل ټکی دی. د نمونې اصلي ځانګړتیاوې په لاندې ډول دي:
   • دا د LL او CMSIS ډرایورونو سرچینې کوډونه لري، کوم چې په ورکړل شوي تخته کې د کوډ پراختیا لپاره اړین اجزاو لږترلږه سیټ دي.
   • دا د ټولو اړین فرم ویئر اجزاو لپاره شاملې لارې لري.
   • دا د ملاتړ شوي STM32WL3x محصول لاین وسیله غوره کوي او د CMSIS او LL ډرایورانو سم ترتیب ته اجازه ورکوي.
   • دا د کارولو لپاره چمتو کارونکي چمتو کوي files چې په لاندې ډول ترتیب شوي دي:
   • main.h: LED او USER_BUTTON تعریف خلاصون پرت.
   • main.c: د اعظمي فریکونسۍ لپاره د سیسټم ساعت ترتیب.
2. پورټ د LL exampLe:
   • د Templates_LL فولډر کاپي / پیسټ کړئ - د لومړنۍ سرچینې ساتلو لپاره - یا مستقیم د موجوده Templa tes_LL پروژه تازه کړئ.
   • بیا، پورټینګ په اصل کې د Templates_LL په ځای کولو کې شامل دی fileد پخواني لخواamples_LL نښه شوې پروژه.
   • د بورډ ټولې ځانګړې برخې وساتئ. د وضاحت د دلیلونو لپاره، د بورډ ځانګړي برخې د ځانګړو سره بیرغ شوي دي tags:
     

په دې توګه، د پور کولو اصلي مرحلې په لاندې ډول دي:

• بدل کړئ stm32wl3x_it.h file.
• بدل کړئ stm32wl3x_it.c file.
• اصلي ځای بدل کړئ file او دا تازه کړئ: د LL ټیمپلیټ LED او کارونکي تڼۍ تعریف د بورډ ځانګړي ترتیب لاندې وساتئ tags.
• اصلي ځای بدل کړئ file او تازه یې کړئ:
• د SystemClock_Config() LL ټیمپلیټ فعالیت د ساعت ترتیب د بورډ ځانګړي ترتیب لاندې وساتئ tags.
• د LED تعریف پورې اړه لري، د هرې LDx پیښې په ځای کې د بل LDy سره بدل کړئ file main.h

د دې تعدیلاتو سره، پخوانیample په نښه شوي تخته کې تیریږي.

د RF غوښتنلیکونه، مظاهرې، او پخوانیamples
د RF غوښتنلیکونو مختلف ډولونه، مظاهرې، او پخوانیamples په STM32CubeWL3 بسته کې شتون لري. دوی په لاندې دوو برخو کې لیست شوي دي.

فرعي GHz exampلاریونونه او مظاهرې
دا پخوانيamples د MRSUBG او LPAWUR راډیو پریرالونو اصلي ځانګړتیاوې څرګندوي. دا پخوانيamples لاندې شتون لري:

• پروژې\NUCLEO-WL33CC\Examples\MRSUBG
• پروژې\NUCLEO-WL33CC\Examples\LPAWUR
• پروژې\NUCLEO-WL33CC\Emonstrations\MRSUBG
• پروژې\NUCLEO-WL33CC\Emonstrations\LPAWUR

هر پخوانیample یا demonstration عموما دوه پروګرامونه لري چې د 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 چې دا ښیې چې څنګه د ډیټابفر 0 او 1 څخه بدل شي.
  • MRSUBG_Sequencer AutoAck: یو پخوانیample چې په اتوماتيک ډول د پاکټ اعترافونه (ACKs) لیږدوي او ترلاسه کوي.
  • MRSUBG_WMBusSTD: د WM-Bus پیغامونو تبادله.
  • WakeupRadio: یو پخوانیampد LPAWUR راډیو پرفیریل ازموینې لپاره.
• مظاهرې/MRSUBG
  • MRSUBG_RTC_Button_TX: دا پخوانیample ښیي چې څنګه SoC په ژور سټاپ حالت کې تنظیم کړئ او MRSUBG ترتیب کړئ ترڅو SoC راویښ کړئ د PB2 په فشارولو سره د چوکاټ لیږلو یا د RTC ټایمر پای ته رسیدو وروسته.
  • MRSUBG_Sequencer_Sniff: دا پخوانیample ښیي چې څنګه د MRSUBG ترتیب ترتیب کړئ ترڅو په سنیف حالت کې کار وکړي. دا پخوانیample د رسیدونکي اړخ څرګندوي او د لیږدونکي په توګه بل وسیله ته اړتیا لري.
  • MRSUBG_Timer: غوښتنلیک د مختلف وخت وقفو سره د MRSUBG ټایمر (د آټوریلوډ سره) ډیری مثالونه مهالویش کوي.
  • MRSUBG_WakeupRadio_Tx: دا پخوانیample تشریح کوي چې څنګه SoC په ژور سټاپ حالت کې تنظیم کړئ او د چوکاټ لیږلو لپاره د PB2 په فشارولو سره د SoC راویښولو لپاره MRSUBG ترتیب کړئ. دا پخوانیample د لیږدونکي اړخ څرګندوي او د LPAWUR ریسیور په توګه بل وسیله ته اړتیا لري. اخیستونکی پخوانیample د NUCLEO-WL33CC\Demonstrations\LPAWUR\LPAWUR_WakeupRad io_Rx فولډر لاندې موقعیت لري.
• مظاهرې/LPAWUR
  • LPAWUR_WakeupRadio_Rx: دا پخوانیample تشریح کوي چې څنګه SoC په ژور سټاپ حالت کې تنظیم کړئ او LPAWUR تنظیم کړئ ترڅو SoC راویښ کړي کله چې یو چوکاټ راشي او په سمه توګه ترلاسه شي. دا پخوانیample د رسیدونکي اړخ څرګندوي او د لیږدونکي په توګه بل وسیله ته اړتیا لري. د لیږدونکي پخوانیample د NUCLEO-WL33CC\Demonstrations\MRSUBG\MRSUBG_WakeupRad io_Tx فولډر لاندې موقعیت لري.

د Sigfox™ غوښتنلیک
دا غوښتنلیکونه ښیې چې څنګه د Sigfox™ سناریو پلي کول او د موجود Sigfox™ APIs کارول. دوی د پروژې په لاره کې شتون لري Projects\NUCLEO-WL33CC\Applications\Sigfox\:

• Sigfox_CLI: دا اپلیکیشن ښیې چې څنګه د کمانډ لاین انٹرفیس (CLI) وکاروئ د کمانډونو لیږلو لپاره چې د پیغامونو لیږلو او د تصدیق کولو ازموینې ترسره کولو لپاره د Sigfox™ پروتوکول کاروي.
• Sigfox_PushButton: دا غوښتنلیک د STM32WL33xx Sigfox™ وسیلې راډیو وړتیاو ارزونې ته اجازه ورکوي. د PB1 فشارول د ازموینې Sigfox™ چوکاټ لیږدوي.

FAQ

1. کله باید د LL چلوونکو پر ځای HAL وکاروم؟
   د HAL ډرایورونه د لوړې کچې او فعالیت لرونکی APIs وړاندیز کوي ، د لوړې کچې پورټ وړتیا سره. محصول یا پردی پیچلتیا د پای کاروونکو لپاره پټه ده.
   LL ډرایور د ټیټ پرت راجستر کچې APIs وړاندیز کوي ، د غوره اصلاح سره مګر لږ پورټ ایبل. دوی د محصول یا IP مشخصاتو ژورې پوهې ته اړتیا لري.
2. ایا د HAL او LL چلوونکي یوځای کارول کیدی شي؟ که هو، نو خنډونه څه دي؟
   دا ممکنه ده چې دواړه HAL او LL چلوونکي وکاروئ. د پرفیریل ابتکار مرحلې لپاره HAL وکاروئ او بیا د LL چلوونکو سره I/O عملیات تنظیم کړئ.
   د HAL او LL ترمنځ لوی توپیر دا دی چې د HAL ډرایورونه اړتیا لري چې د عملیاتو مدیریت لپاره لاسوندونه رامینځته کړي او وکاروي پداسې حال کې چې د LL ډرایور په مستقیم ډول په پردیي راجسترونو کې کار کوي. د HAL او LL مخلوط کول په مثال کې ښودل شويamples_MIX examples.
3. د LL ابتدایی APIs څنګه فعال شوي؟
   د LL ابتکار APIs تعریف او اړوند سرچینې (تشکیلات، لغوي، او پروټوټایپونه) د USE_FULL_LL_DRIVER تالیف سویچ لخوا شرط شوي.
   د LL ابتدایی APIs کارولو وړ کیدو لپاره ، دا سویچ د اوزار چین کمپیلر پری پروسیسر کې اضافه کړئ.
4. ایا د MRSUBG/LPAWUR پرفیریل ایکس لپاره کومه نمونه پروژه شتون لري؟amples؟
   د نوي MRSUBG یا LPAWUR پخوانی جوړولو لپارهample پروژه، یا د کنکال پروژې څخه پیل کړئ چې د \Pr ojects\NUCLEO-WL33CC\Ex لاندې چمتو شويamples\MRSUBG یا \Projects\NUCLEO-WL33CC\Examples\LPAWUR، یا د ورته لارښوونو لاندې د هرې شته پروژې څخه.
5. STM32CubeMX څنګه کولی شي د ایمبیډ شوي سافټویر پراساس کوډ رامینځته کړي؟
   STM32CubeMX د STM32 مایکرو کنټرولرونو په اړه جوړ شوی پوهه لري ، پشمول د دوی پریرالونه او سافټویر ، کوم چې دا اجازه ورکوي چې کارونکي ته ګرافیکي نمایش چمتو کړي او *.h یا *.c تولید کړي. fileد کارونکي ترتیب پر بنسټ.

د بیاکتنې تاریخ

جدول 3. د اسنادو د بیاکتنې تاریخ

نیټه	بیاکتنه	بدلونونه
29-مارچ-2024	1	ابتدايي خوشې کول.
۲۰۲۰-اکتوبر-۲۶	2	د بشپړ ادغام STM32CubeWL3 in STM32Cube. تازه شوی: پیژندنه برخه 2: STM32CubeWL3 اصلي ځانګړتیاوې برخه 3.2.1: د مینځني وییر اجزا 4 برخه: د STM32CubeWL3 فرم ویئر کڅوړه پای ته ورسیدهview برخه 5.1: د لومړي پخوانی چلولample برخه 5.3: د RF غوښتنلیکونه، مظاهرې، او پخوانیamples اضافه شوی: برخه 5.1.1: د HAL پخوانی چلولو څرنګوالیample برخه 5.2.1: د STM32CubeMX کارولو یا تازه کولو لپاره غوښتنلیک 6.4 برخه: آیا د MRSUBG/LPAWUR لپاره کومه نمونه پروژه شتون لري؟ پرفیریل examples؟ برخه 6.5: څنګه کولی شي STM32CubeMX پر بنسټ کوډ تولید کړي سرایت شوی سافټویر؟ لرې شوی: د کمپیوټر وسایلپه شمول نیویګیټر, STM32WL3 GUI، او MR-SUBG Sequencer GUI د WiSE-Studio IOMapper څنګه کولی شي د ایمبیډ شوي سافټویر پراساس کوډ تولید کړي؟ ایا نیویګیټر د سافټویر کڅوړې سرچینو ته د لاسرسي اجازه ورکوي؟

اسناد / سرچینې

ST STM32WL3x سافټویر بسته [pdf] لارښوونې STM32WL3x سافټویر بسته، STM32WL3x، د سافټویر بسته، بسته

حوالې

• د کارن لارښود