SILICON LABS Zigbee EmberZ Net SDK ინსტრუქციები

Silicon Labs არის არჩევანის მომწოდებელი OEM-ებისთვის, რომლებიც ავითარებენ Zigbee ქსელს თავიანთ პროდუქტებში. Silicon Labs Zigbee პლატფორმა არის ყველაზე ინტეგრირებული, სრული და ფუნქციებით მდიდარი Zigbee გადაწყვეტა. Silicon Labs EmberZNet SDK შეიცავს Silicon Labs-ის მიერ Zigbee სტეკის სპეციფიკაციის განხორციელებას.

ძირითადი მახასიათებლები

ზიგბი

-250+ ჩანაწერი APS ბმულის კლავიშების ცხრილში
ZigbeeD მხარდაჭერა Android 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 ერთიანი რადიოს განრიგის პრიორიტეტული კომპონენტი
Debian შეფუთვის მხარდაჭერა MP მასპინძელი აპლიკაციებისთვის – Alpha

ახალი ნივთები

მნიშვნელოვანი ცვლილებები
APS ბმული გასაღების ცხრილის ზომა (კონფიგურირებულია SL_ZIGBEE_KEY_TABLE_SIZE-ის გამოყენებით) გაფართოვდა 127-დან 254-მდე.

R23 მხარდაჭერა დამატებულია ZDD ქსელის ექსპლუატაციისთვის. გვირაბის ფუნქციონირება ხელმისაწვდომია Legacy Network გამოყენების შემთხვევების მხარდაჭერის გარეშე.

Network Steering და Network Creator კომპონენტები განახლებულია R23-ის შეერთების მხარდაჭერაში. ეს მოიცავს შემდეგ დაკავშირებულ ცვლილებებს.
- ნაგულისხმევი Trust Center Link Key (TCLK) მოთხოვნის პოლიტიკა განახლდა ახალი გასაღებების გენერირებისთვის თითოეული მომთხოვნი მოწყობილობისთვის. ახალი გასაღები გენერირდება ყოველ ჯერზე, როცა მომთხოვნი მოწყობილობები ცდილობენ განაახლონ თავიანთი Trust Center Link Key.
- წინა TCLK პოლიტიკის ცვლილების გამო, ქსელის შემქმნელის უსაფრთხოების კომპონენტი ახლა მოითხოვს უსაფრთხოების ბმულის გასაღებების კომპონენტს. აპლიკაციების განახლება განახლდება ამ ახალი მოთხოვნის შესაბამისად.
- ახალი კონფიგურაცია,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY დამატებულია ბირთვული, ჰეშირებული გასაღების გამოყენებით შეერთების დასაშვებად. ეს კონფიგურაცია გვხვდება Network Creator Security კომპონენტის ქვეშ. ამ წესების გამოყენება საშუალებას აძლევს თითოეულ შეერთებულ მოწყობილობას მიიღოს უნიკალური TCLK შეერთების შემდგომ, მაგრამ TCLK-ის განახლების განმეორებითი მცდელობა არ გამოიწვევს ახალ გასაღებს მომთხოვნი მოწყობილობისთვის. ჰეშირებული ბმულის გასაღებების ეს გამოყენება იყო ნაგულისხმევი პოლიტიკა ამ გამოშვებამდე და ამ წესების გამოყენება Trust Center-ს საშუალებას აძლევს თავიდან აიცილოს უსაფრთხოების ბმულის გასაღების კომპონენტის შემოტანა, რომელიც ინახავს გასაღებებს Flash-ში.
  შენიშვნა: Silicon Labs არ გირჩევთ ამ პოლიტიკის გამოყენებას, რადგან ეს ხელს უშლის მოწყობილობების მიერთების გადახვევას ან მათი TCLK-ების განახლებას.

ახალი კონფიგურაციის ნაკრები ემატება კომპონენტს zigbee_ezsp_spi, რათა დაუშვას მასპინძელი SPI მოწყობილობის და მისი პინის ინტერფეისების კონფიგურაცია.
ყოფილმაampპროექტები, მათ შორის პროექტი files (.slcps) და პროექტის საქაღალდე გადაერქვა Silicon Labs დასახელების სახელმძღვანელოდ და გადატანილია „პროექტების“ დირექტორიაში.

ახალი პლატფორმის მხარდაჭერა

ახალი მოდულები
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- ახალი რადიო დაფები
- MGM260P-RB4350A
- MGM260P-RB4351A
ახალი ნაწილი
- efr32xg27
Explorer ნაკრები
- BRD2709A
- MGM260P-EK2713A

ახალი დოკუმენტაცია
ახალი EZSP მომხმარებლის სახელმძღვანელო UG600 8.1 და ზემოთ გამოცემებისთვის.

გაუმჯობესებები

