Lobaro CoAP

Deze pagina is een inleiding tot onze gratis CoAP-softwarestack genaamd "Lobaro-CoAP", waarmee u CoAP-toepassingen kunt maken in C en andere programmeertalen.

De doelgroep bestaat uit ervaren programmeurs met een rijke kennis van de programmeertaal "C".

Projectpagina op Github
Voorbeeld ESP8266 Project

Wij bieden ook integratie in andere talen die gebaseerd zijn op dezelfde C-code:

Lobaro CoAP Go op Github

Snelle feiten

eenvoudig te gebruiken "C" CoAP stack
volledige request/response-logica
volledige herhalingslogica
piggybacked & afzonderlijke reacties
klaar voor slapende server
Demo's voor ESP8266 (IPv4), ZWIR4512 (IPv6)

Sleutelbegrippen

Open source (MIT-licentie)
Klant + server
RFC7252 (CoAP, Core)
RFC7641 (Waarnemen)
RFC7641 geavanceerde transmissie
Bloksgewijze overdrachten

Eenvoudig "CoAP GET" voorbeeld

Deze bron retourneert de huidige ip-configuratie als payload en is toegankelijk via "GET coap://.../wifi/ipconfig".
[code lang="c"]
#include "../lobaro-coap/coap.h"

CoAP_Res_t* pWifi_ip_Res = NULL;

statische 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, "Station: %d.%d.%drn",IP2STR(&ipconfig.ip));
CoAP_SetPayload(pReq, pResp, (uint8_t*)payloadTemp, coap_strlen(payloadTemp), true);
} anders {
pResp->Code=RESP_INTERNAL_SERVER_ERROR_5_00;
}

return 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));
}
[/code]

Voorbeeld van een waarneembare bron

Deze waarneembare bron geeft de huidige systeemtijd weer en is toegankelijk via "GET coap://.../rtc".
[code lang="c"]
#include "../lobaro-coap/coap.h"
#include "rtc_res.h"

CoAP_Res_t* pRTC_Res = NULL;

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

return HANDLER_OK;
}

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

return HANDLER_OK;
}

//Update waarnemers elke seconde
#define DELAY_LOOP 1000 // milliseconden
LOCAL 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};

//Start Update timer
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));
}
[/code]

broncontrole via uri-query

Deze bron kan de toestand van een led veranderen via "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 aan!", coap_strlen("Led is aan!"), true);
anders CoAP_SetPayload(pReq, pResp, "Led is uit!", coap_strlen("Led is uit!"), true);
}

statische 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")) { // geen voorvoegsel gebruikt
geval 0: break; //niet gevonden
case 1: led(true); Found=true; break; //found "on".
geval 2: led(false); Found=true; break; //found "off".
case 3: led(!LedState); Gevonden=true; break; //gevonden "tgl"
}
if(Found) {
SetLedstatePayload(pReq, pResp);
pauze;
}
}

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

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

return HANDLER_OK;
}

statische 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 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));
}
[/code]

grote blokvormige bron

Deze bron wordt over meerdere GET-verzoeken verzonden met behulp van het blockwise protocol (draft-ietf-core-block-18)
[code lang="c"]
static const char CoapInfoStringInFlash[] = {"
Het Constrained Application Protocol (CoAP) is een gespecialiseerd web
overdrachtsprotocol voor gebruik met beperkte knooppunten en beperkte
(b.v. netwerken met laag vermogen en verlies). De knooppunten hebben vaak 8-bit
microcontrollers met kleine hoeveelheden ROM en RAM, terwijl de beperking van
netwerken zoals IPv6 over draadloze persoonlijke netwerken met laag vermogen
(6LoWPANs) hebben vaak hoge pakketfoutpercentages en een typische
doorvoer van 10 kbit/s. Het protocol is ontworpen voor machine-
to-machine (M2M) toepassingen zoals slimme energie en gebouw
automatisering.rnrn

CoAP biedt een verzoek/antwoord-interactiemodel tussen
applicatie-eindpunten, ondersteunt ingebouwde ontdekking van diensten en
bronnen, en omvat belangrijke concepten van het web zoals URI's en
Internettypes. CoAP is ontworpen om gemakkelijk te kunnen interfacen met HTTP
voor integratie met het web en tegelijkertijd voldoen aan gespecialiseerde eisen
zoals multicast-ondersteuning, zeer lage overhead en eenvoud voor
beperkte omgevingen.
“};

CoAP_Res_t* pAbout_Res = NULL;

statische CoAP_HandlerResult_t RequestHandler(CoAP_Message_t* pReq, CoAP_Message_t* pResp) {
statische 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 Options = {.Cf = COAP_CF_TEXT_PLAIN, .Flags = RES_OPT_GET};
return (pAbout_Res=CoAP_CreateResource("about/coap", "CoAP Description",Options, RequestHandler, NULL));
}
[/code]

RTC-klok instellen via URI-vraag

Deze bron stelt een DS3231 RTC via CoAP-verzoek in op datum 21.2.2016 14:00h

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

[code lang="c"]
statische CoAP_HandlerResult_t Handler(CoAP_Message_t* pReq, CoAP_Message_t* pResp)
{
statische char myString[100];
statische 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;
}
[/code]

Lobaro CoAP

Lobaro CoAP

Snelle feiten

Sleutelbegrippen

Eenvoudig "CoAP GET" voorbeeld

Voorbeeld van een waarneembare bron

broncontrole via uri-query

grote blokvormige bron

RTC-klok instellen via URI-vraag

Voorbeeldproject: lobaro.com/lobaro-coap-op-esp8266

Bron: github.com/Lobaro/lobaro-coap