Aan de slag met my.runsten.app

Runsten gehost leest uw auto voor u uit, een Volvo, een Polestar, een Tesla, een BMW, een MINI, of in bèta een Hyundai, een Kia of een Genesis: geen server te draaien, niets bij te werken of te back-uppen. Van het account tot de eerste ritten duurt het een paar minuten.

Uw account

Kies op my.runsten.app Aanmelden of een account aanmaken, en maak er een aan met uw e-mailadres en een wachtwoord van 12 tekens of meer. Bevestig het adres via de e-mail die u ontvangt, en meld u daarna aan.

Runsten vraagt u dan de gebruiksvoorwaarden te aanvaarden en het privacybeleid te lezen (beide in het Engels): Aanvaarden en doorgaan. Als een van beide verandert, vraagt het u dat opnieuw.

Uw auto

Elk merk koppelt op zijn eigen manier, op de pagina Koppeling, in het menu onder uw naam: een Volvo met een sleutel en een Volvo ID (hieronder), een Polestar met een credential van het Data Portal, een Tesla met een aanmelding bij Tesla en een virtuele sleutel, een BMW of een MINI met een client ID van BMW CarData, een Hyundai, een Kia of een Genesis met een sleutel uit de Pleos Playground (bèta). Een plug-inhybride koppelt zoals de elektrische auto’s van zijn merk; wat Runsten ervan toont: plug-in hybrids (in het Engels).

Uw Volvo-sleutel

Volvo geeft elke applicatiesleutel een dagelijks quotum van aanroepen. Runsten leest uw auto uit met een eigen sleutel: het quotum is alleen van u, geen ander account verbruikt het. U maakt hem één keer aan, op de site van Volvo voor ontwikkelaars, die iedereen met een Volvo ID kan gebruiken:

1. Meld u aan met uw Volvo ID op het ontwikkelaarsportaal van Volvo Cars.
2. Maak onder Your API applications een applicatie aan: de naam maakt niet uit.
3. Publiceer haar niet: ze heeft geen redirect-URI, geen voorwaarden en geen beoordeling nodig.
4. Kopieer haar primary VCC API key.
5. Open in Runsten Koppeling in het menu onder uw naam, plak de sleutel in Primary VCC API key, en kies daarna Sleutel opslaan.

De sleutel wordt nooit meer getoond, alleen de laatste vier tekens. Het quotum, 10.000 aanroepen per dag voor elke Volvo-API, is ongeveer zeven keer wat een auto nodig heeft die tien uur per dag rijdt.

Uw Volvo ID

Kies, nog steeds op de pagina Koppeling, Een Volvo ID koppelen, en meld u op de pagina van Volvo aan met het Volvo ID van uw auto, dat van de Volvo Cars-app. Runsten vermeldt de auto’s ervan, en leest ze uit vanaf de volgende ronde, een paar minuten later.

De autorisatie van Volvo duurt hoogstens 6 maanden. Als ze afloopt, zegt elke pagina van de auto dat, met Volvo ID opnieuw koppelen: niets van wat al is uitgelezen, gaat verloren.

Uw Polestar

Een Polestar heeft geen Volvo-sleutel en geen Volvo ID nodig: Runsten leest hem uit met een credential die u aanmaakt op het Data Portal van Polestar, en daarna plakt op de pagina Koppeling, onder Polestar. Hoe u die aanmaakt, en welke vijf domeinen u toekent: your Polestar (in het Engels). De credential is 90 dagen geldig: Runsten herinnert u er twee weken vooraf aan.

Het Data Portal bedient alleen de auto’s van de EU en de EER: Runsten gehost kan een Polestar elders niet uitlezen. Een zelf gehoste instantie kan dat wel, via de API van de Polestar-app (met het Polestar ID, bèta).

Uw Tesla

Runsten leest een Tesla uit via de officiële Fleet API van Tesla, in Free net als in Plus: in Free één keer per uur, zoals de andere merken, en in Plus terwijl hij rijdt en laadt.

Open op de pagina Koppeling het tabblad Tesla en kies Aanmelden bij Tesla: u meldt zich aan op de eigen pagina van Tesla, Runsten ziet uw Tesla-wachtwoord nooit. Voeg daarna de virtuele sleutel van Runsten toe aan elke auto: open de link die de pagina geeft op de telefoon met de Tesla-app, kies de auto, en bevestig in de auto met de sleutelkaart.

