跳到正文

固件:按一下换一位歌手

应援棒第 03 节 / 共 5 节 ·2026-11-17·~3 min

固件:按一下换一位歌手

工程在 product/light-stick/code/,VS Code 装 PlatformIO 插件直接打开这个目录。

一个环境一个入口

工程只保留 xiao-rp2040-button 一个构建环境,入口为 src/main.cpp。 通电后常亮当前色,按一下按钮换下一种,不呼吸、不自动换色。

自制控制板的引脚、每列灯珠数和电流预算统一在 include/board-config.h:

constexpr uint8_t STRIP_DATA_PIN = 3;  // D10 → J4 DIN(经电平转换)
constexpr uint8_t BUTTON_PIN = 4;      // D9 → J3 BTN
constexpr uint8_t POT_PIN = 27;        // D1 → J2 W(预留,不读取)
constexpr uint16_t STRIP_LED_COUNT = 18; // 四列 DIN 并联,共 72 颗
constexpr uint32_t BATTERY_LED_MA = 1800;     // 电池档:灯珠电流上限
constexpr uint32_t USB_PREVIEW_LED_MA = 300;  // 插电脑预览档

色序固定是 NEO_GRB(WS2812 的三字节 RGB),写死在源码里,没有开关可拨错。

应援色

六种颜色只有一份,在 include/singer-palette.h。印象色取通行的色号,灯珠值是对着实物挑的:

歌手印象色灯珠值
初音未来#39C5BB00FF40
镜音铃#FFA500FF3C00
镜音连#FFE211FF9600
巡音流歌#FAAFBEFF3C78
MEIKO#D80000FF0000
KAITO#0000FF0000FF

色号是给屏幕看的 sRGB,灯珠却是线性发光。直接写进去,弱的通道会偏亮—— 初音色的红通道 57 在屏幕上几乎看不出,在灯珠上却是满亮的 22%,整根棒子就泛白发灰。 所以写灯前先 gamma 2.6 还原,再把最亮的通道推满 255:色相不变,亮度交给下一节。

gamma 只管得了亮度曲线,管不了原色本身不同:灯珠的绿、蓝芯片和屏幕的不一样, 按公式算出来的初音色 08FADA 在乳白管里是一片偏白的冰蓝。这种颜色在色表里填 led 直接指定灯珠值,对着实物挑:往串口(115200)发一行候选值,比如 00FF55 00FF40 00FF2B, 按钮就在这几个之间切,发空行回到应援色。六种颜色都这样挑过一遍:这批灯珠的绿芯片偏亮, 初音要几乎纯绿带一点蓝,铃、连、流歌也都比公式少放绿。

亮度:看供电

板上 5V 只有一根轨,电脑 USB 和电池都接在上面,没有分压可量。固件能分辨的只有「有没有电脑在和它说话」:

  • 开机渐亮,全程约 1 秒:前 0.5 秒从黑亮到预览档,同时看有没有电脑(USB 总线复位一两百毫秒内就到)
  • 0.5 秒内看见电脑,就停在预览档到断电(灯珠 ≤300mA,电脑 USB 口只给 500mA)
  • 没看见,认定电池供电,后 0.5 秒接着亮到预算内最亮(灯珠 ≤1.8A,IP5306 额定 2.1A)
  • USB 充电头没有数据线,会按电池档点亮
∑ 电池档的电流与续航

单颗全白 0.2W ≈ 40mA,三通道均分,72 颗;另加控制板 0.12A;电池 5V 下可用 2700mAh。

颜色灯珠值灯珠电流续航
初音未来0 / 255 / 641.20A约 2.0 h
镜音铃255 / 60 / 01.19A约 2.0 h
镜音连255 / 150 / 01.53A约 1.6 h
巡音流歌255 / 60 / 1201.64A约 1.5 h
MEIKO、KAITO单通道 2550.96A约 2.5 h

想要更长续航就调小 BATTERY_LED_MA。单颗功率和电池容量都是保守估计,整机实测约 3 小时,见装配与实测 。

按钮

  • BTN 接 D9 = GPIO4,用 RP2040 内部上拉,不用外加电阻:松手 HIGH,按下 LOW
  • 去抖:电平稳定 30 ms 才算数
  • 只在按下那一刻换色,长按不连发
  • 每次换色在串口打印歌手名,开机是初音未来

编译与烧录

源码登录后可下载:light-stick-code.zip 。 解压后用 VS Code + PlatformIO 插件打开,或者命令行:

cd product/light-stick/code
pio run

需要烧录时再执行:

pio run -e xiao-rp2040-button -t upload --upload-port COM7

走 Windows 的 UF2 磁盘上传,不用装 picotool 驱动。自动进烧录模式失败时: 按住 BOOT 插 USB,出现 RPI-RP2 磁盘后把 .pio/build/<环境>/firmware.uf2 拖进去。

亮度旋钮最后决定不做,固件不读 D1,亮度只看供电(上一节)。灯带每 20 ms 刷新一次,掉电恢复后自动恢复当前颜色。