Lobaro CoAP

Tato stránka je úvodem do naší zdarma softwarový stack CoAP s názvem "Lobaro-CoAP", který umožňuje vytvářet aplikace CoAP v jazyce C a dalších programovacích jazycích.

Cílovou skupinou jsou zkušení programátoři s bohatými znalostmi programovacího jazyka "C".

Stránka projektu na Githubu
Příklad projektu ESP8266

Nabízíme také integraci do jiných jazyků, které jsou založeny na stejném kódu jazyka C:

Lobaro CoAP Go na Githubu

Stručná fakta

snadno použitelný zásobník "C" CoAP
kompletní logika požadavku/odpovědi
kompletní logika opakování pokusu
oddělené a samostatné odpovědi
připraven pro spící server
Ukázky pro ESP8266 (IPv4), ZWIR4512 (IPv6)

Klíčové pojmy

OpenSource (licence MIT)
Klient + server
RFC7252 (CoAP, Core)
RFC7641 (Pozorovat)
Pokročilý přenos RFC7641
Blokové převody

Jednoduchý příklad "CoAP GET"

Tento zdroj vrací aktuální konfiguraci ip jako užitečné zatížení a je přístupný prostřednictvím "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, "Station: %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 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]

Příklad pozorovatelného prostředku

Tento sledovatelný prostředek vrací aktuální systémový čas a je přístupný prostřednictvím "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 myString[20];
coap_sprintf(myString, "%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 myString[20];
coap_sprintf(myString, "%d [s]", hal_rtc_1Hz_Cnt());
CoAP_SetPayload(NULL, pResp, myString, coap_strlen(myString), true);

return HANDLER_OK;
}

//Aktualizace pozorovatelů každou sekundu
#define DELAY_LOOP 1000 // milisekundy
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};

/Spustit časovač aktualizace
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]

ovládání prostředků pomocí uri-dotazu

Tento zdroj může měnit stav diody LED prostřednictvím "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);
else CoAP_SetPayload(pReq, pResp, "Led je vypnutá!", coap_strlen("Led je vypnutá!"), 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")) { // nepoužívá se žádný prefix
case 0: break; //nebyl nalezen
case 1: led(true); Found=true; break; //found "on"
case 2: led(false); Found=true; break; //found "off"
case 3: led(!LedState); Found=true; break; //found "tgl"
}
if(Nalezeno) {
SetLedstatePayload(pReq, pResp);
přestávka;
}
}

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

}inak 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 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]

velký blokový zdroj

Tento prostředek se přenáší prostřednictvím více požadavků GET pomocí protokolu blockwise (draft-ietf-core-block-18).
[code lang="c"]
static const char CoapInfoStringInFlash[] = {"
Protokol CoAP (Constrained Application Protocol) je specializovaný webový protokol.
přenosový protokol pro použití s omezenými uzly a omezenými
(např. nízkopříkonové, ztrátové) sítě. Uzly mají často 8bitové
mikrokontroléry s malým množstvím paměti ROM a RAM, zatímco omezené
sítě, jako je IPv6 v bezdrátových osobních sítích s nízkou spotřebou energie.
(6LoWPAN) často vykazují vysokou chybovost paketů a typický
propustnost v řádu desítek kbit/s. Protokol je určen pro strojové
aplikací M2M, jako jsou inteligentní energetika a budovy.
automatizace.rnrn

CoAP poskytuje model interakce požadavek/odpověď mezi
koncové body aplikací, podporuje integrované zjišťování služeb a
a zahrnuje klíčové koncepty webu, jako jsou URI a další.
Typy internetových médií. CoAP je navržen tak, aby se snadno propojil s HTTP
pro integraci s webem při splnění specializovaných požadavků.
jako je podpora vícesměrového vysílání, velmi nízká režie a jednoduchost pro
omezené prostředí.
“};

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

Nastavení hodin RTC dotazem URI

Tento prostředek nastavuje DS3231 RTC prostřednictvím požadavku CoAP na 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"]
static CoAP_HandlerResult_t Handler(CoAP_Message_t* pReq, CoAP_Message_t* pResp)
{
statický znak myString[100];
statický 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

Stručná fakta

Klíčové pojmy

Jednoduchý příklad "CoAP GET"

Příklad pozorovatelného prostředku

ovládání prostředků pomocí uri-dotazu

velký blokový zdroj

Nastavení hodin RTC dotazem URI

Příklad projektu: lobaro.com/lobaro-coap-on-esp8266

Zdroj: github.com/Lobaro/lobaro-coap