From 910f1d8ea8c7b77c483734ede7db53bef6f6cfbc Mon Sep 17 00:00:00 2001
From: Noah Pendleton <2538614+noahp@users.noreply.github.com>
Date: Thu, 24 Oct 2024 14:53:53 -0400
Subject: [PATCH] draft: memfault sdk esp component article (#518)
---
.prettierrc.yml | 4 +
.vscode/settings.json | 7 +-
_drafts/memfault-esp-component.md | 397 ++++++++++++++++++
assets/video/zissou.webm | Bin 0 -> 321019 bytes
entrypoint.sh | 2 +-
.../idf.py-build-system.excalidraw.svg | 21 +
img/esp-component/zissou.webm | Bin 0 -> 321019 bytes
7 files changed, 428 insertions(+), 3 deletions(-)
create mode 100644 .prettierrc.yml
create mode 100644 _drafts/memfault-esp-component.md
create mode 100644 assets/video/zissou.webm
create mode 100644 img/esp-component/idf.py-build-system.excalidraw.svg
create mode 100644 img/esp-component/zissou.webm
diff --git a/.prettierrc.yml b/.prettierrc.yml
new file mode 100644
index 000000000..ec3b3e2f7
--- /dev/null
+++ b/.prettierrc.yml
@@ -0,0 +1,4 @@
+overrides:
+ - files: "*.md"
+ options:
+ proseWrap: always
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 737749e86..19a5fdab0 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -6,5 +6,8 @@
"**/*.md"
],
"grammarly.config.documentDialect": "american",
- "grammarly.config.suggestions.OxfordComma": true
-}
\ No newline at end of file
+ "grammarly.config.suggestions.OxfordComma": true,
+ "[markdown]": {
+ "editor.formatOnSave": true
+ }
+}
diff --git a/_drafts/memfault-esp-component.md b/_drafts/memfault-esp-component.md
new file mode 100644
index 000000000..79cac57ed
--- /dev/null
+++ b/_drafts/memfault-esp-component.md
@@ -0,0 +1,397 @@
+---
+title: Publishing the Memfault SDK as an ESP-IDF Component
+description: How we shipped our SDK as an ESP-IDF component
+author: noah
+tags: [ci, memfault, esp32, esp-idf, github-actions]
+---
+
+
+
+In this very Memfault-centric post, I'll be talking about how we shipped our SDK
+as an ESP-IDF component. This is a continuation of our efforts to make it easier
+to integrate Memfault into your projects, specifically targeting ESP32-based
+projects.
+
+
+
+{% include newsletter.html %}
+
+{% include toc.html %}
+
+## What are we talking about here
+
+Ok, so full disclosure- your author is employed by Memfault, and this post is
+going to be talking a LOT about our
+[Memfault Firmware SDK](https://github.com/memfault/memfault-firmware-sdk)! In
+spite of that, I hope it's an interesting walkthrough of this specific problem
+we recently tackled.
+
+### ESP Component Registry
+
+A little over 2 years ago, in 2022, Espressif introduced the
+[ESP Component Registry](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/tools/idf-component-manager.html),
+to streamline sharing and reusing public components.
+
+Initially it was used mostly for breaking up the ESP-IDF itself into smaller
+components, but it has since grown to include a
+[variety of third-party components](https://components.espressif.com). This is a
+great way to share code and make it easier to integrate into your projects.
+
+### Memfault Firmware SDK
+
+Memfault's Firmware SDK is a platform-agnostic SDK that provides a set of
+observability/telemetry features for embedded devices:
+
+- Fault capture and analysis
+- Log collection
+- Metrics collection
+- Reboot tracking
+
+It's designed to be easy to integrate into your project, and we're constantly
+working to make it even easier.
+
+We've supported the ESP32 series of chips for a while now
+([over 4 years!](https://github.com/memfault/memfault-firmware-sdk/blob/00ff70fb8b92581e179c31e4dace6d36da25fc8b/CHANGELOG.md#changes-between-memfault-sdk-024-and-sdk-023---march-10-2020)
+😮 time flies), but our integration has always required manually adding the SDK
+to your project:
+
+1. Clone the SDK into your project folder (typically as a submodule)
+2. Add the SDK to your project's `CMakeLists.txt`
+3. Set up necessary Kconfig settings to enable the SDK
+
+Compare that with our Zephyr integration, where you can just add the SDK as a
+`west` module to a project's `west.yml` file like so:
+
+```yaml
+manifest:
+ projects:
+ - name: memfault-firmware-sdk
+ url: https://github.com/memfault/memfault-firmware-sdk
+ revision: 1.11.5
+```
+
+Add the `CONFIG_MEMFAULT=y` Kconfig setting, and the Memfault SDK is enabled in
+your project.
+
+This is great! and it's the user experience we'd love for all our supported
+platforms (looking at you, Eclipse-based IDEs... 😁).
+
+## How we go from manual mode to component
+
+### Let me tell you about our existing integration
+
+
+
+ESP-IDF's build system is based on CMake, and has a LOT of features and options.
+
+The manual is here if you're interested in going on a deep dive:
+
+- [ESP-IDF CMake Build System](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html)
+
+From our perspective, there's essentially 4 steps that happen when you build an
+ESP-IDF based project[^1] (names are my own):
+
+
+
+1. Scan and load all selected components- each component's `CMakeLists.txt` file
+ is processed in script mode
+1. `Kconfig` files are loaded from ESP-IDF and all registered components.
+ `Kconfig` settings are loaded (from `sdkconfig` or `sdkconfig.defaults` if
+ `sdkconfig` is not already generated), and the final configuration is
+ generated
+1. Process the component `CMakeLists.txt` files by including the component
+ directories. This loads all the component source files, etc.
+1. Build the project, producing the output artifacts (`.elf` files, OTA images,
+ etc).
+
+Memfault's existing integration enables our component by adding the directory to
+the `EXTRA_COMPONENT_DIRS` CMake variable, which causes the SDK folder to be
+processed, and we call `register_component()` in our component `CMakeLists.txt`
+to add the SDK to the build.
+
+Note that we're using `register_component()` here, instead of the modern
+`idf_component_register()` function (see
+[documentation](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/build-system.html#minimal-component-cmakelists)),
+because we need to support older versions of ESP-IDF. More about that later!
+
+Otherwise, our SDK component is pretty standard- we have a `CMakeLists.txt` file
+and `Kconfig` file that define the SDK's build and configuration settings. Take
+a look here if you're curious:
+
+- [CMakeLists.txt](https://github.com/memfault/memfault-firmware-sdk/blob/master/ports/esp_idf/memfault/CMakeLists.txt)
+- [Kconfig](https://github.com/memfault/memfault-firmware-sdk/blob/master/ports/esp_idf/memfault/Kconfig)
+
+### What we need to do to make this a component
+
+ESP Component Registry-enabled components have the follow properties:
+
+- Root-level `idf_component.yml` manifest
+- Root-level `CMakeLists.txt` and `Kconfig` files
+- The enclosing folder name must _exactly_ match the component name
+
+We have essentially 2 options when it comes to making our SDK an ESP-IDF
+component:
+
+1. **Reorganize our SDK to put the ESP port at the root, and the core files
+ under `src`, etc**:
+ - This is the simplest option, but it requires changing the Memfault SDK's
+ folder structure
+1. **Use a `CMakeLists.txt` file in the SDK's root folder to include the SDK
+ folder**:
+ - This is more complex, but it allows us to keep the SDK's folder structure
+ as-is
+
+We'll go with option #2, because it's simpler to keep the ESP Component version
+of our SDK as close as possible to the upstream version (mostly, less confusing
+for us, the maintainers!).
+
+### Making the change
+
+The first step is to create the required root-level files:
+
+- `idf_component.yml`: this one's pretty straightforward:
+
+ ```yml
+ description:
+ Memfault SDK for embedded systems. Observability, logging, crash reporting,
+ and OTA all in one service
+ url: https://github.com/memfault/memfault-firmware-sdk
+ repository: https://github.com/memfault/memfault-firmware-sdk
+ documentation: https://docs.memfault.com/
+ issues: https://github.com/memfault/memfault-firmware-sdk/issues
+ ```
+
+ Note: we leave off the `version:` field, which is inserted when the component
+ is packed for upload (see
+ [reference here](https://docs.espressif.com/projects/idf-component-manager/en/latest/reference/manifest_file.html#version))
+
+- `CMakeLists.txt`: this will shim over to our existing component
+ `CMakeLists.txt`, but only if we're building as an ESP-IDF component:
+
+ ```cmake
+ cmake_minimum_required(VERSION 3.12.4)
+
+ if(ESP_PLATFORM)
+ include(${CMAKE_CURRENT_LIST_DIR}/ports/esp_idf/memfault/CMakeLists.txt)
+ else()
+ include(${CMAKE_CURRENT_LIST_DIR}/cmake/Memfault.cmake)
+ endif()
+ ```
+
+- `Kconfig`: this will shim over to our existing component `Kconfig` file
+ similarly to the `CMakeLists.txt`:
+
+ ```configuration
+ # If the repo is being used as an ESP-IDF component, bring in the ESP-IDF specific
+ # Kconfig file. Otherwise this should be unused.
+ if IDF_TARGET != ""
+ rsource "ports/esp_idf/memfault/Kconfig"
+ endif
+ ```
+
+There were a few minor tweaks needed to the existing `CMakeLists.txt` (at
+`ports/esp_idf/memfault/CMakeLists.txt`) to make it work when included in this
+way, but nothing notable- just a few path adjustments.
+
+### Testing the change!
+
+The ESP component tooling permits selecting a local path for a component, like
+so:
+
+```yaml
+dependencies:
+ # Define local dependency with relative path
+ some_local_component:
+ path: ../../projects/component
+```
+
+One nuance here- the component name specified must exactly match the enclosing
+folder name, or the build will fail.
+
+Memfault uses a monorepo for our development, where the Memfault Firmware SDK is
+located in a subfolder at `sdk/embedded`. To make it easy to test the component
+change, we'll create a bind mount with the correct name
+(`memfault-firmware-sdk`), so we can work out of our monorepo and test the
+component build without needing to copy files around:
+
+```bash
+mkdir /tmp/memfault-firmware-sdk && sudo mount --bind /path/to/memfault-monorepo/sdk/embedded /tmp/memfault-firmware-sdk
+```
+
+Now we can update our sample ESP32 app to use the Memfault SDK from the
+filesystem as a component:
+
+```yaml
+dependencies:
+ memfault-firmware-sdk:
+ path: /tmp/memfault-firmware-sdk
+```
+
+And build the project:
+
+```bash
+idf.py build
+```
+
+The ESP-IDF build system will print out the loaded components by default, so we
+can check the build output (it's pretty busy, truncated for brevity below):
+
+```plaintext
+-- Components: ... memfault-firmware-sdk ...
+-- Component paths: ... /tmp/memfault-firmware-sdk ...
+```
+
+This makes iterating on the component changes much easier. We've now confirmed
+our changes work as expected 🎉!
+
+## Final steps
+
+Let's use the ESP component tooling to package up our component for upload to
+the ESP Component Registry. Modern ESP-IDF development environments come with
+the `compote` Python tool pre-installed, otherwise it can be installed with
+`pip install idf-component-manager` to a Python environment.
+
+```bash
+# Running from the root folder of our component
+❯ compote component pack --name memfault-firmware-sdk --version 1.11.4-rc1
+Saving archive to "dist/memfault-firmware-sdk_1.11.4-rc1.tgz"
+```
+
+That spits out an archive that can be uploaded to the ESP Component Registry. We
+can also unpack the archive and confirm the contents look sane- it's a copy of
+the files with the `idf_component.yml` manifest stamped with the version number.
+
+We can test the component end-to-end now by uploading it to the component
+registry:
+
+```bash
+❯ compote component upload \
+ --archive dist/memfault-firmware-sdk_1.11.4-rc1.tgz \
+ --namespace memfault \
+ --name memfault-firmware-sdk
+```
+
+> Note: the example command above is uploading the component to the `memfault`
+> namespace. To register a new namespace, you'll need to create an account on
+> the ESP Component Registry website- the namespace will be set to the user
+> account name. Espressif does support custom namespaces, but they need to be
+> manually created by
+> [contacting Espressif](https://docs.espressif.com/projects/idf-component-manager/en/latest/guides/packaging_components.html#authentication).
+
+### Auto-publishing the component
+
+We can automate the component publishing process by adding a step to our
+existing Memfault SDK publishing automation. A simplified example is shown
+below, using GitHub Actions:
+
+```yaml
+name: Publish ESP Component
+
+on:
+ push:
+ tags:
+ - "v*"
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Set up Python
+ uses: actions/setup-python@v4
+ with:
+ python-version: "3.x"
+
+ - name: Install compote
+ run: pip install idf-component-manager
+
+ - name: Build and publish component
+ env:
+ # This token is used to authenticate with the ESP Component Registry
+ IDF_COMPONENT_API_TOKEN: ${{ secrets.IDF_COMPONENT_API_TOKEN }}
+ run: |
+ compote component pack --name memfault-firmware-sdk --version ${{ github.ref_name }}
+ compote component upload --archive dist/memfault-firmware-sdk_${{ github.ref_name }}.tgz --namespace memfault --name memfault-firmware-sdk
+```
+
+### Continuous verification of the component
+
+Finally, we also want to make sure the component doesn't break in the future
+(maybe we change some paths or files in the SDK that break the component).
+
+We take a couple of strategies to ensure this:
+
+- Confirm the component builds every time we push a change to the internal
+ development repo for the SDK
+- A nightly check that the latest published component on the registry builds
+ successfully
+- A second nightly check that confirms the component builds successfully with
+ the latest ESP-IDF master branch, in case there's upcoming tooling or build
+ changes that we need to be aware of
+
+## Summary
+
+It's a pretty dry topic, but always interesting to learn about a new software
+packaging system!
+
+Some of the techniques apply to other build systems, especially the overall
+methodology:
+
+1. identify and make the changes
+2. test (focus on an efficient test strategy!)
+3. automate the verification and distribution process
+
+It was a fun project to work on, and I'm excited to see the Memfault SDK
+available as an ESP-IDF component; we love making it simpler to integrate
+Memfault into your projects, and this removes a few manual steps from the
+process 🥳.
+
+The final component is now available here:
+
+
+
+One last thing- the ESP Component system permits including example apps. In our
+case, it's the same example application we provide with the non-component
+SDK[^2]. You can find the example here in the ESP Component Registry page:
+
+
+
+And the ESP tooling makes it very easy to try out:
+
+```bash
+❯ idf.py create-project-from-example "memfault/memfault-firmware-sdk:esp32/apps/memfault_demo_app"
+Executing action: create-project-from-example
+Example "esp32/apps/memfault_demo_app" successfully downloaded to /home/noah/dev/memfault/interrupt/memfault_demo_app
+Done
+
+❯ cd memfault_demo_app
+
+# Add a Memfault Project Key:
+❯ echo "CONFIG_MEMFAULT_PROJECT_KEY=\"dummy\"\n" >> sdkconfig.defaults
+
+# Build for the default ESP32 target, flash, and start the serial port monitor:
+❯ idf.py build flash monitor
+```
+
+Thanks for reading!
+
+
+
+{% include newsletter.html %}
+
+{% include submit-pr.html %}
+
+
+
+{:.no_toc}
+
+## References
+
+
+
+[^1]: This is a simplification, but it's close enough for our purposes. See [full explanation here](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/build-system.html#build-process).
+[^2]: The example app is a simple ESP32 app that demonstrates the Memfault SDK's features, and can be [found here](https://github.com/memfault/memfault-firmware-sdk/tree/master/examples/esp32)
+
+
diff --git a/assets/video/zissou.webm b/assets/video/zissou.webm
new file mode 100644
index 0000000000000000000000000000000000000000..edf0b5c319ac1a8dfd07add48291878f53c4555b
GIT binary patch
literal 321019
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