STMicroelectronics UM3399 STM32Cube WiSE רדיו קודי מחולל

הוראות שימוש במוצר

• היישום STM32CubeWiSE-RadioCodeGenerator דורש לפחות 2 Gbytes של זיכרון RAM, יציאות USB ו-Adobe Acrobat Reader 6.0.
• חלץ את התוכן של stm32wise-cgwin.zip file לתוך ספרייה זמנית.
• הפעל את STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ופעל לפי ההוראות שעל המסך.
• חבילת STM32CubeWiSE-RadioCodeGenerator SW files מאורגנים בתיקיות כולל 'אפליקציה' ו'exampלס'.
• כדי לבנות גרף זרימה ב-STM32CubeWiSE-RadioCodeGenerator:
• הוסף SeqActions לתרשים הזרימה באמצעות סרגל הכלים או התפריט הגלובלי.
• חבר את SeqActions לנקודת הכניסה וזו לזו על ידי ציור חיצי מעבר פעולה.
• נווט בתרשים הזרימה על ידי גרירת פעולות והוספת מעברי פעולה לפי הצורך.

מָבוֹא

• מסמך זה מתאר את חבילת ה-SW STM32CubeWiSE-RadioCodeGenerator (STM32CubeWiSEcg) עם מחולל קוד הרצף STM32WL3x MRSUBG.
• STM32CubeWiSE-RadioCodeGenerator הוא יישום PC המשמש לבניית גרף זרימה המגדיר אילו פעולות משדר לבצע באיזה תנאי, באמצעות מנהל ההתקן של הרצף MRSUBG.
• רדיו STM32WL3x Sub-GHz מכיל את הרצף הזה, שהוא מנגנון דמוי מכונה במצב המאפשר ניהול אוטונומי של העברות RF, ללא כל צורך בהתערבות של מעבד.
• אם נדרשת התערבות CPU, ניתן להגדיר פסיקות. ניתן לארגן את פעולות מקלט המשדר בגרף זרימה. במסמך זה, פעולות המשדר הבודדות מכונות SeqActions.
• עם זאת, קוד המקור אינו הייצוג הטוב ביותר עבור גרפי זרימה, מכיוון שהוא מסתיר את המבנה הלוגי והזמני שלהם.
• STM32CubeWiSE-RadioCodeGenerator מטפל בבעיה זו על ידי מתן שיטה גרפית לבניית תרשימי זרימה ולאחר מכן ייצוא של תרשימי הזרימה שנוצרו כקוד מקור C לצורך שילוב ביישומי משתמש.
• הגדרת גרף הזרימה מאוחסנת ב-RAM של המיקרו-בקר בצורה של:
  • קבוצה של טבלאות RAM של ActionConfiguration, המקושרות זו לזו באמצעות מצביעים. מצביעים אלה מגדירים את SeqActions, כלומר, סוג הפעולה (למשלample, שידור, קליטה, ביטול), כמו גם פרמטרים ותנאים ספציפיים לרדיו ספציפיים ל-SeqAction לשידורי פעולה.
  • טבלת RAM ייחודית של GlobalConfiguration. זה מגדיר את נקודת הכניסה של גרף הזרימה (ה-SeqAction הראשון לביצוע), כמו גם כמה ערכי דגל ברירת מחדל ופרמטרי רדיו נפוצים.
• פרמטרי רדיו, שניתן להגדיר בנפרד עבור כל SeqAction, מאוחסנים באחד מהאוגרים הדינמיים, שתוכנם הוא חלק מטבלת ה-RAM של ActionConfiguration. פרמטרים רדיו קבועים לאורך כל הביצוע של גרף הזרימה (אלא אם כן הם משתנים במהלך הפסקת מעבד), מאוחסנים באוגרים סטטיים, שתוכנם הוא חלק מטבלת ה-RAM של התצורה הגלובלית.

מידע כללי

רישוי
מסמך זה מתאר תוכנה הפועלת על המיקרו-בקר מבוסס STM32WL3x Arm® Cortex ® -M0+.
פֶּתֶק: ארם הוא סימן מסחר רשום של ארם לימיטד (או חברות הבת שלה) בארה"ב ו/או במקומות אחרים.

מסמכים קשורים

טבלה 1. הפניות למסמכים

