0.前语
CoAP是受限制的运用协议(Constrained Application Protocol)的代名词。在当时由PC机组成的国际,信息交流是经过TCP和运用层协议HTTP完成的。可是关于小型设备而言,完成TCP和HTTP协议显然是一个过火的要求。为了让小设备能够接入互联网,CoAP协议被规划出来。CoAP是一种运用层协议,它运转于UDP协议之上而不是像HTTP那样运转于TCP之上。CoAP协议十分细巧,最小的数据包仅为4字节。
本文将运用STM32渠道完成一个CoAP Server Demo。本文将具体阐明怎么运用STM32这样的低成本MCU完成CoAP Server的过程,本文企图阐明CoAP协议尽管很“年青”,可是有用、好用且易用。
【代码库房】
假如想取得本文的示例代码请点击——【bitbucket】,示例代码中的doc目录有本文所运用开发板的原理图和相关阐明。
【相关博文】
【物联网学习笔记——索引博文】
【CoAP学习笔记——nodeJS node-coap装置和运用(windows渠道)】
1.运用LwIP处理CoAP数据包
新建一个套接字,绑定UDP 5683端口,侦听该端口数据运用microcoap呼应函数解析,最终取得回来成果即可。示例中运用了RT Thread中移植好的LwIP协议栈,网卡驱动为ENC28J60。
- voidcoap_server(void*para)
- {
- intfd;
- structsockaddr_inservaddr,cliaddr;
- coap_rw_buffer_tscratch_buf={scratch_raw,sizeof(scratch_raw)};
- if((fd=socket(AF_INET,SOCK_DGRAM,0))==-1)
- {
- printf(“SocketError\r\n”);
- return;
- }
- servaddr.sin_family=AF_INET;
- servaddr.sin_addr.s_addr=htonl(INADDR_ANY);
- servaddr.sin_port=htons(PORT);
- rt_memset(&(servaddr.sin_zero),0,sizeof(servaddr.sin_zero));
- if((bind(fd,(structsockaddr*)&servaddr,sizeof(servaddr)))==-1)
- {
- printf(“Binderror\r\n”);
- return;
- }
- endpoint_setup();
- rt_kprintf(“CoapServerStart!\r\n”);
- while(1)
- {
- intn,rc;
- socklen_tlen=sizeof(cliaddr);
- coap_packet_tpkt;
- n=recvfrom(fd,buf,sizeof(buf),0,(structsockaddr*)&cliaddr,&len);
- #ifdefMICROCOAP_DEBUG
- printf(“\r\n——————–\r\n”);
- printf(“ReceivedBuffer:\r\n”);
- coap_dump(buf,n,true);
- printf(“\r\n”);
- #endif
- if(0!=(rc=coap_parse(&pkt,buf,n)))
- {
- printf(“Badpacketrc=%d\r\n”,rc);
- }
- else
- {
- size_trsplen=sizeof(buf);
- coap_packet_trsppkt;
- #ifdefMICROCOAP_DEBUG
- printf(“DumpPacket:\r\n”);
- coap_dumpPacket(&pkt);
- #endif
- coap_handle_req(&scratch_buf,&pkt,&rsppkt);
- if(0!=(rc=coap_build(buf,&rsplen,&rsppkt)))
- {
- printf(“coap_buildfailedrc=%d\n”,rc);
- }
- else
- {
- #ifdefMICROCOAP_DEBUG
- printf(“——————–\r\n”);
- printf(“SendingBuffer:\r\n”);
- coap_dump(buf,rsplen,true);
- printf(“\r\n”);
- #endif
- #ifdefMICROCOAP_DEBUG
- coap_dumpPacket(&rsppkt);
- #endif
- sendto(fd,buf,rsplen,0,(structsockaddr*)&cliaddr,sizeof(cliaddr));
- }
- }
- }
- }
代码中运用了多个LwIP Socket部分的函数,例如socket, bind, recvfrom, sendto等。
其间coap_parse函数把从UDP取得的payload转化为契合CoAP标准的结构体,coap_handle_req函数依据CoAP恳求中的URI,调用呼应的处理函数。最终由coap_build函数把处理的成果系列化为UDP负载。
2.终端描绘
一切的终端信息均保存在endpoints大局数组中,该大局数组坐落endpoints.c文件中。
- constcoap_endpoint_tendpoints[]=
- {
- {COAP_METHOD_GET,handle_get_well_known_core,&path_well_known_core,”ct=40″},
- {COAP_METHOD_GET,handle_get_light,&path_light,”ct=0″},
- {COAP_METHOD_PUT,handle_put_light,&path_light,NULL},
- {COAP_METHOD_GET,handle_get_test_json,&path_test_json,”ct=50″},
- {(coap_method_t)0,NULL,NULL,NULL}
- };
【1】每个endpoint需求CoAP拜访办法,相应的处理函数,URI途径描绘,资源描绘办法等。
【2】CoAP协议中界说了多种拜访办法,GET、PUT、POST和DELETE等办法。
【3】handle_get_light等函数首要用于处理CoAP恳求,依据不同的恳求调用不同的处理办法。
【4】ct=xx指定资源描绘办法,例如ct=0表明字符串办法描绘,ct=50表明JSON办法描绘。
URI选用以下办法描绘:
- staticinthandle_get_light(coap_rw_buffer_t*scratch,
- constcoap_packet_t*inpkt,
- coap_packet_t*outpkt,
- uint8_tid_hi,uint8_tid_lo)
- {
- returncoap_make_response(scratch,
- outpkt,
- (constuint8_t*)&light,1,
- id_hi,id_lo,
- &inpkt->tok,
- COAP_RSPCODE_CONTENT,
- COAP_CONTENTTYPE_TEXT_PLAIN);
- }
除了指定回来内容之外,可经过COAP_RSPCODE_CONTENT指定回来是否成功,也能够经过COAP_CONTENTTYPE_TEXT_PLAIN指定回来内容的格局。更多的界说请检查microcoap的源代码。
3.简略测验
可运用CoAP命令行东西测验CoAP Server作业是否正常,或许运用火狐浏览器的coap插件。
运用CoAP命令行测验东西——coap-cli,具体的装置过程请参阅【CoAP学习笔记——nodeJS node-coap装置和运用(windows渠道)】第2部分
3.1 light Demo
输入指令,测验修正light状况
coap put -p 1 coap://10.13.11.116/light
回来
(2.05) 1
阐明
-p参数可用于指定coap的负载,此处1表明翻开light,0表明封闭light。
图3.1 light PUT办法输出
输入指令,测验取得light状况
coap get coap://10.13.11.116/light
回来
(2.05) 1
控制台输出
图3.2 light GET办法输出
3.2 JSON格局Demo
指令
coap get coap://10.13.11.116/test_json
回来
(2.05)
{
“value”: 12
}
控制台输出
图3.3 JSON格局测验输出
4.CoAP格局剖析
经过示例代码并凭借wireshark可剖析CoAP数据包的各个部分,可加上CoAP协议的了解。wireshark中现已支撑CoAP协议,在过滤窗口中输入coap便可抓取一切coap数据包。
CoAP协议的剖析请参阅——【CoAP学习笔记——CoAP格局详解】
图4.1 wireshark剖析CoAP
5. 总结
microcoap正如它的称号相同,简略好用,函数不多可是能够完成最基本的功用。(by xukai871105)