EEPW论坛

1. Let'sDo2025第3期任务-拾色播放器-过程帖

2. 大家好。我是eepw的长风今波浪，很开心能够参加这次由得捷和eepw联合举办的Let'sdo第3期-拾色播放器DIY活动。

一、硬件介绍

核心特性：

处理器：ESP32-S3双核Xtensa LX7处理器，主频240MHz

内存：8MB PSRAM + 16MB Flash，支持CircuitPython运行

显示：内置1.9英寸TFT彩色显示屏（ST7789驱动芯片，170×320分辨率）

无线：Wi-Fi 4（802.11 b/g/n）和蓝牙5.0（LE）支持

USB接口：USB-C接口，支持UF2引导程序和串口通信

GPIO扩展：丰富的数字/模拟I/O引脚，兼容Feather系列扩展板

特殊设计特点：

反向TFT设计：显示屏位于开发板背面，更适合嵌入式应用

板载NeoPixel：1个RGB LED，可用于状态指示

内置电池管理：支持锂电池连接和充电

CircuitPython原生支持：预装UF2引导程序，支持CircuitPython固件

引脚布局关键点：

TFT显示屏通过SPI接口连接，使用固定引脚

用户按键（BOOT按钮）连接到GPIO0

NeoPixel LED连接到GPIO40

技术规格：

类型：无源蜂鸣器（需要外部驱动信号）

工作电压：3.3V-5V，兼容ESP32-S3的3.3V逻辑电平

驱动方式：PWM频率控制，通过改变频率产生不同音高

接口：3针接口（信号、VCC、GND）

特点：简单易用，无需复杂驱动电路

工作原理：
蜂鸣器内部包含压电陶瓷片，当施加交变电压时会产生机械振动发声。通过控制PWM信号的频率（而不是占空比），可以产生不同的音符音高。

核心芯片：TCS3200 RGB颜色传感器
工作原理：

使用光电二极管阵列，包含红、绿、蓝和透明滤波器

输出与光强度成比例的方波频率

通过S2/S3引脚选择不同的滤波器

通过S0/S1引脚选择输出频率缩放比例（2%、20%、100%）

引脚功能：

S0, S1：频率缩放选择

S2, S3：光电二极管滤波器选择

OUT：频率输出（需要测量脉冲宽度）

LED：传感器照明LED控制

OE（可选）：输出使能，通常未使用

颜色测量原理：

分别选择红、绿、蓝滤波器

测量OUT引脚输出的脉冲宽度

脉冲宽度与颜色强度成反比（光越强，脉冲宽度越短）

整体思路：
通过CircuitPython的digitalio和pulseio模块控制TCS3200，实现颜色数据采集，并通过串口和屏幕显示结果。

具体步骤：

TCS3200 → ESP32-S3引脚分配：

S0  → GPIO5   # 频率缩放选择

S1  → GPIO6

S2  → GPIO9   # 滤波器选择

S3  → GPIO10

OUT → GPIO11   # 频率输出

LED → GPIO12   # 传感器照明控制

VCC → 3.3V

GND → GND

按键 → 使用板载BOOT按钮（GPIO0）

a) 初始化阶段：

使用digitalio.DigitalInOut设置S0-S3和LED为输出模式

设置频率缩放为20%（平衡速度和精度）

配置OUT引脚为pulseio.PulseIn输入模式，用于测量脉冲宽度

初始化串口通信用于调试输出

b) 颜色测量逻辑：

开启传感器照明：设置LED引脚为高电平，照亮被测物体

滤波器切换测量：

设置S2=0, S3=0 → 选择红色滤波器

测量脉冲宽度，计算红色分量

设置S2=1, S3=1 → 选择绿色滤波器

测量脉冲宽度，计算绿色分量

设置S2=0, S3=1 → 选择蓝色滤波器

测量脉冲宽度，计算蓝色分量

数据转换：将脉冲宽度转换为0-255的RGB值（脉冲越短，颜色越强）

关闭照明：减少功耗和发热

c) 按键触发机制：

配置BOOT按钮为输入模式，使用上拉电阻

实现防抖逻辑：检测按钮按下后延时10ms再确认状态

