Configure device using RM Interface¶

This page guides user to configure reader using Reader Management Interface.

Important

This guide uses Postman Tool for sending API calls to reader.

Import Certificates and Generate Endpoint Configuration¶

Import device Server certificates in the reader web console.
Create Web Socket Endpoint JSON object

Edit Example MQTT endpoint JSON object shown below.

{
    "name": "WS",
    "description": "WS Test",
    "type": "WEBSOCKET",
    "configuration":
    {
        "endpoint":
        {
            "protocol": "ws"
        },
        "additional":
        {
            "batching":
            {
                "maxPayloadSizePerReport": 0,
                "reportingInterval": 0
            },
            "retention":
            {
                "maxEventRetentionTimeInMin": 50,
                "maxNumEvents": 150000,
                "throttle": 500
            }
        },
        "security":{
        	"verifyServerCertificate": false,
        	"verifyServerHostName": false
        }
    }
}

Edit protocol based on the desired connection required.
- ws: for unsecure Websocket connection.
- wss: for secure Websocket connection.

Import Configuration into Reader¶

Download and import postman collections Cloud Connect Enhanced UI.postman_collection.json and Cloud Connect - RM-commands.postman_collection.json.
Create an environment variables protocol (http/https) and reader-ip (10.17.231.7).
Execute Login API.

Important

change username and password field in the body with readers username and password configured.

Goto ADD endpoint (WS) API and replace the JSON object between <motorm:data> </motorm:data> with the MQTT Endpoint JSON object created in Import Certificates and Generate Endpoint Configuration.
- The response 200 OK indicate the endpoint got added successfully.
- Status other than 200 indicate error and response contain the failure reason and check reader syslog to get more info on error.
Create Endpoint Mapping for WS.
- Goto UPDATE endpoint mapping API and edit control, data, event, and management endpoints to the name used in MQTT endpoint JSON object.
Important

Reader is configured to MQTT endpoint for all the interfaces.
- The response 200 OK indicate the endpoint got added successfully.
- Status other than 200 indicate error and response contain the failure reason and check reader syslog to get more info on error.