CoAP

协议介绍

CoAP是一种在物联网世界的类web协议，它的详细规范定义在RFC 7252。COAP名字翻译来就是“受限应用协议”，顾名思义，使用在资源受限的物联网设备上。物联网设备的ram，rom都通常非常小，运行TCP和HTTP是不可以接受的。

 

协议特点

lot设备架构及协议 iot设备协议_lot设备架构及协议

  1. CoAP协议网络传输层由TCP改为UDP。
  2. 它基于REST，server的资源地址和互联网一样也有类似url的格式，客户端同样有POST，GET,PUT,DELETE方法来访问server，对HTTP做了简化。
  3. COAP是二进制格式的，HTTP是文本格式的，COAP比HTTP更加紧凑。
  4. 轻量化，COAP最小长度仅仅4B，一个HTTP的头都几十个B了。
  5. 支持可靠传输，数据重传，块传输。 确保数据可靠到达。
  6. 支持IP多播, 即可以同时向多个设备发送请求。
  7. 非长连接通信，适用于低功耗物联网场景。

客户端库设置

安装

安装node.js,然后执行以下命令:



npm install coap-cli -g



 

用法



Usage: coap [command] [options] url
 
 
   Commands:
 
     get      performs a GET request
     put      performs a PUT request
     post     performs a POST request
     delete   performs a DELETE request
 
   Options:
 
     -h, --help                    output usage information
     -V, --version                 output the version number
     -o, --observe                 Observe the given resource
     -n, --no-new-line             No new line at the end of the stream
     -p, --payload <payload>       The payload for POST and PUT requests
     -b, --block2 <option>         set the block2 size option
     -q, --quiet                   Do not print status codes of received packets
     -c, --non-confirmable         non-confirmable
     -t, --timeout <seconds>       The maximum send time in seconds
     -T, --show-timing             Print request time, handy for simple performance tests
     -O, --coap-option <key,value> Add COAP-Option to the request (repeatable)



 

PUT和POST

PUT和POST请求如下例所示



echo -n 'hello world' | coap post coap://localhost/message



 





 

Thingsboard的CoAP传输协议架构

因为Thingsboard最新release，是基于微服务架构，不利用单独理解代码。

 





CoAP框架

Thingsboard的CoAP设备传输协议是基于Californium。Californium 是一款基于Java实现的Coap技术框架，该项目实现了Coap协议的各种请求响应定义，支持CON/NON不同的可靠性传输模式。Californium 基于分层设计且高度可扩展，其内部模块设计及接口定义存在许多学习之处；

值得一提的是，在同类型的 Coap技术实现中，Californium的性能表现是比较突出的，如下图：

lot设备架构及协议 iot设备协议_javascript_02

更多的数据可以参考Californium-可扩展云服务白皮书本文以框架的源码分析为主，其他内容不做展开。

 

项目结构



.
 └── main
     └── java
         ├── com
         │   └── sanshengshui
         │       └── coap
         │           ├── adaptors
         │           │   └── JsonCoapAdaptor.java
         │           ├── CoapTransportResource.java
         │           ├── common
         │           │   └── FeatureType.java
         │           └── session
         │               └── SessionMsgType.java
         └── IOTCoapServer.java



 

 

代码讲解

IOTCoapServer



1  public class IOTCoapServer {
 2  
 3      private static final String V1 = "v1";
 4      private static final String API = "api";
 5  
 6  
 7      private static String host = "127.0.0.1";
 8      private static Integer port = 5683;
 9      private static long timeout = 10000;
10  
11      public static void main(String[] args) throws UnknownHostException {
12          CoapServer coapServer = new CoapServer();
13          CoapResource api = new CoapResource(API);
14          api.add(new CoapTransportResource(V1,timeout));
15          coapServer.add(api);
16          InetAddress addr = InetAddress.getByName(host);
17          InetSocketAddress sockAddr = new InetSocketAddress(addr, port);
18          coapServer.addEndpoint(new CoapEndpoint(sockAddr));
19          coapServer.start();
20  
21      }
22  
23  }



 

  • 第12行代码: CoapServer用作创建服务端。
  • 第12-15行: CoapResource是resource的基本实现，扩展这个类来编写您自己的资源。通过向资源添加“v1”、"api"和超时时间的设置，则coap的基础url为:coap://localhost:port/api/v1/。
  • 第16-18行: Endpoint负责与网络进行通信, 如果没有一个Endpoint与CoapServer进行绑定，那就创建一个默认的Endpoint，默认就是ucp实现传输层。
  • 第19行，启动CoAP服务。

 

以下图片展示服务端的基础架构:

lot设备架构及协议 iot设备协议_lot设备架构及协议_03





 

CoapTransportResource

此类负责处理请求

GET



 



