Anjay 3.8.0

BREAKING CHANGES:
- Timeout in case of sending a Confirmable Notification does not cancel the
  observation anymore by default.

Features:
- Added a ``connection_error_is_registration_failure`` configuration option that
  allows handling connection errors as Register failures, including the
  automatic retry mechanism
- Added experimental server connection status API.

Improvements:
- (commercial version only) Changed MSISDN matching method in SMS binding
  feature to allow handling messages with Short Codes as originating number

Bugfixes:
- Fixed a corner case in which a connection error during a non-first Register
  attempt could cause uncontrolled infinite retries
- Fixed a bug in demo of Advanced Firmware Update module that prevented
  proper handling of security config for targets other than APP
- Fixed a bug that caused anjay_next_planned_notify_trigger family APIs to
  return an invalid value after canceling observations

Author: Kucmasz

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 3.8.0 (May 28th, 2024)
+
+### BREAKING CHANGES
+
+- Timeout in case of sending a Confirmable Notification does not cancel the
+  observation anymore by default.
+
+### Features
+
+- Added a ``connection_error_is_registration_failure`` configuration option that
+  allows handling connection errors as Register failures, including the
+  automatic retry mechanism
+- Added experimental server connection status API.
+
+### Improvements
+
+- (commercial version only) Changed MSISDN matching method in SMS binding
+  feature to allow handling messages with Short Codes as originating number
+
+### Bugfixes
+
+- Fixed a corner case in which a connection error during a non-first Register
+  attempt could cause uncontrolled infinite retries
+- Fixed a bug in demo of Advanced Firmware Update module that prevented
+  proper handling of security config for targets other than APP
+- Fixed a bug that caused anjay_next_planned_notify_trigger family APIs to
+  return an invalid value after canceling observations
+
 ## 3.7.0 (February 16th, 2024)
 
 ### Features

CMakeLists.txt

@@ -8,7 +8,7 @@
 cmake_minimum_required(VERSION 3.6.0)
 
 project(anjay C)
