Mistake on this page? Email us

The base class based on which all LwM2M object models can be created. More...

#include <m2mbase.h>

Inheritance diagram for M2MBase:
M2MReportObserver M2MObject M2MObjectInstance M2MResourceBase M2MDevice M2MFirmware M2MSecurity M2MServer M2MResource M2MResourceInstance

Data Structures

struct  lwm2m_parameters
 LwM2M parameters. More...
 

Public Types

enum  BaseType { Object = 0x0, Resource = 0x1, ObjectInstance = 0x2, ResourceInstance = 0x3 }
 Enum to define the type of object.
 
enum  Observation {
  None = 0x0, R_Attribute = 0x01, OI_Attribute = 0x02, OIR_Attribute = 0x03,
  O_Attribute = 0x04, OR_Attribute = 0x05, OOI_Attribute = 0x06, OOIR_Attribute = 0x07
}
 Enum to define observation level.
 
enum  Mode { Static, Dynamic, Directory }
 Enum defining a resource type.
 
enum  DataType {
  STRING, INTEGER, FLOAT, BOOLEAN,
  OPAQUE, TIME, OBJLINK
}
 Enum defining a resource data type.
 
enum  Operation {
  NOT_ALLOWED = 0x00, GET_ALLOWED = 0x01, PUT_ALLOWED = 0x02, GET_PUT_ALLOWED = 0x03,
  POST_ALLOWED = 0x04, GET_POST_ALLOWED = 0x05, PUT_POST_ALLOWED = 0x06, GET_PUT_POST_ALLOWED = 0x07,
  DELETE_ALLOWED = 0x08, GET_DELETE_ALLOWED = 0x09, PUT_DELETE_ALLOWED = 0x0A, GET_PUT_DELETE_ALLOWED = 0x0B,
  POST_DELETE_ALLOWED = 0x0C, GET_POST_DELETE_ALLOWED = 0x0D, PUT_POST_DELETE_ALLOWED = 0x0E, GET_PUT_POST_DELETE_ALLOWED = 0x0F
}
 Enum defining an operation that can be supported by a given resource.
 
enum  MessageDeliveryStatus {
  MESSAGE_STATUS_INIT = 0, MESSAGE_STATUS_BUILD_ERROR, MESSAGE_STATUS_RESEND_QUEUE_FULL, MESSAGE_STATUS_SENT,
  MESSAGE_STATUS_DELIVERED, MESSAGE_STATUS_SEND_FAILED, MESSAGE_STATUS_SUBSCRIBED, MESSAGE_STATUS_UNSUBSCRIBED,
  MESSAGE_STATUS_REJECTED
}
 Enum defining an status codes that can happen when sending confirmable message.
 
enum  MessageType { NOTIFICATION = 0, DELAYED_POST_RESPONSE, BLOCK_SUBSCRIBE, PING }
 
enum  MaxPathSize {
  MAX_NAME_SIZE = 64, MAX_INSTANCE_SIZE = 5, MAX_PATH_SIZE = ((MAX_NAME_SIZE * 2) + (MAX_INSTANCE_SIZE * 2) + 3 + 1), MAX_PATH_SIZE_2 = ((MAX_NAME_SIZE * 2) + MAX_INSTANCE_SIZE + 2 + 1),
  MAX_PATH_SIZE_3 = (MAX_NAME_SIZE + (MAX_INSTANCE_SIZE * 2) + 2 + 1), MAX_PATH_SIZE_4 = (MAX_NAME_SIZE + MAX_INSTANCE_SIZE + 1 + 1)
}
 
typedef void(* notification_delivery_status_cb) (const M2MBase &base, const NotificationDeliveryStatus status, void *client_args)
 
typedef void(* message_delivery_status_cb) (const M2MBase &base, const MessageDeliveryStatus status, const MessageType type, void *client_args)
 
typedef struct M2MBase::lwm2m_parameters lwm2m_parameters_s
 LwM2M parameters.
 

Public Member Functions

