# smart-socket

**Repository Path**: fangxin8/smart-socket

## Basic Information

- **Project Name**: smart-socket
- **Description**: 智能插座项目仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master-gitee
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Smart Socket 智能插座

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

## 目录
- [项目简介](#项目简介)
- [项目初衷](#项目初衷)
- [功能特性](#功能特性)
- [硬件说明](#硬件说明)
- [快速开始](#快速开始)
  - [固件编译与烧录](#固件编译与烧录)
  - [小程序开发](#小程序开发)
  - [首次配置演示](#首次配置演示)
- [联系方式](#联系方式)
- [致谢](#致谢)

## 项目简介

Smart Socket 是一个基于 ESP8266 的智能插座项目，包含硬件固件和微信小程序客户端。本项目支持局域网控制、广域网控制（通过巴法云）、电能统计等功能，并可对接米家实现小爱同学语音控制。

如果这个项目对您有帮助，欢迎 Star 支持一下！

## 项目初衷

由于本人较懒，睡觉前不想起床关灯，甚至不想用手机关灯，加上本人恰好从事嵌入式相关工作，于是突发奇想就想自己做一个智能插座，最好还能用小爱音箱控制的智能插座。既然是智能插座，那电能计量就必不可少吧？电能计量有了，那该如何展示出来呢？我在网上找了很久，一直找不到有什么免费且又能展示数据的云平台（如果有哪位大佬知道，请告诉我），所以这个微信小程序就出现了（局域网控制）。至此，一个支持广域网控制、局域网控制、电能统计功能的智能插座出现了。

PS：项目的硬件成本比在市面上的要贵，如果只是需要一个智能插座，完全可以自己网购一个。

## 项目结构

```
smart-socket/
├── smart-socket-firmware/    # ESP8266 固件代码
└── smart-socket-miniprogram/ # 微信小程序客户端
```

## 硬件说明

本项目使用的硬件方案基于 [新国标五孔计量插座10A](https://oshwhub.com/oldfox126/xin-guo-biao-wu-kong-ji-liang-cha-zuo-10a) 智能插座，这是一个开源的智能插座硬件方案。

物料、焊接可以直接参考方案：

- 主控芯片：ESP12F
- 电源管理：BL0942 电能计量芯片

## 功能特性

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

## 快速开始

### 固件编译与烧录

本项目固件基于 [ESP8266_RTOS_SDK](https://github.com/espressif/ESP8266_RTOS_SDK) 开发，详细编译和烧录步骤请参考 [固件开发文档](smart-socket-firmware/README.md)。

### 小程序开发

本项目使用微信小程序作为控制端，详细开发步骤请参考 [小程序开发文档](smart-socket-miniprogram/README.md)。

### 首次配置演示

以连接巴法云，对接米家为例

#### 1、云平台注册并添加设备
1. 登录访问巴法云，点击MQTT设备云
   ![访问巴法云](docs/images/bafa_index.png)
2. 输入主题名，点击新建主题（可以理解为创建一个设备，后缀必须为001，表示插座设备）
   ![创建设备](docs/images/new_device.png)
3. 米家关联巴法云账号（如无需小爱同学控制，可忽略此步）

   进入米家，点击右上角添加设备进入添加设备界面，选择"其他平台设备"
   ![创建设备](docs/images/mijia1.jpg)

   点击下方"添加"，找到巴法，按照提示添加即可（此处我已经添加好了）
   ![创建设备](docs/images/mijia2.png)

#### 2. 配网模式
1. 给插座上电
2. 长按按键3秒后松手，进入配网模式
3. 手机连接名为 `smart-socket-xxxxxx` 的WiFi热点（密码：12345678）
4. 连接成功后浏览器访问 192.168.4.1
   ![连接热点](docs/images/connect_ap.jpg)

#### 3. 配置信息
1. 输入要连接的WiFi账号密码，其他配置保持默认即可
2. 点击配置设备
   ![配置设备](docs/images/config_wifi.jpg)

#### 4. 使用小程序
手机和设备需要在同一个局域网

1. 扫描下方小程序码，进入智能插座控制小程序
   <div align="center">
   <img src="docs/images/miniprogram.jpg" width="300" alt="智能插座小程序码" />
   <br>
   <em>图：智能插座小程序码</em>
   </div>

2. 下拉搜索设备
   ![小程序首页](docs/images/found_device.jpg)
3. 搜索到设备后点击设备即可连接成功
   ![添加设备](docs/images/connect_device.jpg)
4. 点击"设置"进入设置界面
   ![设备二维码](docs/images/settings.png)
5. 点击"设备配置"，在"客户端ID"处输入之前在巴法云平台的私钥，点击"保存"即可
   ![设备控制](docs/images/network-config.png)
6. 应用商店下载"巴法"APP或通过小爱音箱即可远程控制设备

## 联系方式

如有问题或建议，请通过以下方式联系我：

- 提交 Issue
- 发送邮件至：[403162082@qq.com]

## 致谢

感谢所有为本项目做出贡献的开发者。