Digi Connect SP Quick start guide

NET+Works with GNU Tools

Getting Started Guide

NET+Works with GNU Tools

Getting Started Guide

Operating system/version: 6.3

Part number/version:

90000718_C

Release date: March 2006

www.digi.com

Digi, Digi International, the Digi logo, the Making Device Networking Easy logo, NetSilicon, a Digi

International Company, NET+, NET+OS and NET+Works are trademarks or registered trademarks of

Digi International, Inc. in the United States and other countries worldwide. All other trademarks are

the property of their respective owners.

Information is this document is subject to change without notice and does not represent a

commitment on the part of Digi International.

Digi provides this document “as is,” without warranty of any kind, either expressed or implied,

including, but not limited to, the implied warranties of, fitness or merchantability for a particular

purpose. Digi may make improvements and/or changes in this manual or in the product(s) and/or the

program(s) described in this manual at any time.

This product could include technical inaccuracies or typographical errors. Changes are made periodically

to the information herein; these changes may be incorporated in new editions of the publication.

       v

Contents

Chapter 1: Using NET+Works with GNU Tools and a Hardware Debugger.......... 1

Task 1: Getting ready ................................................................................... 2

Gather IP parameters............................................................................. 2

Save files and close applications................................................................ 2

Verify your access rights ......................................................................... 2

Verify hardware requirements .................................................................. 3

MAJIC upgrades .................................................................................... 3

Task 2: Installing the NET+Works software ..................................................... 4

Task 3: Setting up the IP address of the MAJIC probe ..................................... 6

Task 4: Creating an MDI server icon ............................................................... 10

vi       

Task 5: Configuring the IP address of the development board ......................... 15

Task 6: Building and downloading the template application ............................ 17

Building the BSP ................................................................................... 17

Building the template application .............................................................. 19

Downloading the template application ........................................................ 21

Task 7: Running and debugging the template application ................................ 23

Running the application .......................................................................... 23

Debugging the application with a break point................................................ 24

Chapter 2: Using NET+Works with GNU Tools and the GDB Software Debugger .27

Task 1: Getting ready ................................................................................... 28

Gather IP parameters............................................................................. 28

TFTP server ........................................................................................ 28

Save files and close applications................................................................ 28

Verify your access rights ......................................................................... 29

Verify hardware requirements .................................................................. 29

Task 2: Installing the NET+Works software ..................................................... 30

       vii

Task 3: Configuring the IP address of the development board ......................... 32

Task 4: Setting up the GDB software debugger ............................................... 34

Updating the BSP .................................................................................. 34

Loading the GDB-server-enabled bootloader ................................................. 35

Adding a second serial connection ............................................................. 36

Updating the template application............................................................. 36

Launching the TFTP server....................................................................... 37

Executing the GDB software debugger-enabled bootloader ................................ 37

Task 5: Debugging the template application ................................................... 39

Chapter 3: Tips and Suggestions ........................................................................... 41

Where should I put my code, and why? ........................................................ 41

What should my next step be? .................................................................. 41

Appendix: Updating the MAJIC Probe’s Firmware............................................... 43

       ix

Using this guide

Review this section for basic information about this guide, as well as for general support contact

information.

About this guide

This guide describes NET+OS with GNU Tools and how to use it as part of your development cycle.

Part of the NET+Works integrated product family, NET+OS is a network software suite optimized for

the NET+ARM.

Software release

This guide supports NET+OS 6.3. By default, this software is installed in the /cygdrive/c/

netos63_gnu

directory. The instructions in this guide are based on the assumption that NET+Works

is installed in the default directory.

x       

NET+Works with GNU Tools Getting Started Guide

Who should read this guide

This guide is for software engineers and others who use NET+Works for NET+OS. To complete the

tasks described in this guide, you must:

 Be familiar with installing and configuring software.

 Have sufficient user privileges to do these tasks.

 Be familiar with network software and development board systems.

Conventions used in this guide

