# weather_clock_app

**Repository Path**: IwE_wtF/weather_clock_app

## Basic Information

- **Project Name**: weather_clock_app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ESP32 天气时钟配置 App

HBuilderX / uni-app Android App，用于 ESP32 天气时钟 SoftAP 配网和 320x240 自定义显示图片上传。

## 项目能力

- SoftAP HTTP 配网，默认地址 `http://192.168.4.1`
- 保存配网成功后 ESP32 返回的局域网 IP
- 选择本地图片，支持缩放和水平/垂直位置裁剪
- 将画面转换为 `320x240` RGB888 原始像素矩阵并上传
- 内置 Mock ESP32 开关，便于没有真实设备时预览流程

## ESP32 HTTP 接口约定

```http
GET /api/device
```

返回示例：

```json
{
  "name": "ESP32 Weather Clock",
  "firmware": "1.0.0",
  "screen": { "width": 320, "height": 240, "color": "RGB565" },
  "weather": { "provider": "Seniverse", "owner": "esp32", "state": "ready" }
}
```

```http
POST /api/wifi
Content-Type: application/json

{ "ssid": "HomeWiFi", "password": "password" }
```

```http
GET /api/wifi/status
```

返回示例：

```json
{
  "state": "connected",
  "staIp": "http://192.168.1.88",
  "message": "Wi-Fi 已连接"
}
```

```http
POST /api/display/image
Content-Type: application/octet-stream
X-Image-Width: 320
X-Image-Height: 240
X-Image-Format: RGB888
X-Image-Byte-Order: RGB
X-Image-Bytes: 230400
```

请求体为连续 RGB888 原始像素矩阵，总长度 `320 * 240 * 3 = 230400` 字节。字节顺序为：

```text
R0 G0 B0 R1 G1 B1 ... R76799 G76799 B76799
```

## 使用方式

1. 用 HBuilderX 打开本目录。
2. 运行到 Android 基座或真机。
3. 如无真实 ESP32，先在“设置”页开启 Mock ESP32。
4. 真机配网时，手机先连接 ESP32 SoftAP，再提交 Wi-Fi 信息。

天气由 ESP32 固件通过心知天气 API 获取，App 不保存或调用心知天气 Key。