This page is for compiling 4diac FORTE for the Lego Mindstorm EV3. For information about the parameters to be used, go to the Parameters page
Lego Mindstorm is a series of kits from Lego, whose flexibility allows constructing different systems which can be controlled and sensed by the user, using the inputs and outputs. This document focuses on how to implement 4diac FORTE on the specific model Lego Mindstorm EV3(LMSEV3). To know more about the LMSEV3 you can visit its Wikipedia page.
The LMSEV3 comes with its own software, but work has been done to implement a Linux distribution that can run on it. The ev3dev is a Debian Linux-based operating system that can run on the LMSEV3. More information about capabilities of ev3dev can be found on its website. The procedure to make ev3dev run in a LMSEV3 is similar to running a Linux operating system on a Raspberry Pi. The best and fastest way to implement ev3dev in a LMSEV3 is following the instruction on its getting started page. Basically, what must be done is to download the ev3dev image and write it on a mini SD card (yes, without an mini SD card you won't be able to run it), insert it in the LMSEV3 and boot it.
So, what will you find in this special Linux version for LMSEV3? First, you'll find a menu in the screen of the LMSEV3 that can be accessed using the buttons. And secondly, you will be able to connect using SSH the same way you would do it on a Raspberry Pi, the BeagleBone Black or any other Linux-based operating system and go through the folder system of the ev3dev that is prepared for the LMSEV3. To access all the I/O of the LMSEV3 (including the buttons, LED and the screen), there are specific explanations in this ev3dev webpage, but 4diac FORTE takes care of accessing them and you as user will only work with normal I/O Function Blocks as IX, QX, IW, QW and so on.
To access the LMSEV3 via SSH you'll have to setup a network connection first. The easiest way is using a WiFi dongle that can be connected to the LMSEV3's USB port. A few compatible WiFi dongles are listed here. Once you have a WiFi dongle, you can connect to a WiFi network via "Wireless and Networks" on the start menu. Power on WiFi, scan for available networks and then connect to it. If you successfully connected to a WiFi network, the IP address of the LMSEV3 will be shown in the top left corner of the screen. To make life easier, setup your router to use static IP addresses. Now you can setup an SSH connection on your computer. How to setup a connection with PuTTY or WinSCP is explained here
With the LMSEV3 running the ev3dev and it being accessible through SSH, the next thing to do is to install and run 4diac FORTE in it. Similar to other platforms, you have two possibilities. The first one is to transfer the source code to the ev3dev (using WinSCP in Windows or the "scp" command in Linux), installing the compiler and other necessary tools (C++ compiler and CMake, mainly) and compiling it directly in the LMSEV3. The second option is to use a cross-compiler. This means that you will code and compile in your desktop machine, and then send the executable to the LMSEV3 and run it there. The first option is easier to implement but is slower to compile. The second one is much faster but you will have to setup of the environment on your desktop machine. With Docker, it's much easier to do the second option. The first option should be used only when installing Docker is not possible. Especially if you will be compiling several times, you should try the second option. Getting your desktop machine to cross-compile for the ev3dev is not easy, but a complete step by step guide is presented here.
To set up the cross-compiler, the following steps must be done:
NOTE: all commands starting with docker
are run in the command prompt of your host computer, all other commands are run inside of your docker container (if you cross-compile) or inside of your EV3!
run
runs a new container --rm
this will make sure, that the container is thrown away once you are done. -it
this will make the command prompt available inside of your container. -v <host-path>:<container-path>
this will make a directory of your host computer accessible from within the container. Make sure to specify the host path according to your OS. On Windows hosts, you might experience some problems with file paths, e.g. when using git bash on Windows you need to use double backslash as file separator. -w <container-path>
this will specifiy the working directory within your container. ev3cc
this is the name of your Docker image.forte
to your brick using WinSCP. Check, whether execution rights are enabled for forte
. Remember, when you create your own FBs, you should add these to the 4diac FORTE folder, adjust the CMakefiles.txt and compile again. In the example section, it is explained how to do this.
If you have limited rights on your host computer (e.g. your company manages certain settings) and therefore can't use Docker, you can install a Linux distribution in a virtual machine and run your Docker container there. If you are having trouble setting up a virtual machine on your windows machine, try to disable "Hyper-V". You can follow the instructions here.
If you are having problems connecting to your EV3, try whether the network connection is working and ping your EV3. If your EV3 is connected, the IP address should be shown an the top of the screen.
If you are having problems including external modules, add this to your setup_lmsEv3.sh file
and run it again.
ext_mod
within your forte
folder. Your modules are then added as subfolders to ext_mod
. In this case, a module called "EV3" is added.
If you want to build a 4diac FORTE, here is a quick link back:
After you installed all required tools, it's time to start using them. Take a look at the tutorials - a step by step guide:
If you want to go back to the Start Here page, we leave you here a fast access
Or Go to top