mozicoder

前言

        CoAP是一种类HTTP协议的物联网专用协议,其数据包为人类不可阅读的字节流形式,在开发相关应用的时候往往不能准确的了解数据包的内容。故需要专用的调试工具对数据和通讯进行调试。这篇文章是为了让开发者更好的了解工具的特性。

CoAP协议介绍

        CoAP(Constrained Application Protocol)受限应用协议,是一种在物联网世界的类web协议,RFC规范定义为RFC7252,7959,8613,8974。该协议使用在资源受限的物联网设备上。物联网设备的RAMROM都通常非常小,不能运行消耗资源比较多的TCP和HTTP。

CoAP调试工具

        工具名称:Mozi.IoT.CoAP

        下载地址:Mozi.Network 发行版 - Gitee.com

        调试地址:coap://coap.me

        调试环境:.Net4

命令行参数说明

    用法:coap command url [options] [body]
         

      command 可选值:get | post | put | delete

      url 格式

        coap://{host}[:{port}]/{path}[?{query}]

      options 请求选项参数如下:

        -time                    监听若干秒,参数值为整数,单位为秒

        -dump                    值为文件路径,将编码好的数据包转储到文件,不发起请求

        -file                    需要上传的文件的路径

        -round                   重复发起请求的次数(最高100次),需-time参数进行配合

        -type                    消息类型,取值

                                    con   --Confirmable

                                    non   --NonConfirmable

                                    ack   --Acknowledgement

                                    rst   --Reset

        -token                   格式:0x0f0e

        -ifmatch                 

        -etag                    

        -ifnonematch             

        -extendedtokenlength     

        -locationpath            

        -contentformat           

        -maxage                  

        -accept                  

        -locationquery           

        -block2                  Block2设置,格式:Num/MoreFlag/Size

        -block1                  Block1设置,格式:Num/MoreFlag/Size

                                 Num:0~1045785,MoreFlag:[0|1],Size:0~1024

        -size2                   

        -proxyuri                

        -proxyscheme             

        -size1  

        
        注:

            1.字符串变量值用""包裹

            2.整型变量值用,直接输入整数即可,如 -size 1024

        body 说明:

            1.0x开始的字符串被识别为HEX字符串并被转为字节流

            2.其它识别为普通字符串同时被编码成字节流,编码方式为UTF-8

            3.带空格的字符串请用""进行包裹"

      示例:

         coap get coap://127.0.0.1:5683/core/time?type=1 -block1 0/0/128

指令解释

-time

值类型:整数

说明:

        此指令指示程序持续监听若干秒,无论服务端是否有响应,程序都不会退出。默认情况下,程序在发起请求时会阻塞30s,直到收到一次服务端响应或超时就会立即结束运行。有时候服务器不会仅仅发送一次响应,而是将包进行分块发送,或服务器响应不时很及时。这两种情况下就需要控制监听的时间。

-dump

值类型:字符串

说明:

        此指令会将请求包以HEX字符串的形式,导出到指定的文件,同时不会发起与服务器的通讯请求。

-file

值类型:字符串

说明:

        设置上传的文件的完整路径,文件会按默认的分块大小进行传输(默认128bit)

-round

值类型:整数

说明:

        设置重复发起请求的次数,为防止工具被用作攻击工具,上限设置为100次

-type

值类型:枚举

说明:

        消息的类型,取值范围如下(忽略大小写):

        Confirmable  |  CON

        NonConfirmable |  NON

        Acknowledgement |  ACK

        Reset |  RST

-token

值类型:二进制

说明:

        请使用HEX字符串的格式设置此值,如0x0f0e

-ifmatch

值类型:字符串

说明:

        请参考HTTP通讯中的if-match

-etag

值类型:字符串

说明:

        请参考HTTP通讯中的etag

-ifnonematch

值类型:字符串

说明:

        请参考HTTP通讯中的if-none-match

-extendedtokenlength

值类型:字符串

说明:

        这个值暂时不要使用,因为最新的规范文档还没有表述的很清楚,待后期实现后会加入

          

-contentformat

值类型:字符串或数字

说明:

        这个参数表示发起的请求内容的格式,用于POST/PUT两种请求方式。如果不设置此参数,则通讯双方默认内容格式为为text/plain,且此参数不会附加到数据包中。

        取值范围如下表:

                "text/plain" | 0 

                "application/link-format" | 40

                "application/xml" | 41

                "application/octet-stream" | 42

                "application/exi" |  47

                "application/json" | 50

                "application/cbor" | 60  

                 

-accept

值类型:字符串或数字

说明:

        表示客户端期望服务器返回的内容的格式类型,参数取值请参看-contentformat。

                 

-block1|block2

值类型:字符串

说明:

        表示期望使用的分块值,格式为{Num}/{MoreFlag}/{Size}例如:1/0/1024。

        Num:表示当前请求的块在整个资源中的序号,取值范围为0-1045785

        MoreFlag:表示是否有更多后序包,取值范围为[0|1]  

        Size:表示分块的大小,取值为2**[4-11],可取值为16,32,64,128,256,512,1024,2048 

    

-size2 | -size1

值类型:无符号整型

说明:

表示整个资源的大小,取值范围为0-2**32,即无符号整型

                  

-proxyuri   

值类型:字符串URI

说明:

表示后端响应请求的代理服务器地址的绝对地址            

-proxyscheme             

   用于重新组装后端服务器的地址,该值仅替换协议头部分。如果-proxyscheme https ,那么请求地址coap://127.0.0.1/core/time 就会变换为https://127.0.0.1/core/time

分类:

技术点:

相关文章: