הוראות SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs היא הספק המועדף עבור יצרני OEM המפתחים רשת Zigbee לתוך המוצרים שלהם. פלטפורמת Silicon Labs Zigbee היא פתרון ה-Zigbee המשולב, השלם והעשיר ביותר בתכונות הקיים. ה- Silicon Labs EmberZNet SDK מכיל את היישום של Silicon Labs של מפרט מחסנית Zigbee.

תכונות מפתח

זיגבי

-250+ ערכים בטבלת מפתחות קישור APS
תמיכה ב-ZigbeeD באנדרואיד 12 (v21.0.6113669) וב-Tizen (v0.1-13.1)

תמיכה במודול xG26

רב פרוטוקול

תמיכה ב-ZigbeeD ו-OTBR ב-OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT עם האזנה במקביל ב-MG26 עבור SoC - GA

רכיב עדיפות של מתזמן רדיו מאוחד 802.15.4
תמיכה באריזה של דביאן עבור יישומי מארח MP - אלפא

פריטים חדשים

שינויים חשובים
גודל טבלת מפתחות קישור APS (מוגדר באמצעות SL_ZIGBEE_KEY_TABLE_SIZE) מורחב מ-127 ל-254 ערכים.

תמיכה ב-R23 מתווספת עבור פונקציונליות הזמנת רשת ZDD. פונקציונליות מנהור זמינה ללא תמיכה במקרים של שימוש מדור קודם.

רכיבי היגוי הרשת ויוצרי הרשת עודכנו כדי לכלול תמיכה בהצטרפות ל-R23. אלה כוללים את השינויים הקשורים הבאים.
- ברירת המחדל של מדיניות הבקשות של מפתח קישור מרכז האמון (TCLK) עודכנה כדי ליצור מפתחות חדשים עבור כל מכשיר מבקש. מפתח חדש נוצר בכל פעם שהמכשירים המבקשים מנסים לעדכן את מפתח הקישור למרכז האמון שלהם.
- עקב שינוי המדיניות הקודם של TCLK, רכיב האבטחה של יוצר הרשת דורש כעת את הרכיב מפתחות קישור אבטחה. שדרוג יישומים יעודכן כדי להתאים לדרישה חדשה זו.
- תצורה חדשה,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY נוסף כדי לאפשר הצטרפות באמצעות מפתח גיבוב ליבה. תצורה זו נמצאת תחת רכיב Network Creator Security. השימוש במדיניות זו מאפשר לכל מכשיר מצטרף לקבל TCLK ייחודי לאחר ההצטרפות, אך ניסיונות חוזרים ונשנים לעדכן את ה-TCLK לא יביאו למפתח חדש עבור המכשיר המבקש. שימוש זה במפתחות קישור גיבוב היה מדיניות ברירת המחדל לפני מהדורה זו, והשימוש במדיניות זו מאפשר למרכז האמון להימנע מהכנסת רכיב מפתחות קישור אבטחה, ששומר מפתחות ב-Flash.
  פֶּתֶק: Silicon Labs לא ממליצה להשתמש במדיניות זו, מכיוון שהדבר מונע ממכשירים להצטרף לגלגול, או לעדכן, את ה-TCLKs שלהם.

ערכת תצורה חדשה מתווספת לרכיב zigbee_ezsp_spi כדי לאפשר את התצורה של התקן ה-SPI המארח וממשקי הפינים שלו.
האקסיתampהפרויקטים, כולל הפרויקט files (.slcps) ותיקיית הפרויקט, שונה להנחיות למתן שמות של Silicon Labs והועבר אל ספריית "פרויקטים".

תמיכת פלטפורמה חדשה

מודולים חדשים
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- לוחות רדיו חדשים
- MGM260P-RB4350A
- MGM260P-RB4351A
חלק חדש
- efr32xg27
ערכת אקספלורר
- BRD2709A
- MGM260P-EK2713A

תיעוד חדש
מדריך למשתמש חדש של EZSP UG600 עבור מהדורות 8.1 ומעלה.

שיפורים

SL_ZIGBEE_KEY_TABLE_SIZE מגבלות הורחבו עד ל-254 ערכים.
הוסיף zigbee_security_link_keys ל-Z3Light.
הוסיף zigbee_security_link_keys ל-zigbee_mp_z3_tc_z3_tc. עדכן גם את גודל טבלת המפתח שלו.
הגדיל את גודל טבלת מפתחות Z3 Gateway (שיוגדר ל-ncp) ל-20.

