to download MULTI for Davinci Quick - Green Hills Software

v4.3.1 

Quick 

Start 

Guide 

for DaVinci technology processors

Green Hills Software 30-day Evaluation License Agreement 

Green Hills Software, Inc. (Green Hills) agrees to grant and user (“Licensee”) agrees to accept a non-transferable and non-exclusive license (“the License”) to use the 

computer programs: Green Hills C/C++ Compilers and MULTI® (“the Licensed Programs”), on the following terms and conditions: 

1. Consideration—For and in consideration of receiving the License, Licensee agrees to evaluate the Licensed Programs for the sole purpose of making a purchase 

decision, and to report to Green Hills problems encountered in their use. Licensee also agrees to prevent the disclosure of any and all results of Licensee’s use of 

Licensed Programs, including but not limited to, space performance, time performance, compile time performance, new features, bug fixes, defects, Bugs, documentation 

improvements, documentation errors, user interface, competitive analysis, comparison with competing products, etc. 

2. Ownership of Licensed Programs—Title and full ownership rights to the Licensed Programs under this 30 Day Evaluation License Agreement, including any installation, 

operations, or other manuals, remain with Green Hills. The Licensed Programs are agreed to be Green Hills’ proprietary information and trade secret, whether or 

not any portion thereof is or may be validly copyrighted or patented. 

Licensee shall have the right to use the Licensed Programs or any portion thereof on this computer system located at the address of licensee above. 

Separate licenses, for additional consideration payable to Green Hills, shall be required for the use of the Licensed Programs on each additional central processing unit. 

Unless Green Hills declares otherwise in writing, Licensee shall not inhibit or otherwise disable any feature of the Licensed Programs, by modification of the licensed 

program or otherwise, which prints out or otherwise displays notices of Green Hills’ proprietary rights in the Licensed Programs, identifications of this 30 Day 

Evaluation License Agreement or the License granted hereunder, or the site at which Licensee may use the Licensed Programs pursuant to this 30 Day Evaluation 

License Agreement. 

No right to print, copy, or otherwise disclose the Licensed Programs or any portion thereof, in any form whatsoever, is granted hereby. 

This 30 Day Evaluation License Agreement, the License granted hereunder, and the Licensed Programs may not be assigned, sub-licensed, or otherwise transferred by 

the Licensee without the prior written consent of Green Hills. Any assignment, sub-license, or transfer in violation of the foregoing sentence shall be null and void and 

shall, at the option of Green Hills, result in the automatic termination of this 30 Day Evaluation License Agreement. Licensee shall take all reasonable steps to ensure 

the performance of this paragraph. 

3. Term and Termination—The license shall be effective from the date hereof and shall terminate thirty (30) days thereafter unless terminated earlier as provided 

herein. 

In the event Licensee neglected or fails to perform or observe any of its obligations under this 30 Day Evaluation License Agreement, and fails to correct such breach 

within thirty (30) days after Green Hills gives Licensee notice of such breach, or if any assignment shall be made of its business for the benefit of creditors, or if a 

receiver, trustee in bankruptcy, or a similar officer shall be appointed to take charge of all or part of its property, or it is adjudged a bankrupt, this 30 Day Evaluation 

License Agreement and the License granted hereunder shall immediately terminate. 

4. Security—Licensee and all individuals having access to the Licensed Programs, on other than an “execute only” basis, acknowledge and agree: 

(a) to maintain the Licensed Programs in secure premises to prevent any unauthorized person from obtaining any part thereof; and 

(b) not to provide any copies or disclose any details of the Licensed Programs to unauthorized third parties without the prior written approval of Green Hills; and 

(c) not to create, not to attempt to create, and not to permit or help others to create, by disassembly or otherwise, source code for the Licensed Programs, and not to 

translate the Licensed Programs into any computer or natural language; and 

(d) not to allow any individual access to the Licensed Programs, on other than an “execute only” basis, until a signed acknowledgement of their obligations hereunder 

