reformatted readme to use markdown

This commit is contained in:
Ronald Schaten 2016-05-20 14:46:43 +02:00
parent 34fc0b7075
commit 773c793d2a

View File

@ -1,10 +1,12 @@
IRlicht -- a 4-channel (RGBW) controller for LED-lamps, based on Arduino and
controlled via infrared by a universal remote.
# IRlicht
A 4-channel (RGBW) controller for LED-lamps, based on Arduino and controlled
via infrared by a universal remote.
Copyright 2014 Ronald Schaten <http://www.schatenseite.de>
CIRCUIT
## Circuit
You can see how to connect your Arduino in the enclosed Fritzing files and
their rendered breadboard schematics. Basically, it's just the IR receiver
@ -16,7 +18,7 @@ those, I dissected an old DVD player and desoldered the enclosed IR receiver
diode from that. Worked like a charm. :-)
SOFTWARE
## Software
After installing Ken Shirriff's IR receiver library in your Arduino
environment, everything you need is the enclosed sketch (irlicht.ino).
@ -30,40 +32,41 @@ With the initial brightness levels given in the sketch, you can select which
mode and colors should be active when the device is switched on.
USAGE
## Usage
If your remote is set up like mine, you get the following functions:
Some keys for basic color selection:
1 -- red
2 -- green
3 -- blue
5 -- white
7 -- yellow (red and green)
8 -- cyan (green and blue)
9 -- magenta (blue and red)
* 1 -- red
* 2 -- green
* 3 -- blue
* 5 -- white
* 7 -- yellow (red and green)
* 8 -- cyan (green and blue)
* 9 -- magenta (blue and red)
On the first press, the channel is turned on to 1/5 of maximum. Repeating the
key enhances the brightness, after five levels the channel is turned off again.
4 -- all channels on
6 -- all channels off
* 4 -- all channels on
* 6 -- all channels off
This turns the whole setup on or off with one single press of a button.
Flash -- Hard cycle through all colors (except white).
Fade -- Soft cycle through all colors (except white).
Strobe -- Turn the currently selected color on and off.
Soft -- Fade the current color from dark to a certain level and back.
* Flash -- Hard cycle through all colors (except white).
* Fade -- Soft cycle through all colors (except white).
* Strobe -- Turn the currently selected color on and off.
* Soft -- Fade the current color from dark to a certain level and back.
Dim -- Decrease the maximum brightness of the lamp.
Bright -- Increase the maximum brightness.
* Dim -- Decrease the maximum brightness of the lamp.
* Bright -- Increase the maximum brightness.
AllLightsOn -- Misleading name: this speeds up the current animation.
AllLightsOff -- Also misleading, although consistent: slows down the animation.
* AllLightsOn -- Misleading name: this speeds up the current animation.
* AllLightsOff -- Also misleading, although consistent: slows down the
animation.
COMMENTS
## Comments
Feel free to drop me a line at <ronald@schatenseite.de>.