Lobaro CoAP

Esta página es una introducción a nuestro gratis Pila de software CoAP denominada "Lobaro-CoAP", que permite crear aplicaciones CoAP en C y otros lenguajes de programación.

Los destinatarios son programadores experimentados con amplios conocimientos del lenguaje de programación "C".

Página del proyecto en Github
Ejemplo de proyecto ESP8266

También ofrecemos integración en otros lenguajes basados en el mismo código C:

Lobaro CoAP Go en Github

Datos breves

pila CoAP "C" fácil de usar
lógica completa de solicitud/respuesta
lógica de reintento completa
respuestas complementarias y separadas
preparado para servidor durmiente
Demostraciones para ESP8266 (IPv4), ZWIR4512 (IPv6)

Términos clave

Código abierto (licencia MIT)
Cliente + Servidor
RFC7252 (CoAP, núcleo)
RFC7641 (Observar)
Transmisión avanzada RFC7641
Traslados en el sentido de las agujas del reloj

Ejemplo sencillo de "CoAP GET

Este recurso devuelve la configuración ip actual como carga útil y se accede a él mediante "GET coap://.../wifi/ipconfig".
[code lang="c"]
#include "../lobaro-coap/coap.h"

CoAP_Res_t* pWifi_ip_Res = NULL;

static CoAP_HandlerResult_t ICACHE_FLASH_ATTR RequestHandler(CoAP_Message_t* pReq, CoAP_Message_t* pResp) {
struct ip_info ipconfig;
char payloadTemp[100];

if(wifi_get_ip_info(STATION_IF, &ipconfig)) {
coap_sprintf(payloadTemp, "Estación: %d.%d.%drn",IP2STR(&ipconfig.ip));
CoAP_SetPayload(pReq, pResp, (uint8_t*)payloadTemp, coap_strlen(payloadTemp), true);
} else {
pResp->Code=RESP_INTERNAL_SERVER_ERROR_5_00;
}

return HANDLER_OK;
}

CoAP_Res_t* Create_Wifi_IPs_Resource() {
CoAP_ResOpts_t Opciones = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_GET };
return (pWifi_ip_Res=CoAP_CreateResource("wifi/ipconfig", "Configuración IP ESP8266",Options, RequestHandler, NULL));
}
[/código]

Ejemplo de recurso observable

Este recurso observable devuelve la hora actual del sistema y se accede a él a través de "GET coap://.../rtc".
[code lang="c"]
#include "../lobaro-coap/coap.h"
#include "rtc_res.h"

CoAP_Res_t* pRTC_Res = NULL;

static CoAP_HandlerResult_t RequestHandler(CoAP_Message_t* pReq, CoAP_Message_t* pResp) {
char miCadena[20];
coap_sprintf(miCadena, "%d [s]", hal_rtc_1Hz_Cnt());
CoAP_SetPayload(pReq, pResp, myString, coap_strlen(myString), true);

return HANDLER_OK;
}

static CoAP_HandlerResult_t NotifyHandler(CoAP_Observer_t* pObserver, CoAP_Message_t* pResp) {
char miCadena[20];
coap_sprintf(miCadena, "%d [s]", hal_rtc_1Hz_Cnt());
CoAP_SetPayload(NULL, pResp, myString, coap_strlen(myString), true);

return HANDLER_OK;
}

//Actualizar Observadores cada segundo
#define DELAY_LOOP 1000 // milisegundos
LOCAL os_timer_t Notificar_timer;

LOCAL void notify_cb(void *arg) {
CoAP_NotifyResourceObservers(pRTC_Res);
}

CoAP_Res_t* Create_RTC_Resource() {
CoAP_ResOpts_t Opciones = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_GET};

/Iniciar temporizador de actualización
os_timer_disarm(&Notify_timer);
os_timer_setfn(&Notify_timer, (os_timer_func_t *)notify_cb, (void *)0);
os_timer_arm(&Notify_timer, DELAY_LOOP, 1);

return (pRTC_Res=CoAP_CreateResource("/rtc", "esp8266 RTC", Options, RequestHandler, NotifyHandler));
}
[/código]

control de recursos mediante uri-query

Este recurso puede cambiar el estado de un led mediante "POST coap://.../esp8266/led_gpio12″.
[code lang="c" highlight="12-17″]
static void SetLedstatePayload(CoAP_Message_t* pReq, CoAP_Message_t* pResp){
if(LedState) CoAP_SetPayload(pReq, pResp, "¡Led está encendido!", coap_strlen("¡Led está encendido!"), true);
else CoAP_SetPayload(pReq, pResp, "¡Led está apagado!", coap_strlen("¡Led está apagado!"), true);
}

static CoAP_HandlerResult_t Res_ReqHandler(CoAP_Message_t* pReq, CoAP_Message_t* pResp) {
if(pReq->Code == REQ_POST) {
CoAP_option_t* pOpt;
bool Encontrado = false;

for(pOpt =pReq->pOptionsList ; pOpt != NULL; pOpt = pOpt->next) {
switch(CoAP_FindUriQueryVal(pOpt,"",3, "on", "off", "tgl")) { // no se utiliza prefijo
caso 0: break; //no encontrado
caso 1: led(true); Found=true; break; //encontrado "on"
caso 2: led(false); Found=true; break; //encontrado "apagado"
caso 3: led(!LedState); Found=true; break; //encontrado "tgl"
}
if(Encontrado) {
SetLedstatePayload(pReq, pResp);
romper;
}
}

if(!Found){
char info[] = {"usage: coap://.../led_gpio12?on (or "off", "tgl")"};
CoAP_SetPayload(pReq, pResp, info, coap_strlen(info), true);
pResp->Code=RESP_ERROR_BAD_REQUEST_4_00;
}

}else if(pReq->Code == REQ_GET){
SetLedstatePayload(pReq, pResp);
}

return HANDLER_OK;
}

static CoAP_HandlerResult_t Res_NotifyHandler(CoAP_Observer_t* pObserver, CoAP_Message_t* pResp) {
SetLedstatePayload(NULL, pResp);
return HANDLER_OK;
}

CoAP_Res_t* Create_Led_Resource() {
CoAP_ResOpts_t Opciones = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_POST | RES_OPT_GET};
return (pLed_Res=CoAP_CreateResource("esp8266/led_gpio12", "LED en GPIO12",Options, Res_ReqHandler, Res_NotifyHandler));
}
[/código]

