diff --git a/apps/esphome/README.md b/apps/esphome/README.md new file mode 100644 index 000000000000..4914ce844b61 --- /dev/null +++ b/apps/esphome/README.md @@ -0,0 +1,33 @@ +# 使用说明 + +- **默认访问地址** + ESPHome Dashboard 默认运行在 6052 端口: + ``` + IP:6052 + ``` + +# 关于 ESPHome + +将 ESP32、ESP8266、BK72xx、RP2040 和其他支持的板子通过简单的 YAML 配置转变为强大的智能家居设备。 + +### 主要特性: +- **无需编程**:使用简单的 YAML 配置文件而不是复杂的 C++代码。 +- **无线更新**:通过OTA升级您的设备,无需物理访问。 +- **模块化设计**:支持数百种传感器、显示屏和其他组件。 +- **本地控制**:设备本地运行,无需依赖云服务。 + +### 谁使用 ESPHome? + - **DIY 爱好者** - 创建定制传感器、开关和显示屏,满足特定需求 + - **智能家居爱好者** - 用经济实惠的定制设备扩展他们的智能家居系统 + - **专业集成商** - 为客户部署可靠、本地控制的智能设备 + - **制造商** - 创建适用于 ESPHome 认证的产品,配备标准化固件 + +### ESPHome 支持哪些微控制器? + - **Espressif ESP32 和 ESP8266** - 广泛支持 ESP32 和 ESP8266 微控制器,许多物联网项目的核心。 + - **RP2040** - 支持树莓派的 RP2040 微控制器。 + - **其他** - 支持 Nordic Semiconductor nRF52、Realtek RTL87xx 和 Becken BK72xx 芯片。 + - **桌面** - 许多 ESPHome 组件可以在使用主机平台的情况下在桌面计算机上运行! + +### 注意事项: +1. **网络模式**:本应用使用 `host` 网络模式,以便能够自动发现局域网内的 ESP 设备。 +2. **USB 烧录**:如果您需要通过 USB 串口直接从服务器烧录固件,可能需要在 Docker 中映射设备路径(如 `/dev/ttyUSB0`),或使用 ESPHome Web 端口进行首次烧录。 \ No newline at end of file diff --git a/apps/esphome/data.yml b/apps/esphome/data.yml new file mode 100644 index 000000000000..5f225136dc25 --- /dev/null +++ b/apps/esphome/data.yml @@ -0,0 +1,19 @@ +name: ESPHome +tags: + - 工具 +title: 通过简单的配置文件控制您的 ESP8266/ESP32。 +description: 将 ESP32、ESP8266、BK72xx、RP2040 和其他支持的板子通过简单的 YAML 配置转变为强大的智能家居设备。 +additionalProperties: + key: esphome + name: ESPHome + tags: + - Tool + shortDescZh: 简单强大的 ESP8266/ESP32 配置与固件编译工具。 + shortDescEn: ESPHome is a system to control your ESP8266/ESP32 by simple yet powerful configuration files. + type: tool + crossVersionUpdate: true + limit: 0 + recommend: 0 + website: https://esphome.io/ + github: https://github.com/esphome/esphome + document: https://esphome.io/guides/getting_started_command_line/ diff --git a/apps/esphome/latest/data.yml b/apps/esphome/latest/data.yml new file mode 100644 index 000000000000..0b4f776d35ac --- /dev/null +++ b/apps/esphome/latest/data.yml @@ -0,0 +1,31 @@ +additionalProperties: + formFields: + - default: ./data + edit: true + envKey: DATA_PATH + labelEn: Config folder path + labelZh: 数据文件夹路径 + required: true + type: text + - default: 6052 + disabled: true + envKey: PANEL_APP_PORT_HTTP + labelEn: Port + labelZh: HTTP 端口 + required: true + rule: paramPort + type: number + - default: "" + edit: true + envKey: USERNAME + labelEn: Web Password + labelZh: 控制台用户名 + required: false + type: text + - default: "" + edit: true + envKey: PASSWORD + labelEn: Web Password + labelZh: 控制台密码 + required: false + type: password diff --git a/apps/esphome/latest/docker-compose.yml b/apps/esphome/latest/docker-compose.yml new file mode 100644 index 000000000000..4590609e5a1f --- /dev/null +++ b/apps/esphome/latest/docker-compose.yml @@ -0,0 +1,16 @@ +services: + esphome: + container_name: ${CONTAINER_NAME} + restart: always + privileged: true + network_mode: host + volumes: + - "${DATA_PATH}:/config" + - /etc/localtime:/etc/localtime:ro + environment: + - TZ=Asia/Shanghai + - "USERNAME=${USERNAME}" + - "PASSWORD=${PASSWORD}" + image: esphome/esphome:latest + labels: + createdBy: "Apps" diff --git a/apps/esphome/logo.png b/apps/esphome/logo.png new file mode 100644 index 000000000000..fbf43c81b7d9 Binary files /dev/null and b/apps/esphome/logo.png differ