Zum Inhalt springen

Erste Schritte auf my.runsten.app ​

Runsten gehostet liest Ihr Auto für Sie, einen Volvo, einen Polestar, einen Tesla, einen BMW, MINI oder, in der Beta, einen Hyundai, Kia oder Genesis: kein Server zu betreiben, nichts zu aktualisieren oder zu sichern. Vom Konto bis zu den ersten Fahrten dauert es nur ein paar Minuten.

Ihr Konto ​

Wählen Sie auf my.runsten.app Anmelden oder Konto erstellen und legen Sie ein Konto mit Ihrer E-Mail-Adresse und einem Passwort mit mindestens 12 Zeichen an. Bestätigen Sie die Adresse über die E-Mail, die Sie erhalten, und melden Sie sich dann an.

Runsten bittet Sie dann, die Nutzungsbedingungen zu akzeptieren und die Datenschutzerklärung zu lesen (beide auf Englisch): Akzeptieren und weiter. Ändert sich eines davon, werden Sie erneut gefragt.

Ihr Auto ​

Jede Marke verbindet sich auf ihre eigene Weise, auf der Seite Verbindung im Menü unter Ihrem Namen: ein Volvo mit einem Schlüssel und einer Volvo ID (siehe unten), ein Polestar mit Zugangsdaten aus seinem Data Portal, ein Tesla mit einer Anmeldung bei Tesla und einem virtuellen Schlüssel, ein BMW oder MINI mit einer Client-ID von BMW CarData, ein Hyundai, Kia oder Genesis mit einem Schlüssel aus dem Pleos Playground (Beta). Ein Plug-in-Hybrid wird wie die Elektroautos seiner Marke verbunden; was Runsten davon zeigt: Plug-in-Hybride (auf Englisch).

Ihr Volvo-Schlüssel ​

Volvo gewährt jedem Anwendungsschlüssel ein tägliches Abrufkontingent. Runsten liest Ihr Auto mit einem eigenen Schlüssel: Sein Kontingent gehört Ihnen allein, kein anderes Konto verbraucht es. Sie legen ihn einmal an, auf der Entwicklerseite von Volvo, die jeder mit einer Volvo ID nutzen kann:

  1. Melden Sie sich mit Ihrer Volvo ID im Entwicklerportal von Volvo Cars an.
  2. Legen Sie unter Your API applications eine Anwendung an: Der Name ist beliebig.
  3. Veröffentlichen Sie sie nicht: Sie braucht keine Redirect-URI, keine Nutzungsbedingungen, keine Prüfung.
  4. Kopieren Sie ihren Primary VCC API key.
  5. Öffnen Sie in Runsten Verbindung im Menü unter Ihrem Namen, fügen Sie den Schlüssel in Primary VCC API key ein und klicken Sie auf Schlüssel speichern.

Der Schlüssel wird nie wieder angezeigt, nur seine letzten vier Zeichen. Sein Kontingent, 10.000 Abrufe pro Tag für jede Volvo-API, ist etwa siebenmal so groß, wie ein Auto braucht, das zehn Stunden am Tag fährt.

Ihre Volvo ID ​

Wählen Sie, weiterhin auf der Seite „Verbindung“, Volvo ID verbinden und melden Sie sich auf der Seite von Volvo mit der Volvo ID Ihres Autos an, der aus der Volvo Cars App. Runsten listet ihre Autos auf und liest sie ab seinem nächsten Durchlauf, ein paar Minuten später.

Die Autorisierung von Volvo gilt höchstens 6 Monate. Läuft sie ab, sagt das jede Seite des Autos, mit Volvo ID erneut verbinden: Bereits Gelesenes geht nicht verloren.

Ihr Polestar ​

Ein Polestar braucht weder einen Volvo-Schlüssel noch eine Volvo ID: Runsten liest ihn mit Zugangsdaten, die Sie im Data Portal von Polestar anlegen und dann auf der Seite „Verbindung“ unter Polestar einfügen. Wie Sie sie anlegen und welche fünf Bereiche Sie gewähren: Ihr Polestar (auf Englisch). Sie gelten 90 Tage: Runsten erinnert Sie zwei Wochen vorher.

Das Data Portal bedient nur Autos aus der EU und dem EWR: Runsten gehostet kann einen Polestar anderswo nicht lesen. Eine selbst gehostete Instanz kann es, über die API der Polestar-App (mit der Polestar ID, Beta).

Ihr Tesla ​

Runsten liest einen Tesla über die offizielle Fleet API von Tesla, in Free wie in Plus: in Free einmal pro Stunde, wie die anderen Marken, in Plus während der Fahrt und beim Laden.

