larsrc-google / robertalab

The programming environment »Open Roberta Lab" by Fraunhofer IAIS enables children and adolescents to program robots. A variety of different programming blocks are provided to program motors and sensors of the robot. Open Roberta Lab uses an approach of graphical programming so that beginners can seamlessly start coding. As a cloud-based application, the platform can be used without prior installation of specific software but runs in any popular browser, independent of operating system and device.

Open Roberta Lab

Build status:

• master
• develop

Introduction

The steps below explain how to get started with your own deployment of the OpenRoberta programming environment.

After a fresh git clone you get the robertalab project folder. It includes everything you need to setup and extend your own browser programming environment. License information is available in the docs folder.

Things you need on your computer:

• Java 1.7
• Maven >= 3.2
• Phantomjs
• Git
• Web browser

Please also check our wiki for a detailed install instruction, development procedure, coding conventions and further reading. Please also checkout our project issue tracker.

Fast installation with maven

Step 1: Clone the repository and compile

git clone git://github.com/OpenRoberta/robertalab.git
cd robertalab/OpenRobertaParent
mvn clean install

Get a coffee! Might take a couple of minutes.

A successful build looks like:

[INFO] ---------------------------------------
[INFO] Reactor Summary:
[INFO] RobertaParent ..................SUCCESS
[INFO] Resources ......................SUCCESS
[INFO] OpenRobertaShared ..............SUCCESS
[INFO] OpenRobertaRuntime .............SUCCESS
[INFO] EV3Menu ........................SUCCESS
[INFO] OpenRobertaRobot ...............SUCCESS
[INFO] OpenRobertaServer ..............SUCCESS
[INFO] OpenRobertaUSB .................SUCCESS
[INFO] ---------------------------------------
[INFO] BUILD SUCCESS

Step 2a: Starting your own server instance using a unix-like shell (on either lin* or win*).

cd .. # return to the root folder
./ora.sh --start # start the server using default properties

You can also run ./ora.sh --help for more options.

Step 2b: Starting your own server instance without using the shell script

cd ../OpenRobertaServer # go to the folder of the server resources and the database
java -cp target/resources/\* de.fhg.iais.roberta.main.ServerStarter --properties  --ip 0.0.0.0 --port 1999

Step 3: Accessing your programming environment

Start your browser at: http://localhost:1999

That's it!