Introduction and setup

rt-robotest is a complete suite of hardware and software modules, for automated HIL system testing. Targeting embedded systems with hard real-time demands. IO's, busses and other electrical interfaces can be stimulated through an EtherCAT based real-time IO interface.

Many embedded systems include some kind of companion or configuration software running on a PC. With rt-robotest, this software can easily be automated and included in the system test setup.

robotest_overview.png
rt-robotest system overview

Preconditions

Python

RIDE (Robot Framework IDE) runs only on the regular Python, not on Jython nor IronPython. Python 2.6 is the minimum version, and 2.7.x is recommended. Please notice that on OS X RIDE requires 32-bit Python version.

Most other operating systems than Windows have a recent enough Python installed by default. You can find Windows installers and plenty of other information from http://python.org.

wxPython

RIDE's GUI is implemented using wxPython toolkit. Only wxPython 2.8.12.1 with Unicode support is officially supported. Possible new releases in wxPython 2.8 series ought to work fine too.

On Windows you can download an appropriate installer from wxPython download page. For more information about the installation see http://wxpython.org pages in general.

On Linux you should be able to install wxPython with your package manager. For example, on Debian based systems such as Ubuntu running sudo apt-get install python-wxgtk2.8 ought to be enough.

On OS X you should use wxPython binaries found from the wxPython download page. wxPython2.8 only has 32 bit build available, so Python must be run in 32-bit mode also. This can be done globally by running:

defaults write com.apple.versioner.python Prefer-32-Bit -bool yes

or just for the RIDE execution:

VERSIONER_PYTHON_PREFER_32_BIT=yes ride.py

rt-robotest software suite

If RIDE is used only to edit test cases, Robot Framework does not need to installed at all. However, rt-robotest requires Robot Framework to be installed in order to execute tests.

Install rt-robotest software suite. This includes Robot Framework, xLink protocol and RIDE with rt-robotest plugin. From a command prompt, run:

pip install http://www.rt-labs.se/content/uploads/rt-robotest.zip

Start-Up

After a successful installation RIDE can be started from the command line by running

ride.py

Alternatively you can specify a file or directory to open as an argument like ride.py path/to/tests.

On Windows running ride.py requires having <PythonInstallationDir> on PATH. If pybot command to run tests with Robot Framework works you should be fine.

If you use Cygwin on Windows, you may need to fix the shebang line in ride.py manually before running it.

reading

On top of this page you will find a link 'Related Pages', that has documentation for the different rt-robotest hardware and software modules.