aboutsummaryrefslogtreecommitdiff
path: root/docs/Usage
diff options
context:
space:
mode:
authorJakob Stendahl <jakob.stendahl@outlook.com>2018-11-29 23:14:58 +0100
committerJakob Stendahl <jakob.stendahl@outlook.com>2018-11-29 23:14:58 +0100
commit101745c6a4a2c6a186be48182d48814177840c65 (patch)
treeee7c7420291473033cf7cd9f921fe21958bf571f /docs/Usage
parent2147880e40ee39ae07c8df9d3500080da467475d (diff)
downloadLuxcena-Neo-101745c6a4a2c6a186be48182d48814177840c65.tar.gz
Luxcena-Neo-101745c6a4a2c6a186be48182d48814177840c65.zip
:construction: Chenged things, and written some docs
Diffstat (limited to 'docs/Usage')
-rw-r--r--docs/Usage/CLI.md26
-rw-r--r--docs/Usage/Configuration.md78
-rw-r--r--docs/Usage/Install.md32
-rw-r--r--docs/Usage/README.md11
4 files changed, 147 insertions, 0 deletions
diff --git a/docs/Usage/CLI.md b/docs/Usage/CLI.md
new file mode 100644
index 0000000..f689a3d
--- /dev/null
+++ b/docs/Usage/CLI.md
@@ -0,0 +1,26 @@
+# Command line interface
+---
+
+This gets installed in the `/usr/bin` directory, and can be called by:
+```bash
+$ luxcena-neo.sh
+```
+or is alias
+```bash
+$ lux-neo
+```
+{% hint style='danger' %}
+This CLI assumes root access, so please run it with `sudo`
+{% endhint %}
+
+## Options
+#### `sudo lux-neo uninstall`
+Uninstall the whole thing. You will have to remove this script yourself.
+#### `sudo lux-neo update`
+Update to the newest version on the current branch.
+#### `sudo lux-neo conf`
+Open the strip-config in `nano`.
+#### `sudo lux-neo start`
+Start the server.
+#### `sudo lux-neo stop`
+Stop the server.
diff --git a/docs/Usage/Configuration.md b/docs/Usage/Configuration.md
new file mode 100644
index 0000000..c9750d0
--- /dev/null
+++ b/docs/Usage/Configuration.md
@@ -0,0 +1,78 @@
+# Configuration
+
+How to setup luxcena-neo to work with your setup
+
+---
+
+```bash
+$ sudo lux-neo conf
+```
+
+When running the command above, a config file should appear in the editor 'nano'.
+```json
+{
+ "led_count": 53,
+ "segments": [],
+ "matrix": [],
+ "segmentConfiguration": "snake",
+ "led_pin": 18,
+ "led_freq_hz": 800000,
+ "led_dma": 10,
+ "led_invert": false,
+ "led_channel": 0
+}
+```
+{% hint style='tip' %}
+If you rather want to use vim or another editor, the file is at `/home/lux-neo/userdata/config/strip.json`
+{% endhint %}
+
+## led_count
+
+This is the number of LED's you want to control.
+
+## segments
+
+This is a simple list, here you should add the lenghts of all your segments. Please enter the "real" length, and don't start counting from 0. If you just want one segment, you should just have one element in the list, which is the number of led's you are controlling.
+
+When summing this list, it should check out with the "led-count"-option.
+
+## matrix
+
+This is a two dimensonal array, used to arrange the segments in a matrix of your likings. Here you enter the segment-number to represent them. In the example above, all the segments are in one line. If you want to have them in a square, it could look like this:
+
+```json
+"segments": [10, 10, 10, 10, 10, 10, 10, 10, 10],
+"matrix": [
+ [0, 1, 2],
+ [3, 4, 5],
+ [6, 7, 8]
+]
+```
+{% hint style='danger' %}
+If you don't have a reference to all the segments or something, the matrix setup will fail. And fall back to 'segmentsconfiguration'
+{% endhint %}
+
+## segmentconfiguration
+
+If the matrix-option is empty or badly setup. The matrix will be set up using one of these defaults:
+
+```
+"snake":
+"line":
+"random":
+```
+
+## led_pin
+If using the luxcena-shield, you shouldn't have to worry about this option. But set it to the GPIO-port connected to your pixel's din-port.
+
+## led_dma
+{% hint style='danger' %}
+If using a newer RPi (3 or newer), leave this as 10! Or your file-system might crash.
+{% endhint %}
+This is the dma-channel used to generate the data-stream. If you for some reason need channel 10 for something else, you can change it. But i strongly recommend leaving it to 10!
+
+## led_invert
+This should not be touched, unless you are using a inverting level converter.
+
+## led_channel
+Leave this as default unless you know what you are doing.
diff --git a/docs/Usage/Install.md b/docs/Usage/Install.md
new file mode 100644
index 0000000..ced241a
--- /dev/null
+++ b/docs/Usage/Install.md
@@ -0,0 +1,32 @@
+# Installation
+
+If you want to install luxcena-neo to use it, these are the instructions:
+
+---
+
+## Requirements
+* The luxcena-shield
+* Access to the raspberry pi (SSH or direct)
+* Root access (preferably through the `sudo` command)
+
+## Install
+1. Start with logging into your Raspberry Pi
+2. Run these commands
+```bash
+$ git clone https://github.com/JakobST1n/Luxcena-Neo
+$ cd Luxcena-Neo
+$ sudo ./bin/install.sh
+```
+3. Follow the instructions on screen. You should answer yes to most of the questions.
+4. The install-process might seem to hang, but there is just no output being sent to the console. If you want to see a bit more verbose output. Open another terminal session, and run this command:
+```bash
+$ tail -n 10 -f /tmp/luxcena-neo.install.log
+```
+This is also where you will find possible reasons for a failed install.
+4. Luxcena-Neo should now be installed. Start it with this command
+```bash
+$ luxcena-neo start
+```
+
+## Troubleshooting
+We haven't encountered any troubles yet, but once we do, we will post fix'es here.
diff --git a/docs/Usage/README.md b/docs/Usage/README.md
new file mode 100644
index 0000000..ce62034
--- /dev/null
+++ b/docs/Usage/README.md
@@ -0,0 +1,11 @@
+# Usage
+
+
+## [Install](/Usage/Install.md)
+Want to install luxcena-neo? This is the guide!
+
+## [Configuration](/Usage/Configuration.md)
+Just installed luxcena-neo, or you have changed your setup? This is the guide!
+
+## [CLI](/Usage/CLI.md)
+Ready to start the thing? Or change something?