在 YouTube 上观看

ESP32-S3 RGB LED矩阵项目5 - 箭头始终向上

项目 5 - 箭头始终向上（使用 QMI8658C 的方向指示器）

项目5使用QMI8658C运动传感器检测ESP32-S3 RGB LED矩阵的朝向，始终显示一个指向重力方向上的箭头。无论你怎么旋转电路板——USB侧朝上、OUSB侧朝上、侧面“15”或侧面“34”——箭头都会自动旋转并指向物理上的上方。

这是使用机载加速度计进行实时定向传感的强大演示。该模块的所有六个项目都在一个YouTube视频中演示，视频也嵌入在此页面上。项目5的完整代码会在文章下方自动加载，并且附属链接在代码部分下方出现。

ESP32-S3 RGB LED矩阵模块概述

ESP32-S3 RGB LED矩阵模块包括几个使该项目成为可能的组件：

• ESP32-S3 微控制器- 提供 Wi-Fi、BLE，并运行 LED/IMU 逻辑。
• 8×8 RGB LED 矩阵- 在四个方向中显示箭头。
• QMI8658C 加速度计- 检测倾斜、运动和方向。:contentReference[oaicite:0]{index=0}
• USB-C端口用于Arduino IDE的电源和编程。
• 重置和启动按钮用于上传草图。
• GPIO引脚可用于其他项目的资源。

箭头方向完全由加速度计读数决定。当板子旋转时，QMI8658C 传感器感知新的 X/Y/Z 值，程序选择应该绘制哪个箭头图案 (↑, ↓, ←, →)。

视频中涵盖的项目（时间戳）

• 00:00- 介绍
• 02:01- 安装ESP32开发板
• 03:32安装库
• 05:32- 项目 1: 移动点
• 11:11- 项目 2：文本滚动
• 12:59- 项目 3：HTTP 文本
• 16:41- 项目 4：倾斜点
• 18:55-项目5：箭头始终向上（此项目）
• 20:02- 项目6：目标游戏

视频清楚地显示了箭头如何根据模块的转动瞬间改变方向。强烈建议观看这一部分。:contentReference[oaicite:1]{index=1}

在Arduino IDE中安装ESP32开发板

如果您完成了任何早期项目，董事会的设置已经完成。否则：

1. File > Preferences→ 添加ESP32板网址
2. Tools > Board > Boards Manager…→ 安装 "ESP32"
3. 在下方选择ESP32-S3开发板Tools > Board
4. 在下方选择正确的USB COM端口Tools > Port

安装所需库

项目5使用：

• Adafruit NeoMatrix
• Adafruit NeoPixel
• Adafruit GFX
• QMI8658(运动传感器)

1. Sketch > Include Library > Manage Libraries…
2. 搜索：新矩阵→ 安装
3. 安装依赖项：NeoPixel+GFX
4. 搜索并安装QMI8658由其作者编写

项目5如何运作

QMI8658C 在 X、Y 和 Z 轴上测量重力。通过比较这些值，草图确定电路板的哪个物理面朝上：

• USB面朝上
• OUSB面朝上（相对 USB）
• 侧面“15”朝上
• 面朝“34”向上

每个方向对应于8×8矩阵上的不同箭头图案。映射遵循您之前调试会话中确认的方向逻辑。棋盘的旋转持续读取，箭头会在向上侧变化时立即更新。

项目 5 - 代码设置（箭头始终向上）

以下是来自配置区域的用户可调值。完整的项目代码会在文章下方自动显示。

矩阵配置

// Matrix configuration
const int MATRIX_PIN    = 14;   // fixed for this module
const int MATRIX_WIDTH  = 8;
const int MATRIX_HEIGHT = 8;

// Recommended orientation: Top-Left origin, progressive mode
// (actual constructor is inside the code loaded below)

该项目使用NEO_MATRIX_PROGRESSIVE布局以确保箭头根据实际移动正确指向。

亮度

uint8_t matrixBrightness = 40;   // 0–255

您可以在光线较强的环境中提高此数值。在室内使用时，30-60是舒适的。

箭头颜色

// Arrow color
uint8_t arrowRed   = 255;
uint8_t arrowGreen = 0;
uint8_t arrowBlue  = 0;

更改这些值以修改箭头的颜色。例如：

• 绿色箭头：(0, 255, 0)
• 蓝色箭头：(0, 0, 255)
• 白色箭头：(255, 255, 255)

灵敏度和平滑处理

为了避免抖动，代码包含平滑和阈值逻辑。在设置中，您可能会找到类似：

// Sensitivity / smoothing adjustment
float tiltThreshold = 0.30f;   // adjust if arrow changes too easily

• 如果你的箭头翻转得太容易→增加阈值。
• 如果箭头变化太慢 →减少阈值。

箭头图案

草图包括箭头位图模式用于：

• ↑ 向上
• ↓ 下
• ← 左
• → 右

您无需修改这些，但如果您想要不同的风格，可以更改代码中的形状。

摘要

项目5展示了ESP32-S3 RGB LED矩阵和QMI8658C加速度计如何协同工作以检测方向，并显示一支始终向上的箭头。该项目基于倾斜点（项目4），为您在项目6中的最终互动游戏做好准备。

本文章下方提供完整的“箭头总是向上”草图（自动加载）。强烈建议观看视频中对应部分，以观察箭头如何瞬间响应电路板的旋转。如果您希望在家中构建此项目，ESP32-S3 RGB LED矩阵模块的关联链接在代码部分下方出现。

图像

ESP32 S3 Matrix

ESP32 S3 Matrix pin out

ESP32-S3_RGB_8x8_matrix-3

ESP32 S3 Matrix attached with buzzer to pin6 and GND

ESP32 S3 Matrix displaying red heart

ESP32 S3 Matrix displaying green heart

ESP32 S3 Matrix displaying rainbow heart 3

ESP32-S3_RGB_8x8_matrix1

ESP32-S3_RGB_8x8_matrix-2

ESP32-S3-Mtrix - Alway Up

ESP32 S3 Matrix

ESP32 S3 Matrix pin out

ESP32-S3_RGB_8x8_matrix-3

ESP32 S3 Matrix attached with buzzer to pin6 and GND

ESP32 S3 Matrix displaying red heart

ESP32 S3 Matrix displaying green heart

ESP32 S3 Matrix displaying rainbow heart 3

ESP32-S3_RGB_8x8_matrix1

ESP32-S3_RGB_8x8_matrix-2

ESP32-S3-Mtrix - Alway Up

This code has not been parsed yet. Please return to the admin panel to parse it.