SL_ZIGBEE_KEY_TABLE_SIZE ლიმიტები გაფართოვდა 254 ჩანაწერამდე.
Z3Light-ს დაემატა zigbee_security_link_keys.
zigbee_mp_z3_tc_z3_tc-ს დაემატა zigbee_security_link_keys. განახლებულია მისი ძირითადი ცხრილის ზომაც.
გაიზარდა Z3 Gateway გასაღების ცხრილის ზომა (რომელიც დაყენდება ncp) 20-მდე.

დაფიქსირებული საკითხები

ცნობილი საკითხები მიმდინარე რელიზში

წინა გამოშვების შემდეგ დაემატა სქელი საკითხები. თუ გამოტოვებთ გამოშვებას, ბოლო გამოშვების შენიშვნები ხელმისაწვდომია აქ https://www.silabs.com/developers/zigbee-emberznet ტექნიკური დოკუმენტების ჩანართში.

მოძველებული ნივთები

Zigbee_watchdog_periodic_refresh კომპონენტი აღარ გამოიყენება Zigbee აპლიკაციის ჩარჩოში და მოძველებულია ამ გამოშვებაში. დამკვირვებლის ტაიმერი ნაგულისხმევად გამორთულია ყველა სampაპლიკაციები. მომავალში SDK-ს დაემატება გაუმჯობესებული დამკვირვებელი კომპონენტი.
შენიშვნა: ჩართეთ დამკვირვებელი ტაიმერი კონფიგურაციის ერთეულით SL_LEGACY_HAL_DISABLE_WATCHDOG დაყენებულია 0-ზე თქვენს აპლიკაციაში

ქსელის შეზღუდვები და მოსაზრებები

ნაგულისხმევი Trust Center აპლიკაციები, რომლებიც მოწოდებულია ამ EmberZNet გამოშვებით, შეუძლიათ რამდენიმე მოწყობილობის მხარდაჭერა ქსელში. ეს რიცხვი განისაზღვრება რამდენიმე ფაქტორზე დაყრდნობით, მათ შორის კონფიგურირებული ცხრილის ზომები, NVM-ის გამოყენება და სხვა გენერირების დროისა და გაშვების დროის მნიშვნელობები. მომხმარებლებს, რომლებიც ცდილობენ შექმნან დიდი ქსელები, შეიძლება შეექმნათ რესურსის პრობლემები, როდესაც ქსელი უფრო ფართოა, ვიდრე აპლიკაციას შეუძლია მხარი დაუჭიროს. მაგampასევე, მოწყობილობამ, რომელიც ითხოვს Trust Center Link Key-ს Trust Center-დან, შეიძლება გამოიწვიოს sl_zigbee_af_zigbee_key_establishment_cb გამოძახება Trust Center-ზე h სტატუსით დაყენებული SL_ZIGBEE_KEY_TABLE_FULL, რაც მიუთითებს, რომ გასაღების ცხრილს არ აქვს ადგილი ახალი მოწყობილობის ან ამ გასაღების დასამატებლად. NVM3-ს არ აქვს ხელმისაწვდომი სივრცე. Silicon Labs გთავაზობთ შემდეგ რეკომენდაციებს მომხმარებლებისთვის, რომლებიც ცდილობენ შექმნან დიდი ქსელები. Trust Center-ის აპლიკაციებისთვის რეკომენდებულია შემდეგი კონფიგურაციები. ეს რეკომენდაციები არ არის ამომწურავი და ისინი ემსახურება როგორც საბაზისო აპლიკაციებს, რომლებიც აპირებენ დიდი ქსელების გაზრდას.

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 Zigbee s-შიampაპლიკაციები არის 32K. აპლიკაციებმა, რომლებიც უფრო მეტად იყენებენ NVM-ს, შეიძლება მოითხოვონ ამ მნიშვნელობის კიდევ უფრო მაღალი რეგულირება.
- დიდ ქსელებს 65 კვანძამდე შეიძლება დასჭირდეს NVM3 ქეშის ზომა 1200 ბაიტი; მზარდი ქსელების მასზე დიდი შეიძლება მოითხოვოს გაორმაგდეს ეს მნიშვნელობა 2400 ბაიტი.

ეს კორექტივები ვრცელდება მხოლოდ Trust Center-ზე

Multiprotocol Gateway და RCP