virtual ~M2MBase ()
 Destructor.
 
void set_operation (M2MBase::Operation operation)
 Sets the operation type for an object. More...
 
void set_interface_description (const String &description)
 Sets the interface description of the object. More...
 
void set_interface_description (const char *description)
 Sets the interface description of the object. More...
 
const char * interface_description () const
 Returns the interface description of the object. More...
 
virtual void set_resource_type (const String &resource_type)
 Sets the resource type of the object. More...
 
virtual void set_resource_type (const char *resource_type)
 Sets the resource type of the object. More...
 
const char * resource_type () const
 Returns the resource type of the object. More...
 
void set_coap_content_type (const uint16_t content_type)
 Sets the CoAP content type of the object. More...
 
void set_observable (bool observable)
 Sets the observable mode for the object. More...
 
void set_auto_observable (bool auto_observable)
 Sets the object to be auto-observable. More...
 
virtual void add_observation_level (M2MBase::Observation observation_level)
 Adds the observation level for the object. More...
 
virtual void remove_observation_level (M2MBase::Observation observation_level)
 Removes the observation level for the object. More...
 
void set_under_observation (bool observed, M2MObservationHandler *handler)
 Sets the object under observation. More...
 
virtual M2MObservationHandlerobservation_handler () const =0
 Returns the Observation Handler object. More...
 
virtual void set_observation_handler (M2MObservationHandler *handler)=0
 Sets the observation handler. More...
 
void set_instance_id (const uint16_t instance_id)
 Sets the instance ID of the object. More...
 
void set_max_age (const uint32_t max_age)
 Sets the max age for the resource value to be cached. More...
 
M2MBase::BaseType base_type () const
 Returns the object type. More...
 
M2MBase::Operation operation () const
 Returns the operation type of the object. More...
 
const char * name () const
 Returns the object name. More...
 
int32_t name_id () const
 Returns the object name in integer. More...
 
uint16_t instance_id () const
 Returns the object's instance ID. More...
 
const char * uri_path () const
 Returns the path of the object. More...
 
uint16_t coap_content_type () const
 Returns the CoAP content type of the object. More...
 
bool is_observable () const
 Returns the observation status of the object. More...
 
bool is_auto_observable () const
 Returns the auto observation status of the object. More...
 
M2MBase::Observation observation_level () const
 Returns the observation level of the object. More...
 
Mode mode () const
 Returns the mode of the resource. More...
 
uint16_t observation_number () const
 Returns the observation number. More...
 
uint32_t max_age () const
 Returns the max age for the resource value to be cached. More...
 
virtual sn_coap_hdr_s * handle_get_request (nsdl_s *nsdl, sn_coap_hdr_s *received_coap_header, M2MObservationHandler *observation_handler=NULL)
 Handles GET request for the registered objects. More...
 
virtual sn_coap_hdr_s * handle_put_request (nsdl_s *nsdl, sn_coap_hdr_s *received_coap_header, M2MObservationHandler *observation_handler, bool &execute_value_updated)
 Handles PUT request for the registered objects. More...
 
virtual sn_coap_hdr_s * handle_post_request (nsdl_s *nsdl, sn_coap_hdr_s *received_coap_header, M2MObservationHandler *observation_handler, bool &execute_value_updated, sn_nsdl_addr_s *address=NULL)
 Handles GET request for the registered objects. More...
 
void send_notification_delivery_status (const M2MBase &object, const NotificationDeliveryStatus status)
 Executes the function that is set in "set_notification_delivery_status_cb". Note: the setter for this callback is marked as m2m_deprecated, but there is no point having it here, as then the code will always give warnings. This simply must be there until the set_notification_delivery_status_cb() is removed.
 
void send_message_delivery_status (const M2MBase &object, const MessageDeliveryStatus status, const MessageType type)
 Executes the function that is set in "set_message_delivery_status_cb".
 
void set_register_uri (bool register_uri)
 Sets whether this resource is published to server or not. More...
 
bool register_uri ()
 Returns whether this resource is published to server or not. More...
 
bool is_under_observation () const
 Returns whether this resource is under observation or not. More...
 
bool set_value_updated_function (value_updated_callback callback)
 Sets the function that is executed when this object receives a PUT or POST command. More...
 
bool set_value_updated_function (value_updated_callback2 callback)
 Sets the function that is executed when this object receives a PUT or POST command. More...
 
bool is_value_updated_function_set () const
 Returns whether a callback function is set or not. More...
 
void execute_value_updated (const String &name)
 Calls the function that is set in the "set_value_updated_function". More...
 
size_t resource_name_length () const
 Returns length of the object name. More...
 
sn_nsdl_dynamic_resource_parameters_s * get_nsdl_resource () const
 Returns the resource information. More...
 
M2MBase::lwm2m_parameters_sget_lwm2m_parameters () const
 Returns the resource structure. More...
 
uint16_t get_notification_msgid () const m2m_deprecated
 Returns the notification message id. More...
 
void set_notification_msgid (uint16_t msgid) m2m_deprecated
 Sets the notification message id. This is used to map RESET and EMPTY ACK messages. More...
 
bool set_notification_delivery_status_cb (notification_delivery_status_cb callback, void *client_args) m2m_deprecated
 Sets the function that is executed when notification message state changes. More...
 
bool set_message_delivery_status_cb (message_delivery_status_cb callback, void *client_args)
 Sets the function that is executed when message state changes. Currently this is used to track notifications and delayed response delivery statuses. More...
 

Static Public Member Functions

static char * create_path (const M2MObject &parent, const char *name)
 
static char * create_path (const M2MObject &parent, uint16_t object_instance)
 
static char * create_path (const M2MResource &parent, uint16_t resource_instance)
 
static char * create_path (const M2MResource &parent, const char *name)
 
static char * create_path (const M2MObjectInstance &parent, const char *name)
 

Protected Member Functions

M2MBaseoperator= (const M2MBase &)
 
 M2MBase (const M2MBase &)
 
 M2MBase (const String &name, M2MBase::Mode mode, const String &resource_type, char *path, bool external_blockwise_store, bool multiple_instance, M2MBase::DataType type=M2MBase::OBJLINK)
 Constructor. More...
 
 M2MBase (const lwm2m_parameters_s *s)
 
virtual bool observation_to_be_sent (const m2m::Vector< uint16_t > &changed_instance_ids, uint16_t obs_number, bool send_object=false)
 An observation callback to be sent to the server due to a change in the observed parameter. More...
 
void set_base_type (M2MBase::BaseType type)
 Sets the base type for an object. More...
 
M2MReportHandler * create_report_handler ()
 Create Report Handler object. More...
 
M2MReportHandler * report_handler () const
 Returns the Report Handler object. More...
 
void free_resources ()
 Delete the resource structures owned by this object. Note: this needs to be called separately from each subclass' destructor as this method uses a virtual method and the call needs to be done at same class which has the implementation of the pure virtual method.
 
NotificationDeliveryStatus get_notification_delivery_status () const m2m_deprecated
 Returns notification send status. More...
 
void clear_notification_delivery_status () m2m_deprecated
 Clears the notification send status to initial state.
 
void get_observation_token (uint8_t *token, uint8_t &token_length) const
 Provides the observation token of the object. More...
 
void set_observation_token (const uint8_t *token, const uint8_t length)
 Sets the observation token value. More...
 
virtual void set_changed ()
 The data has changed and it needs to be updated into Device Management. Current implementation maintains the changed state only in M2MEndpoint. If any of the changes in an object changes the M2M registration structure, the information is propagated to M2MEndpoint using this interface.
 
virtual M2MBaseget_parent () const
 Returns the owner object. Can return NULL if the object has no parent.
 
void handle_observation (nsdl_s *nsdl, const sn_coap_hdr_s &received_coap_header, sn_coap_hdr_s &coap_response, M2MObservationHandler *observation_handler, sn_coap_msg_code_e &response_code)
 Handles subscription request. More...
 
void start_observation (const sn_coap_hdr_s &received_coap_header, M2MObservationHandler *observation_handler)
 Start the observation. More...
 

Static Protected Member Functions

static void * memory_alloc (uint32_t size)
 Memory allocation required for libCoap. More...
 
static void memory_free (void *ptr)
 Memory free functions required for libCoap. More...
 
static char * alloc_string_copy (const char *source)
 Allocate and make a copy of given zero terminated string. This is functionally equivalent with strdup(). More...
 
static uint8_t * alloc_string_copy (const uint8_t *source, uint32_t size)
 Allocate (size + 1) amount of memory, copy size bytes into it and add zero termination. More...
 
static uint8_t * alloc_copy (const uint8_t *source, uint32_t size)
 Allocate (size) amount of memory, copy size bytes into it. More...
 
static bool validate_string_length (const String &string, size_t min_length, size_t max_length)
 
static bool validate_string_length (const char *string, size_t min_length, size_t max_length)
 
static bool build_path (StringBuffer< MAX_PATH_SIZE > &buffer, const char *s1, uint16_t i1, const char *s2, uint16_t i2)
 
static bool build_path (StringBuffer< MAX_PATH_SIZE_2 > &buffer, const char *s1, uint16_t i1, const char *s2)
 
static bool build_path (StringBuffer< MAX_PATH_SIZE_3 > &buffer, const char *s1, uint16_t i1, uint16_t i2)
 
static bool build_path (StringBuffer< MAX_PATH_SIZE_4 > &buffer, const char *s1, uint16_t i1)
 
static char * stringdup (const char *s)
 
static bool is_blockwise_needed (const nsdl_s *nsdl, uint32_t payload_len)
 Checks whether blockwise is needed to send resource value to server. More...
 

Friends

class Test_M2MBase
 
class Test_M2MObject
 
class M2MNsdlInterface
 
class M2MInterfaceFactory
 
class M2MObject
 

Detailed Description

The base class based on which all LwM2M object models can be created.

It serves as the base class for Objects, ObjectInstances and Resources.

Constructor & Destructor Documentation

M2MBase::M2MBase ( const String name,
M2MBase::Mode  mode,
const String resource_type,
char *  path,
bool  external_blockwise_store,
bool  multiple_instance,
M2MBase::DataType  type = M2MBase::OBJLINK 
)
protected

Constructor.

Parameters
nameName of the object created.
modeType of the resource.
resource_typeTextual information of resource.
pathPath of the object like 3/0/1
external_blockwise_storeIf true CoAP blocks are passed to application through callbacks otherwise handled in mbed-client-c.

Member Function Documentation

virtual void M2MBase::add_observation_level ( M2MBase::Observation  observation_level)
virtual

Adds the observation level for the object.

Parameters
observation_levelThe level of observation.

Reimplemented in M2MObjectInstance, M2MResource, and M2MObject.

static uint8_t* M2MBase::alloc_copy ( const uint8_t *  source,
uint32_t  size 
)
staticprotected

Allocate (size) amount of memory, copy size bytes into it.

Parameters
sourceThe source buffer to copy, may not be NULL.
sizeThe size of memory to be reserved.
static char* M2MBase::alloc_string_copy ( const char *  source)
staticprotected

Allocate and make a copy of given zero terminated string. This is functionally equivalent with strdup().

Parameters
sourceThe source string to copy, may not be NULL.
static uint8_t* M2MBase::alloc_string_copy ( const uint8_t *  source,
uint32_t  size 
)
staticprotected

Allocate (size + 1) amount of memory, copy size bytes into it and add zero termination.

Parameters
sourceThe source string to copy, may not be NULL.
sizeThe size of memory to be reserved.
M2MBase::BaseType M2MBase::base_type ( ) const

Returns the object type.

Returns
The base type of the object.
uint16_t M2MBase::coap_content_type ( ) const

