Konsep dasar

Identitas: MAC

Setiap Sentinel dikenal lewat MAC Ethernet-nya: huruf kecil tanpa pemisah, misalnya a2cb8ff8768d. Nilai ini muncul di semua topik, di data (id pada SenFlat, bn pada SenML), di LCD (menu Device), dan menjadi Serial device di Celestian. Karena identitas diturunkan dari MAC dasar chip, unit yang sama selalu punya ID yang sama.

Slot

Sensor berbentuk slot dengan ID tetap:

Slot	Isi	Jumlah
t1 … t4	suhu DS18B20, diikat ke sensor lewat ROM ID	4
d1 … d4	input digital (pintu, UPS, air, asap, umum)	4
o1 … o4	output digital	4

ID slot tidak berubah. Yang bisa Anda ganti adalah nama metrik (tN_name, dN_name, oN_name, mis. rack_top), yang menjadi nama data di Celestian, dan label (teks untuk manusia dan LCD). Nama mengikuti fungsi, bukan pin: memindahkan front_door ke slot lain dengan menukar nama tidak memutus deret datanya, sedangkan mengganti nama memulai deret data baru.

Metrik

Tiap nilai yang dikirim adalah metrik dengan nama, misalnya rack_top, voltage, front_door, alarm_level. Sensor yang gagal dibaca tidak dikirim (tidak pernah null atau nilai penanda). Daftar metrik bawaan ada di Metrik. Perangkat Modbus menambah metrik dengan nama awalan_akhiran (mis. rak1_voltage).

Dua mode koneksi

	Mode gateway (bawaan)	Mode langsung
Kredensial di node	tidak ada	mqtt_user dan mqtt_pass (ID dan device key)
Topik di node	sentinel/<mac>/…	m/<workspace>/c/<channel>/<mac>/…
IP broker, NTP, OTA	IP gateway dari DHCP	host broker Celestian
Data saat WAN putus	ditahan gateway di disk	ditahan node di PSRAM (hist_kb), hilang bila reboot

Node otomatis memakai mode gateway tanpa pengaturan. Mode langsung aktif bila workspace dan channel diisi.

Lima jenis pengaturan

Pengaturan dikirim ke node lewat topik berbeda, masing-masing dengan nomor versi sendiri dan laporan baliknya:

Topik	Versi	Isi	Halaman
config	cfg_ver	key datar: koneksi, sensor, alarm, tampilan, target firmware	Konfigurasi
rules	rules_ver	rule di perangkat: kondisi, lalu output, event, atau teks LCD	Rules
sources	sources_ver	sumber metrik Modbus dan pengaturan bus RS-485	Sumber Modbus
profiles	profiles_ver	profil perangkat Modbus (peta register)	Profil Modbus
tgroups	tgroups_ver	kelompok telemetri: seberapa sering tiap kelompok metrik dikirim	Kelompok telemetri

Aturan yang sama berlaku untuk semuanya:

• Pesan dikirim retained (QoS 1) sehingga node yang baru menyala atau tersambung ulang menerima yang terakhir.
• config menerapkan key yang valid dan menolak sisanya dengan alasan; rules, sources, profiles, dan tgroups mengganti seluruh set.
• Node membalas di topik …/reported (retained) berisi apa yang berlaku, versi, dan rejected. Konfigurasi dianggap berlaku bila versi di laporan sama dengan yang dikirim dan rejected kosong.
• Semuanya disimpan di flash node dan bertahan setelah reboot.
• Set bisa dikirim dengan konfirmasi (confirm_s): berjalan sementara, dan kembali sendiri ke set lama bila tidak dikonfirmasi. Ini melindungi dari pengaturan yang membuat node tidak berfungsi.

Perhatian

Karena broker hanya menyimpan satu pesan retained per topik, kirim seluruh set yang Anda kelola dalam satu pesan, bukan sepotong-sepotong. Node pengganti atau node baru hanya menerima potongan terakhir.

Alarm, rules, dan kelompok telemetri

• Alarm bawaan (temp_warn_c, volt_max_v, …) mengurus suhu, listrik, dan input digital yang diberi dN_alarm. Tingkatnya dilaporkan sebagai alarm_level: 0 normal, 1 peringatan, 2 alarm.
• Rules untuk logika tambahan: nyalakan kipas bila suhu tinggi, alarm bila meter Modbus melewati batas, atau jadwal jam kerja.
• Kelompok telemetri mengatur kapan metrik dikirim, agar nilai yang jarang berubah tidak menghabiskan ukuran pesan.