All Posts

Node HortiLink adalah control authority utama dalam arsitektur per-site. Node berbasis ESP (baseline ESP32) bertanggung jawab atas pembacaan sensor, eksekusi kontrol aktuator, enforcement interlock keselamatan, serta operasi otonom saat gateway atau server tidak tersedia. Node juga menjalankan routing relay-aware intra-site, menghasilkan telemetry dan health message sesuai HTL-01, serta mengelola buffering lokal, OTA client, dan mekanisme watchdog. Dokumen ini mengunci arsitektur firmware, model kontrol lokal, mekanisme routing, serta strategi recovery agar Node tetap deterministik, aman, dan produksi-grade dalam lingkungan pertanian dengan listrik dan jaringan yang tidak stabil.

Gateway HortiLink adalah bridge intra-site antara domain Node (ESP-NOW relay-aware) dan Server Raspberry Pi (MQTT). Gateway bertindak sebagai ESP-NOW coordinator, validator routing, deduplication engine, store-and-forward buffer, serta distributor time authority. Gateway tidak memiliki otoritas kontrol aktuator dan tidak boleh menggantikan local control engine pada Node. Dokumen ini mengunci arsitektur firmware Gateway, mekanisme validasi pesan, buffering, rate limiting, reconnect strategy, serta health monitoring agar sistem tetap deterministik, terisolasi per-site, dan tahan terhadap kegagalan jaringan atau broker tanpa mengganggu kontrol lokal pada Node.

Site Server HortiLink berbasis Raspberry Pi adalah supervisory layer lokal yang menyediakan MQTT broker, ingestion telemetry, time-series database, command management, configuration registry, OTA repository, serta dashboard dan autentikasi berbasis LAN. Server tidak memiliki otoritas kontrol langsung terhadap aktuator; kontrol kritikal tetap berada di Node. Server harus mampu beroperasi sepenuhnya tanpa internet, mendukung buffering dari Gateway, menjaga integritas data historis, serta menyediakan RBAC dan mekanisme backup yang memadai. Dokumen ini mengunci konfigurasi broker, skema penyimpanan data, manajemen command & konfigurasi, serta strategi reliability dan recovery level server.

HMI HortiLink adalah antarmuka web berbasis LAN yang menyediakan monitoring, command, konfigurasi, OTA, dan alarm untuk satu site. HMI mendukung dua mode - (A) direct-to-node via HTTP untuk commissioning dan diagnostik lokal, serta (B) via server untuk monitoring terpusat, command terkontrol, dan manajemen konfigurasi. HMI menerapkan Role-Based Access Control (Operator, Engineer, Admin) dan tidak memiliki otoritas untuk mengabaikan interlock keselamatan pada Node. Semua command mengikuti state machine HTL-01. Dokumen ini mengunci arsitektur HMI, model role, manual override policy, alarm model, serta mekanisme real-time update dalam batas LAN-only operation.

HTL-06 mendefinisikan integrasi elektrikal antara Node HortiLink dan sistem aktuator fisik seperti pompa, solenoid valve, motor, dan panel daya. Dokumen ini mengunci desain supply power 12–24V ke 5V/3.3V, proteksi arus lebih, isolasi opto, relay/contactors rating, inrush current handling, grounding, serta proteksi terhadap brownout dan noise EMI. Kontrol logika tetap berada pada Node (HTL-02), namun keselamatan sistem harus dijamin melalui interlock fisik dan proteksi listrik independen dari software. HTL-06 memastikan bahwa kegagalan software, reset MCU, atau noise listrik tidak menyebabkan kondisi unsafe pada aktuator.