Page History

Program LEGO Mindstorms with leJOS and SCCharts

...

Overview

Mindstorms is a product family from Lego, with sensors, motors and a programmable brick. The newest iteration of the product family is the EV3 programmable brick. Its predecessors are NXT and RCX. In the following we will see how to develop applications for the NXT brick.

...

• Introduction to SCCharts
• SCCharts Syntax
• SCCharts Examples

...

Download and install leJOS

Download and extract the newest archives for your Operating System from Sourceforce (Linux/Mac) or use the Setup.exe (Windows).

The further installation is explained in detail at httphttps://wwwlejos.lejossourceforge.orgio/nxt/nxj/tutorial/Preliminaries/GettingStarted.htm.

Do not forget to flash the download leJOS firmware to the Mindstorms brick as explained in the tutorial!

Known issues or remarks

Linux

You can switch your currently used java version via sudo After installing leJOS make sure that all commands are available in the PATH.

Make sure that this is also the case for gcc or javac/java if you plan to simulate your model.

You might have to start KIELER from the console to access all comands in the PATH.

Known issues or remarks

Linux

You can switch your currently used java version via sudo update-alternatives --config java

You can find a guide to install jelos leJOS and all dependencies here: https://wiki.ubuntuusers.de/LeJOS_f%C3%BCr_Lego_NXT/. You need to add the LEJOS_NXT_JAVA_HOME environment variable (which should point to your java 8 installation). Following this guide allows to connect via bluetooth.

You can flash your NXT using KIELER if you configure the LEJOS_HOME in KIELER via preferences>lejos>...Connection via usb does currently not work.