@Override
     public void handleGET(CoapExchange exchange) {
         Optional<FeatureType> featureType = getFeatureType(exchange.advanced().getRequest());
         if (!featureType.isPresent()) {
         } else if (featureType.get() == FeatureType.TELEMETRY) {
             exchange.respond(CoAP.ResponseCode.BAD_REQUEST);
         }  else if (featureType.get() == FeatureType.ATTRIBUTES) {
             processRequest(exchange, SessionMsgType.GET_ATTRIBUTES_REQUEST);
         } else {
             exchange.respond(CoAP.ResponseCode.BAD_REQUEST);
         }
     }



 

  • 如果我们客户端发起的是GET请求，那么将会进入到handleGET(CoapExchange exchange)方法。
  • getFeatureType(Request request)判断coap协议长度是否大于3。当大于等于3，获取/api/v1/${param}的param元素。
public static final int FEATURE_TYPE_POSITION = 3;
 
 private Optional<FeatureType> getFeatureType(Request request) {
         List<String> uriPath = request.getOptions().getUriPath();
         try {
             if (uriPath.size() >= FEATURE_TYPE_POSITION) {
                 return Optional.of(FeatureType.valueOf(uriPath.get(FEATURE_TYPE_POSITION - 1).toUpperCase()));
             }
         } catch (RuntimeException e) {
         }
         return Optional.empty();
     }



 

  • 通过判断param是否是temperature还是attributes进行相关的逻辑操作。
  • 当不是上述类型，回复状态为BAD_REQUEST的状态码。

 

POST



 



@Override
     public void handlePOST(CoapExchange exchange) {
         Optional<FeatureType> featureType = getFeatureType(exchange.advanced().getRequest());
         if (!featureType.isPresent()) {
             exchange.respond(CoAP.ResponseCode.BAD_REQUEST);
         } else {
             switch (featureType.get()) {
                 case ATTRIBUTES:
                     processRequest(exchange, SessionMsgType.POST_ATTRIBUTES_REQUEST);
                     break;
                 case TELEMETRY:
                     processRequest(exchange, SessionMsgType.POST_TELEMETRY_REQUEST);
                     break;
             }
         }
     }



 

  • 如果我们客户端发起的是POST请求，那么将会进入到handlePOST(CoapExchange exchange)方法。
  • 对获取的uri的类型是temperature还是attributes来做相关的逻辑操作。

 

逻辑处理



 



private void processRequest(CoapExchange exchange, SessionMsgType type) {
         exchange.accept();
         Exchange advanced = exchange.advanced();
         Request request = advanced.getRequest();
 
         try {
             switch (type) {
                 case GET_ATTRIBUTES_REQUEST:
                 case POST_TELEMETRY_REQUEST:
                 case POST_ATTRIBUTES_REQUEST:
                     //这个类在之前的物模型博文中有所讲解，大家可以翻看！
                     JsonCoapAdaptor.convertToMsg(type,request);
                     break;
                 default:
                     throw new IllegalArgumentException("Unsupported msg type: " + type);
             }
             exchange.respond("Data has been received");
         } catch (AdaptorException e){
             exchange.respond(CoAP.ResponseCode.BAD_REQUEST, e.getMessage());
         } catch (IllegalArgumentException  e) {
             exchange.respond(CoAP.ResponseCode.INTERNAL_SERVER_ERROR, e.getMessage());
         }
     }



 





 

项目演示

遥测上传API

要将遥测数据发布到服务器节点，请将POST请求发送到以下URL：



 



coap://host/api/v1/telemetry



 

最简单的支持数据格式是：



 



{"key1":"value1", "key2":"value2"}



 

要么



 



[{"key1":"value1"}, {"key2":"value2"}]



 

请注意，在这种情况下，服务器端时间戳将分配给上传的数据！

如果您的设备能够获取客户端时间戳，您可以使用以下格式：



{"ts":1451649600512, "values":{"key1":"value1", "key2":"value2"}}



 

在上面的示例中，我们假设“1451649600512”是具有毫秒精度的unix时间戳。例如，值'1451649600512'对应于'Fri，2016年1月1日12：00：00.512 GMT'

例子：



echo -n '{"size":21,"type":"device"}' | coap post coap://demo.thingsboard.io/api/v1/telemetry



 



结果:



key= 1564105084015
 属性名=size 属性值=21
 属性名=type 属性值=device



 

属性API

属性API允许设备

  • 将客户端设备属性上载到服务器。
  • 从服务器请求客户端和共享设备属性。
将属性更新发布到服务器

要将客户端设备属性发布到ThingsBoard服务器节点，请将POST请求发送到以下URL：



coap://host/api/v1/attributes



 

例子：



echo -n '{"size":21,"type":"device","status":true}' | coap post coap://localhost:5683/api/v1/attributes



结果：



 



key= 1564105158573
 属性名=size 属性值=21
 属性名=type 属性值=device
 属性名=status 属性值=true



 



从服务器请求属性值

要向ThingsBoard服务器节点请求客户端或共享设备属性，请将GET请求发送到以下URL：



 



coap://host/api/v1/attributes?clientKeys=attribute1,attribute2&sharedKeys=shared1,shared2



例子：



coap get coap://localhost:5683/api/v1/attributes?clientKeys=attribute1,attribute2&sharedKeys=shared1,shared2