Skip to content

memfault/particle-firmware-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Memfault Library for use with Particle Device OS

Ship Firmware with Confidence.

More details about the Memfault platform itself, how it works, and step-by-step integration guides can be found here.

The library is compatible with all versions of Device OS greater than or equal to Device OS 3.0

❗ Note: Use the particle-firmware-library repository to add memfault support to an application. This repository is updated as part of the release process for the memfault-firmware-sdk.

Welcome to your library!

To get started, add the library to your particle application:

$ git submodule add https://github.com/memfault/particle-firmware-library lib/memfault

Integration Steps

  1. Add the following to your application

    #include "memfault.h"
    Memfault memfault;
    
    void loop() {
      // ...
      memfault.process();
      // ...
    }
  2. Create a Memfault Project Key at https://goto.memfault.com/create-key/particle and copy it to your clipboard.

  3. Navigate to the Integrations tab in the Particle Cloud UI and create a new "Custom Template" webhook. Be sure to replace MEMFAULT_PROJECT_KEY below with the one copied in step 2.

    {
      "event": "memfault-chunks",
      "responseTopic": "",
      "url": "https://chunks.memfault.com/api/v0/chunks/{{PARTICLE_DEVICE_ID}}",
      "requestType": "POST",
      "noDefaults": false,
      "rejectUnauthorized": true,
      "headers": {
        "Memfault-Project-Key": "MEMFAULT_PROJECT_KEY",
        "Content-Type": "application/octet-stream",
        "Content-Encoding": "base64"
      },
      "body": "{{{PARTICLE_EVENT_VALUE}}}"
    }

Example Usage

See the examples/memfault_test/ folder for a complete application demonstrating how to use Memfault.

Questions

Don't hesitate to contact us for help! You can reach us through support@memfault.com.