IAV lumits

ConMon-DokumentationConMon einfach erklärt – klingt technisch, ist aber der Schlüssel für vernetztes Fahren. Hier erfährst du, wie Daten sicher und im Hintergrund kommunizieren.

Verbindung mit lumits ConMon

Um sich mit der lumits MQTT Schnittstelle (ConMon) verbinden zu können, müssen Sie vorerst einen geeigneten Coupon. Dann taucht in Ihrem lumits Bereich ein Download button auf.

Über diesen Button erhalten Sie ein Zip-Archiv mit folgendem Inhalt:

Ein X.509 Zertifikat
Der dazugehörige private key
Der dazugehörige public key
Ein aktuelles RootCA Zertifikat von Amazon
lumitsMqttInformation.json Datei mit:

Nachdem Sie Ihre Zugriffsschlüssel heruntergeladen haben, können Sie Ihren eigenen MQTT client aufsetzen (Ein Beispiel von AWS gibt es unter: https://github.com/aws/aws-iot-device-sdk-python-v2).

Dafür müssen Sie sich mit der angegebenen Domain Adresse mit dem Port 8883 verbinden. Dafür müssen Sie Ihre clientId, Zertifikat und den private key benutzen. Danach können Sie auf den unten beschriebenen Topics publishen und diese abonnieren.

MQTT Topics

Bitten beachten Sie, dass alle Topics den Platzhalter "clientId" beinhalten. Diesen müssen sie mit Ihrer clientId ersetzen, da jedes Topic exklusiv für jeden Nutzer ist.

1. subscribe topics (Kommunikation von AWS zum Client)

(1) Topic: "clientId"/reports: Die lumits Auswertung der C-ITS Nachricht

{
    "timestamp_ms": (integer) Unix timestamp der Nachricht,
    "id": (integer) Id der Nachricht,
    "report": (string) GZip komprimierte Auswetungs-json,
    "originalReportSize": (integer) Größe der unkomprimierten Auswertung in bytes
}

Erklärung:

Die id und timestamp_ms Werte vergibt ein client jeder Nachricht. Diese können benutzt werden um Anfragen mit Antworten zu verknüpfen.
report: Auswertung als JSON, welche mit Gzip komprimiert wurde.
originalReportSize: kann benutzt werden um Speicher für das Entpacken zu reservieren

Beispiel:

{
    "timestamp_ms": 1365808, 
    "id": 609, 
    "report": "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",
    "originalReportSize": 46751
}

2. publish topics (Kommunikation vom Client zu AWS)

(1) Topic: "clientId"/startSession: Der Befehl um eine Session zu starten. Dies startet Ressourcen im Backend und spezifiziert den gewollten ITS-Standard

{
    "specification": (string) die C-ITS Spezification,
    "specVersion": (string) Version der Spezification
}

Erklärung: Erlaubte Wertekombination:

"specification" : "c2ccc"
"specification" : "croads"
"specification" : "ite.cti_4501"

Beispiel:

{
    "specification": "c2ccc",
    "specVersion": "1.6.6"
}

(2) Topic: "clientId"/endSession: Der Befehl zum beenden einer Session. Er löst das herunterfahren der Ressourcen im Backend aus.

{}

Erklärung: Die Nachricht selbst ist leer und wird als Signal benutzt, dass eine Session beendet werden soll. Falls dieses Signal nicht erfolgt, können Interferenzen mit späteren Sessions erfolgen und zusätzliche Couponnutzung abgerechnet werden.

{}

(3) Topic: "clientId"/keepAlive: Der Befehl um dem Backend mitzuteilen, dass man immer noch verbunden ist.

{}

Erklärung: Die Nachricht selbst ist leer und wird als Signal benutzt, dass der Nutzer noch verbunden ist. Standardmäßig wird eine Session beendet, wenn der Nutzer für 60min keine Requests schickt. Um dies zu verhindern, kann man ein keepAlive schicken.

{}

(4) Topic: "clientId"/requests: Die C-ITS Nachricht, die lumits analysieren soll.

{
    "id": (integer) sequenzielle Id der Anfrage,
    "timestamp_ms": (integer) Zeitstenmpel der Nachricht in ms,
    "msg": (string) base64 kodierte C-ITS Nachricht
}

Erklärung:

"id" - eine Sequenzielle Id, die vom client vergeben wird. Sie muss bei 0 starten und sich mit jeder Nachricht um 1 erhöhen. Dadurch kann die korrekte Reihenfolge garantiert werden, fehlende Nachrichten erkannt werden und Auswertungen wieder zugeordnet werden.
"timestamp_ms" - Zeitstempel, der vom client vergeben wird. Er kann auch zur zuordnung von Anfragen und Auswertungen verwendet werden.
"msg" - Die base64 kodierte C-ITS Nachricht.

{
    "id": 609,
    "timestamp_ms": 1365808,
    "msg": "////////EvxOEx6QiUcRAAUBIFACgACTAQAYABL8ThMekHTlwTcfJb9JBltpDYx4CfsAAKAAB9EAAAICXdoY9ME3QGqZVQkuNKdhojwiyBY4LpBYn7CmOpYDCJKDM/8iAFoCP/+UGYAQXgCKgOOYzgAE8A80GOTGcACLgGigqtYzgAO8A0cFV7IAAB3gGsgrLYzgAO8A2UFbTGcAB3gG2groYzgAO8A3kFeDGcAB3gHCgsIYzgAO8A4sFirIAAB3gHLgspYzgAOw"
}