Memfault Firmware SDK 1.27.0 (Build 14706)

Author: Memfault Inc

CHANGELOG.md

@@ -6,6 +6,79 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.27.0] - 2025-07-21
+
+### 📈 Added
+
+- General:
+
+  - Add a reference software watchdog port for the STM32L4 series LPTIM
+    peripheral. Users of the STM32 HAL can now compile in the reference port and
+    the `MemfaultWatchdog_Handler`. The handler will save a coredump so the full
+    system state can be recovered when a watchdog takes place. More details can
+    be found in
+    [`ports/include/memfault/ports/watchdog.h`](ports/include/memfault/ports/watchdog.h).
+
+  - Add CLI commands `wdg_enable`, `wdg_disable`, and `wdog_update <timeout_ms>`
+    for testing a software watchdog port. These commands are disabled by default
+    and can be enabled for platforms using the minimal shell/console with
+    `MEMFAULT_DEMO_CLI_WATCHDOG`.
+
+- Zephyr:
+
+  - Add a new Kconfig option, `CONFIG_MEMFAULT_HTTP_MAX_MESSAGES_TO_SEND`, which
+    controls the max number of messages that will be sent in a single invocation
+    of `memfault_zephyr_port_post_data()` or similar APIs. The default is `100`,
+    which is suitable for most applications. Before this change, the limit was
+    hard coded to 5 messages, which was too low for systems with infrequent
+    upload intervals.
+
+  - Support building for `native_sim` on arm64 hosts (specifically, the
+    `native_sim/native/64` target), in addition to x86 hosts.
+
+### 🛠️ Changed
+
+- Zephyr:
+
+  - Improve the default implementation of
+    `memfault_platform_sanitize_address_range()` to include all memory
+    accessible by the kernel. This enables collection of heap-allocated task
+    control blocks, which was previously unsupported. Users with discontiguous
+    memory regions should provide their own implementation, as before.
+
+  - Prioritize the thread bookkeeping array when collecting thread information
+    in a coredump (when `CONFIG_MEMFAULT_COREDUMP_COLLECT_TASKS_REGIONS=y`, the
+    default). This improves the quality of the processed coredump if the
+    coredump region is too small to collect all stacks for all threads in the
+    system (impacts systems with many threads and limited coredump storage
+    space).
+
+  - Add a new Kconfig option, `CONFIG_MEMFAULT_HTTP_PACKETIZER_BUFFER_SIZE`,
+    which controls the size of the intermediate buffer used when reading data
+    from the underlying data source (coredump storage, log buffer, CDR, etc)
+    when uploading data to Memfault via HTTP. The default size is 128 bytes, and
+    1024 bytes on nRF91x series SOCs to better support modem trace CDR upload.
+    Thanks to @DematteisGiacomo for submitting this in
+    [#92](https://github.com/memfault/memfault-firmware-sdk/pull/92).
+
+- ESP-IDF:
+
+  - Handle deprecated Deep Sleep API calls for upcoming ESP-IDF v5.5 and v6.
+
+  - Supporting building with the Memfault CLI commands disabled,
+    `CONFIG_MEMFAULT_CLI_ENABLED=n`. Thanks to @finger563 for reporting this
+    issue and providing a fix in
+    [#93](https://github.com/memfault/memfault-firmware-sdk/issues/93) 🎉!
+
+### 🐛 Fixed
+
+- Zephyr:
+
+  - Fix an issue where the socket file descriptor can potentially be leaked when
+    the connection terminated unexpectedly during an HTTP chunk upload. Thanks
+    to @DematteisGiacomo for submitting this in
+    [#92](https://github.com/memfault/memfault-firmware-sdk/pull/92).
+
 ## [1.26.1] - 2025-06-30
 
 This is a minor fix release, addressing one future compatibility issue with the

VERSION

@@ -1,3 +1,3 @@
-BUILD ID: 14472
-GIT COMMIT: 5c095a2bce
-VERSION: 1.26.1
+BUILD ID: 14706
+GIT COMMIT: d002984f03
+VERSION: 1.27.0

components/demo/src/memfault_demo_shell_commands.c

@@ -135,6 +135,14 @@ static const sMemfaultShellCommand s_memfault_shell_commands[] = {
     "Run a self test to check integration with the SDK" },
 #endif
 
+#if MEMFAULT_DEMO_CLI_WATCHDOG
+  { "wdog_enable", memfault_demo_cli_cmd_software_watchdog_enable, "Enable the software watchdog" },
+  { "wdog_disable", memfault_demo_cli_cmd_software_watchdog_disable,
+    "Disable the software watchdog" },
+  { "wdog_update", memfault_demo_cli_cmd_software_watchdog_update_timeout,
+    "Update the software watchdog timeout" },
+#endif
+
   { "help", memfault_shell_help_handler, "Lists all commands" },
 };
 

components/demo/src/memfault_demo_watchdog.c

@@ -0,0 +1,61 @@
+//! @file
+//!
+//! Copyright (c) Memfault, Inc.
+//! See LICENSE for details
+//!
+//! @brief
+//! CLI commands used by demo applications to exercise the Memfault software watchdog
+
+#include "memfault/config.h"
+
+#if MEMFAULT_DEMO_CLI_WATCHDOG
+
+  #include <stdlib.h>
+
+  #include "memfault/core/compiler.h"
+  #include "memfault/core/debug_log.h"
+  #include "memfault/ports/watchdog.h"
+
+int memfault_demo_cli_cmd_software_watchdog_enable(MEMFAULT_UNUSED int argc,
+                                                   MEMFAULT_UNUSED char *argv[]) {
+  int rv = memfault_software_watchdog_enable();
+  if (rv < 0) {
+    MEMFAULT_LOG_RAW("Failed to enable software watchdog: %d", rv);
+    return -1;
+  }
+  return 0;
+}
+
+int memfault_demo_cli_cmd_software_watchdog_disable(MEMFAULT_UNUSED int argc,
+                                                    MEMFAULT_UNUSED char *argv[]) {
+  int rv = memfault_software_watchdog_disable();
+  if (rv < 0) {
+    MEMFAULT_LOG_RAW("Failed to disable software watchdog: %d", rv);
+    return -1;
+  }
+  return 0;
+}
+
+int memfault_demo_cli_cmd_software_watchdog_update_timeout(MEMFAULT_UNUSED int argc,
+                                                           MEMFAULT_UNUSED char *argv[]) {
+  if (argc < 2) {
+    MEMFAULT_LOG_RAW("Usage: wdog_update <timeout_ms>");
+    return -1;
+  }
+
+  int timeout_ms = atoi(argv[1]);
+  if (timeout_ms <= 0) {
+    MEMFAULT_LOG_RAW("Invalid timeout value: %d", timeout_ms);
+    return -1;
+  }
+
+  int rv = memfault_software_watchdog_update_timeout(timeout_ms);
+  if (rv < 0) {
+    MEMFAULT_LOG_RAW("Failed to update software watchdog timeout: %d", rv);
+    return -1;
+  }
+  MEMFAULT_LOG_RAW("Software watchdog timeout updated to %d ms", timeout_ms);
+  return 0;
+}
+
+#endif  // MEMFAULT_DEMO_CLI_WATCHDOG

components/include/memfault/default_config.h

@@ -600,6 +600,15 @@ extern "C" {
   #define MEMFAULT_DEMO_CLI_SELF_TEST_COREDUMP_STORAGE 0
 #endif
 
+//! Enable testing of the software watchdog through the Demo CLI component
+//!
+//! Setting this config to 1 will add new commands to enable, disable, and update the timeout
+//! of the software watchdog. To use this feature, a software watchdog implementation must be
+//! provided. See https://docs.memfault.com/docs/mcu/watchdogs for more details.
+#ifndef MEMFAULT_DEMO_CLI_WATCHDOG
+  #define MEMFAULT_DEMO_CLI_WATCHDOG 0
+#endif
+
 //
 // Custom Data Recording configuration options [EXPERIMENTAL]
 //

components/include/memfault/demo/cli.h

@@ -127,6 +127,15 @@ int memfault_demo_cli_cmd_heartbeat(int argc, char *argv[]);
 //! This command triggers a test which exercises different subsystems
 int memfault_demo_cli_cmd_self_test(int argc, char *argv[]);
 
+//! Enable the software watchdog
+int memfault_demo_cli_cmd_software_watchdog_enable(int argc, char *argv[]);
+
+//! Disable the software watchdog
+int memfault_demo_cli_cmd_software_watchdog_disable(int argc, char *argv[]);
+
+//! Update the software watchdog timeout
+int memfault_demo_cli_cmd_software_watchdog_update_timeout(int argc, char *argv[]);
+
 #ifdef __cplusplus
 }
 #endif

components/include/memfault/version.h

@@ -20,8 +20,8 @@ typedef struct {
 } sMfltSdkVersion;
 
 #define MEMFAULT_SDK_VERSION \
-  { .major = 1, .minor = 26, .patch = 1 }
-#define MEMFAULT_SDK_VERSION_STR "1.26.1"
+  { .major = 1, .minor = 27, .patch = 0 }
+#define MEMFAULT_SDK_VERSION_STR "1.27.0"
 
 #ifdef __cplusplus
 }

components/panics/src/memfault_fault_handling_aarch64.c

@@ -15,6 +15,12 @@
   #include "memfault/panics/coredump_impl.h"
   #include "memfault/panics/fault_handling.h"
 
+//! Provide stub implementations here to support building only
+void memfault_platform_halt_if_debugging(void) { }
+bool memfault_arch_is_inside_isr(void) {
+  return false;
+}
+
 MEMFAULT_WEAK void memfault_platform_fault_handler(MEMFAULT_UNUSED const sMfltRegState *regs,
                                                    MEMFAULT_UNUSED eMemfaultRebootReason reason) { }
 

examples/zephyr/qemu/qemu-app/CMakeLists.txt

@@ -34,3 +34,9 @@ zephyr_compile_definitions(
 )
 
 zephyr_compile_options(--param=min-pagesize=0x1000)
+
+# For Zephyr >=3.0.0,<3.6.0, explicitly enable -Werror
+if (${KERNEL_VERSION_MAJOR}.${KERNEL_VERSION_MINOR}.${KERNEL_PATCHLEVEL} VERSION_GREATER_EQUAL 3.0.0 AND
+    ${KERNEL_VERSION_MAJOR}.${KERNEL_VERSION_MINOR}.${KERNEL_PATCHLEVEL} VERSION_LESS 3.6.0)
+  zephyr_compile_options(-Werror)
+endif()

examples/zephyr/qemu/qemu-app/Kconfig

@@ -31,6 +31,17 @@ config ZEPHYR_MEMFAULT_EXAMPLE_SOFTWARE_VERSION
     help
       The software version to report to Memfault.
 
+# Stub expressions, to support backwards compatibility with older Zephyr
+# versions where these options were not available.
+config COMPILER_WARNINGS_AS_ERRORS  # v3.6.0+
+    bool "Treat warnings as errors"
+
+config CRC  # v3.3.0+
+    bool "Cyclic redundancy check (CRC) Support"
+
+config BUILD_OUTPUT_META  # v3.0.0+
+    bool "Create a build meta file"
+
 endmenu
 
 source "Kconfig.zephyr"