Memfault Firmware SDK 1.9.2 (Build 8056)

Author: Memfault Inc

CHANGELOG.md

@@ -6,6 +6,59 @@ 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.9.2] - 2024-05-29
+
+### :chart_with_upwards_trend: Improvements
+
+- ESP-IDF:
+
+  - Fix CLI command, `memfault_ota_check`, to return 0 to the console component
+    when an update is available.
+
+  - Add the temperature metric `cpu_temp` which is measured using an internal
+    temperature sensor that many ESP32 boards have built-in. This metric is
+    collected by default with the Kconfig `CONFIG_MEMFAULT_METRICS_CPU_TEMP=y`.
+
+  - Enable recording vprintf data into the Memfault log buffer through a vprintf
+    hook. Users can call `memfault_esp_port_vprintf_log_hook()` from their
+    vprintf handler so they can use both their vprintf handler and record logs
+    into Memfault's log buffer. To use this feature, set
+    `CONFIG_MEMFAULT_LOG_USE_VPRINTF_HOOK=n`.
+
+  - Fix a case where `esp_http_client_cleanup()` was not called in certain
+    scenarios (for example, if the access point is connected, but there is no
+    outside internet access), which resulted in a memory leak. Thanks to
+    @mykmelez for providing the fix in
+    [#71](https://github.com/memfault/memfault-firmware-sdk/pull/71) 🎉!
+
+- Zephyr:
+
+  - Fix a bug in `memfault_zephyr_port_post_data_return_size()` where a positive
+    value could be returned in the event of a failure instead of a negative
+    value. This would result in `mflt post_chunks` returning a successful post
+    message even though there was a failure such as a DNS lookup failure.
+
+  - Add the temperature metric `cpu_temp` which is measured using an internal
+    temperature sensor that some Zephyr boards have. Similar to ESP-IDF, this
+    metric is collected by default with the Kconfig
+    `CONFIG_MEMFAULT_METRICS_CPU_TEMP=y`, but the board must have the device
+    tree node `die-temp0` for this option to be used.
+
+  - Add an example for collecting thread stack usage metrics when the thread
+    handles are not accessible in the desired scope. Users can leverage the
+    Zephyr routine `k_thread_foreach()` to register a callback that will be
+    called with each thread's `k_thread` handle. In the callback, users can read
+    the stack usage via the handle and set their metrics.
+
+### :boom: Breaking Changes
+
+- Zephyr:
+
+  - Change the error return value for
+    `memfault_zephyr_port_http_upload_sdk_data()` to a negative value instead
+    of 1. This change aligns with the error return value for the other Zephyr
+    HTTP client APIs, and simplifies logic in the HTTP client.
+
 ## [1.9.1] - 2024-05-21
 
 ### :chart_with_upwards_trend: Improvements

VERSION

@@ -1,3 +1,3 @@
-BUILD ID: 7915
-GIT COMMIT: 435dc7c1d8
-VERSION: 1.9.1
+BUILD ID: 8056
+GIT COMMIT: 398b8ca5a7
+VERSION: 1.9.2

components/include/memfault/version.h

@@ -19,8 +19,8 @@ typedef struct {
   uint8_t patch;
 } sMfltSdkVersion;
 
-#define MEMFAULT_SDK_VERSION   { .major = 1, .minor = 9, .patch = 1 }
-#define MEMFAULT_SDK_VERSION_STR "1.9.1"
+#define MEMFAULT_SDK_VERSION   { .major = 1, .minor = 9, .patch = 2 }
+#define MEMFAULT_SDK_VERSION_STR "1.9.2"
 
 #ifdef __cplusplus
 }

examples/esp32/apps/memfault_demo_app/main/main.c

@@ -388,12 +388,44 @@ void esp_heap_trace_alloc_hook(void *ptr, size_t size, uint32_t caps) {
 }
 #endif
 