is obtained; and 

(e) to give Green Hills written notice of any unauthorized disclosure or use of the Licensed Programs as soon as they learn or become aware of it. 

5. Support Services—For a thirty (30) day period beginning on the date hereof, Green Hills will make reasonable efforts to correct any program errors in the Licensed 

Programs brought to its attention with written documented reports submitted by Licensee’s Designated Contact Person, except those resulting from alteration or misuse 

of the Licensed Programs. Green Hills, however, does not guarantee service results or represent or warrant that all program errors will be corrected. 

6. Warranty—Green Hills warrants that the Licensed Programs will be in good operating condition at the time of acceptance of Licensee and will conform in all essential 

respects to the then currently published Program Description applicable to the Licensed Programs when it is shipped to Licensee. 

GREEN HILLS MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR ANY OTHER MATTER OTHER THAN 

THE EXPRESS WARRANTIES CONTAINED IN THIS LICENSE AGREEMENT AND ANY AMENDMENT(S) HERETO. NO REPRESENTATION OR STATEMENT NOT EXPRESSLY 

CONTAINED IN THIS LICENSE AGREEMENT OR ANY AMENDMENT(S) HERETO SHALL BE BINDING UPON GREEN HILLS AS A WARRANTY OR OTHERWISE. 

Green Hills shall have no liability to Licensee for any losses or damages, direct or indirect, arising out of this 30 Day Evaluation License Agreement. In no event shall 

Green Hills be liable for any indirect, special, or consequential damages, such as, but not limited to, loss of anticipated profits or other economic loss in connection with 

Licensee’s use of the Licensed Programs. Green Hills shall not be liable for any loss, injury, damage, or expense caused by Licensee’s use of the Licensed Programs. 

Green Hills shall not be liable for any loss, injury, damage, or expense caused by Licensee’s misuse or negligent processing of the Licensed Programs. 

Green Hills shall not be held to any liability with respect to any claim by a third party on account of, or arising out of the use of the Licensed Programs. 

7. Patent/Copyright Infringement—Green Hills guarantees that Licensee’s purchase and use of the license furnished in this agreement, in the form in which furnished 

to Licensee, will not infringe any valid United States or Foreign patent or copyright, and Green Hills agrees to defend any claim, action, or suit that may be 

brought against Licensee for patent or copyright infringement by reason of Licensee’s purchase or use of such license, and Green Hills also agrees to indemnify Licensee 

and hold Licensee harmless against all claims, judgments, decrees, damages, costs, and expenses recovered against Licensee or sustained by Licensee on account of any 

such actual or alleged infringement. 

8. Miscellaneous—The terms of this 30 Day Evaluation License Agreement may be modified only in writing signed by Green Hills and by Licensee. 

This 30 Day Evaluation License Agreement represents the entire agreement between the parties with respect to the use of the Licensed Programs and supercedes any 

previous oral or written communications, representations, understandings, or agreements with respect thereto. No provision appearing on any purchase order, quotation 

form or other form originated by either party shall be applicable unless such provisions are expressly accepted in writing by both 

parties. 

Fees specified in this agreement are exclusive of sales and use taxes. Licensee shall pay any sales or use tax imposed as a result of the existence or operation of this 

agreement. 

Any dispute under this 30 Day Evaluation License Agreement shall be submitted to binding arbitration in Los Angeles County, California, under the rules then prevailing 

of the American Arbitration Association. Judgment upon any award made in such arbitration may be entered and enforced in any court of competent jurisdiction. 

This 30 Day Evaluation License Agreement shall be governed by the laws of the State of California, U.S.A. Any judicial action taken by either party shall have its venue 

only in Los Angeles County, State of California, U.S.A, in the State or Federal Court having jurisdiction of the subject matter of the action. The prevailing party in any 

legal action brought to enforce or interpret this Agreement or for damages for its breach shall be entitled to an award of reasonable attorney’s fees. If any provision 

