Phytec PhyCORE-PXA270 Programming manual

PHYTEC Messtechnik GmbH

A product of a PHYTEC Technology Holding company

Quick Start Instructions

Linux-Kit

phyCORE-PXA270

Using Eclipse and the GNU Cross Development Tool Chain

Note: The PHYTEC Linux-phyCORE-PXA270-Disc includes the

electronic version of the English phyCORE-PXA270 Hardware Manual.

Edition: October 2009

phyCORE-PXA270 Quick Start Instructions

In this manual copyrighted products are not explicitly indicated. The absence of the

trademark (™) and copyright (©) symbols does not imply that a product is not

protected. Additionally, registered patents and trademarks are similarly not expressly

indicated in this manual.

The information in this document has been carefully checked and is believed to be

entirely reliable. However, PHYTEC Messtechnik GmbH assumes no responsibility for

any inaccuracies. PHYTEC Messtechnik GmbH neither gives any guarantee nor accepts

any liability whatsoever for consequential damages resulting from the use of this

manual or its associated product. PHYTEC Messtechnik GmbH reserves the right to

alter the information contained herein without prior notification and accepts no

responsibility for any damages that might result.

Additionally, PHYTEC Messtechnik GmbH offers no guarantee nor accepts any

liability for damages arising from the improper usage or improper installation of the

hardware or software. PHYTEC Messtechnik GmbH further reserves the right to alter

the layout and/or design of the hardware without prior notification and accepts no

liability for doing so.

Rights - including those of translation, reprint, broadcast, photomechanical or similar

reproduction and storage or processing in computer systems, in whole or in part - are

reserved. No reproduction may be made without the explicit written consent from

PHYTEC Messtechnik GmbH.

EUROPE NORTH AMERICA

Address: PHYTEC Technologie Holding AG

Robert-Koch-Str. 39

55129 Mainz

GERMANY

PHYTEC America LLC

203 Parfitt Way SW, Suite G100

Bainbridge Island, WA 98110

USA

Ordering

Information:

+49 (800) 0749832

[email protected]

1 (800) 278-9913

[email protected]

Technical

Support:

+49 (6131) 9221-31

[email protected]

1 (800) 278-9913

[email protected]

Fax: +49 (6131) 9221-33 1 (206) 780-9135

Web Site: http://www.phytec.de http://www.phytec.com

5th Edition: October 2009

phyCORE-PXA270 Table of Contents

Chapter 1 Introduction.........................................................1

1.1 Rapid Development Kit Documentation ....................................1

1.2 Professional Support Packages Available ..................................2

1.3 Overview of this Quick Start Manual.........................................2

5 min

1.4 Conventions Used in this Quick Start Manual ...........................3

1.5 System Requirements .................................................................4

1.6 Software Development Tool Chains ..........................................5

1.6.1 Eclipse .............................................................................5

1.6.2 The GNU Cross Development Tool Chain .....................6

Chapter 2 Getting Started....................................................7

2.1 Requirements of the Host Platform ............................................7

2.2 Configuring the Host Platform ...................................................8

2.2.1 Installing Software Packages ..........................................8

35 min

2.2.2 Set Up Network Card Configuration ............................14

2.2.3 Disabling the Firewall ...................................................15

2.2.4 Set Up TFTP Server ......................................................16

2.3 Linux-phyCORE-PXA270-Kit Setup.......................................18

2.3.1 Starting the Setup ..........................................................19

2.4 Advanced Configuration Information ......................................27

2.5 Connecting the Host with the Target........................................29

2.6 Copying an Example to the Target...........................................33

2.6.1 Copying a Program to the Target..................................34

2.6.2 Using Telnet to Execute a Program on the Target ........35

2.6.3 Using SSH to Execute a Program on the Target...........36

2.7 Advanced Information..............................................................39

2.7.1 Copying a Program to the Target with the .......................

Command Line..............................................................39

2.7.2 Executing a Program on the Target...............................39

2.7.3 Executing a Program directly on the Target using SSH40

Chapter 3 Getting More Involved.....................................41

3.1 Configuring and Compiling the Kernel....................................41

70 min

phyCORE-PXA270 Quick Start Instructions

3.1.1 Writing the Kernel into the Target’s Flash ................... 44

3.2 Opening an Existing Project..................................................... 47

3.2.1 Copying the HelloWorld Project................................... 48

3.2.2 Starting Eclipse and Importing the Example Project.... 48

3.3 Creating a New Project............................................................. 53

3.4 Changing the Demo Application.............................................. 62

3.4.1 Executing the Program on the Target using Microcom 63

