ESP32-S3 BLE Gateway 文档

欢迎使用 ESP32-S3 BLE Gateway 技术文档！

本项目是一个基于 ESP32-S3 + NRF52833 的企业级 BLE 网关系统。

---

快速导航

- :material-rocket-launch: **[快速开始](快速开始.md)** 5 分钟快速上手 - :material-chip: **[硬件设计](硬件设计/硬件设计.md)** 引脚分配、PCB 设计指南 - :material-cube-outline: **[核心组件](核心组件/核心组件.md)** BLE 扫描器、WiFi、MQTT 等模块 - :material-api: **[API 参考](API参考文档/API参考文档.md)** RESTful API、WebSocket API - :material-web: **[Web 界面](Web用户界面/Web用户界面.md)** WebUI 架构与接口设计 - :material-cog: **[配置管理](配置管理.md)** 系统配置与参数说明

---

系统架构

graph TB
    subgraph "硬件层"
        ESP32["ESP32-S3<br/>主控制器"]
        NRF["NRF52833<br/>BLE 控制器"]
        ETH["CH390H<br/>以太网"]
        LED["WS2812 LED"]
    end

    subgraph "软件层"
        BLE["BLE 扫描器"]
        WIFI["WiFi 管理"]
        MQTT["MQTT 客户端"]
        WEB["WebUI 服务器"]
        HCI["HCI 传输层"]
    end

    ESP32 --> BLE
    ESP32 --> WIFI
    ESP32 --> MQTT
    ESP32 --> WEB
    HCI <--> NRF
    BLE --> HCI
    ETH --> ESP32

---

核心特性

特性	说明
双芯片架构	ESP32-S3 主控 + NRF52833 BLE
双网络支持	WiFi + CH390H 以太网
BLE 扫描	持续扫描、设备过滤、广播解析
云端上报	MQTT 协议，兼容 OpenMQTTGateway
Web 管理	嵌入式 WebUI，REST API
状态指示	WS2812 三色 LED

---

文档目录

• 项目概述 - 系统介绍与架构总览
• 快速开始 - 编译、烧录、配置
• 硬件设计 - 硬件连接与 PCB
• 核心组件 - 软件模块详解
• API 参考 - 接口文档
• 部署运维 - 生产部署指南
• 故障排除 - 常见问题解决

---

ESP32-S3 BLE Gateway | 企业级 BLE 网关解决方案