hereof is invalid under any applicable statute or rule of law, it shall to that extent be deemed to be omitted. 

The waiver by any party to this 30 Day Evaluation License Agreement of any default or breach of the 30 Day Evaluation License Agreement shall not constitute a 

waiver of any subsequent default or breach of the same or of a different kind. 

2 

Quick Start Guide 

Green Hills Software, Inc. 

Quick Start for MULTI and DaVinci technology processors 

MULTI v4.3.1 for DaVinci Technology Processors 

TABLE OF CONTENTS 

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 

Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 

Setting up MULTI for Linux Run Mode Debugging . . . . . . . . . . . . . . . . . . . . . . .4 

Creating a new Linux Application in MULTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 

Setting up the Green Hills Probe for DaVinci . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 

Debugging a Linux kernel image with MULTI . . . . . . . . . . . . . . . . . . . . . . . . . . .11 

Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 

Copyright © 2006 by Green Hills Software, Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval 

system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without prior written 

permission from Green Hills Software, Inc. 

DISCLAIMER 

GREEN HILLS SOFTWARE, INC. MAKES NO REPRESENTATIONS OR WARRANTIES WITH RESPECT TO THE CONTENTS HEREOF AND SPECIFICALLY DIS- 

CLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE. 

Further, Green Hills Software, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without 

obligation of Green Hills Software, Inc. to notify any person of such revision or changes. Green Hills Software, the Green Hills logo, MULTI and 

AdaMULTI are registered trademarks, and EventAnalyzer and ResourceAnalyzer are trademarks of Green Hills Software, Inc. All other 

trademarks and registered trademarks are property of their respective companies. 

PubID: 0806 

August 25, 2006 

3

Quick Start for MULTI and DaVinci technology processors Quick Start for MULTI and DaVinci technology processors 

OVERVIEW 

This Quick Start Guide is a companion to the software provided with the DVEVM and the MULTI 

integrated development environment. 

This documents provides high-level, step-by-step instructions for developers using MULTI with DaVinci 

technology processors for the first time. For more detailed instructions, users are directed to other manuals 

and documents provided by either Texas Instruments (TI) or Green Hills Software (GHS). This guide 

is written to support a Linux host development environment, since that is what is provided with the 

DVEVM. MULTI is also available for Windows host environments. 

INSTALLING THE SOFTWARE 

Install the TI and MontaVista software included with the DV-EVM before proceeding. See DVEVM 

Getting Started Guide (sprue66a.pdf) for details. 

Install MULTI. Please refer to the MULTI: Getting Started Guide (start.pdf) for information on 

installing and licensing MULTI. Make sure that MULTI is in your PATH so that command line tools 

that are used below such as dblink can be found. 

SETTING UP MULTI FOR LINUX RUN MODE DEBUGGING 

Details for this section are covered in MULTI: Developing for Embedded Linux on ARM (linux_arm.pdf). 

There is also a high level overview covered in the MULTI release notes (release_notes.pdf) found in the 

MULTI installation directory. There is a script (dvevm_debug.sh) in the same installation directory that 

automates much of this process and generates a MULTI project based on the DVEVM examples. This is 

the fastest way to get started debugging an application on DaVinci. 

The script provided with MULTI v4.3.1 has been validated with version 1_10_00_18 software from TI. 

For the most recent software updates, please check www.ghs.com/ti_quickstart. 

The script will ask you several questions and automatically take you through all of the steps covered 

below. Before executing dvevm_debug.sh, please edit~/dvevm_1_10/Rules.make and be sure that the variables 

in that file are all pointing to the correct directories. To verify that Rules.make is acceptable, compile 

the DVEVM demos using the 'make' command and run them on your DaVinci. For more information 

on this procedure, please refer to your TI documentation. 

Also verify that you have write permissions to the following directories and the files in those directories: 

~/dvevm_1_10/ 

~/dvevm_1_10/demos/decode/ 

~/dvevm_1_10/demos/encode/ 

~/dvevm_1_10/demos/encodedecode/ 