Returns the CoAP content type of the object.

Returns
The CoAP content type of the object.
M2MReportHandler* M2MBase::create_report_handler ( )
protected

Create Report Handler object.

Returns
M2MReportHandler object.
void M2MBase::execute_value_updated ( const String name)

Calls the function that is set in the "set_value_updated_function".

Parameters
nameThe name of the object.
M2MBase::lwm2m_parameters_s* M2MBase::get_lwm2m_parameters ( ) const

Returns the resource structure.

Returns
Resource structure.
NotificationDeliveryStatus M2MBase::get_notification_delivery_status ( ) const
protected

Returns notification send status.

Returns
Notification status.
uint16_t M2MBase::get_notification_msgid ( ) const

Returns the notification message id.

Returns
Message id.
sn_nsdl_dynamic_resource_parameters_s* M2MBase::get_nsdl_resource ( ) const

Returns the resource information.

Returns
Resource information.
void M2MBase::get_observation_token ( uint8_t *  token,
uint8_t &  token_length 
) const
protected

Provides the observation token of the object.

Parameters
[out]tokenA pointer to the value of the token.
[out]token_lengthThe length of the token pointer.
virtual sn_coap_hdr_s* M2MBase::handle_get_request ( nsdl_s *  nsdl,
sn_coap_hdr_s *  received_coap_header,
M2MObservationHandler observation_handler = NULL 
)
virtual

Handles GET request for the registered objects.

Parameters
nsdlAn NSDL handler for the CoAP library.
received_coap_headerThe received CoAP message from the server.
observation_handlerA handler object for sending observation callbacks.
Returns
sn_coap_hdr_s The message that needs to be sent to server.

Reimplemented in M2MResourceBase, M2MObjectInstance, M2MResource, and M2MObject.

void M2MBase::handle_observation ( nsdl_s *  nsdl,
const sn_coap_hdr_s &  received_coap_header,
sn_coap_hdr_s &  coap_response,
M2MObservationHandler observation_handler,
sn_coap_msg_code_e &  response_code 
)
protected

Handles subscription request.

Parameters
nsdlAn NSDL handler for the CoAP library.
received_coap_headerThe received CoAP message from the server.
coap_responseThe CoAP response to be sent to server.
observation_handlerA handler object for sending observation callbacks.
virtual sn_coap_hdr_s* M2MBase::handle_post_request ( nsdl_s *  nsdl,
sn_coap_hdr_s *  received_coap_header,
M2MObservationHandler observation_handler,
bool &  execute_value_updated,
sn_nsdl_addr_s *  address = NULL 
)
virtual

Handles GET request for the registered objects.

Parameters
nsdlAn NSDL handler for the CoAP library.
received_coap_headerThe received CoAP message from the server.
observation_handlerA handler object for sending observation callbacks.
execute_value_updatedTrue executes the "value_updated" callback.
Returns
sn_coap_hdr_s The message that needs to be sent to server.

Reimplemented in M2MObjectInstance, M2MResource, and M2MObject.

virtual sn_coap_hdr_s* M2MBase::handle_put_request ( nsdl_s *  nsdl,
sn_coap_hdr_s *  received_coap_header,
M2MObservationHandler observation_handler,
bool &  execute_value_updated 
)
virtual

Handles PUT request for the registered objects.

Parameters
nsdlAn NSDL handler for the CoAP library.
received_coap_headerThe received CoAP message from the server.
observation_handlerA handler object for sending observation callbacks.
execute_value_updatedTrue executes the "value_updated" callback.
Returns
sn_coap_hdr_s The message that needs to be sent to server.

Reimplemented in M2MResourceBase, M2MObjectInstance, M2MResource, and M2MObject.

uint16_t M2MBase::instance_id ( ) const

Returns the object's instance ID.

Returns
The instance ID of the object.
const char* M2MBase::interface_description ( ) const

Returns the interface description of the object.

Returns
The interface description of the object.
bool M2MBase::is_auto_observable ( ) const

