/esp-rainmaker

ESP RainMaker Agent for firmware development

Primary LanguageCApache License 2.0Apache-2.0

ESP RainMaker

Note: For major changes, please refer this file.

Introduction

ESP RainMaker is an end-to-end solution offered by Espressif to enable remote control and monitoring for products based on ESP32 series of SoCs (e.g., ESP32, ESP32-S2, ESP32-C3, ESP32-C6, ESP32-C2, etc.) without any configuration required in the Cloud.

The primary components of this solution are:

  • Claiming Service (to get the Cloud connectivity credentials)
  • RainMaker Agent (i.e. this repo, to develop the firmware)
  • RainMaker Cloud (backend, offering remote connectivity)
  • RainMaker Phone App/CLI (Client utilities for remote access)

The key features of ESP RainMaker are:

  1. Ability to define own devices and parameters, of any type, in the firmware.
  2. Zero configuration required on the Cloud.
  3. Phone apps that dynamically render the UI as per the device information.

Get ESP RainMaker

Please clone this repository using the below command:

git clone --recursive https://github.com/espressif/esp-rainmaker.git

Note the --recursive option. This is required to pull in the various dependencies into esp-rainmaker. In case you have already cloned the repository without this option, execute this to pull in the submodules: git submodule update --init --recursive

Please check the ESP RainMaker documentation here to get started.

Each example has its own README with additional information about using the example.

Supported ESP-IDF versions

ESP RainMaker can work with ESP IDF 4.1 and above.

Phone Apps

Android

iOS

Discussions

ESP32 Forum

Gitter Chat