Zodra de sleutel is toegevoegd, stelt Runsten de auto zo in dat hij zijn gegevens zelf stuurt, wanneer ze veranderen: zijn positie ongeveer elke 10 seconden tijdens het rijden, zijn lading, zijn actieradius, enzovoort. Er wordt niets gestuurd terwijl de auto slaapt, en Runsten wekt hem alleen voor een opdracht die u stuurt (hieronder). Ritten en laadsessies worden gevonden op basis van wat hij stuurt, met hun route. Voor elke auto toont de pagina of de sleutel is toegevoegd of nog moet worden toegevoegd, en ‘Runsten ontvangt wat de auto stuurt.’ zodra de gegevens binnenkomen.

Twee gevallen worden niet uitgelezen door Runsten gehost: een Model S of X van vóór 2021, en een auto met te oude software (alleen een zelf gehoste Runsten leest ze uit). Toont de auto dat hij geen apps van derden zijn gegevens laat ontvangen, sta het dan toe in de auto, onder Bediening > Veiligheid.

Om te stoppen, verwijdert u de toegang van Runsten in de Tesla-app (uw naam > Beveiliging en privacy > Apps van derden), of verwijdert u de virtuele sleutel in de auto (Bediening > Sloten). De auto of het account verwijderen in Runsten verwijdert de gegevens ervan.

De bediening

Met Plus heeft de pagina van de auto in Runsten de bediening waarvoor u de Tesla-app de meeste dagen opent:

• Laden: stel de laadlimiet in, van 50 tot 100%, en start of stop het laden.
• Klimaat: zet het aan of uit, en stel de interieurtemperatuur in, van 15 tot 28 °C.
• Vergrendeling: vergrendel of ontgrendel, elk na een bevestiging.

Runsten wekt de auto voor een opdracht die u stuurt, nooit anders, en zegt u of de auto ze heeft uitgevoerd, geweigerd, of niet bereikbaar was; de status volgt binnen een minuut. Elke opdracht en het resultaat ervan worden in uw account bewaard, en verdwijnen met de auto. Hebt u zich bij Tesla aangemeld voordat de bediening er was, dan vraagt de pagina van de auto u opnieuw aan te melden, vanaf de pagina Koppeling, met alle toegang aangevinkt.

Uw BMW of MINI

Runsten leest een BMW of een MINI uit via BMW CarData, de officiële dienst die BMW gratis openstelt voor eigenaars, met Free net als met Plus.

U moet in uw BMW- of MINI-account de hoofdgebruiker van de auto zijn, en het ConnectedDrive-contract van de auto moet actief zijn. Daarna, één keer, op een computer:

1. Open in het portaal MyBMW of MyMINI op de website van uw land BMW CarData en kies Create CarData Client. Noteer meteen de client ID: het portaal maakt hem niet makkelijk terug te vinden.
2. Abonneer de client op CarData API, en daarna, zodra dat is bevestigd, op CarData Streaming: Runsten heeft ze allebei nodig.
3. Vink in de gegevensselectie van CarData Streaming de sleutels aan die Runsten uitleest (de lijst, in het Engels): een sleutel die niet is aangevinkt, wordt nooit verstuurd.
4. Klik in het portaal nooit op Authenticate device: Runsten doet dat, met de code hieronder.

Open op de pagina Koppeling het tabblad BMW, plak de client ID en kies Code opvragen. Open de pagina van BMW via de link, meld u aan met uw BMW- of MINI-account en keur de code goed die Runsten toont, binnen de paar minuten die het aangeeft. Laat de pagina van Runsten open: het koppelt vanzelf. Runsten ziet uw BMW-wachtwoord nooit. De auto’s waarvan u hoofdgebruiker bent, worden toegevoegd en vanaf dan uitgelezen.

Elke laadsessie toont dan de energie die van het net is gehaald, laadverliezen inbegrepen, wat geen ander merk geeft: Runsten leest de laadgeschiedenis van BMW één keer per dag uit, dus een laadsessie krijgt die uiterlijk de dag nadat ze is afgelopen, en de kosten zijn daarop gebaseerd. De laadsessies van de 30 dagen vóór de koppeling komen mee. CarData geeft geen buiten- of binnentemperatuur en geen softwareversie: Runsten kan ze niet tonen.

