blink1

name: blink1 description: Use when controlling blink(1) USB LED device via blink1-tool CLI, setting RGB/HSB colors, fade transitions, patterns, blinking effects, multi-device/LED control, or Linux udev setup. Keywords: blink1-tool, ThingM, USB LED, notification light, RGB color, HSB, pattern, blink, fade, chase, glimmer.

blink(1) USB LED Control

Overview

blink1-tool controls ThingM blink(1) USB LED devices. Supports RGB/HSB colors, fade transitions, patterns, multi-device, and multi-LED (mk2+).

Quick Fix: If device not detected on Linux, run blink1-tool --add_udev_rules then replug. See Troubleshooting for details.

Version Compatibility

Check firmware: blink1-tool --fwversion

Quick Reference

Quick Start (3 Steps)

# 1. 检测设备
blink1-tool --list           # 应显示设备ID

# 2. 设置颜色（验证工作）
blink1-tool --rgb=255,0,0    # 红灯亮起 = 成功

# 3. 关闭设备
blink1-tool --off

如果 Step 1 无输出 → 见 Troubleshooting

Color Control

RGB Values

# Decimal: R,G,B (0-255 each)
blink1-tool --rgb=255,0,255    # Magenta

# Hex (with or without #)
blink1-tool --rgb=#FF9900      # Orange
blink1-tool --rgb FF9900       # Same

HSB Values

# Hue (0-360), Saturation (0-100), Brightness (0-100)
blink1-tool --hsb=180,100,50   # Cyan at 50% brightness

Fade Transitions

# -m sets fade duration (milliseconds)
blink1-tool -m 100 --rgb=255,0,0   # Quick 0.1s fade to red
blink1-tool -m 2000 --rgb=0,255,0  # Slow 2s fade to green

Brightness Control

# -b sets brightness (0-255)
# 0 = use actual RGB values
# 1-255 = scale brightness (1=min, 255=max)
blink1-tool -b 50 --rgb=255,255,255   # Dim white
blink1-tool -b 200 --rgb=ff0000       # Bright red

# Or use HSB with brightness parameter
blink1-tool --hsb=0,100,25            # Red at 25% brightness

Blinking & Effects

Basic Blink

# Blink command LAST (timing set with -t and -m)
blink1-tool -t 200 -m 100 --rgb ff00ff --blink 5   # Purple, 5 times

Random Colors

blink1-tool --random          # One random color
blink1-tool -t 2000 --random=100   # Every 2s, 100 random colors

Glimmer Effect

# Soft flickering of set color
blink1-tool --rgb=0,0,255 --glimmer=10   # Blue glimmer 10 times

Chase (Multi-LED mk2+)

blink1-tool --chase                     # Forever chase
blink1-tool --chase=5,3,18              # 5 times, LEDs 3-18

Patterns

Pattern String Format

count,color,fade,delay,color,fade,delay,...

# Purple-green flash 10 times
blink1-tool --playpattern '10,#ff00ff,0.1,0,#00ff00,0.1,0'

# Write pattern to device
blink1-tool --writepattern '5,#ff0000,0.3,0.1,#000000,0.3,0.1'
blink1-tool --savepattern   # Save to flash (mk2+)

Pattern Management

blink1-tool --clearpattern   # Erase RAM pattern
blink1-tool --savepattern    # Save RAM to flash
blink1-tool --readpattern    # Download pattern as string
blink1-tool --play 1,0       # Play from position 0
blink1-tool --playstate      # Check play status

Multi-Device & Multi-LED

Device Selection

# First get device IDs
blink1-tool --list

# Select specific devices
blink1-tool -d all --rgb=ff0000     # All devices
blink1-tool -d 0,2 --rgb=00ff00     # 1st and 3rd device

LED Selection (mk2+)

# -l: 0=all, 1=top, 2=bottom
blink1-tool --led=2 --rgb=FF9900    # Bottom LED orange
blink1-tool --ledn 1,3,5,7          # Specific LED list

Device Setup (Linux)

# If device not detected, add udev rules
blink1-tool --add_udev_rules

# Then replug device

# Verify: blink1-tool --list should now show device

Options Summary

Troubleshooting

No Device Found

# Check if device is connected
blink1-tool --list

# If empty output:
# 1. Physical: check USB connection
# 2. Linux: run --add_udev_rules, replug, or try with sudo
# 3. Permission: user must be in plugdev group (may need restart)

Permission Denied (Linux)

# Option 1: Add udev rules (persistent)
blink1-tool --add_udev_rules
# Then replug device

# Option 2: Temporary sudo
sudo blink1-tool --list

# Option 3: Add user to plugdev group (persistent)
# If plugdev group doesn't exist:
sudo groupadd plugdev

# Add user to group:
sudo usermod -a -G plugdev $USER

# MUST restart system for group change to take effect
# (logout/login may not be sufficient)

udev Rules 与 plugdev 组的关系

取决于 udev rules 怎么写的：

# 查看当前 udev rules
grep -r "27b8" /etc/udev/rules.d/ 2>/dev/null
cat /etc/udev/rules.d/51-blink1.rules

注意：即使 MODE="0666"，某些发行版/配置仍要求用户在 plugdev 组。遇到权限问题，先尝试加入组。

推荐：用 TAG+="uaccess" 替代 GROUP 写法：

ATTRS{idVendor}=="27b8", ATTRS{idProduct}=="01ed", TAG+="uaccess"

uaccess 是 systemd/logind 的动态授权机制，当前登录用户自动获得设备权限。

验证设备权限

# 查找设备
lsusb | grep -i blink   # 如 Bus 001 Device 005

# 查看设备节点权限
ls -la /dev/bus/usb/001/005
# 看 GROUP 和权限位

Common Mistakes