# smart-socket-firmware

**Repository Path**: nzttj/smart-socket-firmware

## Basic Information

- **Project Name**: smart-socket-firmware
- **Description**: 基于ESP8266和BL0942芯片的智能电能监测插座，支持WiFi配网、MQTT远程控制和微信小程序本地控制。
- **Primary Language**: C/C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-02-12
- **Last Updated**: 2025-12-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能插座项目 - ESP8266电能监测插座

[![License: GPL-3.0](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://opensource.org/licenses/GPL-3.0)


基于ESP8266和BL0942芯片的智能电能监测插座，支持WiFi配网、MQTT远程控制和微信小程序本地控制。

## 功能特性

- ⚡ 实时电能监测（电压/电流/功率/电量）
- 📶 支持AP配网模式（长按3秒触发）
- 🌐 网页端WiFi/MQTT配置界面
- 📡 MQTT协议远程控制开关
- 🔌 继电器状态本地控制
- 🔋 支持FLASH存储配置信息
- 🔄 固件OTA在线更新
- 📊 ~~数据上报间隔可配置~~
- 🚨 ~~过载保护阈值可配置~~
- 🛡️ 儿童安全锁
- 💡 LED指示灯状态开关
- ⚠️ 断电后上电状态可配置（断电前状态/默认开启/默认关闭）
- ⏰ 支持本地定时开关控制
- 📊 支持周/月用电量统计

## 硬件要求

| 组件              | 规格                     |
|-------------------|-------------------------|
| 主控模块          | ESP8266 (ESP-12F)        |
| 电能计量芯片      | BL0942                   |
| 继电器模块        | 10A 250VAC               |
| 按键              | 轻触开关                 |
| 电源模块          | 5V 1A (建议使用隔离电源)  |
| 指示灯            | LED (蓝)                 |

## 软件依赖

- [ESP8266_RTOS_SDK](https://github.com/espressif/ESP8266_RTOS_SDK)

## 安装与使用

### 开发环境配置

1. 安装 ESP8266 开发环境
   ```bash
   # 克隆 ESP8266_RTOS_SDK
   git clone --recursive https://github.com/espressif/ESP8266_RTOS_SDK.git
   cd ESP8266_RTOS_SDK
   
   # 安装依赖
   ./install.sh
   
   # 设置环境变量
   ./export.sh
   ```

2. 克隆本项目
   ```bash
   https://gitee.com/nzttj/smart-socket-firmware.git
   cd smart-socket-firmware
   ```

### 编译与烧录

1. 配置项目
   ```bash
   idf.py menuconfig
   ```

2. 编译项目
   ```bash
   ./build.sh
   ```

3. 烧录固件

   方式一：通过命令行烧录
   ```bash
   # 简单方式
   idf.py -p (PORT) flash

   # 详细方式（包含所有参数）
   ../ESP8266_RTOS_SDK/components/esptool_py/esptool/esptool.py -p (PORT) -b 460800 --after hard_reset write_flash \
   --flash_mode dio \
   --flash_size 4MB \
   --flash_freq 80m \
   0x0 build/bootloader/bootloader.bin \
   0x8000 build/partition_table/partition-table.bin \
   0xd000 build/ota_data_initial.bin \
   0x10000 build/smart-socket.bin
   ```

   方式二：通过 Flash Download Tool 烧录
   1. 下载并安装 [Flash Download Tool](https://www.espressif.com/en/support/download/other-tools)
   2. 打开 Flash Download Tool，选择 ESP8266
   3. 配置烧录参数：
      - 选择正确的COM端口
      - 波特率：460800
      - Flash大小：4MB
      - Flash模式：DIO
      - Flash频率：80MHz
   4. 添加固件文件：
      - 地址：0x0，文件：firmware/bootloader.bin
      - 地址：0x8000，文件：firmware/partition-table.bin
      - 地址：0xd000，文件：firmware/ota_data_initial.bin
      - 地址：0x10000，文件：firmware/smart-socket_v1_0_0.bin
   5. 点击"START"开始烧录

### 使用说明

1. 首次使用

   - 手机连接 "smart-socket-xxxxxx" WiFi热点
   - 访问 http://192.168.4.1 进行WiFi、MQTT配置
   - 配置完成后设备将自动重启并连接到指定WiFi和MQTT服务器

2. 远程控制

   - 通过MQTT客户端发送控制指令
   - 发送指令：`on` 开启设备
   - 发送指令：`off` 关闭设备

3. 局域网控制

   ...

## 项目结构

```
workspace/                      # 工作目录
├── smart-socket-firmware/      # 项目根目录
│   ├── main/                   # 应用代码
│   ├── components/             # 自定义组件
│   ├── html/                   # Web界面文件
│   └── firmware/               # 固件相关文件
└── ESP8266_RTOS_SDK/           # ESP8266 RTOS SDK
```

## 联系方式

如有问题或建议，请提交 Issue 或发送邮件至 [403162082@qq.com]

## 致谢

...