Diff: mbed-client/mbed-client/m2mbase.h

Revision:

11:cada08fc8a70

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed-client/mbed-client/m2mbase.h	Thu Jun 09 17:08:36 2016 +0000
@@ -0,0 +1,396 @@
+/*
+ * Copyright (c) 2015 ARM Limited. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ * Licensed under the Apache License, Version 2.0 (the License); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an AS IS BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#ifndef M2M_BASE_H
+#define M2M_BASE_H
+
+// Support for std args
+#include <stdint.h>
+#include "mbed-client/m2mconfig.h"
+#include "mbed-client/m2mreportobserver.h"
+
+//FORWARD DECLARATION
+struct sn_coap_hdr_;
+typedef sn_coap_hdr_ sn_coap_hdr_s;
+struct nsdl_s;
+
+class M2MObservationHandler;
+class M2MReportHandler;
+
+/**
+ *  @brief M2MBase.
+ *  This class is the base class based on which all LWM2M object models
+ *  can be created. This serves base class for Object, ObjectInstances and Resources.
+ */
+
+class M2MBase : public M2MReportObserver {
+
+public:
+
+    /**
+      * Enum to define the type of object.
+      */
+    typedef enum {
+        Object = 0x0,
+        Resource = 0x1,
+        ObjectInstance = 0x2,
+        ResourceInstance = 0x3
+    } BaseType;
+
+    /**
+      * Enum to define observation level.
+      */
+    typedef enum {
+        None                 = 0x0,
+        R_Attribute          = 0x01,
+        OI_Attribute         = 0x02,
+        OIR_Attribute        = 0x03,
+        O_Attribute          = 0x04,
+        OR_Attribute         = 0x05,
+        OOI_Attribute        = 0x06,
+        OOIR_Attribute       = 0x07
+    } Observation;
+
+
+    /**
+     * @brief Enum defining an operation that can be
+     * supported by a given resource.
+    */
+    typedef enum {
+        Static,
+        Dynamic,
+        Directory
+    }Mode;
+
+    /**
+     * Enum defining an operation that can be
+     * supported by a given resource.
+    */
+    typedef enum {
+        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,
+
+    }Operation;
+
+protected:
+
+    // Prevents the use of default constructor.
+    M2MBase();
+
+    // Prevents the use of assignment operator.
+    M2MBase& operator=( const M2MBase& /*other*/ );
+
+    // Prevents the use of copy constructor
+    M2MBase( const M2MBase& /*other*/ );
+
+    /**
+     * @brief Constructor
+     * @param baseType, Type of the object created
+     * @param name, Name of the object
+     * @param id, ID of the object
+     */
+    M2MBase(const String &name,
+            M2MBase::Mode mode);
+public:
+
+    /**
+     * Destructor
+     */
+    virtual ~M2MBase();
+
+    /**
+     * @brief Sets the operation type for an object.
+     * @param operation, Operation to be set.
+     */
+    virtual void set_operation(M2MBase::Operation operation);
+
+    /**
+     * @brief Sets the interface description of the object.
+     * @param description, Description to be set.
+     */
+    virtual void set_interface_description(const String &description);
+
+    /**
+     * @brief Sets the resource type of the object.
+     * @param resource_type, Resource type to be set.
+     */
+    virtual void set_resource_type(const String &resource_type);
+
+    /**
+     * @brief Sets the CoAP content type of the object.
+     * @param content_type, Content Type to be set based on
+     * CoAP specifications.
+     */
+    virtual void set_coap_content_type(const uint8_t content_type);
+
+    /**
+     * @brief Sets the observable mode for the object.
+     * @param observable, Value for the observation.
+     */
+    virtual void set_observable(bool observable);
+
+    /**
+     * @brief Adds the observation level for the object.
+     * @param observation_level, Level of the observation.
+     */
+    virtual void add_observation_level(M2MBase::Observation observation_level);
+
+    /**
+     * @brief Removes the observation level for the object.
+     * @param observation_level, Level of the observation.
+     */
+    virtual void remove_observation_level(M2MBase::Observation observation_level);
+
+    /**
+     * @brief Sets the object under observation.
+     * @param observed, Value for the observation. When true, starts observing. When false, ongoing observation is cancelled.
+     * @param handler, Handler object for sending
+     * observation callbacks.
+     */
+    virtual void set_under_observation(bool observed,
+                                       M2MObservationHandler *handler);
+
+    /**
+     * @brief Sets the observation token value.
+     * @param token, Pointer to the token of the resource.
+     * @param length , Length of the token pointer.
+     */
+    virtual void set_observation_token(const uint8_t *token,
+                                       const uint8_t length);
+
+    /**
+     * Sets the instance ID of the object.
+     * @param instance_id, Instance ID of the object.
+     */
+    virtual void set_instance_id(const uint16_t instance_id);
+
+    /**
+     * Sets the observation number of the object.
+     * @param observation_number, Observation number of the object.
+     */
+    virtual void set_observation_number(const uint16_t observation_number);
+
+    /**
+     * @brief Returns object type.
+     * @return BaseType of the object.
+     */
+    virtual M2MBase::BaseType base_type() const;
+
+    /**
+     * @brief Returns the operation type of the object.
+     * @return Operation, Supported operation on the object.
+     */
+    virtual M2MBase::Operation operation() const;
+
+    /**
+     * @brief Returns the object name.
+     * @return Name for the object.
+     */
+    virtual const String &name() const;
+
+    /**
+     * @brief Returns the object name in integer.
+     * @return Name for the object in integer.
+     */
+    virtual int32_t name_id() const;
+
+    /**
+     * @brief Returns the object's Instance ID.
+     * @returns Instance ID of the object.
+     */
+    virtual uint16_t instance_id() const;
+
+    /**
+     * @brief Returns the interface description of the object.
+     * @return Description of the object.
+     */
+    virtual const String& interface_description() const;
+
+    /**
+     * @brief Returns the resource type of the object.
+     * @return Resource type of the object.
+     */
+    virtual const String& resource_type() const;
+
+    /**
+     * @brief Returns the CoAP content type of the object.
+     * @return Content type of the object.
+     */
+    virtual uint8_t coap_content_type() const;
+
+    /**
+     * @brief Returns the observation status of the object.
+     * @return True if observable, else false.
+     */
+    virtual bool is_observable() const;
+
+    /**
+     * @brief Returns the observation level of the object.
+     * @return Observation level of the object.
+     */
+    virtual M2MBase::Observation observation_level() const;
+
+    /**
+     * @brief Provides the observation token of the object.
+     * @param value[OUT], pointer to the value of the token.
+     * @param value_length[OUT], length of the token pointer.
+     */
+    virtual void get_observation_token(uint8_t *&token, uint32_t &token_length);
+
+    /**
+     * @brief Returns the mode of the resource.
+     * @return Mode of the resource.
+     */
+     virtual Mode mode() const;
+
+    /**
+     * @brief Returns the observation number.
+     * @return Observation number for the object.
+     */
+    virtual uint16_t observation_number() const;
+
+    /**
+     * @brief Parses the received query for the notification
+     * attribute.
+     * @param query, Query that needs to be parsed.
+     * @return True if required attributes are present, else false.
+     */
+    virtual bool handle_observation_attribute(char *&query);
+
+    /**
+     * @brief Handles GET request for the registered objects.
+     * @param nsdl, NSDL handler for the CoAP library.
+     * @param received_coap_header, Received CoAP message from the server.
+     * @param observation_handler, Handler object for sending
+     * observation callbacks.
+     * @return sn_coap_hdr_s,  Message that needs to be sent to server.
+     */
+    virtual sn_coap_hdr_s* handle_get_request(nsdl_s *nsdl,
+                                              sn_coap_hdr_s *received_coap_header,
+                                              M2MObservationHandler *observation_handler = NULL);
+    /**
+     * @brief Handles PUT request for the registered objects.
+     * @param nsdl, NSDL handler for the CoAP library.
+     * @param received_coap_header, Received CoAP message from the server.
+     * @param observation_handler, Handler object for sending
+     * observation callbacks.
+     * @return sn_coap_hdr_s,  Message that needs to be sent to server.
+     */
+    virtual sn_coap_hdr_s* handle_put_request(nsdl_s *nsdl,
+                                              sn_coap_hdr_s *received_coap_header,
+                                              M2MObservationHandler *observation_handler = NULL);
+
+    /**
+     * @brief Handles GET request for the registered objects.
+     * @param nsdl, NSDL handler for the CoAP library.
+     * @param received_coap_header, Received CoAP message from the server.
+     * @param observation_handler, Handler object for sending
+     * observation callbacks.
+     * @return sn_coap_hdr_s,  Message that needs to be sent to server.
+     */
+    virtual sn_coap_hdr_s* handle_post_request(nsdl_s *nsdl,
+                                               sn_coap_hdr_s *received_coap_header,
+                                               M2MObservationHandler *observation_handler = NULL);
+protected : // from M2MReportObserver
+
+    virtual void observation_to_be_sent();
+
+protected:
+
+    /**
+     * @brief Sets the Base type for object.
+     * @param type, Type of the base object.
+     */
+    virtual void set_base_type(M2MBase::BaseType type);
+
+    /**
+     * @brief Removes resource from the CoAP structure.
+     * @param resource_name, Name of the resource.
+     */
+    virtual void remove_resource_from_coap(const String &resource_name);
+
+    /**
+     * @brief Removes object from NSDL list.
+     */
+    virtual void remove_object_from_coap();
+
+    /**
+     * @brief Memory Allocation required for libCoap.
+     * @param size, Size of memory to be reserved.
+    */
+    virtual void* memory_alloc(uint16_t size);
+
+    /**
+     * @brief Memory free functions required for libCoap.
+     * @param ptr, Object whose memory needs to be freed.
+    */
+    virtual void memory_free(void *ptr);
+
+    /**
+     * @brief Returns Report Handler object.
+     * @return M2MReportHandler object.
+    */
+    M2MReportHandler* report_handler();
+
+    /**
+     * @brief Returns Observation Handler object.
+     * @return M2MObservationHandler object.
+    */
+    M2MObservationHandler* observation_handler();
+
+private:
+
+    bool is_integer(const String &value);
+
+private:
+
+
+    M2MReportHandler           *_report_handler;
+    M2MObservationHandler      *_observation_handler;
+    M2MBase::Operation          _operation;
+    M2MBase::Mode               _mode;
+    M2MBase::BaseType           _base_type;
+    M2MBase::Observation        _observation_level;
+    String                      _name;
+    String                      _resource_type;
+    int32_t                     _name_id;
+    String                      _interface_description;
+    uint8_t                     _coap_content_type;
+    uint16_t                    _instance_id;
+    bool                        _observable;
+    uint16_t                    _observation_number;
+    uint8_t                     *_token;
+    uint8_t                     _token_length;
+
+friend class Test_M2MBase;
+
+};
+
+#endif // M2M_BASE_H
+