[ZC-02] Zigbee Coordinator USB Stick / Dongle — CC2652P — Zigbee2MQTT / ZHA

ZC-02 Zigbee Coordinator USB

Zigbee Coordinator adalah perangkat yang berperan utama dalam mengatur dan mengontrol jaringan Zigbee.

Zigbee adalah protokol komunikasi nirkabel untuk menghubungkan berbagai perangkat dalam jaringan jarak pendek, terutama perangkat hemat energi. Di dalam jaringan Zigbee, berbagai jenis sensor dapat dipakai sesuai aplikasi.

Sensor yang sering dipakai di jaringan Zigbee

Sensor suhu — pengukuran suhu lingkungan; iklim, cuaca, pemantauan suhu.
Sensor kelembaban — tingkat kelembaban; kontrol kelembaban, pertanian cerdas, cuaca.
Sensor gerakan (motion) — deteksi pergerakan; keamanan, pencahayaan otomatis.
Sensor cahaya — intensitas cahaya; pencahayaan otomatis, manajemen energi.
Sensor gas — keberadaan/konsentrasi gas; kebocoran, keselamatan.
Sensor karbon monoksida (CO) dan asap — detektor CO dan asap.
Sensor tekanan — tekanan atmosferik; cuaca, ketinggian, prakiraan.
Sensor kelembaban tanah — pertanian cerdas, irigasi, pertumbuhan tanaman.

Perangkat Zigbee dengan sensor-sensor ini dipakai di IoT, rumah pintar, pemantauan industri, dan lainnya. Zigbee memungkinkan komunikasi nirkabel yang efisien dan hemat energi.

Sebagai pusat kendali, Zigbee Coordinator mengatur komunikasi antar perangkat Zigbee dan membantu pengiriman data berjalan lancar, aman, dan efisien.

Tugas utama Zigbee Coordinator

Mengatur jaringan — membentuk jaringan, penyusunan dan alokasi alamat ke perangkat lain.
Menghubungkan perangkat — mengizinkan perangkat bergabung dan menjaga daftar perangkat terhubung.
Rute data — menentukan jalur transmisi data agar efisien.
Keamanan — kunci enkripsi dan autentikasi perangkat yang bergabung.
Sinkronisasi waktu — koordinasi tugas dan jadwal berbasis waktu.
Monitoring kinerja — memantau jaringan, mengidentifikasi masalah, dan perbaikan bila perlu.
Konektivitas ke jaringan lain — misalnya internet atau LAN untuk kontrol dan pemantauan jarak jauh.

Koordinator menjadi titik hubung antara jaringan Zigbee dan jaringan lain (internet, LAN) melalui USB, Ethernet, atau Wi‑Fi.

Produk ini memakai koneksi USB untuk berinteraksi dengan aplikasi di komputer/PC yang bertindak sebagai pusat kendali Zigbee Coordinator.

Link pemesanan

Zigbee Coordinator

Zigbee Router

Penting: Coordinator vs Router

Perbedaan utama ada pada peran dan firmware, bukan bentuk fisik (fisiknya sama; bedanya firmware di dalamnya).

Zigbee Coordinator

Peran paling penting; setiap jaringan Zigbee harus punya satu coordinator.
Biasanya perangkat pertama yang dinyalakan di jaringan.
Menginisiasi, membentuk, dan mengendalikan jaringan; alokasi alamat; sinkronisasi waktu.
Hanya satu coordinator per jaringan Zigbee.

Zigbee Router

Perangkat tambahan untuk mengulang dan mengarahkan data (repeater).
Tidak membentuk jaringan atau mengatur alokasi alamat seperti coordinator.
Memperluas jangkauan dan memperkuat konektivitas, terutama untuk perangkat di luar jangkauan langsung coordinator.

Jaringan umumnya terdiri dari satu coordinator, beberapa router, dan perangkat akhir (end devices) seperti sensor dan aktuator.

Instalasi dan pairing Zigbee Router USB (model terpisah): Panduan ZR-02.

Instalasi

Persyaratan: komputer atau PC dengan salah satu cara sebagai berikut:

Hanya Zigbee2MQTT — Panduan instalasi Zigbee2MQTT
Home Assistant + Zigbee2MQTT
- Instalasi Home Assistant
  - Judul video: Cara Install Home Assistant di VirtualBox - 2025 — kanal iothings-io di YouTube.
- App hassio-zigbee2mqtt (nama repositori/paket di GitHub tetap hassio-zigbee2mqtt)
Home Assistant + integrasi ZHA - Instalasi Home Assistant - Integrasi ZHA

Dengan salah satu opsi di atas, CC2652P USB Stick/Dongle dapat dipasang sebagai Zigbee Coordinator.

Rekomendasi: gunakan kabel ekstensi USB antara dongle dan komputer. Antena bekerja lebih baik jika dijauhkan dari PC dan sumber Wi‑Fi 2,4 GHz. Letakkan dongle di area terbuka, hindari halangan berat (terutama dinding logam dan belakang layar LCD).

