Sviluppo dispositivi di controllo

Per registrarsi come sviluppatore di dispositivi di controllo:

1. Accedi al tuo account Realer.
2. Clicca in alto a destra in qualsiasi pagina di Realer e seleziona Account.
3. Clicca su Registrati come sviluppatore dispositivi di controllo.
   Se sei già registrato come sviluppatore, vedrai Account sviluppatore dispositivi di controllo.
4. Fornisci i dettagli del tuo account sviluppatore es. nome aziendale, logo e sito web.
5. Clicca su Registrati come sviluppatore.

Per procurarti le chiavi API di un dispositivo di controllo:

1. Vai alla pagina del tuo account sviluppatore su Realer.
   È necessario essere registrato come sviluppatore di dispositivi di controllo.
2. Dalla pagina del tuo account sviluppatore, clicca Nuova licenza dispositivo.
3. Scegli il piano di abbonamento per il dispositivo di controllo che vuoi sviluppare e clicca sul pulsante corrispondente con il prezzo.
4. Segui le istruzioni a schermo per effettuare il pagamento.

Dopo il checkout, Realer ti reindirizza alla pagina del dispositivo di controllo contenente le chiavi API generate. Conserva client_id e client_secret in modo sicuro; il firmware le usa all'endpoint token OAuth per ottenere token di accesso per le chiamate API del dispositivo.

Pianifica prima l'integrazione, poi sviluppa il firmware usando la documentazione API di Realer. La documentazione API definisce i contratti esatti di autenticazione OAuth con credenziali client, bootstrap runtime, catalogo, desired-state, feed-data, payload MQTT, campi e codici di risposta.

Usa la guida di pianificazione dell'integrazione per confermare il percorso runtime: polling HTTPS o messaggistica broker MQTT su TLS. Poi usa la pagina introduttiva della documentazione API quando sei pronto per implementare.

Prima di scrivere il firmware, decidi cosa controlla o osserva fisicamente il dispositivo, come si connette a Internet, a quale record dispositivo di controllo Realer appartiene e quale capacità runtime userà.

• Crea o seleziona il record dispositivo di controllo e ottieni le chiavi API per il provisioning del firmware.
• Conferma il percorso runtime assegnato al dispositivo. Un dispositivo usa un solo percorso runtime: polling HTTPS o messaggistica broker MQTT su TLS. Usa la pagina runtime della documentazione API per la suddivisione esatta.
• Pianifica subito la gestione dei token OAuth. Il firmware si autentica come dispositivo tramite credenziali client OAuth, poi legge il descrittore di bootstrap runtime prima del lavoro API protetto.

La guida di pianificazione dell'integrazione copre il percorso decisionale. Usa la pagina introduttiva della documentazione API quando ti servono i riferimenti esatti per implementare.

Progetta il contratto del dispositivo prima di codificare il ciclo firmware. Decidi quali uscite sono comandi, quali ingressi sono sensori, come applicare le richieste desired-state di Realer e quali valori il dispositivo deve riportare.

• Usa il bootstrap runtime all'avvio e la documentazione API del catalogo dispositivo per capire come Realer rappresenta definizioni di comandi e sensori.
• Usa la documentazione API dei feed-data per distinguere report di stato comando e letture sensore.
• Scegli unità di misura e contesti di quantità significativi per i valori numerici.
• Tieni separato il testo dell'interfaccia dagli identificatori firmware: le righe di risorse e dashboard usano etichette di riga, mentre la descrizione di un sensore è un dettaglio UI aggiuntivo. Il firmware dovrebbe usare campi tecnici del catalogo come tipo, contesto della grandezza, unità di misura e pin o porta.

Mantieni la progettazione di comandi, sensori, desired-state e feed-data al livello della guida. Usa semantica dei campi per regole di retry, ordinamento, correlazione, scadenza e gestione dei risultati.

Testa il firmware in un ambiente controllato prima di collegarlo ad apparecchiature reali o esporlo ad altri utenti. Un dispositivo di controllo Realer può influenzare attuatori, sensori e sistemi critici per la sicurezza.

• Tieni le chiavi API fuori da repository pubblici, log, codice lato client e screenshot condivisi.
• Usa hardware isolato, carichi simulati o uscite disabilitate quando validi gestione dei comandi e reporting dei feed-data.
• Verifica il fallback locale per perdita di Internet, credenziali scadute, risposte API rifiutate e disconnessioni broker prima dell'uso in produzione.

Per la base di sicurezza, leggi la responsabilità dello sviluppatore prima dei test live.

Il firmware dovrebbe trattare Realer come un piano di controllo cloud che può essere temporaneamente non disponibile, rifiutare dati non validi o smettere di accettare operazioni cloud quando abbonamento o credenziali non sono più attivi.

• Per risultati HTTPS rifiutati, usa codici di risposta e semantica dei campi per decidere se ritentare, ignorare, riconciliare o entrare in comportamento locale sicuro.
• Per errori di autenticazione, bootstrap e runtime MQTT, rinnova token OAuth e credenziali MQTT a breve durata tramite i flussi documentati in autenticazione e flusso MQTT.
• Per perdita di abbonamento o entitlement, aspettati l'interruzione dell'accesso API cloud e segui la guida sulla fine dell'abbonamento.

La guida sulla gestione degli errori API copre il comportamento del firmware. Usa la documentazione API per contratti esatti di richiesta, payload e risposta.

Il riferimento sulle unità di misura aiuta quando un valore numerico di comando o sensore necessita dell'unità di misura corretta.

Il riferimento sui contesti di quantità aiuta quando un valore numerico necessita del significato fisico o di dominio corretto.