user manual - Evidence
Contents
1. How to install Evelin SDK odiosas ira hava ees 11 Initial dialog of VMWare o riera weed A 14 Em VIDAS 6 wid kg Be Geo ee a A A 14 Disabling automatic build seen AA 19 Setting visible hidden windows o a 19 Changing perspective e 20 Scratchbox preferences e 21 Changing Seralehibox path ceso oca we ee Pe 21 Creating a new project on Eclipse 0 000 ee eae 23 Creating a Scratchbox project on Eclipse 23 Creating the Eveln BSP project sisas suca ona aa ees 24 Selecting the target ee ds we be we eee es 24 a es he Ge ee ees eee eee RES 25 Choosing Scratchbox path and default target o oo oaa aaa 26 aio be hee ee ease REA eee She eee 27 Changing target for a given project 2 52 22 82 54204 nwa 28 Running a projette o dsd rra K Ee e 31 Configuration for running a project o 31 Configuration for running a project L lt o cc egora desd 32 How to terminate a running application o 32 De a ECs s ceg oemei k k p eRe RRR ERA EE Cw a 34 Creating the configuration for debugging a project 35 Creating the configuration for debugging a project 2 35 Changing the port used for debugging 36 Changing perspective to Debug ee eee 36 Debugging on unsupported target o oo o a e a ee 36 Debug TW o s care ee ee ee ee ee E Rees A 37 Debug2. Select your target as explained in Section 4 5 2 Build the project as explained in Section 4 5 3 Click the Debug icon as shown in Figure 4 18 and select the Debug configurations item The first time you debug the application you have to create the configuration To do that click twice on the Scratchbox2 application item as shown in Figure 4 19 A new configuration for your application will appear as shown in Figure 4 20 Select the project you wish to debug in the Project box Select the project you wish to debug in the C C Application box Note 4 5 9 It would not be possible to select the project if it has not been already compiled The Debugger tab shown in Figure 4 21 allows to set the network port of the operating system used for debugging The default value is 1234 You can change this value according to your needs Note 4 5 10 This feature allows to debug more applications simultaneously by using a different port for each debugged application 33 RAA EVIDENCE Chapter 4 Usage from Eclipse 10 11 12 13 14 Note 4 5 11 See the etc services file to know which ports are busy because already used by other services Click the Debug button The first time you start a debugging session the window shown in Figure 4 22 will appear Check the combobox and press the Yes button Note 4 5 12 Debugging on some targets is not yet supported For those targets the
3. To build the firmware for your embedded board if any follow the operations described in the next paragraphs 4 4 1 Import of the project First of all disable automatic build of the project as explained in Section 4 3 1 Then create a new project 1 Click on File gt New Project as shown in Figure 4 6 2 Select C New Scratchbox2 project as shown in Figure 4 7 3 Specify evelin bsp as project name see Figure 4 8 Note 4 4 1 Do not use a different name otherwise the firmware will not be compiled correctly 4 Select your target as shown in Figure 4 9 Note 4 4 2 Do not select to start from an existing template otherwise the firmware will not be compiled correctly Note 4 4 3 The default path is taken from the dialog shown in Figure 4 4 and should be fine in most situations 22 RAA EVIDENCE f EMAEDDINO TECHNOLOGY Chapter 4 Usage from Eclipse le hift Alt N E C Project Open File 8 New Scratchbox2 project dose E C Project Close All El Convert to a C C Make Project 63 Source Folder shift ctri s o Polder Ctrl S ef Source File hy Header File E File from Template F2 Class Convert Line Delimiters To Print Switch Workspace Properties Exit Figure 4 6 Creating a new project on Eclipse Select a wizard C Project to manage the configuration and compilation of a Scratchbox2 project Figure 4 7 Creating a Scratchbox pro
4. gcc make etc to build your application Depending on the chosen target Evelin SDK will invoke the right toolchain and will build the application for such target In other words the application can be compiled in the common way as if we were compiling it for our host architecture Evelin SDK will do the rest for us 16 AAA EVIDENCE Chapter 3 Usage from shell 3 3 Running a compiled binary Once the application has been compiled as explained in the previous section it can be run on the host architecture even if the binary has been compiled for a target architecture Evelin SDK in fact remembers which target the application has been compiled for and automatically starts Qemu to run your application This way it is possible to run and debug applications compiled for an embedded microcontroller directly on the host PC Note 3 3 1 When using Eclipse do not use the environment from shell otherwise the commands from shell may interfere with Eclipse settings 17 4 Usage from Eclipse This section explains how to use the GUI based on the Eclipse IDE 5 provided with the SDK 4 1 Requirements In order to run the development environment a Java 1 6 virtual machine is needed This means that the package sun java6 jre must be installed The installation script will try to install the virtual machine automatically from the repositories 4 2 Running the GUI To start the GUI type ev sdk eclipse without any param
5. AAA EVIDENCE f Chapter 4 Usage from Eclipse 4 5 3 Building the project Before building the project disable automatic build of the project as explained in Section 4 3 1 Then to build the project click with the right key of the mouse on the project name inside the left frame as shown in Figure 4 10 Select Clean Project followed by Build Project 29 AAA EVIDENCE Chapter 4 Usage from Eclipse 4 5 4 Running the application To run the application follow the next steps d Select your target as explained in Section 4 5 2 Build the project as explained in Section 4 5 3 Click the Run icon as shown in Figure 4 14 and select the Run configurations item The first time you run the application you have to create the configuration To do that click twice on the Scratchbox2 application item as shown in Figure 4 15 A new configuration for your application will appear as shown in Figure 4 16 Select the project you wish to run in the Project box Select the project you wish to run in the C C Application box Note 4 5 6 It would not be possible to select the project if it has not been already compiled Click the Run button To terminate the application click the icon shown in Figure 4 17 Note 4 5 7 The application can be run even if compiled for a target different than the host machine Evelin SDK will automatically detect the type of binary and will start Qemu to run the application No
6. Z Tasks Include Browser Other Shift Alt Q Q Figure 4 2 Setting visible hidden windows 4 3 3 Eclipse perspectives Eclipse has a set of views called perspectives Each perspective allows to make certain operations or see certain kind of information 19 RAA EVIDENCE i EMAESDINGATEGHNOLOSY Chapter 4 Usage from Eclipse To change perspective just click on the icons on the top right corner of the main window as shown in Figure 4 3 Y stdio h i stdlib h Figure 4 3 Changing perspective Note 4 3 1 The list of running processes shown in Figure 4 24 can be seen at any time by entering the Debug perspective 20 EMaEDDINe TECHNOLOGY Chapter 4 Usage from Eclipse 4 3 4 Scratchbox path To change the Scratchbox path click on Window gt Preferences as shown in Figure 4 4 Then click on Scratchbox2 Preferences as shown in Figure 4 5 Note 4 3 2 The default path should be fine in most situations J New Window Customize Perspective Save Perspective As Reset Perspective Close Perspective Close All Perspectives Navigation Figure 4 4 Scratchbox preferences AC Cancel Figure 4 5 Changing Scratchbox path 21 AAA EVIDENCE f Chapter 4 Usage from Eclipse 4 4 Building existing firmware Some versions of Evelin SDK e g the version for Xflar are provided with firmware for a specific board This firmware is called Evelin BSP
7. Layout TH Horizontal Layout 833 Grid Layout 25 Form Layout Spacers 3 bag Horizontal Spacer Vertical Spacer Buttons H es Push Button Too Button Radio Button Check Box Command Link Button FH Button Box Item Views Model Based gt List View S8 Tree View E Table View L Column View E Table Widget Containers y 5 Group Box C Scroll Area S Tool Box E Tab Widget Stacked Widget Frame Widget MdiArea EG Dock Widget Figure 4 35 How to design the GUI 47 RAA EVIDENCE l EMAEDDINO TECHNOLOGY Chapter 4 Usage from Eclipse myprogram ui 2 QObject objectName myprogramClass QWidget windowMod NonModal e enabled E l E K 0 0 400 x 300 S TES Widh 400 o ooo B Po Preferre i size Height 0 olic Prefe Preferre dth L ih maximum Siz Width 16777215 Height 16777215 myprogram ui 2 QObject objectName myprogramClass QWidget enablec E abled j gt O 0 400 x 300 gt o sizePolicy Preferred Preferre Width E rem o0 mU PAEA Width 16777215 16777215 E 7 0x0 p Inherited Figure 4 37 Setting the size of the QT main window 48 AAA EVIDENCE f Chapter 4 Usage from Eclipse 4 6 3 Building the project To build the project follow the instructions of Section 4 5 3 49 RAS
8. features 2 ck a ee La ek aa A a eR 37 Terminating a debugged application 37 Changing perspective to C C oaaae 38 Selecting a QT project sic casedda nadaa Ee ee Re aS 42 How to specify the project name lt lt 4 42 Dialog lor QT projeti o se doa sigota gor d sa AA 43 Diala lor OT projeti lt a dad eS A A i 43 How to add support for the specific target 44 Selecting the specific target 2 ee ee 45 RAA EVIDENCE List of Figures 4 34 4 35 4 36 4 37 4 38 4 39 4 40 4 41 Man GOT Imi ea mad we aeae a a oe ee ee ee 46 How to demon the GUI 0 0 toh saan eoki e a BA eS 47 Setting the properties of QT widgets 48 Setting the size of the QT main window 48 How to enable a serial connection 1 lt o ea e 50 How to enable a serial connection 2 ooo ea a a 51 Settings for the serial connection 1 51 Settings for the serial connection 2 o 52 About this document This document explains how to use the Evelin SDK development environment Function of the document The function of this document is to provide information about the usage of the environ ment to developers who are going to use it Document history Version Date Author Company Change Description 2 10 Alpha Sept 15th 2008 Claudio Sc
9. gt target conf configuration file Do not change the values unless you really know what you are doing 12 AAA EVIDENCE Chapter 2 Installation Note 2 2 11 Ifa copy of the environment is already installed the installation will auto matically remove it Please notice that the content of the rootfs i e ev sdk rootfs directories will be lost Note 2 2 12 Since most of the environment is provided as source code the installa tion requires some time up to 1 hour depending on your host hardware and network connection to compile the source code Note 2 2 13 If the installation is interrupted for some reason e g lack of Internet connection restart the installation with the same command specified above Note 2 2 14 The version of the SDK installed will be saved into the ev sdk ev sdk version file Note 2 2 15 Any error during the installation will be saved in the ev sdk log file Note 2 2 16 Most of the environment will be installed in the ev sdk directory 2 3 VMWare image Evelin SDK is available also as VMWare 10 image based on Ubuntu 9 On this image the environment is already installed and configured so there is no need of installing it The VMWare image is compressed as 7 zip archive and it is located in the vmware directory A free client to extract the archive can be downloaded from http www T Z1P OLE In order to use the vmware image follow the next steps 1 Downlo
10. web PA A2 Rame the GUL s sopor ao opos d AA Reed eee Lx TW 102 remia ew eee Be AA ADA AA 431 Disabling automate build gt scos eee ye Rd hee eS oe 432 Visiblefhidden windows 1 6 44 658508 6b eda 5 3 doao Eclipse perspectives c scera oe ee Ee ee Oe BS Oe RS Bie o path oo be dade Poe RE SERA EEE EES a4 Building existing HORA eo eones CR Re CR RO we ee 44 1 Lmport ot the project o o cc ee RR REE Ee a eae Building the HORA s o a awe oe ee ee we OE AG Sm aS 4 5 New shell projects 222 6 a ke we ee ee ER 4 5 1 Creating a new project 2 2 a ee 45 2 Target selection 1 o scoe AAA RAR eR ED 45 3 Building the project cea desar erre eR ee es 4 5 4 Running the application a os ss so sec 4 5 5 Debugging a local application 206 4 5 6 Debugging a remote application 06 46 New graphical projects 4 2 2 5 so cedado eed ee need nesai A61 Creating anew project y cuca OS oles A da 4 6 2 Designing the graphical interface aoao a AGS Buildme the ee kh ee Oe a ey 00 10 10 10 13 15 16 16 16 17 RAA EVIDENCE Contents 4 7 Serial connection oaoa a a a 0 a a a ee 50 5 Known issues 53 SL Installation o s oaaae na Aen de SPARES ad e p a 53 List of Figures 2 1 2 2 2 3 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 4 9 4 10 4 11 4 12 4 13 4 14 4 15 4 16 4 17 4 18 4 19 4 20 4 21 4 22 4 23 4 24 4 25 4 26 4 27 4 28 4 29 4 30 4 31 4 32 4 33
11. window shown in Figure 4 23 will appear At this point the window shown in Figure 4 24 will appear Refer to Eclipse documentation for information about how debug your application Figure 4 25 briefly shows some of the features about debugging offered by the interface To terminate the application click the icon shown in Figure 4 26 To return to the C C perspective click the icon on the top right corner of the window shown in Figure 4 27 Note 4 5 13 The application can be debugged even if compiled for a target different than the host machine Evelin SDK in fact remembers which target the application has been compiled for and automatically starts Qemu to debug your application This way it is possible to run and debug applications compiled for an embedded microcontroller directly on the host PC m O C C myproject src main c Eclipse Plat File Edit Refactor Navigate Search Run Project Window Help fae Ge ee ine tiv Gy civ Gr MESES MESA O AMADA POS ASES Project Explorer 2 O la main c No launch history f As 7 D fs ris Debug As ly generated by Evelin SDK 2 w DAS TAS lt infoGevidence eu com gt gt i 3 3 Binaries Organize Favorites gt W Includes include lt stdio h gt Y src include lt stdlib h gt b main c gt fay main o arm be int main b main arm be unsigned Long int i 0 j for i Makefile if i 10000 printf i lu n i retu
12. EVIDENCE Chapter 4 Usage from Eclipse 4 7 Serial connection The version of Eclipse installed with Evelin SDK already contains a plugin to connect through a serial connection to the target To enable this feature follow the next steps 1 Click on Window Show view other as shown in Figure 4 38 Then select Terminal Terminal as shown in Figure 4 39 A new tab called Terminal will be created in the panel below Click on the Settings icon of the Terminal tab as shown in Figure 4 40 A new dialog will be opened Select a Serial connection as shown in Figure 4 41 Window New Window New Editor Open Perspective Show View El Console Shift Alt Q C 3 Navigator c Outline Shift Alt Q O E Problems Shift Alt Q X Project Explorer ul Properties 4 Search Shift Alt Q S Customize Perspective Save Perspective As Reset Perspective Close Perspective Close All Perspectives Navigation Shift Alt Q Q Preferences Figure 4 38 How to enable a serial connection 1 50 EMaEDDINe TECHNOLOGY Chapter 4 Usage from Eclipse 2 Terminal Figure 4 39 How to enable a serial connection 2 Figure 4 40 Settings for the serial connection 1 51 EMAEDDINS TecHNoLoay Chapter 4 Usage from Eclipse Terminal Figure 4 41 Settings for the serial connection 2 52 5 Known issues This section contains the list of known
13. EVOLINS Embedded Linux development made easier User s manual Version 3 0 March 14 2011 a eee AAs EVIDENCE About Evidence S r l Evidence is a company operating in the field of software for embedded real time systems It started in 2002 as a spin off company of the Real Time Systems ReTiS Lab of the Scuola Superiore Sant Anna Pisa Italy Today Evidence is a dynamic company having collaborations in the field of electronics telecommunications automotives and industrial automation People at Evidence are experts in the domain of embedded and real time systems with a deep knowledge on the design and specification flow of embedded software especially for the embedded market Besides providing consultancy services Evidence also provides BSPs based on Linux for embedded devices evaluation boards featuring most innovative 8 16 and 32 bit microcontrollers for the embedded market development tools for making embedded software development easier and tools for the schedulability analysis of real time tasks running on your final product Contact Info Evidence Srl Via Carducci 56 Localit Ghezzano 56010 S Giuliano Terme PISA Italy Tel 39 050 99 11 224 Fax 39 050 99 10 812 For more information about Evidence products please send an e mail to the follow ing address infolevidence eu com Other information about the Evidence product line can be found at the Evidence web site at http www evid
14. How to add support for the specific target 44 RAA EVIDENCE l arap ne Chapter 4 Usage from Eclipse Scratchbox 2 project options Here you choose the Scratchox 2 installation and the target CPU Figure 4 33 Selecting the specific target 45 AAs EVIDENCE Chapter 4 Usage from Eclipse 4 6 2 Designing the graphical interface To design the graphical interface of your application follow the next steps 1 Click twice on the file with ui extension in the left panel as shown in Figure 4 34 An empty form will appear on the central panel Click on the Qt C Widget tab as shown in Figure 4 35 The list of widgets will appear on the left panel Drag and drop your favourite widgets from the left panel to the central form To set the size of the QT form click on the QT C tab in the right dialog as shown in Figure 4 36 Then set the geometry of the form as shown in Figure 4 37 These values should be set equal to the size of the display of your target a File Edit Navigate Search Run Project Window Help JCS Gc eu lige Bs civ Gv lA Br Hr Or r l Ly Project Exp E J Qt C Wi D BS 7 Y tS myproject b Includes b main cpp e myproject cpp h Myproject h _ myproject aso myproje t ui y v v Figure 4 34 Main QT form 46 MU EVIDENCE EMBEDDING TECHNOLOGY Chapter 4 Usage from Eclipse Layouts y 5 Vertical
15. Just click on Nezt 5 The dialog shown in Figure 4 31 will appear Just click on Finish 6 You then have to add the support for the specific target Click with the right key of the mouse on the project name inside the left frame as shown in Figure 4 32 Select Add Scratchbox 2 support 7 A dialog similar to the one shown in Figure 4 33 will appear Select your target and click Finish 41 Chapter 4 Usage from Eclipse EMBEDDING TECHNOLOGY RAA EVIDENCE Select a wizard Create a Qt Gui application project Figure 4 28 Selecting a QT project Qt Gui Project Create a new Qt Gui Application Project Location home cloud ev sdk bin eclipse workspace myproject Bre Figure 4 29 How to specify the project name 42 EMBEDDING TECHNOLOGY Chapter 4 Usage from Eclipse Qt Gui Project Setup the class and file names myproject cpp Figure 4 30 Dialog for QT project Qt Gui Project Select the Qt modules lt Back Next gt seme SLE Eee Figure 4 31 Dialog for QT project 43 RAA EVIDENCE l EMAEDDINO ne Chapter 4 Usage from Eclipse Nl gt Remove from Context Shift Ctri Alt Down Move Rename F2 Build Project Clean Project 2 Refresh Close Project Close Unrelated Projects Build Configurations Make targets Index Add ScratchBox 2 support Run As Debug As Team Compare With Restore from Local History Properties Figure 4 32
16. ad the vmplayer from http www vmware com products player 2 Install vmplayer 3 Download the 7 zip file archiver from http www 7 zip org 4 Install the 7 zip file archiver 5 Extract the vmware evelin sdk 7z archive using the 7 zip file archiver This will create a directory called evelin sdk 6 Run vmplayer A dialog similar to the one shown in Figure 2 2 will appear 7 Click on Open and locate the vmx image inside the evelin sdk directory 13 RAR EVIDENCE Chapter 2 Installation 8 The first time you run the image a dialog similar to the one shown in Figure 2 3 will appear Click on I copied it 9 At this point the boot of the Ubuntu image will start 10 Login using user as both login and password 11 Finally run Evelin SDK as explained in the following chapters VMware Player 8 vmware Browse for available virtual machines When you select lt virtual machine it opens in this VMware Player window Download a virtual appliance from VMware Virtual Appliz Marketplace You can then open it in VMware Player Download Recent Virtual Machines fhubuntu8lOdesktop Ehubuntu8b4desktop Featured Virtual Appliance Accellion File transfer virtual appliance An on demand file transfer solution that is secure econc Download and easy to use for end users and IT management ial vmware This virtual machine may have been moved or copied In order to configure certain ma
17. cratchbox2 integration Graphical debugging of both host and target binaries Plugin to support the graphical design of QT based GUIs e Support for the following targets ARM7 ARM little endian and big endian ARMI1 Renesas SH4 2 Installation 2 1 Requirements In order to install the development environment a PC with the following characteristics is required e Ubuntu 10 04 LTS 32 bit distribution installed Note 2 1 1 Evelin SDK Full includes an image that can be run on any operating system supporting VM Ware e 1 GB of free space on the hard disk plus 2 5 GB for each user who will use the environment e bash apt get dpkg and gzip utilities already installed Note 2 1 2 If bash is not installed just type apt get update apt get install bash with superuser permissions i e as root user or using the sudo command e proc and proc sys filesystems mounted e A Linux kernel with the binfmt_misc module required for the CPU transparency mechanism loaded as a loadable kernel module or built in the kernel image Note 2 1 3 For the supported Linux distributions this is already available on the default kernel Note 2 1 4 If it is not available you need to recompile the kernel in order to add this support 2 2 Installation of the SDK Most of Evelin SDK is installed inside the user s home directory Therefore the instal lation must be done for every user who wants to use
18. efault target as shown in Figure 4 11 Note 4 5 1 This allows to specify for which target the binary will be compiled for Host refers to the host architecture Note 4 5 2 If you wish you can choose to start from an existing template which shows how to write the Makefile strongly recommended Note 4 5 3 The default path is taken from the dialog shown in Figure 4 4 and should be fine in most situations Figure 4 11 Choosing Scratchbox path and default target 26 ewarbbine TecHNoLoay Chapter 4 Usage from Eclipse 4 5 2 Target selection To change the target for a given project click with the right button of the mouse on the project and select Properties as shown in Figure 4 12 Then click on Scratchbox2 Options as shown in Figure 4 13 Note 4 5 4 This allows to specify for which target the binary will be compiled for Note 4 5 5 Host refers to the host architecture Choose the target then click on Apply and then on OK 13 Export Build Project Clean Project Refresh Close Project Close Unrelated Projects Build Configurations Make targets Figure 4 12 Project properties 21 AAA EVIDENCE EMBEDDING TECHNOLOGY Chapter 4 Usage from Eclipse File automatically generated by Evelin SOK 2 Srl lt info evidence eu by Evidence som y include lt stdio h gt include lt stdlib h gt Figure 4 13 Changing target for a given project 28
19. ence eu com This document is Copyright 2005 2010 Evidence S r l Information and images contained within this document are copyright and the property of Evidence S r l All trademarks are hereby acknowledged to be the properties of their respective owners The information text and graphics contained in this document are provided for information purposes only by Evidence S r l Evidence S r l does not warrant the accuracy or completeness of the information text and other items contained in this document Matlab Simulink Mathworks are registered trademarks of Matworks Inc Microsoft Windows are registered trademarks of Microsoft Inc Java is a registered trademark of Sun Microsystems in the USA and other countries and are used under license All other trademarks used are properties of their respective owners This document has been written using IXT X Contents Introduction Ll Deere the SDE ek ye eee ORAM as ESAS ee de A 1 2 Techmical features ocn socru radiusa d Pew dee Ew Re Se Installation mL TURIN cse s e ds ma E AR BRS A 22 Inet ol the SDR cooper Oe Be pie Be DA BE Cw ee 29 VMWare imag gt o o es bebe ded Re REE RESALE DEERE EGS 2 4 Removing the environment 20002 ee eee Usage from shell 3 1 Entering the environment e he ae eR eee ees 3 2 Compiling and building a project o o oo R nmnga compiled binary lt s sac AA Usage from Eclipse AL Reuniermnents s 6 ee car we bee
20. eter on a X11 terminal Alternatively if an icon Evelin SDK Eclipse has been created at installation time on your desktop just click the icon Note 4 2 1 The installer creates a default workspace located in the sim lt username gt ev sdk workspace directory 4 3 Basic usage 4 3 1 Disabling automatic build We strongly suggest to disable the automatic building of the project by clicking on the Project menu and disabling i e uncheck the related item as shown in Figure 4 1 4 3 2 Visible hidden windows The list of visible hidden windows can be easily changed at any time by clicking on Window gt Show View as shown in Figure 4 2 18 RAA EVIDENCE l EMAEDDINO TECHNOLOGY Chapter 4 Usage from Eclipse Open Project Close Project 9 Build All Build Configurations Build Project Build Working Set Clean Build Automatically Make Target Properties Figure 4 1 Disabling automatic build Therefore if at some time you cannot see a window anymore just click on this menu to make the window visible New Editor Open Perspective a Show Vie Ey C C Projects Console Shift Alt Q C include lt stdi oe See include lt stdl Save Perspe AS Reset Perspective Make Targets i i Close Perspective S Naviga or E R L Shift Alt Q O unsigned 2 El Problems Shift Alt Q X for 543 Negation Project Explorer if LIL E Properties references pr 4 Search Shift Alt Q S return 0
21. issues Please check this list before sending any help request to the technical support services 5 1 Installation Note 5 1 1 Evelin SDK may stop working if QTCreator is installed after it In this case overwrite the installed copy by re installing Evelin SDK 53 Bibliography Eclipse C C Development Tooling CDT http www eclipse org cdt Scratchbox 2 http www freedesktop org wiki Software sboz2 Fabrice Bellard Qemu Open Source Processor Emulator http bellard org gemu Jasmin Blanchette and Mark Summerfield C GUI Programming with Qt 4 2nd edition Prentice Hall 2008 Eclipse an open development platform http www eclipse org GNU Compiler Collection http gcc gnu org Qemu Mailing List gemu armeb linux stat64 syscall fiz http lists gnu org archive html qemu devel 2006 09 msg00137 html Nokia Qt A Cross platform application and UI framework http qt nokia com Ubuntu http www ubuntu com VMWare http www umware com 54
22. ject on Eclipse 23 RAA EVIDENCE l arap TECHNOLOGY Chapter 4 Usage from Eclipse New Scratchbox2 project Create a new C project to manage the configuration and compilation of a Scratchbox2 amp events O O project Location home cloud ev sdk bin eclipse workspace evelin bsp Brows Figure 4 8 Creating the Evelin BSP project Scratchbox 2 project options Here you choose the Scratchox 2 installation and the target CPU Figure 4 9 Selecting the target 24 RAA EVIDENCE EMBEDDING TECHNOLOGY Chapter 4 Usage from Eclipse 4 4 2 Building the firmware To build the firmware click with the right key of the mouse on the project name inside the left frame as shown in Figure 4 10 Then select Build Project 2 Remove from Context Shift Ctri Alt Down Move Rename Build ject Clean Project 2 Refresh Close Project Close Unrelated Projects Buid Configurations Make targets Index Bun As Debug As Profile As Tam Compare With Restore from Local History Properties Figure 4 10 Building the project 25 RAA EVIDENCE f oarnp TECHNO oey Chapter 4 Usage from Eclipse 4 5 New shell projects 4 5 1 Creating a new project To create a new project follow the next steps 1 Click on File gt New gt Project as shown in Figure 4 6 2 Select C New Scratchbox2 project as shown in Figure 4 7 3 Specify the project name 4 Select the d
23. nagement and networking features VMware Workstation needs to know which Did you move this virtual machine or did you copy it If you don t know answer I copied it OI moved it o Figure 2 3 Starting VMWare 14 AAA EVIDENCE Chapter 2 Installation 2 4 Removing the environment If you ever want to remove the SDK from the host machine just type sudo ev sdk uninstall and type your password if asked Then wait the EVELIN SDK UNINSTALLED message 15 3 Usage from shell This section explains how to use the main commands of Evelin SDK The path of the commands is automatically appended to user s bashrc file during the installation 3 1 Entering the environment Type sb2 config 1 to know the list of available targets Type sb2 config d lt target gt to set the default target Type sb2 to enter the Scratchbox environment using the default target To exit the environment just type exit You can also specify a specific target using sb2 t lt target gt Type sb2 lt command gt to execute a command inside Scratchbox using the default target This command runs the given command inside Scratchbox without the need of entering the environment You can also specify a specific target using sb2 t lt target gt lt command gt 3 2 Compiling and building a project Once entered the environment as explained in the previous section you can run the typical commands i e
24. ordino Evidence Srl Initial version 2 10 Beta Oct 21st 2008 Claudio Scordino Evidence Srl Second draft 2 10 Beta2 Nov 20th 2008 Claudio Scordino Evidence Srl Third draft 2 10 Beta3 Jan 22nd 2009 Claudio Scordino Evidence Srl Fourth draft 2 10 0 Jan 29th 2009 Claudio Scordino Evidence Srl First version 2 11 0 Dec 23rd 2009 Claudio Scordino Evidence Srl QT and serial 2 11 1 Apr 20th 2010 Claudio Scordino Evidence Srl Remote debugging 3 0 Dec 20th 2010 Alessandro Biasci Evidence Srl Ubuntu 10 04 LTS support Acronyms BSP Board Support Package SDK Software Development Kit 1 Introduction This manual contains the instructions for the installation and the usage of Evelin SDK Evelin which stands for EVidence Embedded LINux is the suite of tools for embedded Linux systems created and maintained by Evidence S r l 1 1 Description of the SDK Evelin SDK is based on the Scratchbox2 2 environment Scratchbox2 is a very powerful environment that allows to develop target binaries in a way completely transparent to the developer In particular Scratchbox2 is a cross compilation toolkit developed by the Open Source community and designed to make embedded Linux application development easier It provides a full set of tools to inte grate and cross compile an entire Linux distribution Once the target has been chosen Scratchbox2 allows to configure and compile the binaries rega
25. ping su b Enter root s password and press Enter c Edit the etc sudoers file and add the following line lt username gt ALL ALL ALL d Type exit e Then start the installation as specified above Note 2 2 5 lt targets gt is the list of targets e g armle armeb arm7 arm11 sh4 etc to be installed Note 2 2 6 Type install sh help to have the list of available targets Note 2 2 7 If called without arguments the install sh script will install all available targets 5 Type accept if you accept the license otherwise Evelin SDK will not be installed 6 Accept Java license by Sun the environment needs Java to run Eclipse 7 Wait for the EVELIN SDK INSTALLED message Note 2 2 8 If you are using the Gnome desktop manager and if your Linux distribution is fully supported some icons will appear on your desktop Do not worry if the icons do not appear since the environment can be easily used also without them 8 Reboot the machine in order to make the system read the new settings Note 2 2 9 The installation tries to detect your Linux distribution automatically However if not detected or detected wrongly the installation program will ask you the right Linux distribution installed on your host machine In this case the user must specify a Linux distribution between those present in the distro directory Note 2 2 10 The installation configuration for a given target is written in the targets lt target
26. r 4 Usage from Eclipse Figure 4 27 Changing perspective to C C 38 AAA EVIDENCE Chapter 4 Usage from Eclipse 4 5 6 Debugging a remote application The same GUI shown in Section 4 5 5 can be used also to debug applications running on the target In practice the Eclipse frontend connects to a local gdb client which in turn connects to a gdbserver running on the target The communication is done through Ethernet and the target must have a gdbserver installed To debug the application follow the next steps 1 10 First of all edit the Makefile of the project and add the g option to gcc parame ters This option compiles the project adding all symbolic information needed for debugging Usually the option is appended to either the CFLAGS or the CPPFLAGS variables Save the Makefile Select your target as explained in Section 4 5 2 Build the project as explained in Section 4 5 3 Transfer the binary of the application to the target e g using FTP TFTP HTTP LRZ Connect to the target using a serial connection see Section 4 7 and run the application using the following command gdbserver lt Host IP gt 1234 application Note 4 5 14 1234 is the default port but you can use different values Click the Debug icon as shown in Figure 4 18 and select the Debug configurations item The first time you debug the application you have to create the configuration To do
27. rdless of the target ma chine and without worrying about cross compilation This way even the higher level software based on GNU Autotools is capable of compiling transparently Evelin SDK includes improvements to the original Scratchbox2 environment patches to fix existing bugs toolchains for new target architectures plugin for integration with the Eclipse 5 IDE etc Evidence also made some modifications to the original envi ronment in order to let it capable of supporting new architectures Last but not least Evidence provides technical support for its environment 1 2 Technical features Evelin SDK has the following technical features e Based on the Scratchbox2 2 project e Easy to use installer e Additional Scratchbox2 scripts AAs EVIDENCE Chapter 1 Introduction e Transparent cross compilation based on GNU gcc 6 e Target software emulation cpu transparency mechanism that allows to execute target binaries on the host platform through Qemu 3 Qemu is a generic and Open Source processor emulator which achieves a good emulation speed by using dynamic translation Qemu is automatically invoked by the environment when needed i e no intervention of the user is needed Note that Evelin SDK uses a proprietary version of Qemu with better support for big endian targets 7 e GUI based on the well known Eclipse IDE 5 with CDT 1 plugin for development of C and C programs Proprietary plugin for S
28. rn 0 y Figure 4 18 Debugging a project 34 RAA EVIDENCE f ewarooine ne Chapter 4 Usage from Eclipse Create manage and run configurations S Filter matched 4 of 4 items Create manage and run configurations myproject Configuration Search Paja Filter matched 5 of 5 items Figure 4 20 Creating the configuration for debugging a project 2 35 EMAEDDINS TECHNOLOO Y Chapter 4 Usage from Eclipse myproject Configuration localhost 1 Filter matched 5 of 5 items Figure 4 21 Changing the port used for debugging Figure 4 22 Changing perspective to Debug Figure 4 23 Debugging on unsupported target 36 RAA EVIDENCE l EMBEDDINO ne Chapter 4 Usage from Eclipse hread 0 Suspended 1 mai AC armeb main 22 01 09 14 33 3 home cloud ev sdk tests test fstatAvorkspace318316 metadata armeb_gdb_wre File automatically generated by Evelin SIK 2 by Evidence Srl lt info evidence ey com gt 2 stdlib h e nain int include lt stdio h gt include lt stdlib h gt int main unsigned Long int i for jti printf i lu n i return 0 File automatiza by Evidence P mari rt for Tra if 1 1 10000 1 printf i unr i Figure 4 25 Debug features chbox2 application 19 15 22 Suspended SRA stant Figure 4 26 Terminating a debugged application 37 arap TECHNOLOGY Chapte
29. te 4 5 8 The list of running processes shown in Figure 4 24 can be seen at any time by entering the Debug perspective 30 RAA EVIDENCE f EMAEDDINO ne Chapter 4 Usage from Eclipse GY 1 20 no launch history Run As onfiguration Organize Favorites Figure 4 14 Running a project Create manage and run configurations Filter matched 2 of 2 items Figure 4 15 Configuration for running a project 31 RAA EVIDENCE f arap ne Chapter 4 Usage from Eclipse myproject Configuration earch Proc si ela Filter matched 3 of 3 items Figure 4 16 Configuration for running a project 2 Figure 4 17 How to terminate a running application 32 AAA EVIDENCE Chapter 4 Usage from Eclipse 4 5 5 Debugging a local application Eclipse provides a GUI to debug your application using an internal gdb Internally the debug works as a client server remote debugging the Eclipse gdb client connects to the Qemu gdb server which runs the application The communication between client and server is made through a network port of the host machine To debug the application follow the next steps 1 First of all edit the Makefile of the project and add the g option to gcc parame ters This option compiles the project adding all symbolic information needed for debugging Usually the option is appended to either the CFLAGS or the CPPFLAGS variables Save the Makefile
30. that click twice on the Scratchbox2 application item as shown in Figure 4 19 A new configuration for your application will appear as shown in Figure 4 20 Select the project you wish to debug in the Project box Select the project you wish to debug in the C C Application box Note 4 5 15 It would not be possible to select the project if it has not been already compiled 39 AAA EVIDENCE f Chapter 4 Usage from Eclipse 11 In the Main tab uncheck Connect process input output to a terminal 12 In the Debugger tab select e Debugger gdbserver Debugger e Connection TCP e Host name or IP address host IP address e Port number 1234 or any other value 13 In the Common tab uncheck Allocate console 40 AAA EVIDENCE f Chapter 4 Usage from Eclipse 4 0 New graphical projects The version of Eclipse installed with Evelin SDK already contains a plugin to design graphical applications using the QT framework 4 8 This section explains how to create a graphical application using the Eclipse IDE 4 6 1 Creating a new project To create a new project follow the next steps 1 Click on File gt New Project as shown in Figure 4 6 2 Select Qt gt Qt Gui Project as shown in Figure 4 28 Then click on Nezt 3 Specify the project name as shown in Figure 4 29 For instance we have supposed to use the name myproject Then click on Nezt 4 The dialog shown in Figure 4 30 will appear
31. the environment 10 AAA EVIDENCE Chapter 2 Installation To start the installation of Evelin SDK follow the next steps 1 Check to have a working network connection on your host machine Note 2 2 1 If your host platform is behind a firewall or a proxyweb the installa tion may fail because the Ubuntu repositories may be unreachable Please check this condition with your network administrator Note 2 2 2 In case of very slow network connection the installation may fail because the apt get utilities may experience a timeout Note 2 2 3 On Ubuntu machines the universe repositories must be enabled in the etc apt sources list file If disabled the installation script will enable those repositories automatically depending on your Linux distribution 2 Enter the directory containing the Evelin SDK distribution typically the CD ROM 3 Read the license in the COPYRIGHT file 4 Start the installation by typing sudo bash install sh lt targets gt as shown in Figure 2 1 cloud andor cdrom 006 1 cdrom sudo bash install sh 4 Figure 2 1 How to install Evelin SDK Enter your password if required 11 AAs EVIDENCE Chapter 2 Installation Note 2 2 4 The sudo command requires the user to belong to some specific groups e g admin or sudo on the Linux machine If your user does not have permissions for using the sudo command just follow the next steps a Enter as root user by ty
Download Pdf Manuals
Related Search