SILICON LABS EFR32MG12 Ver Server Bootload Udara lan Persiyapan Klien Kanggo Zigbee SDK 7.0 Lan Luwih

Informasi produk

Produk kasebut minangka Server Bootload Over-the-Air (OTA) lan persiyapan Klien kanggo Zigbee SDK 7.0 lan luwih dhuwur. Iki ngidini sesi bootloading Zigbee OTA antarane piranti klien kluster ZCL OTA Upgrade lan piranti server. Tata cara sing diterangake ing manual pangguna nggunakake papan pangembangan adhedhasar EFR32MG12.

Titik Kunci

• Server digunakake kanggo sesi bootloading OTA.
• Produk kasebut dikembangake dening Silicon Labs.
• Revisi Dokumen: 0.1
• Nomer dokumen: AN1384

Pambuka
Bagian introduksi menehi liwatview saka produk. Iki nerangake tujuan cathetan aplikasi lan njlèntrèhaké langkah-langkah sing perlu kanggo nyiyapake sesi bootloading OTA antarane piranti klien lan server nggunakake papan pangembangan EFR32MG12.

Persyaratan Hardware lan Piranti Lunak
Bagean syarat hardware lan piranti lunak nyedhiyakake informasi babagan alat lan komponen sing dibutuhake kanggo persiyapan. Nyebutake manawa piranti konfigurasi proyek Simplicity Studio 5 (SSv5) digunakake kanggo akeh langkah. Iku uga nemtokake yen IAR-EWARM digunakake minangka compiler, lan nomer versi compiler kompatibel bisa ditemokaké ing cathetan release SDK.

Bagean kasebut luwih nerangake yen rong WSTK basis EFR32MG12 dibutuhake, siji kanggo piranti klien lan siji minangka komponen Network Co-Processor (NCP) saka OTA Server. Host PC sing nganggo wadhah Linux utawa Windows Docker uga dibutuhake kanggo persiyapan Server OTA.

Kanggo piranti sing nggunakake EFR32MG1, mung pilihan serial dataflash kasedhiya, lan bagean karo nomer diwiwiti karo EFR32MG1x6 utawa EFR32MG1x7 duwe lampu kilat serial terpadu.

Pandhuan Panggunaan Produk

1. Sinau babagan dhasar mbangun lan ngemot gambar aplikasi ing platform Silicon Labs. Deleng "Pandhuan Miwiti Cepet Zigbee EmberZNet kanggo SDK v7.0 lan luwih dhuwur" (QSG180) kanggo rincian.
2. Yen sampeyan ngembangaken karo EmberZNet SDK 6.10.x lan ngisor, deleng cathetan aplikasi "Server Bootload Over-the-Air lan Persiyapan Klien" (AN728).
3. Ngatur papan pangembangan WSTK kanggo nggunakake EFR32MG12 miturut pandhuan sing kasedhiya ing "WSTK6001 User Manual".
4. Kanggo rincian liyane babagan bootloader, waca "Dasar Bootloading" (UG103.6).
5. Hubungi revisi paling anyar sing diterbitake saka spesifikasi perpustakaan kluster Zigbee kanggo rincian babagan kluster Upgrade ZCL OTA.
6. Nggawe lan nyoba kluster bootload Zigbee OTA nggunakake piranti konfigurasi proyek Simplicity Studio 5. Deleng "Pandhuan Miwiti Cepet Zigbee EmberZNet kanggo SDK v7.0 lan luwih dhuwur" (QSG180) kanggo instruksi.
7. Priksa manawa sampeyan duwe versi compiler IAR-EWARM sing kompatibel kaya sing kasebut ing cathetan rilis SDK.
8. Tindakake tata cara ing cathetan aplikasi iki kanggo nindakake sesi bootloading OTA antarane piranti klien lan server.
9. Deleng bagean "Lanjutan" ing cathetan aplikasi kanggo ngatur konfigurasi hardware lan piranti lunak kanggo kabutuhan sampeyan.

AN1384: Server Bootload Over-the-Air lan Persiyapan Klien kanggo Zigbee SDK 7.0 lan luwih dhuwur
Cathetan aplikasi iki nggambarake proses sing kudu ditindakake pangguna kanggo nindakake sesi bootloading Zigbee® OTA (over-the-air) ing antarane piranti klien kluster ZCL OTA Upgrade lan piranti server. Perangkat keras sing digunakake yaiku kit pangembangan adhedhasar EFR32MG12. (Waca Manual pangguna WSTK6001 kanggo katrangan babagan carane ngatur papan pangembangan WSTK kanggo nggunakake EFR32MG12.) Sampeyan uga bisa ngrujuk tata cara ing dokumen iki nalika nyetel utawa nyoba download OTA bootload ing lingkungan pangembangan dhewe karo hardware dhewe.
Yen sampeyan ngembangaken karo EmberZNet SDK 6.10.x lan ngisor, ndeleng AN728: Over-the-Air Bootload Server lan Klien Setup.
Sadurunge miwiti ngleksanakake tata cara ing dokumen iki, sampeyan kudu ngerti dhasar kanggo mbangun lan ngemot gambar aplikasi ing platform Silicon Labs. Waca QSG180: Zigbee EmberZNet Quick-Start Guide kanggo SDK v7.0 lan luwih dhuwur kanggo rincian.

POINTS UTAMA 

• Konfigurasi lan gawe loro gambar klien Zigbee OTA.
• Ngatur lan mbangun server OTA.
• Muat gambar klien asli.
• Muat piranti lunak server NCP.
• Muat gambar klien OTA sing dianyari ing server.

Pambuka

