2013-02-19 16:18:04 +01:00
/*
2013-07-30 17:46:44 +02:00
* Copyright ( c ) 2013 , Matthias Kovatsch
2013-02-19 16:18:04 +01:00
* All rights reserved .
*
* Redistribution and use in source and binary forms , with or without
* modification , are permitted provided that the following conditions
* are met :
* 1. Redistributions of source code must retain the above copyright
* notice , this list of conditions and the following disclaimer .
* 2. Redistributions in binary form must reproduce the above copyright
* notice , this list of conditions and the following disclaimer in the
* documentation and / or other materials provided with the distribution .
* 3. Neither the name of the Institute nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission .
*
* THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ` ` AS IS ' ' AND
* ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING , BUT NOT LIMITED TO , THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED . IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT , INDIRECT , INCIDENTAL , SPECIAL , EXEMPLARY , OR CONSEQUENTIAL
* DAMAGES ( INCLUDING , BUT NOT LIMITED TO , PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES ; LOSS OF USE , DATA , OR PROFITS ; OR BUSINESS INTERRUPTION )
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY , WHETHER IN CONTRACT , STRICT
* LIABILITY , OR TORT ( INCLUDING NEGLIGENCE OR OTHERWISE ) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE , EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE .
*
* This file is part of the Contiki operating system .
*/
/**
* \ file
* Erbium ( Er ) REST Engine example ( with CoAP - specific code )
* \ author
* Matthias Kovatsch < kovatsch @ inf . ethz . ch >
*/
# include <stdio.h>
# include <stdlib.h>
# include <string.h>
# include "contiki.h"
# include "contiki-net.h"
/* Define which resources to include to meet memory constraints. */
2013-07-30 18:45:44 +02:00
# define REST_RES_INFO 1
2013-02-19 16:18:04 +01:00
# define REST_RES_HELLO 0
2013-07-30 18:45:44 +02:00
# define REST_RES_MIRROR 0 /* causes largest code size */
2013-11-19 15:23:52 +01:00
# define REST_RES_CHUNKS 1
2013-07-30 18:45:44 +02:00
# define REST_RES_SEPARATE 0
# define REST_RES_PUSHING 0
2013-04-09 15:28:36 +02:00
# define REST_RES_EVENT 1
2013-07-30 18:45:44 +02:00
# define REST_RES_SUB 0
# define REST_RES_LEDS 1
2013-04-17 13:40:46 +02:00
# define REST_RES_TOGGLE 1
2013-02-19 16:18:04 +01:00
# define REST_RES_LIGHT 0
2013-07-30 18:45:44 +02:00
# define REST_RES_BATTERY 1
2013-02-19 16:18:04 +01:00
# define REST_RES_RADIO 0
# include "erbium.h"
2013-04-17 13:40:46 +02:00
2013-02-19 16:18:04 +01:00
# if defined (PLATFORM_HAS_BUTTON)
# include "dev/button-sensor.h"
# endif
# if defined (PLATFORM_HAS_LEDS)
# include "dev/leds.h"
# endif
# if defined (PLATFORM_HAS_LIGHT)
# include "dev/light-sensor.h"
# endif
# if defined (PLATFORM_HAS_BATTERY)
# include "dev/battery-sensor.h"
# endif
# if defined (PLATFORM_HAS_SHT11)
# include "dev/sht11-sensor.h"
# endif
# if defined (PLATFORM_HAS_RADIO)
# include "dev/radio-sensor.h"
# endif
/* For CoAP-specific example: not required for normal RESTful Web service. */
# if WITH_COAP == 3
# include "er-coap-03.h"
# elif WITH_COAP == 7
# include "er-coap-07.h"
2013-07-30 17:46:44 +02:00
# elif WITH_COAP == 12
# include "er-coap-12.h"
# elif WITH_COAP == 13
# include "er-coap-13.h"
2013-02-19 16:18:04 +01:00
# else
# warning "Erbium example without CoAP-specifc functionality"
# endif /* CoAP-specific example */
# define DEBUG 0
# if DEBUG
# define PRINTF(...) printf(__VA_ARGS__)
# define PRINT6ADDR(addr) PRINTF("[%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x]", ((uint8_t *)addr)[0], ((uint8_t *)addr)[1], ((uint8_t *)addr)[2], ((uint8_t *)addr)[3], ((uint8_t *)addr)[4], ((uint8_t *)addr)[5], ((uint8_t *)addr)[6], ((uint8_t *)addr)[7], ((uint8_t *)addr)[8], ((uint8_t *)addr)[9], ((uint8_t *)addr)[10], ((uint8_t *)addr)[11], ((uint8_t *)addr)[12], ((uint8_t *)addr)[13], ((uint8_t *)addr)[14], ((uint8_t *)addr)[15])
# define PRINTLLADDR(lladdr) PRINTF("[%02x:%02x:%02x:%02x:%02x:%02x]",(lladdr)->addr[0], (lladdr)->addr[1], (lladdr)->addr[2], (lladdr)->addr[3],(lladdr)->addr[4], (lladdr)->addr[5])
# else
# define PRINTF(...)
# define PRINT6ADDR(addr)
# define PRINTLLADDR(addr)
# endif
/******************************************************************************/
# if REST_RES_HELLO
/*
* Resources are defined by the RESOURCE macro .
* Signature : resource name , the RESTful methods it handles , and its URI path ( omitting the leading slash ) .
*/
RESOURCE ( helloworld , METHOD_GET , " hello " , " title= \" Hello world: ?len=0.. \" ;rt= \" Text \" " ) ;
/*
* A handler function named [ resource name ] _handler must be implemented for each RESOURCE .
* A buffer for the response payload is provided through the buffer pointer . Simple resources can ignore
* preferred_size and offset , but must respect the REST_MAX_CHUNK_SIZE limit for the buffer .
* If a smaller block size is requested for CoAP , the REST framework automatically splits the data .
*/
void
helloworld_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
const char * len = NULL ;
/* Some data that has the length up to REST_MAX_CHUNK_SIZE. For more, see the chunk resource. */
char const * const message = " Hello World! ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxy " ;
int length = 12 ; /* |<-------->| */
/* The query string can be retrieved by rest_get_query() or parsed for its key-value pairs. */
if ( REST . get_query_variable ( request , " len " , & len ) ) {
length = atoi ( len ) ;
if ( length < 0 ) length = 0 ;
if ( length > REST_MAX_CHUNK_SIZE ) length = REST_MAX_CHUNK_SIZE ;
memcpy ( buffer , message , length ) ;
} else {
memcpy ( buffer , message , length ) ;
}
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ; /* text/plain is the default, hence this option could be omitted. */
REST . set_header_etag ( response , ( uint8_t * ) & length , 1 ) ;
REST . set_response_payload ( response , buffer , length ) ;
}
# endif
/******************************************************************************/
# if REST_RES_MIRROR
/* This resource mirrors the incoming request. It shows how to access the options and how to set them for the response. */
RESOURCE ( mirror , METHOD_GET | METHOD_POST | METHOD_PUT | METHOD_DELETE , " debug/mirror " , " title= \" Returns your decoded message \" ;rt= \" Debug \" " ) ;
void
mirror_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
/* The ETag and Token is copied to the header. */
uint8_t opaque [ ] = { 0x0A , 0xBC , 0xDE } ;
/* Strings are not copied, so use static string buffers or strings in .text memory (char *str = "string in .text";). */
static char location [ ] = { ' / ' , ' f ' , ' / ' , ' a ' , ' ? ' , ' k ' , ' & ' , ' e ' , 0 } ;
/* Getter for the header option Content-Type. If the option is not set, text/plain is returned by default. */
unsigned int content_type = REST . get_header_content_type ( request ) ;
/* The other getters copy the value (or string/array pointer) to the given pointers and return 1 for success or the length of strings/arrays. */
2013-07-30 17:46:44 +02:00
uint32_t max_age_and_size = 0 ;
2013-02-19 16:18:04 +01:00
const char * str = NULL ;
uint32_t observe = 0 ;
const uint8_t * bytes = NULL ;
uint32_t block_num = 0 ;
uint8_t block_more = 0 ;
uint16_t block_size = 0 ;
const char * query = " " ;
int len = 0 ;
/* Mirror the received header options in the response payload. Unsupported getters (e.g., rest_get_header_observe() with HTTP) will return 0. */
int strpos = 0 ;
/* snprintf() counts the terminating '\0' to the size parameter.
* The additional byte is taken care of by allocating REST_MAX_CHUNK_SIZE + 1 bytes in the REST framework .
2013-07-30 17:46:44 +02:00
* Add + 1 to fill the complete buffer , as the payload does not need a terminating ' \0 ' . */
if ( content_type ! = - 1 )
{
strpos + = snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE + 1 , " CT %u \n " , content_type ) ;
}
2013-02-19 16:18:04 +01:00
/* Some getters such as for ETag or Location are omitted, as these options should not appear in a request.
* Max - Age might appear in HTTP requests or used for special purposes in CoAP . */
2013-07-30 17:46:44 +02:00
if ( strpos < = REST_MAX_CHUNK_SIZE & & REST . get_header_max_age ( request , & max_age_and_size ) )
2013-02-19 16:18:04 +01:00
{
2013-07-30 17:46:44 +02:00
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " MA %lu \n " , max_age_and_size ) ;
}
/* For HTTP this is the Length option, for CoAP it is the Size option. */
if ( strpos < = REST_MAX_CHUNK_SIZE & & REST . get_header_length ( request , & max_age_and_size ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " SZ %lu \n " , max_age_and_size ) ;
2013-02-19 16:18:04 +01:00
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = REST . get_header_host ( request , & str ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " UH %.*s \n " , len , str ) ;
}
/* CoAP-specific example: actions not required for normal RESTful Web service. */
# if WITH_COAP > 1
if ( strpos < = REST_MAX_CHUNK_SIZE & & coap_get_header_observe ( request , & observe ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " Ob %lu \n " , observe ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_token ( request , & bytes ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " To 0x " ) ;
int index = 0 ;
for ( index = 0 ; index < len ; + + index ) {
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " %02X " , bytes [ index ] ) ;
}
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " \n " ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_etag ( request , & bytes ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " ET 0x " ) ;
int index = 0 ;
for ( index = 0 ; index < len ; + + index ) {
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " %02X " , bytes [ index ] ) ;
}
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " \n " ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_uri_path ( request , & str ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " UP " ) ;
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " %.*s \n " , len , str ) ;
}
# if WITH_COAP == 3
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_location ( request , & str ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " Lo %.*s \n " , len , str ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & coap_get_header_block ( request , & block_num , & block_more , & block_size , NULL ) ) /* This getter allows NULL pointers to get only a subset of the block parameters. */
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " Bl %lu%s (%u) \n " , block_num , block_more ? " + " : " " , block_size ) ;
}
# else
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_location_path ( request , & str ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " LP %.*s \n " , len , str ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = coap_get_header_location_query ( request , & str ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " LQ %.*s \n " , len , str ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & coap_get_header_block2 ( request , & block_num , & block_more , & block_size , NULL ) ) /* This getter allows NULL pointers to get only a subset of the block parameters. */
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " B2 %lu%s (%u) \n " , block_num , block_more ? " + " : " " , block_size ) ;
}
/*
* Critical Block1 option is currently rejected by engine .
*
if ( strpos < = REST_MAX_CHUNK_SIZE & & coap_get_header_block1 ( request , & block_num , & block_more , & block_size , NULL ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " B1 %lu%s (%u) \n " , block_num , block_more ? " + " : " " , block_size ) ;
}
*/
# endif /* CoAP > 03 */
# endif /* CoAP-specific example */
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = REST . get_query ( request , & query ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " Qu %.*s \n " , len , query ) ;
}
if ( strpos < = REST_MAX_CHUNK_SIZE & & ( len = REST . get_request_payload ( request , & bytes ) ) )
{
strpos + = snprintf ( ( char * ) buffer + strpos , REST_MAX_CHUNK_SIZE - strpos + 1 , " %.*s " , len , bytes ) ;
}
if ( strpos > = REST_MAX_CHUNK_SIZE )
{
buffer [ REST_MAX_CHUNK_SIZE - 1 ] = 0xBB ; /* '»' to indicate truncation */
}
REST . set_response_payload ( response , buffer , strpos ) ;
PRINTF ( " /mirror options received: %s \n " , buffer ) ;
/* Set dummy header options for response. Like getters, some setters are not implemented for HTTP and have no effect. */
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
2013-07-30 17:46:44 +02:00
REST . set_header_max_age ( response , 17 ) ; /* For HTTP, browsers will not re-request the page for 17 seconds. */
2013-02-19 16:18:04 +01:00
REST . set_header_etag ( response , opaque , 2 ) ;
REST . set_header_location ( response , location ) ; /* Initial slash is omitted by framework */
2013-07-30 17:46:44 +02:00
REST . set_header_length ( response , strpos ) ; /* For HTTP, browsers will not re-request the page for 10 seconds. CoAP action depends on the client. */
2013-02-19 16:18:04 +01:00
/* CoAP-specific example: actions not required for normal RESTful Web service. */
# if WITH_COAP > 1
coap_set_header_uri_host ( response , " tiki " ) ;
coap_set_header_observe ( response , 10 ) ;
# if WITH_COAP == 3
coap_set_header_block ( response , 42 , 0 , 64 ) ; /* The block option might be overwritten by the framework when blockwise transfer is requested. */
# else
coap_set_header_proxy_uri ( response , " ftp://x " ) ;
coap_set_header_block2 ( response , 42 , 0 , 64 ) ; /* The block option might be overwritten by the framework when blockwise transfer is requested. */
coap_set_header_block1 ( response , 23 , 0 , 16 ) ;
coap_set_header_accept ( response , TEXT_PLAIN ) ;
coap_set_header_if_none_match ( response ) ;
# endif /* CoAP > 03 */
# endif /* CoAP-specific example */
}
# endif /* REST_RES_MIRROR */
/******************************************************************************/
# if REST_RES_CHUNKS
/*
* For data larger than REST_MAX_CHUNK_SIZE ( e . g . , stored in flash ) resources must be aware of the buffer limitation
* and split their responses by themselves . To transfer the complete resource through a TCP stream or CoAP ' s blockwise transfer ,
* the byte offset where to continue is provided to the handler as int32_t pointer .
* These chunk - wise resources must set the offset value to its new position or - 1 of the end is reached .
* ( The offset for CoAP ' s blockwise transfer can go up to 2 ' 147 ' 481 ' 600 = ~ 2047 M for block size 2048 ( reduced to 1024 in observe - 03. )
*/
RESOURCE ( chunks , METHOD_GET , " test/chunks " , " title= \" Blockwise demo \" ;rt= \" Data \" " ) ;
# define CHUNKS_TOTAL 2050
void
chunks_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
int32_t strpos = 0 ;
/* Check the offset for boundaries of the resource data. */
if ( * offset > = CHUNKS_TOTAL )
{
REST . set_response_status ( response , REST . status . BAD_OPTION ) ;
/* A block error message should not exceed the minimum block size (16). */
const char * error_msg = " BlockOutOfScope " ;
REST . set_response_payload ( response , error_msg , strlen ( error_msg ) ) ;
return ;
}
/* Generate data until reaching CHUNKS_TOTAL. */
while ( strpos < preferred_size )
{
strpos + = snprintf ( ( char * ) buffer + strpos , preferred_size - strpos + 1 , " |%ld| " , * offset ) ;
}
/* snprintf() does not adjust return value if truncated by size. */
if ( strpos > preferred_size )
{
strpos = preferred_size ;
}
/* Truncate if above CHUNKS_TOTAL bytes. */
if ( * offset + ( int32_t ) strpos > CHUNKS_TOTAL )
{
strpos = CHUNKS_TOTAL - * offset ;
}
REST . set_response_payload ( response , buffer , strpos ) ;
/* IMPORTANT for chunk-wise resources: Signal chunk awareness to REST engine. */
* offset + = strpos ;
/* Signal end of resource representation. */
if ( * offset > = CHUNKS_TOTAL )
{
* offset = - 1 ;
}
}
# endif
/******************************************************************************/
# if REST_RES_SEPARATE && defined (PLATFORM_HAS_BUTTON) && WITH_COAP > 3
/* Required to manually (=not by the engine) handle the response transaction. */
2013-07-30 17:46:44 +02:00
# if WITH_COAP == 7
2013-02-19 16:18:04 +01:00
# include "er-coap-07-separate.h"
# include "er-coap-07-transactions.h"
2013-07-30 17:46:44 +02:00
# elif WITH_COAP == 12
# include "er-coap-12-separate.h"
# include "er-coap-12-transactions.h"
# elif WITH_COAP == 13
# include "er-coap-13-separate.h"
# include "er-coap-13-transactions.h"
# endif
2013-02-19 16:18:04 +01:00
/*
* CoAP - specific example for separate responses .
* Note the call " rest_set_pre_handler(&resource_separate, coap_separate_handler); " in the main process .
* The pre - handler takes care of the empty ACK and updates the MID and message type for CON requests .
* The resource handler must store all information that required to finalize the response later .
*/
RESOURCE ( separate , METHOD_GET , " test/separate " , " title= \" Separate demo \" " ) ;
/* A structure to store the required information */
typedef struct application_separate_store {
/* Provided by Erbium to store generic request information such as remote address and token. */
coap_separate_t request_metadata ;
/* Add fields for addition information to be stored for finalizing, e.g.: */
char buffer [ 16 ] ;
} application_separate_store_t ;
static uint8_t separate_active = 0 ;
static application_separate_store_t separate_store [ 1 ] ;
void
separate_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
/*
* Example allows only one open separate response .
* For multiple , the application must manage the list of stores .
*/
if ( separate_active )
{
coap_separate_reject ( ) ;
}
else
{
separate_active = 1 ;
/* Take over and skip response by engine. */
coap_separate_accept ( request , & separate_store - > request_metadata ) ;
/* Be aware to respect the Block2 option, which is also stored in the coap_separate_t. */
/*
* At the moment , only the minimal information is stored in the store ( client address , port , token , MID , type , and Block2 ) .
* Extend the store , if the application requires additional information from this handler .
* buffer is an example field for custom information .
*/
snprintf ( separate_store - > buffer , sizeof ( separate_store - > buffer ) , " StoredInfo " ) ;
}
}
void
separate_finalize_handler ( )
{
if ( separate_active )
{
coap_transaction_t * transaction = NULL ;
if ( ( transaction = coap_new_transaction ( separate_store - > request_metadata . mid , & separate_store - > request_metadata . addr , separate_store - > request_metadata . port ) ) )
{
coap_packet_t response [ 1 ] ; /* This way the packet can be treated as pointer as usual. */
/* Restore the request information for the response. */
2013-07-30 17:46:44 +02:00
coap_separate_resume ( response , & separate_store - > request_metadata , REST . status . OK ) ;
2013-02-19 16:18:04 +01:00
coap_set_payload ( response , separate_store - > buffer , strlen ( separate_store - > buffer ) ) ;
/*
* Be aware to respect the Block2 option , which is also stored in the coap_separate_t .
* As it is a critical option , this example resource pretends to handle it for compliance .
*/
coap_set_header_block2 ( response , separate_store - > request_metadata . block2_num , 0 , separate_store - > request_metadata . block2_size ) ;
/* Warning: No check for serialization error. */
transaction - > packet_len = coap_serialize_message ( response , transaction - > packet ) ;
coap_send_transaction ( transaction ) ;
/* The engine will clear the transaction (right after send for NON, after acked for CON). */
separate_active = 0 ;
}
else
{
/*
* Set timer for retry , send error message , . . .
* The example simply waits for another button press .
*/
}
} /* if (separate_active) */
}
# endif
/******************************************************************************/
# if REST_RES_PUSHING
/*
* Example for a periodic resource .
* It takes an additional period parameter , which defines the interval to call [ name ] _periodic_handler ( ) .
* A default post_handler takes care of subscriptions by managing a list of subscribers to notify .
*/
PERIODIC_RESOURCE ( pushing , METHOD_GET , " test/push " , " title= \" Periodic demo \" ;obs " , 5 * CLOCK_SECOND ) ;
void
pushing_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
/* Usually, a CoAP server would response with the resource representation matching the periodic_handler. */
const char * msg = " It's periodic! " ;
REST . set_response_payload ( response , msg , strlen ( msg ) ) ;
/* A post_handler that handles subscriptions will be called for periodic resources by the REST framework. */
}
/*
* Additionally , a handler function named [ resource name ] _handler must be implemented for each PERIODIC_RESOURCE .
* It will be called by the REST manager process with the defined period .
*/
void
pushing_periodic_handler ( resource_t * r )
{
static uint16_t obs_counter = 0 ;
static char content [ 11 ] ;
+ + obs_counter ;
PRINTF ( " TICK %u for /%s \n " , obs_counter , r - > url ) ;
/* Build notification. */
coap_packet_t notification [ 1 ] ; /* This way the packet can be treated as pointer as usual. */
2013-07-30 17:46:44 +02:00
coap_init_message ( notification , COAP_TYPE_NON , REST . status . OK , 0 ) ;
2013-02-19 16:18:04 +01:00
coap_set_payload ( notification , content , snprintf ( content , sizeof ( content ) , " TICK %u " , obs_counter ) ) ;
/* Notify the registered observers with the given message type, observe option, and payload. */
REST . notify_subscribers ( r , obs_counter , notification ) ;
}
# endif
/******************************************************************************/
# if REST_RES_EVENT && defined (PLATFORM_HAS_BUTTON)
/*
* Example for an event resource .
* Additionally takes a period parameter that defines the interval to call [ name ] _periodic_handler ( ) .
* A default post_handler takes care of subscriptions and manages a list of subscribers to notify .
*/
EVENT_RESOURCE ( event , METHOD_GET , " sensors/button " , " title= \" Event demo \" ;obs " ) ;
void
event_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
/* Usually, a CoAP server would response with the current resource representation. */
const char * msg = " It's eventful! " ;
REST . set_response_payload ( response , ( uint8_t * ) msg , strlen ( msg ) ) ;
/* A post_handler that handles subscriptions/observing will be called for periodic resources by the framework. */
}
/* Additionally, a handler function named [resource name]_event_handler must be implemented for each PERIODIC_RESOURCE defined.
* It will be called by the REST manager process with the defined period . */
void
event_event_handler ( resource_t * r )
{
static uint16_t event_counter = 0 ;
static char content [ 12 ] ;
+ + event_counter ;
PRINTF ( " TICK %u for /%s \n " , event_counter , r - > url ) ;
/* Build notification. */
coap_packet_t notification [ 1 ] ; /* This way the packet can be treated as pointer as usual. */
2013-07-30 17:46:44 +02:00
coap_init_message ( notification , COAP_TYPE_CON , REST . status . OK , 0 ) ;
2013-02-19 16:18:04 +01:00
coap_set_payload ( notification , content , snprintf ( content , sizeof ( content ) , " EVENT %u " , event_counter ) ) ;
/* Notify the registered observers with the given message type, observe option, and payload. */
REST . notify_subscribers ( r , event_counter , notification ) ;
}
# endif /* PLATFORM_HAS_BUTTON */
/******************************************************************************/
# if REST_RES_SUB
/*
* Example for a resource that also handles all its sub - resources .
* Use REST . get_url ( ) to multiplex the handling of the request depending on the Uri - Path .
*/
RESOURCE ( sub , METHOD_GET | HAS_SUB_RESOURCES , " test/path " , " title= \" Sub-resource demo \" " ) ;
void
sub_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
const char * uri_path = NULL ;
int len = REST . get_url ( request , & uri_path ) ;
int base_len = strlen ( resource_sub . url ) ;
if ( len = = base_len )
{
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " Request any sub-resource of /%s " , resource_sub . url ) ;
}
else
{
2013-07-30 17:46:44 +02:00
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " .%.*s " , len - base_len , uri_path + base_len ) ;
2013-02-19 16:18:04 +01:00
}
REST . set_response_payload ( response , buffer , strlen ( ( char * ) buffer ) ) ;
}
# endif
/******************************************************************************/
# if defined (PLATFORM_HAS_LEDS)
/******************************************************************************/
# if REST_RES_LEDS
/*A simple actuator example, depending on the color query parameter and post variable mode, corresponding led is activated or deactivated*/
RESOURCE ( leds , METHOD_POST | METHOD_PUT , " actuators/leds " , " title= \" LEDs: ?color=r|g|b, POST/PUT mode=on|off \" ;rt= \" Control \" " ) ;
void
leds_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
size_t len = 0 ;
const char * color = NULL ;
const char * mode = NULL ;
uint8_t led = 0 ;
int success = 1 ;
if ( ( len = REST . get_query_variable ( request , " color " , & color ) ) ) {
PRINTF ( " color %.*s \n " , len , color ) ;
if ( strncmp ( color , " r " , len ) = = 0 ) {
led = LEDS_RED ;
} else if ( strncmp ( color , " g " , len ) = = 0 ) {
led = LEDS_GREEN ;
} else if ( strncmp ( color , " b " , len ) = = 0 ) {
led = LEDS_BLUE ;
} else {
success = 0 ;
}
} else {
success = 0 ;
}
if ( success & & ( len = REST . get_post_variable ( request , " mode " , & mode ) ) ) {
PRINTF ( " mode %s \n " , mode ) ;
if ( strncmp ( mode , " on " , len ) = = 0 ) {
leds_on ( led ) ;
} else if ( strncmp ( mode , " off " , len ) = = 0 ) {
leds_off ( led ) ;
} else {
success = 0 ;
}
} else {
success = 0 ;
}
if ( ! success ) {
REST . set_response_status ( response , REST . status . BAD_REQUEST ) ;
}
}
# endif
/******************************************************************************/
# if REST_RES_TOGGLE
/* A simple actuator example. Toggles the red led */
2013-07-30 17:46:44 +02:00
RESOURCE ( toggle , METHOD_POST , " actuators/toggle " , " title= \" Red LED \" ;rt= \" Control \" " ) ;
2013-02-19 16:18:04 +01:00
void
toggle_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
leds_toggle ( LEDS_RED ) ;
}
# endif
# endif /* PLATFORM_HAS_LEDS */
/******************************************************************************/
# if REST_RES_LIGHT && defined (PLATFORM_HAS_LIGHT)
/* A simple getter example. Returns the reading from light sensor with a simple etag */
RESOURCE ( light , METHOD_GET , " sensors/light " , " title= \" Photosynthetic and solar light (supports JSON) \" ;rt= \" LightSensor \" " ) ;
void
light_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
uint16_t light_photosynthetic = light_sensor . value ( LIGHT_SENSOR_PHOTOSYNTHETIC ) ;
uint16_t light_solar = light_sensor . value ( LIGHT_SENSOR_TOTAL_SOLAR ) ;
const uint16_t * accept = NULL ;
int num = REST . get_header_accept ( request , & accept ) ;
if ( ( num = = 0 ) | | ( num & & accept [ 0 ] = = REST . type . TEXT_PLAIN ) )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " %u;%u " , light_photosynthetic , light_solar ) ;
REST . set_response_payload ( response , ( uint8_t * ) buffer , strlen ( ( char * ) buffer ) ) ;
}
else if ( num & & ( accept [ 0 ] = = REST . type . APPLICATION_XML ) )
{
REST . set_header_content_type ( response , REST . type . APPLICATION_XML ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " <light photosynthetic= \" %u \" solar= \" %u \" /> " , light_photosynthetic , light_solar ) ;
REST . set_response_payload ( response , buffer , strlen ( ( char * ) buffer ) ) ;
}
else if ( num & & ( accept [ 0 ] = = REST . type . APPLICATION_JSON ) )
{
REST . set_header_content_type ( response , REST . type . APPLICATION_JSON ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " {'light':{'photosynthetic':%u,'solar':%u}} " , light_photosynthetic , light_solar ) ;
REST . set_response_payload ( response , buffer , strlen ( ( char * ) buffer ) ) ;
}
else
{
2013-07-30 17:46:44 +02:00
REST . set_response_status ( response , REST . status . NOT_ACCEPTABLE ) ;
2013-02-19 16:18:04 +01:00
const char * msg = " Supporting content-types text/plain, application/xml, and application/json " ;
REST . set_response_payload ( response , msg , strlen ( msg ) ) ;
}
}
# endif /* PLATFORM_HAS_LIGHT */
/******************************************************************************/
# if REST_RES_BATTERY && defined (PLATFORM_HAS_BATTERY)
/* A simple getter example. Returns the reading from light sensor with a simple etag */
RESOURCE ( battery , METHOD_GET , " sensors/battery " , " title= \" Battery status \" ;rt= \" Battery \" " ) ;
void
battery_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
int battery = battery_sensor . value ( 0 ) ;
const uint16_t * accept = NULL ;
int num = REST . get_header_accept ( request , & accept ) ;
if ( ( num = = 0 ) | | ( num & & accept [ 0 ] = = REST . type . TEXT_PLAIN ) )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " %d " , battery ) ;
REST . set_response_payload ( response , ( uint8_t * ) buffer , strlen ( ( char * ) buffer ) ) ;
}
else if ( num & & ( accept [ 0 ] = = REST . type . APPLICATION_JSON ) )
{
REST . set_header_content_type ( response , REST . type . APPLICATION_JSON ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " {'battery':%d} " , battery ) ;
REST . set_response_payload ( response , buffer , strlen ( ( char * ) buffer ) ) ;
}
else
{
2013-07-30 17:46:44 +02:00
REST . set_response_status ( response , REST . status . NOT_ACCEPTABLE ) ;
2013-02-19 16:18:04 +01:00
const char * msg = " Supporting content-types text/plain and application/json " ;
REST . set_response_payload ( response , msg , strlen ( msg ) ) ;
}
}
# endif /* PLATFORM_HAS_BATTERY */
# if defined (PLATFORM_HAS_RADIO) && REST_RES_RADIO
/* A simple getter example. Returns the reading of the rssi/lqi from radio sensor */
RESOURCE ( radio , METHOD_GET , " sensor/radio " , " title= \" RADIO: ?p=lqi|rssi \" ;rt= \" RadioSensor \" " ) ;
void
radio_handler ( void * request , void * response , uint8_t * buffer , uint16_t preferred_size , int32_t * offset )
{
size_t len = 0 ;
const char * p = NULL ;
uint8_t param = 0 ;
int success = 1 ;
const uint16_t * accept = NULL ;
int num = REST . get_header_accept ( request , & accept ) ;
if ( ( len = REST . get_query_variable ( request , " p " , & p ) ) ) {
PRINTF ( " p %.*s \n " , len , p ) ;
if ( strncmp ( p , " lqi " , len ) = = 0 ) {
param = RADIO_SENSOR_LAST_VALUE ;
} else if ( strncmp ( p , " rssi " , len ) = = 0 ) {
param = RADIO_SENSOR_LAST_PACKET ;
} else {
success = 0 ;
}
} else {
success = 0 ;
}
if ( success ) {
if ( ( num = = 0 ) | | ( num & & accept [ 0 ] = = REST . type . TEXT_PLAIN ) )
{
REST . set_header_content_type ( response , REST . type . TEXT_PLAIN ) ;
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " %d " , radio_sensor . value ( param ) ) ;
REST . set_response_payload ( response , ( uint8_t * ) buffer , strlen ( ( char * ) buffer ) ) ;
}
else if ( num & & ( accept [ 0 ] = = REST . type . APPLICATION_JSON ) )
{
REST . set_header_content_type ( response , REST . type . APPLICATION_JSON ) ;
if ( param = = RADIO_SENSOR_LAST_VALUE ) {
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " {'lqi':%d} " , radio_sensor . value ( param ) ) ;
} else if ( param = = RADIO_SENSOR_LAST_PACKET ) {
snprintf ( ( char * ) buffer , REST_MAX_CHUNK_SIZE , " {'rssi':%d} " , radio_sensor . value ( param ) ) ;
}
REST . set_response_payload ( response , buffer , strlen ( ( char * ) buffer ) ) ;
}
else
{
2013-07-30 17:46:44 +02:00
REST . set_response_status ( response , REST . status . NOT_ACCEPTABLE ) ;
2013-02-19 16:18:04 +01:00
const char * msg = " Supporting content-types text/plain and application/json " ;
REST . set_response_payload ( response , msg , strlen ( msg ) ) ;
}
} else {
REST . set_response_status ( response , REST . status . BAD_REQUEST ) ;
}
}
# endif
2013-07-31 14:32:15 +02:00
void
hw_init ( )
{
# if defined (PLATFORM_HAS_LEDS)
leds_off ( LEDS_RED ) ;
# endif
}
2013-02-19 16:18:04 +01:00
PROCESS ( rest_server_example , " Erbium Example Server " ) ;
AUTOSTART_PROCESSES ( & rest_server_example ) ;
PROCESS_THREAD ( rest_server_example , ev , data )
{
PROCESS_BEGIN ( ) ;
PRINTF ( " Starting Erbium Example Server \n " ) ;
# ifdef RF_CHANNEL
PRINTF ( " RF channel: %u \n " , RF_CHANNEL ) ;
# endif
# ifdef IEEE802154_PANID
PRINTF ( " PAN ID: 0x%04X \n " , IEEE802154_PANID ) ;
# endif
PRINTF ( " uIP buffer: %u \n " , UIP_BUFSIZE ) ;
PRINTF ( " LL header: %u \n " , UIP_LLH_LEN ) ;
PRINTF ( " IP+UDP header: %u \n " , UIP_IPUDPH_LEN ) ;
PRINTF ( " REST max chunk: %u \n " , REST_MAX_CHUNK_SIZE ) ;
2013-07-31 14:32:15 +02:00
/* Initialize the OSD Hardware. */
hw_init ( ) ;
2013-02-19 16:18:04 +01:00
/* Initialize the REST engine. */
rest_init_engine ( ) ;
/* Activate the application-specific resources. */
# if REST_RES_HELLO
rest_activate_resource ( & resource_helloworld ) ;
# endif
# if REST_RES_MIRROR
rest_activate_resource ( & resource_mirror ) ;
# endif
# if REST_RES_CHUNKS
rest_activate_resource ( & resource_chunks ) ;
# endif
# if REST_RES_PUSHING
rest_activate_periodic_resource ( & periodic_resource_pushing ) ;
# endif
# if defined (PLATFORM_HAS_BUTTON) && REST_RES_EVENT
rest_activate_event_resource ( & resource_event ) ;
# endif
# if defined (PLATFORM_HAS_BUTTON) && REST_RES_SEPARATE && WITH_COAP > 3
/* No pre-handler anymore, user coap_separate_accept() and coap_separate_reject(). */
rest_activate_resource ( & resource_separate ) ;
# endif
# if defined (PLATFORM_HAS_BUTTON) && (REST_RES_EVENT || (REST_RES_SEPARATE && WITH_COAP > 3))
SENSORS_ACTIVATE ( button_sensor ) ;
# endif
# if REST_RES_SUB
rest_activate_resource ( & resource_sub ) ;
# endif
# if defined (PLATFORM_HAS_LEDS)
# if REST_RES_LEDS
rest_activate_resource ( & resource_leds ) ;
# endif
# if REST_RES_TOGGLE
rest_activate_resource ( & resource_toggle ) ;
# endif
# endif /* PLATFORM_HAS_LEDS */
# if defined (PLATFORM_HAS_LIGHT) && REST_RES_LIGHT
SENSORS_ACTIVATE ( light_sensor ) ;
rest_activate_resource ( & resource_light ) ;
# endif
# if defined (PLATFORM_HAS_BATTERY) && REST_RES_BATTERY
SENSORS_ACTIVATE ( battery_sensor ) ;
rest_activate_resource ( & resource_battery ) ;
# endif
# if defined (PLATFORM_HAS_RADIO) && REST_RES_RADIO
SENSORS_ACTIVATE ( radio_sensor ) ;
rest_activate_resource ( & resource_radio ) ;
# endif
/* Define application-specific events here. */
while ( 1 ) {
PROCESS_WAIT_EVENT ( ) ;
# if defined (PLATFORM_HAS_BUTTON)
if ( ev = = sensors_event & & data = = & button_sensor ) {
PRINTF ( " BUTTON \n " ) ;
# if REST_RES_EVENT
/* Call the event_handler for this application-specific event. */
event_event_handler ( & resource_event ) ;
# endif
# if REST_RES_SEPARATE && WITH_COAP>3
/* Also call the separate response example handler. */
separate_finalize_handler ( ) ;
# endif
}
# endif /* PLATFORM_HAS_BUTTON */
} /* while (1) */
PROCESS_END ( ) ;
}