SILICON LABS Zigbee EmberZ Net SDK 지침

Silicon Labs는 Zigbee 네트워킹을 제품에 개발하는 OEM에게 선택받는 공급업체입니다. Silicon Labs Zigbee 플랫폼은 가장 통합적이고 완벽하며 기능이 풍부한 Zigbee 솔루션입니다. Silicon Labs EmberZNet SDK에는 Silicon Labs의 Zigbee 스택 사양 구현이 포함되어 있습니다.

주요 특징

지그비

- APS 링크 키 표에 250개 이상의 항목 있음
Android 12(v21.0.6113669) 및 Tizen(v0.1-13.1)에서 ZigbeeD 지원

xG26 모듈 지원

다중 프로토콜

OpenWRT에서 ZigbeeD 및 OTBR 지원 – GA
SoC용 MG26에서 동시 수신을 지원하는 DMP BLE + CMP ZB 및 Matter/OT – GA

802.15.4 통합 무선 스케줄러 우선 순위 구성 요소
MP 호스트 애플리케이션에 대한 Debian 패키징 지원 – Alpha

새로운 아이템

중요한 변경 사항
APS 링크 키 테이블 크기(SL_ZIGBEE_KEY_TABLE_SIZE를 사용하여 구성)가 127개 항목에서 254개 항목으로 확장되었습니다.

ZDD 네트워크 커미셔닝 기능에 대한 R23 지원이 추가되었습니다. 터널링 기능은 레거시 네트워크 사용 사례에 대한 지원 없이 사용할 수 있습니다.

Network Steering 및 Network Creator 구성 요소가 업데이트되어 R23 가입을 지원합니다. 여기에는 다음과 같은 관련 변경 사항이 포함됩니다.
- 기본 Trust Center Link Key(TCLK) 요청 정책이 업데이트되어 요청하는 각 장치에 대해 새 키를 생성합니다. 요청하는 장치가 Trust Center Link Key를 업데이트하려고 할 때마다 새 키가 생성됩니다.
- 이전 TCLK 정책 변경으로 인해 Network Creator Security 구성 요소에는 이제 Security Link Keys 구성 요소가 필요합니다. 업그레이드하는 애플리케이션은 이 새로운 요구 사항을 준수하도록 업데이트됩니다.
- 새로운 구성,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY가 추가되어 핵심 해시 키를 사용하여 조인할 수 있습니다. 이 구성은 Network Creator Security 구성 요소에서 찾을 수 있습니다. 이 정책을 사용하면 각 조인 장치가 조인 후에 고유한 TCLK를 수신할 수 있지만 TCLK를 업데이트하려는 시도를 반복해도 요청하는 장치에 대한 새 키가 생성되지 않습니다. 이 해시 링크 키 사용은 이 릴리스 이전의 기본 정책이었으며, 이 정책을 사용하면 Trust Center가 Flash에 키를 저장하는 Security Link Keys 구성 요소를 가져오지 않아도 됩니다.
  메모: Silicon Labs는 이 정책을 사용하지 않는 것이 좋습니다. 이 정책을 사용하면 장치에 가입할 때 TCLK를 롤링하거나 업데이트할 수 없기 때문입니다.

호스트 SPI 장치와 해당 핀 인터페이스를 구성할 수 있도록 구성 요소 zigbee_ezsp_spi에 새로운 구성 세트가 추가되었습니다.
전직amp프로젝트를 포함한 le 프로젝트 files(.slcps) 및 프로젝트 폴더는 Silicon Labs 명명 지침에 따라 이름이 변경되고 "projects" 디렉토리로 이동되었습니다.

새로운 플랫폼 지원

새로운 모듈
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- 새로운 라디오 보드
- MGM260P-RB4350A
- MGM260P-RB4351A
새 부품
- 에프르32xg27
익스플로러 키트
- 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 게이트웨이 키 테이블 크기(ncp로 설정됨)를 20으로 늘렸습니다.

해결된 문제

현재 릴리스의 알려진 문제

굵게 표시된 문제는 이전 릴리스 이후에 추가되었습니다. 릴리스를 놓친 경우 최신 릴리스 정보를 확인할 수 있습니다. https://www.silabs.com/developers/zigbee-emberznet 기술 문서 탭에서.

