cf49ba4219
The regular OTA upgrades with ESP RainMaker required an additional https connection to fetch the OTA image, which has a significant impact on heap usage. With MQTT OTA, the same MQTT channel used for rest of the RainMaker communication is used to fetch the OTA image, thereby saving on RAM. This could be slightly slower and may odd some cost. but the overall impact would be low enough when compared against the advantages. Signed-off-by: sanket.wadekar <sanket.wadekar@espressif.com> Co-authored-by: Piyush Shah <piyush.shah@espressif.com>
ESP RainMaker
This branch will not support esp-idf v4.x releases anymore as they have reached their end of life. Please check out
idf_4_x_compatbranch if your project requires it.
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-S3, ESP32-C2, ESP32-C3, ESP32-C6, ESP32-H2, ESP32-C5 (preview), 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:
- Ability to define own devices and parameters, of any type, in the firmware.
- Zero configuration required on the Cloud.
- 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