Instalasi Zigbee2MQTT lewat Apps (Home Assistant)

Bagi pengguna lama: Di Home Assistant versi baru, istilah Add-ons di antarmuka diganti menjadi Apps, dan Add-on store menjadi App store — fungsinya sama (Supervisor). Panduan di bawah memakai nama baru. Bila instalasi Anda masih menampilkan Add-ons / ADD-ON STORE, buka menu yang setara.

1. MQTT broker

Instal dan jalankan MQTT Mosquitto broker dari App store jika memakai broker lokal. Setelah terpasang, integrasi MQTT muncul di Settings → Devices & services → Integrations — konfigurasi sesuai kebutuhan.

2. App Zigbee2MQTT

Settings → Apps → App store → menu titik tiga kanan atas → Repositories.
Tambah repo: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt → ADD → CLOSE.
Buka lagi App store, pilih Zigbee2MQTT → Install.
Tab Configuration — isi data_path, misalnya /config/zigbee2mqtt (default) atau /config/zigbee2mqtt_usb.
Save → Start atau restart. UI web mungkin belum muncul sampai konfigurasi serial/MQTT benar.

3. `configuration.yaml` Zigbee2MQTT

Lewat File Editor dari App store (atau editor file lain), buka configuration.yaml di folder data_path dan tambahkan minimal:

serial:
  port: /dev/ttyUSB0
  adapter: zstack   # Mulai Zigbee2MQTT 2.0.0 — sesuaikan dengan dokumentasi versi Anda
mqtt:
  base_topic: z2m_usb   # opsional; default zigbee2mqtt

Sesuaikan port dengan perangkat di sistem Anda (mis. /dev/ttyUSB0, /dev/ttyACM0).

Jalankan ulang Zigbee2MQTT dari panel app-nya. Jika Web UI tampil tanpa error berkelanjutan, instalasi dasar selesai.

Judul video: Cara Install Zigbee2MQTT untuk Pemula - Setup Coordinator Zigbee Pertama di Home Assistant 2025 — kanal iothings-io di YouTube.

Catatan: Video ini dibuat akhir tahun 2025. Dari waktu ke waktu tampilan antarmuka Home Assistant, Zigbee2MQTT, dan layanan terkait dapat berbeda dari yang tampil di video maupun dari urutan menu di panduan teks ini.

Daya pancar (transmit power)

Daya pancar CC2652P dapat diatur di Zigbee2MQTT hingga maks. 20 dBm lewat Settings → Advanced (sesuai tampilan Zigbee2MQTT versi Anda).

Pengaturan daya pancar di Zigbee2MQTT (Settings → Advanced)

Pengaturan daya pancar di Zigbee2MQTT

Judul video: Cara Konfigurasi TX Power Zigbee Coordinator & Router di Zigbee2MQTT 2025 - Optimasi Jaringan — kanal iothings-io di YouTube.

Catatan: Judul dan tampilan mengikuti unggahan di YouTube; antarmuka Zigbee2MQTT dapat berbeda di pembaruan berikutnya.

Skematik dan komponen utama

Secara garis besar komponen utama:

RF-BM-2652P2 — modul berbasis TI CC2652P SoC daya rendah.
CH340C — IC USB 2.0 serial.
USBLC6-2SC6 — proteksi ESD (mis. leakage 5,25 V, breakdown 6 V).
UMW AMS1117-3.3 — regulator LDO 3,3 V (SOT-223).

Skema CC2652P USB Stick/Dongle

Firmware

Mode Coordinator di-flash dengan firmware CC1352P2_CC2652P_launchpad_coordinator (Z-Stack 3.x.0), revisi terakhir yang direkomendasikan: 20250321.

Rilis firmware: Z-Stack 3.x.0 coordinator 20250321 (GitHub)
Unduhan langsung (ZIP berisi .hex): CC1352P2_CC2652P_launchpad_coordinator_20250321.zip

Versi firmware lebih lama (mis. 20240710, 20230507) masih tersedia di repositori Koenkk/Z-Stack-firmware (klik menu branch "master" > Tags) bila Anda perlu downgrade atau perbandingan.

Dongle siap dipakai setelah dicolokkan ke USB; disarankan memakai kabel ekstensi USB.

Mengubah atau memperbarui firmware

Agar bisa di-flash lewat serial USB, dongle harus masuk Bootloader mode. Pilih salah satu cara:

Dongle tidak terhubung — tekan dan tahan tombol BSL (mis. jarum SIM), colok USB ke PC, tunggu 2–3 detik, lepas BSL.
Dongle sudah terhubung — tahan RST, tekan BSL dan tahan keduanya 2–3 detik, lepas RST, tunggu 2–3 detik, lalu lepas BSL.

Setelah itu perangkat siap untuk perintah flash.

Alat flash (pilih satu):

ZigStar Multi Tool (Windows) — unduh dari folder Tools di repo ZigStar:
- ZigStarGW-MT-x64.exe.zip — untuk Windows 64-bit (x64);
- ZigStarGW-MT-x86.exe.zip — untuk Windows 32-bit (x86).
Pilih salah satu sesuai arsitektur Windows pada komputer Anda (kebanyakan PC modern memakai x64).