ახალი ნივთები
ჩართულია GA SoC მხარდაჭერა BLE DMP-ისთვის Zigbee + Openthread CMP-ით xG26 ნაწილებზე ერთდროულად მოსმენით. Debian alpha მხარდაჭერა დაემატა Zigbeed, OTBR და Z3Gateway აპლიკაციებს. Zigbeed და OTBR მოწოდებულია DEB პაკეტის ფორმატში არჩეული საცნობარო პლატფორმისთვის (Raspberry PI 4). იხილეთ Zigbee-ის, OpenThread-ისა და Bluetooth-ის ერთდროულად გაშვება Linux ჰოსტზე მრავალპროტოკოლის თანაპროცესორით, ნაპოვნი docs.silabs.com, დეტალებისთვის. დამატებულია Zigbeed მხარდაჭერა Tizen-0.1-13.1-ისთვის arm32-ისთვის და aarch64-ისთვის, ასევე Android 12-ისთვის aarch64-ისთვის. მეტი ინფორმაცია Zigbeed-ის შესახებ შეგიძლიათ იხილოთ აქ docs.silabs.com. დამატებულია ახალი კომპონენტი „802.15.4 ერთიანი რადიოს განრიგის პრიორიტეტი“. ეს კომპონენტი გამოიყენება 15.4 სტეკის რადიოს პრიორიტეტების კონფიგურაციისთვის. კომპონენტს ასევე სჭირდება ახალი „რადიო_პრიორიტეტის_კონფიგურატორი“ კომპონენტი. ეს კომპონენტი საშუალებას აძლევს პროექტებს გამოიყენონ Radio Priority Configurator ინსტრუმენტი Simplicity Studio-ში, რათა დააკონფიგურირონ სტეკების რადიოს პრიორიტეტის დონეები, რომლებიც ამას მოითხოვს.

გაუმჯობესებები
განაცხადის შენიშვნა, რომელიც მუშაობს Zigbee, OpenThread და Bluetooth ერთდროულად Linux ჰოსტზე მრავალპროტოკოლის თანაპროცესორით (AN1333) გადატანილია docs.silabs.com. OpenWRT მხარდაჭერა ახლა არის GA ხარისხის. OpenWRT მხარდაჭერა დაემატა Zigbee, OTBR და Z3Gateway აპლიკაციებს. Zigbeed და OTBR მოწოდებულია IPK პაკეტის ფორმატში საცნობარო პლატფორმისთვის (Raspberry PI 4). იხილეთ Zigbee, OpenThread და Bluetooth ერთდროულად გაშვება Linux ჰოსტზე მრავალპროტოკოლის თანაპროცესორით, ნაპოვნი docs.silabs.com, დეტალებისთვის.

დაფიქსირებული საკითხები

ცნობილი საკითხები მიმდინარე რელიზში
წინა გამოშვების შემდეგ დაემატა სქელი საკითხები. თუ თქვენ გამოტოვეთ გამოშვება, ბოლო გამოშვების შენიშვნები ხელმისაწვდომია შვრიის შესახებhttps://www.silabs.com/developers/simplicity-software-development-kit.

მოძველებული ნივთები
"მულტიპროტოკოლის კონტეინერი", რომელიც ამჟამად ხელმისაწვდომია DockerHub-ზე (siliconlabsinc/multiprotocol) მოძველდება მომავალ გამოშვებაში. კონტეინერი აღარ განახლდება და მისი ამოღება შესაძლებელია DockerHub-დან. Debian-ზე დაფუძნებული პაკეტები cpcd, ZigBee და ot-br-posix-ისთვის, ბუნებრივად გენერირებულ და შედგენილ პროექტებთან ერთად, ჩაანაცვლებს კონტეინერის წაშლით დაკარგულ ფუნქციონირებას.

ამ გამოშვების გამოყენება

ეს გამოცემა შეიცავს შემდეგს:

ზიგბის დასტა
Zigbee აპლიკაციის ჩარჩო
ზიგბი სampაპლიკაციები

Zigbee-სა და EmberZNet SDK-ის შესახებ დამატებითი ინფორმაციისთვის იხილეთ UG103.02: Zigbee Fundamentals. თუ პირველად ხართ მომხმარებელი, იხილეთ QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 და უფრო მაღალი, ინსტრუქციებისთვის თქვენი განვითარების გარემოს კონფიგურაციის, მშენებლობისა და ციმციმის შესახებ.ampგანაცხადი და დოკუმენტაციის მითითებები, რომლებიც მიუთითებს შემდგომ ნაბიჯებზე.

ინსტალაცია და გამოყენება
Zigbee EmberZNet SDK მოწოდებულია Simplicity SDK-ის, Silicon Labs SDK-ების კომპლექტის ნაწილად. 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): /მომხმარებლები//SimplicityStudio/SDKs/simplicity_sdk

SDK ვერსიისთვის დამახასიათებელი დოკუმენტაცია დაინსტალირებულია SDK-ით. დამატებითი ინფორმაცია ხშირად შეგიძლიათ იხილოთ ცოდნის ბაზის სტატიებში (KBAs). API ცნობები და სხვა ინფორმაცია ამ და ადრე გამოშვებების შესახებ ხელმისაწვდომია https://docs.silabs.com/.

