Phytec phyCORE-OMAP44 Series Programming manual

A product of a PHYTEC Technology Holding company
QuickStart Instructions
WEC 7-Kit
phyCORE®-OMAP44xx
Using Microsoft Visual Studio 2008
Software Development Tool Chain
Note: The PHYTEC WinCE-phyCORE-OMAP44xx includes the
electronic version of the English phyCORE®-OMAP44xx Hardware
Manual

phyCORE
®
-OMAP44xx QuickStart Instructions
© PHYTEC Meßtechnik GmbH 2012 L-763e_0
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 which 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.
©Copyright 2012 PHYTEC Messtechnik GmbH, 55129 Mainz.
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: [phone]
[email protected] 1 [phone] [email protected]
Technical
Support: [phone]
[email protected] 1 [phone] [email protected]
Fax: [phone] [phone]
Web Site: http://www.phytec.de http://www.phytec.com
1st Edition: January 2012

Contents
1Introduction ...........................................................................................1
1.1 Rapid Development Kit Documentation ......................................1
1.2 Professional Support Packages available .....................................2
1.3 Overview of this QuickStart Instruction.......................................2
1.4 Conventions used in this QuickStart ............................................3
1.5 System Requirements ...................................................................4
1.6 Microsoft Visual Studio 2008 Development Tool Chain.............5
2Getting Started....................................................................................... 7
2.1 Installing Visual Studio 2008 .......................................................7
2.2 Installing Platform Builder...........................................................8
2.3 Installing WinCE phyCORE-OMAP44xx-Kit software............10
2.4 Installing Microsoft Active Sync 4.5..........................................14
2.5 Preparing the phyCORE®-OMAP44xx to interface to a
host-PC........................................................................................15
2.6 Establishing an Active Sync Connection ...................................16
2.7 Downloading Example Code with Active Sync.........................17
2.8 Downloading Example Code with Visual Studio 2008..............18
3Getting More Involved........................................................................23
3.1 Creating a New Project...............................................................23
3.2 Create a Button on dialog ...........................................................27
3.3 Modifying the Source Code........................................................30
3.4 Building the Project....................................................................31
4Debugging.............................................................................................33
4.1 Starting the Debugger.................................................................33
4.2 Visual Studio 2008 Debug Features...........................................35
4.3 Using the Visual Studio 2008 Debug Features...........................36
4.4 Changing Target Settings for the "Executable Version"............37
5Building an image................................................................................ 39
5.1 Changing an image.....................................................................39
5.2 Download an image....................................................................40
6Summary..............................................................................................45
Appendix A How to install Windows Embedded Compact on the
phyCORE-OMAP44xx Kit.................................................47
Appendix B How to update an existing bootloader on the phyCORE-
OMAP44xx Kit ....................................................................53
5 min
4-5 h
30 min
40 min
50 min
© PHYTEC Meßtechnik GmbH 2012 L-763e_0

phyCORE
®
-OMAP44xx QuickStart Instructions
© PHYTEC Messtechnik GmbH 2012 L-763e_0

Introduction
1Introduction
5 min
This QuickStart provides general information on the PHYTEC phyCORE
®
-
OMAP44xx Single Board Computer (SBC). It gives you also an overview of
Microsoft’s Visual Studio 2008 software development tool chain and
instructions on how to run example programs on the phyCORE
®
-
OMAP44xx, mounted on the PHYTEC phyCORE
®
Development Board, in
conjunction with Visual Studio 2008.
Please refer to the phyCORE®-OMAP44xx Hardware Manual for specific
information on such board-level features as jumper configuration, memory
mapping and pin layout. Selecting the links on the electronic version of this
document leads to the respective section of the phyCORE®-OMAP44xx
Hardware Manual.
1.1 Rapid Development Kit Documentation
This "Rapid Development Kit" (RDK) includes the following electronic
documentation on the enclosed "PHYTEC WinCE-phyCORE-OMAP44xx-
Disc":
•the PHYTEC phyCORE®-OMAP44xx Hardware Manual
•controller User's Manuals and Data Sheets
•this QuickStart 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®-OMAP44xx in
conjunction with the Microsoft Visual Studio 2008 software
development tool chain
© PHYTEC Messtechnik GmbH 2012 L-763e_0 1

phyCORE
®
-OMAP44xx QuickStart Instructions
2 © PHYTEC Messtechnik GmbH 2012 L-763e_0
1.2 Professional Support Packages available
This Kit comes with free installation support. If you do 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 QuickStart Instruction
This QuickStart Manual gives 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®-OMAP44xx in conjunction with Microsoft's Visual Studio
2008. It is structured as follows:
1)The “Getting Started” section uses the example HelloWorld to
demonstrate the download of user code to the target device using Visual
Studio 2008 with ActiveSync.
2)The “Getting More Involved” section provides step-by-step instructions
on how to configure and build a new WinCE image, modify the example,
create and build a new project and generate and download output files to
the phyCORE®-OMAP44xx using the Microsoft tools.
3)The “Debugging” section demonstrates simple debug functions using
Visual Studio 2008 debug environment.
In addition to the dedicated data for this Rapid Development Kit, the
PHYTEC WinCE Kit disc contains supplemental information on embedded
microcontroller design and development.

Introduction
1.4 Conventions used in this QuickStart
The following is a list of the typographical conventions used in this book:
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 special attention to notes set apart from the text with the following
icons:
At this part you might leave be path of this QuickStart.
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 to pass the following chapter.
You have successfully passed an important part of this
QuickStart manual.
You can find information to solve problems.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 3

phyCORE
®
-OMAP44xx QuickStart Instructions
1.5 System Requirements
The use of this "Rapid Development Kit" requires:
•the PHYTEC phyCORE®-OMAP44xx
•the phyCORE®Development Board with the included DB-9 serial
cable, USB A/mini-B cable, Ethernet cross-over cable and AC adapter
supplying 12 VDC (min. 2 A)
•Windows Embedded Compact 7 (Eval version)
•the PHYTEC WinCE-phyCORE-OMAP44xx-Disc for WEC 7
•an IBM-compatible host-PC (586 or higher running with WindowsXP
and at least 10 GB free hard disc space)
For more information and example updates, please refer to the following
sources:
http://www.phytec.de
[email protected]
4 © PHYTEC Messtechnik GmbH 2012 L-763e_0

Introduction
© PHYTEC Messtechnik GmbH 2012 L-763e_0 5
1.6 Microsoft Visual Studio 2008 Development Tool Chain
Microsoft's Software development tools for the phyCORE-OMAP44xx
architecture aid every level of developer from the professional applications
engineer to the student just learning about embedded software
development.
Visual Studio 2008 is the version of Microsoft’s popular IDE that supports
also WEC 7. The needed Platform Builder is integrated in Visual Studio
2008. So it is possible to customize the Windows Embedded Compact
Image and write user applications with just one tool. Visual Studio 2008
combines project management, source code editing, program debugging,
and target programming in a single, powerful environment. This QuickStart
provides an overview of the most commonly used VS 2008 features
including:
•Project management, device setup, and tool configuration
•Editor facilities for creating, modifying, and correcting programs
•Target debugging
•Building a new image
The VS 2008 editor offers many standard and advanced software editing
features like:
•Automatic completion of code statements
•Auto listing of object members
•Detailed Syntax Highlighting. Colors are used in printed output.
•Automatic indent and tab blocks of code
The Visual Studio 2008 Tool chain is available from your local Microsoft
dealer. There is also an evaluation version available which is used in this
QuickStart. You can use it to develop standard WinCE applications, MFC
WinCE applications and .NET Applications for WinCE.

phyCORE
®
-OMAP44xx QuickStart Instructions
If you already have installed another version of Visual Studio
2008, you can use this one. We recommend installing the
evaluation version when working with this QuickStart.
6 © PHYTEC Messtechnik GmbH 2012 L-763e_0

Getting Started
2Getting Started
4-5 h
In this chapter you will install Rapid Development Kit software and prepare the
phyCORE
®
-OMAP44xx, mounted on the Development Board, to interface to a
host-PC. You will also learn how to download an example application from a
host-PC using Visual Studio 2008.
2.1 Installing Visual Studio 2008
To install Visual Studio 2008 on your desktop PC insert the DVD labeled
“Visual Studio 2008 Professional Edition” included in this kit in your DVD
Rom drive. The setup should launch automatically. If not, open a windows file
explorer, go to your DVD drive and start “setup.exe” manually. Visual Studio
2008 needs at least 2 GB free hard disc space to install.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 7

phyCORE
®
-OMAP44xx QuickStart Instructions
The following screen appears:
Click “Install Visual Studio 2008” and follow the instructions of the setup
program.
After installation you have to download and install the Visual Studio 2008
Service Pack 1 at:
http://www.microsoft.com/download/en/details.aspx?id=10986
2.2 Installing Platform Builder
To install the Platform Builder Plug-in for Visual Studio 2008, please insert the
DVD labeled “Windows Embedded Compact 7” in your DVD drive. The setup
should start automatically. If not, open a windows file explorer, select your
DVD drive and start “WindowsEmbeddedCompact7.exe” manually. On the
opening window click “Install” to start further installation steps.
8 © PHYTEC Messtechnik GmbH 2012 L-763e_0

Getting Started
To getting an up-to-date development environment, you have to click “Update”
for downloading the newest installation files. If you don’t have internet
connection, skip the update process and download it later. It is recommended to
download the updates for best environment compatibility.
Follow the install instructions and choose “Full install” to get the hole product
support.
During the setup you have to enter a product activation key. You
will find it on the front of the DVD case.
After complete installation, it is recommended to register for the Windows
Embedded Developer Update program to get all necessary updates. Click
“Register” for the registration.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 9

