Per inviare messaggi da Tulip (ad esempio tramite trigger o automazioni in-app), è possibile utilizzare un connettore. Il modo più semplice per farlo è installare Connector Host su tutti i dispositivi Tulip Edge.
Con i dispositivi Tulip Edge
Il flusso seguente verrà utilizzato per inviare un messaggio da un trigger Tulip a Node-RED in esecuzione su un dispositivo Tulip Edge:
Una volta completata la configurazione, utilizzare il connettore appena creato in qualsiasi app o automazione Tulip per inviare messaggi a Node-RED, come comandi per i dispositivi o input di flusso.
In Tulip: Configurazione del Connector e del Connector Host
Nota: se non si ha familiarità con gli host dei connettori e la funzione Connettore in Tulip, consultare questo articolo.
- Crea un nuovo connettore dalla pagina " Connettori " nella tua istanza di Tulip.
- Nella finestra modale che appare, inserisci le informazioni come specificato di seguito:
Nome: scegli un nome per il tuoconnettore Descrizione: scegli una descrizione perl’host del connettoreTipo di connettore: seleziona HTTP
- Fai clic su "Salva".
- Per specificare i dettagli dell'host del connettore, fai clic sul pulsante " Produzione, test e sviluppo " a sinistra. Nella finestra modale che appare, inserisci le seguenti informazioni:
In esecuzione su: seleziona l’host del connettore del dispositivo Edge di destinazione. *Nota: se l’host del connettore del dispositivo Edge non viene trovato, accedi al portale del dispositivo Edge e assicurati che l’opzione “Host del connettore” sia stata abilitata.*Host: inserisci localhostPorta: inserisci 1880 (questa è la porta su cui è in esecuzione Node-RED)TLS: inserisci NoNon è necessario aggiungere intestazioni o certificati.
- Fare clic su “Test” e verificare che la connessione sia riuscita. Infine, fare clic su “Salva”.
Questo connettore è ora in grado di comunicare con Node-RED sul dispositivo Edge di destinazione.
In Node-RED: configurazione del nodo HTTP IN
This section assumes familiarity with Node-RED. Learn more here.
Per ricevere il messaggio dall’host del connettore presente sul dispositivo, verrà utilizzato un nodo HTTP IN.
- Fare clic e trascinare per aggiungere un nodo HTTP IN dalla tavolozza sul lato sinistro dell’editor di Node-RED al flusso:
Inserire le seguenti informazioni: Metodo: POST URL: qualsiasi percorso definito dall’utente, ad esempio /nodeRED o /myMachine/0013. Verrà riutilizzato in Node-RED, quindi dovrebbe essere facile da riconoscere e da ricordare.L’esempio riportato di seguito mostra l’URL configurato come /test: 
- Fare clic su "Fatto" per salvare le modifiche.
Le richieste HTTP falliranno se non viene restituita una risposta al server (in questo caso, Tulip). 1. Trascinare un nodo Risposta HTTP. 2. Collegare il nodo Richiesta HTTP al nodo Risposta HTTP. 3. Fare doppio clic sul nodo Risposta HTTP e inserire 200 come codice di stato. Fare clic su "Fatto".
Modify the Status Code and/or use the +add button in the HTTP Response node to modify or add to the Connector's response. These data (most often, system or device outputs generated by the Flow) will appear in the Connector's Response. Configure Connector Outputs with the guide here.
- Infine, trascina un nodo "Debug " dalla tavolozza. Configura questo nodo per generare "Oggetto messaggio completo " utilizzando il menu a tendina "msg.":
Questo flusso Node-RED riceverà ora un messaggio da Tulip e lo visualizzerà nel log di debug di Node-RED.
Un flusso completato potrebbe apparire come mostrato di seguito:
Fare clic su "Deploy" in alto a destra per salvare tutte le modifiche.
In Tulip: configurazione e test della funzione del connettore
Una volta completata la configurazione del flusso Node-RED, tornare al connettore in Tulip. 1. Creare una nuova funzione del connettore. 2. Modificare il metodo della funzione del connettore da GET a POST. 3. Inserire nel campo URL il percorso configurato in Node-RED (in questo esempio, /test). 4. (facoltativo) per aggiungere contenuto al connettore (ad esempio un messaggio o un comando), aggiungi un "Input" al connettore. 5. (facoltativo) Aggiungi l’Input al corpo della richiesta (Request Body) modificando prima il "Content Type" in JSON, quindi aggiungendo un elemento alla radice.
La schermata qui sotto mostra un connettore configurato per l’endpoint /test specificato sopra e include un input denominato testValue:
Fare clic su “Esegui” per testare la funzione del connettore. Si verificheranno due indicatori di successo: 1. La funzione del connettore riceverà una risposta 200 OK, contenente (se applicabile): 1. Eventuali input configurati sul connettore 2. Eventuali output aggiuntivi configurati nel nodo " HTTP Response" di Node-RED. 2. Il registro di debug (Debug Log) in Node-RED visualizzerà il messaggio del connettore. Nota: a seconda della versione corrente di Node-RED, il corpo della richiesta del connettore può essere trovato in: a. msg.payload, oppure b. msg.req.body
Di seguito sono riportati entrambi gli stati di esito positivo:
Operazione del connettore riuscita:
Esito positivo di Node-RED: