ESP32Minecraft小地图

视频链接

B站视频--硬核MC物理小地图电路与功能演示

项目简介

本项目名为 PixelPortal-Tactical，这是一个专为 ESP32 开发板设计的 HUB75 矩阵屏拓展底板。

该设计旨在简化布线，用户只需将现有的 ESP32 开发板（30Pin DevKit V1）插在底板上，即可直接驱动 64x64 RGB 矩阵屏。配合板载的光敏电路和 USB-C 供电接口，完美解决了传统杜邦线连接的不稳定和杂乱问题。

配合 Docker 中间件，该终端可实现 Minecraft 物理小地图映射或作为智能像素时钟使用。

项目功能

本硬件设计完全基于“拓展底板”理念，具有以下核心功能：

1. 模块化直插设计：

   • ESP32 核心座：PCB 预留 2x15Pin 排母接口，完美适配标准的 30Pin ESP32-WROOM-32 开发板。

   • HUB75 直连：底板背部集成标准 HUB75 母座，可直接扣在矩阵屏背面的针脚上，无需任何排线。

2. 板载环境感知：

   • 集成 LDR 光敏电阻（GL5528）与分压电路，连接至 ESP32 的 GPIO 35。

   • 无需外接传感器即可实现环境光检测，配合软件实现自动亮度调节或“物理关灯识别”逻辑。

3. Type-C 供电系统：

   • 板载 USB Type-C 接口，配置了 CC1/CC2 下拉电阻（5.1k），支持 C-to-C 数据线供电。

   • 5V 电源直接供给矩阵屏与 ESP32 开发板（通过 VIN 引脚），单线解决供电与程序下载（通过开发板自带 USB）问题。

项目参数

• 适配核心：ESP32-WROOM-32 开发板 (30Pin 窄板, 引脚间距 2.54mm)

• 显示接口：1x HUB75 (2x8 Pin 母座，直插屏幕)

• 板载传感器：1x LDR 光敏电阻 (接入 IO35)

• 供电接口：1x USB Type-C (5V 输入)

• PCB 尺寸：适配 64x64 P2.5/P3 屏幕背部孔位

• 软件支持：GPIO 32 可用于外接 PIR 传感器（需自行引出）

原理解析（硬件说明）

本设计作为一个纯粹的 ESP32 转接底板，电路设计简洁高效，主要由三部分组成：

1. 信号路由 (Signal Routing)

将 ESP32 开发板的 GPIO 信号通过 PCB 走线直接映射到 HUB75 接口。

• R1/G1/B1/R2/G2/B2 及行选信号 A/B/C/D/E 均已按通用标准连接。

• 相比杜邦线连接，PCB 走线极大降低了信号干扰，提升屏幕刷新稳定性。

2. 传感器电路

• 光敏电阻 (LDR)： 电路包含一个 GL5528 光敏电阻和一个 10kΩ 分压电阻。中点电压连接至 ESP32 的 SENSOR_VP (GPIO 35)。

  • 注：GPIO 35 为输入专用引脚 (Input-only)，不干扰 WiFi 功能，适合高精度 ADC 采样。

3. 电源接口

• USB Type-C： 采用 16Pin Type-C 母座，仅使用 VBUS 和 GND 网络。

  • CC 识别：在 CC1 和 CC2 引脚分别对地连接 5.1kΩ 电阻，确保在使用 C-to-C 数据线连接 PD 充电头时能正确诱骗出 5V 电压。

软件代码

硬件驱动层采用 Arduino/PlatformIO 框架开发。

开源地址：GitHub - PixelPortal-Tactical

引脚定义 (Config)： 使用本底板时，请确保代码中引脚定义如下（对应 30Pin DevKit）：

// 核心引脚配置 #define R1_PIN 25 #define G1_PIN 26 #define B1_PIN 27 // ... (HUB75其他引脚均已对应) #define LDR_PIN 35 // 板载光敏

注意事项

复刻与组装必读：

1. 开发板选型：本底板是按 30Pin 窄版 ESP32 开发板设计的（如下图所示），请勿购买 38Pin 宽版，否则无法插入排母。

2. USB 接口焊接：Type-C 接口引脚较密，焊接时请注意避免连锡短路。

3. 安装方向：

   • ESP32：请严格按照 PCB 丝印方向插入开发板，USB口朝外。

   • 底板：将底板的 HUB75 母座对准屏幕背面的插针按下即可。

4. 绝缘处理：底板背面有焊点，安装时建议在屏幕背面贴一层绝缘胶带，防止短路。

实物图