From 7bdce37fd3f18e2712e18c4e2c64cac69af0aca1 Mon Sep 17 00:00:00 2001 From: Jakob Stendahl Date: Sun, 19 Sep 2021 19:43:11 +0200 Subject: :boom: Introduce new UI based on svelte, and rewrite a lot of the node app and the NeoRuntime --- public/docs/Usage/CLI/index.html | 860 +++++++++++++++++++++++++++++ public/docs/Usage/Configuration/index.html | 767 +++++++++++++++++++++++++ public/docs/Usage/Install/index.html | 682 +++++++++++++++++++++++ 3 files changed, 2309 insertions(+) create mode 100644 public/docs/Usage/CLI/index.html create mode 100644 public/docs/Usage/Configuration/index.html create mode 100644 public/docs/Usage/Install/index.html (limited to 'public/docs/Usage') diff --git a/public/docs/Usage/CLI/index.html b/public/docs/Usage/CLI/index.html new file mode 100644 index 0000000..b89e230 --- /dev/null +++ b/public/docs/Usage/CLI/index.html @@ -0,0 +1,860 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CLI - Luxcena Neo Documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Skip to content + + + +
+ +
+ +
+ + + + +
+
+ + +
+
+
+ +
+
+
+ + +
+
+
+ + +
+
+
+ + +
+
+ + + +

Command line interface

+
+
+

Important!

+

This CLI assumes root access, so please run it with sudo

+
+

Options

+

sudo lux-neo uninstall

+

Uninstall the whole thing. You will have to remove this script yourself.

+

sudo lux-neo update (skipNode)

+

Update to the newest version on the current branch. +If skipNode is the second argument, npm won't be run.

+

sudo lux-neo conf

+

Open the strip-config in nano.

+

sudo lux-neo start (boot)

+

Start the server. +If you add boot, it will start when the system boots: +
1
sudo lux-neo start boot
+
+

+

sudo lux-neo stop (boot)

+

Stop the server. +If you add boot, it will NOT start when the system boots: +
1
sudo lux-neo start boot
+
+

+

sudo lux-neo status

+

This will output the status of the app. First it reports if the service is running, +and some general info. Then it prints the systemd-status report.

+

Example output: +
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
Luxcena-neo-cli [args: 'status']
+
+╭─────────────────────╮
+│ Service active: yes │
+│ Starts on boot: yes │
+│ Has failed:     no  │
+╰─────────────────────╯
+
+━━━Service status━━━━━━━━━━━━━━━━━━
+● luxcena-neo.service - Luxcena Neo
+   Loaded: loaded (/etc/systemd/system/luxcena-neo.service; enabled; vendor preset: enabled)
+   Active: active (running) since Wed 2018-12-05 22:55:28 UTC; 6min ago
+ Main PID: 2365 (luxcena-neo.sh)
+   CGroup: /system.slice/luxcena-neo.service
+           ├─2365 /bin/bash /home/lux-neo/src/bin/luxcena-neo.sh
+           └─2367 node /home/lux-neo/src/app.js
+
+Dec 05 22:55:28 LUXCENA-STUE-SKAP systemd[1]: Started Luxcena Neo.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+

+

sudo lux-neo log service/app

+

This shows the last 20 lines of the chosen log-file. And stays open to show +all new entries.

+

Example output: +
1
+2
+3
+4
+5
Luxcena-neo-cli [args: 'log app']
+
+━━━App log (press ctrl+c to exit)━━━━━━━━━━━━━━━━━━
+[3.11.2018 23:5:21:401] EVENT Starting Luxcena-Neo...
+[3.11.2018 23:5:22:462] SUCCESS Webserver now listening at *:8080
+
+

+

sudo lux-neo version

+

Currently not really doing anything usefull apart from showing which branch you are on.

+

Example output: +
1
+2
+3
+4
+5
+6
Luxcena-neo-cli [args: 'version']
+
+╭─────────────────────╮
+│ Version: Unknown    │
+│ branch : dev    │
+╰─────────────────────╯
+
+

+

sudo lux-neo selectBranch <branch>

+

This will change what branch you are on to . Stashing changes (shouldn't be a concern, but just saying it anyways).

+
+

Note

+

Please note that the version-checker now will just be useless, as it does not now what branch we really are on.

+
+ + + + + + + + + +
+
+
+
+ + + + +
+ + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/docs/Usage/Configuration/index.html b/public/docs/Usage/Configuration/index.html new file mode 100644 index 0000000..f1216e4 --- /dev/null +++ b/public/docs/Usage/Configuration/index.html @@ -0,0 +1,767 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Configuration - Luxcena Neo Documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Skip to content + + + +
+ +
+ +
+ + + + +
+
+ + +
+
+
+ +
+
+
+ + +
+
+
+ + +
+
+
+ + +
+
+ + + +

Configuration

+

How to setup luxcena-neo to work with your setup

+
+
1
$ sudo lux-neo conf
+
+
+ +

When running the command above, a config file should appear in the editor 'nano'. +
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
{
+    "led_count": 53,
+    "segments": [],
+    "matrix": [],
+    "segmentConfiguration": "snake",
+    "led_pin": 18,
+    "led_freq_hz": 800000,
+    "led_dma": 10,
+    "led_invert": false,
+    "led_channel": 0
+}
+
+

+
Tip - Change editor

If you rather want to use vim or another editor, the file is at /home/lux-neo/userdata/config/strip.json

+
+

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:

+
+

Warning

+

If you don't have a reference to all the segments or something, the matrix setup will fail. And fall back to 'segmentsconfiguration'

+
+

segmentconfiguration

+

If the matrix-option is empty or badly setup. The matrix will be set up using one of these defaults:

+
1
+2
+3
"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.

+
+

Warning

+

If using a newer RPi (3 or newer), leave this as 10! Or your file-system might crash.

+
+

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.

+
+

Now you might want to take a look at the command line interface.

+ + + + + + + + + +
+
+
+
+ + + + +
+ + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/docs/Usage/Install/index.html b/public/docs/Usage/Install/index.html new file mode 100644 index 0000000..9da9810 --- /dev/null +++ b/public/docs/Usage/Install/index.html @@ -0,0 +1,682 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Install - Luxcena Neo Documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Skip to content + + + +
+ +
+ +
+ + + + +
+
+ + +
+
+
+ +
+
+
+ + +
+
+
+ + +
+
+
+ + +
+
+ + + +

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. +
  2. Run these commands +
    1
+2
+3
    git clone https://github.com/JakobST1n/Luxcena-Neo
+cd Luxcena-Neo
+sudo ./bin/install.sh
+
    +
    3. +
  3. Follow the instructions on screen. You should answer yes to most of the questions.
    4. +
  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: +
    1
    tail -n 10 -f /tmp/luxcena-neo.install.log
+
    +
    +This is also where you will find possible reasons for a failed install.
    5. +
  5. Luxcena-Neo should now be installed. Start it with this command +
    1
    luxcena-neo start
+
    +
    6. +
+
+

neo":"luxcena-neo

+
+

Troubleshooting

+

We haven't encountered any troubles yet, but once we do, we will post fix'es here.

+
+

You should now be all set to configuring luxcena-neo.

+ + + + + + + + + +
+
+
+
+ + + + +
+ + + + + + + + + + + + + + + + + + + + \ No newline at end of file -- cgit v1.2.3