Home

TimeStorm User`s Manual - LinuxLink

1. FTP SCP Settings The corresponding fields for both the FTP and SCP options shown in Figure 7 are as follows IP Address Enter either the IP address or the hostname of the target If you use a hostname your network must include access to a Domain Name Server DNS lookup facility User Name Enter the user name for FTP or SCP login on the target as appropriate Password Enter a non blank password for FTP or SCP login as appropriate Destination Directory Enter the path to which the files will be transferred on the target FTP settings sometimes restrict the location of files copied to a directory under the home directory of the user Therefore the actual destination directory depends on the configuration of your FTP software In some cases directories specified in this panel are appended to the user s home directory on the target Ensure the user name that you specified has read write permissions to the destination directory Link to Execution When this checkbox is selected all of the information listed in the fields corresponding to the FTP or SCP option is automatically entered into the fields in the Execute tab Those fields are not editable in the Execute tab when this checkbox is TimeStorm User s Manual selected This checkbox is selected by default When this checkbox is deselected you must manually enter the corresponding information in the fields in the Execute tab Name DM3730 SOM LV
2. In these projects the make file is under complete control of the user TimeStorm does not attempt to examine the project and generate a make file before the build Use this option when working with projects that already have an existing make file or when complete control of the make file is necessary Build configurations are part of the project properties To see the build configurations for a project right click on a project select Propertie and then select C C Build gt Settings The current build configuration will appear on the right side of the dialog Use the Manage Configurations button to add rename or delete build configurations Building with Host Compiler Since TimeStorm allows the user to create multiple build configurations for a project users will frequently create a build configuration that executes the host compiler the compiler that produces code to be executed on the host machine so that the program can be tested without the additional overhead involved with remote debugging Since most problems are algorithmic in nature this strategy reduces the amount of development time and is an oft used strategy used by embedded developers To access the build configuration panel e Right click on the project and select Properties e Inthe properties panel select C C Build gt Settings To use the toolchain on the host machine e Select the Cross Toolchain tab in the build configuration panel
3. Remove To eliminate a file from the items to download select it in the list and click the Remove button Download Now The Download Now button copies files immediately without running the application 30 TimeStorm User s Manual Restore Default The Restore Default button resets the panel to its initial state download only the application and its libraries NOTE Downloaded files overwrite any identically named files on the target without giving a warning TimeStorm will not create destination directories on the target so be sure to create them before launching the configuration Common Panel The Common panel shown in Figure 21 sets options for sharing this run configuration among multiple projects Main amp Source 49 Target c Download Files Ei Common Save as Local file O Shared file Display in favorites menu Console Encoding O Zs Debug Default inherited UTF 8 O Q Run Other Standard Input and Output Allocate Console necessary for input File Launch in background Figure 21 Common Panel The options with the Common Panel include Local File By default run configurations are saved with the workspace state files so they can only be used with projects in the current workspace This setting corresponds to the Local file radio button on this panel However you can make the configuration available for use in other workspaces b
4. User s Manual TimeStorm Version 4 3 Embedded Linux from a Trusted Source TimeStorm User s Manual Contents Oaa E a Ee n i necesse T HH 1 FS CNS TIE SEDET pE Oi vdd tvispise ines iaculo dbi de neu seme e Ribes i LUE 2 Host System Reqgulr moehnts rore arbre Sa EN ea FAT YES EPEASR ER YR PEE EXER UEEVE E EUE RETE CURVE RUE UTER EVEN TM NUER IY EE VEN DER SUE VR 2 UO aE WMS K e v 19 e all RR E T T 2 Reze Ln Teesi EE NES 2 Creating a Te term Be 3 Meane NC ie ids ENTE 4 ANE TINC O 02 RR 5 Tne Oran ECI E aer ETT 6 Seis R vaine eT 6 OT 6 BOS esterase nen teed reeset m m m 6 NIT Zc P 6 UNG NC T 6 VIEWS and CIN OS TT 7 PSS eUT 8 Source Code CONTOl SVSTCMS Siscscdiscwsasssncesacedsnventecneseanabsiovsnnenssnentwbsoxentocaupsatwasecuneduandonsebanconsetacbeasubaeveneens 8 Using Your Own Source Code Control System esse eee ee eee eee 8 Using Source Code Control PIUB II rennene 8 Using Source Code Control Command Line sss sese sese ee eee e eee 9 Embedded Development with TimeStorm sss sss sese sees eee eee eee 10 Development Host and Target BOGEG sisespeeecsut uv eot EE E N 10 MOIS with TO ONC VN osos tiae didt cmd cece eden didetim mitti decor iudidui mien ences ecw ars dq 10 TE VS TOONE 11 SSF ojo Te Tooo eana Om m om 11 Adding Your OWN FOO IC TT 12 Managing Build Configurations and Manag
5. Download X Execute El Raw Log FTP SCP None IP Address 192 168 2 68 User Name root Password micis inia Destination Directory Link To Execution NFS Figure 7 Download Tab NFS Settings The corresponding fields for the NFS option shown in Figure 7 are as follows RFS Base Directory Use the Browse button to select the location of the RFS on the host This location is where the target s root filesystem is mounted over NFS for example home user timesys boardname rfs where user is the current username and boardname is the name of the target board Destination Directory Use the Browse button to select the location in the RFS to where the files will be downloaded The directory must be within the RFS Base Directory location that was selected Ensure that you have read write permissions to the destination directory After you have entered the required information in this tab select the Execute tab and enter the appropriate information 17 TimeStorm User s Manual 18 TAB 2 Execute Use the Execute tab shown in Figure 8 to specify the communication method that TimeStorm uses between the host and the target Within this tab you can select from the following communication methods between the host and the target Telnet Communication between the host and the target will occur when using Telnet SSH Communication between the host and the target will occur when using secure shell SSH Seri
6. console view and various control characters and special characters may not be displayed well This console view will be good for viewing the boot loader output using a serial connection run basic commands like browse file system change file permissions etc and copy files to from the target 21 TimeStorm User s Manual Use the icons on the top right corner of the view to copy the console output to a file send a ctri c command to the target clear the console and disconnect from the target Run Debug Configurations TimeStorm IDE uses Run configurations to store download and execution information for your applications Although Run configurations are part of the basic Eclipse IDE TimeStorm Run configurations are customized to support executing and debugging a program and its libraries on a remote target The C C Development User Guide online help includes additional information about TimeStorm s debugging tools Creating a New Run Configuration To create a new run configuration select Run Run Configurations from the main menu Select the type of configuration that you want in the Configurations list and click New icon or double click the Configuration type to add a new configuration Then use the tabbed panels on the right to select and configure the run options Different options appear depending on the type of run configuration that you create TimeStorm projects typically use one of the following types of run c
7. which ensures that cross compilers and other required utilities are available on the 11 TimeStorm User s Manual appropriate path and have the correct permissions for access by the TimeStorm user In order to perform remote debugging in TimeStorm the toolchain must include GDB version 5 2 1 or later Adding Your Own Toolchain To add a new user defined toolchain 1 Click the Add button shown in Figure 2 to invoke the Add Toolchain wizard 2 Within the Add Toolchain wizard Figure 3 specify where the toolchain is installed Use the Browse button to specify the directory that contains the toolchain s binary files Add toolchain Specify toolchain bin directory Please select the directory where the toolchain executables are installed LinuxLinkFactory build armvSl timesys linux uclibcgnueabi toolchain binl Browse This toolchain applies to The current workspace only The currently logged in user only Finish Figure 3 Toolchain Management Toolchain Directory 3 Click the Next button Add toolchain 12 Specify tool names Review and edit detected tool names for this toolchain Name Path ADDR2LINE armv5l timesys linux gnueabi addr2line AR armv5l timesys linux gnueabi ar AS armv5l timesys linux gnueabi as C armv5I timesys linux gnueabi g C FilT armv5l timesys linux gnueabi c filt CC required armv5l timesys linux gnueabi gcc CPP armv
8. TimeStorm and reestablishes it when you Start again If you want the workbench to revert to the standard layout for the current perspective use the Window gt Reset Perspective menu Based on working preferences perspectives can be changed and or additional perspectives can be created by the TimeStorm user Source Code Control Systems TimeStorm relies on the Eclipse framework to provide integration with source code control SCC systems The open nature of Eclipse has resulted in integration of many source code controls systems TimeStorm bundles Egit that work with git TimeStorm users are free to select a SCC that best matches their needs Using Your Own Source Code Control System TimeStorm can be used with any source code control systems If the source code control system in use at your company isn t directly supported by TimeStorm you can still use it to manage your development tasks There are two strategies using a vendor supplied plug in or doing source code control from the command line Using Source Code Control Plug in Many vendors have plug ins that can be added to an existing TimeStorm installation Since TimeStorm is built on Eclipse a plug in that is compatible with the Eclipse used to make TimeStorm can be used without modification Follow the directions supplied by the vendor to add the plug in to TimeStorm TimeStorm User s Manual Using Source Code Control Command Line Some source code control systems do not
9. dropbear openssh Hardware Targets Window The Hardware Targets window enables you to e Add a target to the list of registered targets e Edit the information for a registered target e Delete a target from the list of registered targets e Check connectivity from the host to a target You can access the Hardware Targets window either by clicking the Hardware Targets toolbar button 2 or by selecting Run gt Hardware Targets from the main menu as shown in Figure 6 below 43 Hardware Targets Figure 6 Hardware Targets Menu 15 TimeStorm User s Manual Setting up a target requires information for the following three tabs 16 TAB 1 Download How to download files to the target shown in Figure 7 TAB 2 Execute How to communicate to execute on the target shown in Figure 8 and TAB 3 Raw Log How to test the connectivity between the host and the target shown in Figure 9 TAB 1 Download TimeStorm allows files to be downloaded to the target in a few different methods You will be prompted to select one of the options below FTP Files will be downloaded from the host to the target using FTP SCP Files will be downloaded from the host to the target using SCP NFS TimeStorm will copy the files locally in the target Root File System RFS mounted over NFS None The host will be connected to the target but no data will be downloaded You can then do any needed downloading using the console
10. have Eclipse based plug ins You can still use these but you ll need to do so from the command line When using a SCC command line tool follow these guidelines e DO NOT version control the metadata directory TimeStorm maintains a metadata directory under the workspace This directory contains temporary information related to the workspace and should not be checked into version control e Do not make any files starting with Read only TimeStorm creates files in project directories starting with to store any project related information These files can be checked into version control but must read write on the local file system Some source code control managers make all files read only unless otherwise instructed e When initially checking out a project put in the directory of an existing project To add the project to the workspace create a project with the wizard you can delete all of the files and use the SCC to do the initial check out of the project files into that directory After the check out return to TimeStorm and refresh the project by pressing F5 which will enable TimeStorm to recognize the newly checked out files TimeStorm User s Manual Embedded Development with TimeStorm Embedded development is different from traditional development because e The target machine is usually different hardware architecture than the host machine and e The target machine lacks the resources necessary to be used as a develop
11. incompatibilities arise when using TimeStorm with the default version of Java on the host machine TimeStorm installs a Java Runtime Environment that it alone uses In order to compile programs TimeStorm must have a toolchain By default TimeStorm uses the toolchain on the system LinuxLink Starting Points as well as builds using the LinuxLink Factory build system provide cross compilation toolchains The installation process for a LinuxLink Starting Point puts the toolchain and any other supporting files in the correct location no additional configuration are necessary Working with Toolchains is described later in this guide In order to communicate with the target TimeStorm must be able to communicate with the board using one of several methods TimeStorm can use telnet ftp or ssh scp to communicate with the board and it has been tested using busybox telnetd inetutils telnet ftp servers and the dropbear ssh scp servers As an alternative if the previous network services are not available TimeStorm can communicate with the board over a connection to the serial console and copy files into a local NFS share In order to use TimeStorm it must have a valid license The license management is described in the following chapter License Management After installing TimeStorm software you must install the software license file that enables the features that you have purchased TimeStorm 4 3 uses node locked licenses which are text files wi
12. inside the virtual machine 2 Loginto your LinuxLink account https linuxlink timesys com via a web browser and then o If you are a Team Manager click on the team name at the top of the page o Ifyou are a Developer click on the user name at the top of the page 3 Scroll to the bottom of the page and click the Edit Licenses button in the Active Licenses area 4 Next click the Create button located to the right of the user of the seat for which you want to create the license o Enter the MAC address and a descriptive name for the license It can be helpful to include the type of operating system and computer that will use the license o The license expiration date and the user s email address are entered automatically o Choose to create a license for TimeStorm 4 x NOTE Licenses generated for TimeStorm 3 x will not work with TimeStorm 4 3 so be sure to select the correct version when generating the license o Click Next to generate the license You are given the option of editing the CC field and the text of the message that will be used to send the license file TimeStorm User s Manual o Click Send An email with the attached license is sent and the contents of the license file are displayed o Save the license on the computer you will be using for TimeStorm LinuxLink will keep the license on file so it can be retrieved at any time Installing the License Installing a license involves copying y
13. licenses TimeStorm checks for this directory under the system wide configuration area etc This directory is not automatically created you will need to create it manually if you wish to store license under etc o Licenses copied to this location will work for all version compatible TimeStorm installations on this computer TimeStorm User s Manual Installing TimeStorm TimeStorm is available in 32 bit and 64 bit versions Depending on whether you are running a 32 bit or a 64 bit OS select and download the 32 bit or 64 bit version of TimeStorm To install TimeStorm 1 Opena terminal and change directory to the location where you want to install TimeStorm 2 Use the following command to uncompress the archive on your host and extract its contents the build number lt build_num gt will vary t tar zxt Timestorm tull insteall 4 3 0 lt bui1d num SZT 3 TimeStorm is installed within the directory timestorm 4 3 You can start TimeStorm with the following command timestorm 4 3 timestorm TimeStorm User s Manual TimeStorm and Eclipse TimeStorm is based on the Eclipse IDE first published by IBM and now maintained by the Eclipse Foundation TimeStorm is designed to conform to the Eclipse standards as closely as possible using as much of the existing user interface language as possible This section defines the basics of the Eclipse environment and explains how Timesys has extended Eclipse by adding featu
14. on the active build configuration as described below in the How TimeStorm Builds a Project section of the manual A project created by a TimeStorm wizard is designed to build without any errors or warnings 37 TimeStorm User s Manual How TimeStorm Builds a Project TimeStorm uses Build Configurations to control the project build process When creating a project using a wizard several build configurations will be created by TimeStorm and associated with the project One of these build configurations is the active configuration as illustrated by the star in the illustration below and that will be used by default when creating a build Any build configuration can be selected as the active configuration as this concept exists so the user does not need to select which build settings to use when creating a build Figure 26 below shows the relationship between the project build configurations toolchains and the make files generated by TimeStorm Build Configuration A x Build Configuration B Build Configuration C N Toolchain 1 N Toolchain 2 wv i TimeStorm Build Process WHEL Yati Figure 26 Relationship Between Project Build Configuration Toolchain and Makefile The following describes how TimeStorm uses the makefile and build config to build the project TimeStorm will use the default build configuration following these steps 1 Create a directory with the name of the build configuration The output
15. output will not include any debugging symbols Code compiled with this configuration is ready for production use GnuProfiler This setting builds the software with debugging information as well as code to collect profiling information via GNU gprof TimeStorm User s Manual Select a Toolchain Panel The next panel in the wizard shown in figure 24 asks the user to select a toolchain The entries in this list appear because the user has installed a Timesys Starting Point or have added the toolchain manually Please refer to the Working with Toolchains section to understand how TimeStorm manages toolchains The toolchain can be changed later within the project s property page ae C Project x Select toolchain Select a toolchain Cross Toolchain al u Native toolchain x86 64 linux gnu armv5l timesys linux gnueabi gcc 4 3 3 armv7l timesys linux uclibcgnueabi gcc 4 3 3 E lt Back Next gt Finish Cancel Figure 24 Select Cross Toolchain Once the Finish button is clicked the project will be created in the Workspace 35 TimeStorm User s Manual Creating Static and Shared Libraries Library projects are created by using the New C or C Project wizard shown in Figure 25 TimeStorm uses the existing CDT C and C Project wizards but adds the ability to select a cross toolchain By creating a project with cross toolchain TimeStorm will be able to build the project with one or more of the
16. the serial port Baud Rate Use the drop down list to select the appropriate baud rate for serial communication The default rate is 9600 bps Common Settings for All Options The common fields for all three options in the Execute tab are as follows User Name Enter your user name for a Telnet SSH or serial login as appropriate on the target Password Enter a non blank password for the Telnet SSH or serial login as appropriate on the target Note that the Timesys pre built SDK does not set the root password in the RFS You have to set the password for the root user after the target boots and enter the password in this text field Working Directory Enter the directory to which control will be transferred after TimeStorm logs in to the target By default this is the same path to which the data will be transferred on the target This directory must already exist NOTE If the Link to Execution checkbox is selected in the Download tab the information in the fields corresponding to the FTP or SCP option in the Download tab is automatically entered into the common fields and the IP Address field in the Execute tab In this case the fields are not editable as long as the Link to Execution checkbox is selected in the Download tab TAB 3 Raw Log After you register a target you can check the connectivity to that target at any time Each time you add a target or edit information for a target Timesys recommends that
17. timesys test ubuntu L EBENEN Figure 27 Changing the Toolchain for an Existing Project 39 TimeStorm User s Manual Remote versus Local Application Debugging Application debugging can occur on the host machine or the target board depending on how the application was built When debugging on the local machine the program needs to be built with the host s compiler For most projects it makes sense for debugging to happen on the host machine as debugging remotely is slower due to the communications link In addition most code problems are algorithmic in nature meaning that the code itself contains problems independent of where the code is running This means developers can be very productive by debugging the code on their host machine and then recompiling it for final testing on the target Some things like timing performance or access to specialized devices cannot be tested on the host machine and in this case remote debugging is the right tool to use from the start Debugging on the Development Host When debugging on the development host select Run Debug Configurations from the main menu and use the C C Application configuration from the debug run configuration dialog This run configuration shares many of the same panels as the C C Remote Run configuration and works in much the same way Just like with the C C Remote Run configuration the user needs to specify what project and application will be used for deb
18. toolchains placed on the system when installing a LinuxLink Open the New Project wizard by choosing File gt New gt Project from the main menu or by clicking the New button wa Optionally use the drop down menu to the right of the button to choose Project Choose a C or C Project Se C Project x C Project lt gt Create C project of selected type Project name test_program 4 Use default location Project type Toolchains Linux GCC lt Executable 6 Hello World ANSI C Project 6 Multithread C Program gt Shared Library gt Static Library gt amp Makefile project Show project types and toolchains only if they are supported on the platform lt Back Next gt Cancel Figure 25 New C C Project Wizard Creating Libraries Static versus Shared Libraries Static and shared libraries allow the user to place certain functionality outside of the main program frequently so the same library can be shared across projects Static libraries are incorporated by copying the bits into the main program at link time while shared libraries are linked into the program before it runs by a dynamic library loader Shared libraries can also be accessed when the program is running by loading the libraries into memory and calling functions without the linking step before the program runs 36 TimeStorm User s Manual Library Type Feature Static Shared Outpu
19. you perform a connectivity check to verify that the host can communicate with the target The target connectivity check does not occur automatically upon registering or applying changes to a target TimeStorm User s Manual To verify connectivity to a target select the target in the left panel of the Targets window and click the Check Link button The Raw Log tab shown in Figure 9 becomes active when the check starts If the host communicates successfully with the target a Target Check Passed message shown in figure 9 is displayed in the Raw Log tab of the Targets window Name DM3730 SOM LV Download XX Execute E Raw Log Checking SCP communication Connecting via SCP to 192 168 2 68 Connected to 192 168 2 68 Authenticating username and password SCP connection succesful Checking Execution Initializing Connecting via SSH Eo 192 168 2 68 Connected to 192 168 2 68 Authenticating username and password Obtaining pseudo terminal Testing cd Last login Thu Dec 29 11 36 06 2011 from ravixp timesys com root host68 cd root host68 Target Check Passed Figure 9 Output from Check Link Hardware Target Console When you remotely run or debug an application on your hardware target a console view is launched and the commands being run on the target and the target s console output are displayed in the view If you directly want to interact with the target like run so
20. 2 On the right side of the panel uncheck the Automatically find new updates and notify me box and click the OK button shown in Figure 36 52 TimeStorm User s Manual Building from the Command Line TimeStorm has been designed so that projects can be built from the command line as well as the IDE This feature exists so that customers with build systems can easily integrate projects created with TimeStorm into their automated build system As part of the build process TimeStorm scans the current project and builds a list of files in the project as well as the dependencies on other files in the project TimeStorm then uses that dependency list along with the information in the build configuration to create several GNU make files TimeStorm then builds the project by executing make with the generated files to perform the build steps Each build configuration creates a make file in a directory named after the build configuration under the project directory For example lt workspace gt my project Debug makefile workspace my project Profile makefile The make file overrides the following standard variables to control what tools are used in the standard make build rules RANLIB CPP AS AR OBJCOPE DEBUGGER SIRIP OBJDUMP NM CXX LD Each of these tools is changed to use the location the tool chain of the development host If the location is different on the build machine one of the following strategie
21. 5l timesys linux gnueabi cpp DEBUGGER armv5l timesys linux gnueabi gdb LD required armv5l timesys linux gnueabi ld NM armv5l timesys linux gnueabi nm OBJCOPY armv5l timesys linux gnueabi objcopy OBJDUMP armv5l timesys linux gnueabi objdump RANLIB armv5l timesys linux gnueabi ranlib STRIP armv5l timesys linux gnueabi strip lt Back Next gt Finish Cancel Figure 4 Toolchain Management Detected Tools TimeStorm User s Manual Figure 4 on the previous page shows the list of tools that have been detected in the specified directory Toolchains using gcc with a cross compiler prefix will be automatically detected 4 Modify Edit the toolchain s name and description optional Each tool chain has a Name Description ID and a location TimeStorm uses the toolchain identifier ID as an internal reference the name and description are used to identify the toolchain to users You can customize the name description and identifier for this toolchain Identifiers and names must be unique that is two different toolchains on one system cannot have the same identifier or the exact same name The next panel shown in Figure 5 allows you to modify the toolchain s name and description If your toolchain has acceptable default values modifying the name and description information is optional Add toolchain Specify additional toolchain information Please specify a name description and ID for this toolc
22. Figure 34 Updates Panel 51 TimeStorm User s Manual The next few dialogs will display the license and the exact parts of the software that TimeStorm will be updating 1 After accepting the license press the Finish button to begin installation of the update TimeStorm will download the update in the background The progress of the download is shown in the bottom right corner of the main winow shown in Figure 35 2 When the download finishes restart TimeStorm in order for the update process to be completed DoS Update 4 ne Figure 35 Updating TimeStorm Components Disabling Updates To stop TimeStorm from checking for updates 1 Open the Preferences panel and navigate to nstall Update gt Automatic Updates Preferences x type filtertext Automatic Updates gal F b General Automatically find new updates and notify me b C C b Help Update schedule s uu Look for updates each time platform is started Run Debug Look for updates on the following schedule Tasks Team TimeStorm Usage Data Collector Download options Search for updates and notify me when they are available Download new updates automatically and notify me when ready to install them Vv P Vv VV OS When updates are found Notify me once about updates O Remind me about updates every Restore Defaults Apply x Q OK Cancel Figure 36 Toggle Automatic Updates
23. For example top level dir application shared lib 1 static lib 1 static lib 2 shared lib 2 static lib 1 static lib 2 In this project the user would typically write a make file that built the projects in the following order shared lib 2 static lib 2 shared lib 2 static lib 1 shared lib 1 static lib 2 shared lib 1 static lib 1 application In TimeStorm since all of the projects are peers of each other enforcing the build order would occur through Project References which is part of the project properties To access the Project References 1 Openthe Project Properties dialog by right clicking and selecting Properties 2 Select the Project References entry on the left The dialog will look like the following shown in Figure 28 41 TimeStorm User s Manual i Properties for printenv type filter text Project References ov ECC Projects may refer to other projects in the workspace Builders Use this page to specify what other projects are P C C Build referenced by the project MITT EUH Project references for printenv O envstruct Refactoring History E l l Ct print2 Run Debug Settings gt Task Repository y OK Cancel Figure 28 Project References Panel By selecting entries in this dialog TimeStorm will build those projects before the current project if in fact they needed to be rebuilt Project references can be nested several levels deep so that
24. LUK J systern loaging l Ping p network interfaces ifdown interface lo not configured Tt H answers oe en 4 4 d Te Ape erem zc2u La OOM TH FE lt la iu IL T SEIZE du fusrPrsbinesshad I LU BusybBoxw v1l 740 2 28012 186 19 22 36 91 EDT Built in shell Cash Enter help for a list of built in commands Figure 33 QEMU graphical window Run Debug application in QEMU To run debug an application in QEMU you have to create a hardware target definition for QEMU By default QEMU is assigned an IP address of 192 168 7 2 Set the root password for QEMU and use them to define a hardware target as explained in Then you can use this QEMU to run debug your application Stopping QEMU To stop QEMU type reboot in the QEMU window You may have to enter the sudo password again in the QEMU console You can close the QEMU console window after QEMU has terminated 48 TimeStorm User s Manual Remote System Explorer Remote System Explorer or RSE in short is the new addition from Eclipse for remote target interaction RSE allows you to define targets explore target file system and run and debug applications on target Timesys recommends using the Hardware Target functionality provided by Timesys as explained in the Working with Hardware Targets section because e RSE using SSH does not work with dropbear e RSE does not support serial connection e RSE does not support NFS To use RSE wit
25. al Communication between the host and the target will occur using the serial connection You must fill in all of the corresponding fields for the method that you choose TimeStorm answers the login and password prompts presented by the Telnet or SSH server on the target based on the data that you enter in this tab Name DM3730 SOM LV T Download X Execu te Raw Log Telnet SSH IP Address 192 168 2 68 Serial Details common to Telnet Serial and SSH User Name root Password SUN Working Directory Figure 8 Execute Tab Telnet SSH Settings The corresponding field for both the Telnet and SSH options are as follows IP Address Enter either the IP address or the hostname of the target If you use a hostname your network must include access to a DNS lookup facility TimeStorm User s Manual 19 The execution IP Address field is also used when connecting to gdbserver for TCP based remote debugging This field must be provided regardless of connection method to use TCP based debugging Serial Settings The corresponding fields for the Serial option are as follows Skip login If you are connecting directly to the target s bootloader and thus will not get a login prompt select this option The rest of the common details will be grayed out Serial Port Enter the host s serial port for example dev ttySO If you use this option be sure that the user that you specified has the proper permissions to access
26. ave Launch Figure 31 QEMU Launcher Dialog Launch QEMU QEMU launcher will detect the QEMU enabled SDKs and populate them in the Supported SDKs drop down box To launch QEMU select an SDK The kernel and RFS for QEMU are pre filled from the selected SDK If you want to launch QEMU with a different kernel or RFS you may edit the kernel and RFS path If you want to pass additional options to QEMU you may enter it in the QEMU Advanced Options text area Click the launch button to launch QEMU QEMU will be launched in a terminal window and you will be required to enter your sudo password as shown in Figure 32 46 TimeStorm User s Manual rootfs ext2 Continuing with the following parameters KERNEL home timesys timesysgemu_verzatile zIlmage 4 4 te armv5l ROOTFS home timesus timesus qemu versatile rfs rootfs extz FSTYPE ext2 Setting up tap interface under sudo sudo password for timesyst Acquiring lockfile for tapu WARNING distecd not present no distcc support loaded Running qemu sustem arm home timesus timezus qemu vergsatile toolchain bin qemu sustem arm kernel home time sus timesus qemu verzatile zImage 3 4 ts armvbl net nic vlanz net tap vlan z ifnam e tap script na dawnscript zno H versatilepb hda heme timesus timesuz qemu verzati e rfz raotfz extz nocreboot show cursor usb usbdevice wacom tablet na reboot m 128 append raat dev sda rw console ttunMno
27. click on the project and then click Properties 2 Inthe Properties window expand C C build and click Settings The project s build settings is displayed in the right hand side 3 Click the Cross toolchain tab and select the toolchain you want to use with the project NOTE The toolchain you are changing is for the build configuration displayed at the top of the page 4 Make sure to Clean and Build the project after you change the toolchain Applications Places Mon Apr 23 10 38 AM o ti m timesys File Edit So riv Settings lt E fe X gt Resource l l x 3 DM ET o Builders Configuration Debug Active Manage Configurations Y C C Build rE a S Build Variables amp T i 2 ly wow e gt i l Cross Toolchain S Bui j j i nativec Discovery Options i Tool Settings Build Steps Build Artifact Binary Parsers Error Parsers dioh Environment Cross Toolchain SDK beagleboard GCC 4 4 5 armv7l timesys linux uclibcgnueabi Y dlib h Loggin z iain void int 99 g Native toolchain x86_64 linux gnu Settings SDK at91sam9261_ek GCC 4 5 3 armv5l timesys linux gnueabi 20120412 10 45 gt C C General Project References SDK beagleboard GCC 4 4 5 armv7l timesys linux uclibcgnueabi Run Debug Settings gt Task Repository WikiText R E rij B 01 0 s a Build Finished m iS cproj B timesys test ubuntu 2 C C cproj src cpr gl
28. cutable is set automatically when you choose a toolchain from the list By default the toolchain will be the same as the toolchain of the project To use a debugger in TimeStorm you must associate the debugger with a toolchain You can associate any debugger with a toolchain that you define Stop at main on startup Select this checkbox if you want execution to pause when your application starts This option is selected by default Automatically track the values of variables Select this checkbox if you want to have the values of variables displayed in the Variables view while your project is being debugged This option is selected by default Debugger Options This section of the panel includes two tabs 1 Main and 2 Shared Libraries The Main tab is shown in Figure 16 above TimeStorm User s Manual 26 Main This tab includes the following fields GDB Debugger This field automatically displays the default debugger for the toolchain that you have installed and is read only GDB command file This field allows you to specify a gdb command file using the Browse button The debugger will execute the commands specified in this file Connection Type This field allows you to choose whether to use TCP or Serial to establish a debugger connection between host and target Note that this connection is in addition to the execution type that you specified in your hardware target In order to use seria
29. d in the system when installing a Timesys starting point Create New Project To create a new application project Open the New Project wizard by choosing File gt New gt Project from the main menu OR Click the New button a and use the drop down menu to the right of the button to choose Project 33 1 Choose aC or C Project The new C C Wizard shown in Figure 22 can be used to create several different types of projects including Executable and Shared and Static Library This section will focus on creating an Executable project Shared and static library projects are covered in the Creating Shared and Static Libraries section of this manual Project Panel 1 2 J Under the Project Type heading expand the Executable type and select the source code template you would like to use Under the Toolchains heading select the TimeStorm Cross Compile Toolchain Click Next to bring up the Select Configurations panel shown in Figure 23 tis C Project x C Project lt gt Create C project of selected type Project name test program 4 Use default location Project type Toolchains Linux GCC gt T Yye Srnrrr TE EL one ile ivl ea t rv Executable Hello World ANSI C Project 6 Multithread C Program P amp Shared Library gt Static Library Makefile project Show project types and toolchains only if th
30. de 51 CAGE ee 51 ESAS Update ETT 52 Building trom the Command LIN 6 uo eec vt eek ib rta ere ravet a ee Aone lee seh ea as 53 PIXMA Fl OS RR TRETEN 54 Using Source Code Control from the Command line sss sss sss sss eee eee 54 ADOBE TIIISSS us tetibxc satelles uae eaiaouaataate E CIL Ln DUUM COT D sure a GR MODI UM I DID CELA Pega 55 TimeStorm User s Manual TimeStorm Overview TimeStorm is an Eclipse based integrated development environment IDE for embedded application development TimeStorm 4 3 is based on Eclipse Juno SR1 packages Eclipse 4 2 1 and C C Development Tools 8 1 1 TimeStorm supports e C C application development e Qt application development e Toolchain Management e Remote Target Management e Remote Target Console e Remote Run Debug of applications e QEMU e Remote System Explorer e Gprof e GCov e Callgraph e LTTng e OProfile e Valgrind For use on host only currently there is no remote target support for these features These features are meant for code running on your host TimeStorm User s Manual Installing TimeStorm Host System Requirements lO TTEBBIAMAGHBASCEIINE Fedora 17 e Ubuntu 12 04 e Other recent 32 bit or 64 bit Linux distributions Disk Space 250 MB What TimeStorm Installs During the initial installation the TimeStorm IDE installs everything it needs to run TimeStorm is written in Java and native code so in order to ensure that no
31. e target used when you run the application Ps Environment Debugger amp Source 4 T Hardware Target dev_board v Manage targets Figure 79 Targets Panel In the Target panel use the drop down menu to select a hardware target that you have registered with TimeStorm If you have not yet registered a hardware target click Manage targets to open the Hardware Targets management utility If you have problems maintaining a connection to the target when using this run configuration consider increasing the value in the timeout setting Settings made in the Launch Timeout panel only affect run configurations they do not affect timeout settings for the Console view or for any other use of Telnet or FTP Telnet and FTP timeout values for run configurations can be set from the TimeStorm Preferences panel From the main TimeStorm menu select Window Preferences and open the TimeStorm Launch Timeout item Download Files Panel In the Download Files panel shown in Figure 20 you can select the files that TimeStorm transfers to your target You can use this panel to download additional files to your target along with your application 29 TimeStorm User s Manual zx P Environment Debugger amp Source Target e d Files i Common Will download using scp File Destination Dir Add File Target Program and Libraries 2 files Works
32. e ucl utes Eb b dendi rires 33 Create NEW PrO eC eva ine oM e EPUM cone gone tens dra Dro CH RUNS dee sence UE VENE run Dv NO Ne den pa bI e Edu aola Ne Mu du TTE do 33 Nas E TT ETT Select Bulla Configuration Panel TTT Selecta Kee a 9 T PTT Creating Static dine Shared Seel 36 Static versus Shared EIDESFIGS d a pera RR EE Seren So EDEP MER Ete ONCE DA asd au eA Sue REF EE Vexm ER DERE e pd eusa vo rU Ema s 36 Echtinig MOBUAN sce ees aeri ten tod se pear adesso erat nb orc Pec e cec Re eer reer Seana eae are 37 How TimesStorm Bullds a PFOJeCt 555 iere verdes Ce eked A Reread wera ae IVA wd bees 38 Changing the Toolchain for an Existing Project sees eee ee eee eee eee 39 TimeStorm User s Manual Remote versus Local Application DEDUSBING cccccccssseccccseccccessccecaeseceeeeseceeseueceseesecesseneceesaneeeetes 40 Deb gsine on the DevelopmebntLEloSt asserit me EIU e Imc NARE NANNE 40 Development Host Debugging Strategies eee ee eee eee eee eee 40 Building Related Projects in a Workspace sse eee eee 41 OtDevelopment with NIMES LOM aas aieo dtcocu uoces ate vete a sot olahedeensatacdutetacamanst ates eren afe 43 eiz IS Launcher cH 46 REMIO CE SustemiEXDIORBR ot tesi cstetun Eun Seisteiboutasmsiesstesh eaa Boot aer LS A co rete SUD qutt onte cct Ru 49 OME EODIS aedi N SS E N A tM ULeRM UND M dm mA RN OMM Ac Ut id 50 Advanced TODICS soyo TS 51 Automa gre Beta VoU TT TET T MU LAU oct Bul e
33. ect 1 Mrite cache enab oe A Vi Hd e c se E m ka 8 70 5 B MR T BD eae A AHSI Pth 16 iub d 106 9 ing lb Rd Hib E I R d Z SL 03 d VE ZI 9 a 91 E i EI T a CE i tp TEITE LEE Tafit RR BE B mmm TR B E eer eer s comm com gt l nico f luxnic net gt L mowai Nx N E ical blocks 555 MB 538 MiB n 3 ka DZ ee ee B 9 mulco Lum CL Gn ERR TD z i LI ve ae MG mpm M dm EIE OE S sos on oe ER i auium S NINE LILILICLEUA C wa a me dra d a DRED c moo E c read cache enabled doesn t support S ITE partition table l m l gt mouse device common for all mice isda Attached SCSI disk rtc core registered pl 31 as registered LATI Familiy t iet l enen t or 1 rchitecture ting system clock to H6127 1 a heubnert as devices fpaa 86 a lela im P H U Lig I I Comp d LA devii ZL d U d i eT loc f MasSkK Z 90 2705 host 1927 168 ra domain E nis domain nanet bootserverc255 Kl L Te 255 rootserver 255 255 255 2 mExPS Generic rer Mouse as fdevicesfpga t Mount ed oct Cextz filesystem on device 8 84 H S ee T ED d LUTTE ee A l i S started BusyBox v1 26 2 26012 16 19 EET EIER ng hotplug handler C 1 l ng device tiles Huto mount oft LYmediasdal successtul Ed rl b ls au ero ris oT ae ML E MIL timezone and system clock
34. ed Makeffiles sss sees 13 Types ol make nle Manageme T 14 TimeStorm User s Manual BUGIS with HOSE GOMDIICN xs ccucscdesvms ces deese dasdeunce idet e em rede aero eb evte tas ovt ve erben deas Sas oe eds 14 Working wItBdHsrdwale Targets asc etaibed tmb sana ie abrite tense ded erie e ea 15 Egi cca each M undds 15 Haraware Targets WIDOOW dero sso a a Meca duse oM rre nU veu nU nea o EE Leu UP CL ER contac 15 TABI IDOW eoe H n Pim ls TAB 3 RAW LOG Eo E prm un EE E I Hardware Taree Console d eee re aee epu brach rune to pu A bap else pc n fee eei ce 20 Run BI SETT TET Tel ade ucuicedm sc pue mut eite ndum utes se IE E 22 Creating a New Ru mconfigut atiOD su vec arida ttes En ti dered nekkid capes 22 DV ANP allele cose eii ete his qa sites i aan Leb dea ee cea derek E veanctdise hunch v pilot E deseo Areuments Pallel s asc tuemre e M EMEN a OK EC I iR ED ED PE DEAE Environment Palblsdsadesubet eni ds euo Mon E OR Ooo dO E EPA ERA N esta MS Coins Deb gserPalielestoueietuaetue tiae LI ILI eti UELLE SOUrce I Ut orca cote ah secs site inet E Rt oranes uuu do emu a ut a aut DE Targa Panel eas Seca restaraunts DR E LM EIL Download Files PANE NC LOU E DLE Common Panel ecri EU PRU acu dei E tua Pea mcm Metus UR aM coon Ua RERUM Sv I UAE Creating dnApDIICcatiOn Project co doses iA urere Dae oaeukt a tua uv eae Mm
35. ey are supported on the platform 9 Back Next Cancel Figure 22 New C C Project Wizard TimeStorm User s Manual Select Build Configuration Panel In this panel TimeStorm will suggest creating three build configurations that contain the compilation settings for the project Build configurations work together with the toolchain and project to create the makefile that TimeStorm uses for the build For more information on Build Configurations please see the How TimeStorm Builds a Project section Project Select Configurations Select platforms and configurations you wish to deploy on Project type Executable Toolchains TimeStorm Cross Compile Toolchain Configurations Debug W s GnuProfiler T Release Deselect all Select all Adva nced settings Use Advanced settings button to edit project s properties Additional configurations can be added after project creation Use Manage configurations buttons either on toolbar or on property pages Figure 23 Select Build Configuration panel By default TimeStorm creates three Build Configurations for new projects 34 Debug This setting performs no code optimization and attaches complete debugging information These settings are designed make debugging as easy as possible Release This setting has the highest compiler code optimization settings The
36. for the build is stored under a directory that matches the name of the build configuration used for the build If this directory does not exist it will be created TimeStorm must have the ability to create directories in the workspace or this operation will result in an error 2 Scan the project create a makefile that invokes the appropriate build program for the source file Before the build process occurs TimeStorm will scan the project for files it knows how to build based on extension ignoring files that it does not know how to handle For those files that it knows how to process TimeStorm will then examine the files calculate dependencies and emit a standard GNU makefile 38 TimeStorm User s Manual 3 Execute the makefile display results in the Console Window After creating the makefile TimeStorm uses GNU to perform the build The results of the build process are displayed in the Console window 4 Scan the results create markers for errors and warnings After the build the results are scanned and TimeStorm translates errors and warnings for files into markers that appear next to the offending line and in the problems view Changing the Toolchain for an Existing Project If you want to switch to a different cross toolchain or if you want to check if your code compiles with a native toolchain you can change the toolchain used by a project after creating it To change the toolchain shown in Figure 27 1 Right
37. get Management TimeStorm includes a tool for communicating with a target enabling target information to be stored in one location and shared by those features needing to reach a remote machine e Remote Run Debug Configurations In order to run and debug the code created for the target TimeStorm includes Run and Debug configurations that use the targets defined by the user to download code and properly configure the run time environment of the target Working with Toolchains Toolchains include the tools required to compile your applications Toolchains that you use with TimeStorm for remote development allow you to compile on one platform your applications for use on another platform They include appropriate cross compilers debugging software and other utilities that 10 TimeStorm User s Manual work with your target processor Build configurations for TimeStorm projects specify which toolchain to use when building your project You can set different toolchains in different build configurations Timesys Toolchains TimeStorm is designed to automatically detect Linux toolchains from Timesys Starting Points that have been installed using the install shell script as the root user To display the list of toolchains recognized by TimeStorm 1 Fromthe main menu select Window gt Preferences 2 From within the Preferences panel select TimeStorm gt Toolchains as shown in Figure 2 3 To View the toolchain properties selec
38. gt 5 Load shared library symbols automatically O Stop on shared library events 4 Search linker paths from project build settings Figure 57 Shared Libraries The Shared Libraries tab includes the following options Directories This field specifies any additional directories for the debugger to search to find shared libraries with debugging symbols By default the debugger will automatically search the paths specified in the project s build settings see option below Use the Add button if you want to add other paths Use the Up and Down buttons to move through the list of directories Use the Remove button to delete a path Load shared library symbols automatically Select this checkbox if you want these library symbols to be displayed as loaded in the Shared Libraries view and if you want the debugger to hit any breakpoints in the shared library project This option is selected by default Stop on shared library events Select this checkbox if you want the debugger to stop at shared library events even before it hits breakpoints in the source code This option is not selected by default TimeStorm User s Manual 28 7 gt Default Search linker paths from project build settings This option is selected by default and will enable the debugger to automatically search all of the linker library path specified in the project s build settings These will be searched in addition to any paths
39. h boards running Timesys SDK e Include openssh package in your target RFS RSE requires a sftp server on the target and the dropbear ssh server does not include an sftp server e When defining a connection in RSE choose SSH only system type After you define a target connection in RSE you will be able to browse the target file system copy files between local host and target and open a terminal console to the target For additional information on RSE refer to the Help included in TimeStorm by selecting Help gt Help Contents 49 TimeStorm User s Manual Other tools TimeStorm bundles other useful tools from the Eclipse community http www eclipse org linuxtools For detailed help on how to use the tools please refer to the Help included in TimeStorm by selecting Help gt Help Contents Below is a summary of the tools 50 Gprof Profile an application using gprof and visualize the gmon out files generated by gprof instrumentation To learn how to use gprof with TimeStorm read Gcov Test code coverage in program using gcov and visualize the gcda and gcno files generated by gcov intrumentation To learn how to use gcov with TimeStorm read LTTng Linux Trace Toolkit is a high performance tracing tool for Linux that efficiently handles large amounts of trace data Initially focused on the Linux kernel its technology has been extended to support user space tracing UST From TimeStorm you can c
40. hain Name armv5I timesys linux gnueabi Description Toolchain for armv5l timesys linux gnueabi development ID User armvSl timesys linux gnueabi lt Back Finish Cancel Figure 5 Toolchain Management Name and ID Managing Build Configurations and Managed Makefiles TimeStorm uses build configurations to control how TimeStorm C and C projects are compiled and built A build configuration is a collection of build settings associated with a project that contains the following information e Compiler What compiler to use to build the software TimeStorm projects have the added benefit of enabling the user to create Build Configurations that use a cross compiler e Compiler Settings Settings such as the optimization level ANSI compliance and warnings e Linker Settings Settings that specify what libraries to use and where they can be found By switching from one build configuration to another you can quickly and easily change the build settings for your project 13 TimeStorm User s Manual Types of makefile Management TimeStorm has two different ways of managing the make files in a project as outlined below 1 C C Executable Shared Library and Static Library Projects The make file for these projects are generated using the settings from the project build configurations These projects may use a TimeStorm Cross Compile Toolchain 2 Makefile projects
41. he New Environment Variable dialog will appears as shown in Figure 15 below Click the Variables button to select the variables that you want to use Then click OK twice Hew Environment Variable value Variables OK Cancel Figure 15 Adding a New Environment Variable Select Click the Select button to import environment variables from the host file system Edit To change an entry select it from the list and click the Edit button Remove To delete an entry select it from the list and click the Remove button TimeStorm User s Manual 25 Main pd Arguments P Environment X3 Debu Debugger Panel In the Debugger panel shown in Figure 16 you can configure how to debug your project ger S Source 48 Target 2 Toolchain armv5i timesys linux gnueabi gcc 4 3 3 4 Stop at main on startup Automatically track the values of vanables Debugger Options Main Shared Libraries GDB debugger home timesys timesys at91sam9260 ek toolchain bin a n GDB command file Browse Warning Some commands in this file may interfere with the startup operation of the debugger for example run Connection Type TCP 7 GDB Server Port 10002 Figure 46 Debugger Panel This panel contains the following options Toolchain Choose the toolchain to use from the drop down list of defined toolchains The path to the debugger exe
42. if a referenced project has other references those references also will be rebuilt if necessary This ensures that the top level project has all of its dependencies built before starting its build In this way the developer has the same degree of control as one would have when using a traditional nested make file 42 TimeStorm User s Manual Qt Development with TimeStorm Qt is a cross platform application and UI framework with APIs for C programming TimeStorm is bundled with the Qt Eclipse integration plugins These plugins will help in developing Qt applications using a Timesys SDK and remotely running and debugging the Qt applications on target Timesys SDKs that include Qt are configured to work easily with TimeStorm These are a few main steps that get you started developing Qt applications using TimeStorm 43 Switch to Qt perspective Click Window gt Open Perspective gt Other gt Qt C Configure TimeStorm for Qt To create Qt projects and develop Qt applications you have to configure TimeStorm for Qt by adding the Qt version you want to use You can add multiple Qt versions to TimeStorm native Qt Qt specific to your board To add a Qt version click Window gt Preferences gt Qt gt Add A dialog as shown below in Figure 29 is opened x U File Edit Navigate Search Project Run Window Help iv A El ei 6 C v Gyr tv Ov Qy e B wy ES fj Ei a Qt e S 7 Bil Q Q BI K General j E Qt Version
43. l you must have another serial port in addition to the one being used as the target console GDB Server Port This field lets you specify the port number used for debugging when TCP connection type is selected This field is visible only when TCP connection type is selected Target device This indicates the name of the serial device on the target to use for the debugger connection Host and target device must be connected with an appropriate serial cable This field is only visible when Serial connection type is selected Host device This indicates the name of the serial device on the host where TimeStorm is running to use for the debugger connection Host and target device must be connected with an appropriate serial cable This field is only visible when Serial connection type is selected Serial baud This indicates the baud rate to use on the serial line for debugger communication The default rate of 115200 should be used unless you are having serial communication issues This field is only visible when Serial connection type is selected Shared Libraries This tab is shown in the following Figure 17 TimeStorm User s Manual 27 B Main Arguments P Environment Debugger Toolchain armv5l timesys linux gnueabi gcc 4 3 3 4 Stop at main on startup Automatically track the values of variables Debugger Options Main Shared Libraries 00000000 Directories I
44. l1152060 console ttu ip 192 158 7 2 13 2 158 1 255 255 255 0 mem 128M highres off osst Could not initialize DAC ozs Failed to open dev dsp osst Reasont Mo such file or directory osst Could not initialize DAC ozs Failed to open devdep ost Reasont Mo such file or directory audio Failed to create voice lm4548 nut Figure 32 QEMU terminal window After entering the sudo password QEMU will run in a separate graphical window as shown in Figure 33 If you wish not to run QEMU in a separate graphical window but continue to run in the terminal window as in Figure 32 enter nographic in the advance parameters text field in the launcher dialog 47 TimeStorm User s Manual b 308 LEM 1 1 y E Forts iU S EI MIL 6na HHHH BH Hd 6168 gt B12 35 Pci 68800 00 60d 8 irq 27 LANE EE LUD Parity checking reset eed 5 OO EREEREER IVI F FA3FP359 li mem EAI Be Sie eee a eee ee le OG OA ater upt is ignor ISTAT 68x5 DSTAT 8x886 SIST axy Direct Access fhu DEU HARDDISK i PQ iB tagged command m 9 enabled command queue de Beginning Domain Va dation Ir Domain Validation s Pp L ng write tests 6 Ending Domain Valid E M Cb ROM DEU MT ch Ron 1 2 P B RHSI tagged command queu C a command queue depth 16 Beginning Domain VY Domain Validation w EUZ Ans Domain Vali device drive Max Krasnyansky 22 1964 M nico rey L 2 Oo ak J 2 54 00 12 34 TTE 520 512 buyte Me L e Prot
45. me commands on the target copy files to from the target etc you can launch a target console by clicking the Zl icon in the toolbar or by clikcing Run gt Hardware Target Console This will open the Choose a Target dialog as shown in Figure 10 Select the target you want to open the console and click OK 20 TimeStorm User s Manual Choose a target Target Manage targets Serial at 115200 baud Figure 10 Choose target for target console TimeStorm connects to the target using the Execution Settings Telnet ssh or serial configured for the target and opens a console view as shown in Figure 11 Bi Problems 4 Tasks G Console 3 Properties de x Ex BB of Civ D Serial at 115200 baud Starting system Logging Configuring network interfaces ifdown interface lo not configured iifdown interface eth8 not configured ip RTNETLINK answers File exists iip RTNETLINK answers File exists iip RTNETLINK answers File exists failed Starting dropbear sshd OK BusyBox v1 19 4 2012 03 22 11 29 17 EDT built in shell ash Enter help for a list of built in commands linuxrc mnt lost found opt media proc Figure 11 Hardware Target console The connection used with the target is displayed at the top of the console view In the console view you can type commands you want to run on the target and view the output Please note that this is a basic
46. ment machine Development Host and Target Board The development host is the machine where TimeStorm runs and source code is compiled for the target board The target board is the location where the code that is compiled on the development host will eventually be debugged and deployed Because target boards often do not have the resources like RAM or fixed storage processing power or peripherals such as a monitor keyboard or network connection to support a development environment engineers typically don t do their development directly on the target TimeStorm bridges the gap between the more powerful development host and less powerful target board through the following features e Toolchain Management TimeStorm keeps track of any toolchains that are installed on the development host as part of a Timesys Starting Point or are created with the Factory build system NOTE A starting point is Timesys terminology for a pre built BSP SDK A starting point is a platform and toolchain that has been specified by Timesys and is pre built and available for download from the Timesys LinuxLink Web site e Build Configurations Build Configurations connect a toolchain with a project Each project can have many build configurations and each build configuration can have its own settings to control how the software is built By default TimeStorm creates three build configurations for new projects 1 Release 2 Debug and 3 Profile e Tar
47. onfigurations C C Application Runs a C or C project on the local system Use this option if when running or debugging an application built with the host compiler TimeStorm C C Remote Runs or installs a C or C project on a remote target Use this option to debug programs built with this cross compiler Main Panel In the Main panel shown in Figure 12 specify the project to run with this configuration You can use the Browse button to search for your project name After filling in the project name use the Search Project button to find the executable file that you want to transfer and run pd Arguments P Environment x Debugger 2 Project printenv Browse C C Application Debug printenv Search Project Browse 22 TimeStorm User s Manual 23 Figure 12 Main Panel Arguments Panel In the Arguments panel shown in Figure 13 you can specify execution details for your application Only the C C Remote projects have the Remote Working Directory option B Mai C C Program Arguments ERE Remote Working directory L Use default command BB Environment Xi Debugger 4 Figure 13 Arguments Panel C C Program Arguments You can specify values to pass to the application by typing them in the C C Program Arguments field Separate values with spaces Values are passed in the order in which you list them here Remote Working Direc
48. onfigure and control LTTng collect the trace data and visualize and analyze the trace data OProfile A powerful profiling tool an d using TimeStorm you will be able to configure OProfile gather OProfile data and visualize it Valgrind A powerful tool that can be used from TimeStorm for profiling applications For use on host only currently there is no remote target support These features are meant for code running on your host TimeStorm User s Manual Advanced Topics Automatic Updates The standalone TimeStorm IDE will automatically search for updates from Timesys when it starts by contacting http updates timesys com timestorm When updates are available a dialog will appear asking whether or not the updates should be installed To update the TimeStorm plugins installed in a third party Eclipse IDE e Select Help gt Software Updates from the menu Update Process The update process will show you where TimeStorm found updates shown in Figure 34 When TimeStorm was installed it was configured to look at a specified Timesys URL Other plug ins may also have added a URL for automatic updates so this dialog may show additional features Se Available Updates EJ Available Updates A Review and confirm that the checked updates will be installed B m dP LLL Size 132 KB Details TimeStorm helps you develop and debug embedded Linux applications L lt Back Next gt Finish Cancel
49. our license file into the appropriate directory on the TimeStorm host License files are typically delivered as text file attachments to email messages from Timesys You can rename a license file but you must retain the lic file extension To install the license locally you can do one of the following e From within the Create a License window click the Download link and save the license file on the TimeStorm host at a location described below OR e Save the emailed license attachment on the TimeStorm host to one of the locations described below At startup time TimeStorm will automatically detect license files if they are stored locally on the TimeStorm host in one of three locations directories The order and locations in which TimeStorm checks for license files are outlined below 1 lt user home directory gt timesys timestorm licenses The TimeStorm user s home directory is typically something like home lt username gt on Linux systems o Licenses copied to this location will work for this user for all version compatible TimeStorm installations on this computer 2 lt TimeStorm installation directory gt licenses TimeStorm checks for a directory named licenses that is located within the TimeStorm installation directory o This licenses directory is created automatically when TimeStorm is installed Licenses installed in this directory will work for this installation of TimeStorm only 3 etc timesys timestorm
50. pace printenv test script Jusr share test data Download Mow Restore Default ul gt Figure 20 Download Files Panel The application specified in the File field is listed as Target Program This is the application that will be run You can change where it is downloaded by selecting it and clicking Edit If the program links in shared libraries then these libraries will be downloaded to the target as well and the Files field is listed as Target Program and Libraries These libraries will be downloaded to the same location as the target program To download the program and libraries to separate locations remove the default entry and re add each as a separate entry File paths are interpreted as relative to the target directory to which you download files If you transfer files by using FTP the actual destination directories depend on the configuration of your FTP software In some cases directories specified in this panel are appended to the user s home directory on the target This panel contains the following buttons Add File Use the Add File button to specify additional files to transfer along with the application These files are transferred every time you transfer the application file Edit To change where the application or any other file in this list is installed select it and click Edit to change its destination directory
51. plays projects in the current workspace Views have their own menus and some views have their own toolbars The actions represented by buttons on view toolbars affect only the items within that view Editors are stacked in the center You can associate different editors with different types of files Double clicking a file to open it will open the associated editor in the workbench shown in Figure 1 above TimeStorm User s Manual Perspectives You can rearrange the views and editors in your workbench as you prefer The saved arrangements of views and editors are called Perspectives There are no constraints as to what views appear ina perspective however the views are typically related in some way TimeStorm ships with several perspectives for example e C C Views and menu items that are customized for applications libraries and driver development e Debug Shows debugging controls step in step over step return terminate etc and information variables breakpoints threads etc e Qt C Includes views for Qt Widget box Action Editor Signal Slot Editor etc e Git Repository Exploring Includes explorer view for adding browsing and managing Git repository When TimeStorm initially opens it loads the C C perspective by default If you create a new project of a different type TimeStorm switches to the appropriate perspective automatically By default TimeStorm saves your current perspective settings when you exit
52. res that make TimeStorm unique to embedded developers Eclipse Terminology Workspace The workspace is the top level container for all of the information kept by TimeStorm When starting TimeStorm the user selects a workspace and uses only that workspace Users may have more than one workspace but TimeStorm uses only one at a time When using TimeStorm users can switch workspaces Projects Projects in TimeStorm are different than workspaces in that the workspace contains projects and projects are the entity responsible for creating binaries A workspace frequently contains several projects one for building the application binaries another for creating a library etc Using the workspace these projects can be coordinated to produce the software binaries for the target board Wizards Every project in TimeStorm is created with a wizard Wizards in TimeStorm ask the user for basic project information and will create a simple working project that is used as the base for additional work Workbench The TimeStorm IDE graphical user interface is called the Workbench Workbench features are part of the standard Eclipse development environment which serves as the basis for TimeStorm IDE The Workbench is composed of editors views and perspectives TimeStorm User s Manual The Eclipse Workbench is presented into one or more windows These windows could be either views or editors as shown in Figure 1 A perspective defines the visual a
53. rrangement of the Workbench windows nee C C printenv printenv c TimeStorm mgl ldk m File Edit Refactor Navigate Search Project Run Window Help 19 2 08 g R Q Q 9 wey Car p ox ao C Y d LC U nt E Project Explorer x BIS test script Mc 59 cj envstruct c EE EE a n Out 2 Mak B R we E E mom printenv c b g envstruct envstruct h v L printenv Text Editor limits h b Binaries gt Wi Includes gt Debug gt d printenv c test script e main void int include envstruct h include print2 h include lt Limits h gt View int main void env t current get envstruct while current print2 current name current value Project View current current gt next return 0 C Build envstruct Building target L Invoking GCC C Lir home timesys timesys at91sam9260 ek toolchain bin armv5l timesys linux gnueabi gcc shared o libenvstruct so envstruct o Finished building target libenvstruct so m Writable Smart Insert 13 1 Figure 1 TimeStorm Workbench The Workbench is documented more completely in the online Workbench User Guide which is available from the TimeStorm Help menu Views and Editors Views support editors and provide alternative presentations as well as ways to navigate information in your workspace For example the Project Explorer view shown in Figure 1 above dis
54. s KZ K C C E An outline is not available ChangeLog Name Bin Path Include Path Add K Help v Install Update Java v Library Hover K Mylyn Qt Add new Qt version Remote Systems y Specify the Name and Bin Include Pathes of the Qt version K Run Debug K Specfile Editor Version Name dm3730 qt SystemTap gt Team gt TimeStorm Au Bin Path home timesys timesys dm3730_evm toolchain bin gt Tracing amp Au Path containing tools qmake uic rcc etc K Usage Data Collector Valgrind Include Path home timesys timesys dm3730 evm toolchain include Browse 2 Path containing the include pathes QtCore QtGui etc 5 Oit v De Type a Cancel Finish n 0 items selected Figure 29 Configuring Qt Enter a name for the Ot version Select the Bin Path Click Browse to select the bin folder of the toolchain that includes Ot Include Path The include path will be automatically set you need not change it TimeStorm User s Manual 6 Click the Finish Button Now TimeStorm is set to use the Qt version you have added To Create a Qt project and develop a Qt application 1 Click File gt New gt Project gt Qt gt Qt Console Project Qt Gui Project to launch the project wizard 2 Fill in the project name and other details 3 Click the Finish button During development you may want to first develop and debug your Qt apps on the host and then rebuild them for
55. s followed Create symlinks This is the easiest path On the build machine create symbolic links to the tools in the location where the make file expects them to be Going this route introduces a configuration dependency on the build machine so this should documented by the build team and in the best of situations a script should be created to automate the creation of the links Set environment variables With make if an environment variable is set it will not be overridden by a make variable The script that runs the make file will need to set all of these variables to the right location before invoking make 53 TimeStorm User s Manual Auxiliary Files TimeStorm will over write the make file each time is performs a build In order to allow for maximum customization TimeStorm builds the make file with several optionally included files Optionally included files are incorporated into the make file if they exist otherwise if the file does not exist the reference to the file is ignored TimeStorm optionally includes these files makefile init This file is called at the beginning of the makefile It can be used to customize initialization makefile defs This file is called after initialization but before objects are compiled It can be used to supply custom macro definitions makefile targets This file is called at the end of the makefile It can be used to supply customized target information No
56. specified in the Directories field above To deselect this option uncheck the box Source Panel The Source panel Figure 18 shows the location of the source files for the project gt Z printenv Absolute File Path gt t envstruct gt i gt print Restore Default Search for duplicate source files on the path Figure 68 Source Panel Source Lookup Path This field shows the project being run as well as any projects that it references Add You can add arbitrary source file locations by using the Add button These locations are searched after the generic locations from the top to the bottom item in order Edit Remove Up Down The other buttons to the right of the list allow you to edit remove or reorder the list items and to restore the default information Search for duplicate source files on the path Selecting this checkbox causes TimeStorm to notify the user if it is unable to determine which source file corresponds to an executing binary file For example if you have two source files with the same filename in different directories of the search path TimeStorm is unable to determine which file is related to the binary file with that name If this checkbox is selected TimeStorm displays a message and asks the user to select which file to use This checkbox is not selected by default TimeStorm User s Manual Target Panel The Target panel shown in Figure 19 allows you to select the hardwar
57. t File Name lib lt project name gt a Lib lt project name gt so Can Update at Run time No Yes Dynamic Loader Needed No Yes Code Shared Across No Yes Applications Select the TimeStorm Cross Compile Toolchain from the list of toolchains populated installed from a Timesys Starting Point or added manually to TimeStorm The toolchain can be changed later in the Project s Property page see Changing the Toolchain for an Existing Project Next select the configurations Debug Profile and Release After clicking the Finish button the project will be created in the Workspace Editing and Building After starting development using the wizard TimeStorm works like a standard IDE When new files are added to the project TimeStorm will add them to the project s make file and will use the program s extension to determine what tool to use for the build process Extension Build Program CHC C compiler C CXX Cpp CC C compiler S Assembler To add an include file source file or create a sub directory to a project right click on the project choose New to see different file options Give the appropriate file extension when specifying the file name To build the application select Project Build Project from the menu TimeStorm will build the project with the active build configuration and display any errors or warnings in the problems view During the build process TimeStorm generates a make file for the project based
58. t the toolchain and click the View button NOTE Timesys toolchains that are automatically detected cannot be edited If you want to modify tools or properties for a Timesys toolchain you must add it as a user defined toolchain Preferences x type filter text Toolchains ov b General Create remove view or edit toolchain definitions P C C Installed Toolchains Pun N Locati Applies To 444 Name ocauon les 10 P Install Update l pe Add gt Run Debug armv5l timesys lint home timesys time All Users b teks armv7l timesys lint home timesys time All Users em GCC 4 3 3 armv5l ti home timesys buile Current Use v INED Native toolchain x usr All Users Launch P Usage Data Collector gt D OK Cancel Figure 2 Toolchain Management NOTE Both automatically detected and any added user defined toolchains will appear in this list User Supplied Toolchains If your toolchain is not from a Timesys Starting Point you must import your toolchain to make it available to TimeStorm The next section titled Adding Your Own Toolchain gives detailed instructions for adding a user defined toolchain to your TimeStorm Workspace so that it will be available for use in TimeStorm projects When using a toolchain that was not provided by Timesys you must ensure the toolchain s compatibility with TimeStorm and with the other elements of your development environment The toolchain must be GNU based
59. th a lic file extension A node locked license enables TimeStorm features on one machine only and is restricted to the hardware address of the machine The licenses are keyed to the MAC address of the system Once a license is installed and TimeStorm Users Manual used it cannot be moved to a machine with a different MAC address If needed you can move the license to a different machine by creating a new license and installing it on the new machine NOTE Since the TimeStorm 4 3 license system is based on a different technology than the TimeStorm 3 x series of products you must obtain a new license for TimeStorm 4 3 Creating a TimeStorm License To create a license for TimeStorm tools you must have a LinuxLink seat assigned to you e You Can create a new license for TimeStorm three times within the life of the subscription e If you need to create additional licenses beyond this limit contact Timesys These requests are handled on a case by case basis e Team Manager If you are the Team Manager of your LinuxLink account you can create a license for all the seats within your account e Developer If you are a Developer you can create licenses for the seats assigned to you To create a TimeStorm license 1 Note the MAC address of the machine on which you will be using TimeStorm You may use any of the network interfaces however if you are running TimeStorm in a Virtual Box environment make sure you use the MAC address of the NIC
60. the target board To switch the Qt version 1 Right click on the project and click Properties Qt Properties 2 Select the Ot version you want to use as shown in Figure 30 r aa Lj Properties for qtGuiApp Gl Qt Properties K Resource Default Builders Use Qt Version dm3730 qt K C C General C C Include Paths ar C C Make Project C C Project Paths Logging Project References s k S Run gmake when pro file changes Pative qt Qt Properties Run Debug Settings K Task Repository WikiText Restore Defaults Apply Figure 30 Changing Qt version for a project 44 TimeStorm User s Manual After booting the board with the SDK that includes Qt you will be able to remotely run debug the Qt apps on the Hardware target To Run Debug Qt an application on the Target 1 Follow the procedure explained in Run Debug Configurations 45 TimeStorm User s Manual QEMU Launcher QEMU Launcher will allow you to select a QEMU enabled SDK and run QEMU QEMU launcher dialog can be opened by clicking the icon in the toolbar or by clicking Run gt Launch QEMU The launcher dialog will be displayed as show in Figure 31 QEMU Launcher Launch QEMU 0 71 open source processor Smt lator Supported SDKs qemu versatile Kernel home timesys timesys qemu_versatile zimage 3 4 ts armv5l RFS home timesys timesys qemu_versatile rfs rootfs ext2 QEMU Advanced Options Cancel S
61. then select the Native Toolchain option e The Native Toolchain will be appended with text describing the type of platform for example i686 linux e When using the host compiler ensure that all of the libraries both inside of the workspace and toolchain have been compiled for the host platform 14 TimeStorm User s Manual Working with Hardware Targets Before you can run and or debug on a remote target TimeStorm will require information about the target s TimeStorm uses this information to determine how and where data should be copied to the target and the method of communication that TimeStorm should use between the host and the target This is done through the Hardware Targets window Target RFS To download files to the target the target should be booted with an RFS that includes an FTP server or an SSH server that supports scp or booted using the NFS share on the host To communicate with the target the target should be booted with an RFS that includes a telnet server or SSH server or connected to the hosted via the serial port The pre built SDK from Timesys includes dropbear that supports both scp and ssh If you are creating your own SDK using the Timesys FREE Edition Web Factory there are many packages from which you can choose for ftp telnet and ssh The available packages are listed below e ftp proftpd pure ftpd vsftpd ncftp e scp dropbear openssh e telnet netkit telnet e ssh
62. tice TimeStorm will look for the files in the parent of the build configuration directory This makes it easy to share make file customizations across build configurations Using Source Code Control from the Command line Some organizations use a source code control SCC system that can only be used from the command line or some other external tool TimeStorm can be used with these tools as long as care is taken in what files are placed under source control and other configuration measures are taken This section lists out the files and directories that should not be placed under SCC and other per file configuration information File or Directory Notes Workspace workspace metadata This directory contains state information such as window positioning for the current workspace Exclude this entire directory from SCC management C C Projects lt workspace gt lt c project gt cproject These files contain project oriented information such as what lt workspace gt lt c project gt products appears in the properties dialog for a project lt workspace gt lt c project gt project Add all of these files into source control 54 nux from a Trusted Source SyS About Timesys Timesys is the provider of LinuxLink a high productivity software development framework that dramatically simplifies and soeeds up embedded Linux application development The LinuxLink framework includes the Linux kernel cross toolchain applica
63. tion development IDE an award winning build system called Factory a vast library of middleware packages software stacks and libraries documentation and expert technical support LinuxLink enables development teams to consistently build and maintain a custom open source embedded Linux platform through regularly updated Linux sources proven middleware packages and a scriptable GNU based build environment LinuxLink reduces the time resources risk and cost associated with building a product based on open source Linux For more information visit www timesys com Timesys Corporation 925 Liberty Avenue Pittsburgh PA 15222 1 888 432 8463 1 412 232 3250 Fax 1 412 232 9818 TimeStorm pytimesys 9 2002 2012 Timesys Corporation All rights reserved Timesys the Timesys logo TimeStorm and Factory are trademarks of Timesys Corporation Fedora is a trademark of Red Hat Inc Fortran is a trademark of Lahey Computer Systems Inc Java and Java Runtime Environment are trademarks of Oracle Corporation Linux is a trademark of Linus Torvalds in the United States and other countries Qt is a trademark of Nokia Corporation in Finland and or other countries worldwide Ubuntu is a registered trademark of Canonical Ltd All other trademarks and product names are the property of their respective owners
64. tory In the Remote Working Directory field you can specify the directory from which to run the application on the target TimeStorm switches to this directory path before executing the application If you do not change the value of this field from the application runs from the target user s home directory Command to Execute In the Command to Execute field enter the exact command to use when running the application This value is required The default value is to run the specified program within the working directory Uncheck Use default command to change this value Keep in mind the directory structure on your target when constructing this command For example if you have copied your application file to a directory named apps but you want to execute it from a working directory named home test you must include the path to your application in your command For example apps my app TimeStorm User s Manual 24 Environment Panel In the Environment panel shown in Figure 14 you can set environment variables for the target E Main 0 Arguments 75 Environment Debugger Variable LD LIBRARY PATH Append environment to native environment O Replace native environment with specified environment Figure 14 Environment Panel The panel shown in Figure 14 contains the following buttons New Click the New button to create a new entry and t
65. ugging and has control over the environment variables and source code locations Development Host Debugging Strategies Since it may not be possible to create a complete environment for running a program on the host machine the recommended strategy is to build scaffolding code to emulate the target device and create an environment similar to the target To minimize the development efforts for this scaffolding code engineers will not put effort into creating a high fidelity emulation but one good enough to exercise the code in question In addition the host machine is frequently configured to be similar in file structure as the remote machine or a directory is created to resemble the root file system of the target and the program performs a chroot when starting Following this strategy allows the developer to create a separate environment that is closer to that of the target that is with the same set of files permissions libraries and device nodes without interfering with the host machine s configuration The chroot strategy also helps reduce regressions that can happen when recompiling and testing the program on the target machine 40 TimeStorm User s Manual Building Related Projects in a Workspace In TimeStorm projects are not hierarchical This is much different than other systems where a project is frequently structured as a top level directory with a directory for each component with those directories nesting downward
66. y choosing the Shared file radio button 31 TimeStorm User s Manual 32 Shared File When you select this option the run configuration is saved as a Launch file that can be imported into another TimeStorm workspace Optionally you can specify a different location for the file so that it is more easily accessible to multiple projects Display in Favorites Menu You can select whether to include this run configuration on the main Run and Debug menus For example if you select the Run checkbox the run configuration always appears in the Run History submenu You can choose to include the run configuration in either menu both menus or neither menu Launch in Background Selecting the Launch in background checkbox causes this run configuration to run as a background thread Running as a background thread is the default value Clear this checkbox if you want to run in the foreground along with other TimeStorm processing NOTE The other options in this panel are Eclipse features that are not currently supported in TimeStorm TimeStorm User s Manual Creating an Application Project Application projects are created by using the New C or C Project wizard TimeStorm uses the existing CDT C and C Project wizards but adds the ability to select a cross toolchain By creating a project with cross toolchain TimeStorm will be able to build the project with one or more of the toolchains place

TimeStorm User`s Manual - LinuxLink

Contents

Download Pdf Manuals

Related Search

Related Contents