Cathetan aplikasi iki njlèntrèhaké langkah-langkah sing dibutuhake kanggo nduduhake sesi bootloading Zigbee OTA ing antarane piranti klien kluster ZCL OTA Upgrade lan piranti server. Tata cara nggunakake papan pangembangan adhedhasar EFR32MG12. (Waca Manual pangguna WSTK6001 kanggo rincian babagan carane ngatur papan pangembangan WSTK kanggo nggunakake EFR32MG12.)
Waca UG103.6: Bootloading Fundamentals kanggo rincian liyane babagan bootloader. Kanggo rincian babagan klaster Upgrade ZCL OTA, deleng revisi sing diterbitake paling anyar saka spesifikasi perpustakaan kluster Zigbee. Elinga, ing Zigbee Cluster Configurator, ZCL OTA Upgrade cluster diarani OTA Bootloading. Kanggo konsistensi, terminologi kasebut uga digunakake ing dokumen iki. Yen sampeyan nggoleki dokumen Zigbee, priksa manawa sampeyan nggoleki 'OTA Upgrade.'
Deleng cathetan aplikasi iki nalika nyiyapake lan utawa nyoba kluster bootload Zigbee OTA dhewe. Bagean Lanjut de-scribes carane iki example bisa ditambahi kanggo nggunakake konfigurasi hardware dhewe, lan carane ngganti konfigurasi lunak kanggo ndhukung informasi Produsèn-tartamtu dhewe.
Kanggo referensi luwih lengkap, waca:

• Dokumen Zigbee # 07-5123, Spesifikasi Pustaka Kluster Zigbee - bab "Upgrade Over-The-Air"; kasedhiya saka https://csa-iot.org/.
• QSG180: Pandhuan Miwiti Cepet Zigbee EmberZNet kanggo SDK v7.0 lan luwih dhuwur
• UG491: Pandhuan Pangembang Kerangka Aplikasi Zigbee kanggo SDK 7.0 lan luwih dhuwur
• UG489: Silicon Labs Gecko Bootloader Pandhuan Pangguna kanggo GSDK 4.0 lan luwih dhuwur
• AN1084: Nggunakake Gecko Bootloader karo EmberZNet
• AN1325: Zigbee Cluster Configurator Pandhuan pangguna
• AN1389: Mlaku Aplikasi Host Zigbee ing Wadah Docker

Persyaratan Hardware lan Piranti Lunak

Akeh langkah ing dokumen iki ditindakake kanthi nggunakake piranti konfigurasi proyek sing diwenehake dening Simplicity Studio 5 (SSv5). Piranti kasebut kalebu Project Configurator, Component Editor, lan Zigbee Cluster Configurator. Kanggo informasi luwih lengkap babagan konfigurasi aplikasi, deleng QSG180: Zigbee EmberZNet Quick-Start Guide kanggo SDK v7.0 lan Higher, kasedhiya karo release.
Sawetara prosedur nggunakake IAR-EWARM minangka compiler. Versi IAR-EWARM kudu kompatibel karo versi EmberZNet SDK. Deleng cathetan rilis kanggo SDK kanggo nemtokake nomer versi compiler sing kompatibel.
Prosedur iki nggunakake rong WSTK berbasis EFR32MG12 (Wireless Starter Kit), siji kanggo piranti klien sing mlaku ing mode System-on-Chip (SoC), lan siji minangka komponen Network Co-Processor (NCP) saka OTA Server. Host PC sing nganggo Linux utawa Windows Docker con-tainer uga dibutuhake minangka bagean saka persiyapan Server OTA.

Hardware klien
Piranti klien sing digunakake ing prosedur kasebut yaiku WSTK berbasis EFR32MG12 sing mlaku ing mode SoC. Sampeyan duwe rong pilihan kanggo ruang download. Kapisan yaiku nggunakake piranti panyimpenan eksternal, kayata dataflash serial utawa EEPROM serial, disambungake menyang piranti kasebut. Opsi kapindho, mung kasedhiya karo piranti sing duwe ruang lampu kilat luwih saka 512 kB, yaiku nggunakake bagean saka lampu kilat utama minangka ruang undhuhan. Bootloader sing nggunakake opsi kapindho asring diarani minangka bootloader panyimpenan internal utawa lokal. bagean EFR32MG12 bisa nggunakake panyimpenan lokal; EFR32MG1 bagean ora bisa. Kanggo dhaptar lengkap bagean memori eksternal didhukung kanggo bagean EFR32MGx, se UG489: Silicon Labs Gecko Bootloader Pandhuan pangguna.
Kanggo piranti sing nggunakake EFR32MG1, mung pilihan serial dataflash kasedhiya; ora ana bootloader aplikasi panyimpenan lokal sing saiki ditawakake. Nanging, bagean sing nomer diwiwiti karo EFR32MG1x6 utawa EFR32MG1x7 ngemot lampu kilat serial terpadu sing bisa digunakake kaya dataflash serial off-chip nanging tanpa komponen tambahan.
EFR32MG12- utawa piranti basis MG13 karo paling 512 kB lampu kilat internal uga ndhukung panyimpenan internal kanggo nggunakake desain bootloader aplikasi panyimpenan lokal, uga panyimpenan external kanggo nggunakake desain bootloader aplikasi basis lampu kilat SPI. Ing prosedur sing diterangake ing dokumen iki, panyimpenan internal digunakake ing EFR32MG12 kanthi lampu kilat 1024 kB. Hubungi dhukungan teknis Silicon Labs kanggo pitulung babagan tata letak memori liyane kanggo piranti liyane.
Kluster klien Zigbee OTA bisa digunakake karo piranti basis EmberZNet PRO sing mlaku ing mode SoC utawa EZSP NCP. Dokumen iki ora nuduhake carane ngatur aplikasi host EZSP kanggo klien basis NCP, nanging hardware server lan persiyapan diterangake ing bagean 2.2 Server Hardware padha nalika klien nggunakake EZSP. Cathetan aplikasi iki nuduhake siji mantanample carane kluster klien OTA bisa digunakake karo konfigurasi hardware tartamtu.
Piranti lunak klien adhedhasar Kerangka Aplikasi ZCL sing ana ing versi paling anyar saka tumpukan EmberZNet PRO.

