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

Dependencies:   C12832 LM75B

Committer:
terencez
Date:
Wed May 03 19:00:24 2017 +0800
Revision:
11:1fadb70654a6
Parent:
10:df97539c6ddd
Child:
12:cc4b0014fc3a
remove warnings

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