Per iniziare su my.runsten.app

Runsten in hosting legge la Sua auto per Lei, una Volvo, una Polestar, una Tesla, una BMW, una MINI, oppure, in beta, una Hyundai, una Kia o una Genesis: nessun server da gestire, nulla da aggiornare o di cui fare il backup. Dall’account ai primi viaggi, bastano pochi minuti.

Il Suo account

Su my.runsten.app, selezioni Accedi o crea un account, e ne crei uno con il Suo indirizzo email e una password di almeno 12 caratteri. Confermi l’indirizzo dall’email che riceve, poi acceda.

Runsten Le chiede poi di accettare le sue condizioni d’uso e di leggere la sua informativa sulla privacy (in inglese): Accetta e continua. Quando una di esse cambia, glielo chiede di nuovo.

La Sua auto

Ogni marca si collega a modo suo, nella pagina Collegamento, nel menu sotto il Suo nome: una Volvo con una chiave e un Volvo ID (qui sotto), una Polestar con una credenziale del suo Data Portal, una Tesla con un accesso con Tesla e una chiave virtuale, una BMW o una MINI con un client ID di BMW CarData, una Hyundai, una Kia o una Genesis con una chiave del Pleos Playground (beta). Un ibrido plug-in si collega come le auto elettriche della sua marca; ciò che Runsten ne mostra: plug-in hybrids (in inglese).

La Sua chiave Volvo

Volvo concede a ogni chiave di applicazione una quota giornaliera di chiamate. Runsten legge la Sua auto con una chiave Sua: la quota è solo Sua, nessun altro account la consuma. La crea una sola volta, sul sito di Volvo per sviluppatori, che chiunque abbia un Volvo ID può usare:

1. Acceda con il Suo Volvo ID al portale per sviluppatori di Volvo Cars.
2. In Your API applications, crei un’applicazione: va bene qualsiasi nome.
3. Non la pubblichi: non servono né URI di reindirizzamento, né condizioni, né revisione.
4. Copi la sua Primary VCC API key.
5. In Runsten, apra Collegamento nel menu sotto il Suo nome, incolli la chiave in Primary VCC API key, poi Salva la chiave.

La chiave non viene più mostrata, solo i suoi ultimi quattro caratteri. La sua quota, 10.000 chiamate al giorno per ogni API Volvo, è circa sette volte quanto serve a un’auto guidata dieci ore al giorno.

Il Suo Volvo ID

Sempre nella pagina Collegamento, selezioni Collega un Volvo ID, e acceda alla pagina di Volvo con il Volvo ID della Sua auto, quello dell’app Volvo Cars. Runsten elenca le sue auto e le legge dal suo prossimo passaggio, pochi minuti dopo.

L’autorizzazione di Volvo dura al massimo 6 mesi. Quando scade, ogni pagina dell’auto lo segnala, con Ricollega il Volvo ID: nulla di ciò che è già stato letto va perso.

La Sua Polestar

Una Polestar non ha bisogno né di una chiave Volvo né di un Volvo ID: Runsten la legge con una credenziale che Lei crea sul Data Portal di Polestar, poi incolla nella pagina Collegamento, sotto Polestar. Come crearla, e i cinque domini da concedere: your Polestar (in inglese). Legge per 90 giorni: Runsten glielo ricorda due settimane prima.

Il Data Portal serve solo le auto dell’UE e del SEE: Runsten in hosting non può leggere una Polestar altrove. Un’istanza in self-hosting può farlo, tramite l’API dell’app Polestar (con il Polestar ID, beta, in inglese).

La Sua Tesla

Runsten legge una Tesla tramite la Fleet API ufficiale di Tesla, in Gratis come in Plus: una volta all’ora in Gratis, come le altre marche, e mentre guida e ricarica in Plus.

Nella pagina Collegamento, apra la scheda Tesla e selezioni Accedi con Tesla: accede dalla pagina di Tesla stessa, Runsten non vede mai la Sua password Tesla. Poi aggiunga la chiave virtuale di Runsten a ogni auto: apra il link indicato dalla pagina sul telefono con l’app Tesla, scelga l’auto e confermi nell’auto con la key card.