phyCORE
®
-OMAP44xx QuickStart Instructions
2.3 Installing WinCE phyCORE-OMAP44xx-Kit software
In this section you will find a description of the WinCE-phyCORE-OMAP44xx-
Kit setup. This setup will install the following tools and programs:
•SDK for phyCORE-OMAP44xx WEC 7.0
•A binary BSP for the phyCORE-OMAP44xx and a project to build a new
image
•Example programs for Visual Studio 2008
•Digital version of this QuickStart instruction and the hardware manuals
The phyCORE-OMAP44xx SDK for WinCE is needed for writing target-
oriented applications. It will integrate in the Visual Studio IDE, offering a new
target device for code generation. Also the SDK includes all functionality that is
included in the image that runs on the phyCORE-OMAP44xx. Therefore using
the SDK allows the compiler to check if all functionality that is needed in the
10 © PHYTEC Messtechnik GmbH 2012 L-763e_0

Getting Started
application will be present in the image. The absence of specific features is
therefore recognized at “compile-time” not at “runtime”.
For proper installation of the SDK it is essential to first install
Visual Studio 2008 as described in chapter 2.1.
Insert the CD labeled “PHYTEC phyCORE-OMAP44xx” in your
CDROM/DVD drive and start setup.exe.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 11

phyCORE
®
-OMAP44xx QuickStart Instructions
In this dialog you are asked for a destination path for installing the demo
software and the manuals. We recommend to use the default path for working
with this QuickStart.
12 © PHYTEC Messtechnik GmbH 2012 L-763e_0

Getting Started
In the next dialog you can choose a program folder. We recommend using the
default program folder for working with this QuickStart.
In the next steps, the BSP for the PHYTEC phyCORE-OMAP44xx will be
installed. Please follow the instructions on the screen.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 13

phyCORE
®
-OMAP44xx QuickStart Instructions
After this the installation of the SDK will be launched. Follow the instructions
of the installation program. Choose complete when being asked for the amount
of files to install.
2.4 Installing Microsoft Active Sync 4.5
To be able to upload the software you are developing to your phyCORE-
OMAP44xx device you need Microsoft Active Sync 4.5. When your PC is
connected to your phyCORE-OMAP44xx device via a USB cable this software
allows you to create a direct connection to your device.
You can download Microsoft Active Sync 4.5 from the Microsoft website at
http://www.microsoft.com/windowsmobile/activesync/activesync45.mspx
To download the software follow the instruction given on the webpage and save
the downloaded file to your hard drive. Select the folder you saved the software
to and double-click setup.msi.
14 © PHYTEC Messtechnik GmbH 2012 L-763e_0
Click “Next” and in the following dialog click “Install” to start the installation
process for Microsoft Active Sync 4.5. This may take a few minutes.

Getting Started
You have successfully installed the software for the WinCE-
phyCORE-OMAP44xx-Kit. You can find the programs you will
need to develop own applications for the target on your host
system. All necessary configurations were done by the setup
program.
2.5 Preparing the phyCORE®-OMAP44xx to interface to a host-PC
To be able to interface your phyCORE-OMAP44xx with your PC you must first
setup the correct network settings on your phyCORE-OMAP44xx. For
downloading software to the phyCORE-OMAP44xx with ActiveSync we will use
the USB interface in this QuickStart. This chapter explains how to configure
WinCE to connect to your host PC.
Connect the AC adapter with the power supply connector (12V) on your board.
The power connector should have 12 VDC inside and outside
should be ground.
If Windows Embedded Compact didn’t start within 1 minute, you
have a kit with linux preinstalled. Please continue with Appendix
A “How to install Windows Embedded Compact on the
phyCORE-OMAP44xx Kit” and continue here after you have
finished this chapter successfully.
When Windows Embedded Compact has loaded it will show a screen to
calibrate the touch panel. Click on the cross on the screen to calibrate your touch
panel. When calibration is done you will see the WinCE screen.
© PHYTEC Messtechnik GmbH 2012 L-763e_0 15

phyCORE
®
-OMAP44xx QuickStart Instructions
2.6 Establishing an Active Sync Connection
The phyCORE-OMAP44xx device should already be connected to the PC as
described in chapter 2.4 and running.
ActiveSync should already be running after the installation in chapter 2.4.
Connect the USB A/mini-B cable with the USB OTG connector on the target to
a free USB port on your host.
Ensure to use the USB A/mini-B included in this RDK.
Establishing the connection might take a few seconds. Once the connection has
been established Active Sync will show a screen with status information.
Your PC is now connected to your phyCORE-OMAP44xx device.
16 © PHYTEC Messtechnik GmbH 2012 L-763e_0