Server Hardware
Piranti NCP sing digunakake ing prosedur kasebut yaiku WSTK berbasis EFR32MG kanthi aplikasi host sing disambungake UART sing bisa komunikasi liwat EmberZNet Serial Protocol (EZSP). Ing cathetan aplikasi iki, sistem Linux utawa Windows PC karo wadhah Docker dibutuhake kanggo mbukak piranti lunak host sing nyambung menyang NCP. Panyimpenan kanggo gambar piranti lunak OTA minangka lokal host file sistem. Kanggo ngindhari masalah ngubungake, aja nggunakake mesin virtual kanggo mbukak host.
Sampeyan bisa kanggo server OTA mbukak ing SoC basis EFR32MG, utawa nggunakake NCP karo beda (non-POSIX basis) sistem host. Konfigurasi sing beda tinimbang sing ditampilake ing kene mbutuhake mekanisme alternatif kanggo nyorong gambar menyang server OTA supaya bisa dilayani menyang klien liwat protokol kluster bootload Zigbee OTA. Kanggo exampNanging, gambar piranti lunak bisa di-push liwat backhaul sarana, sambungan Ethernet menyang jaringan lokal, utawa sawetara mekanisme kepemilikan liyane.
Sistem Linux sing disambungake menyang papan pangembangan sing tumindak minangka UART NCP mung minangka salah sawijining pilihan kanggo ngladeni OTA files. Iku pilihan sing paling ramah kanggo server OTA amarga ana akeh mekanisme kanggo push OTA files menyang server kang file sistem.
Tokoh ing ngisor iki nuduhake diagram konfigurasi hardware sing digunakake kanggo prosedur bootload aplikasi Zigbee OTA. Elinga yen mung siji klien sing dibutuhake.

Gambar 2.1. Diagram Perangkat Keras Bootload Aplikasi Zigbee OTA

OTA File Panyimpenan

Babagan Zigbee OTA File Format
OTA file format ditetepake ing Zigbee Cluster Library Specification, ing "OTA File Format" bagean saka "Over-The- Air Upgrade" bab. Gambar kasusun saka header Zigbee OTA, banjur siji utawa luwih gumpalan data bootloader kepemilikan, banjur set data tandha kriptografi opsional ditambahake ing pungkasan. Server OTA mung kudu maca header OTA kanggo ngawula file, lan kanthi mangkono bisa ngawula files kanggo manufaktur beda lan utawa produk beda. Gambar ing ngisor iki nuduhake mantanample saka tata letak ing file format.

Gambar 3.1. File Format dikirim liwat-the-Air

Silicon Labs wis nggawe alat kanggo ngasilake gambar OTA sing diarani Image-builder. Versi non-ECC saka Image-builder kalebu karo release EmberZNet PRO ing sub-direktori tool\image-builder. Kanggo informasi luwih lengkap babagan Image-builder, waca AN716: Pandhuan kanggo Nggunakake Image Builder.
Tandha OTA nuduhake tandha tandha gambar OTA file lan bebas saka tandha utawa enkripsi sing ana ing gambar nganyari file nang bungkus OTA file. Saiki, mung Smart Energy Profile nduweni dhukungan kanggo teken ing gambar. Cathetan aplikasi iki nganggep yen gambar OTA ora perlu ditandatangani.

Babagan OTA File Panyimpenan
Gambar anyar disimpen ing lampu kilat eksternal utawa lampu kilat internal, gumantung saka bootloader sing digunakake.

• Yen nggunakake SPI Storage Bootloader, gambar anyar bakal disimpen menyang lampu kilat SPI.
• Yen nggunakake Bootloader Panyimpenan Internal, gambar anyar bakal disimpen ing lampu kilat internal.

Offset gambar anyar disetel ing komponen piranti lunak OTA Simple Storage EEPROM Driver. Ana rong setelan khas.

1. Nggunakake slot-manager: Offset slot ditetepake ing bootloader. Ing aplikasi, setel Dhukungan Panyimpenan Gecko Bootloader menyang pilihan apa wae kajaba Aja nggunakake slot. Ing kasus iki, OTA Storage Start Offset lan OTA Storage End Offset ora bakal digunakake.
2. Nggunakake offset Absolute: Ing aplikasi, sampeyan kudu nyetel Dhukungan Panyimpenan Gecko Bootloader menyang Aja nggunakake slot. Ing kasus iki, Slot Panyimpenan Kanggo Simpen Gambar Kanggo ora bakal digunakake. Offset Mulai Panyimpenan OTA lan Offset Akhir Panyimpenan OTA kudu disetel kanthi bener. OTA Storage Start Offset kudu padha karo wiwitan offset saka slot sing ditetepake ing bootloader. OTA Storage End Offset kudu padha karo wiwitan offset plus ukuran slot slot kasebut.

Prosedur Umum

Ing ngisor iki njelasake langkah-langkah kanggo ngatur klien lan server kluster bootload OTA. Rincian diwenehi ing bagean sabanjure.

1. Ngatur lan mbangun gambar klien OTA asli.
2. Ngatur lan mbangun gambar klien OTA sing dianyari.
3. Nggawe server Zigbee OTA files.
4. Mbangun host PC.
5. Mbangun Bootloader Panyimpenan Internal.
6. Muat gambar klien asli.
7. Muat piranti lunak server EZSP NCP.
8. Muat gambar klien OTA sing dianyari ing server.
9. Jalanake klien / server Zigbee OTA.

Konfigurasi lan Gawe Gambar Klien Zigbee OTA Asli
Prosedur iki ngatur Zigbee LO On/Off Light (Zigbee - SoC Light) kanggo mbukak ing papan BRD4161A minangka mantanample, nanging bisa dicocogake kanggo sembarang sampl aplikasi. Jinis piranti Zigbee liyane bisa dikonfigurasi kanthi cara sing padha. mantanamppersiyapan kalebu dhukungan kanggo klien kluster bootload Zigbee OTA.
Tata cara ing cathetan aplikasi iki nggawe rong gambar klien: versi asli lan versi sing dianyari. Klien iki bakal dadi versi asli. Gambar sing digawe bakal mbukak sadurunge proses Zigbee OTA nganyarke piranti klien.
Tindakake langkah-langkah ing ngisor iki kanggo ngatur klien OTA:

1. Ing Simplicity Studio, gawe lan jeneng proyek anyar. Iki bisa kosong utawa adhedhasar salah sawijining mantan sing kasedhiyaamples. Kanggo tujuan latihan iki, sampeyan bisa uga pengin menehi jeneng file ZNet_OTA_Client_7 (kanggo tumpukan 7.xx).
2. Bukak Project Configurator banjur klik tab SOFTWARE COMPONENTS.
3. Nggoleki OTA-related software components and install the following highlighted components.
   
4. Konfigurasi komponen Kebijakan Klien Kluster OTA Bootload kanthi nyetel Versi Firmware menyang nilai 1 minangka nomer versi asli. Iki kritis, amarga langkah-langkah sabanjure nganggep sampeyan duwe versi disetel menyang 1.
   