უსაფრთხოების ინფორმაცია
უსაფრთხო სარდაფის ინტეგრაცია
აპლიკაციებისთვის, რომლებიც ირჩევენ გასაღებების უსაფრთხოდ შენახვას Secure Key Storage კომპონენტის Secure Vault-High ნაწილებზე, შემდეგი ცხრილი აჩვენებს დაცულ გასაღებებს და მათი შენახვის დაცვის მახასიათებლებს, რომლებსაც მართავს Zigbee Security Manager კომპონენტი.შეფუთული გასაღებები, რომლებიც მონიშნულია როგორც „არაექსპორტირებადი“ შეიძლება გამოყენებულ იქნას, მაგრამ არ შეიძლება viewed ან გაზიარებული გაშვების დროს. შეფუთული გასაღებები, რომლებიც მონიშნულია როგორც „ექსპორტირებადი“, შეიძლება გამოყენებულ იქნას ან გაზიარებული იყოს მუშაობის დროს, მაგრამ რჩება დაშიფრული Flash-ში შენახვისას. მომხმარებლის აპლიკაციებს არასოდეს სჭირდებათ ამ კლავიშების უმეტესობასთან ურთიერთობა. არსებული API-ები Link Key Table კლავიშების ან გარდამავალი კლავიშების სამართავად ჯერ კიდევ ხელმისაწვდომია მომხმარებლის აპლიკაციისთვის და შეიძლება გადაიტანოს Zigbee Security Manager კომპონენტის მეშვეობით.

უსაფრთხოების მრჩეველები
Security Advisories-ის გამოსაწერად, შედით Silicon Labs-ის მომხმარებელთა პორტალზე, შემდეგ აირჩიეთ Account Home. დააწკაპუნეთ HOME-ზე, რომ გადახვიდეთ პორტალის მთავარ გვერდზე და შემდეგ დააწკაპუნეთ შეტყობინებების მართვაზე. დარწმუნდით, რომ „პროგრამული უზრუნველყოფის/უსაფრთხოების საკონსულტაციო შეტყობინებები და პროდუქტის ცვლილების შეტყობინებები (PCN)“ არის მონიშნული და რომ თქვენ მინიმუმ გამოწერილი ხართ თქვენი პლატფორმისა და პროტოკოლისთვის. ნებისმიერი ცვლილების შესანახად დააჭირეთ შენახვას.

მხარდაჭერა
განვითარების ნაკრების მომხმარებლებს შეუძლიათ მიიღონ ტრენინგი და ტექნიკური მხარდაჭერა. გამოიყენეთ Silicon Laboratories Zigbee web გვერდზე, რომ მიიღოთ ინფორმაცია Silicon Labs Zigbee-ის ყველა პროდუქტისა და სერვისის შესახებ და დარეგისტრირდეთ პროდუქტის მხარდაჭერაზე. შეგიძლიათ დაუკავშირდეთ Silicon Laboratories-ის მხარდაჭერას მისამართზე http://www.silabs.com/support.

Zigbee სერთიფიკატი
Ember ZNet 8.1 გამოშვება კვალიფიცირებულია Zigbee Compliant პლატფორმისთვის SoC, NC, P და RCP არქიტექტურებისთვის. ამ გამოცემასთან არის დაკავშირებული ZCP სერთიფიკატის ID, გთხოვთ, შეამოწმოთ CSA webსაიტი აქ:
https://csa-iot.org/csa-iot_products/.

გთხოვთ გაითვალისწინოთ, რომ ZCP სერთიფიკატი არის fileგამოაქვეყნეთ გამოშვება და რამდენიმე კვირა სჭირდება CSA-ზე ასახვას webსაიტი. დამატებითი კითხვებისთვის, გთხოვთ, დაუკავშირდეთ Silicon Laboratories-ის მხარდაჭერას ნომერზე http://www.silabs.com/support.

ხშირად დასმული კითხვები

კითხვა: როგორ განვაახლოთ APS ბმულის კლავიშის ცხრილის ზომა SDK-ში?
პასუხი: APS ბმულის კლავიშის ცხრილის ზომის კონფიგურაცია შესაძლებელია SL_ZIGBEE_KEY_TABLE_SIZE პარამეტრის გამოყენებით. 8.1 ვერსიაში ის გაფართოვდა 127-დან 254-მდე.

Q: რა გაუმჯობესებებია 8.1 ვერსიაში?
პასუხი: ვერსია 8.1 მოაქვს გაუმჯობესებებს, როგორიცაა APS ბმულის კლავიშის ცხრილის ზომის გაფართოება, კომპონენტების სახელის გადარქმევა, mutex დაცვის დამატება 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

სპეციფიკაციები

პროდუქტის ინფორმაცია