There are 2 contexts which you may wish to start using MyRobotLab. They are :
-
User - someone who uses MyRobotLab on some project. They are interested in only utilizing the current capabilities of MyRobotLab and are not interested in developing new Services. You may develop new functionality in Python within a "User" context and do not need Eclipse or any other dependencies.
-
Developer - someone who is interested in creating new Services in Java. They are interested in extending the functionality of MyRobotLab.
User
-
Install Java 1.8 for your operating system, please chose 64bit version if your system is 64.
-
Download MyRobotLab in it's latest build
-
Currently you can use the GUI to change message routing and some parameters of configuration, or you may use the Jython Service to create (Python-)scripts. The Jython environment has access to nearly all functionality of MyRobotLab.
-
Check out the Tutorials for something you like, or make a request for a new tutorial.
Developer
-
Install JDK 1.8 ( not JRE ) for your operating system
-
Install Eclipse unless you have a preference "Eclipse Standard" is a great IDE
-
Missing JDK TOOLS mod :
Edit eclipse.ini and replace jre by jdk :
C:/Program Files/Java/jre[VERSION]/bin/
by :
C:/Program Files/Java/jdk[VERSION]/bin/
-
Start Eclipse - put in a simple directory name (no spaces or unicode characters)
.png)
-
Next Select Menu Windows->Open Perspective->Other->Git

Clone a Git repository

We have 1 GitHub repo we want cloned :
https://github.com/MyRobotLab/myrobotlab
Use your own GitHub credentials if you have them - they aren't necessary if you just want to clone.
You can select needed branch, develop branch is current WIP, master the last stable.

I do not usually like the "default" location it chooses - but prefer a subdirectory to my workspace. Also click the Import all existing projects after the clone finishes

Switch now to Java view
Click File / import maven
-
Parameters Explained:
-
--service gui SwingGui Starts a SwingGui service named "gui", you may start multiple services at once with this command parameter. It will need to follow this convention --service <serviceName> <serviceType> <serviceName> <serviceType> ....
For example, --service gui01 SwingGui editor Jython
Starts a swingGui named gui01 and a Jython service named editor
-
-logLevel sets the current log4j level, other levels include (FATAL, ERROR, WARN, INFO, DEBUG)
-
-logToConsole redirects logging to the eclipse console, otherwise default behavior will be to a myrobotlab.log file
-
VM Arguments
-Djava.library.path="libraries/native/x86.32.windows;libraries/native/x86.64.windows" on Windows or
-Djava.library.path="./libraries/native/x86.32.linux:./libraries/native/x86.64.linux:./libraries/native/x86.32.mac" on Linux or Mac allows MyRobotLab to use native libraries required by some of the services (e.g. OpenCV, Arduino, Joystick, etc).
These directories are populated by the repo manager depending on what services are loaded & installed.
-
Hit F11 on the Runtime file and you should be up and running MyRobotLab in the Eclipse debugging perspective... have fun :)
Optional
Script Development
Personnal contributions : https://github.com/MyRobotLab/pyrobotlab/tree/develop/home
Services scripts : https://github.com/MyRobotLab/pyrobotlab/tree/develop/service