מִספָּר	הַפנָיָה	כּוֹתֶרֶת
[1]	RM0511	STM32WL30xx/31xx/33xx Arm® מבוססי MCU תת-GHz

מתחילים

• סעיף זה מתאר את כל דרישות המערכת להפעלת STM32CubeWiSE-RadioCodeGenerator.
• זה גם מפרט את הליך התקנת חבילת התוכנה.

דרישות מערכת
ליישום STM32CubeWiSE-RadioCodeGenerator יש את הדרישות המינימליות הבאות:

• מחשב עם מעבד Intel® או AMD® המריץ את מערכת ההפעלה Microsoft® Windows 10
• לפחות 2 ג'יגה בייט של זיכרון RAM
• יציאות USB
• Adobe Acrobat Reader 6.0

הגדרת חבילת STM32CubeWiSE-RadioCodeGenerator SW
בצע את השלבים הבאים:

1. חלץ את התוכן של stm32wise-cgwin.zip file לתוך ספרייה זמנית.
2. חלץ והפעל את STM32CubeWiSE-RadioCodeGenerator_Vx.xxexe file ופעל לפי ההוראות שעל המסך.

חבילת STM32CubeWiSE-RadioCodeGenerator SW files
חבילת STM32CubeWiSE-RadioCodeGenerator SW files מאורגנים בתיקיות הבאות:

• אפליקציה: מכילה STM32CubeWiSE-RadioCodeGenerator.exe
• examples: תיקיה זו מאורגנת בתיקיות המשנה הבאות:
• קוד: תיקיה זו מכילה את גרפי הזרימה למשלample כבר מיוצא כקוד C, מוכן להזרקה לפרויקט יישום
• flowgraphs: תיקייה זו מאחסנת כמה דגמיםampפחות תרחישים של פעולות רצף MRSUBG אוטונומיות

הערות שחרור ורישיון files ממוקמים בתיקיית השורש.

תיאור תוכנת STM32CubeWiSE-RadioCodeGenerator

• סעיף זה מתאר את הפונקציות העיקריות של היישום STM32CubeWiSE-RadioCodeGenerator. כדי להפעיל כלי זה, לחץ על הסמל STM32CubeWiSE-RadioCodeGenerator.

לאחר הפעלת STM32CubeWiSE-RadioCodeGenerator, חלון היישום הראשי מופיע. הוא מורכב מ:

• תפריט וסרגל כלים גלובליים
• הייצוג החזותי של גרור ושחרור של גרף הזרימה
• קטע תצורת SeqAction (גלוי רק אם SeqAction נמצא כעת בעריכה)

בניית גרף זרימה
יסודות
תרשימי זרימה בנויים בשני שלבים:

1. הוסף SeqActions לתרשים הזרימה. ניתן לעשות זאת באמצעות כפתור "הוסף פעולה" בסרגל הכלים, באמצעות התפריט הגלובלי (עריכה → הוסף פעולה) או באמצעות קיצור הדרך "Ctrl+A".
2. חבר את SeqActions לנקודת הכניסה וזו לזו על ידי ציור חיצי מעבר פעולה.

התנאים שבהם מתרחשים מעברים אלו מוגדרים מאוחר יותר (ראה סעיף 3.2.1: זרימת בקרה).

ניווט בתרשים הזרימה, פעולות גרירה
על ידי גרירת רקע לוח השחמט של גרף הזרימה עם מצביע העכבר (לחיצה שמאלית), את viewניתן לכוונן את היציאה בגרף הזרימה. ניתן להשתמש בגלגל הגלילה של העכבר כדי להגדיל ולהקטין. לחיצה במקום כלשהו על פעולה (פרט ליציאות הפלט, כפתור המחיקה וכפתור העריכה) כדי לבחור פעולה. ניתן לסדר פעולות בגרף הזרימה על ידי גרירתן עם לחצן העכבר השמאלי.

הוספת מעברי פעולה