~/workdir/filesys/usr/lib/ (for libc.so and libpthread.so) 

4 


Use the following commands to execute the script: 

host $ cd /usr/ghs/multi431/linux86 

host $ ./dvevm_debug.sh 

NOTE: Running the above script lets you skip the following steps. 

The details of what happens behind the scenes in the script are important for setting up your development 

environment, so we will quickly cover them here. 

First setup a linux build directory on your host that contains the cross tools, headers and libraries that 

MULTI will use to build embedded linux applications. The script creates a directory in your DVEVM 

software install directory called multi_linux_build_dir. When you create new projects for embedded 

linux in MULTI you will be prompted to provide the path to this directory. 

host $ cd ~/workdir/dvevm_1_10 

host $ mkdir multi_linux_build_dir 

host $ cd multi_linux_build_dir 

host $ ln –s /opt/mv_pro_4.0/MontaVista/pro/devkit/arm/v5t_le/armv5tl_MontaVista-linuxeabi/bin bin 

host $ ln –s ~/workdir/filesys/usr/include include 

host $ ln –s ~/workdir/filesys/lib lib 

host $ mkdir usr 

host $ cd usr 

host $ ln –s ~/workdir/filesys/usr/lib lib 

Next you must modify libc.so and libprthread.so such that the local MontaVista versions are used instead 

of the files from /usr. 

host $ cd ~/workdir/dvevm_1_10/multi_linux_build_dir/lib/usr 

Edit libc.so to have the following path in the GROUP line: 

GROUP ( ../../lib/libc.so.6 ../../lib/libc_nonshared.a ) 

Edit libpthread.so to have the following path in the GROUP line: 

GROUP ( ../../lib/libpthread.so.0 ../../lib/libpthread_nonshared.a ) 

The last thing to do is to copy the target resident debug agent that MULTI uses for run mode debug. 

This agent is called linuxserv and is located in /lib/lnxarm_davinci5/linuxserv 

host $ cp /usr/ghs/multi431/lib/lnxarm_davinci5/linuxserv ~/workdir/filesys/opt/dvevm 


5


CREATING A NEW LINUX APPLICATION IN MULTI 

1. From the MULTI Launcher choose File->Create New Project 

2. Make the selections shown below and click Next. 

3. Choose the fork debugging example 

4. Make sure to store it somewhere in your target files system hierarchy, click Next 

5. Specify the Linux build directory that you created, then click Finish 

6. Build the application. Hit F7 or click the Build button 

6 Green Hills Software, Inc. 


7


7. Click the Debug button to launch the debugger 

8. Start linuxserv running on the target 

target $ cd /opt/dvevm 

target $ ./linuxserv –server 3112 –target_root_dir /home/green/workdir/filesys 

9. Establish a linuxserv connection to MULTI. See chapter 4 of MULTI: Developing for Embedded Linux 

on ARM (linux_arm.pdf) for details on setting up the Linuxserv connection in MULTI. 

Here is a screen shot of an example connection for DaVinci. 



9


10. Debug the application. As you step over the first line MULTI will open up a new debugger window for 

you on the child process that was created by the fork() system call. 

SETTING UP THE GREEN HILLS PROBE FOR DAVINCI 

There are various ways to communicate with the Green Hills Probe and configure it for use with your 

DaVinci target. For details on how to connect to the probe and adjust the settings please consult the 

Green Hills Debug Probe User’s Guide. There is additional DaVinci EVM specific board information in 

the board_info.pdf document that is located in \target\arm\davinci\board_info.pdf. 

The output below is an example working probe configuration for the DaVinci EVM. Please pay particular 

attention to the adapter, logic_high, and target settings below. This example uses the TI DSP target 

interface module with a 14 pin connector and 3.3V logic. This configuration requires the use of the 

Low Voltage Adapter with Adaptive Clocking for TI ARM based processors (14 pin-CTI-20 pin) from 

