refactor(reTerminal): restructure E1001/E1002 code with framework pattern

- Reorganize code into 3 sections: User Config, Custom UI, Framework
- Add EntityData struct and API functions (getEntity, getEntityById, etc.)
- Move predefinitions before user code to fix compilation errors
- Provide both dynamic and fixed layout examples for dashboards
- Keep all original UI designs unchanged
- Update README files for various examples

Author: limengdu

arduino/SeeedHADiscovery/examples/ButtonSwitch/README.md

@@ -9,6 +9,7 @@ A multi-click button detection example that creates three independent switches i
 - **Long Press (>1s)**: Toggle Switch 3
 - Bidirectional control (button ↔ Home Assistant)
 - Real-time state synchronization
+- **WiFi Provisioning**: Web-based WiFi configuration (no hardcoded credentials needed)
 
 ## Hardware Requirements
 
@@ -43,9 +44,22 @@ Install manually from [GitHub](https://github.com/limengdu/SeeedHADiscovery).
 
 ## Quick Start
 
-### 1. Configure WiFi
+### 1. WiFi Configuration
 
+**Option A: WiFi Provisioning (Recommended)**
+
+WiFi provisioning is enabled by default. On first boot:
+1. Device creates AP hotspot: `Seeed_Button_AP`
+2. Connect your phone/computer to this AP
+3. Browser opens automatically, or navigate to `http://192.168.4.1`
+4. Select your WiFi network and enter password
+5. Device restarts and connects to your WiFi
+
+**Option B: Hardcoded Credentials**
+
+To use hardcoded credentials instead:
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "Your_WiFi_SSID";
 const char* WIFI_PASSWORD = "Your_WiFi_Password";
 ```
@@ -56,7 +70,14 @@ const char* WIFI_PASSWORD = "Your_WiFi_Password";
 #define BUTTON_PIN D1  // Change if needed
 ```
 
-### 3. Upload and Connect
+### 3. ESP32-C5 5GHz WiFi (Optional)
+
+To force a specific WiFi band on ESP32-C5:
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // or WIFI_BAND_MODE_2G_ONLY
+```
+
+### 4. Upload and Connect
 
 1. Select board: **XIAO ESP32C6** (or your board)
 2. Upload the sketch
@@ -105,8 +126,12 @@ const char* WIFI_PASSWORD = "Your_WiFi_Password";
 ### WiFi connection fails
 - Verify SSID and password
 - Check WiFi signal strength
+- If using provisioning, ensure device is in AP mode
+
+### Can't access provisioning page
+- Make sure you're connected to the device's AP
+- Try navigating manually to `http://192.168.4.1`
 
 ## License
 
 Part of the SeeedHADiscovery library.
-

arduino/SeeedHADiscovery/examples/ButtonSwitch/README_CN.md

@@ -9,6 +9,7 @@
 - **长按（>1秒）**：切换开关 3
 - 双向控制（按钮 ↔ Home Assistant）
 - 实时状态同步
+- **WiFi 配网**：网页配置 WiFi（无需硬编码凭据）
 
 ## 硬件要求
 
@@ -43,9 +44,22 @@
 
 ## 快速开始
 
-### 1. 配置 WiFi
+### 1. WiFi 配置
 
+**方式 A：WiFi 配网（推荐）**
+
+WiFi 配网默认启用。首次启动时：
+1. 设备创建 AP 热点：`Seeed_Button_AP`
+2. 将手机/电脑连接到此 AP
+3. 浏览器自动打开，或手动访问 `http://192.168.4.1`
+4. 选择你的 WiFi 网络并输入密码
+5. 设备重启并连接到你的 WiFi
+
+**方式 B：硬编码凭据**
+
+如需使用硬编码凭据：
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "你的WiFi名称";
 const char* WIFI_PASSWORD = "你的WiFi密码";
 ```
@@ -56,7 +70,14 @@ const char* WIFI_PASSWORD = "你的WiFi密码";
 #define BUTTON_PIN D1  // 根据需要修改
 ```
 
-### 3. 上传并连接
+### 3. ESP32-C5 5GHz WiFi（可选）
+
+在 ESP32-C5 上强制使用特定 WiFi 频段：
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // 或 WIFI_BAND_MODE_2G_ONLY
+```
+
+### 4. 上传并连接
 
 1. 选择开发板：**XIAO ESP32C6**（或你的开发板）
 2. 上传程序
@@ -105,8 +126,12 @@ const char* WIFI_PASSWORD = "你的WiFi密码";
 ### WiFi 连接失败
 - 验证 SSID 和密码
 - 检查 WiFi 信号强度
+- 如使用配网，确保设备处于 AP 模式
+
+### 无法访问配网页面
+- 确保已连接到设备的 AP
+- 尝试手动访问 `http://192.168.4.1`
 
 ## 许可证
 
 SeeedHADiscovery 库的一部分。
-

arduino/SeeedHADiscovery/examples/HAStateSubscribe/README.md

@@ -9,6 +9,7 @@ Receive and display entity states from Home Assistant on your device. Perfect fo
 - Real-time state updates
 - Access to entity attributes (friendly name, unit, device class)
 - Dynamic entity configuration via HA interface
+- **WiFi Provisioning**: Web-based WiFi configuration (no hardcoded credentials needed)
 
 ## Use Cases
 
@@ -41,20 +42,40 @@ Install manually from [GitHub](https://github.com/limengdu/SeeedHADiscovery).
 
 ## Quick Start
 
-### 1. Configure WiFi
+### 1. WiFi Configuration
 
+**Option A: WiFi Provisioning (Recommended)**
+
+WiFi provisioning is enabled by default. On first boot:
+1. Device creates AP hotspot: `Seeed_StateDisplay_AP`
+2. Connect your phone/computer to this AP
+3. Browser opens automatically, or navigate to `http://192.168.4.1`
+4. Select your WiFi network and enter password
+5. Device restarts and connects to your WiFi
+
+**Option B: Hardcoded Credentials**
+
+To use hardcoded credentials instead:
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "your-wifi-ssid";
 const char* WIFI_PASSWORD = "your-wifi-password";
 ```
 
-### 2. Upload and Connect
+### 2. ESP32-C5 5GHz WiFi (Optional)
+
+To force a specific WiFi band on ESP32-C5:
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // or WIFI_BAND_MODE_2G_ONLY
+```
+
+### 3. Upload and Connect
 
 1. Upload the sketch to your device
 2. Open Serial Monitor (115200 baud)
 3. Add device in Home Assistant
 
-### 3. Configure Subscriptions in HA
+### 4. Configure Subscriptions in HA
 
 1. Find your device in **Settings** → **Devices & Services**
 2. Click **Configure** on your device
@@ -142,7 +163,10 @@ if (temp && temp->hasValue() && temp->getFloat() > 28.0) {
 - Verify HA WebSocket connection
 - Check if entities exist in HA
 
+### Can't access provisioning page
+- Make sure you're connected to the device's AP
+- Try navigating manually to `http://192.168.4.1`
+
 ## License
 
 Part of the SeeedHADiscovery library.
-

arduino/SeeedHADiscovery/examples/HAStateSubscribe/README_CN.md

@@ -9,6 +9,7 @@
 - 实时状态更新
 - 访问实体属性（友好名称、单位、设备类别）
 - 通过 HA 界面动态配置实体
+- **WiFi 配网**：网页配置 WiFi（无需硬编码凭据）
 
 ## 使用场景
 
@@ -41,20 +42,40 @@
 
 ## 快速开始
 
-### 1. 配置 WiFi
+### 1. WiFi 配置
 
+**方式 A：WiFi 配网（推荐）**
+
+WiFi 配网默认启用。首次启动时：
+1. 设备创建 AP 热点：`Seeed_StateDisplay_AP`
+2. 将手机/电脑连接到此 AP
+3. 浏览器自动打开，或手动访问 `http://192.168.4.1`
+4. 选择你的 WiFi 网络并输入密码
+5. 设备重启并连接到你的 WiFi
+
+**方式 B：硬编码凭据**
+
+如需使用硬编码凭据：
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "你的WiFi名称";
 const char* WIFI_PASSWORD = "你的WiFi密码";
 ```
 
-### 2. 上传并连接
+### 2. ESP32-C5 5GHz WiFi（可选）
+
+在 ESP32-C5 上强制使用特定 WiFi 频段：
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // 或 WIFI_BAND_MODE_2G_ONLY
+```
+
+### 3. 上传并连接
 
 1. 上传程序到设备
 2. 打开串口监视器（115200 波特率）
 3. 在 Home Assistant 中添加设备
 
-### 3. 在 HA 中配置订阅
+### 4. 在 HA 中配置订阅
 
 1. 在 **设置** → **设备与服务** 中找到你的设备
 2. 点击设备上的 **配置**
@@ -142,7 +163,10 @@ if (temp && temp->hasValue() && temp->getFloat() > 28.0) {
 - 验证 HA WebSocket 连接
 - 检查实体是否存在于 HA 中
 
+### 无法访问配网页面
+- 确保已连接到设备的 AP
+- 尝试手动访问 `http://192.168.4.1`
+
 ## 许可证
 
 SeeedHADiscovery 库的一部分。
-

arduino/SeeedHADiscovery/examples/LEDSwitch/README.md

@@ -8,6 +8,7 @@ Control an LED from Home Assistant via WiFi. This example demonstrates basic swi
 - Real-time state feedback
 - Support for both onboard and external LEDs
 - Configurable LED polarity (active high/low)
+- **WiFi Provisioning**: Web-based WiFi configuration (no hardcoded credentials needed)
 
 ## Hardware Requirements
 
@@ -55,9 +56,22 @@ Install manually from [GitHub](https://github.com/limengdu/SeeedHADiscovery).
 
 ## Quick Start
 
-### 1. Configure WiFi
+### 1. WiFi Configuration
 
+**Option A: WiFi Provisioning (Recommended)**
+
+WiFi provisioning is enabled by default. On first boot:
+1. Device creates AP hotspot: `Seeed_LED_AP`
+2. Connect your phone/computer to this AP
+3. Browser opens automatically, or navigate to `http://192.168.4.1`
+4. Select your WiFi network and enter password
+5. Device restarts and connects to your WiFi
+
+**Option B: Hardcoded Credentials**
+
+To use hardcoded credentials instead:
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "Your_WiFi_SSID";
 const char* WIFI_PASSWORD = "Your_WiFi_Password";
 ```
@@ -78,7 +92,14 @@ For XIAO ESP32-C3 or external LED:
 #define LED_ACTIVE_LOW true
 ```
 
-### 4. Upload and Connect
+### 4. ESP32-C5 5GHz WiFi (Optional)
+
+To force a specific WiFi band on ESP32-C5:
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // or WIFI_BAND_MODE_2G_ONLY
+```
+
+### 5. Upload and Connect
 
 1. Select board: **XIAO ESP32C6** (or your board)
 2. Upload the sketch
@@ -112,9 +133,12 @@ Access device status at: `http://<device_ip>/`
 ### WiFi connection fails
 - Verify SSID and password
 - Check WiFi signal strength
-- Red LED will blink if connection fails
+- LED will blink if connection fails
+
+### Can't access provisioning page
+- Make sure you're connected to the device's AP
+- Try navigating manually to `http://192.168.4.1`
 
 ## License
 
 Part of the SeeedHADiscovery library.
-

arduino/SeeedHADiscovery/examples/LEDSwitch/README_CN.md

@@ -8,6 +8,7 @@
 - 实时状态反馈
 - 支持板载和外接 LED
 - 可配置 LED 极性（高电平/低电平有效）
+- **WiFi 配网**：网页配置 WiFi（无需硬编码凭据）
 
 ## 硬件要求
 
@@ -55,9 +56,22 @@ GPIO 引脚 ---[220Ω]--- LED (+) --- LED (-) --- GND
 
 ## 快速开始
 
-### 1. 配置 WiFi
+### 1. WiFi 配置
 
+**方式 A：WiFi 配网（推荐）**
+
+WiFi 配网默认启用。首次启动时：
+1. 设备创建 AP 热点：`Seeed_LED_AP`
+2. 将手机/电脑连接到此 AP
+3. 浏览器自动打开，或手动访问 `http://192.168.4.1`
+4. 选择你的 WiFi 网络并输入密码
+5. 设备重启并连接到你的 WiFi
+
+**方式 B：硬编码凭据**
+
+如需使用硬编码凭据：
 ```cpp
+#define USE_WIFI_PROVISIONING false
 const char* WIFI_SSID = "你的WiFi名称";
 const char* WIFI_PASSWORD = "你的WiFi密码";
 ```
@@ -78,7 +92,14 @@ const char* WIFI_PASSWORD = "你的WiFi密码";
 #define LED_ACTIVE_LOW true
 ```
 
-### 4. 上传并连接
+### 4. ESP32-C5 5GHz WiFi（可选）
+
+在 ESP32-C5 上强制使用特定 WiFi 频段：
+```cpp
+#define WIFI_BAND_MODE WIFI_BAND_MODE_5G_ONLY  // 或 WIFI_BAND_MODE_2G_ONLY
+```
+
+### 5. 上传并连接
 
 1. 选择开发板：**XIAO ESP32C6**（或你的开发板）
 2. 上传程序
@@ -114,7 +135,10 @@ const char* WIFI_PASSWORD = "你的WiFi密码";
 - 检查 WiFi 信号强度
 - 如果连接失败，LED 会闪烁
 
+### 无法访问配网页面
+- 确保已连接到设备的 AP
+- 尝试手动访问 `http://192.168.4.1`
+
 ## 许可证
 
 SeeedHADiscovery 库的一部分。
-