Lobaro CoAP

Questa pagina è un'introduzione al nostro libero Lo stack software CoAP denominato "Lobaro-CoAP", che consente di creare applicazioni CoAP in C e in altri linguaggi di programmazione.

Il pubblico di riferimento è costituito da programmatori esperti con una buona conoscenza del linguaggio di programmazione "C".

Pagina del progetto su Github
Esempio di progetto ESP8266

Offriamo anche integrazioni in altri linguaggi basati sullo stesso codice C:

Lobaro CoAP Go su Github

Fatti rapidi

stack CoAP "C" facile da usare
logica completa di richiesta/risposta
logica di ripetizione completa
risposte separate e sovrapposte
preparato per il server addormentato
Demo per ESP8266 (IPv4), ZWIR4512 (IPv6)

Termini chiave

OpenSource (licenza MIT)
Cliente + Server
RFC7252 (CoAP, Core)
RFC7641 (Osservare)
Trasmissione avanzata RFC7641
Trasferimenti in senso orario

Semplice esempio di "CoAP GET

Questa risorsa restituisce la configurazione ip corrente come payload ed è accessibile tramite "GET coap://.../wifi/ipconfig".
[code lang="c"]
#includere "../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, "Stazione: %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;
}

restituire HANDLER_OK;
}

CoAP_Res_t* Create_Wifi_IPs_Resource() {
CoAP_ResOpts_t Options = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_GET };
return (pWifi_ip_Res=CoAP_CreateResource("wifi/ipconfig", "ESP8266 IP configuration",Options, RequestHandler, NULL));
}
[/codice]

Esempio di risorsa osservabile

Questa risorsa osservabile restituisce l'ora corrente del sistema ed è accessibile tramite "GET coap://.../rtc".
[code lang="c"]
#includere "../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 myString[20];
coap_sprintf(myString, "%d [s]", hal_rtc_1Hz_Cnt());
CoAP_SetPayload(pReq, pResp, myString, coap_strlen(myString), true);

restituire HANDLER_OK;
}

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

restituire HANDLER_OK;
}

//Aggiornamento degli osservatori ogni secondo
#define DELAY_LOOP 1000 // millisecondi
LOCALE os_timer_t Notify_timer;

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

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

//Avviare il timer di aggiornamento
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));
}
[/codice]

controllo delle risorse tramite uri-query

Questa risorsa può cambiare lo stato di un led tramite "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 is on!", coap_strlen("Led is on!"), true);
altrimenti CoAP_SetPayload(pReq, pResp, "Led is off!", coap_strlen("Led is off!"), 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 Found = false;

for(pOpt =pReq->pOptionsList ; pOpt != NULL; pOpt = pOpt->next) {
switch(CoAP_FindUriQueryVal(pOpt,"",3, "on", "off", "tgl")) { // nessun prefisso utilizzato
caso 0: pausa; //non trovato
caso 1: led(true); Found=true; break; //found "on"
caso 2: led(false); Found=true; break; //trovato "off"
caso 3: led(!LedState); Found=true; break; //trovato "tgl"
}
if(Trovato) {
SetLedstatePayload(pReq, pResp);
pausa;
}
}

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);
}

restituire HANDLER_OK;
}

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

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

grande risorsa a blocchi

Questa risorsa viene trasmessa attraverso più richieste GET utilizzando il protocollo blockwise (draft-ietf-core-block-18).
[code lang="c"]
char statici CoapInfoStringInFlash[] = {"
Il Constrained Application Protocol (CoAP) è un protocollo web specializzato.
protocollo di trasferimento per l'uso con nodi vincolati e nodi vincolati
(ad esempio, reti a bassa potenza e con perdite). I nodi hanno spesso 8 bit
microcontrollori con piccole quantità di ROM e RAM, mentre i vincoli di
come IPv6 su reti personali wireless a bassa potenza.
(6LoWPAN) hanno spesso un alto tasso di errore dei pacchetti e un tipico
di 10 decine di kbit/s. Il protocollo è progettato per le macchine.
applicazioni M2M (to-machine) come quelle per l'energia intelligente e gli edifici.
automazione.rnrn

CoAP fornisce un modello di interazione richiesta/risposta tra
endpoint delle applicazioni, supporta il rilevamento integrato dei servizi e delle
risorse e comprende concetti chiave del Web come URI e
tipi di media Internet. CoAP è stato progettato per interfacciarsi facilmente con HTTP
per l'integrazione con il Web e la soddisfazione di requisiti specifici
come il supporto multicast, l'overhead molto ridotto e la semplicità per
ambienti vincolati.
“};

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);

restituire HANDLER_OK;
}

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

Impostazione dell'orologio RTC tramite interrogazione URI

Questa risorsa imposta un RTC DS3231 tramite richiesta CoAP alla data 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)
{
char statico myString[100];
statico 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);

restituire HANDLER_OK;
}
[/codice]

Lobaro CoAP

Lobaro CoAP

Fatti rapidi

Termini chiave

Semplice esempio di "CoAP GET

Esempio di risorsa osservabile

controllo delle risorse tramite uri-query

grande risorsa a blocchi

Impostazione dell'orologio RTC tramite interrogazione URI

Progetto di esempio: lobaro.com/lobaro-coap-on-esp8266

Fonte: github.com/Lobaro/lobaro-coap