Added some basic docs
This commit is contained in:
parent
15381a3960
commit
3d78da51b2
|
@ -0,0 +1,36 @@
|
|||
twinkl-client
|
||||
=============
|
||||
|
||||
Compile
|
||||
-------
|
||||
```
|
||||
git clone git@github.com:LongHairedHacker/twinkl-client.git
|
||||
cd twinkl-client
|
||||
git submodule init
|
||||
git submodule update
|
||||
make
|
||||
```
|
||||
|
||||
Usage
|
||||
-----
|
||||
```
|
||||
twinkle-client <twinkl server> <priority>
|
||||
```
|
||||
|
||||
* **twinkle server**: The ip or hostname of the twinkl-server
|
||||
* **priority**: Priority of your packet 0 is highest 7 is lowest
|
||||
|
||||
twinkl-client reads a list of channel value pairs from stdin.
|
||||
One pair per line in the format `<channel> : <value>`.
|
||||
Channels range from 0 to 511 while values range from 0 to 255.
|
||||
Both can be entered in decimal or hexadecimal (prefix with *0x*).
|
||||
An empty line sends the twinkl packet containing all values since the last empty line.
|
||||
An EOF (Ctrl-D) also sends the twinkel packet and terminates the client.
|
||||
|
||||
Only channels that have been assigned a value before sending the packet will
|
||||
be reserved for usage by your priority level.
|
||||
This implies that if you want a channel to stay at 0 without a lower priority level
|
||||
being able to override it you have to set it to 0 in every packet you send.
|
||||
It is also a good Idea to send an empty packet (newline directly followed by a EOF)
|
||||
before killing the client, as it will clear any leftover reserved channels
|
||||
for your priority level.
|
Loading…
Reference in New Issue