Spectrum Digital that converts the 1.8V logic on the DVEVM to 3.3V. The part number is 701212. 

The Green Hills Probe can also directly support 1.8V logic if you do not wish to use this adapter. 

Furthermore, if you have a 20pin-20pin adapter you can use an ARM target interface module with the 

probe instead of the TI DSP target interface module. This interface module provides the added functionality 

of exposing the SYSRESET line of the processor, which allows you to reset the board from the 

probe without having to cycle power. 

Note: The probe command t switches the probe between the various cores available 

through the JTAG. The currently selected core and it’s state is indicated in the command prompt. 

The numbering scheme is as follows: 

0 = icepick 

1 = ARM926 

2 = Embedded Trace Buffer 

3 = C64x+ 

Here is an example of switching between cores: 

icepick[0,?] % t 1 

Selected core 1. 

arm926[1,c] % 

See Appendix A for complete listing of probe settings for this example. 

DEBUGGING A LINUX KERNEL IMAGE WITH MULTI 

If you wish to debug a linux kernel image with MULTI you must build the kernel with debug information 

included in the output file. 

Follow the steps in section 4 of the DVEVM Getting Started Guide (sprue66a.pdf) to install and setup 

the MontaVista Linux Kernel software. In section 4.6 “Building a New Linux Kernel” you will need to 

pass an additional parameter in the make command line to build the linux kernel imagewith debug 

information. In step 5 of section 4.6 use the following command line to build debug information into 

the kernel image: 

host $ make ARCH=arm CROSS_COMPILE=arm_v5t_le- CONFIG_DEBUG_INFO=1 uImage 

10 Green Hills Software, Inc. Green Hills Software, Inc. 

11


You will also need to translate the dwarf debug information generated by gcc to a debug format that 

MULTI understands. To do this run the following command: 

host $ dblink --scan_source -auto_translate vmlinux 

The dblink command will create the following files that MULTI uses when debugging the kernel: 

vmlinux.dla 

vmlinux.dnm 

Boot the kernel using one of the methods described in DVEVM Getting Started Guide. Once the kernel 

is up and running you will want to start a debugger on the vmlinux image and then attach to the target 

with a freeze mode connection. For details on configuring target connections with MULTI please 

refer to MULTI: Configuring Connections for ARM Targets and MULTI: Configuring Connections for 

C6000 Targets. 

The following screen shots show how to create a connection to the ARM core through the Green Hills 

Probe. It is also possible to debug using the Spectrum Digital XDS560 and XDS510 as well as the 

Blackhawk XDS560 probes with MULTI. 

1. Create a connection. 




2. In the Connection Editor Window, click on the Advanced tab to specify the ARM core for this 

connection. 

3. After you have created the connection, connect the debugger in Attach mode. 

13


4. After establishing the connection you can browse through the code using MULTI and put a breakpoint 

in the kernel. A safe place to do this is in the __schedule() function. 




5. From here you can open up the OSA Explorer to view internal linux kernel structures and the list of 

processes in the system. You can also open up a new debugger window on a specific process by double 

clicking on the process in the Task pane of the OSA window. 

For detailed information on linux kernel debugging, including debugging kernel modules, please see 

chapter 6 in the MULTI: Developing for Embedded Linux on ARM (linux_arm.pdf) document. 

15


APPENDIX 

Example probe configuration for TI DSP interface module with 3.3V logic adapter: 

* Green Hills Probe for DaVinci, v1.12.0 

* Firmware built Apr 28 2006 14:35:40 

* Serial No: 6927 

* Part number 520-GP300-02A 

* Green Hills Software, Inc 

* http://www.ghs.com 

* 

* Type 'info' to list probe information. 

* Type 'setup' to set the current configuration. 

Type 'help' to list the online help. 

Green Hills Probe 

icepick[0,?] % set 

dhcp = off 

ip = 192.168.104.248 

netmask = 255.255.255.0 

gateway = 192.168.104.254 

single_mpserv_only = off 

adapter = auto [ti] 