בעיות קבועות

בעיות ידועות במהדורה הנוכחית

נושאים מודגשים נוספו מאז המהדורה הקודמת. אם פספסת מהדורה, הערות הגרסה האחרונות זמינות בכתובת https://www.silabs.com/developers/zigbee-emberznet בכרטיסייה Tech Docs.

פריטים שהוצאו משימוש

הרכיב zigbee_watchdog_periodic_refresh אינו בשימוש עוד במסגרת היישום Zigbee והוא הוצא משימוש במהדורה זו. טיימר כלב השמירה מושבת כברירת מחדל עבור כל ה-sampיישומים. בעתיד יתווסף רכיב Watchdog משופר ל-SDK.
פֶּתֶק: הפעל את טיימר כלב השמירה עם פריט התצורה SL_LEGACY_HAL_DISABLE_WATCHDOG מוגדר ל-0 באפליקציה שלך

מגבלות ושיקולי רשת

יישומי ברירת המחדל של מרכז האמון המגיעים עם מהדורת EmberZNet זו מסוגלים לתמוך במספר מכשירים ברשת. מספר זה נקבע על סמך מספר גורמים, כולל גדלי טבלאות מוגדרים, שימוש ב-NVM וערכי זמן יצירה וזמן ריצה אחרים. משתמשים המבקשים ליצור רשתות גדולות עלולים להיתקל בבעיות משאבים כאשר הם מגדילים את הרשת יותר ממה שהאפליקציה יכולה לתמוך. למשלample, מכשיר המבקש מפתח קישור של מרכז אמון ממרכז האמון עשוי להפעיל התקשרות חוזרת של sl_zigbee_af_zigbee_key_establishment_cb למרכז האמון כאשר סטטוס h מוגדר ל-SL_ZIGBEE_KEY_TABLE_FULL, מה שמציין שלטבלת המפתחות אין מקום להוסיף מפתח חדש עבור המכשיר המבקש או ש ל-NVM3 אין מקום פנוי. Silicon Labs מספקת את ההמלצות הבאות למשתמשים המבקשים ליצור רשתות גדולות. עבור יישומי מרכז אמון, התצורות הבאות מומלצות. המלצות אלו אינן ממצות, והן משמשות כבסיס ליישומים המתכוונים להצמיח רשתות גדולות.

הכללת רכיב ה-Address Table (zigbee_address_table), עם
- פריט התצורה SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE מוגדר לגודל הרשת הרצויה
- הערך SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE מוגדר למקסימום (4)

הכללת רכיב מפתחות קישור אבטחה (zigbee_security_link_keys), עם
- הערך SL_ZIGBEE_KEY_TABLE_SIZE מוגדר לגודל הרשת
פריטי התצורה הבאים מוגדרים לגודל הרשת הרצויה
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, כפי שנמצא ברכיב Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, כפי שנמצא ברכיב ניתוב מקור, אם נעשה שימוש בניתוב מקור
התאמה של NVM3_DEFAULT_NVM_SIZE ו-NVM3_DEFAULT_CACHE_SIZE בהתאם לשימוש ב-NVM3
- לדוגמה, גדלי רשת יותר מ-65 צמתים דורשים ככל הנראה גודל NVM3 של 64K. גודל ברירת המחדל של NVM3 ב-Silicon Labs Zigbeeample applications הוא 32K. יישומים המשתמשים ב-NVM בצורה כבדה יותר עשויים לדרוש התאמת ערך זה אפילו גבוה יותר.
- רשתות גדולות של עד 65 צמתים עשויות להזדקק לגודל מטמון NVM3 של 1200 בתים; הגדלת רשתות גדולות מזה עשויה לדרוש הכפלת ערך זה ל-2400 בתים.

התאמות אלו חלות על מרכז האמון בלבד

Multiprotocol Gateway ו-RCP

