如果你一直關注樂鑫，應該對 ESP RainMaker 及其豐富的功能有所了解。ESP RainMaker 重要特性之一是輕量化，它能充當ESP 節點和移動端App、Alexa、GVA等客戶端之間的“隧道”，具備極大的靈活性和可擴展性。

ESP RainMaker 支持創建任何設備，開發多種設備功能，最終還能通過移動端App實現設備控制。

ESP-RainMaker項目用于實現“節點”，用戶登錄后可以使用客戶端（如手機應用程序）進行對節點進行配置，然后通過ESPRainMakerCloud 進行控制。

節點

節點是基于 ESP32 的單個產品。它具有關聯的標識符（node_id） 和聲明服務提供的一組憑據，用于對節點進行合法驗證。用戶可以為節點指定好名稱。單個節點可以公開多個設備。

設備

設備是用戶可控制的邏輯實體，如開關、燈泡、恒溫器、溫度傳感器等。一個簡單的節點通常只有一個設備。但是，ESP32 也可以有多個設備，例如在一塊板上安裝兩個開關，或者它可以充當其他設備（例如BLE 傳感器）的橋接器。每個設備在節點中必須具有唯一的名稱，并且可以選擇具體的類型。

參數

這些是設備的控制和監視參數，用于用戶在APP或者服務器上進行控制或者監視。例如：開/關電源狀態、亮度、電流/目標溫度等所有這些參數在設備中都必須具有唯一的名稱。這些參數還可以具有其他字段，如值、類型、邊界、UI 信息等。參數值可以是布爾值、整數、浮點數或字符串。

獲取ESP RainMaker項目

使用以下方法下載RainMaker：

1、git clone https://github.com/espressi?f/esp-rainmaker.git

2、git clone https://github.com/espressif/esp-iot-bridge.git

第一個倉庫為Rainmaker倉庫，配合ESP Rainmaker APP使用 。

第二個倉庫集成了Rainmaker和lite mesh，本文示例使用該倉庫，使用樂鑫nova home app關于lite mesh的內容請關注后續文章。

執行以下命令以拉入子模塊：

git submodule update--init --recursive --progress

構建和刷新固件

Rainmaker工程位于esp-iot-bridge倉庫的examples/rainmaker目錄下，編譯以及燒錄基于ESP-IDF，本文基于IDF5.0。

如果您是第一次使用，建議先擦除閃存，然后再刷新固件。以下是步驟：

cd ~/esp-iot-bridge/examples/rainmaker/led_light/(進入例程目錄)

idf.py set-target esp32/esp32s2/esp32c3/esp32s3(選擇芯片類型)

[注意：ESP RainMaker 可與 ESP32系列所有芯片配合使用，如 ESP32、ESP32-S2、ESP32-C3 和 ESP32-S3。]

idf.py build(編譯)

idf.py erase_flash(擦除)

idf.py flash monitor(燒錄并運行)

代碼運行成功后

Part.1

找到設備名稱

Part.2

打開App添加你的第一個設備

Part.3

找到設備同意藍牙連接

Part.4

輸入WiFi賬號密碼進行配網

左右滑動查看圖集

Part.5

進入在線調節參數頁面

基于ESP RainMaker的應用程序的典型代碼如下

例程中Rainmaker節點、設備、屬性的初始化在app_rainmaker_start()函數中實現，具體可以參考app_rainmaker.c文件，具體流程為

初始化ESP RainMaker節點esp_rmaker_node_init(),方法是向其傳遞配置 esp_rmaker_config_t()節點名稱和類型。

創建設備esp_rmaker_device_create()。RainMaker節點本身沒有特定的值，除非它下面有設備。

添加參數和其他元數據。

將設備添加到節點。

啟動RainMaker代理esp_rmaker_start()。這將啟動RainMaker核心任務，該任務將等待Wifi，如果需要，通過MQTT連接到RainMaker Cloud，報告節點配置，報告參數值，然后等待命令。

啟動無線網絡 app_wifi_start()

以上是 ESP RainMaker 項目開發的基本介紹。您無需在云后臺進行任何配置或更改，就可以輕松添加自定義功能，擁有極大的靈活性與可擴展性。

審核編輯：湯梓紅