terence zhang / Mbed OS mbed-os-example-wakaama

Dependencies:   C12832 LM75B

Committer:
terencez
Date:
Sat May 06 11:21:27 2017 +0000
Revision:
14:ec9e195830ff
Parent:
13:4e6f1ebf886c
Child:
16:31c387e94b6d
First compile version, registration success but could not handle request.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
terencez 0:f9d13e09cf11 1 /*******************************************************************************
terencez 0:f9d13e09cf11 2 *
terencez 0:f9d13e09cf11 3 * Copyright (c) 2013, 2014 Intel Corporation and others.
terencez 0:f9d13e09cf11 4 * All rights reserved. This program and the accompanying materials
terencez 0:f9d13e09cf11 5 * are made available under the terms of the Eclipse Public License v1.0
terencez 0:f9d13e09cf11 6 * and Eclipse Distribution License v1.0 which accompany this distribution.
terencez 0:f9d13e09cf11 7 *
terencez 0:f9d13e09cf11 8 * The Eclipse Public License is available at
terencez 0:f9d13e09cf11 9 * http://www.eclipse.org/legal/epl-v10.html
terencez 0:f9d13e09cf11 10 * The Eclipse Distribution License is available at
terencez 0:f9d13e09cf11 11 * http://www.eclipse.org/org/documents/edl-v10.php.
terencez 0:f9d13e09cf11 12 *
terencez 0:f9d13e09cf11 13 * Contributors:
terencez 0:f9d13e09cf11 14 * David Navarro, Intel Corporation - initial API and implementation
terencez 0:f9d13e09cf11 15 * Fabien Fleutot - Please refer to git log
terencez 0:f9d13e09cf11 16 * Simon Bernard - Please refer to git log
terencez 0:f9d13e09cf11 17 * Toby Jaffey - Please refer to git log
terencez 0:f9d13e09cf11 18 * Julien Vermillard - Please refer to git log
terence zhang 3:a280069151ac 19 * Bosch Software Innovations GmbH - Please refer to git log
terence zhang 3:a280069151ac 20 * Pascal Rieux - Please refer to git log
terencez 0:f9d13e09cf11 21 *******************************************************************************/
terencez 0:f9d13e09cf11 22
terencez 0:f9d13e09cf11 23 /*
terencez 0:f9d13e09cf11 24 Copyright (c) 2013, 2014 Intel Corporation
terencez 0:f9d13e09cf11 25
terencez 0:f9d13e09cf11 26 Redistribution and use in source and binary forms, with or without modification,
terencez 0:f9d13e09cf11 27 are permitted provided that the following conditions are met:
terencez 0:f9d13e09cf11 28
terencez 0:f9d13e09cf11 29 * Redistributions of source code must retain the above copyright notice,
terencez 0:f9d13e09cf11 30 this list of conditions and the following disclaimer.
terencez 0:f9d13e09cf11 31 * Redistributions in binary form must reproduce the above copyright notice,
terencez 0:f9d13e09cf11 32 this list of conditions and the following disclaimer in the documentation
terencez 0:f9d13e09cf11 33 and/or other materials provided with the distribution.
terencez 0:f9d13e09cf11 34 * Neither the name of Intel Corporation nor the names of its contributors
terencez 0:f9d13e09cf11 35 may be used to endorse or promote products derived from this software
terencez 0:f9d13e09cf11 36 without specific prior written permission.
terencez 0:f9d13e09cf11 37
terencez 0:f9d13e09cf11 38 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
terencez 0:f9d13e09cf11 39 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
terencez 0:f9d13e09cf11 40 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
terencez 0:f9d13e09cf11 41 IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
terencez 0:f9d13e09cf11 42 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
terencez 0:f9d13e09cf11 43 BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
terencez 0:f9d13e09cf11 44 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
terencez 0:f9d13e09cf11 45 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
terencez 0:f9d13e09cf11 46 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
terencez 0:f9d13e09cf11 47 THE POSSIBILITY OF SUCH DAMAGE.
terencez 0:f9d13e09cf11 48
terencez 0:f9d13e09cf11 49 David Navarro <david.navarro@intel.com>
terencez 0:f9d13e09cf11 50
terencez 0:f9d13e09cf11 51 */
terencez 0:f9d13e09cf11 52
terencez 0:f9d13e09cf11 53 #ifndef _LWM2M_CLIENT_H_
terencez 0:f9d13e09cf11 54 #define _LWM2M_CLIENT_H_
terencez 0:f9d13e09cf11 55
terence zhang 3:a280069151ac 56 #ifdef __cplusplus
terence zhang 3:a280069151ac 57 extern "C" {
terence zhang 3:a280069151ac 58 #endif
terence zhang 3:a280069151ac 59
terencez 0:f9d13e09cf11 60 #include <stdint.h>
terencez 0:f9d13e09cf11 61 #include <stddef.h>
terencez 0:f9d13e09cf11 62 #include <stdbool.h>
terence zhang 3:a280069151ac 63 #include <time.h>
terence zhang 3:a280069151ac 64
terencez 0:f9d13e09cf11 65
terencez 11:1fadb70654a6 66 #define MBED_OS_EXAMPLE_WAKAAMA
terencez 11:1fadb70654a6 67
terencez 10:df97539c6ddd 68 #ifdef MBED_OS_EXAMPLE_WAKAAMA
terencez 0:f9d13e09cf11 69 #include <stdlib.h>
terencez 0:f9d13e09cf11 70 #include <string.h>
terencez 13:4e6f1ebf886c 71 #include "er-coap-13/er-coap-13.h"
terencez 11:1fadb70654a6 72 #endif
terencez 11:1fadb70654a6 73
terencez 11:1fadb70654a6 74 //////////////////////////////////////////////////
terencez 11:1fadb70654a6 75 #ifdef MBED_OS_EXAMPLE_WAKAAMA
terencez 0:f9d13e09cf11 76 // Global definitions
terencez 0:f9d13e09cf11 77 #define LWM2M_LITTLE_ENDIAN
terencez 0:f9d13e09cf11 78 #define LWM2M_CLIENT_MODE
terencez 0:f9d13e09cf11 79 #define LWM2M_WITH_LOGS
terencez 0:f9d13e09cf11 80 #define SHARED_DEFINITIONS
terencez 0:f9d13e09cf11 81 #define WAKAAMA_DEFINITIONS
terencez 0:f9d13e09cf11 82 #endif
terencez 0:f9d13e09cf11 83
terencez 0:f9d13e09cf11 84 #ifndef LWM2M_EMBEDDED_MODE
terencez 0:f9d13e09cf11 85 /** LWIP_TIMEVAL_PRIVATE: if you want to use the struct timeval provided
terencez 0:f9d13e09cf11 86 * by your system, set this to 0 and include <sys/time.h> in cc.h */
terencez 14:ec9e195830ff 87 //typedef long time_t
terencez 0:f9d13e09cf11 88
terencez 0:f9d13e09cf11 89 struct timeval {
terencez 14:ec9e195830ff 90 time_t tv_sec; /* seconds */
terencez 14:ec9e195830ff 91 time_t tv_usec; /* and microseconds */
terencez 0:f9d13e09cf11 92 };
terencez 0:f9d13e09cf11 93 struct timezone{
terencez 0:f9d13e09cf11 94
terencez 0:f9d13e09cf11 95 int tz_minuteswest; /*minutes to greenwich time*/
terencez 0:f9d13e09cf11 96 int tz_dsttime; /*type of DST correction*/
terencez 0:f9d13e09cf11 97 };
terencez 0:f9d13e09cf11 98
terencez 0:f9d13e09cf11 99 #endif
terencez 0:f9d13e09cf11 100
terence zhang 3:a280069151ac 101
terence zhang 3:a280069151ac 102 #ifdef LWM2M_SERVER_MODE
terence zhang 3:a280069151ac 103 #ifndef LWM2M_SUPPORT_JSON
terence zhang 3:a280069151ac 104 #define LWM2M_SUPPORT_JSON
terence zhang 3:a280069151ac 105 #endif
terence zhang 3:a280069151ac 106 #endif
terence zhang 3:a280069151ac 107
terence zhang 3:a280069151ac 108 #if defined(LWM2M_BOOTSTRAP) && defined(LWM2M_BOOTSTRAP_SERVER_MODE)
terence zhang 3:a280069151ac 109 #error "LWM2M_BOOTSTRAP and LWM2M_BOOTSTRAP_SERVER_MODE cannot be defined at the same time!"
terence zhang 3:a280069151ac 110 #endif
terence zhang 3:a280069151ac 111
terence zhang 3:a280069151ac 112 /*
terence zhang 3:a280069151ac 113 * Platform abstraction functions to be implemented by the user
terence zhang 3:a280069151ac 114 */
terence zhang 3:a280069151ac 115
terence zhang 3:a280069151ac 116 #ifndef LWM2M_MEMORY_TRACE
terence zhang 3:a280069151ac 117 // Allocate a block of size bytes of memory, returning a pointer to the beginning of the block.
terence zhang 3:a280069151ac 118 void * lwm2m_malloc(size_t s);
terence zhang 3:a280069151ac 119 // Deallocate a block of memory previously allocated by lwm2m_malloc() or lwm2m_strdup()
terence zhang 3:a280069151ac 120 void lwm2m_free(void * p);
terence zhang 3:a280069151ac 121 // Allocate a memory block, duplicate the string str in it and return a pointer to this new block.
terence zhang 3:a280069151ac 122 char * lwm2m_strdup(const char * str);
terence zhang 3:a280069151ac 123 #else
terence zhang 3:a280069151ac 124 // same functions as above with caller location for debugging purposes
terence zhang 3:a280069151ac 125 char * lwm2m_trace_strdup(const char * str, const char * file, const char * function, int lineno);
terence zhang 3:a280069151ac 126 void * lwm2m_trace_malloc(size_t size, const char * file, const char * function, int lineno);
terence zhang 3:a280069151ac 127 void lwm2m_trace_free(void * mem, const char * file, const char * function, int lineno);
terence zhang 3:a280069151ac 128
terence zhang 3:a280069151ac 129 #define lwm2m_strdup(S) lwm2m_trace_strdup(S, __FILE__, __FUNCTION__, __LINE__)
terence zhang 3:a280069151ac 130 #define lwm2m_malloc(S) lwm2m_trace_malloc(S, __FILE__, __FUNCTION__, __LINE__)
terence zhang 3:a280069151ac 131 #define lwm2m_free(M) lwm2m_trace_free(M, __FILE__, __FUNCTION__, __LINE__)
terence zhang 3:a280069151ac 132 #endif
terence zhang 3:a280069151ac 133 // Compare at most the n first bytes of s1 and s2, return 0 if they match
terence zhang 3:a280069151ac 134 int lwm2m_strncmp(const char * s1, const char * s2, size_t n);
terence zhang 3:a280069151ac 135 // This function must return the number of seconds elapsed since origin.
terence zhang 3:a280069151ac 136 // The origin (Epoch, system boot, etc...) does not matter as this
terence zhang 3:a280069151ac 137 // function is used only to determine the elapsed time since the last
terence zhang 3:a280069151ac 138 // call to it.
terence zhang 3:a280069151ac 139 // In case of error, this must return a negative value.
terence zhang 3:a280069151ac 140 // Per POSIX specifications, time_t is a signed integer.
terence zhang 3:a280069151ac 141 time_t lwm2m_gettime(void);
terence zhang 3:a280069151ac 142
terence zhang 3:a280069151ac 143 #ifdef LWM2M_WITH_LOGS
terence zhang 3:a280069151ac 144 // Same usage as C89 printf()
terence zhang 3:a280069151ac 145 void lwm2m_printf(const char * format, ...);
terence zhang 3:a280069151ac 146 #endif
terence zhang 3:a280069151ac 147
terence zhang 3:a280069151ac 148 // communication layer
terence zhang 3:a280069151ac 149 #ifdef LWM2M_CLIENT_MODE
terencez 14:ec9e195830ff 150
terence zhang 3:a280069151ac 151 // Returns a session handle that MUST uniquely identify a peer.
terence zhang 3:a280069151ac 152 // secObjInstID: ID of the Securty Object instance to open a connection to
terence zhang 3:a280069151ac 153 // userData: parameter to lwm2m_init()
terence zhang 3:a280069151ac 154 void * lwm2m_connect_server(uint16_t secObjInstID, void * userData);
terence zhang 3:a280069151ac 155 // Close a session created by lwm2m_connect_server()
terence zhang 3:a280069151ac 156 // sessionH: session handle identifying the peer (opaque to the core)
terence zhang 3:a280069151ac 157 // userData: parameter to lwm2m_init()
terence zhang 3:a280069151ac 158 void lwm2m_close_connection(void * sessionH, void * userData);
terence zhang 3:a280069151ac 159 #endif
terence zhang 3:a280069151ac 160 // Send data to a peer
terence zhang 3:a280069151ac 161 // Returns COAP_NO_ERROR or a COAP_NNN error code
terence zhang 3:a280069151ac 162 // sessionH: session handle identifying the peer (opaque to the core)
terence zhang 3:a280069151ac 163 // buffer, length: data to send
terence zhang 3:a280069151ac 164 // userData: parameter to lwm2m_init()
terencez 14:ec9e195830ff 165 coap_status_t lwm2m_buffer_send(void * sessionH, uint8_t * buffer, size_t length, void * userData);
terence zhang 3:a280069151ac 166 // Compare two session handles
terence zhang 3:a280069151ac 167 // Returns true if the two sessions identify the same peer. false otherwise.
terence zhang 3:a280069151ac 168 // userData: parameter to lwm2m_init()
terence zhang 3:a280069151ac 169 bool lwm2m_session_is_equal(void * session1, void * session2, void * userData);
terence zhang 3:a280069151ac 170
terencez 0:f9d13e09cf11 171 /*
terencez 0:f9d13e09cf11 172 * Error code
terencez 0:f9d13e09cf11 173 */
terencez 0:f9d13e09cf11 174
terencez 11:1fadb70654a6 175 #ifdef MBED_OS_EXAMPLE_WAKAAMA
terencez 11:1fadb70654a6 176 //Prefer to use the orignal enum from the coap stack, remove warnings.
terencez 11:1fadb70654a6 177 #define COAP_NO_ERROR NO_ERROR//(uint8_t)0x00
terencez 11:1fadb70654a6 178 #define COAP_IGNORE (uint8_t)0x01
terencez 11:1fadb70654a6 179
terencez 11:1fadb70654a6 180 #define COAP_201_CREATED CREATED_2_01//(uint8_t)0x41
terencez 11:1fadb70654a6 181 #define COAP_202_DELETED DELETED_2_02//(uint8_t)0x42
terencez 11:1fadb70654a6 182
terencez 11:1fadb70654a6 183 #define COAP_204_CHANGED CHANGED_2_04//(uint8_t)0x44
terencez 11:1fadb70654a6 184 #define COAP_205_CONTENT CONTENT_2_05//(uint8_t)0x45
terencez 11:1fadb70654a6 185 #define COAP_231_CONTINUE (uint8_t)0x5F
terencez 11:1fadb70654a6 186
terencez 11:1fadb70654a6 187 #define COAP_400_BAD_REQUEST BAD_REQUEST_4_00//(uint8_t)0x80
terencez 11:1fadb70654a6 188 #define COAP_401_UNAUTHORIZED UNAUTHORIZED_4_01//(uint8_t)0x81
terencez 11:1fadb70654a6 189 #define COAP_402_BAD_OPTION BAD_OPTION_4_02//(uint8_t)0x82
terencez 11:1fadb70654a6 190 #define COAP_404_NOT_FOUND NOT_FOUND_4_04//(uint8_t)0x84
terencez 11:1fadb70654a6 191 #define COAP_405_METHOD_NOT_ALLOWED METHOD_NOT_ALLOWED_4_05//(uint8_t)0x85
terencez 11:1fadb70654a6 192 #define COAP_406_NOT_ACCEPTABLE NOT_ACCEPTABLE_4_06//(uint8_t)0x86
terencez 11:1fadb70654a6 193 #define COAP_408_REQ_ENTITY_INCOMPLETE (uint8_t)0x88
terencez 11:1fadb70654a6 194 #define COAP_412_PRECONDITION_FAILED PRECONDITION_FAILED_4_12//(uint8_t)0x8C
terencez 11:1fadb70654a6 195 #define COAP_413_ENTITY_TOO_LARGE REQUEST_ENTITY_TOO_LARGE_4_13//(uint8_t)0x8D
terencez 11:1fadb70654a6 196 #define COAP_500_INTERNAL_SERVER_ERROR INTERNAL_SERVER_ERROR_5_00//(uint8_t)0xA0
terencez 11:1fadb70654a6 197 #define COAP_501_NOT_IMPLEMENTED NOT_IMPLEMENTED_5_01//(uint8_t)0xA1
terencez 11:1fadb70654a6 198 #define COAP_503_SERVICE_UNAVAILABLE SERVICE_UNAVAILABLE_5_03//(uint8_t)0xA3
terencez 11:1fadb70654a6 199 #else
terencez 0:f9d13e09cf11 200 #define COAP_NO_ERROR (uint8_t)0x00
terence zhang 3:a280069151ac 201 #define COAP_IGNORE (uint8_t)0x01
terencez 0:f9d13e09cf11 202
terencez 0:f9d13e09cf11 203 #define COAP_201_CREATED (uint8_t)0x41
terencez 0:f9d13e09cf11 204 #define COAP_202_DELETED (uint8_t)0x42
terencez 11:1fadb70654a6 205
terencez 0:f9d13e09cf11 206 #define COAP_204_CHANGED (uint8_t)0x44
terencez 0:f9d13e09cf11 207 #define COAP_205_CONTENT (uint8_t)0x45
terencez 11:1fadb70654a6 208
terence zhang 3:a280069151ac 209 #define COAP_231_CONTINUE (uint8_t)0x5F
terencez 0:f9d13e09cf11 210 #define COAP_400_BAD_REQUEST (uint8_t)0x80
terencez 0:f9d13e09cf11 211 #define COAP_401_UNAUTHORIZED (uint8_t)0x81
terence zhang 3:a280069151ac 212 #define COAP_402_BAD_OPTION (uint8_t)0x82
terencez 0:f9d13e09cf11 213 #define COAP_404_NOT_FOUND (uint8_t)0x84
terencez 0:f9d13e09cf11 214 #define COAP_405_METHOD_NOT_ALLOWED (uint8_t)0x85
terencez 0:f9d13e09cf11 215 #define COAP_406_NOT_ACCEPTABLE (uint8_t)0x86
terence zhang 3:a280069151ac 216 #define COAP_408_REQ_ENTITY_INCOMPLETE (uint8_t)0x88
terence zhang 3:a280069151ac 217 #define COAP_412_PRECONDITION_FAILED (uint8_t)0x8C
terence zhang 3:a280069151ac 218 #define COAP_413_ENTITY_TOO_LARGE (uint8_t)0x8D
terencez 0:f9d13e09cf11 219 #define COAP_500_INTERNAL_SERVER_ERROR (uint8_t)0xA0
terencez 0:f9d13e09cf11 220 #define COAP_501_NOT_IMPLEMENTED (uint8_t)0xA1
terencez 0:f9d13e09cf11 221 #define COAP_503_SERVICE_UNAVAILABLE (uint8_t)0xA3
terencez 11:1fadb70654a6 222 #endif
terencez 0:f9d13e09cf11 223
terence zhang 3:a280069151ac 224 /*
terence zhang 3:a280069151ac 225 * Standard Object IDs
terence zhang 3:a280069151ac 226 */
terence zhang 3:a280069151ac 227 #define LWM2M_SECURITY_OBJECT_ID 0
terence zhang 3:a280069151ac 228 #define LWM2M_SERVER_OBJECT_ID 1
terence zhang 3:a280069151ac 229 #define LWM2M_ACL_OBJECT_ID 2
terence zhang 3:a280069151ac 230 #define LWM2M_DEVICE_OBJECT_ID 3
terence zhang 3:a280069151ac 231 #define LWM2M_CONN_MONITOR_OBJECT_ID 4
terence zhang 3:a280069151ac 232 #define LWM2M_FIRMWARE_UPDATE_OBJECT_ID 5
terence zhang 3:a280069151ac 233 #define LWM2M_LOCATION_OBJECT_ID 6
terence zhang 3:a280069151ac 234 #define LWM2M_CONN_STATS_OBJECT_ID 7
terence zhang 3:a280069151ac 235
terence zhang 3:a280069151ac 236 /*
terence zhang 3:a280069151ac 237 * Ressource IDs for the LWM2M Security Object
terence zhang 3:a280069151ac 238 */
terence zhang 3:a280069151ac 239 #define LWM2M_SECURITY_URI_ID 0
terence zhang 3:a280069151ac 240 #define LWM2M_SECURITY_BOOTSTRAP_ID 1
terence zhang 3:a280069151ac 241 #define LWM2M_SECURITY_SECURITY_ID 2
terence zhang 3:a280069151ac 242 #define LWM2M_SECURITY_PUBLIC_KEY_ID 3
terence zhang 3:a280069151ac 243 #define LWM2M_SECURITY_SERVER_PUBLIC_KEY_ID 4
terence zhang 3:a280069151ac 244 #define LWM2M_SECURITY_SECRET_KEY_ID 5
terence zhang 3:a280069151ac 245 #define LWM2M_SECURITY_SMS_SECURITY_ID 6
terence zhang 3:a280069151ac 246 #define LWM2M_SECURITY_SMS_KEY_PARAM_ID 7
terence zhang 3:a280069151ac 247 #define LWM2M_SECURITY_SMS_SECRET_KEY_ID 8
terence zhang 3:a280069151ac 248 #define LWM2M_SECURITY_SMS_SERVER_NUMBER_ID 9
terence zhang 3:a280069151ac 249 #define LWM2M_SECURITY_SHORT_SERVER_ID 10
terence zhang 3:a280069151ac 250 #define LWM2M_SECURITY_HOLD_OFF_ID 11
terence zhang 3:a280069151ac 251 #define LWM2M_SECURITY_BOOTSTRAP_TIMEOUT_ID 12
terence zhang 3:a280069151ac 252
terence zhang 3:a280069151ac 253 /*
terence zhang 3:a280069151ac 254 * Ressource IDs for the LWM2M Server Object
terence zhang 3:a280069151ac 255 */
terence zhang 3:a280069151ac 256 #define LWM2M_SERVER_SHORT_ID_ID 0
terence zhang 3:a280069151ac 257 #define LWM2M_SERVER_LIFETIME_ID 1
terence zhang 3:a280069151ac 258 #define LWM2M_SERVER_MIN_PERIOD_ID 2
terence zhang 3:a280069151ac 259 #define LWM2M_SERVER_MAX_PERIOD_ID 3
terence zhang 3:a280069151ac 260 #define LWM2M_SERVER_DISABLE_ID 4
terence zhang 3:a280069151ac 261 #define LWM2M_SERVER_TIMEOUT_ID 5
terence zhang 3:a280069151ac 262 #define LWM2M_SERVER_STORING_ID 6
terence zhang 3:a280069151ac 263 #define LWM2M_SERVER_BINDING_ID 7
terence zhang 3:a280069151ac 264 #define LWM2M_SERVER_UPDATE_ID 8
terence zhang 3:a280069151ac 265
terence zhang 3:a280069151ac 266 #define LWM2M_SECURITY_MODE_PRE_SHARED_KEY 0
terence zhang 3:a280069151ac 267 #define LWM2M_SECURITY_MODE_RAW_PUBLIC_KEY 1
terence zhang 3:a280069151ac 268 #define LWM2M_SECURITY_MODE_CERTIFICATE 2
terence zhang 3:a280069151ac 269 #define LWM2M_SECURITY_MODE_NONE 3
terence zhang 3:a280069151ac 270
terencez 0:f9d13e09cf11 271
terencez 0:f9d13e09cf11 272 /*
terencez 0:f9d13e09cf11 273 * Utility functions for sorted linked list
terencez 0:f9d13e09cf11 274 */
terencez 0:f9d13e09cf11 275
terencez 0:f9d13e09cf11 276 typedef struct _lwm2m_list_t
terencez 0:f9d13e09cf11 277 {
terencez 0:f9d13e09cf11 278 struct _lwm2m_list_t * next;
terencez 0:f9d13e09cf11 279 uint16_t id;
terencez 0:f9d13e09cf11 280 } lwm2m_list_t;
terencez 0:f9d13e09cf11 281
terencez 0:f9d13e09cf11 282 // defined in list.c
terencez 0:f9d13e09cf11 283 // Add 'node' to the list 'head' and return the new list
terencez 0:f9d13e09cf11 284 lwm2m_list_t * lwm2m_list_add(lwm2m_list_t * head, lwm2m_list_t * node);
terencez 0:f9d13e09cf11 285 // Return the node with ID 'id' from the list 'head' or NULL if not found
terencez 0:f9d13e09cf11 286 lwm2m_list_t * lwm2m_list_find(lwm2m_list_t * head, uint16_t id);
terencez 0:f9d13e09cf11 287 // Remove the node with ID 'id' from the list 'head' and return the new list
terencez 0:f9d13e09cf11 288 lwm2m_list_t * lwm2m_list_remove(lwm2m_list_t * head, uint16_t id, lwm2m_list_t ** nodeP);
terencez 0:f9d13e09cf11 289 // Return the lowest unused ID in the list 'head'
terencez 0:f9d13e09cf11 290 uint16_t lwm2m_list_newId(lwm2m_list_t * head);
terence zhang 3:a280069151ac 291 // Free a list. Do not use if nodes contain allocated pointers as it calls lwm2m_free on nodes only.
terence zhang 3:a280069151ac 292 // If the nodes of the list need to do more than just "free()" their instances, don't use lwm2m_list_free().
terence zhang 3:a280069151ac 293 void lwm2m_list_free(lwm2m_list_t * head);
terencez 0:f9d13e09cf11 294
terencez 0:f9d13e09cf11 295 #define LWM2M_LIST_ADD(H,N) lwm2m_list_add((lwm2m_list_t *)H, (lwm2m_list_t *)N);
terencez 0:f9d13e09cf11 296 #define LWM2M_LIST_RM(H,I,N) lwm2m_list_remove((lwm2m_list_t *)H, I, (lwm2m_list_t **)N);
terence zhang 3:a280069151ac 297 #define LWM2M_LIST_FIND(H,I) lwm2m_list_find((lwm2m_list_t *)H, I)
terence zhang 3:a280069151ac 298 #define LWM2M_LIST_FREE(H) lwm2m_list_free((lwm2m_list_t *)H)
terencez 0:f9d13e09cf11 299
terencez 0:f9d13e09cf11 300 /*
terencez 0:f9d13e09cf11 301 * URI
terencez 0:f9d13e09cf11 302 *
terencez 0:f9d13e09cf11 303 * objectId is always set
terence zhang 3:a280069151ac 304 * instanceId or resourceId are set according to the flag bit-field
terencez 0:f9d13e09cf11 305 *
terencez 0:f9d13e09cf11 306 */
terencez 0:f9d13e09cf11 307
terencez 0:f9d13e09cf11 308 #define LWM2M_MAX_ID ((uint16_t)0xFFFF)
terencez 0:f9d13e09cf11 309
terencez 0:f9d13e09cf11 310 #define LWM2M_URI_FLAG_OBJECT_ID (uint8_t)0x04
terencez 0:f9d13e09cf11 311 #define LWM2M_URI_FLAG_INSTANCE_ID (uint8_t)0x02
terencez 0:f9d13e09cf11 312 #define LWM2M_URI_FLAG_RESOURCE_ID (uint8_t)0x01
terencez 0:f9d13e09cf11 313
terence zhang 3:a280069151ac 314 #define LWM2M_URI_IS_SET_INSTANCE(uri) (((uri)->flag & LWM2M_URI_FLAG_INSTANCE_ID) != 0)
terence zhang 3:a280069151ac 315 #define LWM2M_URI_IS_SET_RESOURCE(uri) (((uri)->flag & LWM2M_URI_FLAG_RESOURCE_ID) != 0)
terencez 0:f9d13e09cf11 316
terencez 0:f9d13e09cf11 317 typedef struct
terencez 0:f9d13e09cf11 318 {
terencez 0:f9d13e09cf11 319 uint8_t flag; // indicates which segments are set
terencez 0:f9d13e09cf11 320 uint16_t objectId;
terencez 0:f9d13e09cf11 321 uint16_t instanceId;
terencez 0:f9d13e09cf11 322 uint16_t resourceId;
terencez 0:f9d13e09cf11 323 } lwm2m_uri_t;
terencez 0:f9d13e09cf11 324
terencez 0:f9d13e09cf11 325
terencez 0:f9d13e09cf11 326 #define LWM2M_STRING_ID_MAX_LEN 6
terencez 0:f9d13e09cf11 327
terencez 0:f9d13e09cf11 328 // Parse an URI in LWM2M format and fill the lwm2m_uri_t.
terencez 0:f9d13e09cf11 329 // Return the number of characters read from buffer or 0 in case of error.
terencez 0:f9d13e09cf11 330 // Valid URIs: /1, /1/, /1/2, /1/2/, /1/2/3
terencez 0:f9d13e09cf11 331 // Invalid URIs: /, //, //2, /1//, /1//3, /1/2/3/, /1/2/3/4
terence zhang 3:a280069151ac 332 int lwm2m_stringToUri(const char * buffer, size_t buffer_len, lwm2m_uri_t * uriP);
terence zhang 3:a280069151ac 333
terence zhang 3:a280069151ac 334 /*
terence zhang 3:a280069151ac 335 * The lwm2m_data_t is used to store LWM2M resource values in a hierarchical way.
terence zhang 3:a280069151ac 336 * Depending on the type the value is different:
terence zhang 3:a280069151ac 337 * - LWM2M_TYPE_OBJECT, LWM2M_TYPE_OBJECT_INSTANCE, LWM2M_TYPE_MULTIPLE_RESOURCE: value.asChildren
terence zhang 3:a280069151ac 338 * - LWM2M_TYPE_STRING, LWM2M_TYPE_OPAQUE: value.asBuffer
terence zhang 3:a280069151ac 339 * - LWM2M_TYPE_INTEGER, LWM2M_TYPE_TIME: value.asInteger
terence zhang 3:a280069151ac 340 * - LWM2M_TYPE_FLOAT: value.asFloat
terence zhang 3:a280069151ac 341 * - LWM2M_TYPE_BOOLEAN: value.asBoolean
terence zhang 3:a280069151ac 342 *
terence zhang 3:a280069151ac 343 * LWM2M_TYPE_STRING is also used when the data is in text format.
terence zhang 3:a280069151ac 344 */
terence zhang 3:a280069151ac 345
terence zhang 3:a280069151ac 346 typedef enum
terence zhang 3:a280069151ac 347 {
terence zhang 3:a280069151ac 348 LWM2M_TYPE_UNDEFINED = 0,
terence zhang 3:a280069151ac 349 LWM2M_TYPE_OBJECT,
terence zhang 3:a280069151ac 350 LWM2M_TYPE_OBJECT_INSTANCE,
terence zhang 3:a280069151ac 351 LWM2M_TYPE_MULTIPLE_RESOURCE,
terence zhang 3:a280069151ac 352
terence zhang 3:a280069151ac 353 LWM2M_TYPE_STRING,
terence zhang 3:a280069151ac 354 LWM2M_TYPE_OPAQUE,
terence zhang 3:a280069151ac 355 LWM2M_TYPE_INTEGER,
terence zhang 3:a280069151ac 356 LWM2M_TYPE_FLOAT,
terence zhang 3:a280069151ac 357 LWM2M_TYPE_BOOLEAN,
terence zhang 3:a280069151ac 358
terence zhang 3:a280069151ac 359 LWM2M_TYPE_OBJECT_LINK
terence zhang 3:a280069151ac 360 } lwm2m_data_type_t;
terence zhang 3:a280069151ac 361
terence zhang 3:a280069151ac 362 typedef struct _lwm2m_data_t lwm2m_data_t;
terence zhang 3:a280069151ac 363
terence zhang 3:a280069151ac 364 struct _lwm2m_data_t
terence zhang 3:a280069151ac 365 {
terence zhang 3:a280069151ac 366 lwm2m_data_type_t type;
terence zhang 3:a280069151ac 367 uint16_t id;
terence zhang 3:a280069151ac 368 union
terence zhang 3:a280069151ac 369 {
terence zhang 3:a280069151ac 370 bool asBoolean;
terence zhang 3:a280069151ac 371 int64_t asInteger;
terence zhang 3:a280069151ac 372 double asFloat;
terence zhang 3:a280069151ac 373 struct
terence zhang 3:a280069151ac 374 {
terence zhang 3:a280069151ac 375 size_t length;
terence zhang 3:a280069151ac 376 uint8_t * buffer;
terence zhang 3:a280069151ac 377 } asBuffer;
terence zhang 3:a280069151ac 378 struct
terence zhang 3:a280069151ac 379 {
terence zhang 3:a280069151ac 380 size_t count;
terence zhang 3:a280069151ac 381 lwm2m_data_t * array;
terence zhang 3:a280069151ac 382 } asChildren;
terence zhang 3:a280069151ac 383 struct
terence zhang 3:a280069151ac 384 {
terence zhang 3:a280069151ac 385 uint16_t objectId;
terence zhang 3:a280069151ac 386 uint16_t objectInstanceId;
terence zhang 3:a280069151ac 387 } asObjLink;
terence zhang 3:a280069151ac 388 } value;
terence zhang 3:a280069151ac 389 };
terence zhang 3:a280069151ac 390
terence zhang 3:a280069151ac 391 typedef enum
terence zhang 3:a280069151ac 392 {
terence zhang 3:a280069151ac 393 LWM2M_CONTENT_TEXT = 0, // Also used as undefined
terence zhang 3:a280069151ac 394 LWM2M_CONTENT_LINK = 40,
terence zhang 3:a280069151ac 395 LWM2M_CONTENT_OPAQUE = 42,
terence zhang 3:a280069151ac 396 LWM2M_CONTENT_TLV_OLD = 1542, // Keep old value for backward-compatibility
terence zhang 3:a280069151ac 397 LWM2M_CONTENT_TLV = 11542,
terence zhang 3:a280069151ac 398 LWM2M_CONTENT_JSON_OLD = 1543, // Keep old value for backward-compatibility
terence zhang 3:a280069151ac 399 LWM2M_CONTENT_JSON = 11543
terence zhang 3:a280069151ac 400 } lwm2m_media_type_t;
terence zhang 3:a280069151ac 401
terence zhang 3:a280069151ac 402 lwm2m_data_t * lwm2m_data_new(int size);
terence zhang 3:a280069151ac 403 int lwm2m_data_parse(lwm2m_uri_t * uriP, uint8_t * buffer, size_t bufferLen, lwm2m_media_type_t format, lwm2m_data_t ** dataP);
terence zhang 3:a280069151ac 404 int lwm2m_data_serialize(lwm2m_uri_t * uriP, int size, lwm2m_data_t * dataP, lwm2m_media_type_t * formatP, uint8_t ** bufferP);
terence zhang 3:a280069151ac 405 void lwm2m_data_free(int size, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 406
terence zhang 3:a280069151ac 407 void lwm2m_data_encode_string(const char * string, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 408 void lwm2m_data_encode_nstring(const char * string, size_t length, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 409 void lwm2m_data_encode_opaque(uint8_t * buffer, size_t length, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 410 void lwm2m_data_encode_int(int64_t value, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 411 int lwm2m_data_decode_int(const lwm2m_data_t * dataP, int64_t * valueP);
terence zhang 3:a280069151ac 412 void lwm2m_data_encode_float(double value, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 413 int lwm2m_data_decode_float(const lwm2m_data_t * dataP, double * valueP);
terence zhang 3:a280069151ac 414 void lwm2m_data_encode_bool(bool value, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 415 int lwm2m_data_decode_bool(const lwm2m_data_t * dataP, bool * valueP);
terence zhang 3:a280069151ac 416 void lwm2m_data_encode_objlink(uint16_t objectId, uint16_t objectInstanceId, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 417 void lwm2m_data_encode_instances(lwm2m_data_t * subDataP, size_t count, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 418 void lwm2m_data_include(lwm2m_data_t * subDataP, size_t count, lwm2m_data_t * dataP);
terence zhang 3:a280069151ac 419
terence zhang 3:a280069151ac 420
terence zhang 3:a280069151ac 421 /*
terence zhang 3:a280069151ac 422 * Utility function to parse TLV buffers directly
terence zhang 3:a280069151ac 423 *
terence zhang 3:a280069151ac 424 * Returned value: number of bytes parsed
terence zhang 3:a280069151ac 425 * buffer: buffer to parse
terence zhang 3:a280069151ac 426 * buffer_len: length in bytes of buffer
terence zhang 3:a280069151ac 427 * oType: (OUT) type of the parsed TLV record. can be:
terence zhang 3:a280069151ac 428 * - LWM2M_TYPE_OBJECT
terence zhang 3:a280069151ac 429 * - LWM2M_TYPE_OBJECT_INSTANCE
terence zhang 3:a280069151ac 430 * - LWM2M_TYPE_MULTIPLE_RESOURCE
terence zhang 3:a280069151ac 431 * - LWM2M_TYPE_OPAQUE
terence zhang 3:a280069151ac 432 * oID: (OUT) ID of the parsed TLV record
terence zhang 3:a280069151ac 433 * oDataIndex: (OUT) index of the data of the parsed TLV record in the buffer
terence zhang 3:a280069151ac 434 * oDataLen: (OUT) length of the data of the parsed TLV record
terence zhang 3:a280069151ac 435 */
terence zhang 3:a280069151ac 436
terence zhang 3:a280069151ac 437 #define LWM2M_TLV_HEADER_MAX_LENGTH 6
terence zhang 3:a280069151ac 438
terence zhang 3:a280069151ac 439 int lwm2m_decode_TLV(const uint8_t * buffer, size_t buffer_len, lwm2m_data_type_t * oType, uint16_t * oID, size_t * oDataIndex, size_t * oDataLen);
terencez 0:f9d13e09cf11 440
terencez 0:f9d13e09cf11 441
terencez 0:f9d13e09cf11 442 /*
terencez 0:f9d13e09cf11 443 * LWM2M Objects
terencez 0:f9d13e09cf11 444 *
terencez 0:f9d13e09cf11 445 * For the read callback, if *numDataP is not zero, *dataArrayP is pre-allocated
terencez 0:f9d13e09cf11 446 * and contains the list of resources to read.
terencez 0:f9d13e09cf11 447 *
terencez 0:f9d13e09cf11 448 */
terencez 0:f9d13e09cf11 449
terencez 0:f9d13e09cf11 450 typedef struct _lwm2m_object_t lwm2m_object_t;
terencez 0:f9d13e09cf11 451
terence zhang 3:a280069151ac 452 typedef uint8_t (*lwm2m_read_callback_t) (uint16_t instanceId, int * numDataP, lwm2m_data_t ** dataArrayP, lwm2m_object_t * objectP);
terence zhang 3:a280069151ac 453 typedef uint8_t (*lwm2m_discover_callback_t) (uint16_t instanceId, int * numDataP, lwm2m_data_t ** dataArrayP, lwm2m_object_t * objectP);
terence zhang 3:a280069151ac 454 typedef uint8_t (*lwm2m_write_callback_t) (uint16_t instanceId, int numData, lwm2m_data_t * dataArray, lwm2m_object_t * objectP);
terence zhang 3:a280069151ac 455 typedef uint8_t (*lwm2m_execute_callback_t) (uint16_t instanceId, uint16_t resourceId, uint8_t * buffer, int length, lwm2m_object_t * objectP);
terence zhang 3:a280069151ac 456 typedef uint8_t (*lwm2m_create_callback_t) (uint16_t instanceId, int numData, lwm2m_data_t * dataArray, lwm2m_object_t * objectP);
terencez 0:f9d13e09cf11 457 typedef uint8_t (*lwm2m_delete_callback_t) (uint16_t instanceId, lwm2m_object_t * objectP);
terencez 0:f9d13e09cf11 458
terencez 0:f9d13e09cf11 459 struct _lwm2m_object_t
terencez 0:f9d13e09cf11 460 {
terence zhang 3:a280069151ac 461 struct _lwm2m_object_t * next; // for internal use only.
terence zhang 3:a280069151ac 462 uint16_t objID;
terence zhang 3:a280069151ac 463 lwm2m_list_t * instanceList;
terence zhang 3:a280069151ac 464 lwm2m_read_callback_t readFunc;
terence zhang 3:a280069151ac 465 lwm2m_write_callback_t writeFunc;
terence zhang 3:a280069151ac 466 lwm2m_execute_callback_t executeFunc;
terence zhang 3:a280069151ac 467 lwm2m_create_callback_t createFunc;
terence zhang 3:a280069151ac 468 lwm2m_delete_callback_t deleteFunc;
terence zhang 3:a280069151ac 469 lwm2m_discover_callback_t discoverFunc;
terence zhang 3:a280069151ac 470 void * userData;
terencez 0:f9d13e09cf11 471 };
terencez 0:f9d13e09cf11 472
terencez 0:f9d13e09cf11 473 /*
terencez 0:f9d13e09cf11 474 * LWM2M Servers
terencez 0:f9d13e09cf11 475 *
terencez 0:f9d13e09cf11 476 * Since LWM2M Server Object instances are not accessible to LWM2M servers,
terencez 0:f9d13e09cf11 477 * there is no need to store them as lwm2m_objects_t
terencez 0:f9d13e09cf11 478 */
terencez 0:f9d13e09cf11 479
terencez 0:f9d13e09cf11 480 typedef enum
terencez 0:f9d13e09cf11 481 {
terence zhang 3:a280069151ac 482 STATE_DEREGISTERED = 0, // not registered or boostrap not started
terence zhang 3:a280069151ac 483 STATE_REG_PENDING, // registration pending
terence zhang 3:a280069151ac 484 STATE_REGISTERED, // successfully registered
terence zhang 3:a280069151ac 485 STATE_REG_FAILED, // last registration failed
terence zhang 3:a280069151ac 486 STATE_REG_UPDATE_PENDING, // registration update pending
terence zhang 3:a280069151ac 487 STATE_REG_UPDATE_NEEDED, // registration update required
terence zhang 3:a280069151ac 488 STATE_REG_FULL_UPDATE_NEEDED, // registration update with objects required
terence zhang 3:a280069151ac 489 STATE_DEREG_PENDING, // deregistration pending
terence zhang 3:a280069151ac 490 STATE_BS_HOLD_OFF, // bootstrap hold off time
terence zhang 3:a280069151ac 491 STATE_BS_INITIATED, // bootstrap request sent
terence zhang 3:a280069151ac 492 STATE_BS_PENDING, // boostrap ongoing
terence zhang 3:a280069151ac 493 STATE_BS_FINISHING, // boostrap finish received
terence zhang 3:a280069151ac 494 STATE_BS_FINISHED, // bootstrap done
terence zhang 3:a280069151ac 495 STATE_BS_FAILING, // bootstrap error occurred
terence zhang 3:a280069151ac 496 STATE_BS_FAILED, // bootstrap failed
terencez 0:f9d13e09cf11 497 } lwm2m_status_t;
terencez 0:f9d13e09cf11 498
terencez 0:f9d13e09cf11 499 typedef enum
terencez 0:f9d13e09cf11 500 {
terencez 0:f9d13e09cf11 501 BINDING_UNKNOWN = 0,
terencez 0:f9d13e09cf11 502 BINDING_U, // UDP
terencez 0:f9d13e09cf11 503 BINDING_UQ, // UDP queue mode
terencez 0:f9d13e09cf11 504 BINDING_S, // SMS
terencez 0:f9d13e09cf11 505 BINDING_SQ, // SMS queue mode
terencez 0:f9d13e09cf11 506 BINDING_US, // UDP plus SMS
terencez 0:f9d13e09cf11 507 BINDING_UQS // UDP queue mode plus SMS
terencez 0:f9d13e09cf11 508 } lwm2m_binding_t;
terencez 0:f9d13e09cf11 509
terence zhang 3:a280069151ac 510 /*
terence zhang 3:a280069151ac 511 * LWM2M block1 data
terence zhang 3:a280069151ac 512 *
terence zhang 3:a280069151ac 513 * Temporary data needed to handle block1 request.
terence zhang 3:a280069151ac 514 * Currently support only one block1 request by server.
terence zhang 3:a280069151ac 515 */
terence zhang 3:a280069151ac 516 typedef struct _lwm2m_block1_data_ lwm2m_block1_data_t;
terence zhang 3:a280069151ac 517
terence zhang 3:a280069151ac 518 struct _lwm2m_block1_data_
terence zhang 3:a280069151ac 519 {
terence zhang 3:a280069151ac 520 uint8_t * block1buffer; // data buffer
terence zhang 3:a280069151ac 521 size_t block1bufferSize; // buffer size
terence zhang 3:a280069151ac 522 uint16_t lastmid; // mid of the last message received
terence zhang 3:a280069151ac 523 };
terence zhang 3:a280069151ac 524
terencez 14:ec9e195830ff 525 /*
terencez 14:ec9e195830ff 526 * LWM2M Servers
terencez 14:ec9e195830ff 527 *
terencez 14:ec9e195830ff 528 * Since LWM2M Server Object instances are not accessible to LWM2M servers,
terencez 14:ec9e195830ff 529 * there is no need to store them as lwm2m_objects_t
terencez 14:ec9e195830ff 530 */
terencez 14:ec9e195830ff 531
terencez 14:ec9e195830ff 532 typedef enum
terencez 14:ec9e195830ff 533 {
terencez 14:ec9e195830ff 534 SEC_NONE = 0,
terencez 14:ec9e195830ff 535 SEC_PRE_SHARED_KEY,
terencez 14:ec9e195830ff 536 SEC_RAW_PUBLIC_KEY,
terencez 14:ec9e195830ff 537 SEC_CERTIFICATE
terencez 14:ec9e195830ff 538 } lwm2m_security_mode_t;
terencez 14:ec9e195830ff 539
terencez 14:ec9e195830ff 540 typedef struct
terencez 14:ec9e195830ff 541 {
terencez 14:ec9e195830ff 542 lwm2m_security_mode_t mode;
terencez 14:ec9e195830ff 543 size_t publicKeyLength;
terencez 14:ec9e195830ff 544 uint8_t * publicKey;
terencez 14:ec9e195830ff 545 size_t privateKeyLength;
terencez 14:ec9e195830ff 546 uint8_t * privateKey;
terencez 14:ec9e195830ff 547 } lwm2m_security_t;
terencez 14:ec9e195830ff 548
terencez 14:ec9e195830ff 549
terencez 14:ec9e195830ff 550
terencez 0:f9d13e09cf11 551 typedef struct _lwm2m_server_
terencez 0:f9d13e09cf11 552 {
terence zhang 3:a280069151ac 553 struct _lwm2m_server_ * next; // matches lwm2m_list_t::next
terence zhang 3:a280069151ac 554 uint16_t secObjInstID; // matches lwm2m_list_t::id
terence zhang 3:a280069151ac 555 uint16_t shortID; // servers short ID, may be 0 for bootstrap server
terence zhang 3:a280069151ac 556 time_t lifetime; // lifetime of the registration in sec or 0 if default value (86400 sec), also used as hold off time for bootstrap servers
terence zhang 3:a280069151ac 557 time_t registration; // date of the last registration in sec or end of client hold off time for bootstrap servers
terence zhang 3:a280069151ac 558 lwm2m_binding_t binding; // client connection mode with this server
terence zhang 3:a280069151ac 559 void * sessionH;
terence zhang 3:a280069151ac 560 lwm2m_status_t status;
terence zhang 3:a280069151ac 561 char * location;
terence zhang 3:a280069151ac 562 bool dirty;
terence zhang 3:a280069151ac 563 lwm2m_block1_data_t * block1Data; // buffer to handle block1 data, should be replace by a list to support several block1 transfer by server.
terencez 14:ec9e195830ff 564 lwm2m_security_t security;
terencez 14:ec9e195830ff 565 char * sms;
terencez 0:f9d13e09cf11 566 } lwm2m_server_t;
terencez 0:f9d13e09cf11 567
terencez 0:f9d13e09cf11 568
terencez 0:f9d13e09cf11 569 /*
terencez 0:f9d13e09cf11 570 * LWM2M result callback
terencez 0:f9d13e09cf11 571 *
terencez 0:f9d13e09cf11 572 * When used with an observe, if 'data' is not nil, 'status' holds the observe counter.
terencez 0:f9d13e09cf11 573 */
terence zhang 3:a280069151ac 574 typedef void (*lwm2m_result_callback_t) (uint16_t clientID, lwm2m_uri_t * uriP, int status, lwm2m_media_type_t format, uint8_t * data, int dataLength, void * userData);
terencez 0:f9d13e09cf11 575
terencez 0:f9d13e09cf11 576 /*
terencez 0:f9d13e09cf11 577 * LWM2M Observations
terencez 0:f9d13e09cf11 578 *
terencez 0:f9d13e09cf11 579 * Used to store observation of remote clients resources.
terencez 0:f9d13e09cf11 580 * status STATE_REG_PENDING means the observe request was sent to the client but not yet answered.
terencez 0:f9d13e09cf11 581 * status STATE_REGISTERED means the client acknowledged the observe request.
terence zhang 3:a280069151ac 582 * status STATE_DEREG_PENDING means the user canceled the request before the client answered it.
terencez 0:f9d13e09cf11 583 */
terencez 0:f9d13e09cf11 584
terencez 0:f9d13e09cf11 585 typedef struct _lwm2m_observation_
terencez 0:f9d13e09cf11 586 {
terencez 0:f9d13e09cf11 587 struct _lwm2m_observation_ * next; // matches lwm2m_list_t::next
terencez 0:f9d13e09cf11 588 uint16_t id; // matches lwm2m_list_t::id
terencez 0:f9d13e09cf11 589 struct _lwm2m_client_ * clientP;
terencez 0:f9d13e09cf11 590 lwm2m_uri_t uri;
terence zhang 3:a280069151ac 591 lwm2m_status_t status;
terencez 0:f9d13e09cf11 592 lwm2m_result_callback_t callback;
terencez 0:f9d13e09cf11 593 void * userData;
terencez 0:f9d13e09cf11 594 } lwm2m_observation_t;
terencez 0:f9d13e09cf11 595
terencez 0:f9d13e09cf11 596 /*
terence zhang 3:a280069151ac 597 * LWM2M Link Attributes
terence zhang 3:a280069151ac 598 *
terence zhang 3:a280069151ac 599 * Used for observation parameters.
terence zhang 3:a280069151ac 600 *
terence zhang 3:a280069151ac 601 */
terence zhang 3:a280069151ac 602
terence zhang 3:a280069151ac 603 #define LWM2M_ATTR_FLAG_MIN_PERIOD (uint8_t)0x01
terence zhang 3:a280069151ac 604 #define LWM2M_ATTR_FLAG_MAX_PERIOD (uint8_t)0x02
terence zhang 3:a280069151ac 605 #define LWM2M_ATTR_FLAG_GREATER_THAN (uint8_t)0x04
terence zhang 3:a280069151ac 606 #define LWM2M_ATTR_FLAG_LESS_THAN (uint8_t)0x08
terence zhang 3:a280069151ac 607 #define LWM2M_ATTR_FLAG_STEP (uint8_t)0x10
terence zhang 3:a280069151ac 608
terence zhang 3:a280069151ac 609 typedef struct
terence zhang 3:a280069151ac 610 {
terence zhang 3:a280069151ac 611 uint8_t toSet;
terence zhang 3:a280069151ac 612 uint8_t toClear;
terence zhang 3:a280069151ac 613 uint32_t minPeriod;
terence zhang 3:a280069151ac 614 uint32_t maxPeriod;
terence zhang 3:a280069151ac 615 double greaterThan;
terence zhang 3:a280069151ac 616 double lessThan;
terence zhang 3:a280069151ac 617 double step;
terence zhang 3:a280069151ac 618 } lwm2m_attributes_t;
terence zhang 3:a280069151ac 619
terence zhang 3:a280069151ac 620 /*
terencez 0:f9d13e09cf11 621 * LWM2M Clients
terencez 0:f9d13e09cf11 622 *
terencez 0:f9d13e09cf11 623 * Be careful not to mix lwm2m_client_object_t used to store list of objects of remote clients
terencez 0:f9d13e09cf11 624 * and lwm2m_object_t describing objects exposed to remote servers.
terencez 0:f9d13e09cf11 625 *
terencez 0:f9d13e09cf11 626 */
terencez 0:f9d13e09cf11 627
terencez 0:f9d13e09cf11 628 typedef struct _lwm2m_client_object_
terencez 0:f9d13e09cf11 629 {
terencez 0:f9d13e09cf11 630 struct _lwm2m_client_object_ * next; // matches lwm2m_list_t::next
terencez 0:f9d13e09cf11 631 uint16_t id; // matches lwm2m_list_t::id
terencez 0:f9d13e09cf11 632 lwm2m_list_t * instanceList;
terencez 0:f9d13e09cf11 633 } lwm2m_client_object_t;
terencez 0:f9d13e09cf11 634
terencez 0:f9d13e09cf11 635 typedef struct _lwm2m_client_
terencez 0:f9d13e09cf11 636 {
terencez 0:f9d13e09cf11 637 struct _lwm2m_client_ * next; // matches lwm2m_list_t::next
terencez 0:f9d13e09cf11 638 uint16_t internalID; // matches lwm2m_list_t::id
terencez 0:f9d13e09cf11 639 char * name;
terencez 0:f9d13e09cf11 640 lwm2m_binding_t binding;
terencez 0:f9d13e09cf11 641 char * msisdn;
terence zhang 3:a280069151ac 642 char * altPath;
terence zhang 3:a280069151ac 643 bool supportJSON;
terencez 0:f9d13e09cf11 644 uint32_t lifetime;
terencez 0:f9d13e09cf11 645 time_t endOfLife;
terencez 0:f9d13e09cf11 646 void * sessionH;
terencez 0:f9d13e09cf11 647 lwm2m_client_object_t * objectList;
terencez 0:f9d13e09cf11 648 lwm2m_observation_t * observationList;
terencez 0:f9d13e09cf11 649 } lwm2m_client_t;
terencez 0:f9d13e09cf11 650
terencez 0:f9d13e09cf11 651
terencez 0:f9d13e09cf11 652 /*
terencez 0:f9d13e09cf11 653 * LWM2M transaction
terencez 0:f9d13e09cf11 654 *
terencez 0:f9d13e09cf11 655 * Adaptation of Erbium's coap_transaction_t
terencez 0:f9d13e09cf11 656 */
terencez 0:f9d13e09cf11 657
terencez 0:f9d13e09cf11 658 typedef struct _lwm2m_transaction_ lwm2m_transaction_t;
terencez 0:f9d13e09cf11 659
terencez 0:f9d13e09cf11 660 typedef void (*lwm2m_transaction_callback_t) (lwm2m_transaction_t * transacP, void * message);
terencez 0:f9d13e09cf11 661
terencez 0:f9d13e09cf11 662 struct _lwm2m_transaction_
terencez 0:f9d13e09cf11 663 {
terencez 0:f9d13e09cf11 664 lwm2m_transaction_t * next; // matches lwm2m_list_t::next
terencez 0:f9d13e09cf11 665 uint16_t mID; // matches lwm2m_list_t::id
terence zhang 3:a280069151ac 666 void * peerH;
terence zhang 3:a280069151ac 667 uint8_t ack_received; // indicates, that the ACK was received
terence zhang 3:a280069151ac 668 time_t response_timeout; // timeout to wait for response, if token is used. When 0, use calculated acknowledge timeout.
terencez 0:f9d13e09cf11 669 uint8_t retrans_counter;
terencez 0:f9d13e09cf11 670 time_t retrans_time;
terencez 0:f9d13e09cf11 671 char objStringID[LWM2M_STRING_ID_MAX_LEN];
terencez 0:f9d13e09cf11 672 char instanceStringID[LWM2M_STRING_ID_MAX_LEN];
terencez 0:f9d13e09cf11 673 char resourceStringID[LWM2M_STRING_ID_MAX_LEN];
terencez 0:f9d13e09cf11 674 void * message;
terencez 0:f9d13e09cf11 675 uint16_t buffer_len;
terencez 0:f9d13e09cf11 676 uint8_t * buffer;
terencez 0:f9d13e09cf11 677 lwm2m_transaction_callback_t callback;
terencez 0:f9d13e09cf11 678 void * userData;
terencez 0:f9d13e09cf11 679 };
terencez 0:f9d13e09cf11 680
terencez 0:f9d13e09cf11 681 /*
terencez 0:f9d13e09cf11 682 * LWM2M observed resources
terencez 0:f9d13e09cf11 683 */
terencez 0:f9d13e09cf11 684 typedef struct _lwm2m_watcher_
terencez 0:f9d13e09cf11 685 {
terencez 0:f9d13e09cf11 686 struct _lwm2m_watcher_ * next;
terencez 0:f9d13e09cf11 687
terence zhang 3:a280069151ac 688 bool active;
terence zhang 3:a280069151ac 689 bool update;
terencez 0:f9d13e09cf11 690 lwm2m_server_t * server;
terence zhang 3:a280069151ac 691 lwm2m_attributes_t * parameters;
terencez 0:f9d13e09cf11 692 uint8_t token[8];
terencez 0:f9d13e09cf11 693 size_t tokenLen;
terence zhang 3:a280069151ac 694 time_t lastTime;
terencez 0:f9d13e09cf11 695 uint32_t counter;
terencez 0:f9d13e09cf11 696 uint16_t lastMid;
terence zhang 3:a280069151ac 697 union
terence zhang 3:a280069151ac 698 {
terence zhang 3:a280069151ac 699 int64_t asInteger;
terence zhang 3:a280069151ac 700 double asFloat;
terence zhang 3:a280069151ac 701 } lastValue;
terencez 0:f9d13e09cf11 702 } lwm2m_watcher_t;
terencez 0:f9d13e09cf11 703
terencez 0:f9d13e09cf11 704 typedef struct _lwm2m_observed_
terencez 0:f9d13e09cf11 705 {
terencez 0:f9d13e09cf11 706 struct _lwm2m_observed_ * next;
terencez 0:f9d13e09cf11 707
terencez 0:f9d13e09cf11 708 lwm2m_uri_t uri;
terencez 0:f9d13e09cf11 709 lwm2m_watcher_t * watcherList;
terencez 0:f9d13e09cf11 710 } lwm2m_observed_t;
terencez 0:f9d13e09cf11 711
terence zhang 3:a280069151ac 712 #ifdef LWM2M_CLIENT_MODE
terencez 0:f9d13e09cf11 713
terence zhang 3:a280069151ac 714 typedef enum
terence zhang 3:a280069151ac 715 {
terence zhang 3:a280069151ac 716 STATE_INITIAL = 0,
terence zhang 3:a280069151ac 717 STATE_BOOTSTRAP_REQUIRED,
terence zhang 3:a280069151ac 718 STATE_BOOTSTRAPPING,
terence zhang 3:a280069151ac 719 STATE_REGISTER_REQUIRED,
terence zhang 3:a280069151ac 720 STATE_REGISTERING,
terence zhang 3:a280069151ac 721 STATE_READY
terence zhang 3:a280069151ac 722 } lwm2m_client_state_t;
terence zhang 3:a280069151ac 723
terence zhang 3:a280069151ac 724 #endif
terencez 0:f9d13e09cf11 725 /*
terencez 0:f9d13e09cf11 726 * LWM2M Context
terencez 0:f9d13e09cf11 727 */
terencez 0:f9d13e09cf11 728
terence zhang 3:a280069151ac 729 #ifdef LWM2M_BOOTSTRAP_SERVER_MODE
terence zhang 3:a280069151ac 730 // In all the following APIs, the session handle MUST uniquely identify a peer.
terencez 0:f9d13e09cf11 731
terence zhang 3:a280069151ac 732 // LWM2M bootstrap callback
terence zhang 3:a280069151ac 733 // When a LWM2M client requests bootstrap information, the callback is called with status COAP_NO_ERROR, uriP is nil and
terence zhang 3:a280069151ac 734 // name is set. The callback must return a COAP_* error code. COAP_204_CHANGED for success.
terence zhang 3:a280069151ac 735 // After a lwm2m_bootstrap_delete() or a lwm2m_bootstrap_write(), the callback is called with the status returned by the
terence zhang 3:a280069151ac 736 // client, the URI of the operation (may be nil) and name is nil. The callback return value is ignored.
terence zhang 3:a280069151ac 737 typedef int (*lwm2m_bootstrap_callback_t) (void * sessionH, uint8_t status, lwm2m_uri_t * uriP, char * name, void * userData);
terence zhang 3:a280069151ac 738 #endif
terencez 0:f9d13e09cf11 739
terencez 0:f9d13e09cf11 740 typedef struct
terencez 0:f9d13e09cf11 741 {
terencez 0:f9d13e09cf11 742 #ifdef LWM2M_CLIENT_MODE
terence zhang 3:a280069151ac 743 lwm2m_client_state_t state;
terence zhang 3:a280069151ac 744 char * endpointName;
terence zhang 3:a280069151ac 745 char * msisdn;
terence zhang 3:a280069151ac 746 char * altPath;
terence zhang 3:a280069151ac 747 lwm2m_server_t * bootstrapServerList;
terence zhang 3:a280069151ac 748 lwm2m_server_t * serverList;
terence zhang 3:a280069151ac 749 lwm2m_object_t * objectList;
terence zhang 3:a280069151ac 750 lwm2m_observed_t * observedList;
terencez 0:f9d13e09cf11 751 #endif
terencez 0:f9d13e09cf11 752 #ifdef LWM2M_SERVER_MODE
terencez 0:f9d13e09cf11 753 lwm2m_client_t * clientList;
terencez 0:f9d13e09cf11 754 lwm2m_result_callback_t monitorCallback;
terencez 0:f9d13e09cf11 755 void * monitorUserData;
terencez 0:f9d13e09cf11 756 #endif
terence zhang 3:a280069151ac 757 #ifdef LWM2M_BOOTSTRAP_SERVER_MODE
terence zhang 3:a280069151ac 758 lwm2m_bootstrap_callback_t bootstrapCallback;
terence zhang 3:a280069151ac 759 void * bootstrapUserData;
terence zhang 3:a280069151ac 760 #endif
terence zhang 3:a280069151ac 761 uint16_t nextMID;
terence zhang 3:a280069151ac 762 lwm2m_transaction_t * transactionList;
terence zhang 3:a280069151ac 763 void * userData;
terencez 0:f9d13e09cf11 764 } lwm2m_context_t;
terencez 0:f9d13e09cf11 765
terencez 14:ec9e195830ff 766 #ifdef MBED_OS_EXAMPLE_WAKAAMA
terencez 14:ec9e195830ff 767 int lwm2m_add_server(lwm2m_context_t * contextP, uint16_t shortID, uint32_t lifetime, char * sms, lwm2m_binding_t binding, void * sessionH, lwm2m_security_t * securityP);
terencez 14:ec9e195830ff 768 #endif
terencez 0:f9d13e09cf11 769
terence zhang 3:a280069151ac 770 // initialize a liblwm2m context.
terence zhang 3:a280069151ac 771 lwm2m_context_t * lwm2m_init(void * userData);
terencez 0:f9d13e09cf11 772 // close a liblwm2m context.
terencez 0:f9d13e09cf11 773 void lwm2m_close(lwm2m_context_t * contextP);
terencez 0:f9d13e09cf11 774
terence zhang 3:a280069151ac 775 // perform any required pending operation and adjust timeoutP to the maximal time interval to wait in seconds.
terence zhang 3:a280069151ac 776 int lwm2m_step(lwm2m_context_t * contextP, time_t * timeoutP);
terencez 0:f9d13e09cf11 777 // dispatch received data to liblwm2m
terencez 0:f9d13e09cf11 778 void lwm2m_handle_packet(lwm2m_context_t * contextP, uint8_t * buffer, int length, void * fromSessionH);
terencez 0:f9d13e09cf11 779
terencez 0:f9d13e09cf11 780 #ifdef LWM2M_CLIENT_MODE
terence zhang 3:a280069151ac 781 // configure the client side with the Endpoint Name, binding, MSISDN (can be nil), alternative path
terence zhang 3:a280069151ac 782 // for objects (can be nil) and a list of objects.
terence zhang 3:a280069151ac 783 // LWM2M Security Object (ID 0) must be present with either a bootstrap server or a LWM2M server and
terence zhang 3:a280069151ac 784 // its matching LWM2M Server Object (ID 1) instance
terence zhang 3:a280069151ac 785 int lwm2m_configure(lwm2m_context_t * contextP, const char * endpointName, const char * msisdn, const char * altPath, uint16_t numObject, lwm2m_object_t * objectList[]);
terence zhang 3:a280069151ac 786 int lwm2m_add_object(lwm2m_context_t * contextP, lwm2m_object_t * objectP);
terence zhang 3:a280069151ac 787 int lwm2m_remove_object(lwm2m_context_t * contextP, uint16_t id);
terencez 0:f9d13e09cf11 788
terencez 0:f9d13e09cf11 789 // send a registration update to the server specified by the server short identifier
terence zhang 3:a280069151ac 790 // or all if the ID is 0.
terence zhang 3:a280069151ac 791 // If withObjects is true, the registration update contains the object list.
terence zhang 3:a280069151ac 792 int lwm2m_update_registration(lwm2m_context_t * contextP, uint16_t shortServerID, bool withObjects);
terencez 0:f9d13e09cf11 793
terencez 0:f9d13e09cf11 794 void lwm2m_resource_value_changed(lwm2m_context_t * contextP, lwm2m_uri_t * uriP);
terencez 0:f9d13e09cf11 795 #endif
terencez 0:f9d13e09cf11 796
terencez 0:f9d13e09cf11 797 #ifdef LWM2M_SERVER_MODE
terencez 0:f9d13e09cf11 798 // Clients registration/deregistration monitoring API.
terence zhang 3:a280069151ac 799 // When a LWM2M client registers, the callback is called with status COAP_201_CREATED.
terence zhang 3:a280069151ac 800 // When a LWM2M client deregisters, the callback is called with status COAP_202_DELETED.
terencez 0:f9d13e09cf11 801 // clientID is the internal ID of the LWM2M Client.
terencez 0:f9d13e09cf11 802 // The callback's parameters uri, data, dataLength are always NULL.
terencez 0:f9d13e09cf11 803 // The lwm2m_client_t is present in the lwm2m_context_t's clientList when the callback is called. On a deregistration, it deleted when the callback returns.
terencez 0:f9d13e09cf11 804 void lwm2m_set_monitoring_callback(lwm2m_context_t * contextP, lwm2m_result_callback_t callback, void * userData);
terencez 0:f9d13e09cf11 805
terencez 0:f9d13e09cf11 806 // Device Management APIs
terencez 0:f9d13e09cf11 807 int lwm2m_dm_read(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_result_callback_t callback, void * userData);
terence zhang 3:a280069151ac 808 int lwm2m_dm_discover(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_result_callback_t callback, void * userData);
terence zhang 3:a280069151ac 809 int lwm2m_dm_write(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_media_type_t format, uint8_t * buffer, int length, lwm2m_result_callback_t callback, void * userData);
terence zhang 3:a280069151ac 810 int lwm2m_dm_write_attributes(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_attributes_t * attrP, lwm2m_result_callback_t callback, void * userData);
terence zhang 3:a280069151ac 811 int lwm2m_dm_execute(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_media_type_t format, uint8_t * buffer, int length, lwm2m_result_callback_t callback, void * userData);
terence zhang 3:a280069151ac 812 int lwm2m_dm_create(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_media_type_t format, uint8_t * buffer, int length, lwm2m_result_callback_t callback, void * userData);
terencez 0:f9d13e09cf11 813 int lwm2m_dm_delete(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_result_callback_t callback, void * userData);
terencez 0:f9d13e09cf11 814
terencez 0:f9d13e09cf11 815 // Information Reporting APIs
terencez 0:f9d13e09cf11 816 int lwm2m_observe(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_result_callback_t callback, void * userData);
terencez 0:f9d13e09cf11 817 int lwm2m_observe_cancel(lwm2m_context_t * contextP, uint16_t clientID, lwm2m_uri_t * uriP, lwm2m_result_callback_t callback, void * userData);
terencez 0:f9d13e09cf11 818 #endif
terencez 0:f9d13e09cf11 819
terence zhang 3:a280069151ac 820 #ifdef LWM2M_BOOTSTRAP_SERVER_MODE
terence zhang 3:a280069151ac 821 // Clients bootstrap request monitoring API.
terence zhang 3:a280069151ac 822 // When a LWM2M client sends a bootstrap request, the callback is called with the client's endpoint name.
terence zhang 3:a280069151ac 823 void lwm2m_set_bootstrap_callback(lwm2m_context_t * contextP, lwm2m_bootstrap_callback_t callback, void * userData);
terence zhang 3:a280069151ac 824
terence zhang 3:a280069151ac 825 // Boostrap Interface APIs
terence zhang 3:a280069151ac 826 // if uriP is nil, a "Delete /" is sent to the client
terence zhang 3:a280069151ac 827 int lwm2m_bootstrap_delete(lwm2m_context_t * contextP, void * sessionH, lwm2m_uri_t * uriP);
terence zhang 3:a280069151ac 828 int lwm2m_bootstrap_write(lwm2m_context_t * contextP, void * sessionH, lwm2m_uri_t * uriP, lwm2m_media_type_t format, uint8_t * buffer, size_t length);
terence zhang 3:a280069151ac 829 int lwm2m_bootstrap_finish(lwm2m_context_t * contextP, void * sessionH);
terence zhang 3:a280069151ac 830
terencez 0:f9d13e09cf11 831 #endif
terence zhang 3:a280069151ac 832
terence zhang 3:a280069151ac 833 #ifdef __cplusplus
terence zhang 3:a280069151ac 834 }
terence zhang 3:a280069151ac 835 #endif
terence zhang 3:a280069151ac 836
terence zhang 3:a280069151ac 837 #endif