5. Konfigurasi komponen Driver EEPROM OTA Simple Storage kanthi ngaktifake Dhukungan Bootloading SOC lan mateni Dhukungan SOC-Read-Modify-Write. Nilai Offset Mulai OTA Storage lan OTA Storage End Offset ing komponen iki bisa uga kudu diganti kanggo tata letak panyimpenan liyane, kalebu tata letak sing nglibatake Slot Panyimpenan. Hubungi dhukungan teknis Silicon Labs kanggo pandhuan babagan milih nilai liyane adhedhasar kasus panggunaan sampeyan. Kanggo mantan ikiample, OTA klien OTA Storage Mulai Offset (540672) lan Akhir Offset (999424) diatur kanggo cocog karo sing kasebut kanggo Internal Storage Bootloader bakal dibangun ing bagean mengko.
   
6. Saiki Bukak Project Configurator banjur pilih tab CONFIGURATION TOOLS. Bukak Zigbee Cluster Configurator.
   
7. Sorot Endpoint-1 saka Dhaptar Kluster ing panel kiwa. Expand grup Umum lan ngaktifake klien Over-the-Air Bootloading Cluster minangka kapacak ing ngisor iki. Simpen pangowahan nganggo tombol trabasan CTRL-S utawa File-> Simpen.
   
8. Bukak Project Configurator banjur pilih tab CONFIGURATION TOOLS. Bukak Alat Pin banjur pilih tab Periferal ing panel Konfigurasi ing sisih tengen. Verifikasi yen USART0 duwe IO Stream: USART (vcom) sing dipilih minangka komponen piranti lunak. Simpen owah-owahan sing digawe menyang Alat Pin nganggo tombol trabasan CTRL-S utawa File-> Simpen.
   
9. Gawe aplikasi miturut metode sing disenengi. Yen .gbl (Gecko Bootloader) file ora digawe minangka bagéan saka mbangun, sampeyan bisa mbukak printah komandan ing ngisor iki kanggo nggawe kanthi manual saka S-rekaman file ZNet_OTA_Client_7.s37 minangka kapacak ing ngisor iki. Informasi luwih lengkap babagan komandan bisa ditemokake ing UG162: Pandhuan Referensi Panglima Kesederhanaan.
   commander.exe gbl nggawe .\ZNet_OTA_Client_7.gbl –app .\ZNet_OTA_Client_7.s37

Konfigurasi lan Gawe Gambar Klien Zigbee OTA sing Dianyari
Bagean iki mbangun gambar versi sing dianyari. Gambar kasebut identik kajaba nomer versi sing dipasang ing gambar kasebut.

Salin Gambar Klien OTA Asli
Nyalin ZNet_OTA_Client_7.gbl asli file karo Versi Firmware disetel menyang 1 menyang folder liyane supaya ora ditindhes nalika versi "dianyari" dibangun ing jejere kanggo ngaktifake nganyari OTA. Ganti jeneng iki file cocok, kanggo example:
ZNet_OTA_Client_7_v1.gbl.

Ngowahi, Nggawe, lan Mbangun Konfigurasi Klien OTA sing Dianyari
Kanggo nggawe konfigurasi Klien OTA anyar, tindakake langkah ing ngisor iki.

• Bukak proyek Klien OTA sing wis disimpen sadurunge digawe ing bagean 4.1 Ngatur lan Mbangun Gambar Klien OTA Zigbee Asli.
• Bukak Project Configurator banjur klik tab SOFTWARE COMPONENT.
• Nggoleki the OTA Bootload Cluster Client Policy component and click Configure to configure it.

• Ngganti nilai ing Versi Firmware kanggo 22. Nilai iki minangka pilihan sing sewenang-wenang, nanging kudu luwih gedhe tinimbang versi sadurunge.

• Mbangun proyek. Goleki .ota file digawe ing direktori output compiler. Nanging, yen mung .s37 file digawe saka banjur mbangun, banjur tindakake pandhuan ing ngisor iki kanggo nggawe file ZNet_OTA_Client_7.ota dibutuhake kanggo upgrade mengko. Informasi liyane babagan utilitas image-builder bisa ditemokake ing AN716: Pandhuan kanggo Nggunakake Image-Builder.
  commander.exe gbl nggawe .\ZNet_OTA_Client_7.gbl –app .\ZNet_OTA_Client_7.s37
  image-builder-windows.exe – create ZNet_OTA_Client_7.ota –version 22 –manuf-id 0x1002 –image-type 0 –tag-id 0x0000 –tag-file .\ZNet_OTA_Client_7.gbl –string “ZNet_OTA_Client_7”
• Salin ZNet_OTA_Client_7.ota menyang direktori ing ngendi sampeyan nyimpen ZNet_OTA_Client_7_v1.gbl lan ganti jeneng kanggo trek nomer versi, kanggo Examplan ZNet_OTA_Client_7_v22.ota.

Nggawe Zigbee OTA Server Files
Prosedur iki nggawe sumber kanggo piranti host gateway Zigbee 3.0. Piranti kasebut kalebu dhukungan kanggo server kluster bootload Zigbee OTA. Piranti lunak server host bisa ndhukung gambar OTA sing ditandatangani lan ora ditandatangani amarga ora bakal nindakake verifikasi files. Kanggo ngatur server OTA:

• Ing Simplicity Studio, miwiti Wisaya Proyek Anyar. Pilih Linux 32 Bit minangka piranti target lan Gawefile IDE minangka Toolchain. Klik Sabanjure.

• Pilih Zigbee Host Gateway minangka mantanample project minangka kapacak ing ngisor iki lan klik Sabanjure.

• Pilih Salin konten banjur klik Rampung kanggo nggawe proyek kaya sing ditampilake ing ngisor iki.

• Proyek host Z3Gateway files digawe ing Lokasi sing ditemtokake ing langkah sadurunge.

Mbangun PC Host
Mbangun server OTA bisa ditindakake ing sistem Linux utawa ing wadhah Windows Docker. Cathetan aplikasi iki nganggep yen sampeyan ora nggunakake kompiler silang lan sistem target iku sistem sing padha karo piranti pangembangan. Sampeyan bisa nggawe kompilasi silang kanggo sistem Linux sing beda (kanggo example, ing PC x86 sing ngarahake sistem ARM Linux sing dipasang). Waca bagean 5.4 Nggunakake Cross-Compiler kanggo Server OTA kanggo katrangan babagan carane nggawe kompilasi silang kanggo sistem liyane.
Mbangun Server OTA kanggo Linux mbutuhake sawetara alat pangembangan. Kita nganggep sampeyan duwe akses menyang alat kasebut. Padha kaya ing ngisor iki:

