pkg/wakaama/objects: add Temperature Sensor

pkg/wakaama/Makefile.dep

@@ -29,6 +29,10 @@ ifneq (,$(filter wakaama_objects_illuminance,$(USEMODULE)))
     USEMODULE += wakaama_objects_ipso_sensor_base
 endif
 
+ifneq (,$(filter wakaama_objects_temperature,$(USEMODULE)))
+    USEMODULE += wakaama_objects_ipso_sensor_base
+endif
+
 USEMODULE += ztimer
 USEMODULE += ztimer_sec
 USEPKG += tlsf

pkg/wakaama/contrib/objects/Kconfig.ipso

@@ -41,4 +41,13 @@ config LWM2M_ILLUMINANCE_INSTANCES_MAX
 
 endmenu
 
+menu "IPSO temperature object"
+    depends on USEMODULE_WAKAAMA_OBJECTS_TEMPERATURE
+
+config LWM2M_TEMPERATURE_INSTANCES_MAX
+    int "Maximum number of temperature object instances"
+    default 1
+
+endmenu
+
 endmenu # "IPSO objects"

pkg/wakaama/contrib/objects/temperature.c

@@ -0,0 +1,71 @@
+/*
+ * Copyright (C) 2024 HAW Hamburg
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+/**
+ * @{
+ * @ingroup     lwm2m_objects_temperature
+ *
+ * @file
+ * @brief       Temperature Sensor object implementation for LwM2M client using Wakaama
+ *
+ * @author      Leandro Lanzieri <leandro.lanzieri@haw-hamburg.de>
+ * @}
+ */
+
+#include "mutex.h"
+#include "liblwm2m.h"
+#include "lwm2m_client.h"
+#include "objects/temperature.h"
+#include "objects/ipso_sensor_base.h"
+
+#define ENABLE_DEBUG 0
+#include "debug.h"
+
+/**
+ * @brief Temperature Sensor object implementation descriptor.
+ */
+static lwm2m_obj_ipso_sensor_base_t _temperature_object;
+
+/**
+ * @brief Pool of object instances.
+ */
+static lwm2m_obj_ipso_sensor_base_inst_t _instances[CONFIG_LWM2M_TEMPERATURE_INSTANCES_MAX];
+
+lwm2m_object_t *lwm2m_object_temperature_init(lwm2m_client_data_t *client_data)
+{
+    assert(client_data);
+    int res = lwm2m_object_ipso_sensor_base_init_derived(client_data, &_temperature_object,
+                                                         LWM2M_TEMPERATURE_OBJECT_ID,
+                                                         _instances,
+                                                         CONFIG_LWM2M_TEMPERATURE_INSTANCES_MAX);
+
+    if (res) {
+        DEBUG("[lwm2m:temperature]: failed to create object\n");
+        return NULL;
+    }
+
+    return &_temperature_object.object;
+}
+
+int32_t lwm2m_object_temperature_instance_create(const lwm2m_obj_temperature_args_t *args)
+{
+    int32_t result = lwm2m_object_ipso_sensor_base_instance_create(&_temperature_object, args);
+
+    if (result) {
+        DEBUG("[lwm2m:temperature]: failed to create instance\n");
+    }
+
+    return result;
+}
+
+void lwm2m_object_temperature_update_value(const lwm2m_client_data_t *client_data,
+                                           uint16_t instance_id,
+                                           int16_t value)
+{
+    lwm2m_object_ipso_sensor_base_update_value(client_data, &_temperature_object, instance_id,
+                                               value);
+}

pkg/wakaama/include/objects/temperature.h