3.5 Starting a Program out of Eclipse on the Target ...................... 64

3.6 Automatically Starting the Program when Booting the Target 67

Chapter 4 Debugging an Example Project.......................73

4.1 Starting the GDB Server on the Target .................................... 73

4.2 Configuring and Starting the Debugger in Eclipse .................. 75

4.3 Setting a Breakpoint ................................................................. 80

35 min

4.4 Stepping and Watching Variable Contents .............................. 81

4.5 Changing Variable Values ....................................................... 82

4.6 Using the Memory Monitor...................................................... 83

Chapter 5 Further Information.........................................87

Chapter 6 Summary............................................................88

Chapter 7 Installing Linux on the phyCORE-PXA270...89

7.1 Installing the Boot Loader........................................................ 89

7.2 Configure U-Boot Environment Variables .............................. 91

7.3 Restore the U-Boot default configuration ................................ 92

7.4 Writing the Kernel / Root File System into Flash.................... 93

phyCORE-PXA270 Introduction

Chapter 1Introduction

5 min

In this Quick Start you can find general information on the PHYTEC

phyCORE-PXA270, and an overview of the Eclipse software development

tool and the GCC C/C++ cross development tool chain. You will also find

instructions on how to run example programs on the phyCORE-PXA270,

mounted on the PHYTEC Development Board, in conjunction with the

Eclipse development tool.

Please refer to the phyCORE-PXA270 Hardware Manual for specific

information on board-level features, such as jumper configuration, memory

mapping, and pin layout.

1.1 Rapid Development Kit Documentation

This “Rapid Development Kit” (RDK) includes the following electronic

documentation on the enclosed “PHYTEC Linux-phyCORE-PXA270-

Disc:”

The PHYTEC phyCORE-PXA270 Hardware Manual.•

•

PXA270 Controller User's Manuals and Data Sheets.

This Quick Start Instructions with general “Rapid Development Kit”

description, software installation advice, and an example program

enabling quick out-of-the-box start-up of the phyCORE-PXA270 in

conjunction with the Eclipse and GCC C/C++ software development

tool chain.

phyCORE-PXA270 Quick Start Instructions

1.2 Professional Support Packages Available

This kit comes with free installation support. If you have any questions

concerning installation and setup, you are welcome to contact our support

department.

For more in-depth questions, we offer a variety of custom-tailored

packages with different support options (e-mail, phone, direct contact to the

developer) and different reaction times.

Please contact our sales team to discuss the appropriate support option if

professional support beyond installation and setup is important to you.

1.3 Overview of this Quick Start Manual

This Quick Start manual gives you a general “Rapid Development Kit”

description, as well as software installation advice and an example program

enabling quick out-of-the-box start-up of the

phyCORE-PXA270 in conjunction with the Eclipse IDE and GCC C/C++

software tools. It is structured as follows:

•

The “Getting Started” chapter describes the configuration of the host

platform and how to setup all the tools used in this manual.

The “Getting More Involved” chapter provides step-by-step instructions

on how to configure and build a new kernel, modify an example

application, create and build new projects, and copy programs to the

phyCORE-PXA270 using Eclipse.

The “Debugging” chapter provides information on how to debug an

application with the Eclipse debugging interface.

In addition to the dedicated data for this Rapid Development Kit, the

PHYTEC Linux-phyCORE-PXA270-Disc contains supplemental infor-

mation on embedded microcontroller design and development in general.

phyCORE-PXA270 Introduction

1.4 Conventions Used in this Quick Start Manual

The following is a list of the typographical conventions used in this Quick

Start manual:

Italic

Used for file and directory names, program and command

names, command-line options, menu items, URLs, and other

terms that correspond the terms on your desktop.

Bold

Used in examples to show commands or other text that should

be typed literally by the user.

Pay attention to notes set apart from the text with the following icons:

At this part you might leave the path of this Quick Start.

This is a warning. It helps you to avoid annoying problems.

Provides useful supplementary information about the topic.

At the beginning of each chapter you can find information of

the time needed to pass that chapter.

You have successfully passed an important part of this Quick

Start manual.

Provides information to solve common problems.

phyCORE-PXA270 Quick Start Instructions

1.5 System Requirements

Use of this “Rapid Development Kit” requires:

The PHYTEC phyCORE-PXA270.•

•

The PHYTEC Development Board with the included DB-9 serial cable,

Ethernet cross-over cable and AC adapter supplying 12 VDC (min. 2

A).

PHYTEC Linux distribution based on OSELAS from Pengutronix.

An IBM-compatible host PC (586 or higher CPU).

openSUSE 11.0 (x86) and the KDE desktop.