This table describes the typographic conventions used in this guide:

This convention Is used for

italic type Emphasis, new terms, variables, and document titles.

bold, sans serif type Menu commands, dialog box components, and other screen items.

menu name → option Menu names and selections selections.

monospaced type Filenames, pathnames, and code examples.

www.digi.com

       xi

What’s in this guide

This table shows where you can find information in this guide:

Related documentation

 The Hardware Installation Guide describes how set up the hardware.

 NET+Works with GNU Tools BSP Porting Guide describes how to port the board support

package (BSP) to a new hardware application using GNU Tools.

 NET+Works with GNU Tools Programmer’s Guide describes how to use NET+OS to

develop programs for your application and hardware.

To read about See

Installing NET+Works with GNU Tools, configuring IP

parameters, and completing a brief exercise using

either the MAJIC probe or the Raven debugger

Chapter 1: “Using NET+Works with GNU Tools

and a Hardware Debugger”

Installing NET+Works with GNU Tools, configuring IP

parameters, and completing a brief exercise using the

GDB software debugger

Chapter 2: “Using NET+Works with GNU Tools

and the GDB Software Debugger”

T

ips for using NET+Works with GNU Tools with

your own projects

Chapter 3, “Tips and Suggestions”

xii       

NET+Works with GNU Tools Getting Started Guide

 NET+Works online help describes the application programmer interfaces (APIs) that are

provided with NET+OS. The online help is located in

C:\netos63_gnu\Documentation.

For information about third-party products and other components, review the documentation

CD-ROM that came with your development kit.

For information about the processor you are using, see your NET+Works hardware documentation.

Documentation updates

Digi occasionally provides documentation updates on the Web site.

Be aware that if you see differences between the documentation you received in your NET+Works

package and the documentation on the Web site, the Web site content is the latest version.

Customer support

To get help with a question or technical problem with this product, or to make comments and

recommendations about our products or documentation, use the contact information listed next:

 United States telephone: 1 877 912-3444

 International telephone: 1 952 912-3444

 email: [email protected]

 Web site: http://digi.com

       1

Chapter 1: Using NET+Works with GNU Tools and a Hardware Debugger

This chapter provides a series of tasks that will get you up and running with NET+Works with

GNU Tools. In these tasks, you will:

 Install NET+Works with GNU Tools.

 Configure IP parameters.

 Complete a brief exercise that demonstrates how to use the tool set, including:

– Building the board support package (BSP), libraries, and template applications

– Running and debugging the sample application

You must do all the tasks in this chapter, in the order in which they are presented.

To get started, go on to “Task 1: Getting ready.”

Note:

If you are using the GDB software debugger, skip to Chapter 2: “Using NET+Works with

GNU Tools and the GDB Software Debugger.”

Plan to spend approximately two hours

completing the tasks.

2       

NET+Works with GNU Tools Getting Started Guide

Task 1: Getting ready

This task describes what you need to

do before you get started.

The instructions in this document are

based on the assumption that you have

already installed your hardware.

Gather IP parameters

See your network administrator for IP

parameter information:

 If you are using a Raven debugger,

you need IP parameters for the

development board only.

 If you are using a MAJIC probe, you

need IP parameters for both the

development board and the MAJIC.

You may find it convenient to write the

information in the spaces provided.

Development board

 IP address:

___________________________

 Subnet mask:

___________________________

 Default gateway:

___________________________

MAJIC probe

 IP address:

___________________________

 Subnet mask:

___________________________

 Default gateway:

___________________________

Save files and close

applications

Save all open files and close any open

applications, because after you install

the software, you will reboot your PC.

Verify your access rights

Make sure you have administrative

rights on the PC on which you are

installing NET+Works.

www.digi.com

       3

Verify hardware requirements

 Your PC must be running either Microsoft Windows 2000

or XP.

Be aware that Windows 95/98/ME, Windows NT 4.0, and

