CoAP Protocol Gateway

Open , click the “Modules” tab on the left, and choose to add:

Click “Select”, and then select “CoAP Access Gateway”:

Configure related basic parameters:

Add listening port:

Configure monitoring parameters:

Click “OK” to complete the configuration of the listener, and then click “Add” to complete the creation of the module:

Usage example

libcoap (opens new window) is a very easy-to-use CoAP client library. Here we use it as a CoAP client to test the function of EMQX CoAP access gateway.

PUBLISH example

Use to post a message:

libcoap/examples/coap-client -m put -e 1234 "coap://127.0.0.1/mqtt/topic1?c=client1&u=tom&p=secret"

-The topic name is: “topic1” (not “/topic1”) -Client ID is: “client1” -Username: “tom” -The password is: “secret” -Payload is: “1234”

Use libcoap to subscribe to a topic:

-The topic name is: “topic1” (not “/topic1”) -Client ID is: “client1” -Username: “tom” -The password is: “secret” -Duration of subscription: 10 seconds

During this period, if a message is generated on the topic of , libcoap will receive the message.

Communication interface description

CoAP Client Observe Operation

In the EMQX CoAP access gateway, you can use the Observe operation of CoAP to implement a topic subscription operation:

GET coap://localhost/mqtt/{topicname}?c={clientid}&u={username}&p={password} with OBSERVE=0

-“Mqtt” in the path is required -Replace {topicname}, {clientid}, {username} and {password} with your real values -{topicname} and {clientid} are required -If clientid does not exist, “bad_request” will be returned -{Topicname} in the URI should be percent-encoded to prevent special characters such as + and # -{username} and {password} are optional -If {username} and {password} are incorrect, an uauthorized error will be returned -The subscribed QoS level is always 1

CoAP Client Unobserve Operation

Use the Unobserve operation to unsubscribe the topic:

CoAP Client Notification Operation

The access gateway will receive the message on the subscription topic and deliver it to the CoAP client in the form of Observe-notification:

CoAP Client Publish Operation

Use CoAP’s PUT command to perform a PUBLISH operation:

CoAP Client Keep Alive

The device should periodically issue GET commands as a ping operation to keep the session online

CoAP access gateway does not support POST and DELETE methods.

The subject name in the URI must be URI encoded first (reference: RFC 7252-section 6.4)

ClientId, Username, Password, Topic in CoAP URI are concepts in MQTT. In other words, the CoAP access gateway tries to incorporate CoAP information into the MQTT system by borrowing the concept of nouns in MQTT.

The authentication, access control, hook and other functions of EMQX are also applicable to the CoAP access gateway. such as:

-If the username/password is not authorized, the CoAP client will get an ʻuauthorized` error -If the username/client ID is not allowed to publish a specific topic, the CoAP message will actually be discarded, although the CoAP client will get an Acknoledgement from the access gateway -If a CoAP message is published, the’message.publish’ hook can also capture this message

Well-known locations

The well-known of the CoAP access gateway found constant return “,”

E.g:

CoAP gateway