Sonoff-OTA-Flash-CLI 使用教程

项目介绍

Sonoff-OTA-Flash-CLI 是一个 Bash 脚本，用于通过命令行为 Sonoff DIY 模式设备执行 OTA（Over the Air）固件更新。该脚本默认安装 Tasmota 固件，也可以根据需要安装其他固件。支持 DIY 模式协议 v2.0（固件 3.5.0 或更高版本）的设备包括 Sonoff Basic R3、Sonoff RF 等。

项目快速启动

安装依赖

在开始使用之前，请确保你的系统已安装以下依赖工具：

• dns-sd（Mac OS）
• avahi-browse（Linux）
• expect（Mac OS 的超时处理）
• dscacheutil 或 getent（IP 地址解析）
• curl（HTTP 请求）

下载并运行脚本

1. 克隆项目仓库：

   git clone https://github.com/njh/sonoff-ota-flash-cli.git
   cd sonoff-ota-flash-cli
   

2. 运行脚本：

   ./sonoff-ota-flash.sh
   

示例代码

以下是一个简单的示例，展示如何使用该脚本进行固件更新：

$ ./sonoff-ota-flash.sh
Checking new firmware file exists OK
Looking up sha256sum for firmware OK
Searching for Sonoff module on network
Found module on network
Hostname: eWeLink_1000e4c17c
IPv4 Address: 192.168.1.104
Getting Module Info
{
  "seq": 2,
  "error": 0,
  "data": {
    "switch": "off",
    "startup": "off",
    "pulse": "off",
    "pulseWidth": 500,
    "ssid": "test",
    "otaUnlock": false,
    "fwVersion": "3.5.0",
    "deviceid": "1000e4c17c",
    "bssid": "b4:fb:de:ad:be:ef",
    "signalStrength": -52
  }
}
Unlocking for OTA flashing
{
  "seq": 2,
  "error": 0
}
Proceed with flashing [N/y] y
Requesting OTA flashing
{
  "seq": 3,
  "error": 0
}
Please wait for your device to finish flashing

应用案例和最佳实践

自动化维护

Sonoff-OTA-Flash-CLI 可以集成到自动化脚本中，定期检查并更新 Sonoff 设备的固件，确保设备始终运行在最新的固件版本上，从而提高安全性和稳定性。

批量更新

对于拥有多个 Sonoff 设备的用户，可以使用该脚本编写批处理脚本，一次性更新所有设备的固件，大大提高维护效率。

自定义固件

用户可以根据自己的需求，编译并安装自定义的 Tasmota 固件，实现更多个性化的功能和配置。

典型生态项目

Tasmota

Tasmota 是一个开源的固件，专为 ESP8266 和 ESP32 设备设计，提供了丰富的功能和灵活的配置选项。Sonoff-OTA-Flash-CLI 默认安装 Tasmota 固件，是 Sonoff 设备的首选固件之一。

Home Assistant

Home Assistant 是一个开源的家庭自动化平台，支持多种设备和协议。通过安装 Tasmota 固件，Sonoff 设备可以无缝集成到 Home Assistant 中，实现更高级的自动化和控制功能。

ESPHome

ESPHome 是一个基于 YAML 的系统，用于构建自定义固件，适用于 ESP8266 和 ESP32 设备。通过 Sonoff-OTA-Flash-CLI，用户可以轻松安装 ESPHome 固件，实现更多定制化的功能。

通过以上教程，你可以轻松地使用 Sonoff-OTA-Flash-CLI 进行 Sonoff 设备的固件更新，并探索更多高级应用和生态项目。