ZigStar GW Multi tool

Setelah aplikasi terpasang dan dongle sudah dalam mode bootloader (lihat langkah di bagian atas halaman ini), lanjutkan flash:
1. Tekan Refresh pada pemilihan port; COM port untuk CC2652P USB Stick/Dongle akan terdeteksi. Pilih port yang benar-benar sesuai dongle Zigbee Anda (bukan perangkat serial lain).
2. Lewat Browse (…), pilih berkas .hex firmware yang tepat: untuk dongle ini Anda harus memakai firmware Coordinator (bukan firmware Router). Pastikan nama berkas / paket unduhan juga cocok untuk CC2652P (lihat bagian Firmware di atas — hindari memilih firmware untuk jenis chip lain).
3. Pastikan opsi Erase, Write, dan Verify dicentang.
4. Tekan Start.
5. Tunggu hingga proses flashing selesai (misalnya bilah progres mencapai selesai / tidak ada error), lalu cabut kabel USB dari dongle.
Flash selesai. Untuk peran Coordinator, ikuti juga bagian bersihkan NVRAM di bawah jika Anda menerapkan langkah tersebut.
SmartRF Flash Programmer 2 — unduhan dari TI (perlu registrasi). SmartRF Flash Programmer 2
Baris perintah (Linux/Windows) — tanpa GUI, pakai Python dan skrip cc2538-bsl:
1. Instal Python — pastikan Python 3 atau lebih baru tersedia di sistem Anda.
2. Periksa versi (pastikan yang dipanggil adalah Python 3):
```
python --version
```
  Di Linux/macOS sering memakai python3 --version dan pip3 menggantikan pip.
3. Instal dependensi:
```
pip install pyserial intelhex
```
  Untuk isolasi paket, pakai venv (virtual environment): sebuah folder terpisah berisi “salinan” Python + pip sendiri, sehingga pyserial dan intelhex tidak tertulis ke instalasi Python sistem (pip install global). Cocok jika Anda tidak ingin berebut versi pustaka dengan proyek lain.
  
  Buat dan aktifkan venv (ringkas):
  - Folder kerja — buka terminal di folder tempat Anda akan menyimpan cc2538-bsl.py (atau folder lain yang Anda mau).
  - Buat lingkungan (membuat subfolder .venv):
```
python3 -m venv .venv
```
    Di Windows, jika python3 tidak dikenali, coba python -m venv .venv atau py -3 -m venv .venv.
  - Aktifkan — setelah berhasil, prompt terminal biasanya diawali (.venv):
    - Linux / macOS: source .venv/bin/activate
    - Windows CMD: .venv\Scripts\activate.bat
    - Windows PowerShell: .\.venv\Scripts\Activate.ps1
      (Jika ditolak kebijakan eksekusi, Anda bisa pakai CMD dengan baris di atas, atau di PowerShell sekali saja: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.)
  - Pasang dependensi (hanya selama venv aktif):
```
pip install pyserial intelhex
```
  - Keluar dari lingkungan kapan saja: deactivate.
  Jika di satu mesin ada beberapa Python dan Anda tidak pakai venv, gunakan python3 -m pip install pyserial intelhex (atau py -m pip install … di Windows) supaya paket terpasang untuk interpreter yang Anda gunakan — tanpa venv, itu bukan isolasi penuh, hanya menghindari pip yang tertaut ke Python lain.
4. Unduh cc2538-bsl.py atau clone repositori dari https://github.com/JelmerT/cc2538-bsl.
5. Perintah flash (jalankan dari folder yang berisi cc2538-bsl.py):
```
python cc2538-bsl.py -p PORT -evw FIRMWARE
```
  - -p — port serial USB yang dipilih (misalnya COM7 di Windows atau /dev/ttyUSB0 di Linux).
  - -evw — erase, write, dan verifikasi firmware (erase, tulis, dan cek).
  - FIRMWARE — path berkas firmware yang akan disimpan ke chip (biasanya berkas .hex coordinator yang Anda unduh).

Setelah flash sebagai Coordinator: bersihkan NVRAM

Hanya untuk peran Coordinator (bukan untuk Router): setelah flashing, disarankan membersihkan NVRAM. Colok ulang dongle tanpa menekan BSL.

ZigStar Multi Tool: pilih COM port yang benar → Erase (NVRAM) → cabut USB.
Command line (dari folder skrip Zigbee2MQTT, sesuaikan path dan port):

cd /opt/zigbee2mqtt/scripts   # atau path instalasi Zigbee2MQTT Anda
node zStackEraseAllNvMem.js /dev/ttyUSB0

Auto-BSL (opsional)

Dengan jumper SJ1 dan SJ2 di-short (sesuai panduan papan), mode AUTO-BSL memungkinkan flash tanpa menekan tombol BSL setiap kali. Jumper SJ1 dan SJ2 untuk mengaktifkan mode AUTO-BSL

Kembali ke halaman utama