Documentation link about device messages is broken

RE: Documentation link about device messages is broken

Markus Tacker (he/him) — Thu, 27 Oct 2022 07:20:38 GMT

The messages interpreted by nRF Cloud are documented here: github.com/.../application-protocols

RE: Documentation link about device messages is broken

Charlie — Mon, 24 Oct 2022 10:45:47 GMT

Hi Matt,

The Supported Schemas are listed here, and you can find a folder application-protocols/schemas/deviceToCloud at v1 · nRFCloud/application-protocols (github.com) which contains the message format and examples for different data types.

You can also refer to sdk-nrf/json_protocol_names_nrf_cloud.h at main · nrfconnect/sdk-nrf · GitHub to understand the data types you can expect from nRF Cloud when you run the Assert Tracker V2 application.

Best regards,

Charlie

RE: Documentation link about device messages is broken

mawh — Mon, 24 Oct 2022 09:50:09 GMT

Thanks Charlie. I was hoping that document would go into some more detail about the structure of messages, but it didn't seem to contain any. Do you ahve any information about what shape of json I might expect to receive when I call ListMessages

For example here is one message I get:

        {
            "topic": "prod/aaa-bbb-ccc-ddd/m/d/nrf-12345678901234567890/d2c",
            "deviceId": "nrf-12345678901234567890",
            "receivedAt": "2001-01-01T01:01:01.001Z",
            "message":
            {
                "data": "29.4",
                "messageType": "DATA",
                "appId": "AIR_QUAL"
            },
            "tenantId": "aaa-bbb-ccc-ddd"
        },


And here is another:

        {
            "topic": "prod/aa-bb-cc-dd/m/d/nrf-123123123123123123/d2c",
            "deviceId": "nrf-123123123123123123123",
            "receivedAt": "2012-12-12T12:12:12.123Z",
            "message":
            {
                "data": "$GPGGA,123123.12,1231.12312,N,12312.312312,W,1,08,1.23,123.12,M,0,,*39\r\n",
                "messageType": "DATA",
                "appId": "GPS"
            },
            "tenantId": "aaa-bbb-ccc-ddd"
        },


At the moment I have to just guess at what data I might get.
Some spec or an OA document that describes it might be helpful?

RE: Documentation link about device messages is broken

Charlie — Mon, 24 Oct 2022 08:58:17 GMT

Hi Matt,

It is available here Device messages | nRF Cloud Docs.

Thanks for reporting this issue, I will inform the document writer for a correction.

Best regards,

Charlie