• כפי שמוצג באיור 2, לכל פעולה יש שתי "יציאות פלט", הנקראות NextAction1 (NA1) ו-NextAction2 (NA2), אותן ניתן לחבר ל-SeqActions שמתבצעות לאחר השלמת הפעולה. למשלample, NextAction1 יכול לשמש לביצוע פעולה כלשהי אם הפעולה הנוכחית הייתה מוצלחת וניתן היה להפעיל NextAction2 במקרה של כשל.
• כדי ליצור מעבר פעולה, העבר את מצביע העכבר מעל אחת מיציאות הפלט, לחץ על לחצן העכבר השמאלי והזז את מצביע העכבר כדי לגרור חץ מעבר. הזז את מצביע העכבר מעל יציאת הקלט בצד שמאל של SeqAction אחר ושחרר את לחצן העכבר השמאלי כדי להפוך את החיבור קבוע. כדי להסיר מעבר פעולה, פשוט חזור על השלבים ליצירת מעבר פעולה, אך שחרר את לחצן העכבר השמאלי איפשהו מעל רקע לוח השחמט.
• אם פלט (NextAction1, NextAction2) נותר לא מחובר, הרצף מסתיים אם הפעולה הבאה הזו מופעלת.
• הקפד לחבר גם את "נקודת הכניסה" ליציאת קלט כלשהי של SeqAction. SeqAction זה הוא הראשון שמתבצע ברגע שהרצף מופעל.

פעולות עריכה ומחיקה

• ניתן לערוך את SeqActions על ידי לחיצה על כפתור העיפרון בפינה השמאלית העליונה של SeqAction. ניתן למחוק אותו על ידי לחיצה על הצלב האדום בצד ימין למעלה (ראה איור 3). מחיקת SeqAction מסירה גם כל מעברי פעולה נכנסים ויוצאים.

תצורת SeqAction
ניתן להגדיר את SeqActions דרך ממשק תצורה עם כרטיסיות הנגיש דרך לחצן העיפרון בפינה השמאלית העליונה של כל פעולה בגרף הזרימה. ממשק זה בעצם מגדיר את התוכן של טבלת ה-RAM ActionConfiguration עבור הפעולה הספציפית, המורכבת מאפשרויות תצורה הקשורות לזרימת בקרה, כמו גם מתוכן האוגר הדינמי. ניתן להגדיר את תוכן האוגר הדינמי באופן ידני עם שליטה מלאה על כל ערך אוגר (ראה סעיף 3.2.3: תצורת רדיו מתקדמת) או באמצעות ממשק פשוט (ראה סעיף 3.2.2: תצורת רדיו בסיסית). הממשק הפשוט אמור להספיק כמעט לכל מקרי השימוש.

בקרת זרימה
לשונית זרימת הבקרה (ראה איור 4) מכילה כמה אפשרויות תצורה בסיסיות כגון שם הפעולה ומרווח הזמן הקצוב לפעולה. שם הפעולה לא משמש רק לתצוגה בגרף הזרימה אלא גם מועבר לקוד המקור שנוצר.

• לשונית זרימת הבקרה (ראה איור 4) מכילה כמה אפשרויות תצורה בסיסיות כגון שם הפעולה ומרווח הזמן הקצוב לפעולה. שם הפעולה לא משמש רק לתצוגה בגרף הזרימה אלא גם מועבר לקוד המקור שנוצר.
• והכי חשוב, לשונית זרימת הבקרה מגדירה את המצב בו תלוי המעבר ל-NextAction1 / NextAction2, כמו גם מרווח מעבר ודגלים. ניתן להגדיר את תנאי המעבר על ידי לחיצה על הכפתור שכותרתו "...", מה שגורם לתיבת הדו-שיח לבחירת המסכה המוצגת באיור 5 להופיע. מרווח המעבר שינה את המאפיין NextAction1Interval / NextAction2Interval של טבלת ה-RAM. עיין במדריך העזר STM32WL3x [1] למידע נוסף על המשמעות של מרווח זה והמשמעות של הדגלים SleepEn / ForceReload / ForceClear.
• יתר על כן, ניתן להוסיף תיאור קצר של בלוק SeqAction בכרטיסייה זו. תיאור זה משמש רק למטרות תיעוד ומועבר לקוד המקור שנוצר כהערת קוד מקור.

תצורת רדיו בסיסית

ניתן לחלק את לשונית תצורת הרדיו הבסיסית לשלושה חלקים:

1. קטע בחלק העליון שבו מוגדרים שניים מהפרמטרים החשובים ביותר של כל פעולה: הפקודה לביצוע (TX, RX, NOP, SABORT וכן הלאה) ואם ישים, אורך החבילה להעברה.
2. קטע משמאל שבו מוגדרים פרמטרי הרדיו בפועל כגון: תדר נושא, קצב נתונים, מאפייני אפנון, ספי מאגר נתונים וטיימרים.
3. ניתן להפעיל בנפרד קטע מימין שבו פסיקות המעבד. מטפל בפסיקות נוצר עבור כל אחת מהפסיקות המסומנות. זה בעצם מגדיר את התוכן של האוגר RFSEQ_IRQ_ENABLE.

עיין במדריך העזר STM32WL3x [1] למשמעות פרמטרי הרדיו השונים.

תצורת רדיו מתקדמת

• אם אפשרויות התצורה שנחשפו דרך לשונית תצורת הרדיו הבסיסית (סעיף 3.2.2: תצורת רדיו בסיסית) אינן מספיקות, לשונית תצורת הרדיו המתקדמת STM32WL3x מאפשרת הגדרה של תוכן אוגר דינמי שרירותי. לשונית התצורה המתקדמת מופעלת על ידי סימון תיבת הסימון תצורה מתקדמת בפינה השמאלית העליונה של ממשק התצורה עם הכרטיסיות.
• לא ניתן להשתמש בתצורות בסיסיות ומתקדמות בו-זמנית, על המשתמש לבחור בזו או אחרת. עם זאת, ניתן כמובן גם לערוך ידנית את קוד המקור שנוצר לאחר מכן ולהוסיף אפשרויות תצורה שעלולות להיות חסרות.

דו-שיח קונפיגורציה גלובלי

• ניתן לגשת לתיבת הדו-שיח "הגדרות פרויקט גלובליות" דרך לחצן סרגל הכלים "הגדרות גלובליות". תיבת הדו-שיח מכילה גם אפשרויות תצורה עבור תוכן האוגר הסטטי וגם הגדרות פרויקט נוספות. שים לב שניתן להגדיר רק חלק קטן מהאפשרויות של תצורת אוגר סטטי באמצעות דו-שיח זה. אפשרויות אלה ניתנות רק כדי לזרז יישומי אב טיפוס של יישומים עם STM32CubeWiSE-RadioCodeGenerator.
• בדרך כלל צפוי שתכני הרשומות הסטטיות יוגדרו בקוד המקור של היישום הנכתב באופן ידני.
• המשמעות של הגדרות הפרויקט האחרות מוסברת בתיבת הדו-שיח עצמה.
• קוד C נוסף המוכנס ממש לפני יצירת טבלת ה-Global Configuration RAM מתוכן האוגר הסטטי עשוי להיות מסופק גם כן. ניתן להשתמש בשדה זה כדי להגדיר ערכי אוגר סטטיים שאינם נגישים דרך מסכת תצורת האוגר הסטטית שסופקה.

יצירת קוד
ניתן לתרגם את גרף הזרימה לקוד מקור שלם של פרוייקט C על ידי לחיצה על הלחצן Generate Code בסרגל הכלים. תיקיית הפרויקט שנוצרה אינה מכילה פרויקט files עבור IAR, Keil® או GCC. אֵלֶה fileיש להוסיף s ידנית לפרויקט STMWL3x.
זהו מבנה תיקיות הפרויקט שנוצר:

תיקיית פרוייקט

• Inc
• SequencerFlowgraph.h: כותרת file עבור SequencerFlowgraph.c, סטטי. אל תערוך את זה.
• stm32wl3x_hal_conf.h: תצורת STM32WL3x HAL file, סטטי.
• src
• SequencerFlowgraph.c: הגדרת גרף זרימה. זה החשוב file שמשתמש במנהל ההתקן של הרצף כדי להגדיר את טבלאות ה-RAM של תצורה גלובלית ותצורת פעולה. נוצר אוטומטית, אל תערוך.
• main.c: פרויקט ראשי file שמדגים כיצד לטעון וליישם את הגדרת גרף הזרימה. סטטי, שנה זאת לפי הצורך.
• כדי לערוך את main.c או stm32wl3x_hal_conf.h, בחר התנהגות כתיבה שמור בהגדרות הפרויקט. בדרך זו, רק SequencerFlowgraph.c מוחלף.