• Gawe
• GCC
• sed
• awk
• xargs
• Pustaka C standar lan header pangembangane
• Pustaka Readline lan header pangembangane
• Perpustakaan Ncurses lan header pangembangane

Langkah-langkah kanggo mbangun server OTA ing Linux tindakake. Dianggep langkah-langkah kasebut ditindakake sawise ngonfigurasi server ing Simplicity Studio.

1. Nyalin tumpukan EmberZNet PRO files saka lokasi sing diinstal ing Windows menyang direktori ing PC Linux (contone, direktori Ngarep pangguna). Iki kudu kalebu ing files sing padha kui ing langkah sadurunge.
2. Bukak Bash Shell.
3. Ganti direktori proyek EmberZNet ing PC Linux utawa Raspberry Pi. Kanggo example, cd /ngarep/ /Z3Gateway
4. Run Make ing Make sing digawefile saka direktori kasebut, contoneample nggawe –f Z3Gateway.Makefile utawa mung nggawe yen digawe Nggawefile ana ing direktori kerja saiki lan khusus dijenengi Makefile.
5. Kompilasi kudu rampung kanthi sukses karo Z3Gateway sing bisa dieksekusi ing subdirektori ./build/debug/

Kanggo mbangun Server OTA Z3Gateway nggunakake wadhah Windows Docker, waca AN1389: Mlaku Aplikasi Host Zigbee ing Wadah Docker.

Mbangun Bootloader Panyimpenan Internal
Kanggo nganyarke OTA kanthi sukses, bootloader kudu dipilih lan dikonfigurasi kanthi bener. Review UG489: Silicon Labs Gecko Boot-loader Pandhuan pangguna kanggo GSDK 4.0 lan luwih kanggo mangerteni sing luwih lengkap bab carane bootloader bisa lan carane ngatur kanggo upgrade OTA.
Langkah-langkah ing ngisor iki ngatur lan mbangun Bootloader Panyimpenan Internal sing nyimpen gambar nganyari perangkat kukuh ing EFR32MG12 saka papan BRD4161A. Slot panyimpenan dikonfigurasi kanggo miwiti ing alamat 0x84000 kanthi ukuran 448 kB. Bootloader iki bisa digunakake dening klien lan server OTA ing bagean sabanjure.

• Jalanake Wisaya Proyek Anyar saka Simplicity Studio (SSv5) kanggo milih lan nggawe proyek bootloader panyimpenan internal anyar.

• Sawise proyek digawe, mbukak lan ngatur komponen piranti lunak Bootloader Storage Slot Setup. Priksa manawa alamat wiwitan panyimpenan ana ing 540672 9 (0x84000) kanthi ukuran 458752 (448kB). Priksa manawa nilai kasebut cocog karo OTA Storage Start Offset (540672) klien OTA lan Offset Akhir (999424) sing ditemtokake sajrone konfigurasi klien OTA ing bagean 4.1 Ngatur lan Mbangun Gambar Klien Zigbee OTA Asli.

• Kanggo mbangun nggawe gambar bootloader gabungan sing dibutuhake, klik-tengen ing jeneng proyek ing Project Explorer view banjur pilih Properties. Banjur tambahake string iki ../postbuild.sh ${ProjDirPath} ${Studio Sdk Path} ${Commander Adapt-er Pack Path} menyang kothak printah ing langkah-langkah Post-build kaya ing ngisor iki. Klik Apply and Close.

• Mbangun bootloader.
• Gambar bootloader-storage-internal-single-combined.s37 bootloader digawe. Elinga yen mung piranti Seri 1 mbutuhake bootloader gabungan. Waca UG489: Silicon Labs Gecko Bootloader Pandhuan pangguna kanggo GSDK 4.0 lan luwih dhuwur kanggo informasi luwih lengkap.

Muat Gambar Klien Asli
Lampu kilat bootloader sing cocog kanggo papan sampeyan. Ing kasus iki, sampeyan bisa nggunakake bootloader sing padha kanggo Klien lan Server OTA yen sampeyan nggunakake papan sing padha (kanggo ex.amplan, BRD4161A). Sampeyan bisa nggunakake Simplicity Studio kanggo nindakake iki (pirsani QSG180: Zigbee EmberZNet Quick-Start Guide kanggo SDK v7.0 lan luwih dhuwur kanggo instruksi babagan loading aplikasi lan perangkat kukuh bootloader) utawa gunakake printah Simplicity Commander (pirsani UG162: Pandhuan Referensi Panglima Kesederhanaan kanggo rincian tambahan. ):
komandan lampu kilat -d EFR32 [path menyang bootloader-storage-internal-single-combined.s37] komandan lampu kilat -d EFR32 [path menyang ZNet_OTA_Client_7.gbl]

Muat EZSP NCP Server Software
Kanggo nggunakake piranti EFR32MG sing disambungake menyang host PC liwat USB, perlu kanggo mbangun lan mbukak piranti lunak EZSP NCP menyang chip target. Ing ngisor iki nerangake proses nemokake lan sumunar gambar NCP sing wis dibangun menyang EFR32MG12 minangka mantanample kanggo chip target NCP. Sampeyan uga bisa mbangun gambar dhewe kaya sing diterangake ing AN1320: Mbangun Aplikasi NCP Customized karo Zigbee EmberZNet 7.x yen sample gambar ora bisa dumunung.

1.  Goleki prebuilt sample ncpuart-hw saka GSDK 4.x release. Minangka mantanample, ing ngisor iki lokasi gambar kanggo BRD4161A.
   C:\SiliconLabs\SimplicityStudio\v5\offline\com.silabs.sdk.stack.su-per_ \protocol\zigbee\demo\ncp-uart-hw\ ncp-uart-hw-brd4161a.s37
2. Goleki prebuilt bootloader-storage-internal-single-combined.s37.
3. Lampu kilat ing gambar bootloader ngiring dening gambar ncpuart-hw minangka kapacak ing ngisor iki.
   commander flash -d EFR32 [path to bootloader-storage-internal-single-combined.s37] commander flash -d EFR32 [path to ncp-uart-hw-brd4161a.s37]

