ledcontroller-3bit/README.md

56 lines
1.7 KiB
Markdown
Raw Normal View History

2013-02-18 23:21:48 +00:00
# ledcontroller-3bit #
A Linux command line utility to control usb mail notifiers identified as:
$ lsusb
Bus 001 Device 010: ID 1294:1320 RISO KAGAKU CORP.
2013-02-21 01:28:25 +00:00
Inside the scripts folder you will find some simple bash scripts you can use to control the notifier.
For example the script `mled-cputemp` will make it respond to your CPU's temperature.
2013-02-21 19:06:10 +00:00
### Get and compile: ###
2013-02-18 23:21:48 +00:00
$ git clone https://github.com/andmarios/ledcontroller-3bit.git
$ cd ledcontroller-3bit/
$ make
2013-02-21 19:06:10 +00:00
### Run: ###
2013-02-18 23:21:48 +00:00
$ ./ledcontroller blue | red | green | aqua | purple | yellow | white | off
2013-02-21 19:06:10 +00:00
### Install permanently: ###
2013-02-18 23:21:48 +00:00
$ sudo install -m root -g root -m 755 ledcontroller /usr/bin/ledcontroller
2013-02-21 19:06:10 +00:00
### Uninstall: ###
2013-02-18 23:21:48 +00:00
$ sudo rm /usr/bin/ledcontroller
2013-02-21 19:06:10 +00:00
### Have fun: ###
2013-02-18 23:21:48 +00:00
2013-02-21 19:06:10 +00:00
Take a look inside the _scripts_ directory.
## Requisites: ##
2013-02-18 23:21:48 +00:00
+ libusb:1 or libusb-1.0-dev, depending on your distribution
+ a system which can compile binaries (package build-essentials for Debian based distributions)
2013-02-21 19:06:10 +00:00
## Hardware ##
2013-02-18 23:29:04 +00:00
2013-02-21 19:06:10 +00:00
I think [this is my notifier](http://www.andmarios.com/links/mail-usb-notifier) but I can't be sure as I bought it a couple of years ago from eBay.
2013-02-18 23:29:04 +00:00
2013-02-18 23:21:48 +00:00
---
2013-02-21 19:06:10 +00:00
## Copyright ##
This code (files `main.c` and `Makefile`) is a fork of the ledcontroller code by jmrobles (<http://robleshermoso.wordpress.com>).
2013-02-18 23:21:48 +00:00
2013-02-21 19:02:26 +00:00
My contribution to this code is very small and probably I could never write this on my own.
I added support for all the 7 colors of the notifier as the original code only supported the
3 basic colors. Also I hopefully fixed an issue with a warning output at the kernel's log.
2013-02-18 23:21:48 +00:00
2013-02-21 19:02:26 +00:00
The code is distributed under the terms of the GNU General Public License v3. You can find more
information and the original license inside `main.c`.