-set(ANJAY_VERSION "3.7.0" CACHE STRING "Anjay library version")
+set(ANJAY_VERSION "3.8.0" CACHE STRING "Anjay library version")
 set(ANJAY_BINARY_VERSION 1.0.0)
 
 set(ANJAY_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
@@ -210,6 +210,7 @@ else()
 endif()
 
 option(WITH_AVS_COAP_TCP "Enable CoAP over TCP support" "${WITH_LWM2M11}")
+option(WITH_CONN_STATUS_API "Enable support for the experimental anjay_get_server_connection_status() API and related callback." ON)
 
 
 
@@ -557,6 +558,7 @@ set(ANJAY_WITH_SECURITY_STRUCTURED "${WITH_SECURITY_STRUCTURED}")
 set(ANJAY_WITH_SEND "${WITH_SEND}")
 set(ANJAY_WITH_SENML_JSON "${WITH_SENML_JSON}")
 set(ANJAY_WITHOUT_QUEUE_MODE_AUTOCLOSE "${WITHOUT_QUEUE_MODE_AUTOCLOSE}")
+set(ANJAY_WITH_CONN_STATUS_API "${WITH_CONN_STATUS_API}")
 
 configure_file(include_public/anjay/anjay_config.h.in
                include_public/anjay/anjay_config.h)

demo/advanced_firmware_update.c

@@ -1206,7 +1206,7 @@ int advanced_firmware_update_install(
                      (int) state.result);
             result = advanced_firmware_update_additional_image_install(
                     anjay, fw_logic_add_inst->iid, fw_table, &state,
-                    ADD_IMG_NAMES[i]);
+                    security_info, ADD_IMG_NAMES[i]);
 
             if (result) {
                 demo_log(ERROR, "AFU instance %u install failed",
@@ -1261,3 +1261,17 @@ void advanced_firmware_update_uninstall(advanced_fw_update_logic_t *fw_table) {
         afu_logic_destroy(&fw_table[i]);
     }
 }
+
+int advanced_firmware_update_get_security_config(
+        anjay_iid_t iid,
+        void *fw_,
+        anjay_security_config_t *out_security_config,
+        const char *download_uri) {
+    (void) iid;
+    advanced_fw_update_logic_t *fw_table = (advanced_fw_update_logic_t *) fw_;
+    advanced_fw_update_logic_t *fw = &fw_table[FW_UPDATE_IID_APP];
+    (void) download_uri;
+    memset(out_security_config, 0, sizeof(*out_security_config));
+    out_security_config->security_info = fw->security_info;
+    return 0;
+}

demo/advanced_firmware_update.h

@@ -102,6 +102,7 @@ int advanced_firmware_update_additional_image_install(
         anjay_iid_t iid,
         advanced_fw_update_logic_t *fw_table,
         anjay_advanced_fw_update_initial_state_t *init_state,
+        const avs_net_security_info_t *security_info,
         const char *component_name);
 
 const char *
@@ -143,6 +144,12 @@ int fw_update_common_perform_upgrade(
         size_t requested_supplemental_iids_count);
 int fw_update_common_maybe_create_firmware_file(advanced_fw_update_logic_t *fw);
 
+int advanced_firmware_update_get_security_config(
+        anjay_iid_t iid,
+        void *fw_,
+        anjay_security_config_t *out_security_config,
+        const char *download_uri);
+
 typedef struct {
     anjay_advanced_fw_update_state_t inst_states[FW_UPDATE_IID_IMAGE_SLOTS];
     anjay_advanced_fw_update_result_t inst_results[FW_UPDATE_IID_IMAGE_SLOTS];

demo/advanced_firmware_update_addimg.c

@@ -92,7 +92,7 @@ static int update(advanced_fw_update_logic_t *fw) {
     return 0;
 }
 
-static const anjay_advanced_fw_update_handlers_t handlers = {
+static anjay_advanced_fw_update_handlers_t handlers = {
     .stream_open = fw_stream_open,
     .stream_write = fw_update_common_write,
     .stream_finish = fw_update_common_finish,
@@ -107,10 +107,19 @@ int advanced_firmware_update_additional_image_install(
         anjay_iid_t iid,
         advanced_fw_update_logic_t *fw_table,
         anjay_advanced_fw_update_initial_state_t *init_state,
+        const avs_net_security_info_t *security_info,
         const char *component_name) {
     advanced_fw_update_logic_t *fw_logic = &fw_table[iid];
     memcpy(fw_logic->current_ver, VER_DEFAULT, sizeof(VER_DEFAULT));
     fw_global = fw_logic;
+    if (security_info) {
+        memcpy(&fw_logic->security_info, security_info,
+               sizeof(fw_logic->security_info));
+        handlers.get_security_config =
+                advanced_firmware_update_get_security_config;
+    } else {
+        handlers.get_security_config = NULL;
+    }
     int result =
             anjay_advanced_fw_update_instance_add(anjay, fw_logic->iid,
                                                   component_name, &handlers,

demo/advanced_firmware_update_app.c

@@ -189,19 +189,6 @@ static anjay_advanced_fw_update_handlers_t handlers = {
     .perform_upgrade = fw_update_common_perform_upgrade
 };
 
-static int fw_get_security_config(anjay_iid_t iid,
-                                  void *fw_,
-                                  anjay_security_config_t *out_security_config,
-                                  const char *download_uri) {
-    (void) iid;
-    advanced_fw_update_logic_t *fw_table = (advanced_fw_update_logic_t *) fw_;
-    advanced_fw_update_logic_t *fw = &fw_table[FW_UPDATE_IID_APP];
-    (void) download_uri;
-    memset(out_security_config, 0, sizeof(*out_security_config));
-    out_security_config->security_info = fw->security_info;
-    return 0;
-}
-
 int advanced_firmware_update_application_install(
         anjay_t *anjay,
         advanced_fw_update_logic_t *fw_table,
@@ -215,7 +202,8 @@ int advanced_firmware_update_application_install(
     if (security_info) {
         memcpy(&fw_logic->security_info, security_info,
                sizeof(fw_logic->security_info));
-        handlers.get_security_config = fw_get_security_config;
+        handlers.get_security_config =
+                advanced_firmware_update_get_security_config;
     } else {
         handlers.get_security_config = NULL;
     }

demo/demo.c

@@ -498,6 +498,21 @@ static void reschedule_notify_time_dependent(anjay_demo_t *demo) {
     }
 }
 
+// !defined(ANJAY_WITH_CONN_STATUS_API)
+
+#ifdef ANJAY_WITH_CONN_STATUS_API
+static void
+server_connection_status_change_callback(void *demo_,
+                                         anjay_t *anjay,
+                                         anjay_ssid_t ssid,
+                                         anjay_server_conn_status_t status) {
+    (void) demo_;
+    (void) anjay;
+    demo_log(INFO, "Current status of the server with SSID %d is: %s", ssid,
+             translate_server_connection_status_enum_to_str(status));
+}
+#endif // ANJAY_WITH_CONN_STATUS_API
+
 static int demo_init(anjay_demo_t *demo, cmdline_args_t *cmdline_args) {
     demo->allocated_buffers = cmdline_args->allocated_buffers;
     cmdline_args->allocated_buffers = NULL;
@@ -544,6 +559,8 @@ static int demo_init(anjay_demo_t *demo, cmdline_args_t *cmdline_args) {
         .update_immediately_on_dm_change =
                 cmdline_args->update_immediately_on_dm_change,
         .enable_self_notify = cmdline_args->enable_self_notify,
+        .connection_error_is_registration_failure =
+                cmdline_args->connection_error_is_registration_failure,
         .default_tls_ciphersuites = {
             .ids = cmdline_args->default_ciphersuites,
             .num_ids = cmdline_args->default_ciphersuites_count
@@ -555,6 +572,10 @@ static int demo_init(anjay_demo_t *demo, cmdline_args_t *cmdline_args) {
 #if defined(ANJAY_WITH_LWM2M11) && defined(WITH_AVS_COAP_TCP)
         .coap_tcp_request_timeout = cmdline_args->tcp_request_timeout,
 #endif // defined(ANJAY_WITH_LWM2M11) && defined(WITH_AVS_COAP_TCP)
+#ifdef ANJAY_WITH_CONN_STATUS_API
+        .server_connection_status_cb = server_connection_status_change_callback,
+        .server_connection_status_cb_arg = demo,
+#endif // ANJAY_WITH_CONN_STATUS_API
     };
 
 #ifdef ANJAY_WITH_LWM2M11

demo/demo_args.c

@@ -131,6 +131,7 @@ static const cmdline_args_t DEFAULT_CMDLINE_ARGS = {
     .prefer_hierarchical_formats = false,
     .update_immediately_on_dm_change = false,
     .enable_self_notify = false,
+    .connection_error_is_registration_failure = false,
     .prefer_same_socket_downloads = false,
 };
 
@@ -594,6 +595,9 @@ static void print_help(const struct option *options) {
           "over CoAP+TCP and HTTP" },
 #    endif // ANJAY_WITH_DOWNLOADER
 #endif     // ANJAY_WITH_MODULE_SW_MGMT
+        { 348, NULL, NULL,
+          "Treat failures of the \"connect\" socket operation (e.g. (D)TLS "
+          "handshake failures) as a failed LwM2M Register operation." },
     };
 
     const size_t screen_width = get_screen_width();
@@ -994,6 +998,7 @@ int demo_parse_argv(cmdline_args_t *parsed_args, int argc, char *argv[]) {
         { "sw-mgmt-tcp-request-timeout",   required_argument, 0, 347 },
 #    endif // ANJAY_WITH_DOWNLOADER
 #endif // ANJAY_WITH_MODULE_SW_MGMT
+        { "connection-error-is-registration-failure", no_argument, 0, 348 },
         { 0, 0, 0, 0 }
         // clang-format on
     };
@@ -2001,6 +2006,9 @@ int demo_parse_argv(cmdline_args_t *parsed_args, int argc, char *argv[]) {
         }
 #    endif // ANJAY_WITH_DOWNLOADER
 #endif     // ANJAY_WITH_MODULE_SW_MGMT
+        case 348:
+            parsed_args->connection_error_is_registration_failure = true;
+            break;
         case 0:
             goto process;
         }

demo/demo_args.h

@@ -168,6 +168,7 @@ typedef struct cmdline_args {
     bool prefer_hierarchical_formats;
     bool update_immediately_on_dm_change;
     bool enable_self_notify;
+    bool connection_error_is_registration_failure;
     bool use_connection_id;
     bool start_offline;
 

demo/demo_cmds.c

@@ -1430,6 +1430,24 @@ static void cmd_last_communication_time(anjay_demo_t *demo,
 }
 #endif // ANJAY_WITH_COMMUNICATION_TIMESTAMP_API
 
+#ifdef ANJAY_WITH_CONN_STATUS_API
+static void cmd_get_server_connection_status(anjay_demo_t *demo,
+                                             const char *args_string) {
+    anjay_ssid_t ssid = ANJAY_SSID_ANY;
+    anjay_server_conn_status_t result;
+
+    if (*args_string && parse_ssid(args_string, &ssid)) {
+        demo_log(ERROR, "invalid Short Server ID: %s", args_string);
+        return;
+    }
+
+    result = anjay_get_server_connection_status(demo->anjay, ssid);
+
+    demo_log(INFO, "Current server connection status: %s",
+             translate_server_connection_status_enum_to_str(result));
+}
+#endif // ANJAY_WITH_CONN_STATUS_API
+
 static void cmd_help(anjay_demo_t *demo, const char *args_string);
 
 struct cmd_handler_def {
@@ -1665,6 +1683,12 @@ static const struct cmd_handler_def COMMAND_HANDLERS[] = {
                 "no argument specified) or a given server (if numeric SSID "
                 "argument given)."),
 #endif // ANJAY_WITH_COMMUNICATION_TIMESTAMP_API
+#ifdef ANJAY_WITH_CONN_STATUS_API
+    CMD_HANDLER("get-server-connection-status", "[SSID]",
+                cmd_get_server_connection_status,
+                "Displays current connection status for the server with SSID "
+                "specified by the argument."),
+#endif // ANJAY_WITH_CONN_STATUS_API
     CMD_HANDLER("help", "", cmd_help, "Prints this message")
     // clang-format on
 };