Öffnen Sie auf der Seite „Verbindung“ den Tab Tesla und wählen Sie Mit Tesla anmelden: Sie melden sich auf Teslas eigener Seite an, Runsten sieht Ihr Tesla-Passwort nie. Fügen Sie dann jedem Auto den virtuellen Schlüssel von Runsten hinzu: Öffnen Sie den Link, den die Seite angibt, auf dem Smartphone mit der Tesla-App, wählen Sie das Auto und bestätigen Sie im Auto mit der Schlüsselkarte.

Sobald der Schlüssel hinzugefügt ist, stellt Runsten das Auto so ein, dass es seine Daten selbst sendet, sobald sie sich ändern: seine Position etwa alle 10 Sekunden während der Fahrt, seine Ladung, seine Reichweite und so weiter. Solange das Auto schläft, wird nichts gesendet, und Runsten weckt es nur für einen Befehl, den Sie senden (siehe unten). Fahrten und Ladevorgänge werden aus dem Gesendeten erkannt, mit ihrer Route. Für jedes Auto zeigt die Seite, ob sein Schlüssel hinzugefügt ist oder noch fehlt, und „Runsten empfängt, was das Auto sendet“, sobald die Daten ankommen.

Zwei Fälle werden von Runsten gehostet nicht gelesen: ein Model S oder X von vor 2021 und ein Auto mit zu alter Software (nur ein selbst gehostetes Runsten liest sie). Zeigt das Auto an, dass es Drittanbieter-Apps nicht erlaubt, seine Daten zu empfangen, erlauben Sie es im Auto unter Fahrzeug > Sicherheit.

Um aufzuhören, entfernen Sie den Zugriff von Runsten in der Tesla-App (Profil > Sicherheit & Datenschutz > Drittanbieter-Apps) oder entfernen Sie den virtuellen Schlüssel im Auto (Fahrzeug > Verriegelungen). Wenn Sie das Auto oder das Konto in Runsten löschen, werden seine Daten gelöscht.

Seine Steuerung ​

Mit Plus hat die Seite des Autos in Runsten seine Steuerung, für die man die Tesla-App an den meisten Tagen öffnet:

  • Laden: das Ladelimit setzen, von 50 bis 100 %, das Laden starten oder stoppen.
  • Klima: ein- oder ausschalten und die Innenraumtemperatur einstellen, von 15 bis 28 °C.
  • Verriegelung: verriegeln oder entriegeln, jeweils nach einer Bestätigung.

Runsten weckt das Auto für einen Befehl, den Sie senden, sonst nie, und sagt Ihnen, ob das Auto ihn ausgeführt, abgelehnt hat oder nicht erreichbar war; sein Status folgt innerhalb einer Minute. Jeder Befehl und sein Ergebnis werden in Ihrem Konto gespeichert und mit dem Auto gelöscht. Haben Sie sich mit Tesla angemeldet, bevor es die Steuerung gab, bittet die Seite des Autos Sie, sich erneut anzumelden, über die Seite „Verbindung“, mit allen Häkchen gesetzt.

Ihr BMW oder MINI ​

Runsten liest einen BMW oder MINI über BMW CarData, den offiziellen Dienst, den BMW seinen Besitzern kostenlos öffnet, mit Free wie mit Plus.

Sie müssen in Ihrem BMW- oder MINI-Konto Hauptnutzer des Autos sein, und sein ConnectedDrive-Vertrag muss aktiv sein. Dann, einmalig, an einem Computer:

  1. Öffnen Sie im Portal MyBMW oder MyMINI auf der Website Ihres Landes die Kachel BMW CarData und wählen Sie Create CarData Client. Notieren Sie sich die Client-ID sofort: Im Portal ist sie später nur schwer wiederzufinden.
  2. Abonnieren Sie für den Client CarData API und dann, sobald das bestätigt ist, CarData Streaming: Runsten braucht beides.
  3. Haken Sie in der Datenauswahl von CarData Streaming die Datenschlüssel an, die Runsten liest (die Liste, auf Englisch): Ein nicht angehakter Schlüssel wird nie gesendet.
  4. Klicken Sie im Portal nie auf Authenticate device: Das übernimmt Runsten, mit dem Code unten.

Öffnen Sie auf der Seite „Verbindung“ den Tab BMW, fügen Sie die Client-ID ein und wählen Sie Code anfordern. Öffnen Sie über den Link die Seite von BMW, melden Sie sich mit Ihrem BMW- oder MINI-Konto an und bestätigen Sie den Code, den Runsten anzeigt, innerhalb der wenigen Minuten, die er gilt. Lassen Sie die Seite von Runsten geöffnet: Runsten verbindet sich von selbst. Ihr BMW-Passwort sieht Runsten nie. Die Autos, deren Hauptnutzer Sie sind, werden hinzugefügt und von da an gelesen.