clock = 15 MHz 

use_rtck = off 

rtck_use_timeout = on 

logic_high = 3.300000 

target = icepick(0:arm926 1:armetb 2:c64x_plus) 

checker = off 

power_detect = on 

user_button = tri-state 

user_string = Green Hills Probe 

baudrate = 115.2 kbaud 

rst_pulse = 300 ms 

rst_settle = 300 ms 

jrst_pulse = 300 ms 

jrst_settle = 300 ms 

rst_tap_then_sys = off 

minimize_scanchain = off 

use_max_reset = off 

icepick[0,?] % t 1 


arm926[1,c] % set 

dhcp = off 

ip = 192.168.104.248 

netmask = 255.255.255.0 


gateway = 192.168.104.254 








checker = off 










endianness = little 

fast_dl = off 

abort_check = on 

use_bkpt_inst = on 

use_hw_singlestep = off 

catch_por = off 

catch_reset = off 

catch_undef = off 

catch_swi = off 

catch_prefetch = off 

catch_abort = off 

catch_irq = off 

catch_fiq = off 

etm_version = 1 

monitor_mode = off 

override_mmu = on 

force_dbgack = on 

simulate_singlestep = off 

arm926[1,c] % t 2 


[2,?] % set 

dhcp = off 

ip = 192.168.104.248 

netmask = 255.255.255.0 

gateway = 192.168.104.254 





17







checker = off 











associated_core = 1 

[2,?] % t 3 


c64x+[3,?] % set 

dhcp = off 

ip = 192.168.104.248 

netmask = 255.255.255.0 

gateway = 192.168.104.254 








checker = off 











step_ints = off 

c64x+[3,?] % 




19

Corporate Headquarters 

30 West Sola Street 

Santa Barbara, CA 93101 

ph: 805.965.6044 

fax: 805.965.6343 

email: sales@ghs.com 

www.ghs.com 

North American Sales Offices 

Arizona - Phoenix 

Tel: 602.953.6123 

California - Los Angeles 

Tel: 805.965.6044 

California - San Clemente 

Tel: 949.369.3950 

California - Santa Clara 

Tel: 408.919.0800 

Canada - Ottawa 

Tel: 613.271.2115 

Colorado - Denver 

Tel: 303.740.8462 

Georgia - Atlanta 

Tel: 404.873.6285 

Illinois - Chicago 

Tel: 847.515.2418 

Massachusetts - Natick 

Tel: 508.655.5155 

Massachusetts - Topsfield 

Tel: 978.887.0051 

North Carolina - Mars Hill 

Tel: 828.689.8508 

Ohio - Dayton 

Tel: 937.848.8644 

Texas - Dallas 

Tel: 972.712.1407 

Washington - Bothell 

Tel: 425.402.3692 

International Offices 

Australia 

Tel: +61.4.3744.7638 

France 

Tel: +33.1.46.96.07.00 

Germany 

Tel: +49.721.98.62.580 

Israel 

Tel: +972.9.958.4060 

Japan 

Tel: +81.3.3576.5351 

Netherlands 

Tel: +31.33.4613363 

Sweden 

Tel: +46.46.211.33.70 

United Kingdom 

Tel: +44.1844.267950 

North American Safety 

Critical Products Sales Offices 

California - Laguna Hills 

Tel: 949.460.6442 

Florida - Palm Harbor 

Tel: 727.781.4909 

Technical Support 

North America Mountain/Pacific 

time, Australia, New Zealand 

support-west@ghs.com or 

1.877.GHS.TECH 

North America Eastern/Central 

time, South America 

support-east@ghs.com or 

1.877.GHS.TECH 

Europe, Africa, India 

support-nl@ghs.com or 

+31.33.4613363 

Japan, Taiwan, South Korea 

support@adac.co.jp or 

+86.10.62000988 

Safety Critical Technical Support 

support-ada@ghs.com or 

727.781.4909

to download MULTI for Davinci Quick - Green Hills Software

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?