IAV lumits

ConMon DocumentationConMon Documentation – might seem technical, but it's key to seamless communication in C-ITS! Take a look and stay connected.

Connecting to lumits ConMon

To get access to the MQTT interface (ConMon), you first need to buy a dedicated coupon. Then a download button will appear on your coupons overview.

This download will provide you a zip package containing:

Your X.509 certificate
The corresponding private key
The corresponding public key
Some current RootCA certificates from Amazon
lumitsMqttInformation.json file containing:

After downloading your access credentials, you can setup your own MQTT client (here is an example provided by AWS: https://github.com/aws/aws-iot-device-sdk-python-v2).

To do that, you will need to connect to the domain endpoint (port 8883) using your clientId, certificate and private key. After that you will be able to subscribe and publish to the specified topics below.

MQTT Topics

Please note that all topics include the placeholder "clientId". It should be replaced with your specific clientId. These topics are exclusive for every user.

1. Subscribe topics (communication from AWS to the client)

(1) Topic: "clientId"/reports: The lumits report for a C-ITS message

{
    "timestamp_ms": (integer) Unix timestamp of message,
    "id": (integer) Id of message,
    "report": (string) GZip compressed report-json
    "originalReportSize": (integer) Size of uncompressed report in bytes
}

Explanation

The id and timestamp_ms values are given by the client to the request and can be used to associate a report to a request.
report a JSON, which gets compressed by Gzip for transportation.
originalReportSize is intended for memory allocation when decompressing the report

Example:

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

2. Publish topics (communication from client to AWS)

(1) Topic: "clientId"/startSession: The command to start a session. This will trigger the backend to boot up. It also specifies the desired C-ITS specification

{
    "specification": (string) the C-ITS specification,
    "specVersion": (string) the specVersion of the specification
}

Explanation Allowed combination of values:

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

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

(2) Topic: "clientId"/endSession: The command to end a session. This will trigger the backend to shutdown and prepare for the next session.

{}

Explanation The message itself is empty and is just used as a signal that the user wants to stop a session. If no message is sent, there might be interferences with multiple running sessions in the backend and additional coupon limits might get used.

{}

(3) Topic: "clientId"/keepAlive: The command to notify the backend, that you are still there.

{}

Explanation The message itself is empty and is just used as a signal that the user has not disconnected. By default, if a user does not send a request message in 60min, the backend with shut down. To avoid that you can send a keepAlive.

{}

(4) Topic: "clientId"/requests: The C-ITS message for lumits to analyze.

{
    "id": (integer) sequential id of the request, "timestamp_ms": (integer) timestamp of the message in ms, "msg": (string) base64 encoded C-ITS message
}

Explanation The request containing the C-ITS message to be analyzed. Parameters:

"id" - a sequential id set by the client. It needs to start at 0 and increase by 1 with every message. This allows to keep the correct order, detect issues and match requests to reports.
"timestamp_ms" - a timestamp given by the client. It can also be used for matching requests to reports.
"msg" - The base64 encoded C-ITS message.

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