Muat Gambar Klien OTA sing Dianyari ing Server
Aplikasi OTA Server nggoleki OTA fileing direktori disebut ota-files sing minangka sub-direktori ing direktori kerja saiki saka ngendi aplikasi server dibukak.

Kanggo Linux

1. Bukak cangkang Linux ing PC Server OTA.
2. Goleki OTA sing dibangun sadurunge file ZNet_OTA_Client_7_v22.ota.
3. Navigasi menyang direktori ing ngendi OTA Server dumunung (contone /home/ /Z3Gateway)
4. Nggawe subdirektori lan nyalin OTA file marang iku. cd /ngarep/ /Z3Gateway mkdir ota-files cp -i [PATH To ZNet_OTA_Client_7_v22.ota] ota-files/

Kanggo Windows Docker Container 

1. Goleki OTA sing dibangun sadurunge file ZNet_OTA_Client_7_v22.ota.
2. Gunakake Windows Explorer kanggo nggawe direktori sing diarani ota-files ing direktori ngendi aplikasi Z3Gateway OTA Server bakal dibangun lan mbukak nggunakake wadhah Docker.
3. Salin OTA file marang ota-files direktori.
4. Priksa manawa maneh mbangun docker kanggo nganyari OTA file ing wadhah.

Jalanake Klien / Server Zigbee OTA

1. Priksa manawa WSTK kanggo piranti NCP disambungake menyang PC nganggo kabel USB.
2. Bukak Server OTA kanthi nglakokake aplikasi server OTA saka baris printah lan pass lokasi port komunikasi. Port komunikasi bakal dadi piranti port USB utawa serial. Cara kanggo nemtokake port EFR32MG12 disambungake gumantung ing sistem operasi PC inang.

Ing Linux
Port USB biasane didaftar minangka / dev / ttyUSBX, ing ngendi X minangka nomer sing diwenehake dening sistem operasi. Kanggo example, ing ngisor iki bakal nggunakake ttyUSB0.

• Bukak Linux Shell.
• Ganti menyang direktori ing ngendi gambar aplikasi OTA Server dumunung. Kanggo example: cd /ngarep/ /Z3Gate-way/build/debug/
• Miwiti server kanthi mbukak ./Z3Gateway -n 0 –p /dev/ttyUSB0.

Ing Windows Running Docker Container
Priksa manawa sampeyan wis ngetutake pandhuan saka AN1389 sing kasebut sadurunge: Mlaku Aplikasi Host Zigbee ing Wadah Docker kanggo mbangun lan mbukak wadhah Docker kanggo aplikasi host Z3Gateway.
Port USB yaiku COM1, COM2, COM3, lan liya-liyane. Port COM bisa ditemtokake kanthi nonton bagean Ports (COM & LPT) ing Windows Device Manager nalika nyopot lan relogging konektor USB WSTK. Ex ing ngisor ikiample nggunakake COM1.

• Miwiti jendhela printah minangka Administrator.
• Jalanake printah silink ing ngisor iki kanggo miwiti sesi silink. silink.exe -automap 4900
• Miwiti jendhela printah anyar.
• Navigasi menyang direktori ing ngendi aplikasi inang Z3Gateway dibangun.
• Assuming a Dockerfile wis digawe adhedhasar AN1389, mbukak printah ing ngisor iki ing jendhela printah kanggo miwiti wadhah. mbangun docker. -t z3gateway docker mbukak -iku z3gateway
• Kanggo mbukak aplikasi host, ketik printah ing wadhah kasebut. ./ mbangun/debug/Z3Gateway -n 0 -p /dev/ttySilink
• Ing ngisor iki nuduhake sukses aplikasi host Z3Gateway saka wadhah kasebut.

• Sambungake menyang piranti Klien OTA ing jendhela Simplicity Studio Serial 1 utawa kanthi mbukak command prompt Windows lan nyambung liwat telnet menyang alamat IP ing port 4901.
• Priksa manawa piranti klien lan server duwe printing Kluster Loading Over-the-Air Boot kanthi nggunakake printah ing ngisor iki:
  • Ing Klien OTA: plugin ota-storage-common print Gambar
  • Ing Server OTA: plugin ota-storage-common print Images
    Ing kasus loro, output kudu dicithak menyang CLI. Yen ora ana output sing katon, bali lan verifikasi konfigurasi aplikasi lan konfigurasi Debug Printing.
• Priksa manawa klien nggunakake versi lawas saka piranti lunak klien. Saka CLI klien OTA ketik printah ing ngisor iki. Sampeyan kudu ndeleng output sing cocog:
  Z3Light>plugin info ota-klien
  Info pitakon gambar klien
  ID Manuf: 0x1002
  ID Jinis Gambar: 0x0000
  Versi saiki: 0x00000001
  Versi Hardware: NA
  Tundha pitakon ms: 300000
  Server Discovery Tundha ms: 600000
  Ngundhuh Tundha ms: 0
  Run Upgrade Tundha ms: 600000
  Verifikasi Tundha ms: 10
  Ngundhuh Ambang Kasalahan: 10
  Nganyari Ambang Enteni: 10
  Elinga yen kolom versi saiki ngandika 0x00000001.
• Verifikasi manawa Server OTA duwe gambar sing luwih anyar ing panyimpenan OTA. Saka CLI server OTA ketik printah ing ngisor iki. Sampeyan kudu ndeleng output sing cocog:
  plugin ota-storage-common print Gambar
  Z3Gateway>Gambar 0
  Versi Header: 0x0100
  Dawane Header: 56 bita
  Kontrol lapangan: 0x0000
  ID Manuf: 0x1002
  Jinis gambar: 0x0000
  Versi: 0x00000016
  Versi Zigbee: 0x0002
  String Header: ZNet_OTA_Client_7
  Ukuran gambar: 331502 bita
  Total Tags: 1
  Tag0x0000
  Dawane: 331440
  1 gambar ing panyimpenan OTA.
  Elinga yen nomer versi 0x00000016. Ukuran gambar sing tepat bisa beda-beda.
