LJ/README.md

183 lines
6.2 KiB
Markdown
Raw Normal View History

2018-12-31 13:49:11 +00:00
LJ v0.7.1
2018-12-13 11:05:32 +00:00
By Sam Neurohack, Loloster, Cocoa
LICENCE : CC BY
2018-12-31 02:41:02 +00:00
2018-12-13 11:05:32 +00:00
![LJ](http://www.teamlaser.fr/thsf/images/fulls/THSF9-33.jpg)
2018-12-30 15:12:30 +00:00
A software laser server with GUI for up to 4 lasers live actions. Think creative like Laser "battles", planetarium,...
2018-12-13 11:05:32 +00:00
2018-12-30 15:12:30 +00:00
LJ has 3 main components :
2018-12-13 11:05:32 +00:00
2019-01-16 00:50:24 +00:00
- A "tracer" per etherdream/laser that take its point list, correct geometry, recompute in etherdreams coordinates, send it to its controller,... and report etherdream status to the manager.
- A "manager" that talk to all tracers (which client number point lists to draw, new geometry correction,...), handle the webui functions, OSC commands,...
2018-12-30 15:12:30 +00:00
- Up to ten clients, that simultaneously send one point list per laser.
Needs at least : an etherdream DAC connected to an ILDA laser, RJ 45 IP network (gigabits only !! no wifi, 100 mpbs doesn't work well with several lasers)
2018-12-13 11:05:32 +00:00
LJ supports Linux and OS X. Windows is unkown but welcome, if someone want to jump in and care about it.
2018-12-13 11:05:32 +00:00
2018-12-30 15:12:30 +00:00
2018-12-13 11:05:32 +00:00
#
# Features among many others.
#
(Doc in progress)
2018-12-30 15:12:30 +00:00
- OSC and websocket commands. Very cool : LJ can script or be scripted.
2019-01-16 00:50:24 +00:00
- Web ui : In your browser open webui/index.html. Javascript is needed. By default it connect to localhost. If you want to control a remote server, you need to change the uri line in LJ.js.
2018-12-30 15:12:30 +00:00
- Status update every 0.5 seconds : every etherdream DAC state, number of buffer points sent,...
- "Optimisation" points automatically added, can be changed live for glitch art. Search "resampler" commands.
2018-12-31 02:51:32 +00:00
- A compiled version for os x and linux of nannou.org etherdream+laser emulator is included. For more informations, like license see https://github.com/nannou-org/ether-dream
2019-01-16 00:50:24 +00:00
- Some fancy examples are available : 3D anaglyph, Laser Pong, Laser Wars
2018-12-13 11:05:32 +00:00
#
# Install
#
With Linux, type in a terminal window :
2018-12-13 11:05:32 +00:00
./install.sh
For OS X, you need brew already installed, then :
brew update
brew upgrade
brew install redis
2018-12-31 13:49:11 +00:00
type all install.sh commands beginning line 4. An OS X install script soon !!
For Linux and OS X :
2018-12-31 13:49:11 +00:00
You probably want redis bound to all network interfaces : comment the bind line in /etc/redis/redis.conf and restart it.
2018-12-13 11:05:32 +00:00
2018-12-31 13:49:11 +00:00
In webui/index.html change the ws ip adress to the server IP if needed.
2018-12-13 11:05:32 +00:00
2018-12-27 11:40:30 +00:00
Using the same idea check all ip address in LJ.conf.
2018-12-13 11:05:32 +00:00
#
# To run
#
2018-12-31 13:49:11 +00:00
Order is :
- Dac/Laser (emulator or IRL)
- Redis server once.
- This server. see below.
- Load/reload webUI page from disk in a browser (webui/index.html). Javascript must be enabled.
2019-01-16 00:50:24 +00:00
- Run a client, see in clients folder for examples.
2018-12-31 13:49:11 +00:00
2018-12-30 15:12:30 +00:00
A typical start is python main.py -L numberoflasers. Use -h to display all possible arguments.
2018-12-13 11:05:32 +00:00
Case 1 : the laser server computer is the same that the computer running a client :
2018-12-27 11:40:30 +00:00
python main.py
2018-12-13 11:05:32 +00:00
2018-12-30 15:12:30 +00:00
Check in your client code if the laser server IP is the good one
2018-12-13 11:05:32 +00:00
Run your client
to monitor redis server :
redis-cli monitor
Case 2 : Server and Client computers are different :
Say the laser server computer (running LJ) IP is 192.138.1.13, the client computer is 192.168.1.52
On the server computer :
edit /etc/redis/redis.conf
2018-12-30 15:12:30 +00:00
use -r argument :
2018-12-27 11:40:30 +00:00
python main.py -r 192.168.1.13
2018-12-13 11:05:32 +00:00
2018-12-30 15:12:30 +00:00
run the client on client computer, like :
2018-12-13 11:05:32 +00:00
node testredis.js
to monitor redis server :
2018-12-30 15:12:30 +00:00
redis-cli -h redisserverIP monitor
2018-12-13 11:05:32 +00:00
2019-01-16 00:50:24 +00:00
#
# Program your own "Client"
#
The server approach is based on redis, so you write and run your laser client software in any redis capable programming langage (50+ : https://redis.io/clients).
- Read the Introduction part in this readme.
- There is a clients folders with examples in different languages.
- Generate at least one point list array (say a square).
- Feed your point list array in string format to redis server.
-
2018-12-13 11:05:32 +00:00
#
# Todo
#
(Doc in Progress)
- kpps live modification for glitch art.
2018-12-31 13:49:11 +00:00
- A grid style warp correction process in webUI
2018-12-13 11:05:32 +00:00
2019-01-16 00:50:24 +00:00
#
# Networking
#
LJ is network based and this is *critical and flickering reason #1* if not managed properly, especially if you have several lasers.
Our "always working solution", as we regularly move our gear for different venues :
We use static network configuration. Our Etherdreams controllers have static IPs defined in their SDcard from 192.168.1.1 to 192.168.1.9. Because wifi will always finally sucks for many reasons, our computers (laser server and clients) are *gigabits wired connected* with 192.168.1.10 and after. Don't trust end user gear marketing on wifi, we have a big gigabits switch for laser only stuff. We provide Internet through wifi on different network like 192.168.2.x
Even if etherdreams are 100 Mbits, we use gigabits gear.
By default LJ uses on 127.0.0.1 (localhost) :
- A websocket on port 9001 for WebUI interaction.
- The redis server on port 6379 ('ljayserverip')
- An OSC server on port 8002.
- An OSC client as output on port 8001.
- An OSC client for Nozoids support on 'nozoscIP', port 8003.
You need to update LJ.conf to your network/etherdreams IPs and be sure to check command arguments : python main.py --help
The need for a dedicated computer to act as "laser server" usually depends on how many lasers you want to control and your main computer load. If you seen flickering with small point lists, try the dedicated computer option and/or stop process interfering like redis monitoring,...
2018-12-13 11:05:32 +00:00
#
# Ether dream configuration
#
![Etherdream Laser DAC](https://www.ether-dream.com/ed2-external.jpg)
2018-12-31 13:49:11 +00:00
This program suppose that the ether dream is configured in a certain way especially for its IP address. We write an autoplay.txt file inside an SD Card within the ether dream DAC, with the following lines you can adjust i.e for pps or fps. Yes, there is a builtin DHCP client in the ether dream DAC but if you run multiple lasers, having a fixed dedicated network makes you focus on laser stuff.
2018-12-13 11:05:32 +00:00
/net/ipaddr 192.168.1.3
/net/netmask 255.255.255.0
2019-01-16 00:50:24 +00:00
/net/gateway 192.168.1.10
2018-12-13 11:05:32 +00:00
/ilda/pps 25000
/ilda/fps 25
2019-01-16 00:50:24 +00:00
About hardware setup, especially if you have several lasers : ILDA cables are insanely expensive. You may consider the Power Over Ethernet 'POE' option. Buy a very small ILDA cable, a POE splitter and connect everything to the ether dream fixed near your laser. You can have then a simple and very long network cable and use a Power Over Ethernet injector or switch close to the driving computer. Beware some vendors use 24V POE Injector : POE injectors and splitters must match.