פריטים חדשים
הפעלת תמיכה ב-GA SoC עבור BLE DMP עם Zigbee + Openthread CMP עם האזנה במקביל על חלקי xG26. נוספה תמיכה באלפא של Debian עבור יישומי Zigbeed, OTBR ו-Z3Gateway. Zigbeed ו-OTBR מסופקים גם בפורמט חבילת DEB עבור פלטפורמת ההתייחסות שנבחרה (Raspberry PI 4). ראה הפעלת Zigbee, OpenThread ו-Bluetooth במקביל על מארח לינוקס עם מעבד משותף של ריבוי פרוטוקולים, שנמצא ב- docs.silabs.com, לפרטים. נוספה תמיכת Zigbeed עבור Tizen-0.1-13.1 עבור arm32 ו-aarch64 וכן אנדרואיד 12 עבור aarch64. מידע נוסף על Zigbeed ניתן למצוא בכתובת docs.silabs.com. נוסף את הרכיב החדש "802.15.4 Unified radio scheduler priority". רכיב זה משמש לקביעת סדר העדיפויות הרדיו של ערימה 15.4. הרכיב דורש גם את הרכיב החדש "radio_priority_configurator". רכיב זה מאפשר לפרויקטים להשתמש בכלי Radio Priority Configurator ב-Simplicity Studio כדי להגדיר את רמות העדיפות ברדיו של הערימות הדורשות זאת.

שיפורים
הערת יישום הפעלת Zigbee, OpenThread ו-Bluetooth במקביל על מארח לינוקס עם מעבד משותף של ריבוי פרוטוקולים (AN1333) הועברה אל docs.silabs.com. תמיכת OpenWRT היא כעת באיכות GA. נוספה תמיכה ב-OpenWRT עבור יישומי Zigbee, OTBR ו-Z3Gateway. Zigbeed ו-OTBR מסופקים גם בפורמט חבילת IPK עבור פלטפורמת ההתייחסות (Raspberry PI 4). ראה הפעלת Zigbee, OpenThread ו-Bluetooth במקביל על מארח לינוקס עם מעבד משותף של ריבוי פרוטוקולים, שנמצא ב- docs.silabs.com, לפרטים.

בעיות קבועות

בעיות ידועות במהדורה הנוכחית
נושאים מודגשים נוספו מאז המהדורה הקודמת. אם פספסת מהדורה, הערות מהדורה אחרונות זמינות oathttps://www.silabs.com/developers/simplicity-software-development-kit.

פריטים שהוצאו משימוש
"מיכל ריבוי הפרוטוקול" אשר זמין כעת ב- DockerHub (siliconlabsinc/multiprotocol) יוצא משימוש במהדורה הקרובה. הקונטיינר לא יעודכן יותר וניתן יהיה לשלוף אותו מ- DockerHub. החבילות המבוססות על דביאן עבור cpcd, ZigBee ו-ot-br-posix, יחד עם פרויקטים שנוצרו והידור מקוריים, יחליפו את הפונקציונליות שאבדה עם הסרת המיכל.

שימוש בגרסה זו

מהדורה זו מכילה את הדברים הבאים:

ערימת זיגבי
Zigbee Application Framework
זיגבי סample יישומים

למידע נוסף על Zigbee ו- EmberZNet SDK ראה UG103.02: Zigbee Fundamentals. אם אתה משתמש בפעם הראשונה, ראה QSG180: מדריך התחלה מהירה של Zigbee EmberZNet עבור SDK 7.0 ומעלה, לקבלת הוראות על הגדרת סביבת הפיתוח שלך, בנייה והבהבה כampהיישום, והפניות לתיעוד המצביעות על השלבים הנוספים.

התקנה ושימוש
Zigbee EmberZNet SDK מסופק כחלק מ-Simplicity SDK, חבילת SDK של Silicon Labs. כדי להתחיל במהירות עם Simplicity SDK, התקן את Simplicity Studio 5, אשר יגדיר את סביבת הפיתוח שלך וידריך אותך בהתקנת Simplicity SDK. Simplicity Studio 5 כולל את כל הדרוש לפיתוח מוצר IoT עם מכשירי Silicon Labs, כולל משגר משאבים ופרויקטים, כלי תצורת תוכנה, IDE מלא עם שרשרת הכלים של GNU וכלי ניתוח. הוראות התקנה מסופקות במדריך למשתמש המקוון של Simplicity Studio 5. לחלופין, ניתן להתקין את Simplicity SDK באופן ידני על ידי הורדה או שיבוט של הגרסה העדכנית ביותר מ-GitHub. לִרְאוֹת https://github.com/SiliconLabs/simplicity_sdk למידע נוסף. Simplicity Studio מתקין את Simplicity SDK כברירת מחדל ב:

(Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

תיעוד ספציפי לגרסת ה-SDK מותקן עם ה-SDK. לעתים קרובות ניתן למצוא מידע נוסף במאמרי מאגר הידע (KBAs). הפניות ל-API ומידע אחר על מהדורות זו ועל מהדורות קודמות זמינות בזמינות https://docs.silabs.com/.

מידע אבטחה
שילוב מאובטח בכספת
עבור יישומים שבוחרים לאחסן מפתחות בצורה מאובטחת באמצעות רכיב Secure Key Storage בחלקים Secure Vault-High, הטבלה הבאה מציגה את המפתחות המוגנים ואת מאפייני הגנת האחסון שלהם שמנהל הרכיב Zigbee Security Manager.ניתן להשתמש במפתחות עטופים המסומנים כ"לא ניתנים לייצוא" אך לא ניתן להשתמש בהם viewערוך או משותף בזמן ריצה. ניתן להשתמש או לשתף מפתחות עטופים המסומנים כ"ניתנים ליצוא" בזמן ריצה אך להישאר מוצפנים בזמן שהם מאוחסנים ב-Flash. יישומי משתמש לעולם אינם צריכים לקיים אינטראקציה עם רוב המפתחות הללו. ממשקי API קיימים לניהול מפתחות טבלת מפתחות קישור או מפתחות חולפים עדיין זמינים לאפליקציית המשתמש והם מנותבים כמעט דרך רכיב Zigbee Security Manager.

עצות אבטחה
כדי להירשם ל-Security Advisories, היכנס לפורטל הלקוחות של Silicon Labs ולאחר מכן בחר Account Home. לחץ על HOME כדי לעבור לדף הבית של הפורטל ולאחר מכן לחץ על האריח נהל התראות. ודא ש'הודעות ייעוץ תוכנה/אבטחה והודעות על שינוי מוצר (PCN)' מסומן, ושאתה מנוי לכל הפחות על הפלטפורמה והפרוטוקול שלך. לחץ על שמור כדי לשמור את כל השינויים.

תְמִיכָה
לקוחות ערכת פיתוח זכאים להדרכה ותמיכה טכנית. השתמש ב-Silicon Laboratories Zigbee web דף כדי לקבל מידע על כל המוצרים והשירותים של Silicon Labs Zigbee, ולהירשם לתמיכה במוצר. אתה יכול לפנות לתמיכה של מעבדות סיליקון בכתובת http://www.silabs.com/support.

הסמכת זיגבי
מהדורת Ember ZNet 8.1 הוסמכה לפלטפורמה תואמת Zigbee עבור ארכיטקטורות SoC, NC, P ו-RCP. יש מזהה אישור ZCP הקשור לגרסה זו, אנא בדוק את ה-CSA webאתר כאן:
https://csa-iot.org/csa-iot_products/.

שימו לב שהסמכת ZCP היא fileד לפרסם את המהדורה, ולוקח כמה שבועות לפני שמגיעים לידי ביטוי ב-CSA webאֲתַר. לכל שאלה נוספת, אנא צור קשר עם התמיכה של מעבדות סיליקון בכתובת http://www.silabs.com/support.

שאלות נפוצות

ש: כיצד אוכל לעדכן את גודל טבלת מפתח קישורי APS ב-SDK?
ת: ניתן להגדיר את גודל טבלת מפתחות הקישור של APS באמצעות הפרמטר SL_ZIGBEE_KEY_TABLE_SIZE. בגרסה 8.1 הוא הורחב מ-127 ל-254 ערכים.

ש: מהם השיפורים בגרסה 8.1?
ת: גרסה 8.1 מביאה שיפורים כגון הרחבת גודל טבלת מפתח קישורי APS, שינוי שמות של רכיבים, הוספת הגנת מוטקס עבור תור האירועים של Athe pp Framework ועוד. עיין בהערות המהדורה לקבלת רשימה מפורטת של שיפורים.

ש: כיצד אוכל לטפל בבעיות מתוקנות ב-SDK?
ת: תיקנו בעיות ב-SDK כולל פתרון בעיות פוטנציאליות בתצורת גודל טבלאות שכן, שינוי שמות של רכיבים, תיקון תקורה של נתיב מקור, טיפול בפקודות ZCL ועוד. ודא שאתה מעדכן לגרסה העדכנית ביותר כדי ליהנות מתיקונים אלה.

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

SILICON LABS Zigbee EmberZ Net SDK [pdfהוראות
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

הפניות

מדריך למשתמש

SILICON LABS Zigbee EmberZ Net SDK

מפרטים

מידע על המוצר