Skip to content
Control software for the Inland (FURI KEYSHINE) USB LED Badge.
C M4 Makefile Shell
Find file
Latest commit 30bcec6 Mar 17, 2016 @thentenaar Update the GTK+ 2.x GUI
Tthis stuff certainly ain't my best work ever, but I'm leaving the
structure of the code largely intact, as it still works perfectly.

I made a few cosmetic alterations, and updated it to add an error
dialog, and to work around some deprecated functions; but otherwise it's
largely the same as it was when I wrote it years ago.

It's interesting how the way you code changes over time.
Failed to load latest commit information.
doc Initial revision Dec 14, 2009
hidapi @ b5b2e17 Add hidapi as a submodule Mar 19, 2016
m4
src
udev Cleanup the repo layout Mar 19, 2016
.gitmodules Add hidapi as a submodule Mar 19, 2016
LICENSE Re-license this under the Simplified BSD License Mar 13, 2016
Makefile.am Add autotools files Mar 19, 2016
README.md Cleanup the repo layout Mar 19, 2016
autogen.sh Add autotools files Mar 19, 2016
configure.ac Add autotools files Mar 19, 2016
usb-badge.desktop Cleanup the repo layout Mar 19, 2016
usb-badge.png

README.md

usb-badge

A simple program for manupulating the FURI KEYSHINE USB Bage (0x04d9:0xe002). I've included both a CLI utility (usb-badge-cli), and a GUI utility (usb-badge-gui). The CLI was originally contributed by Jeff Jahr, and some patches were contributed by Cody Boisclair.

The GUI requires GTK+ >= 2.14.0.

Synopsis

USB Badge CLI
Copyright (C) 2009-2016 Tim Hentenaar

Usage: usb-badge-cli [options...]

Options:
        -h Show this message
        -d Dump message data. Valid values are: 1 - Dump, 0 - Don't.
        -l Set the brighness of the display. Valid values are 0-7.
        -i Index of message to dump or modify. Valid values are 0-4.
        -a Set the display action. Valid values are:
                0 - Move                    1 - Flash, then move
                2 - Scroll Up               3 - Scroll Down
                4 - Flash                   5 - Freeze

        -s Set the update speed of the message. Valid values are 0-7.
        -m Set the message text (136 chars max.)
        -x Set the message data as a hexadecimal string (136 bytes max.)

Examples:
        Dumping all message data:     src/usb-badge-cli -d
        Dumping a specific message:   src/usb-badge-cli -d -i <index>
        Setting luminance:            src/usb-badge-cli -l 2
        Setting speed/action:         src/usb-badge-cli -i <index> -s 2 -a 1
        Updating message text:        src/usb-badge-cli -i <index> -m Message

Licensing

See the LICENSE file for details. The bundled hidapi is distributed under its included BSD license.

Installation

Building is as simple as:

$ ./autogen.sh && make && make install

Note that you can pass arguments to configure via autogen.sh. for example:

$ ./autogen.sh --prefix=/usr --sysconfdir=/etc

On Linux, udev rules for the converter will also be installed in $(sysconfdir)/udev/rules.d which will give cause the badge to be owned by the plugdev group, with permissions of 0660. Thus, you may want to pass --sysconfdir=/etc to configure.

Something went wrong with that request. Please try again.