Recommended free disk space: at least 2 GB.

For more information and updates, please refer to the following sources:

http://www.phytec.de

[email protected]

phyCORE-PXA270 Introduction

1.6 Software Development Tool Chains

1.6.1 Eclipse

The Eclipse platform provides support for C/C++ development. Because

the Eclipse platform is only a framework for developer tools, it doesn't

support C/C++ directly; instead it uses external plug-ins. This Quick Start

shows you how to make use of the CDT, a set of plug-ins for C/C++

development in conjunction with the GCC C/C++ tool chain.

The CDT is an open source project (licensed under the Common Public

License) implemented purely in Java as a set of plug-ins for the Eclipse

SDK platform. These plug-ins add a C/C++ perspective to the Eclipse

Workbench that can now support C/C++ development with a number of

views and wizards, along with advanced editing and debugging support.

Due to its complexity, the CDT is broken down into several components,

which take the form of separate plug-ins. Each component operates as an

autonomous project, with its own set of committers, bug categories, and

mailing lists. However, all plug-ins are required for the CDT to work

properly. Here is a list of the plug-ins/components:

•

Primary CDT plug-in is the “framework” for the CDT plug-ins.

CDT Feature Eclipse is the CDT Feature Component.

CDT Core provides Core Model, CDOM, and Core Components.

CDT UI is the Core UI, views, editors, and wizards.

CDT Launch provides the launch mechanism for external tools such as

the compiler and debugger.

CDT Debug Core provides debugging functions.

CDT Debug UI provides the user interface for the CDT debugging

editors, views, and wizards.

phyCORE-PXA270 Quick Start Instructions

•CDT Debug MI is the application connector for MI-compatible

debuggers.

1.6.2 The GNU Cross Development Tool Chain

Cross development in general refers to the overall software development

process that produces a single application or a complete system running on

a platform that is different from the development platform. This is an

important concept when the target system doesn’t have a native set of

compilation tools, or when the host system is faster and has greater

resources.

The platform where the actual development takes place is called the host

platform. The platform where the final application is tested and run is

called the target platform. In this Quick Start we are using an x86-based

Linux as the host platform. As the target platform we are using the ARM

architecture with an PXA270 CPU.

Building a program for a CPU architecture different from the one used on

the machine where the compilation is done is accomplished using a cross

compiler tool chain and cross-compiled libraries. In this Quick Start we are

using the GNU C/C++ cross development tool chain.

Other manuals for phyCORE-PXA270

Table of contents

Other Phytec Computer Hardware manuals

Phytec

Phytec L-808e.A4 User manual

Phytec

Phytec phyCORE-LPC3180 Programming manual

Phytec

Phytec phyCORE-DS80C390 Programming manual

Phytec

Phytec ATOM phyCORE-Z500P(T) User manual

Phytec

Phytec Cosmic-AM335 Series User manual

Phytec

Phytec phyGATE Tauri-L User manual

Phytec

Phytec phyCORE-PXAG49 Programming manual

Phytec

Phytec phyCORE-MPC5676/57 Series User manual

Phytec

Phytec L-843e.A1 User manual

Phytec

Phytec phyCORE-AM335 Series User manual

Phytec

Phytec eGrabber-4plus User manual

Phytec

Phytec phyCORE-i.MX 8M Mini User manual

Phytec

Phytec L-863e.A2 phyCORE-i.MX 8M User manual

Phytec

Phytec phyCORE-LPC3180 User manual

Phytec

Phytec L-1029e.A1 User manual

Phytec

Phytec L-820e.A2 User manual

Phytec

Phytec phyCORE-i.MX 8M Plus User manual

Phytec

Phytec phyCORE-TC399 User manual

Phytec

Phytec IoT-Enablement-Kit 4 User manual

Phytec

Phytec KEIL nanoMODUL-STM32F103 Programming manual

Phytec

Phytec phyCORE-AM62Ax User manual

Phytec

Phytec phyFLEX-i.MX 6 User manual

Phytec

Phytec phyCORE-i.MX 8M Mini User manual

Phytec

Phytec phyCORE-MPC5554 User manual

Popular Computer Hardware manuals by other brands

EMC2

EMC2 VNX Series Hardware Information Guide

Panasonic

Panasonic DV0PM20105 Operation manual

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 user manual

Gigabyte

Gigabyte B660M DS3H AX DDR4 user manual

Raidon

Raidon iT2300 Quick installation guide

National Instruments

National Instruments PXI-8186 user manual

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual

Phytec phyCORE-PXA270 Programming manual

Popular Computer Hardware manuals by other brands