On Linux there is an issue when uploading the firmware because of a kernel module (http://ubuntuforums.org/showthread.php?t=1123633). If you can't upload the firmware with your Linux OS, add blacklist cdc_acm at the very end of the file /etc/modprobe.d/blacklist.conf. Afterwards execute sudo rmmod cdc_acm. This will remove the cdc_acm module from the kernel and prevent its restart. Now try to flash the firmware again.

...

Furthermore, to use USB connection, a java library has to be compiled via ant. To do this perform cd /path/to/leJOS/build and start ant. If the ant build tool is not installed on your system, you can do so via sudo apt-get install ant.

Windows

The setup.exe of the current LEGO Fantom driver for Windows (1.2.0) has an awkward issue. If you get an error message (Developer Error) because an .msi file could not be found, don't panic. The file is part of the downladed archive (in the Products folder) but you have to start it manually.

If you get a runtime error when starting the ssetup.exe also On Linux there is an issue that the NXT is found, but uploading any file to it does not progress after Found nxt <name>. Try to connect via bluetooth (-b option) if this is the case.

Windows

leJOS requires a 32 java installation as mentioned in the leJOS setup guide, Java 8 is confirmed to work.

The setup.exe of the current LEGO Fantom driver for Windows (1.2.0) has an awkward issue. If you get an error message (Developer Error) because an .msi file could not be found, don't panic. The file is part of the downladed downoladed archive (in the Products folder) but you have to start it manually.

If installing the fantom driver fails or does not work try to connect via bluetooth.

Mac OS X

The leJOS NXJ tools require a 32 Bit version of Java. However, newer 32 Bit versions of Java are not longer available for Mac. Thus to use leJOS the installation of Java 1.6 is required, which is the last one that supports a 32 Bit mode. You can download the installer for Java 1.6 from https://support.apple.com/You may also try to install the necessary drivers by following the Guide to install on Windows 10 on Reddit.

If you get a runtime error when starting the setup.exe also don't panic. The file is part of the downloaded archive (in the Products folder) but you have to start it manually.

If installing the fantom driver fails or does not work try to connect via bluetooth.

Mac OS X

The leJOS NXJ tools require a 32 Bit version of Java. However, newer 32 Bit versions of Java are not longer available for Mac. Thus to use leJOS the installation of Java 1.6 is required, which is the last one that supports a 32 Bit mode. You can download the installer for Java 1.6 from https://support.apple.com/kb/dl1572?locale=en_US. It will install Java 1.6 to /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home so that the environment variable LEJOS_NXT_JAVA_HOME, which is set in the installation instructions, points to the correct path.

The environment variable LEJOS_NXT_JAVA_HOME is set in the installation tutorial by editing ~/.profile. However, on a Mac the environment variables defined in this file are not visible for GUI Applications, only for apps started from terminal. Thus to use leJOS together with KIELER, one either has to start KIELER from terminal or set the environment variable so that all GUI applications can access it. However, this does not seem to be trivial on Mac (see also http://stackoverflow.com/questions/135688/setting-environment-variables-in-os-x).

...

Test the Mindstorm

A simple Hello World application for the Mindstorms is developed as part of the leJOS tutorial http://www.lejos.org/nxt/nxj/tutorial/Preliminaries/FirstProgram.htmCompile by setting .

If get a compilation error, set the java compliance level (target and source are necessary if you are using java 11 or something like that and have not set LEJOS_NXT_JAVA_HOME to a java 8 installation).

nxjc -target 1.8 -source 1.8 HelloWorld.java

...

If this works with your device, you are able to start using KIELER to develop applications for the NXT brick.

Download and Configure KIELER

Download and unpack the nightly build of KIELER for your OS. It is available at the Downloads page.

Note: Java 1.8 is needed on all operating systems. With Java 1.7 not all plugins of KIELER will be loaded. Furthermore on Windows, you will need to download the 32 Bit version of KIELER – even if you have a 64 bit operating system! Otherwise flashing the brick and uploading to the brick will fail.

TODO how to compile for leJOs in KIELER

Creating an Example Project

TODO Wrapper do not work anymore.However you might still need a java 1.8 or lower, since KIELER does not add target and source per default.

Renaming your NXT brick

If you plan to use bluetooth to connect to your NXT it might help to change the name of your NXt brick.

You can do that via the nxjbrowse command (if USB does not connect add the -b option).

Select your NXT and click connect.

Via Set Name the name of your brick can be changed.

...

Download and Configure KIELER

Download and unpack the nightly build of KIELER for your OS. It is available at the Downloads page. No configuration is needed.

You do not need the preinstalled NXJ plugin in KIELER, but leJOS has to be installed and all commands have to be in the PATH.

...

Creating an Example Project

The following shows how to create a project, which will turn on a light if a button is pressed.

Create a new project:

1. Choose File > New > Project > General > Project (do never convert your project in a an Xtext-project)
2. The project is created and the model file is opened in an editor (This might take a few seconds)..
3. Create a SCChart inside the project.
4. Open the SCCharts modeling perspective (Window > Perspective > Open Perspective > Other)
5. Edit the model
6. Compile the model using the KIELER compiler (using the Netlist-Based Deployment (NXT) compilation system)

Edit the Model:

Change the contents of the model file to the following code and save it.

scchart FlashlightFloodlight {
    
    @Wrapperinput TouchSensor,bool S4
    input bool @macro "Button", "ENTER" button
    
    @Wrapperoutput bool @macro "Floodlight", "S1
    output bool " light
    
    initial state lightOff
    if button do light = true go to lightOn
    
    state lightOn
    if !button do light = false go to lightOff
}

...

The annotations on the input and output variable are used to define which wrapper code is used to set / read them. @Wrapper TouchSensor, S4 @macro "Button", "ENTER" will set the input variable to true iff the touch sensor on the port S4 orange enter button is pressed. @Wrapper @macro "Floodlight", "S1" on the output variable will turn on the red led of the light sensor that is attached to port S1 iff the variable is true.

The available wrapper code snippets are defined in the directory assets/snippets in ftl files (FreeMarker template files). The table below gives an overview of the available wrapper code snippets.

Note: The Floodlight of the EV3 has a pretty high latency when switching between on and off.

Compile the model:

TODO

Available Wrapper Code Snippets

There Select the Netlist-Based Deployment (NXJ) or Netlist-Based Deployment (NXJ) Bluetooth to deploy to the NXT.

This compilation chain is accessible via the KIELER Compiler View.

Available Wrapper Code Snippets

There are several wrapper code snippets that can be used as annotations on input and output variables in the model file. These snippets are inserted in the main file template as part of the project build. The available snippets are listed below.

For sensors, the port has to be on of S1, S2, S3, S4.

For motors / actuators the port has to be one of A, B, C, D.

...

Resets a clock, such that the full time intervall of the clock has to elapse, before the clock will be set to true again.

If autoFalse is true, the reset variable will be set to false automatically.

...

Delays the execution until the tick loop takes at least as long as the given target duration.

The input variable is set to the actual tick loop duration.

...

Should be used on the very first input variable in the model, such that waiting is the last action in the tick loop.

In case the actual tick loop duration is longer than the target duration, the modeler can provide some error handling.

...

...

Should be used on the very last input variable in the model, such that waiting and settings the system time is the last action done, before the tick function call.

...

Reads  the value of a light sensor.

If percentValue is true, the a percent value is retured, based on the light sensor calibration.

...

input

output

...

input

output

...

Lets a motor rotate the variable value in degrees. This is only done if the value is unequal zero. If the value is negative, the motor rotates backwards. The variable is set to zero afterwards, such that setting the variable once to a value X, will let the motor rotate X degrees.

...

Plays a sequence of tones in either ascending or descending tone frequency if the variable is true.

The variable is set to false automatically.

...

direction has to be one of Up, Down

default volume is 10

...

Not available on NXT

mode hat to be one of Angle, Rate

...

Resets a gyroscope if the variable is true.

If autoReset is true, the variable is set to false automatically.

...

Using the Remote Console (RConsole) TODO

The display of the NXT brick is rather small compared to a Monitor. To ease debugging, one can print to a Remote Console (RConsole), if the USB cable is connected. This enables easier collection for example of sensor data.

To use the RConsole, uncomment the RConsole lines in the wrapper code template Main.ftl. Start the nxjconsoleviewer tool in the bin directory of your leJOS installation. Now, when starting the application, the brick tries to connect with the nxjconsoleviewer. Press the Connect button. If connected succesfully, RConsole.println(...) commands will be written to this window.

The EV3 brick has a similar feature. However it does not require any code changes. Just run the ev3console program in the bin directory of your leJOS installation from command line. The output of the brick will be printed to this command line.

Problem Solving TODO

The following presents typical issues and how to solve them.

...

"java.lang.UnsupportedClassVersionError"

"unsupported major.minor version"

...

Uploading to the brick does not respond

TODO not the only reason

...

This Java instance does not support a 32-bit JVM. Please install the desired version.

...

here.

...

Using the Remote Console (RConsole)

The display of the NXT brick is rather small compared to a Monitor. To ease debugging, one can print to a Remote Console (RConsole). This enables easier collection for example of sensor data.

Use the RConsole compilation system to deploy to the NXT (Currently called Netlist-Based Deployment (NXT) via RConsole). Start the nxjconsoleviewer tool. Now, when starting the application, the brick tries to connect with the nxjconsoleviewer. Press the Connect button. If connected succesfully, RConsole.println(...) commands will be written to this window.

To stop this nxt is this mode the ENTER and ESC button (orange and dark grey) have to be pressed at the same time. Yu have to disconnect and reconnect via the nxjconsoleviewer tool if you restart the application.

The EV3 brick has a similar feature. However it does not require any code changes. Just run the ev3console program in the bin directory of your leJOS installation from command line. The output of the brick will be printed to this command line.

...

Problem Solving

The following presents typical issues and how to solve them.