Una volta aggiunta la chiave, Runsten imposta l’auto perché invii da sola i suoi dati, man mano che cambiano: la posizione circa ogni 10 secondi in marcia, la carica, l’autonomia e così via. Nulla viene inviato mentre l’auto dorme, e Runsten la sveglia solo per un comando che Lei invia (qui sotto). Viaggi e ricariche vengono rilevati da ciò che invia, con il loro percorso. Per ogni auto, la pagina indica se la chiave è stata aggiunta o è ancora da aggiungere, e «Runsten riceve ciò che l’auto invia» quando i dati arrivano.

Due casi non vengono letti da Runsten in hosting: una Model S o X precedente al 2021, e un’auto con un software troppo vecchio (solo un Runsten in self-hosting le legge). Se l’auto indica che non consente alle app di terze parti di ricevere i suoi dati, lo consenta nell’auto, in Comandi > Sicurezza.

Per smettere, rimuova l’accesso di Runsten nell’app Tesla (Profilo > Sicurezza e privacy > App di terze parti), oppure rimuova la chiave virtuale nell’auto (Comandi > Serrature). Eliminare l’auto o l’account in Runsten ne elimina i dati.

I suoi comandi

Con Plus, la pagina dell’auto in Runsten ha i suoi comandi, quelli per cui si apre l’app Tesla quasi ogni giorno:

• Ricarica: imposti il limite di carica, dal 50 al 100 %, avvii o interrompa la ricarica.
• Climatizzazione: la accenda o la spenga, e imposti la temperatura dell’abitacolo, da 15 a 28 °C.
• Serrature: blocchi o sblocchi, ogni volta dopo una conferma.

Runsten sveglia l’auto per un comando che Lei invia, mai altrimenti, e Le dice se l’auto lo ha eseguito, rifiutato, o se non è stata raggiungibile; il suo stato si aggiorna entro un minuto. Ogni comando e il suo esito sono conservati nel Suo account, e se ne vanno con l’auto. Se ha effettuato l’accesso con Tesla prima dell’arrivo dei comandi, la pagina dell’auto Le chiede di accedere di nuovo, dalla pagina Collegamento, lasciando selezionati tutti gli accessi.

La Sua BMW o MINI

Runsten legge una BMW o una MINI tramite BMW CarData, il servizio ufficiale che BMW offre gratuitamente ai proprietari, con Gratis come con Plus.

Deve essere l’utente principale dell’auto nel Suo account BMW o MINI, con il contratto ConnectedDrive attivo. Poi, una volta sola, da un computer:

1. Nel portale MyBMW o MyMINI del sito del Suo Paese, apra BMW CarData e scelga Create CarData Client. Annoti subito il client ID: nel portale non è facile ritrovarlo.
2. Sottoscriva il client a CarData API poi, una volta confermato, a CarData Streaming: a Runsten servono entrambi.
3. Nella selezione dei dati di CarData Streaming, spunti le chiavi che Runsten legge (l’elenco, in inglese): una chiave non spuntata non viene mai inviata.
4. Non faccia mai clic su Authenticate device nel portale: se ne occupa Runsten, con il codice qui sotto.

Nella pagina Collegamento, apra la scheda BMW, incolli il client ID, poi selezioni Ottieni un codice. Apra la pagina di BMW dal link, acceda con il Suo account BMW o MINI e approvi il codice mostrato da Runsten, entro i pochi minuti indicati. Lasci aperta la pagina di Runsten: si collega da sola. Runsten non vede mai la Sua password BMW. Le auto di cui è l’utente principale vengono aggiunte, e lette da quel momento.

Ogni ricarica mostra poi l’energia prelevata dalla rete, perdite comprese, che nessun’altra marca fornisce: Runsten legge la cronologia delle ricariche di BMW una volta al giorno, quindi una ricarica la riceve al più tardi il giorno dopo la sua fine, e il suo costo si basa su questa. Arrivano anche le ricariche dei 30 giorni precedenti al collegamento. CarData non fornisce né la temperatura esterna o dell’abitacolo né la versione del software: Runsten non può mostrarle.

