跳到主要内容

固件预生产检查清单

在确定固件之前，请完成以下事项。

创建项目​

虽然可以参照标准示例来创建项目，但建议复制示例代码后再根据具体使用场景进行改动，并单独维护，以避免在 esp-rainmaker 代码库更新时发生冲突。另外，建议使用 Git 等版本控制系统跟踪每个项目的改动。

Claiming​

私有 RainMaker 部署不支持 Claiming 功能。请使用 RainMaker Admin CLI 生成需要烧录到工厂分区的凭证。此外，为节省 flash 使用空间，请在项目的 sdkconfig.defaults 文件中禁用以下配置选项：

CONFIG_ESP_RMAKER_ASSISTED_CLAIM
CONFIG_ESP_RMAKER_SELF_CLAIM

配网二维码​

开发环境中，配网二维码会显示在串口终端上；但在生产环境中，二维码需要在设备外部生成。RainMaker Admin CLI 能够生成这些二维码。

空中升级 (OTA)​

在 switch 和 led_light 示例中，默认启用 OTA 固件更新。代码片段如下：

esp_rmaker_ota_config_t ota_config = {
   .server_cert = ESP_RMAKER_OTA_DEFAULT_SERVER_CERT,
};
esp_rmaker_ota_enable(&ota_config, OTA_USING_PARAMS);

该配置用于基于参数的 OTA 升级，适用于开发者使用场景。若通过管理面板进行 OTA 升级，请将 OTA_USING_PARAMS 改为 OTA_USING_TOPICS：

esp_rmaker_ota_enable(&ota_config, OTA_USING_TOPICS);

更多有关 OTA 的信息，请参考本指南。请注意，只有超级管理员用户才可以通过管理面板执行 OTA 操作。

时区​

如果计划使用定时功能，请确保固件中设置了时区，或添加了时区服务以支持运行时配置时区。详情请参阅本指南。大多数示例已默认添加时区服务。

定时​

若希望固件支持定时功能，需显式添加相应的 API。详情请参阅本指南。请注意，定时功能依赖时区，时区是其正常工作的前提。大多数示例已默认添加定时服务。

定时任务数量限制​

前往 idf.py menuconfig > ESP RainMaker Config > ESP RainMaker Scheduling > Maximum Schedules，通过配置选项 CONFIG_ESP_RMAKER_SCHEDULING_MAX_SCHEDULES 来设置定时任务的最大数量限制。默认值之前为 5，现已改为 10。如果该数量不足以满足你的需求，可以自行增加。需要注意的是，由于所有定时信息均作为 RainMaker 的“参数”上传，且 RainMaker 使用 AWS IoT Shadow 在云端维护参数值，所有参数总大小限制为 8 KB。

本地控制​

ESP RainMaker 提供本地控制功能，优势有：

  • 响应更快
  • 成本更低（避免调用 REST API）

启用方法请参考本指南。启用前，请务必阅读安全注意事项。

On this page