Lewati ke konten
SentinelDokumentasi Sentinel

Memakai Sentinel di Celestian

Sentinel mengirim datanya ke Celestian. Halaman ini merangkum yang perlu disiapkan di sisi Celestian; langkah rinci tiap menu ada di dokumentasi Celestian.

Urutan

Section titled “Urutan”
  1. Workspace dan channel. Buat workspace dan satu channel untuk data lokasi (route dipakai di topik MQTT dan tidak bisa diubah kemudian).
  2. Device gateway. Buat device untuk Gateway DC dengan Gateway mode, simpan device key-nya (hanya tampil sekali), dan hubungkan ke channel dengan tipe publish dan subscribe.
  3. Isi gateway. Masukkan ID dan key itu ke gateway (Bridge ke Celestian).
  4. Sentinel muncul di Roster. Node yang terhubung ke gateway terdaftar otomatis di tab Roster gateway, dikenali dari MAC.
  5. Daftarkan sebagai device dengan Serial = MAC (huruf kecil, tanpa pemisah).
  6. Rule penyimpanan. Di channel, pasang rule Channel Subscriber → Bypass → Internal DB (SenML); tanpa rule, pesan diterima tetapi tidak disimpan.
  7. Dashboard dan alarm. Buat dashboard dari metrik (rack_top, voltage, …) dan Rule alarm di Celestian bila ingin notifikasi e-mail atau Telegram. Alarm di node (alarm_*) tetap dikirim sebagai event.

Untuk mode langsung (tanpa gateway), device Sentinel sendiri dihubungkan ke channel dengan tipe publish dan subscribe, lalu kredensialnya diisi di node (Jaringan dan mode koneksi).

Mengelola konfigurasi dari Celestian

Section titled “Mengelola konfigurasi dari Celestian”

Menu Setelan Perangkat (detail device) dan Template Setelan mengirim pesan config retained dengan cfg_ver yang naik otomatis, dan menampilkan status tersinkron / menunggu / ditolak sebagian dari config/reported. Beberapa catatan:

  • Key koneksi (workspace, channel, mqtt_*, ntp_server) tidak bisa diubah dari Celestian; atur lewat web atau serial.
  • Celestian hanya menerima key yang ada di katalog model Sentinel; key yang belum ada di katalog ditolak saat menyimpan.
  • Untuk banyak Sentinel serupa, simpan pengaturan bersama (tanpa label, hw, tN_rom, maintenance_until, fw_*) sebagai Template Setelan, lalu terapkan ke device dengan pratinjau dulu.
  • Celestian mengirim ulang konfigurasi dan rules terakhir ke node yang melapor cfg_ver lebih lama. Ingat ini saat memindahkan Sentinel.

Contoh membuat template lewat API dengan Personal Access Token (izin device.configure):

Terminal window
export CELESTIAN=https://<domain>  WS=<workspace>  TOKEN=tpat_<token>
curl -s -X POST "$CELESTIAN/api/v1/workspaces/$WS/device-config-templates" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  --data @sentinel-template.json


# simpan draf setelan device lalu kirim ke node
curl -s -X PUT  "$CELESTIAN/api/v1/workspaces/$WS/devices/{id}/device-config" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" --data @sentinel-device-config.json
curl -s -X POST "$CELESTIAN/api/v1/workspaces/$WS/devices/{id}/device-config/push" \
  -H "Authorization: Bearer $TOKEN"

Berkas contoh Tools/konfigurasi/sentinel-device-config.json dan sentinel-template.json diekspor dari firmware 0.6.0; sesuaikan key dengan versi firmware dan katalog Celestian Anda.

Rules, sumber, dan firmware

Section titled “Rules, sumber, dan firmware”
  • Rules di perangkat, sumber Modbus, dan kelompok telemetri dikirim lewat topik masing-masing; pastikan bridge gateway meneruskannya (Bridge ke Celestian).
  • Firmware OTA bertahap dari Celestian diteruskan lewat server OTA gateway (OTA di gateway). Setelah rollback, node melaporkan fw_rolled_back dan tidak memasang lagi versi yang sama (Firmware dan OTA).