כיצד לייבא קוד שנוצר ל-CubeMX example
כדי לייבא פרויקט שנוצר על ידי STM32CubeWiSE-RadioCodeGenerator לתוך אקס CubeMXample (MRSUBG_Skeleton), יש צורך לבצע את השלבים הבאים:

1. פתח את התיקיה המכילה את fileנוצר על ידי STM32CubeWiSE-RadioCodeGenerator ולהעתיק את התיקיות "Inc" ו-"Src".
2. הדבק את שתי התיקיות בתיקייה "MRSUBG_Skeleton" ותחליף את שתי התיקיות שכבר קיימות.
3. פתח את פרויקט "MRSUBG_Skeleton" באחד מה-IDEs הבאים:
   • EWARM
   • MDK-ARM
   • STM32CubeIDE
4. בתוך פרויקט "MRSUBG_Skeleton", הוסף את "SequencerFlowghraph.c" file:
   • עבור פרויקט EWARM, הנתיב להוספת ה file הוא הבא: MRSUBG_Skeleton\Application\User
   • עבור פרויקט MDK-ARM, הנתיב להוספת ה file הוא הבא: MRSUBG_Skeleton\Application/User
   • עבור פרויקט STM32CubeIDE, הנתיב להוספת ה file זהה:
     MRSUBG_Skeleton\Application\User
5. בתוך פרויקט MRSUBG_Skeleton, הוסף stm32wl3x_hal_uart.c ו-stm32wl3x_hal_uart_ex.c files לנתיב הבא: MRSUBG_Skeleton\Drivers\STM32WL3x_HAL_Driver. הנתיב זהה עבור כל ה-IDEs. השניים files נמצאים ב-Firmware\Drivers\STM32WL3x_HAL_Driver\Src.
6. כדי להשתמש בתכונות COM, stm32wl3x_nucleo_conf.h file, הממוקם ב-Firmware\Projects\NUCLEOWL33CC\ Examples\MRSUBG\MRSUBG_Skeleton\Inc, יש לשנות את הגדרת USE_BSP_COM_FEATURE ו-USE_COM_LOG ל-1U:
7. העתק את הקוד הבא לתוך "stm32wl3x_it.c", הממוקם ב-MRSUBG_Skeleton\Application\User.

זרימה למשלamples

• ארבעה לשעברampגרפי זרימה מסופקים לצד קוד המקור. האקסים האלהampניתן לטעון קבצים לתוך STM32CubeWiSE-RadioCodeGenerator על ידי לחיצה על כפתור "טען" בסרגל הכלים.

AutoACK_RX

• ההדגמה של Auto-ACK ממחישה כיצד שני התקני STM32WL3x יכולים לדבר באופן אוטומטי זה עם זה עם התערבות מינימלית של CPU, בעזרת חומרת הרצף.
• גרף זרימה זה מיישם את ההתנהגות (Auto-Transmit-ACK) של מכשיר A. במכשיר A, הרצף מאוחל במצב קליטה (WaitForMessage), בו הוא ממתין להגעת הודעה.
• ברגע שמגיעה הודעה חוקית, הרצף עובר אוטומטית למצב שידור (TransmitACK), שבו חבילת ACK נשלחת כתגובה, ללא התערבות CPU. ברגע שזה מסתיים, הרצף מאופס למצב WaitForMessage הראשוני שלו.
• גרף זרימה זה מיישם את אותה התנהגות כמו הדוגמה של MRSUBG_SequencerAutoAck_Rxample מהאקסampהתיקייה les\MRSUBG של חבילת התוכנה STM32Cube WL3. אם AutoACK_RX מהבהב במכשיר אחד
  A, ו-AutoACK_TX מהבהב במכשיר כלשהו, ​​B, שני המכשירים שולחים הודעות הלוך ושוב, כמו במשחק פינג-פונג.

AutoACK_TX