Jeder Ladevorgang zeigt dann die aus dem Netz bezogene Energie, Verluste inbegriffen, die keine andere Marke liefert: Runsten liest den Ladeverlauf von BMW einmal am Tag, ein Ladevorgang hat sie also spätestens am Tag nach seinem Ende, und seine Kosten beruhen darauf. Die Ladevorgänge der 30 Tage vor dem Verbinden werden mit übernommen. CarData liefert weder die Außen- noch die Innenraumtemperatur noch die Softwareversion: Runsten kann sie nicht anzeigen.

BMW lässt den Stream eines Autos nur von einer Anwendung zur selben Zeit belegen: Runsten und die CarData-Integration für Home Assistant, evcc oder eine andere App können ihn nicht gemeinsam lesen. Solange eine andere ihn belegt, zeigt die Seite „Verbindung“ Stream von einer anderen Anwendung belegt, und Runsten erhält nur stündliche Werte. Um das Auto auch in Home Assistant zu sehen, nutzen Sie stattdessen die Integration von Runsten.

Um aufzuhören, wählen Sie auf der Seite „Verbindung“ Verbindung entfernen und löschen Sie dann den Client im Portal. Mehr dazu: Ihr BMW oder Mini (auf Englisch).

Ihr Hyundai, Kia oder Genesis (Beta) ​

Runsten liest einen Hyundai, Kia oder Genesis über die Pleos Vehicle Data API, den Zugang, den die Hersteller ihren Besitzern in Europa nach dem EU Data Act öffnen, mit Free wie mit Plus. Die Unterstützung ist in der Beta: Noch kein echtes Fahrzeug wurde gelesen. Schreiben Sie uns also, was Sie sehen, an support@runsten.app.

Sie müssen in Ihrem Bluelink-, Kia Connect- oder Genesis Connected-Konto Hauptnutzer des Autos sein. Dann, einmal pro Marke, an einem Computer:

  1. Registrieren Sie sich im Pleos Playground, öffnen Sie Workspace, dann My Vehicle Data API und den Tab der Marke Ihres Autos.
  2. Haken Sie die beiden Kästchen an, wählen Sie Get API Key und melden Sie sich mit dem Konto Ihres Autos an, als Hauptnutzer.
  3. Kopieren Sie auf der Seite des Schlüssels seine Client ID und sein Client secret.

Öffnen Sie auf der Seite „Verbindung“ den Tab Hyundai · Kia · Genesis, fügen Sie beide unter der Marke Ihres Autos ein und wählen Sie Schlüssel speichern. Runsten fragt nie nach dem Passwort Ihres Bluelink-, Kia Connect- oder Genesis Connected-Kontos. Die Autos, die der Schlüssel liest, werden hinzugefügt und von da an gelesen. Ein Schlüssel liest nur die Autos, die bei seiner Erstellung registriert waren: Legen Sie für ein später hinzugefügtes Auto einen neuen Schlüssel an.

Pleos hält nur einen Zugang zur selben Zeit pro Schlüssel: evcc oder eine Home-Assistant-Integration, die mit demselben Schlüssel liest, nimmt abwechselnd den Platz von Runsten ein, und keine liest gleichmäßig. Um das Auto auch in Home Assistant zu sehen, nutzen Sie stattdessen die Integration von Runsten.

Um aufzuhören, wählen Sie auf der Seite „Verbindung“ Schlüssel entfernen und widerrufen Sie den Schlüssel dann im Playground. Mehr dazu: Ihr Hyundai, Kia oder Genesis (auf Englisch).

Free oder Plus ​

  • Free liest ein Auto jede Stunde und zeigt die letzten 30 Tage; nichts Älteres wird gelöscht. Wenn Sie mehrere Autos verbinden, wählen Sie das von Free gelesene auf der Seite Angebot im Menü unter Ihrem Namen: Die Wahl gilt endgültig.
  • Plus liest bis zu 5 Autos, alle 10 Minuten im Stand und jede Minute während der Fahrt oder beim Laden, und zeigt den gesamten Verlauf, mit den Ladekosten, den CSV-Dateien, der Steuerung eines Teslas, MQTT und KI-Assistenten. Home Assistant funktioniert mit beiden, stündlich mit Free und in Echtzeit mit Plus.
  • Die Beta: Die ersten Autos einer Marke erhalten Plus für 12 Monate, solange ihre Beta offen ist, ohne Karte. Sonst starten neue Konten mit Free und können Plus 14 Tage testen, einmalig, auf der Seite „Angebot“.

Preise und der vollständige Vergleich: Preise.

Wie es weitergeht ​

Was Runsten zeigt, beschreibt die Dokumentation, die für jedes Runsten gleich ist, gehostet oder nicht (auf Englisch):

Etwas funktioniert nicht? Siehe Fehlerbehebung. Ihre Anmeldung, Ihre Daten, Ihr Abonnement: Ihr Konto. Kommen Sie nicht weiter? Schreiben Sie an support@runsten.app.