Getting started with Linux

Runtime
straton user guide – Rev. 10

[email protected]
CP_R31_006_H
STRATON AUTOMATION, All Rights Reserved
The information contained in this document is the property of STRATON AUTOMATION. The
distribution and/or reproduction of all or part of this document in any form whatsoever is authorized
only with the written authorization of STRATON AUTOMATION. The technical data are used only
for the description of the product and do not constitute a guarantee of quality in the legal sense of
the term. We reserve the right to make technical changes.

2
Content

INSTALLATION OF STRATON ..........................................................................................................4

1.1. Download and install straton Editor ........................................................................................... 4
1.2. Download and install the T5 runtime......................................................................................... 4
1.3. Download an application................................................................................................................ 5

2. EXAMPLES WITH DIFFERENT LINUX OS (X86 VERSION) ......................................................... 7

2.1. Tested with Debian 9.8 / Fedora 29 workstation / Ubuntu 16.04 ................................... 7
2.2. Tested with Ubuntu 14.04 .............................................................................................................. 8
2.2.1. Update and upgrade your system ................................................................................... 8
2.2.2. Cleaning the existing gcc and installing the correct one ................................................. 8

2. TEST ON A 64 BIT OS (UBUNTU 18.04.2 LTS X64) ................................................................... 10

FREQUENTLY ASKED QUESTIONS .................................................................................................11

3
Installation of straton

Installation of straton

1.1. Download and install straton Editor

Download and install the straton Editor from https://straton-plc.com/en/downloads/

1.2. Download and install the T5 runtime

Download the straton runtime from https://straton-plc.com/en/downloads/

IMPORTANT: the runtime’s version must fit to your processor (ARM, x86…). The runtimes available on the
website have been built for demo purposes only. Thus, STRATON AUTOMATION cannot guarantee that
this demo runtime will work on your target. Some of the already tested configurations are listed in the
part 2 of this document.

Copy the t5runtime to the Linux device. Connect to the device and set the rights to the runtime:
 chmod +x t5runtime
Start it by typing the following command:
 sudo ./t5runtime

From version 11, an additional bash file named run.sh is provided. This helper can assist the user to select
the appropriate command line arguments.
Grant rights to the file using “chmod +x run.sh”
Launch “sudo ./run.sh --help” to display information about the arguments
Launch “sudo ./run.sh” to start t5runtime with the optimal command line arguments.

By default the runtime’s port number is 1100.

The straton runtime is not started automatically, this needs to be set in the Linux environment.

If not activated straton Runtime runs for 2 hours, the license needs to be installed in a K5License.ini file, in
the same folder as the t5runtime. Please note that the Editor must be licensed too.

In order to activate the license, type in a console, in the same directory as the Runtime:
 echo 00-D0-C9-C7-F9-B5.0100.0.0.4FDD > K5License.ini
(Replace 00-D0-C9-C7-F9-B5.0100.0.0.4FDD with your own license)

4 | 11
Installation of straton

1.3. Download an application

First of all, start a straton Runtime on the platform.

Open the straton IDE and select the Demo project list (Menu
File > \xxx\DEMO.W5L), or click on the DEMO project list in
the start page.
(NOTE: clicking on the “Demo projects” title opens the demo
projects’ folder)

The project list opens. Right-click on the “Samples” project and set it as startup project, so this project will
be the one that will be built and downloaded to the runtime.

5 | 11
Installation of straton

Download the application to the straton runtime:

Select the communication parameters in menu Tools/Communication Parameters

Establish the connection through menu Project/Online ( )

RESULT IS:

The download is successful and application starts correctly.

The runtime is not started or communication parameters are wrong.

The application is not yet downloaded or an error occurs during startup. More detail can be found in the
output view.

6 | 11
Examples with different Linux OS (x86 version)

2. Examples with different Linux OS (x86 version)

2.1. Tested with Debian 9.8 / Fedora 29 workstation / Ubuntu

16.04
Download the runtime to your hardware:

Set the execution rights to the runtime file:

Then start the runtime:

7 | 11
Examples with different Linux OS (x86 version)

2.2. Tested with Ubuntu 14.04

In the case of Ubuntu 14.04 and older runtimes, error messages such as the following one could occur:

This message means that the OS does not have the appropriate version of libstdc++.so.6 (library used to
do some C/C++ coding) or gcc (code compiler).

In order to solve this issue, two different methods are existing:

2.2.1. Update and upgrade your system

 sudo apt update && sudo apt upgrade -y
It will update all components/software/libraries already installed and upgrade the OS.
WARNING: if you don’t want to change your OS version, do not use this method.

2.2.2. Cleaning the existing gcc and installing the correct one
First of all update the system:
 sudo apt update
▪ Then get the ‘synaptic’ package manager to proceed easily in the next steps:
 sudo apt-get synaptic
▪ Once installed, start it:

8 | 11
Examples with different Linux OS (x86 version)

From this interface, all the installed packages on the system are visible. It is also possible to install or
uninstall it. Looking for the gcc packages leads to:

At least the version 4.8 of gcc is needed for the runtime to run correctly. If the system has older versions
of gcc installed then uninstall all these versions first before installing a newer one.

9 | 11
Test on a 64 bit OS (Ubuntu 18.04.2 LTS x64)

2. Test on a 64 bit OS (Ubuntu 18.04.2 LTS x64)

Always check the name of the delivery when downloading the runtime. For 9.3 and older runtimes, this
should look like ‘T5LINUX-x86-ENERGY’, meaning that the runtime has been compiled for a 32 bit
Operating System (x86 OS)

After setting the execution rights to the runtime (#sudo chmod +x t5runtime or #sudo chmod
+x run.sh), trying to launch it on an x64 OS may lead to an error message like the following one:

First of all, install the latest x86 / x64 library package using the following command:
 sudo apt-get install gcc-multilib

Then this should be possible to start the runtime correctly. If not, use the following command to check
which DLLs are linked to the runtime and if some are missing:
 sudo ldd ./t5runtime

10 | 11
Frequently Asked Questions

Frequently Asked Questions

HOW TO GET THE MAC ADDRESS OF THE ETHERNET CARD(S)?

To get the MAC address use the following command: ifconfig

HOW TO DISPLAY THE CONTENT OF A FILE?

The following command can be used: cat <filename>

HOW TO EDIT THE K5LICENSE.INI?

File can be edited using: sudo nano <filename>
Use CTRL+X to close the file.

HOW TO CHANGE THE EXECUTION MODE OF A FILE?

By default a file copied to Linux do not get the execution privilege.
To set this privilege use the command: chmod +x filename

HOW TO GET PROCESSES STATUS?

Two commands are available:
 ps –A
 top

HOW TO LIST NETWORK CONNECTION?

Use the command: netstat

MY RUNTIME DOES NOT START OR IMMEDIATELY STOPS…

Check the file size on your PC and on your device. This must perfectly fit.
If you downloaded the runtime to your device using an FTP Client like Filezilla, think to check that the
Type of Transfer is set to ‘Binary’
Another important thing is that for the moment (version 9.3 and older) the demo runtimes for Linux are
only built for x86 and ARM processors! Thus, this may not run with x64 processors, even after installing
specific libraries.

HOW CAN I DETERMINE THE LINUX VERSION I’M USING?

Type the following command: uname -a

11 | 11