# minna-switch

**Repository Path**: manykit/minna-switch

## Basic Information

- **Project Name**: minna-switch
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-13
- **Last Updated**: 2025-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Minna Switch Box

一个适用于 ESP8266 的简易 WiFi + MQTT 开关盒固件。  
支持 SoftAP 配网、MQTT 控制、本地按钮控制、LED状态显示。

## 功能

- SoftAP + WebServer 配网
- SPIFFS 保存配置信息
- MQTT 客户端自动重连
- 按钮本地控制开关
- 长按按钮6秒清空WiFi并进入配网模式
- LED 指示连接状态
- 串口输出调试信息

## 引脚定义

| 引脚  | 功能          |
|-------|---------------|
| D4    | 继电器 A      |
| D1    | 继电器 B      |
| D7    | 按钮输入      |
| D13   | LED 指示灯    |

## LED状态指示

- 启动时：LED快速闪烁4次，表示系统启动
- 正常工作：LED常亮（WiFi + MQTT 已连接）
- MQTT断线重连中：LED慢闪
- 进入SoftAP配网模式：LED慢闪4次
- 按钮长按2秒：LED快闪后重启

## MQTT主题

- `home/device/info` → 上报设备信息
- `home/device/status_rep/<deviceID>` → 上报当前开关状态
- `home/device/status_req/<deviceID>` → 请求当前状态
- `home/device/set/<deviceID>` → 设置开关状态（例如：`{"state":1}`）

## 使用方法

1. 将固件烧录到 ESP8266 开发板。
2. 首次启动或长按按钮6秒 → 进入 SoftAP 配网模式。
3. 手机连接 WiFi `minna-setup`，浏览器访问 `192.168.4.1`。
4. 输入 WiFi 名称、密码、deviceID、MQTT服务器地址。
5. 配置后设备自动联网并开始工作。

## 依赖库

- ESP8266 Arduino Core
- 以下库：
  - ESP8266WiFi
  - ESP8266WebServer
  - FS
  - ArduinoJson
  - PubSubClient
  - OneButton

## 协议

MIT 开源协议  
(c) 2024 ManyKit 版权所有