BMW laat één toepassing tegelijk de stream van een auto gebruiken: Runsten en de eigen CarData-integratie van Home Assistant, evcc of een andere app kunnen hem niet allemaal uitlezen. Zolang een andere hem bezet, zegt de pagina Koppeling Stream bezet door een andere toepassing, en krijgt Runsten alleen de waarden van elk uur. Wilt u de auto ook in Home Assistant zien, gebruik dan de integratie van Runsten.

Om te stoppen, kiest u Koppeling verwijderen op de pagina Koppeling, en verwijdert u daarna de client in het portaal. Meer: your BMW or Mini (in het Engels).

Uw Hyundai, Kia of Genesis (bèta)

Runsten leest een Hyundai, een Kia of een Genesis uit via de Pleos Vehicle Data API, de toegang die de fabrikanten in Europa onder de Europese Data Act openstellen voor hun eigenaars, met Free net als met Plus. De ondersteuning is in bèta: er is nog geen echte auto uitgelezen, dus laat ons weten wat u ziet via support@runsten.app.

U moet in uw Bluelink-, Kia Connect- of Genesis Connected-account de hoofdgebruiker van de auto zijn. Daarna, één keer per merk, op een computer:

1. Registreer u in de Pleos Playground, open Workspace, dan My Vehicle Data API, en het tabblad van het merk van uw auto.
2. Vink de twee vakjes aan, kies Get API Key en meld u aan met het account van uw auto, als hoofdgebruiker.
3. Kopieer op de pagina van de sleutel de Client ID en het Client secret.

Open op de pagina Koppeling het tabblad Hyundai · Kia · Genesis, plak ze onder het merk van uw auto en kies Sleutel opslaan. Runsten vraagt nooit het wachtwoord van uw Bluelink-, Kia Connect- of Genesis Connected-account. De auto’s die de sleutel uitleest, worden toegevoegd en vanaf dan uitgelezen. Een sleutel leest alleen de auto’s die geregistreerd waren toen hij werd aangemaakt: maak voor een later toegevoegde auto een nieuwe sleutel aan.

Pleos houdt één toegang tegelijk per sleutel: evcc of een Home Assistant-integratie die met dezelfde sleutel leest, neemt om beurten de plaats van Runsten in, en geen van beide leest regelmatig. Wilt u de auto ook in Home Assistant zien, gebruik dan de integratie van Runsten.

Om te stoppen, kiest u Sleutel verwijderen op de pagina Koppeling, en trekt u de sleutel daarna in de Playground in. Meer: your Hyundai, Kia or Genesis (in het Engels).

Free of Plus

• Free leest één auto elk uur uit, en toont de laatste 30 dagen; oudere gegevens worden niet verwijderd. Koppelt u meerdere auto’s, kies dan op de pagina Abonnement, in het menu onder uw naam, welke auto Free uitleest: die keuze maakt u één keer.
• Plus leest tot 5 auto’s uit, elke 10 minuten geparkeerd en elke minuut tijdens het rijden of laden, en toont de volledige geschiedenis, met de laadkosten, de CSV-bestanden, de bediening van een Tesla, MQTT en AI-assistenten. Home Assistant werkt met beide, elk uur met Free en in realtime met Plus.
• De bèta: de eerste auto's van een merk krijgen 12 maanden Plus zolang de bèta van dat merk open is, zonder betaalkaart. Anders beginnen nieuwe accounts met Free, en kunnen ze Plus 14 dagen proberen, één keer, vanaf de pagina Abonnement.

Prijzen en de volledige vergelijking: prijzen.

Daarna

Wat Runsten toont, staat beschreven in de documentatie, die voor elke Runsten dezelfde is, gehost of niet (in het Engels):

• The web interface: de status van de auto, de instellingen, de voorkeuren.
• Trips and charges, Statistics, Battery.
• Places, tariffs and costs: wat elke laadsessie heeft gekost, thuis en elders.
• Home Assistant, met elk abonnement; via MQTT, met Plus.
• Een AI-assistent koppelen, met Plus.

Werkt er iets niet? Zie problemen oplossen. Uw aanmelding, uw gegevens, uw abonnement: uw account. Komt u er nog steeds niet uit? Schrijf naar support@runsten.app.