Windows Server 2003 are not supported.

 If you are using a MAJIC probe and need to configure it,

it’s most convenient to have two COM ports on your PC.

MAJIC upgrades

If you are using a MAJIC probe with firmware prior to

version 3.6.4, you must upgrade the MAJIC firmware.

For instructions, see the Appendix.

What’s next?

Go on to the next task to install the NET+Works software.

4       

NET+Works with GNU Tools Getting Started Guide

Task 2: Installing the NET+Works software

In this task, you will install the NET+Works software on your

system, using a wizard that guides you through the process.

During the installation, if you register NET+Works, you are

prompted for a serial number. Use the serial number that’s

located on your development board. If the development

board is not available, use

Vnnnnnnnn.

 To install NET+Works:

1 Place the installation CD in your CD drive, and follow

the wizard prompts.

After about 40 minutes, the NET+Works 6.3 with GNU

To o l s dialog box prompts you to register your product:

Digi recommends that you register your software so

you can receive information about software updates.

www.digi.com

       5

2 If you want to register your software, click Register

NET+Works 6.3 with GNU Tools, and follow the

prompts.

Digi recommends that you register your software so you

can receive information about software updates.

3 To complete the installation, in the NET+Works 6.3 with

GNU Tools dialog box, click

Next.

After the NET+Works software is installed, you see a

prompt about whether to restart your PC.

4 You must click OK.

What’s next?

If you are using a MAJIC probe, go to the next task to set up

the MAJIC’s IP address.

If you are using a Raven debugger, skip to Task 5,

“Configuring the IP address of the development board.”

6       

NET+Works with GNU Tools Getting Started Guide

Task 3: Setting up the IP address of the

MAJIC probe

This task describes how to set up the IP address of the MAJIC

probe. In this procedure, you’ll use the EPI MAJIC Setup

Wizard and provide the information you gathered in Task 1.

You must follow the instructions in this task if:

 You are a new user.

 You are upgrading and do not know the IP address of your

MAJIC probe.

Otherwise, skip to the next task.

 To set up the MAJIC’s IP address:

1 Using the serial cross cable that ships with the MAJIC,

connect the MAJIC to an available COM port on your PC.

If you don’t have an available connection on your

PC, reuse the one that’s already connected to the

development board. In this case, close all applications

associated with the COM port, such as HyperTerminal.

2 Do one of these steps:

– Windows XP systems. Select Start  All Programs 

EPI Tools-EDTA 2.2a MAJIC Setup Wizard.

– Windows 2000 systems. Select Start  Programs 

EPI Tools-EDTA 2.2a MAJIC Setup Wizard.

The

EPI MAJIC Setup Wizard Introduction window opens:

3 Click NEXT.

www.digi.com

       7

The Choose Operations window opens:

4 From the Type of Connection pulldown menu, select Static

IP Address for Internet

, and then click Go.

The

Configure MAJIC’s Ethernet Static IP Address window

opens; this example has the information filled in.

5 Enter the information you got from your network

administrator, using the format shown in the example:

– IP Address

– Subnet Mask

– Default Gateway

and then click NEXT.

8       

NET+Works with GNU Tools Getting Started Guide

The MAJIC Connection Parameters window opens:

6 Do these steps:

a Click I will be using a serial port to communicate with

my MAJIC

.

b From the COM port to use pulldown menu, select the

serial port number.

Make sure no other programs are using the COM port

you select.

c Click Install IP.

The

Install Static IP dialog box opens:

7 In the Install Static IP dialog box, click OK.

A dialog box and a DOS window open.

8 In the Check Your Installation Result dialog box, confirm

that the IP address information in the DOS window is

correct by clicking

OK.

If there is a problem, correct it, and go back to step 1 of

this task.

9 After the MAJIC configuration completes, power-cycle

the MAJIC.

Page is loading ...

Digi Connect SP Quick start guide

This manual is also suitable for

Digi Connect SP Quick start guide

Related papers

Other documents