• הדגמת "Auto-ACK" ממחישה כיצד שני התקני STM32WL3x יכולים לדבר באופן אוטומטי זה עם זה עם התערבות מינימלית של CPU בעזרת חומרת הרצף.
• גרף זרימה זה מיישם את ההתנהגות ("Auto-Wait-for-ACK") של מכשיר B. במכשיר B, הרצף מאותחל במצב שידור (TransmitMessage), בו הוא משדר הודעה. לאחר סיום השידור, הוא עובר אוטומטית למצב קבלה שבו הוא ממתין לאישור ממכשיר A (WaitForACK). ברגע שמגיעה אישור חוקי, הרצף מאופס למצב ה-TransmitMessage הראשוני שלו וכל התהליך מתחיל מחדש. במקרה שלא התקבל ACK תוך 4 שניות, פסק זמן מופעל והרצף חוזר למצב TransmitMessage בכל מקרה.
• גרף זרימה זה מיישם את אותה התנהגות כמו ה-"MRSUBG_SequencerAutoAck_Tx" לשעברample מהאקסampהתיקייה les\MRSUBG של חבילת התוכנה STM32Cube WL3. אם AutoACK_RX מהבהב במכשיר אחד, A, ו-AutoACK_TX מהבהב במכשיר אחר, B, שני המכשירים שולחים הודעות הלוך ושוב, כמו במשחק פינג-פונג.

הקשב לפני שיחה (LBT)

• האקסית הזוample נלקח ממדריך העזר של STM32WL3x [1]. עיין במדריך זה לפרטים נוספים על דוגמה זוample.

מצב רחרח

• האקסית הזוample נלקח ממדריך העזר של STM32WL3x [1]. עיין במדריך זה לפרטים נוספים על דוגמה זוample.

היסטוריית גרסאות

טבלה 2. היסטוריית גרסאות של מסמך

תַאֲרִיך	גִרְסָה	שינויים
21-2024 בנובמבר	1	שחרור ראשוני.
10-פברואר-2025	2	שם המכשיר עודכן ל-scope STM32WL3x.

הודעה חשובה - קרא בעיון

• STMicroelectronics NV וחברות הבנות שלה ("ST") שומרות לעצמן את הזכות לבצע שינויים, תיקונים, שיפורים, שינויים ושיפורים במוצרי ST ו/או במסמך זה בכל עת ללא הודעה מוקדמת. על הרוכשים לקבל את המידע הרלוונטי העדכני ביותר על מוצרי ST לפני ביצוע הזמנות. מוצרי ST נמכרים בהתאם לתנאי המכירה של ST הקיימים בזמן אישור ההזמנה.
• הרוכשים הם האחראים הבלעדיים לבחירה, לבחירה ולשימוש במוצרי ST ו-ST אינה נושאת באחריות לסיוע ביישום או לעיצוב מוצרי הרוכשים.
• שום רישיון, מפורש או משתמע, לכל זכות קניין רוחני לא ניתן על ידי ST בזאת.
• מכירה חוזרת של מוצרי ST עם הוראות שונות מהמידע המפורט כאן תבטל כל אחריות שניתנה על ידי ST עבור מוצר זה.
• ST והלוגו של ST הם סימנים מסחריים של ST. למידע נוסף על סימני מסחר ST, עיין בכתובת www.st.com/trademarks. כל שאר שמות המוצרים או השירותים הם רכושם של בעליהם בהתאמה.
• המידע במסמך זה מחליף ומחליף מידע שסופק בעבר בכל גרסאות קודמות של מסמך זה.
• © 2025 STMicroelectronics - כל הזכויות שמורות

שאלות נפוצות

• ש: מהן דרישות המערכת המינימליות עבור STM32CubeWiSE-RadioCodeGenerator?
  • A: דרישות המערכת המינימליות כוללות לפחות 2 Gbytes של זיכרון RAM, יציאות USB ו-Adobe Acrobat Reader 6.0.
• ש: כיצד אוכל להגדיר את חבילת התוכנה STM32CubeWiSE-RadioCodeGenerator?
  • A: כדי להגדיר את חבילת התוכנה, חלץ את התוכן של ה-zip שסופק file לתוך ספרייה זמנית והפעל את קובץ ההפעלה file לפי ההוראות שעל המסך.

מסמכים / משאבים

STMicroelectronics UM3399 STM32Cube WiSE רדיו קודי מחולל [pdfמדריך למשתמש UM3399, UM3399 STM32 Cube WiSE Radio Code Generator, UM3399, STM32, Cube WiSE Radio Code Generator, רדיו קודי מחולל, מחולל קודים, מחולל

הפניות

• מדריך למשתמש