当前位置：首页 > news >正文

终极LED徽章编程指南：led-name-badge-ls32 USB-HID工具完全上手教程

news 2026/7/12 20:12:02

终极LED徽章编程指南：led-name-badge-ls32 USB-HID工具完全上手教程

【免费下载链接】led-name-badge-ls32Upload tool for an led name tag with USB-HID interface项目地址: https://gitcode.com/gh_mirrors/led/led-name-badge-ls32

led-name-badge-ls32是一款专为USB-HID接口LED姓名徽章设计的上传工具，支持44x11和48x12两种LED阵列规格，让你轻松自定义徽章显示内容。本教程将带你从安装到高级应用，全方位掌握这款强大工具的使用方法。

认识你的LED徽章

LED姓名徽章是一种便携式电子设备，通过USB-HID接口与计算机连接，可显示文字、图标和简单动画。市面上有多种LED徽章，而本工具支持的型号通过USB识别为：idVendor=0416, idProduct=5020，制造商为LSicroelectronics，设备名称为"LS32 Custm HID"。

蓝色LED徽章显示效果，展示了清晰的文字显示能力

绿色LED徽章在自然光下的显示效果，文字清晰可见

快速安装指南

准备工作

首先需要克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/led/led-name-badge-ls32 cd led-name-badge-ls32

Linux系统设置

为确保普通用户能访问USB设备，需安装udev规则：

sudo cp 99-led-badge-44x11.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules && sudo udevadm trigger

依赖安装

Debian/Ubuntu系统

sudo apt install python3-usb python3-pil

Arch Linux

sudo pacman -Syu python-pyusb python-hidapi

Fedora系统

sudo dnf install hidapi python3-hidapi python3-pillow python3-pyusb

Mac系统

sudo easy_install pip pip install pyhidapi pillow brew install hidapi

Windows系统

运行win/inf-wizard.exe并按照向导安装驱动
安装Python并添加到PATH
打开命令提示符执行：

pip install pyusb pillow

基础使用方法

简单文本显示

最基本的用法是显示文本信息：

python3 ./led-badge-11x44.py "Hello World!"

这条命令会将"Hello World!"作为第一条消息上传到徽章，默认以从右到左的方式滚动显示，速度为4级。上传完成后，徽章会显示一次消息，然后返回充电屏幕（如果仍连接USB）。按USB接口旁边的小按钮即可切换显示模式。

多消息与显示模式

你可以上传多个消息，并设置不同的显示模式和速度：

python3 ./led-badge-11x44.py -m 6 -s 8 "Hello" "World!"

这里：

-m 6设置显示模式为"下拉"动画效果
-s 8设置速度为最快（8级）
两个消息"Hello"和"World!"将分别作为第一条和第二条消息

最多可以上传8条消息，按徽章上的按钮可循环切换查看所有消息。

高级功能探索

图像显示

除了文字，还可以显示图像：

python3 ./led-badge-11x44.py -m 5 :gfx/fablabnbg_logo_44x11.png:

这条命令将显示一个全屏静态图像，模式5表示静态居中显示。

文字与图像混合

你可以在文本中嵌入内置图标或外部图像：

python3 ./led-badge-11x44.py "I:HEART2:my:gfx/fablab_logo_16x11.png:fablab:1:"

这个例子中：

:HEART2:插入内置的心形图标
:gfx/fablab_logo_16x11.png:插入外部图像
:1:引用第一个加载的图像

使用内置图标和自定义图像创建的"love my fablab"显示效果

动画效果

创建简单动画效果：

python3 ./led-badge-11x44.py -s7 -m0,1 :bicycle: :bicycle_r:

这个命令会显示一个自行车从右到左移动的动画，作为第一条消息；第二条消息则是自行车从左到右移动。在"M1-8"模式下，自行车会在屏幕上来回移动。

查看内置图标

要查看所有可用的内置图标名称，使用：

python3 ./led-badge-11x44.py --list-names

内置图标包括：:happy: :happy2::HEART: :heart2: :HEART2: :fablab: :bicycle: :bicycle_r: :owncloud: 等。

参数详解

使用python3 ./led-badge-11x44.py --help查看所有可用参数：

-t TYPE：指定显示类型，支持12x48或默认的11x44
-s SPEED：滚动速度，范围1-8，可指定最多8个逗号分隔的值
-B BRIGHTNESS：亮度，可选25, 50, 75或100（百分比）
-m MODE：显示模式，最多8个值，包括：
- 0: 向左滚动
- 1: 向右滚动
- 2: 向上滚动
- 3: 向下滚动
- 4: 静态居中
- 5: 动画
- 6: 下拉
- 7: 幕布
- 8: 激光
-b BLINK：闪烁效果，1为闪烁，0为正常，最多8个逗号分隔的值
-a ANTS：边框动画，1为启用，0为禁用，最多8个逗号分隔的值

速度与帧率参考

不同速度设置对应的帧率：

速度8: 15 fps
速度7: 7.5 fps
速度6: 4.5 fps
速度5: 2.8 fps
速度4: 2.4 fps
速度3: 2.0 fps
速度2: 1.3 fps
速度1: 1.2 fps

常见问题解决

权限问题：如果无法访问USB设备，请确保已正确安装udev规则并重新加载
图像显示错误：如果出现ImportError: cannot import name '_imaging'，尝试更新Pillow：sudo pip install -U Pillow
Windows驱动问题：使用win/inf-wizard.exe安装驱动时，选择"0x0416 0x5020 LS32 Custm HID"设备
多消息切换：上传多个消息后，按徽章上的按钮直到短暂显示"M1-8"，即可循环显示所有消息