E-box

This is the project page of E-box and related projects (E-scope)

DEVELOPERS

This section contains necessary information for the developers and programmers who use E-Box in their projects.

E-Box Programming

The user manual for the E-box and other EhterCAT slaves can be found here: User manual

The manual for installing a realtime linux system with EtherCAT support can be found here:Install manual and Frequently Asked Questions

Programming instructions

Manual EtherCAT library

ToDo List

This section contains a todo-list

Date	Description	Responsible

News / Changes

This section contains the important changes and news to the software

• 2011/11/14 Matlab R2011b is supported from revision (218)
• 2011/08/27 Changed Timer_posix to Timer_posix_AK from revision (142)
• 2011/07/17 SVN is working again
• 2011/07/12 Beckhoff EL3104 will be supported from next revision (106)

References

[1] Jeroen de Best and Roel Merry, Real-Time Linux for Dummies, DCT2008.103 PDF

[2] Jeroen de Best and Koen Meessen, Realtime Linux, Realtime_Linux

[3] Simple Open EtherCAT Master SOEM website

---

---

STUDENTS

E\Boxes are used in some of the courses. In this section, students can find the necessary information regarding to these courses.

Common Information

The information and manuals presented in this section is used for all courses.

Installation of Ubuntu with Wubi

WARNING: This installation will only work on a normal installation of the Windows Operating System as it depends on the Windows Boot loader. If you use another operating system or if you are unsure please contact one of the course supervisors.

Wubi is a linux installer for Windows which can install and uninstall Ubuntu in the same way as any other Windows application in a simple and safe way. Ubuntu will be installed within a file in the Windows system ebox_root.disk. This file is seen by Ubuntu as a real hard disk.

The installation of Ubuntu used for this course takes up 30 GB of free-space. Therefore, it is recommended to install Ubuntu by connecting to TU/e network via an ethernet cable. Using VPN or wireless is strongly discouraged!

The wubi-installer can be obtained from the TU/e network share: \\ai-stosrv02\EBox. Install by opening the executable "wubi_dd-mm-yy-time". Because the installation is quite large this will take some time, especially creating the virtual disk, so please be patient. Connected to gigabit network the installation will take approximately 15 minutes, on a 100 mbits network connection it will take about an hour.

When you have installed Ubuntu with Wubi, you can start ubuntu by rebooting your computer. A menu will appear during startup which allows you to choose whether to run Windows and Ubuntu. When you choose Ubuntu in this menu, you will go to a new bootloader called GRUB. Here you can choose which version of Ubuntu to run as well as alter the start-up commands for running Ubuntu. Unless you are having problems starting up, you should just select the default version by pressing enter. When prompted for account information use the following:

1. Username: ebox
2. Password: ebox123

You can change the password if desired.

Installing software for experiments

Activating Matlab

The version of Matlab installed on Ubuntu needs to be activated. To do so, start matlab from a terminal window with

1. sudo su
2. matlab

and follow the instructions and use the activation key linked on the campus software site. Matlab activatie

If the student activation key doesn't work, take the employee activation key

Update to the latest experiment software

The software to perform experiments is already present, but possibly outdated. To update the software and simulink models used, you have to checkout the latest stable revision from the SVN (subversion) server. This can easily be done using the svn_update script:

1. Open a terminal (via the icon on the desktop)
2. Type svn_update

If you are experiencing any problems (bugs/errors) with the experiment software, then first make sure you have checked out and installed the latest software revision from the SVN by repeating steps Update to the latest experiment software and Compiling and installation the software. Since this update will also update the simulink templates used in the experiments, it is recommended to save any changes made to these files with a different filename and/or in a different location, preferably on your harddisk.

Compiling and installation the software

First start matlab from a terminal (if not done already):

1. Open a terminal
2. Type sudo matlab

To obtain a fresh copy of the latest version:

1. Run svn_update according to subsection #Update to the latest experiment software in a terminal window.
2. Change the Matlab current directory to /home/ebox/svn/trunk/src/E-box
3. Run make_all_clean in matlab
4. Run make_all_install in matlab, answer yes to TU/e toolboxes installation question

Frequently Asked Questions

Ubuntu start niet

Boot onder windows en controleer de grootte van de ebox_root.disk file. Deze moet 31.188.844.544 bytes groot zijn (zie properties/eigenschappen). Is dit niet het geval, dan kun je de ebox_root.disk handmatig kopieren van de server.

Tijdens compilen krijg je een error of een conflict in sampling tijden (0.001 en 1/2048)

Update en installeer de software (vanaf r355 is dit opgelost) Update to the latest software en Compiling and installation the software. Start vervolgens vanaf een nieuwe kopie van het printer01 model

Tijdens compilen krijg ik errors met "undefined function or variable ref_part"

Dubbelklik op het ref3 blok en klik op accept voor het builden

svn_update werk niet

Voer het volgende commando uit in een terminal

   svn checkout https://e-box.wtb.tue.nl/svn/e-box/trunk/src/E-box/ /home/ebox/svn/trunk/src/E-box/

In de terminal waar de executable draait komt repeterend

   Error occurred getting packet header.
   Error occurred in rt_PktServerWork.
   Disconnecting from host!
   

   Error occurred getting packet header.
   Error occurred in rt_PktServerWork.
   Disconnecting from host!

te staan. Dit is een bekende Linux gerelateerde bug die meestal op te lossen is met een reboot van de pc, of door een andere pc gebruiken.

De scope in Simulink laat alleen het laatste stuk meetdata zien

Gebruik "To Workspace" blokken. Voor een model met naam printer_01.mdl wordt er een printer_01.mat file aangemaakt. Daarin staan de gemeten signalen, bijvoorbeeld rt_simout. De naam van het signaal simout kan je wijzigen, dubbelklik op het "To workspace" blok!

Error(s) encountered while building model "printer01"

Als je deze fout krijgt moet je even de inhoud van je script kopieren en je script afsluiten. Daarna verwijder je alle versies van je script die op je laptop staan, MATLAB doet hier op de een of andere manier moeilijk over, het is dus raadzaam om online of op een losgekoppelde usb stick een backup te hebben. Zet daarna de originele printer01.mdl file terug, open het model, ga naar het venster 'printer01/Enabled controller *' of dubbelklik op Enabled controller in het 'printer01*' venster. Verwijder alles wat er in dit venster staat en plak je gekopieerde script terug en compile. Als je nog errors krijgt over de step size verander je die van 1/1000 naar 1/2048 of andersom. Met het volgende script kun je alle printer01.mdl bestanden in een keer verwijderen van je ubuntu installatie, vervang printer01.mdl door jouw modelnaam.mdl:

cd /home/ebox; find . -type f -name "printer01.mdl" -exec rm -f {} \;

Er is ook een script dat voor jou alle printer01.mdl's verwijdert, en daarna de originele printer01.mdl voor jou terugzet, gewoon de map in de zip ergens plaatsen en het script herstel.sh uitvoeren door te dubbelklikken. https://dl.dropbox.com/u/49462631/herstelscript.zip Kopieer de inhoud uit je eigen model in printer01 in de standaardmap. Noem je eigen model anders dan printer01. In het hoofdbestand moet je nog twee pijltjes opnieuw verbinden. Sla het nieuwe bestand op onder een andere naam. Dit moet het probleem verhelpen.