Returns the auto observation status of the object.

Returns
True if observable, else false.
static bool M2MBase::is_blockwise_needed ( const nsdl_s *  nsdl,
uint32_t  payload_len 
)
staticprotected

Checks whether blockwise is needed to send resource value to server.

Parameters
nsdlAn NSDL handler for the CoAP library.
payload_lenLength of the CoAP payload.
Returns
True if blockwise transfer is needed, else false.
bool M2MBase::is_observable ( ) const

Returns the observation status of the object.

Returns
True if observable, else false.
bool M2MBase::is_under_observation ( ) const

Returns whether this resource is under observation or not.

Returns
True if the resource is under observation, else false,
bool M2MBase::is_value_updated_function_set ( ) const

Returns whether a callback function is set or not.

Returns
True if the callback function is set, else false.
uint32_t M2MBase::max_age ( ) const

Returns the max age for the resource value to be cached.

Returns
The maax age in seconds.
static void* M2MBase::memory_alloc ( uint32_t  size)
staticprotected

Memory allocation required for libCoap.

Parameters
sizeThe size of memory to be reserved.
static void M2MBase::memory_free ( void *  ptr)
staticprotected

Memory free functions required for libCoap.

Parameters
ptrThe object whose memory needs to be freed.
Mode M2MBase::mode ( ) const

Returns the mode of the resource.

Returns
The mode of the resource.
const char* M2MBase::name ( ) const

Returns the object name.

Returns
The name of the object.
int32_t M2MBase::name_id ( ) const

Returns the object name in integer.

Returns
The name of the object in integer.
virtual M2MObservationHandler* M2MBase::observation_handler ( ) const
pure virtual

Returns the Observation Handler object.

Returns
M2MObservationHandler object.

Implemented in M2MObjectInstance, M2MResource, M2MObject, and M2MResourceInstance.

M2MBase::Observation M2MBase::observation_level ( ) const

Returns the observation level of the object.

Returns
The observation level of the object.
uint16_t M2MBase::observation_number ( ) const

Returns the observation number.

Returns
The observation number of the object.
virtual bool M2MBase::observation_to_be_sent ( const m2m::Vector< uint16_t > &  changed_instance_ids,
uint16_t  obs_number,
bool  send_object = false 
)
protectedvirtual

An observation callback to be sent to the server due to a change in the observed parameter.

Parameters
changed_instance_idsA list of changed object instance IDs.
obs_numberThe observation number.
send_objectIndicates whether the whole object will be sent or not.
Returns
True if the message was send, False if there is already ongoing notification.

Implements M2MReportObserver.

M2MBase::Operation M2MBase::operation ( ) const

Returns the operation type of the object.

Returns
The supported operation on the object.
bool M2MBase::register_uri ( )

Returns whether this resource is published to server or not.

Returns
True if the resource is a part of the registration message, else false.
virtual void M2MBase::remove_observation_level ( M2MBase::Observation  observation_level)
virtual

Removes the observation level for the object.

Parameters
observation_levelThe level of observation.

Reimplemented in M2MObjectInstance, M2MResource, and M2MObject.

M2MReportHandler* M2MBase::report_handler ( ) const
protected

Returns the Report Handler object.

Returns
M2MReportHandler object.
size_t M2MBase::resource_name_length ( ) const

Returns length of the object name.

Returns
Length of the object name.
const char* M2MBase::resource_type ( ) const

Returns the resource type of the object.

Returns
The resource type of the object.
void M2MBase::set_auto_observable ( bool  auto_observable)

Sets the object to be auto-observable.

Note
This is not a standard CoAP or LwM2M feature and it only works in Device Management.
You must call this before registration process, since this info must be in a registration message.
Auto-observable will take higher precedence if both observable methods are set.
Parameters
auto_observableIs auto-obs feature enabled or not.
void M2MBase::set_base_type ( M2MBase::BaseType  type)
protected

Sets the base type for an object.