BMW consente a una sola applicazione alla volta di occupare lo stream di un’auto: Runsten e l’integrazione CarData di Home Assistant, evcc o un’altra app non possono leggerlo insieme. Mentre un’altra lo occupa, la pagina Collegamento indica Stream occupato da un’altra applicazione, e Runsten riceve solo i valori orari. Per vedere l’auto anche in Home Assistant, usi piuttosto l’integrazione di Runsten.

Per smettere, selezioni Rimuovi il collegamento nella pagina Collegamento, poi elimini il client nel portale. Per saperne di più: your BMW or Mini (in inglese).

La Sua Hyundai, Kia o Genesis (beta)

Runsten legge una Hyundai, una Kia o una Genesis tramite la Pleos Vehicle Data API, l’accesso che i costruttori aprono ai proprietari in Europa in base al Data Act europeo, con Gratis come con Plus. Il supporto è in beta: nessuna auto reale è ancora stata letta, quindi ci racconti che cosa vede a support@runsten.app.

Deve essere l’utente principale dell’auto nel Suo account Bluelink, Kia Connect o Genesis Connected. Poi, una volta per marca, da un computer:

1. Si registri al Pleos Playground, apra Workspace, poi My Vehicle Data API, e la scheda della marca della Sua auto.
2. Spunti le due caselle, scelga Get API Key e acceda con l’account della Sua auto, come utente principale.
3. Nella pagina della chiave, copi il Client ID e il Client secret.

Nella pagina Collegamento, apra la scheda Hyundai · Kia · Genesis e, sotto la marca della Sua auto, li incolli, poi selezioni Salva la chiave. Runsten non chiede mai la password del Suo account Bluelink, Kia Connect o Genesis Connected. Le auto che la chiave legge vengono aggiunte, e lette da quel momento. Una chiave legge solo le auto registrate quando è stata creata: per un’auto aggiunta dopo, crei una nuova chiave.

Pleos mantiene un solo accesso alla volta per chiave: evcc o un’integrazione di Home Assistant che legge con la stessa chiave prende a turno il posto di Runsten, e nessuno dei due legge con regolarità. Per vedere l’auto anche in Home Assistant, usi piuttosto l’integrazione di Runsten.

Per smettere, selezioni Rimuovi la chiave nella pagina Collegamento, poi revochi la chiave nel Playground. Per saperne di più: your Hyundai, Kia or Genesis (in inglese).

Gratis o Plus

• Gratis legge un’auto ogni ora e mostra gli ultimi 30 giorni; nulla di più vecchio viene eliminato. Se collega più auto, scelga quella che Gratis legge nella pagina Offerta, nel menu sotto il Suo nome: la scelta si fa una volta sola.
• Plus legge fino a 5 auto, ogni 10 minuti in sosta e ogni minuto in marcia o in carica, e mostra l’intera cronologia, con il costo delle ricariche, i file CSV, i comandi di una Tesla, MQTT e gli assistenti IA. Home Assistant funziona con entrambi, ogni ora con Gratis e in tempo reale con Plus.
• La beta: le prime auto di una marca ricevono Plus per 12 mesi finché la sua beta è aperta, senza carta. Altrimenti i nuovi account partono con Gratis, e possono provare Plus per 14 giorni, una sola volta, dalla pagina Offerta.

Prezzi e confronto completo: prezzi.

E poi

Ciò che Runsten mostra è descritto nella documentazione, che è la stessa per ogni Runsten, in hosting o no (in inglese):

• The web interface: lo stato dell’auto, le impostazioni, le preferenze.
• Trips and charges, Statistics, Battery.
• Places, tariffs and costs: quanto è costata ogni ricarica, a casa e altrove.
• Home Assistant, con ogni piano; tramite MQTT (in inglese), con Plus.
• Collegare un assistente IA, con Plus.

Qualcosa non funziona? Veda la risoluzione dei problemi. Il Suo accesso, i Suoi dati, il Suo abbonamento: il Suo account. Ancora bloccato? Scriva a support@runsten.app.