@avdmautomation/node-red-tahoma-local-motor 0.3.0

Node-RED nodes for locally controlling Somfy TaHoma IO and RTS motors with one shared connection and central polling.

npm install @avdmautomation/node-red-tahoma-local-motor

@avdmautomation/node-red-tahoma-local-motor

Node-RED nodes voor lokale aansturing van Somfy TaHoma IO- en RTS-motoren.

Auteur / uitgever

AVDM Automation

Versie 0.3.0

• één gedeelde Local TaHoma Config voor IP-adres, Gateway ID, token en poll-interval;
• één centrale setup/devices poll per configuratie, ongeacht het aantal gekoppelde motornodes;
• motoren gebruiken de volledige deviceURL die TaHoma zelf teruggeeft, dus IO en RTS mogen door elkaar gebruikt worden;
• Gateway ID wordt ingevuld als alleen het gatewaynummer;
• twee feedback-uitgangen: hoofdpositie en lamelpositie;
• aparte reverse-opties voor positie, closure, lamellen en beide feedback-uitgangen;
• Stop en My reageren zodra hun topic binnenkomt, ongeacht een true of false payload;
• commando-antwoorden worden niet naar de feedback-uitgangen gestuurd.

Installeren

Installeer het meegeleverde npm-pakket in de Node-RED gebruikersmap en herstart Node-RED:

cd ~/.node-red
npm install /pad/naar/avdmautomation-node-red-tahoma-local-motor-0.3.0.tgz

Bij Docker kan hetzelfde pakket in de container worden gekopieerd en vanuit /data worden geïnstalleerd.

Publiceren via npm

De npm-pakketnaam is:

@avdmautomation/node-red-tahoma-local-motor

Voor een publieke eerste publicatie:

npm login
npm publish --access public

Configuratie

Maak eerst een Local TaHoma Config aan:

• IP-adres: lokaal IP-adres van de TaHoma;
• Gateway ID: alleen het gatewaynummer, bijvoorbeeld 1234-5678-9012;
• Token: lokale API-token;
• Poll-interval: interval in seconden.

De node bouwt geen io:// of rts:// gateway-URL. Bij apparaatdetectie wordt de volledige deviceURL van TaHoma bewaard en voor opdrachten gebruikt.

Token

Activeer Developer Mode in de Somfy-app door zeven keer op de pincode te drukken. Genereer daarna in Developer Mode de lokale API-token en vul die token in de configuratienode in.

Motornode

Kies in iedere motornode de gedeelde TaHoma-configuratie en daarna de gewenste motor.

Standaardtopics:

Als een topicveld leeg wordt opgeslagen, gebruikt de runtime dezelfde standaardwaarde.

Feedback

• Uitgang 1: motorpositie 0..100 uit core:ClosureState;
• Uitgang 2: lamelpositie 0..100 uit core:SlateOrientationState.

Als een apparaat een feedbackwaarde niet ondersteunt, wordt voor die uitgang geen waarde uitgegeven.

Veiligheid

Het token wordt als Node-RED credential opgeslagen. De voorbeelden bevatten geen privé-IP, gateway-ID, token of motor-ID.

Testen

npm test
npm run check