• Busak versi sadurunge file sing wis disimpen ing klien. Iki biasane ora perlu ing sistem produksi, nanging ing ex ikiample versi sadurungé bisa nimbulaké masalah. Ketik printah ing ngisor iki ing klien:
  plugin ota-storage-common delete 0.
• Pateni nampa printing pesen kanggo matesi output console sak download. Nglewati langkah iki ora bakal mengaruhi fungsi.
  • Ing server: opsi printrx-msgs mateni
  • Ing klien: opsi printrx-msgs mateni
• Gabung piranti menyang jaringan sing padha.
  • Ing server: ninggalake net
  • Ing server: plugin network-creator start 1
  • Ing server: plugin network-creator-security open-network
  • Ing klien: plugin network-steering start 0
    Yen klien gabung sukses, sampeyan kudu ndeleng dialog babagan interaksi pusat kepercayaan ing output.
• Kanggo verifikasi manawa klien wis nyambung menyang server, ketik info ing klien lan server. ID PAN kudu padha.
• Miwiti mesin negara OTA Klien ing klien: plugin ota-klien wiwitan Cathetan: Download bisa nganti 10 menit.
• Yen kabeh dadi apik, sampeyan kudu ndeleng output ing ngisor iki:

Mbaleni Prosedur
Sawise klien Zigbee OTA wis nganyari liwat Zigbee over-the-air boot kluster, iku mung bisa nganyari maneh yen server duwe versi beda saka piranti lunak. Mula, kanggo nindakake download firmware Zigbee OTA maneh, sampeyan kudu nindakake salah siji saka ing ngisor iki:

• Downgrade Gambar mlaku menyang Versi Asli
  Jalanake maneh langkah-langkah ing bagean 4.6 Muat Gambar Klien Asli kanggo mbukak versi asli 1 gambar piranti lunak Klien OTA.
• Gawe Gambar Liyane nganggo Versi Piranti Lunak Anyar

Jalanake langkah-langkah ing ngisor iki:

1. Jalanake maneh langkah-langkah ing bagean 4.2 Konfigurasi lan Gawe Gambar Klien Zigbee OTA sing Dianyari nanging nemtokake Versi Firmware liyane sing luwih gedhe tinimbang 22.
2. Jalanake maneh langkah-langkah ing bagean 4.8 Muat Gambar Klien OTA sing Dianyari ing Server lan ganti gambar upgrade Klien OTA sing lawas karo sing anyar.
   Priksa manawa argumen -version sing dikirim menyang Image-builder nuduhake nomer versi paling anyar.

Topik Lanjut

Bagean iki nyedhiyakake sawetara topik lanjutan sing ngidini pangembang ngatur beban boot menyang hardware lan piranti lunak tartamtu.