Parameters
typeThe base type of the object.
void M2MBase::set_coap_content_type ( const uint16_t  content_type)

Sets the CoAP content type of the object.

Parameters
content_typeThe content type to be set based on CoAP specifications.
void M2MBase::set_instance_id ( const uint16_t  instance_id)

Sets the instance ID of the object.

Parameters
instance_idThe instance ID of the object.
void M2MBase::set_interface_description ( const String description)

Sets the interface description of the object.

Parameters
descriptionThe description to be set.
void M2MBase::set_interface_description ( const char *  description)

Sets the interface description of the object.

Parameters
descriptionThe description to be set.
void M2MBase::set_max_age ( const uint32_t  max_age)

Sets the max age for the resource value to be cached.

Parameters
max_ageThe max age in seconds.
bool M2MBase::set_message_delivery_status_cb ( message_delivery_status_cb  callback,
void *  client_args 
)

Sets the function that is executed when message state changes. Currently this is used to track notifications and delayed response delivery statuses.

Parameters
callbackThe function pointer that is called.
client_argsThe argument which is passed to the callback function.
bool M2MBase::set_notification_delivery_status_cb ( notification_delivery_status_cb  callback,
void *  client_args 
)

Sets the function that is executed when notification message state changes.

Parameters
callbackThe function pointer that is called.
client_argsThe argument which is passed to the callback function.
void M2MBase::set_notification_msgid ( uint16_t  msgid)

Sets the notification message id. This is used to map RESET and EMPTY ACK messages.

Parameters
msgidThe message id.
void M2MBase::set_observable ( bool  observable)

Sets the observable mode for the object.

Parameters
observableA value for the observation.
virtual void M2MBase::set_observation_handler ( M2MObservationHandler handler)
pure virtual

Sets the observation handler.

Parameters
handlerObservation handler

Implemented in M2MObjectInstance, M2MResource, M2MObject, and M2MResourceInstance.

void M2MBase::set_observation_token ( const uint8_t *  token,
const uint8_t  length 
)
protected

Sets the observation token value.

Parameters
tokenA pointer to the token of the resource.
lengthThe length of the token pointer.
void M2MBase::set_operation ( M2MBase::Operation  operation)

Sets the operation type for an object.

Parameters
operationThe operation to be set.
void M2MBase::set_register_uri ( bool  register_uri)

Sets whether this resource is published to server or not.

Parameters
register_uriTrue sets the resource as part of registration message.
virtual void M2MBase::set_resource_type ( const String resource_type)
virtual

Sets the resource type of the object.

Parameters
resource_typeThe resource type to be set.
virtual void M2MBase::set_resource_type ( const char *  resource_type)
virtual

Sets the resource type of the object.

Parameters
resource_typeThe resource type to be set.
void M2MBase::set_under_observation ( bool  observed,
M2MObservationHandler handler 
)

Sets the object under observation.

Parameters
observedThe value for observation. When true, starts observing. When false, the ongoing observation is cancelled.
handlerA handler object for sending observation callbacks.
bool M2MBase::set_value_updated_function ( value_updated_callback  callback)

Sets the function that is executed when this object receives a PUT or POST command.

Parameters
callbackThe function pointer that is called.
Returns
True, if callback could be set, false otherwise.
bool M2MBase::set_value_updated_function ( value_updated_callback2  callback)

Sets the function that is executed when this object receives a PUT or POST command.

Parameters
callbackThe function pointer that is called.
Returns
True, if callback could be set, false otherwise.
void M2MBase::start_observation ( const sn_coap_hdr_s &  received_coap_header,
M2MObservationHandler observation_handler 
)
protected

Start the observation.

Parameters
received_coap_headerAn NSDL handler for the CoAP library.
observation_handlerA handler object for sending observation callbacks.
const char* M2MBase::uri_path ( ) const

Returns the path of the object.

Returns
The path of the object (eg. 3/0/1).

The documentation for this class was generated from the following file:
  • mbed-cloud-client/mbed-client/mbed-client/m2mbase.h