当检测到按钮按下时，触发一次完整的颜色测量流程

d) 数据显示输出：

串口打印：使用print()函数输出RGB值和可能的颜色名称

print(f"检测到颜色: R={red}, G={green}, B={blue}")

整体思路：
利用开发板内置的NeoPixel RGB LED，实时显示当前检测到的颜色。

具体步骤：

2.1 NeoPixel控制基础

NeoPixel使用单线通信协议，CircuitPython通过neopixel库控制

2.2 实现思路

a) 初始化NeoPixel：

import neopixel
pixel = neopixel.NeoPixel(board.NEOPIXEL, 1, brightness=0.3)

创建1个像素的控制对象

b) 颜色同步逻辑：

在每次颜色传感器测量完成后，获取RGB值

将传感器RGB值直接映射到NeoPixel

pixel[0] = (red, green, blue)

c) 与屏幕显示协同：

屏幕显示详细的数值和颜色块

NeoPixel提供实时的颜色视觉反馈

整体思路：
使用PWM控制蜂鸣器频率，实现八阶音符的播放，并与颜色识别功能结合。

具体步骤：

蜂鸣器模块 → ESP32-S3：

SIG → GPIO.A0   # PWM输出引脚

VCC → 3.3V

GND → GND

a) PWM频率控制原理：

使用pwmio.PWMOut创建PWM输出对象

通过改变frequency属性控制音高

通过改变duty_cycle控制音量（开启/关闭）

无源蜂鸣器需要连续变化的信号才能发声

b) 音符频率定义：
定义C大调八阶音符频率（单位：Hz）：

C4: 262  # Do

D4: 294  # Re

E4: 330  # Mi

F4: 349  # Fa

G4: 392  # Sol

A4: 440  # La

B4: 494  # Si

C5: 523  # Do（高八度）

c) 播放控制逻辑：

单音符播放函数：

设置PWM频率为目标音符频率

设置duty_cycle为50%（32768）开始发声

延迟指定时长（如500ms）

设置duty_cycle为0停止发声

添加短暂静音间隔（50ms）

音阶播放函数：

按顺序播放C4到C5的所有音符

每个音符持续相同时间

可以用于功能测试

初始化：

  1. 设置串口通信

  2. 初始化TFT屏幕显示(因为circuitpython会默认在屏幕上输出控制台信息，这一步其实可以偷懒）

  3. 初始化颜色传感器

  4. 初始化NeoPixel LED

  5. 初始化蜂鸣器PWM

主循环：

  1. 检查按钮状态（防抖处理）

  2. 如果按钮按下：

     a. 开启传感器LED

     b. 测量RGB颜色值

     c. 关闭传感器LED

     d. 在屏幕上显示颜色

     e. 设置NeoPixel为检测到的颜色

     f. 根据颜色选择对应音符

     g. 播放音符

     h. 串口打印颜色和音符信息

  3. 延迟短暂时间防止过度占用CPU

内存管理：

CircuitPython内存有限，及时释放不再使用的对象

使用局部变量而非全局变量

避免在循环中创建大量临时对象

功耗优化：

在空闲时降低传感器采样频率

不使用蜂鸣器时关闭PWM输出

合理控制屏幕背光亮度

用户体验：

添加视觉反馈：测量中显示动画

添加声音反馈：成功/失败的不同提示音

分阶段测试：

单独测试每个模块：

先验证颜色传感器基础读数

再测试屏幕显示功能

接着测试NeoPixel控制

最后测试蜂鸣器播放

集成测试：

按钮触发颜色测量

数据流：传感器→屏幕/NeoPixel→蜂鸣器

验证整个流程的时序和稳定性

边界条件测试：

极端颜色值（全黑、全白）

快速连续按钮按下

长时间运行稳定性

调试工具：

串口输出详细调试信息

使用CircuitPython的supervisor模块获取运行时信息

问题1：颜色传感器读数不稳定

可能原因：环境光干扰、传感器LED照明不均匀

解决方案：多次采样取平均、添加软件滤波、改善照明条件

问题2：蜂鸣器声音小或失真

可能原因：PWM频率不准确、驱动能力不足

解决方案：使用硬件PWM引脚、检查电路连接、调整占空比