@@ -0,0 +1,161 @@
+/*
+ * Copyright (C) 2024 HAW Hamburg
+ *
+ * This file is subject to the terms and conditions of the GNU Lesser
+ * General Public License v2.1. See the file LICENSE in the top level
+ * directory for more details.
+ */
+
+/**
+ * @ingroup     lwm2m_objects
+ * @defgroup    lwm2m_objects_temperature Temperature
+ * @brief       Temperature Sensor object implementation for LwM2M client using Wakaama
+ *
+ * @experimental
+ *
+ * This implements the LwM2M Temperature Sensor object (ID 3303) as specified in the LwM2M registry.
+ * This IPSO object should be used with a temperature sensor to report a temperature measurement.
+ * It also provides resources for minimum/maximum measured values and the minimum/maximum range that
+ * can be measured by the temperature sensor. An example measurement unit is degrees Celsius.
+ *
+ * The sensor value can be updated by the application using the
+ * @ref lwm2m_object_temperature_update_value function, or polled when required if a callback is
+ * registered upon object instantiation via @ref lwm2m_obj_temperature_args_t::read_cb.
+ *
+ * To use this object add `USEMODULE += wakaama_objects_temperature` to the application Makefile.
+ *
+ * ## Resources
+ *
+ * For an XML description of the object see
+ * https://raw.githubusercontent.com/OpenMobileAlliance/lwm2m-registry/prod/version_history/3303-1_0.xml
+ *
+ * This object is based on the @ref lwm2m_objects_ipso_sensor_base, therefore it shares the same
+ * resources.
+ *
+ * ## Usage
+ *
+ * 1. Initialize the LwM2M object with an initialized client pointer.
+ *
+ * ~~~~~~~~~~~~~~~{.c}
+ * lwm2m_object_t *obj = lwm2m_object_temperature_init(&client_data);
+ * ~~~~~~~~~~~~~~~
+ *
+ * 2. Create a new instance of the object with a given configuration (@ref lwm2m_obj_temperature_args_t).
+ *    Here, you can decide the way of updating the sensor values: polling or pushing. In this case,
+ *    we register a callback function that is called whenever the sensor value is read.
+ *
+ * ~~~~~~~~~~~~~~~{.c}
+ *
+ * // callback function to read the sensor value
+ * int _read_cb(void *arg, int16_t *value)
+ * {
+ *     (void)arg;
+ *
+ *     // generate new value
+ *     *value = 100;
+ *
+ *     return 0;
+ * }
+ *
+ * // initialize an instance of temperature sensor object
+ * const lwm2m_obj_temperature_args_t temperature_args = {
+ *     .min_range_value = -20.0,
+ *     .max_range_value = 80.0,
+ *     .units = "C",
+ *     .units_len = sizeof("C") - 1,
+ *     .instance_id = 0,
+ *     .read_cb = _read_cb,
+ *     .read_cb_arg = NULL
+ * };
+ *
+ * int32_t res = lwm2m_object_temperature_instance_create(&temperature_args);
+ *
+ * if (res < 0) {
+ *     puts("Could not create temperature object instance");
+ * }
+ * ~~~~~~~~~~~~~~~
+ *
+ * 3. You can now update the sensor values using the @ref lwm2m_object_temperature_update_value function.
+ *
+ * ~~~~~~~~~~~~~~~{.c}
+ * uint16_t instance_id = (uint16_t)res;
+ * lwm2m_object_temperature_update_value(&client_data, instance_id, new_value);
+ * ~~~~~~~~~~~~~~~
+ * @{
+ *
+ * @file
+ *
+ * @author      Leandro Lanzieri <leandro.lanzieri@haw-hamburg.de>
+ */
+
+#ifndef OBJECTS_TEMPERATURE_H
+#define OBJECTS_TEMPERATURE_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "liblwm2m.h"
+#include "lwm2m_client.h"
+#include "objects/ipso_sensor_base.h"
+
+/**
+ * @defgroup lwm2m_objects_temperature_config LwM2M Temperature Sensor object compile configurations
+ * @ingroup lwm2m_client_config
+ * @{
+ */
+/**
+ * @brief Maximum number of instances of the object
+ */
+#ifndef CONFIG_LWM2M_TEMPERATURE_INSTANCES_MAX
+#define CONFIG_LWM2M_TEMPERATURE_INSTANCES_MAX (1U)
+#endif
+/** @} */
+
+/**
+ * @brief LwM2M Temperature Sensor object ID
+ */
+#define LWM2M_TEMPERATURE_OBJECT_ID 3303
+
+/**
+ * @brief Arguments for the creation of a Temperature Sensor object instance.
+ */
+typedef lwm2m_obj_ipso_base_sensor_args_t lwm2m_obj_temperature_args_t;
+
+/**
+ * @brief   Initialize the Temperature Sensor object handle
+ *
+ * @param[in] client_data   Pointer to the LwM2M client data.
+ *
+ * @return Pointer to the global handle of the Temperature Sensor object.
+ */
+lwm2m_object_t *lwm2m_object_temperature_init(lwm2m_client_data_t *client_data);
+
+/**
+ * @brief   Create a new Temperature Sensor instance.
+ *
+ * @param[in]      args             Initialize structure with the parameter for the instance. Must
+ *                                  not be NULL.
+ *
+ * @return > 0 value representing the instance ID if the instance was created successfully.
+ * @return <0 otherwise
+ */
+int32_t lwm2m_object_temperature_instance_create(const lwm2m_obj_temperature_args_t *args);
+
+/**
+ * @brief Update the value of the temperature sensor and trigger a notification
+ *        to the observing servers, if any.
+ *
+ * @param[in] client_data   Pointer to the LwM2M client.
+ * @param[in] instance_id   ID of the instance to update.
+ * @param[in] value         New value for the sensor.
+ */
+void lwm2m_object_temperature_update_value(const lwm2m_client_data_t *client_data,
+                                           uint16_t instance_id, int16_t value);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* OBJECTS_TEMPERATURE_H */
+/** @} */