더 이상 사용되지 않는 항목

zigbee_watchdog_periodic_refresh 구성 요소는 더 이상 Zigbee 애플리케이션 프레임워크에서 사용되지 않으며 이 릴리스에서 더 이상 사용되지 않습니다. 워치독 타이머는 모든 s에 대해 기본적으로 비활성화됩니다.ample 애플리케이션. 향후 SDK에 개선된 워치독 구성 요소가 추가될 예정입니다.
메모: 애플리케이션에서 구성 항목 SL_LEGACY_HAL_DISABLE_WATCHDOG를 0으로 설정하여 워치독 타이머를 활성화합니다.

네트워크 제한 및 고려 사항

이 EmberZNet 릴리스와 함께 제공되는 기본 Trust Center 애플리케이션은 네트워크에서 여러 장치를 지원할 수 있습니다. 이 숫자는 구성된 테이블 크기, NVM 사용 및 기타 생성 시간 및 런타임 값을 포함한 여러 요인에 따라 결정됩니다. 대규모 네트워크를 만들려는 사용자는 애플리케이션이 지원할 수 있는 것보다 네트워크를 크게 확장할 때 리소스 문제에 직면할 수 있습니다. 예를 들어ample, Trust Center에서 Trust Center Link Key를 요청하는 장치는 Trust Center에서 sl_zigbee_af_zigbee_key_establishment_cb 콜백을 트리거할 수 있으며 h 상태는 SL_ZIGBEE_KEY_TABLE_FULL로 설정되어 키 테이블에 요청하는 장치에 대한 새 키를 추가할 공간이 없거나 NVM3에 사용 가능한 공간이 없음을 나타냅니다. Silicon Labs는 대규모 네트워크를 만들려는 사용자에게 다음과 같은 권장 사항을 제공합니다. Trust Center 애플리케이션의 경우 다음 구성을 권장합니다. 이러한 권장 사항은 포괄적이지 않으며 대규모 네트워크를 확장하려는 애플리케이션의 기준이 됩니다.