+#if !defined(CONFIG_MEMFAULT_LOG_USE_VPRINTF_HOOK)
+// Demonstrate a custom vprintf hook that prefixes all log messages with
+// "[IDF]", before invoking the Memfault log hook, and then printing to stdout.
+static int prv_vprintf_hook(const char *fmt, va_list args) {
+  char *fmt_annotated;
+  int rv = asprintf(&fmt_annotated, "[IDF] %s", fmt);
+  if ((rv < 0) || (fmt_annotated == NULL)) {
+    return -1;
+  }
+
+  #if defined(CONFIG_MEMFAULT)
+  (void)memfault_esp_port_vprintf_log_hook(fmt_annotated, args);
+  #endif
+
+  rv = vprintf(fmt_annotated, args);
+
+  free(fmt_annotated);
+
+  return rv;
+}
+
+#endif
+
 // This task started by cpu_start.c::start_cpu0_default().
 void app_main() {
 #if defined(CONFIG_MEMFAULT)
   #if !defined(CONFIG_MEMFAULT_AUTOMATIC_INIT)
   memfault_boot();
   #endif
+
+  #if !defined(CONFIG_MEMFAULT_LOG_USE_VPRINTF_HOOK)
+  esp_log_set_vprintf(prv_vprintf_hook);
+  ESP_LOGD("main", "debug log 🕵️");
+  ESP_LOGI("main", "info log 🐢");
+  ESP_LOGW("main", "warning log ⚠️");
+  ESP_LOGE("main", "error log 🔥");
+  #endif
+
   memfault_device_info_dump();
 
   g_unaligned_buffer = &s_my_buf[1];

examples/zephyr/qemu/qemu-app/boards/nucleo_f756zg.conf

@@ -0,0 +1,2 @@
+CONFIG_ADC=y
+CONFIG_SENSOR=y

examples/zephyr/qemu/qemu-app/boards/nucleo_f756zg.overlay

@@ -0,0 +1,16 @@
+/ {
+	aliases {
+		die-temp0 = &die_temp;
+	};
+};
+
+&die_temp {
+	status = "okay";
+};
+
+&adc1 {
+	pinctrl-0 = <&adc1_in0_pa0>;
+	pinctrl-names = "default";
+	st,adc-prescaler = <4>;
+	status = "okay";
+};

examples/zephyr/qemu/qemu-app/config/memfault_metrics_heartbeat_config.def

@@ -2,3 +2,4 @@ MEMFAULT_METRICS_KEY_DEFINE(MainStack_MinBytesFree, kMemfaultMetricType_Unsigned
 // This example metric demonstrates a permille integer with a range of 0-1000 to be translated into
 // a percentage 0.0-100.0%
 MEMFAULT_METRICS_KEY_DEFINE_WITH_SCALE_VALUE(main_thread_cpu_time_permille, kMemfaultMetricType_Unsigned, 10)
+MEMFAULT_METRICS_KEY_DEFINE(shell_uart_stack_free_bytes, kMemfaultMetricType_Unsigned)

examples/zephyr/qemu/qemu-app/src/main.c

@@ -211,11 +211,35 @@ static int prv_run_example_memory_metrics(const struct shell *shell, size_t argc
 SHELL_CMD_REGISTER(memory_metrics, NULL, "Collects runtime memory metrics from application",
                    prv_run_example_memory_metrics);
 
+//! Callback to collect stack usage for specific threads
+static void prv_collect_thread_stack_usage_cb(const struct k_thread *thread, void *user_data) {
+  // table mapping thread names to metric IDs
+  static const struct {
+    const char *name;
+    MemfaultMetricId id;
+  } threads[] = {
+    { "shell_uart", MEMFAULT_METRICS_KEY(shell_uart_stack_free_bytes) },
+  };
+
+  // scan for a matching thread name
+  for (size_t i = 0; i < ARRAY_SIZE(threads); i++) {
+    if (strncmp(thread->name, threads[i].name, CONFIG_THREAD_MAX_NAME_LEN) == 0) {
+      // get the stack usage and record in the matching metric id
+      size_t stack_free_bytes;
+      k_thread_stack_space_get(thread, &stack_free_bytes);
+      memfault_metrics_heartbeat_set_unsigned(threads[i].id, stack_free_bytes);
+    }
+  }
+}
+
 // Override function to collect the app metric MainStack_MinBytesFree
 // and print current metric values
 void memfault_metrics_heartbeat_collect_data(void) {
   prv_collect_main_thread_stack_free();
   prv_collect_main_thread_run_stats();
+
+  k_thread_foreach(prv_collect_thread_stack_usage_cb, NULL);
+
   memfault_metrics_heartbeat_debug_print();
 }
 

examples/zephyr/qemu/qemu-app/west.yml

@@ -19,6 +19,7 @@ manifest:
         name-allowlist:
             - cmsis
             - picolibc
+            - hal_stm32
 
     - name: memfault-firmware-sdk
       path: modules/lib/memfault-firmware-sdk

examples/zephyr/stm32l4_disco/apps/memfault_demo_app/prj.conf

@@ -82,3 +82,7 @@ CONFIG_MEMFAULT_LOGGING_RAM_SIZE=512
 
 CONFIG_SYSTEM_WORKQUEUE_STACK_SIZE=4096
 CONFIG_HEAP_MEM_POOL_SIZE=1024
+
+# Currently not supported on older Zephyr, so explicitly disable until this
+# sample is updated
+CONFIG_MEMFAULT_METRICS_CPU_TEMP=n