gran recurso en bloque

Este recurso se transmite a través de múltiples peticiones GET utilizando el protocolo blockwise (draft-ietf-core-block-18)
[code lang="c"]
static const char CoapInfoStringInFlash[] = {"
El protocolo CoAP (Constrained Application Protocol) es un protocolo web especializado.
protocolo de transferencia para su uso con nodos restringidos y
(por ejemplo, redes de baja potencia y con pérdidas). Los nodos suelen tener 8 bits
microcontroladores con pequeñas cantidades de ROM y RAM, mientras que se limita
como IPv6 sobre redes inalámbricas de área personal de baja potencia
(6LoWPANs) a menudo tienen altas tasas de error de paquetes y un típico
rendimiento de decenas de kbit/s. El protocolo está diseñado para máquinas
a máquina (M2M), como la energía inteligente y los edificios.
automatización.rnrn

CoAP proporciona un modelo de interacción solicitud/respuesta entre
de aplicaciones, admite la detección integrada de servicios y
e incluye conceptos clave de la Web, como URIs y
tipos de medios de Internet. CoAP está diseñado para interactuar fácilmente con HTTP
para la integración con la Web, cumpliendo al mismo tiempo requisitos especializados
como el soporte de multidifusión, una sobrecarga muy baja y la simplicidad para
entornos restringidos.
“};

CoAP_Res_t* pAbout_Res = NULL;

static CoAP_HandlerResult_t RequestHandler(CoAP_Message_t* pReq, CoAP_Message_t* pResp) {
static uint16_t payloadSize = sizeof(CoapInfoStringInFlash)-1;

CoAP_SetPayload(pReq, pResp, (uint8_t*)&(CoapInfoStringInFlash[0]), payloadSize, false);

return HANDLER_OK;
}

CoAP_Res_t* Create_About_Resource() {
CoAP_ResOpts_t Opciones = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_GET};
return (pAbout_Res=CoAP_CreateResource("about/coap", "CoAP Description",Options, RequestHandler, NULL));
}
[/código]

Ajuste del reloj RTC mediante consulta URI

Este recurso establece un RTC DS3231 a través de la solicitud CoAP en la fecha 21.2.2016 14:00h

coap://[IP]:5683/ds3231?y=2016&mn=2&d=21&h=14&m=0&s=0

[code lang="c"]
static CoAP_HandlerResult_t Handler(CoAP_Message_t* pReq, CoAP_Message_t* pResp)
{
static char miCadena[100];
static datetime_t datetime;

uint8_t valLen = 0;
uint8_t* pVal = NULL;

drv_DS3231_GetDateTime(&datetime);
if(pReq->Code == REQ_PUT) {
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "d=", &valLen)) && valLen) datetime.w_day = (uint8_t) CoAP_atoi(pVal, valLen);
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "h=", &valLen)) && valLen) datetime.hour = (uint8_t) CoAP_atoi(pVal, valLen);
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "m=", &valLen)) && valLen) datetime.min = (uint8_t) CoAP_atoi(pVal, valLen);
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "s=", &valLen)) && valLen) datetime.sec = (uint8_t) CoAP_atoi(pVal, valLen);
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "mm=", &valLen)) && valLen) datetime.w_month = (uint8_t) CoAP_atoi(pVal, valLen);
if((pVal=CoAP_GetUriQueryValFromMsg(pReq, "y=", &valLen)) && valLen) datetime.w_year = (uint8_t) CoAP_atoi(pVal, valLen);
drv_DS3231_SetDateTime(&datetime);
}

sprintf(myString,”%02d.%02d.20%02d %02d:%02d:%02drn”, datetime.w_day, datetime.w_month, datetime.w_year, datetime.hour, datetime.min, datetime.sec);
CoAP_SetPayload(pReq, pResp, myString, strlen(myString), false);

return HANDLER_OK;
}
[/código]

Lobaro CoAP

Lobaro CoAP

Datos breves

Términos clave

Ejemplo sencillo de "CoAP GET

Ejemplo de recurso observable

control de recursos mediante uri-query

gran recurso en bloque

Ajuste del reloj RTC mediante consulta URI

Ejemplo de proyecto: lobaro.com/lobaro-coap-on-esp8266

Fuente: github.com/Lobaro/lobaro-coap