주소 테이블 구성 요소(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 값은 네트워크 크기로 설정됩니다.
다음 구성 항목은 원하는 네트워크 크기에 맞춰 설정됩니다.
- Zigbee Pro Stack 구성 요소에서 찾을 수 있는 SL_ZIGBEE_BROADCAST_TABLE_SIZE
- 소스 라우팅이 사용되는 경우 소스 라우팅 구성 요소에서 발견되는 SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE
NVM3 사용에 따른 NVM3_DEFAULT_NVM_SIZE 및 NVM3_DEFAULT_CACHE_SIZE 조정
- 예를 들어 65개 노드보다 큰 네트워크 크기는 3K의 NVM64 크기를 필요로 할 가능성이 높습니다. Silicon Labs Zigbee의 기본 NVM3 크기는ample 애플리케이션은 32K입니다. NVM을 더 많이 사용하는 애플리케이션은 이 값을 더 높게 조정해야 할 수 있습니다.
- 최대 65개 노드의 대규모 네트워크에는 3바이트의 NVM1200 캐시 크기가 필요할 수 있습니다. 이보다 큰 네트워크가 성장하면 이 값을 두 배인 2400바이트로 늘려야 할 수도 있습니다.

이러한 조정은 신뢰 센터에만 적용됩니다.

다중 프로토콜 게이트웨이 및 RCP

새로운 아이템
xG26 파트에서 동시 수신이 가능한 Zigbee + Openthread CMP를 사용한 BLE DMP에 대한 GA SoC 지원이 활성화되었습니다. Zigbeed, OTBR 및 Z3Gateway 애플리케이션에 대한 Debian 알파 지원이 추가되었습니다. Zigbeed 및 OTBR은 선택한 참조 플랫폼(Raspberry PI 4)에 대한 DEB 패키지 형식으로도 제공됩니다. 멀티프로토콜 공동 프로세서가 있는 Linux 호스트에서 Zigbee, OpenThread 및 Bluetooth를 동시에 실행하는 방법을 참조하세요. docs.silabs.com, 자세한 내용은 다음을 참조하세요. arm0.1 및 aarch13.1의 Tizen-32-64과 aarch12의 Android 64에 대한 Zigbeed 지원이 추가되었습니다. Zigbeed에 대한 자세한 내용은 다음에서 확인할 수 있습니다. docs.silabs.com. 새로운 "802.15.4 Unified radio scheduler priority" 구성 요소를 추가했습니다. 이 구성 요소는 15.4 스택의 무선 우선순위를 구성하는 데 사용됩니다. 이 구성 요소에는 새로운 "radio_priority_configurator" 구성 요소도 필요합니다. 이 구성 요소를 사용하면 프로젝트에서 Simplicity Studio의 Radio Priority Configurator 도구를 사용하여 필요한 스택의 무선 우선순위 수준을 구성할 수 있습니다.

개량
다중 프로토콜 공동 프로세서(AN1333)를 사용하여 Linux 호스트에서 Zigbee, OpenThread 및 Bluetooth를 동시에 실행하는 방법에 대한 애플리케이션 참고 사항이 다음으로 이동되었습니다. docs.silabs.com. OpenWRT 지원은 이제 GA 품질입니다. Zigbee, OTBR 및 Z3Gateway 애플리케이션에 대한 OpenWRT 지원이 추가되었습니다. Zigbeed 및 OTBR은 참조 플랫폼(Raspberry PI 4)에 대한 IPK 패키지 형식으로도 제공됩니다. 멀티프로토콜 공동 프로세서가 있는 Linux 호스트에서 Zigbee, OpenThread 및 Bluetooth를 동시에 실행을 참조하십시오. docs.silabs.com을 참조하십시오.

해결된 문제

현재 릴리스의 알려진 문제
굵은 글씨로 표시된 문제는 이전 릴리스 이후에 추가되었습니다. 릴리스를 놓친 경우 최신 릴리스 노트를 즉시 사용할 수 있습니다.https://www.silabs.com/developers/simplicity-software-development-kit.

더 이상 사용되지 않는 항목
현재 DockerHub(siliconlabsinc/multiprotocol)에서 사용 가능한 "Multiprotocol Container"는 향후 릴리스에서 더 이상 사용되지 않습니다. 컨테이너는 더 이상 업데이트되지 않으며 DockerHub에서 가져올 수 없습니다. cpcd, ZigBee 및 ot-br-posix용 Debian 기반 패키지와 기본적으로 생성되고 컴파일된 프로젝트는 컨테이너 제거로 인해 손실된 기능을 대체합니다.

이 릴리스 사용

이 릴리스에는 다음이 포함되어 있습니다.

지그비 스택
Zigbee 애플리케이션 프레임워크
지그비Samp르 애플리케이션

Zigbee 및 EmberZNet SDK에 대한 자세한 내용은 UG103.02: Zigbee 기초를 참조하세요. 처음 사용자인 경우 개발 환경 구성, 빌드 및 플래시에 대한 지침은 QSG180: SDK 7.0 이상용 Zigbee EmberZNet 빠른 시작 가이드를 참조하세요.ample 애플리케이션과 ext 단계를 가리키는 문서 참조.

설치 및 사용
Zigbee EmberZNet SDK는 Silicon Labs SDK 모음인 Simplicity SDK의 일부로 제공됩니다. Simplicity SDK를 빠르게 시작하려면 Simplicity Studio 5를 설치하세요. 그러면 개발 환경이 설정되고 Simplicity SDK 설치 과정이 안내됩니다. Simplicity Studio 5에는 리소스 및 프로젝트 런처, 소프트웨어 구성 도구, GNU 툴체인이 포함된 전체 IDE, 분석 도구 등 Silicon Labs 기기를 사용한 IoT 제품 개발에 필요한 모든 것이 포함되어 있습니다. 설치 지침은 온라인 Simplicity Studio 5 사용자 가이드에 제공됩니다. 또는 GitHub에서 최신 버전을 다운로드하거나 복제하여 Simplicity SDK를 수동으로 설치할 수도 있습니다. 참조 https://github.com/SiliconLabs/simplicity_sdk 자세한 내용은 Simplicity Studio에서 기본적으로 Simplicity SDK를 설치합니다.

(윈도우): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

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

SDK 버전에 대한 특정 문서는 SDK와 함께 설치됩니다. 추가 정보는 종종 지식 기반 문서(KBA)에서 찾을 수 있습니다. 이 릴리스와 이전 릴리스에 대한 API 참조 및 기타 정보는 atn에서 제공됩니다. https://docs.silabs.com/.

보안 정보
보안 볼트 통합
Secure Vault-High 부분의 Secure Key Storage 구성요소를 사용하여 키를 안전하게 저장하도록 선택한 애플리케이션의 경우, 다음 표는 Zigbee Security Manager 구성요소가 관리하는 보호된 키와 해당 저장 보호 특성을 보여줍니다."Non-Exportable"로 표시된 래핑된 키는 사용할 수 있지만 사용할 수는 없습니다. view런타임에 편집 또는 공유됩니다. "내보내기 가능"으로 표시된 래핑된 키는 런타임에 사용 또는 공유될 수 있지만 Flash에 저장되는 동안 암호화된 상태로 유지됩니다. 사용자 애플리케이션은 이러한 키 대부분과 상호 작용할 필요가 없습니다. 링크 키 테이블 키 또는 일시적 키를 관리하는 기존 API는 여전히 사용자 애플리케이션에서 사용할 수 있으며 Zigbee Security Manager 구성 요소를 통해 라우팅됩니다.

보안 권고
Security Advisories를 구독하려면 Silicon Labs 고객 포털에 로그인한 다음 Account Home을 선택하십시오. 홈을 클릭하여 포털 홈 페이지로 이동한 다음 알림 관리 타일을 클릭합니다. 'Software/Security Advisory Notices & Product Change Notices (PCNs)'가 선택되어 있고 최소한 플랫폼 및 프로토콜에 가입되어 있는지 확인하십시오. 저장을 클릭하여 변경 사항을 저장합니다.

지원하다
개발 키트 고객은 교육 및 기술 지원을 받을 수 있습니다. Silicon Laboratories Zigbee 사용 web 모든 Silicon Labs Zigbee 제품 및 서비스에 대한 정보를 얻고 제품 지원에 가입하려면 페이지를 방문하세요. Silicon Laboratories 지원팀에 문의할 수 있습니다. http://www.silabs.com/support.

지그비 인증
Ember ZNet 8.1 릴리스는 SoC, NC, P 및 RCP 아키텍처를 위한 Zigbee 호환 플랫폼에 적합하며 이 릴리스와 연결된 ZCP 인증 ID가 있습니다. CSA를 확인하십시오. web사이트 여기:
https://csa-iot.org/csa-iot_products/.

ZCP 인증은 다음과 같습니다. file출시 후 몇 주가 소요되며 CSA에 반영되기까지 몇 주가 걸립니다. web사이트. 추가 질문이 있으시면 Silicon Laboratories 지원팀으로 문의해 주십시오. http://www.silabs.com/support.

자주 묻는 질문

질문: SDK에서 APS 링크 키 테이블 크기를 어떻게 업데이트합니까?
A: APS 링크 키 테이블 크기는 SL_ZIGBEE_KEY_TABLE_SIZE 매개변수를 사용하여 구성할 수 있습니다. 버전 8.1에서는 127개에서 254개 항목으로 확장되었습니다.

질문: 8.1 버전에서는 어떤 점이 개선되었나요?
A: 버전 8.1은 APS 링크 키 테이블 크기 확장, 구성 요소 이름 변경, Athe pp Framework 이벤트 대기열에 대한 뮤텍스 보호 추가 등의 개선 사항을 제공합니다. 자세한 개선 사항 목록은 릴리스 노트를 참조하세요.

질문: SDK에서 해결된 문제는 어떻게 처리하나요?
A: SDK에서 수정된 문제: 이웃 테이블 크기 구성의 잠재적 문제 해결, 구성 요소 이름 변경, 소스 경로 오버헤드 수정, ZCL 명령 처리 등. 이러한 수정 사항의 이점을 얻으려면 최신 버전으로 업데이트하세요.

문서 / 리소스

SILICON LABS Zigbee EmberZ Net SDK [PDF 파일] 지침
지그비 엠버즈 넷 SDK, 엠버즈 넷 SDK, 넷 SDK, SDK

참고문헌

사용자 설명서

SILICON LABS Zigbee EmberZ Net SDK

명세서

제품 정보