Claude-LED-LUCKEY 🚦

English

ESP32C3 蓝牙 BLE 状态指示灯，用于 Claude Code 工作状态的物理提醒。

硬件清单

接线定义

注意：GPIO8 是板载蓝灯（右侧第 4 个），不要使用。

LED 亮度配置

固件中定义了三种颜色的最大亮度常量（0-255），可按需调整：

#define BRIGHTNESS_RED    255
#define BRIGHTNESS_YELLOW 255
#define BRIGHTNESS_GREEN  192

修改后重新烧录固件即可全局生效。

灯效模式（共 20 种）

蓝牙通信

• 设备名：Claude-LED-LUCKEY
• 服务 UUID：f4b7e3a1-5c6d-4e8f-9a2b-1c3d5e7f9a0b
• 特征值 UUID：8c9d4e2f-1a3b-4c5d-6e7f-8a9b0c1d2e3f
• 写入方式：Write Without Response
• 数据格式：UTF-8 字符串

支持的命令

命令格式

mode[,buzzer_param]

• mode：模式编号（0-19）或名称
• buzzer_param：蜂鸣器参数
  • 0 = 不响
  • 1 = 短响一声（80ms，2000Hz，主板自检音）
  • 2 = 短响两声（2000Hz + 1000Hz，各 80ms，不同声调）
  • 3 = 高频短响（200ms，4000Hz）

示例：

• "alarm,1" → 红灯常亮 + 短响一声
• "alarm,2" → 红灯常亮 + 短响两声（不同声调）
• "alarm,3" → 红灯常亮 + 高频提示音
• "alarm,0" → 红灯常亮 + 不响
• "alarm" → 红灯常亮 + 不响
• "2" → 模式 2（绿灯闪烁），蜂鸣器不响

数字命令（0-19）

直接发送模式编号，如 "0"、"17"。

名称命令

使用方法

1. 烧录固件

用 Arduino IDE 打开 firmware/claude-led/claude-led.ino，选择 ESP32C3 开发板，烧录。

2. 测试灯效

# 自动测试全部灯效（每种 3 秒）
python scripts/test-all-effects.py

# 手动测试单个灯效
python scripts/send-hook.py 17        # 太极呼吸
python scripts/send-hook.py taichi    # 同上
python scripts/send-hook.py alarm 1   # 红灯常亮 + 短响一声
python scripts/send-hook.py alarm 2   # 红灯常亮 + 短响两声（不同声调）
python scripts/send-hook.py alarm 0   # 红灯常亮 + 不响

3. Claude Code 集成

在 ~/.claude/settings.json 中添加 hooks：

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "python \"D:\\path\\to\\send-hook.py\" 17",
            "timeout": 5000
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "python \"D:\\path\\to\\send-hook.py\" 2",
            "timeout": 5000
          }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "python \"D:\\path\\to\\send-hook.py\" 4 1",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}

Claude Code 事件与灯效映射

首次通电默认灯效为 18（HELLO 摩尔斯码），同时播放天空之城前奏短音作为启动提示。5 分钟无操作后自动关闭。

彩蛋：天空之城

开机自动播放天空之城前奏短音（~2.5 秒）。也可通过命令手动触发：

python scripts/send-hook.py castle      # 短版 (~2.5秒)
python scripts/send-hook.py castle,1    # 完整版 (~46秒)
python scripts/send-hook.py sky         # 同 castle

播放中再次发送 castle 可停止播放。旋律数据由 8051 版本移植而来。

依赖

• Arduino IDE + ESP32 开发板支持包
• Python 3.8+
• bleak（Python BLE 库）：pip install bleak

Contributors

Star History