Memfault Firmware SDK 1.1.3 (Build 3171)

Author: Memfault Inc

CHANGES.md

@@ -1,3 +1,29 @@
+### Changes between Memfault SDK 1.1.2 and 1.1.3 - Aug 8, 2023
+
+#### :chart_with_upwards_trend: Improvements
+
+- Set Memfault SDK version in a string metric on device boot, for easier
+  tracking of SDK versions in the Memfault UI
+- Support using a different identifier for the GNU build id symbol (previously
+  was fixed to `__start_gnu_build_id_start`). Use the
+  `MEMFAULT_GNU_BUILD_ID_SYMBOL` define in `memfault_platform_config.h` to
+  override the default. For Zephyr, the Kconfig option
+  `CONFIG_MEMFAULT_GNU_BUILD_ID_SOURCE_BUILTIN` can be used to override the
+  builtin section specifier + linker fragment for the GNU build ID. Thanks to
+  @JordanYates for posting this change in
+  [#60](https://github.com/memfault/memfault-firmware-sdk/pull/60) 🎉
+- Improvements to the ARMv7-R exception handling when the supervisor processor
+  mode is active
+
+- Zephyr:
+  - Add an optional mode to create and open the HTTP socket in separate function
+    calls, if the user needs to set additional socket options before connecting.
+    See
+    [ports/zephyr/include/memfault/ports/zephyr/http.h](ports/zephyr/include/memfault/ports/zephyr/http.h)
+    for details. Fixes
+    [#52](https://github.com/memfault/memfault-firmware-sdk/issues/52)- thanks
+    to @anicare-tero for posting this 🎉
+
 ### Changes between Memfault SDK 1.1.1 and 1.1.2 - July 11, 2023
 
 #### :chart_with_upwards_trend: Improvements

VERSION

@@ -1,2 +1,2 @@
-BUILD ID: 2861
-GIT COMMIT: 3a1297110
+BUILD ID: 3171
+GIT COMMIT: cd928ad15

components/core/src/memfault_build_id.c

@@ -17,13 +17,13 @@
 #if MEMFAULT_USE_GNU_BUILD_ID
 
 // Note: This variable is emitted by the linker script
-extern uint8_t __start_gnu_build_id_start[];
+extern uint8_t MEMFAULT_GNU_BUILD_ID_SYMBOL[];
 
 MEMFAULT_BUILD_ID_QUALIFIER sMemfaultBuildIdStorage g_memfault_build_id = {
   .type = kMemfaultBuildIdType_GnuBuildIdSha1,
   .len = sizeof(sMemfaultElfNoteSection),
   .short_len = MEMFAULT_EVENT_INCLUDED_BUILD_ID_SIZE_BYTES,
-  .storage = __start_gnu_build_id_start,
+  .storage = MEMFAULT_GNU_BUILD_ID_SYMBOL,
   .sdk_version = MEMFAULT_SDK_VERSION,
 };
 #else

components/core/src/memfault_heap_stats.c

@@ -81,19 +81,30 @@ static uint16_t prv_get_previous_entry(uint16_t search_entry_index) {
 
 //! Return the next entry index to write new data to
 //!
-//! First searches for unused entries
-//! If none are found then traverses list to oldest (last) entry
+//! First searches for never-used entries, then unused (used + freed) entries.
+//! If none are found then traverses list to oldest (last) entry.
 static uint16_t prv_get_new_entry_index(void) {
   sMfltHeapStatEntry *entry;
+  uint16_t unused_index = MEMFAULT_HEAP_STATS_LIST_END;
 
   for (uint16_t i = 0; i < MEMFAULT_ARRAY_SIZE(g_memfault_heap_stats_pool); i++) {
     entry = &g_memfault_heap_stats_pool[i];
 
     if (!entry->info.in_use) {
-      return i;  // favor unused entries
+      if (entry->info.size == 0) {
+        return i;  // favor never used entries
+      }
+      // save the first inactive entry found
+      if (unused_index == MEMFAULT_HEAP_STATS_LIST_END) {
+        unused_index = i;
+      }
     }
   }
 
+  if (unused_index != MEMFAULT_HEAP_STATS_LIST_END) {
+    return unused_index;
+  }
+
   // No unused entry found, return the oldest (entry with next index of
   // MEMFAULT_HEAP_STATS_LIST_END)
   return prv_get_previous_entry(MEMFAULT_HEAP_STATS_LIST_END);

components/include/memfault/components.h

@@ -68,6 +68,7 @@ extern "C" {
 #include "memfault/util/crc16_ccitt.h"
 #include "memfault/util/rle.h"
 #include "memfault/util/varint.h"
+#include "memfault/version.h"
 
 #ifdef __cplusplus
 }

components/include/memfault/default_config.h

@@ -26,6 +26,11 @@ extern "C" {
 #define MEMFAULT_USE_GNU_BUILD_ID 0
 #endif
 
+//! Controls the name used to reference the GNU build ID data
+#ifndef MEMFAULT_GNU_BUILD_ID_SYMBOL
+  #define MEMFAULT_GNU_BUILD_ID_SYMBOL __start_gnu_build_id_start
+#endif
+
 //! Allows users to dial in the correct amount of storage for their
 //! software version + build ID string.
 #ifndef MEMFAULT_UNIQUE_VERSION_MAX_LEN

components/include/memfault/metrics/heartbeat_config.def

@@ -2,6 +2,9 @@
 //! default health statistics for the fleet. All other metrics are provided by the user
 //! of the sdk via the MEMFAULT_METRICS_USER_HEARTBEAT_DEFS_FILE file
 
+// Memfault SDK Version String
+#include "memfault/version.h"
+MEMFAULT_METRICS_STRING_KEY_DEFINE(MemfaultSdkMetric_sdk_version, sizeof(MEMFAULT_SDK_VERSION_STR) - 1)
 // The time since the last heartbeat was collected in ms
 MEMFAULT_METRICS_KEY_DEFINE(MemfaultSdkMetric_IntervalMs, kMemfaultMetricType_Timer)
 // The number of reboots that have taken place since the last heartbeat was collected

components/include/memfault/version.h

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

components/metrics/src/memfault_metrics.c

@@ -897,6 +897,9 @@ int memfault_metrics_boot(const sMemfaultEventStorageImpl *storage_impl,
     return rv;
   }
 
+  rv = memfault_metrics_heartbeat_set_string(MEMFAULT_METRICS_KEY(MemfaultSdkMetric_sdk_version),
+                                             MEMFAULT_SDK_VERSION_STR);
+
   rv = prv_init_unexpected_reboot_metric();
   if (rv != 0) {
     return rv;

components/panics/src/memfault_fault_handling_armv7_a_r.c

@@ -75,6 +75,7 @@ bool memfault_arch_is_inside_isr(void) {
   // Reference Manual section "B1.3.1 ARM processor modes" for these values.
   #define CPSR_MODE_msk 0x1f
   #define CPSR_USER_msk 0x10
+  #define CPSR_SUPERVISOR_msk 0x13
   #define CPSR_SYSTEM_msk 0x1f
 
   uint32_t cpsr;
@@ -84,8 +85,9 @@ bool memfault_arch_is_inside_isr(void) {
 
   const bool in_user_mode = (mode == CPSR_USER_msk);
   const bool in_system_mode = (mode == CPSR_SYSTEM_msk);
+  const bool in_supervisor_mode = (mode == CPSR_SUPERVISOR_msk);
 
-  return !(in_user_mode || in_system_mode);
+  return !(in_user_mode || in_system_mode || in_supervisor_mode);
 }
 
 #if defined(__GNUC__)
@@ -237,6 +239,9 @@ void memfault_fault_handler(const sMfltRegState *regs, eMemfaultRebootReason rea
 // Processor mode values, used when saving LR and SPSR to the appropriate stack.
 // From https://developer.arm.com/documentation/dui0801/a/CHDEDCCD
 // Defined as strings for macro concatenation below
+#define CPU_MODE_FIQ_STR "0x11"
+#define CPU_MODE_IRQ_STR "0x12"
+#define CPU_MODE_SUPERVISOR_STR "0x13"
 #define CPU_MODE_ABORT_STR "0x17"
 #define CPU_MODE_UNDEFINED_STR "0x1b"
 #define CPU_MODE_SYSTEM_STR "0x1f"
@@ -281,7 +286,28 @@ void memfault_fault_handler(const sMfltRegState *regs, eMemfaultRebootReason rea
     /* push user mode regs at point of fault, including sp + lr */ \
     "mov r8, r1 \n" \
     "mov r1, sp \n" \
+    /* Save SPSR and mask mode bits */ \
+    "mrs r9, spsr \n" \
+    "and r9, #0x1f \n" \
+    /* Check each applicable mode and set current mode on a match */ \
+    "cmp r9, #" CPU_MODE_IRQ_STR " \n" \
+    "bne fiq_mode_%= \n" \
+    "cps #" CPU_MODE_IRQ_STR " \n" \
+    "b store_regs_%= \n" \
+    "fiq_mode_%=: \n" \
+    "cmp r9, #" CPU_MODE_FIQ_STR " \n" \
+    "bne supervisor_mode_%= \n" \
+    "cps #" CPU_MODE_FIQ_STR " \n" \
+    "b store_regs_%= \n" \
+    "supervisor_mode_%=: \n" \
+    "cmp r9, #" CPU_MODE_SUPERVISOR_STR " \n" \
+    "bne system_mode_%= \n" \
+    "cps #" CPU_MODE_SUPERVISOR_STR " \n" \
+    "b store_regs_%= \n" \
+    /* Fall back to system mode if no match */ \
+    "system_mode_%=: \n" \
     "cps #" CPU_MODE_SYSTEM_STR " \n" \
+    "store_regs_%=: \n" \
     "stmfd r1!, {r8-r12, sp, lr} \n"\
     "cps #" _mode_string" \n" \
     /* save active registers in exception frame */ \