Node-RED Custom Nodes

Repository layout

Adaptoarele sunt grupate in folderul adapters/, separat de celelalte noduri custom din workspace.

Nodurile care nu sunt adaptoare raman la radacina, de exemplu:

msg-status
presence-detector

In interiorul adapters/, adaptoarele sunt organizate pe tip de device, nu pe model.

Structura standard pentru un device type este:

adapters/<device-type>/homebus-adapter
adapters/<device-type>/homekit-adapter
adapters/<device-type>/energy-adapter atunci cand exista telemetrie energetica dedicata
adapters/<device-type>/models pentru documentatie sau note per model

Exemple curente:

adapters/smart-socket/...
adapters/contact-sensor/...
adapters/water-leak-sensor/...
adapters/smoke-detector/...
adapters/presence-sensor/...

Scopul acestei structuri este sa permitem mai multe modele Zigbee sub acelasi tip de device, fara sa mai multiplicam layout-ul proiectului la nivel de folder radacina.

Deploy targets

SSH target-urile folosite pentru deploy din acest workspace sunt:

testing: node-red@192.168.2.104
production: node-red@192.168.2.101
legacy: pi@192.168.2.133

Verificate prin SSH la data de 2026-03-11.

Service control

Pe testing și production, user-ul node-red poate controla direct serviciul Node-RED, fără sudo:

systemctl restart node-red
systemctl is-active node-red

Numele unității de serviciu este:

node-red.service

Notes

deploy.sh folosește implicit target-ul de testing.
deploy.sh accepta cai relative de forma adapters/device-type/adapter, de exemplu adapters/smart-socket/homebus-adapter.
Pentru hosturile testing și production, user-ul SSH folosit efectiv este node-red.
După deploy pe testing și production, restart-ul standard este systemctl restart node-red.
Hostul legacy rămâne accesat cu user-ul pi.
legacy este în curs de dezafectare.
Nu se face deploy pe legacy decât în situații speciale.

Current verification

Verificat la data de 2026-03-11:

testing 192.168.2.104: restart-ul node-red funcționează direct ca user node-red
production 192.168.2.101: restart-ul node-red funcționează direct ca user node-red
production rulează node-red-contrib-z2m-zg-204zv-homebus@0.0.20

Additional documentation

Documentația detaliată pentru adaptoarele HomeKit și integrarea cu node-red-contrib-homekit-bridged este în:

.doc/homekit-adapter-development-guide.md