SDK

Add the SDK

Extract the release source bundle as components/espectre/, then declare the component from your application:

# main/CMakeLists.txt
idf_component_register(
  SRCS "main.cpp"
  REQUIRES espectre
)

The SDK is source-based, so there is no chip-specific library to link. Optional Direct WebSocket, MQTT, provisioning, OTA, and stream support stay disabled until selected in menuconfig. The first-party C++ frontends enable the Direct capability they use.

Drive the runtime

Start it after your station has joined Wi-Fi, call loop() continuously, and react to the events your product needs:

#include "espectre_sdk.h"

class ProductFrontend : public espectre::IRuntimeListener {
 public:
  bool setup() {
    runtime_.set_config(espectre::RuntimeConfig{});
    return runtime_.setup(this);
  }

  void loop() { runtime_.loop(); }

  void on_motion_state_changed(
      const espectre::RuntimeSnapshot& snapshot) override {
    if (!snapshot.ready_to_publish) return;
    publish_motion(snapshot.motion_state == espectre::MotionState::MOTION);
  }

 private:
  espectre::RuntimeFrontendController runtime_;
};

Keep three contracts

• Publish only when snapshot.ready_to_publish is true.
• Run setup(), loop(), and shutdown() on one task.
• Check capabilities() before exposing runtime controls.