Nemtokake ID Produsen Panjenengan
Tindakake langkah iki kanggo nemtokake ID pabrikan liyane saka 0x1002, yaiku ID manufaktur khusus Silicon Labs.
Saben anggota Connectivity Standards Alliance (CSA) duwe ID pabrikan dhewe. Dhaptar ID pabrikan disimpen ing CSA Document 05-3874 Produsen Kode Database. Yen perusahaan sampeyan ora duwe ID pabrikan, mula kudu njaluk siji saka CSA (https://csa-iot.org/).

• Nalika ngonfigurasi Klien OTA ing Project Configurator, tindakake ing ngisor iki:
  • Pilih tab CONFIGURATION TOOLS lan bukak Zigbee Cluster Configurator.

• Klik ing ZCL GLOBAL OPTIONS.

• Ing entri kothak teks Produsen Produk, pilih utawa ketik kode pabrikan sampeyan dhewe.

• • Simpen pangowahan nganggo tombol trabasan CTRL-S utawa File-> Simpen.
  • Kompilasi maneh aplikasi kasebut.
• Nalika ngasilake gambar Zigbee OTA file, aja nglakoni.
  • Nemtokake ID pabrikan sampeyan kanthi menehi nilai kasebut menyang argumen -manuf-id nalika nglakokake perintah image-builder.

Cathetan: Sampeyan ora perlu ngowahi ID pabrikan server OTA ing ex ikiample. Server bisa uga duwe ID pabrikan sing beda karo Klien OTA. Sampeyan bisa milih ngowahi ID pabrikan supaya cocog karo piranti server OTA sing dibangun perusahaan sampeyan.

Nemtokake ID Tipe Gambar Panjenengan
Tindakake langkah iki kanggo nemtokake ID jinis gambar liyane saka 0x0000.

1. Nalika ngonfigurasi Klien OTA ing Project Configurator, tindakake ing ngisor iki:
   1. Pilih komponen piranti lunak OTA Bootload Cluster Client Policy.
   2. Ing kothak entri teks ID Tipe Gambar, ketik kode ID jinis gambar sampeyan dhewe.
      
   3. Kompilasi maneh aplikasi nggunakake meja kerja IAR.
2. Yen proyek ora ngasilake OTA file kanthi otomatis, argumen Tipe Gambar anyar kudu ditemtokake ing baris printah nalika mbukak Image-builder kanthi -image-type.

Ngowahi Klien OTA kanggo Gunakake EEPROM Beda
Akeh macem-macem bagean panyimpenan external kasedhiya, lan pilihan kang digunakake adhedhasar akeh faktor beda. AN772: Nggunakake Ember Application Bootloader lan UG489: Silicon Labs Gecko Bootloader Pandhuan pangguna kanggo GSDK 4.0 lan luwih rinci sawetara bagean beda sing didhukung dening Silicon Labs lan macem-macem parameter piranti.
Yen bagean panyimpenan eksternal ora ndhukung read-modify-write, banjur konfigurasi Project Configurator kudu dianyari. Ing ngisor iki nerangake proses kasebut:

1. Bukak Konfigurator Proyek klien OTA.
2. Pilih tab SOFTWARE COMPONENT.
3. Pilih OTA Simple Storage EEPROM Driver plugin lan mateni opsi labeled EEPROM Read-modify-write piranti Sup-port.
4. Kompilasi maneh aplikasi kasebut.

Cathetan: Bootloader anyar bakal dibutuhake kanggo ndhukung owah-owahan ing EEPROM. Sampeyan kudu mbukak bootloader anyar kanthi tindakake langkah-langkah ing bagean 4.6 Muat Gambar Klien Asli, lan pilih salah siji sing cocok kanggo bootloader sing digunakake.

Nggunakake Cross-Compiler kanggo Server OTA
Sampeyan bisa nggunakake cross-compiler kanggo mbangun server OTA kanggo sistem target liyane. Kanggo example, mbangun ing PC Windows x86 kanggo sistem ARM Linux. Proses iki relatif terus maju yen cross-compiler wis diinstal lan diatur kanthi bener. Kanggo nindakake iki, sampeyan kudu mbukak make lan pass jeneng / lokasi compiler lan linker ing baris printah.
Kanggo example:
nggawe CC=/opt/crosstool/gcc-4.0.1-glibc-2.3.5/arm-unknown-linux-gnu/bin/arm-unknown-linux-gnu-gcc LD=/opt/crosstool/gcc-4.0.1. 2.3.5-glibc-XNUMX/arm-unknown-linux-gnu/bin/arm-unknown-linux-gnu-gcc
The Makefile nyana kompiler baris printah gaya GCC, lan nggunakake printah compiler (tinimbang printah linker langsung) kanggo linking.

Nggunakake Gambar GBL sing dienkripsi
Gambar ndhelik nglindhungi gambar aplikasi anyar saka pengawasan utawa tampering kanthi nggunakake kunci enkripsi simetris. Kanggo informasi luwih lengkap babagan Gecko Bootloader lan gambar GBL sing dienkripsi, kalebu ngganti jinis bootloader lan mbukak kunci enkripsi menyang piranti, deleng UG489: Silicon Labs Gecko Bootloader User's Guide kanggo GSDK 4.0 lan luwih dhuwur.

Studio Kesederhanaan
Akses siji-klik menyang MCU lan piranti nirkabel, dokumentasi, piranti lunak, perpustakaan kode sumber & liya-liyane. Kasedhiya kanggo Windows, Mac lan Linux!

• Portofolio IoT
  www.silabs.com/IoT
• SW/HW
  www.silabs.com/simplicity
• Kualitas
  www.silabs.com/quality
• Dhukungan & Komunitas
  www.silabs.com/community

Penafian
Silicon Labs arep menehi pelanggan dokumentasi paling anyar, akurat, lan jero kabeh periferal lan modul sing kasedhiya kanggo sistem lan piranti lunak imple-menters nggunakake utawa arep nggunakake produk Silicon Labs. Data karakterisasi, modul lan peripheral sing kasedhiya, ukuran memori lan alamat memori nuduhake saben piranti tartamtu, lan paramèter "Khas" sing kasedhiya bisa beda-beda ing macem-macem aplikasi. Aplikasi exampsing diterangake ing kene mung kanggo ilustrasi. Silicon Labs nduweni hak kanggo nggawe owahan tanpa kabar luwih lengkap babagan informasi produk, spesifikasi, lan katrangan ing kene, lan ora menehi jaminan babagan akurasi utawa kelengkapan informasi sing kalebu. Tanpa kabar sadurunge, Silicon Labs bisa nganyari perangkat kukuh produk sajrone proses manufaktur amarga alasan keamanan utawa linuwih. Owah-owahan kasebut ora bakal ngowahi spesifikasi utawa kinerja produk. Silicon Labs ora duwe tanggung jawab kanggo akibat saka panggunaan informasi sing diwenehake ing dokumen iki. Dokumen iki ora nyatakake utawa kanthi tegas menehi lisensi kanggo ngrancang utawa nggawe sirkuit terpadu. Produk kasebut ora dirancang utawa sah kanggo digunakake ing piranti FDA Kelas III, aplikasi sing dibutuhake persetujuan prapasar FDA utawa Sistem Dhukungan Urip tanpa idin tinulis khusus saka Silicon Labs. "Sistem Dhukungan Urip" yaiku produk utawa sistem sing dimaksudake kanggo ndhukung utawa nyengkuyung urip lan/utawa kesehatan, sing, yen gagal, bisa uga bisa nyebabake ciloko utawa pati pribadi sing signifikan. Produk Silicon Labs ora dirancang utawa sah kanggo aplikasi militer. Produk Silicon Labs ora bakal digunakake ing gaman pemusnah massal kalebu (nanging ora winates ing) senjata nuklir, biologi utawa kimia, utawa misil sing bisa ngirim senjata kasebut. Silicon Labs nolak kabeh jaminan sing nyata lan tersirat lan ora tanggung jawab utawa tanggung jawab kanggo ciloko utawa kerusakan sing ana gandhengane karo panggunaan produk Silicon Labs ing aplikasi sing ora sah kasebut. Cathetan: Isi iki bisa uga ngemot terminologi nyerang sing saiki wis lungse. Silicon Labs ngganti istilah kasebut nganggo basa inklusif yen bisa. Kanggo informasi luwih lengkap, bukak www.silabs.com/about-us/inclusive-lexicon-project
Informasi merek dagang
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® lan logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo lan kombinasi kasebut , "mikrokontroler paling ramah energi ing donya", Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, logo Zentri lan Zentri DMS, Z-Wave®, lan liya-liyane yaiku merek dagang utawa merek dagang kadhaptar saka Silicon Labs. ARM, CORTEX, Cortex-M3 lan THUMB iku merek dagang utawa merek dagang kadhaptar saka ARM Holdings. Keil minangka merek dagang kadhaptar saka ARM Limited. Wi-Fi minangka merek dagang kadhaptar saka Wi-Fi Alliance. Kabeh produk utawa jeneng merek liyane sing kasebut ing kene minangka merek dagang saka sing duwe.

Silicon Laboratories Inc. Sajarah rega saham
400 West Cesar Chavez Austin, TX 78701
USA
www.silabs.com

Dokumen / Sumber Daya

SILICON LABS EFR32MG12 Ver Server Bootload Udara lan Persiyapan Klien Kanggo Zigbee SDK 7.0 Lan Luwih [pdf] Pandhuan pangguna EFR32MG12 Ver Server Bootload Udara lan Setup Klien Kanggo Zigbee SDK 7.0 Lan Luwih, EFR32MG12, Ver Server Bootload Udara lan Setup Klien Kanggo Zigbee SDK 7.0 Lan Luwih, Setup Klien Kanggo Zigbee SDK 7.0 Lan luwih dhuwur, 7.0 Lan luwih dhuwur

Referensi

• Manual pangguna