Windows Embedded CE Kit Quickstart

Windows Embedded CE Kit Quickstart
QuickStart Instructions
WinCE-Kit
®
phyCARD -L
Using Microsoft Visual Studio 2005
Software Development Tool Chain
Note: The PHYTEC WinCE-phyCARD-L-Disc includes the electronic
version of the English phyCARD®-L Hardware Manual
A product of a PHYTEC Technology Holding company
phyCARD®-L
QuickStart 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 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 2011 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.
Address:
EUROPE
NORTH AMERICA
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
+49 (800) 0749832
Information: [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
1st Edition: April 2011
© PHYTEC Meßtechnik GmbH 2011
L-744e_1
Contents
1
Introduction ........................................................................................... 1
1.1 Rapid Development Kit Documentation ......................................1
1.2 Professional Support Packages available .....................................1
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 2005 Development Tool Chain.............5
2
Getting Started....................................................................................... 7
2.1 Installing Visual Studio 2005 .......................................................7
2.2 Installing Platform Builder ...........................................................8
2.3 Installing WinCE phyCARD-L-Kit software.............................10
2.4 Installing Microsoft Active Sync 4.5..........................................13
2.5 Preparing the phyCARD®-L to interface to a host-PC...............14
2.6 Establishing an Active Sync Connection ...................................15
2.7 Downloading Example Code with Active Sync.........................16
2.8 Downloading Example Code with Visual Studio 2005..............17
3
Getting More Involved ........................................................................ 22
3.1 Creating a New Project...............................................................22
3.2 Modifying the Source Code........................................................26
3.3 Building the Project ....................................................................27
4
Debugging............................................................................................. 28
4.1 Starting the Debugger .................................................................28
4.2 Visual Studio 2005 Debug Features ...........................................30
4.3 Using the Visual Studio 2005 Debug Features...........................31
4.4 Changing Target Settings for the "Executable Version" ............32
5
Building an image................................................................................ 33
5.1 Changing an image .....................................................................33
5.2 Download an image ....................................................................34
6
Summary .............................................................................................. 40
How to install WindowsCE on the phyCARD-L Kit . 41
Appendix A
© PHYTEC Meßtechnik GmbH 2011
L-744e_1
5 min
4-5 h
30 min
40 min
50 min
phyCARD®-L
QuickStart Instructions
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Introduction
1 Introduction
5 min
This QuickStart provides general information on the PHYTEC phyCARD®L Single Board Computer (SBC). It gives you also an overview of
Microsoft’s Visual Studio 2005 software development tool chain and
instructions on how to run example programs on the phyCARD®-L,
mounted on the PHYTEC phyBASE® Development Board, in conjunction
with Visual Studio 2005.
Please refer to the phyCARD®-L 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 phyCARD®-L Hardware Manual.
1.1 Rapid Development Kit Documentation
This "Rapid Development Kit" (RDK) includes the following electronic
documentation on the enclosed "PHYTEC WinCE-phyCARD-L-Disc":
• the PHYTEC phyCARD®-L 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 phyCARD®-L in
conjunction with the Microsoft Visual Studio 2005 software
development tool chain
1
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.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
1
phyCARD®-L
QuickStart Instructions
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
®
phyCARD -L in conjunction with Microsoft's Visual Studio 2005. 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 2005 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®-L using the Microsoft tools.
3) The “Debugging” section demonstrates simple debug functions using
Visual Studio 2005 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.
2
© PHYTEC Messtechnik GmbH 2011
L-744e_1
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 2011
L-744e_1
3
phyCARD®-L
QuickStart Instructions
1.5 System Requirements
The use of this "Rapid Development Kit" requires:
• the PHYTEC phyCARD®-L
• the phyBASE® 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. 2A)
• Windows Embedded CE 6.0 (Eval version)
• the PHYTEC WinCE-phyCARD-L-Disc for WinCE
• 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 2011
L-744e_1
Introduction
1.6 Microsoft Visual Studio 2005 Development Tool Chain
Microsoft's Software development tools for the phyCARD-L architecture
aid every level of developer from the professional applications engineer to
the student just learning about embedded software development.
Visual Studio 2005 is the version of Microsoft’s popular IDE that supports
also WinCE 6.0. The needed Platform Builder is integrated in Visual
Studio 2005. So it is possible to customize the WinCE Image and write user
applications with just one tool. Visual Studio 2005 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 2005 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 2005 editor offers many standard and advanced software editing
features like:
• Automatic completion of code statements
• Auto listing of object members
• Detailed Syntax Highlighting. Colours are used in printed output.
• Automatic indent and tab blocks of code
The Visual Studio 2005 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.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
5
phyCARD®-L
QuickStart Instructions
If you already have installed another version of Visual Studio
2005, you can use this one. We recommend installing the
evaluation version when working with this Quickstart.
6
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
2 Getting Started
4-5 h
In this chapter you will install Rapid Development Kit software and prepare the
phyCARD®-L, 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 2005.
2.1 Installing Visual Studio 2005
To install Visual Studio 2005 on your desktop PC insert the DVD labeled
“Visual Studio 2005 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
2005 needs at least 2 GB free hard disc space to install.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
7
phyCARD®-L
QuickStart Instructions
The following screen appears:
Click “Install Visual Studio 2005” and follow the instructions of the setup
program.
During the setup you have to enter a product activation key. You
can request this key from Microsoft. Please read the inside of the
Windows Embedded CE 6.0 DVD package for information.
2.2 Installing Platform Builder
To install the Platform Builder Plug-in for Visual Studio 2005, please insert the
DVD labeled “Windows Embedded CE6.0” in your DVD drive. The setup
should start automatically. If not, open a windows file explorer, go to your DVD
drive and start “setup.exe” manually. Platform Builder needs at least 5 GB free
hard disc space to install.
8
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
When the following dialog appears, be sure to select “Platform Builder” and
under “CE 6.0 Operating System” the files for “ARMV4I”.
During the setup you have to enter a product activation key. This
key had been sent to you together with the activation key for
Visual Studio 2005.
After that, please insert the DVD labeled “Windows Embedded CE6.0 R3” in
your DVD drive. If the setup doesn’t start automatically, open a windows file
explorer, go to your DVD drive and start “setup.exe” manually.
Finally you should install the “Windows Embedded CE 6.0 Cumulative Product
Update Rollup Package through 12/31/2010)” from Microsoft’s homepage at
http://www.microsoft.com/downloads/en/results.aspx?freetext=windows+embed
ded+ce&displaylang=en&stype=s_basic
© PHYTEC Messtechnik GmbH 2011
L-744e_1
9
phyCARD®-L
QuickStart Instructions
When the installation has finished, you need to install a service pack for Visual
Studio
2005.
Go
to
the
following
webpage
http://www.microsoft.com/downloads/details.aspx?FamilyId=BB4A75ABE2D4-4C96-B39D-37BAF6B5B1DC&displaylang=en
and download and install the service pack. Its size is about 450 MB and during
installation it needs at least 5 GB free hard disc space for temporary files.
On the download page you can choose the language of the service
pack. For the Visual Studio 2005 evaluation version that comes
with the PHYTEC WinCE-phyCARD-L-Kit, you have to
download the English version.
2.3 Installing WinCE phyCARD-L-Kit software
In this section you will find a description of the WinCE-phyCARD-L-Kit setup.
This setup will install the following tools and programs:
•
•
•
•
•
SDK for phyCARD-L WinCE 6.0
A binary BSP for the phyCARD-L and a project to build a new image
Example programs for Visual Studio 2005
HabToolKit for programming a new boot loader
Digital version of this Quickstart instruction and the hardware manuals
The phyCARD-L (OMAP3) SDK for WinCE is needed for writing targetoriented 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 phyCARD-L. Therefore using the SDK
allows the compiler to check if all functionality that is needed in the 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 2005 as described in chapter 2.1.
Insert the CD labelled “PHYTEC phyCARD-L” in your CDROM/DVD drive
and start setup.exe.
10
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
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.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
11
phyCARD®-L
QuickStart Instructions
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 phyCARD-L (OMAP3) will be
installed. Please follow the instructions on the screen.
12
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
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.
Finally the installation of the EVMFlash3530_v2.0 Toolkit will be launched.
Follow the instructions of the installation program to complete the installation of
the WinCE phyCARD-L-Kit software.
2.4 Installing Microsoft Active Sync 4.5
To be able to upload the software you are developing to your phyCARD-L
device you need Microsoft Active Sync 4.5. When your PC is connected to your
phyCARD-L 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
© PHYTEC Messtechnik GmbH 2011
L-744e_1
13
phyCARD®-L
QuickStart Instructions
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.
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.
You have successfully installed the software for the WinCEphyCARD-L-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 phyCARD®-L to interface to a host-PC
To be able to interface your phyCARD-L with your PC you must first setup the
correct network settings on your phyCARD-L. For downloading software to the
phyCARD-L 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 CE didn’t start within 1 minute, you have a kit with
linux preinstalled. Please continue with Appendix A “How to
install Windows CE on the phyCARD-L Kit” and continue here
after you have finished this chapter successfully.
When Windows CE 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.
14
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
2.6 Establishing an Active Sync Connection
The phyCARD-L 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 phyCARD-L device.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
15
phyCARD®-L
QuickStart Instructions
2.7 Downloading Example Code with Active Sync
To download the example code provided on the WinCE-phyCARD-L-Disc, you
need to have Active Sync running on your PC to be able to establish a
connection to your phyCARD-L device as described in the previous chapter.
Click Tools in the menu bar of Active Sync and select Explore Device. An
Explorer window called Mobile Device will open that will show you the folder
structure of the Windows CE installation on your phyCARD-L device.
Open a file manager and navigate to the C:\PHYTEC\PCA-A-L1_phyCARDL\WinCE-Kit\QuickStart\Demos\HelloWorld\HelloWorld\Phytec phyCARD-L
SDK (ARMV4I)\Debug folder. Select HelloWorld.exe and copy it to the Mobile
Device window in the folder Program Files using drag and drop. If a question
regarding file conversion arises, just confirm with OK.
16
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
The program has now been copied to your phyCARD-L device. You will be able
to access it by double-clicking the My Device icon on your phyCARD-L device.
This opens a window that will show you the file structure of your device. You
should be able to find HelloWorld.exe at the location you copied it to. Doubleclick it to execute the program. A window will open on your phyCARD-L
device that will print a Hello World message.
2.8 Downloading Example Code with Visual Studio 2005
PHYTEC provides you with example code to learn about downloading code
onto your phyCARD-L device. This code has already been copied to your local
hard drive by the setup.
Start the tool chain by selecting Microsoft Visual Studio 2005 from the programs
group: Start / Programs / Microsoft Visual Studio 2005.
After starting Visual Studio 2005 the window shown below will appear. Here
you can create projects, edit files, configure tools, assemble, link and start the
debugger. Close all projects that might be open by selecting File / Close
Solution.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
17
phyCARD®-L
QuickStart Instructions
The HelloWorld example downloads a program to your device that, when
executed, prints the text Hello World on the display of your phyCARD®-L.
• To open the HelloWorld project select File / Open / Project/Solution… from
the Visual Studio 2005 menu bar.
• Browse to the folder C:\PHYTEC\PCA-A-L1_phyCARD-L\WinCEKit\QuickStart\Demos\HelloWorld.
• Select the HelloWorld project HelloWorld.
18
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
• Click Open.
• In the Solution Platform pull-down menu make sure that the Phytec
phyCARD-L SDK (ARMV4I) configuration is selected. Also make sure that
Phytec phyCARD-L SDK ARMV4I Device is selected in the Target device
menu.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
19
phyCARD®-L
QuickStart Instructions
If these menus are not shown in your Visual Studio IDE, move
your mouse to an empty space on the toolbar, press the right
mouse button and select from the pop up menu the menus Target
and Device.
Build the Project
on the build toolbar or
• Build the target by either selecting the Build icon
in the main menu bar select Build / Build HelloWorld.
• If any source file of the project contains any errors, they will be shown in the
Output Window - Build tab. Use the editor to correct the error(s) in the source
code, save the file and repeat the build.
• If there are no errors, the code can be downloaded to your phyCARD-L
device. For this to work you need to have established an Active Sync
connection between your PC and your phyCARD-L device as described in
section 2.6. When the connection is established select Build / Deploy
HelloWorld from the main menu bar.
• The individual steps of the download procedure can be viewed in the Output
Window - Build tab.
• Wait until the download is complete.
• The newly created application was now deployed on your phyCARD-L
device. To start it select My Device on the target platform, go to the folder
Program Files / Helloworld and double tap on “Helloworld”.
• A window will open on your phyCARD-L device that will print a Hello
World message.
• Click the Close icon in the window to close the application.
20
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting Started
You have successfully passed the Getting Started part of this
QuickStart. In this chapter you learned how to open a project, build
an executable and transfer and run this executable on the target
hardware.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
21
phyCARD®-L
QuickStart Instructions
3 Getting More Involved
30 min
In this chapter you will learn how to configure the Visual Studio 2005 IDE
(Integrated Development Environment), modify the source code from our
example, create a new project and build and download a machine-readable
output file to the target hardware.
3.1 Creating a New Project
• To create a new project file select File / New / Project… from the Visual
Studio 2005 menu. This opens a dialog that will ask about the kind of project
you wish to create.
• Open the Visual C++ tree and select Smart Device.
• In the Templates field select Win32 Smart Device Project.
22
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting More Involved
• In the text field Name, enter the name of the project you wish to create, e.g.
myHelloWorld.
• Click OK.
• Click Next.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
23
phyCARD®-L
QuickStart Instructions
• Click the entry Phytec phyCARD-L SDK in the field Installed SDKs: and
click the > button. The Phytec phyCARD-L SDK will appear in the Selected
SDKs: field.
• Select Pocket PC 2003 in the field Selected SDKs and press the < button.
This removes the Pocket PC 2003 SDK from the list of selected SDKs.
• Click Next >
24
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting More Involved
• Don’t change the settings in this window and press Finish.
At this point you have created a new project for the phyCARD-L board. The
next step is to modify the C source file before building your project. This
includes compiling, linking, locating and creating the executable.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
25
phyCARD®-L
QuickStart Instructions
3.2 Modifying the Source Code
•
Open up the myHelloWorld tree and Source Files. Double-click on the
myHelloWorld.cpp file to open the file in the source code editor.
• Locate the following code section to make your HelloWorld program print
the text Hello World! 5 times instead of just one.
case WM_PAINT:
hdc = BeginPaint(hWnd, &ps);
• Replace this code section with the following:
case WM_PAINT:
RECT rt;
int i;
hdc = BeginPaint (hWnd, &ps);
GetClientRect (hWnd, &rt);
for (i = 1; i <= 5; i++) {
rt.top = rt.top + 30;
DrawText (hdc, _T ("Hello World!"), 12, &rt,
DT_SINGLELINE|DT_VCENTER|DT_CENTER);
}
EndPaint (hWnd, &ps);
break;
• Save the modified file by choosing File / Save or by clicking the save icon
.
26
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Getting More Involved
3.3 Building the Project
You are now ready to run the compiler and linker.
on the build toolbar or
• Build the target by either selecting the Build icon
in the main menu bar select Build / Build myHelloWorld.
• If any source file of the project contains any errors, they will be shown in the
Output Window - Build tab. Use the editor to correct the error(s) in the source
code, save the file and repeat the build.
• If there are no errors, the code can be downloaded to your phyCARD-L
device. For this to work you need to have established an Active Sync
connection between your PC and your phyCARD-L device as described in
section 2.6. When the connection is established select Build / Deploy
HelloWorld from the main menu bar.
• The individual steps of the download procedure can be viewed in the Output
Window - Build tab.
• Wait until the download is complete.
• The newly created application was now deployed on your phyCARD-L
device. To start it select My Device on the target platform and go to the folder
Program Files / myHelloworld and double tap on “myHelloworld”.
A window will open on your phyCARD-L device that will print five Hello
World messages.
You have now modified source code, recompiled the code, created a
downloadable file, and successfully executed this modified code.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
27
phyCARD®-L
QuickStart Instructions
4 Debugging
40 min
This Debugging section provides a basic introduction to the debug functions
included in Visual Studio 2005. The most important features are described by
using an existing example. For a more detailed description of the debugging
features, please refer to the appropriate manuals provided by Microsoft.
4.1 Starting the Debugger
• Make sure that Debug is selected in the Solution Configurations pull-down
menu.
• Open up the myHelloWorld tree and Source Files. Double-click on the
myHelloWorld.cpp file to open the file in the source code editor.
• Locate the following code section and click on the line
rt.top = rt.top + 30;
• Select Debug / Toggle Breakpoint on the main menu bar or press F9 to set a
breakpoint here. The red marker on the left-hand side of the selected line
indicates the breakpoint.
• To start debugging withVisual Studio 2005, select Debug / Start Debugging
or press F5.
• A progress bar will indicate the download process of the debug program.
If a problem occurs during data transfer, an error message will be displayed. If
this should occur, make sure you have established a connection between your
PC and your phyCARD-L device as described in section 2.5.
If data transfer was successful, a screen similar to the one shown below will
appear. The debug toolbar is displayed. In the lower part of the debug screen
you will see the Variables and Watch windows.
28
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Debugging
You may need to open, resize and/or move some windows to make
your screen look similar to the screen capture. You can open inactive
windows by choosing the desired window from the Debug / Windows
pull-down menu.
The debugger will run up to the code section you have marked with a breakpoint
and stop automatically. Notice the yellow arrow pointing to that breakpoint.
You can click on Debug / Toggle Breakpoint or press F9 again to remove the
breakpoint you have set.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
29
phyCARD®-L
QuickStart Instructions
4.2 Visual Studio 2005 Debug Features
• The Debugger window toolbar gives access to the following
debug commands: Restart, Stop Debugging, Break Execution, Show Next
Statement, Step Into, Step Over, Step Out and Run to Cursor.
• The first button on the debugger toolbar is the Start Debugging button. This
starts or continuous debugging.
• The Break All halts execution and the editor shows the current source code
line.
• The Stop Debugging button stops the debugger and will lead you back to
your project screen.
• The Restart button restarts the execution of the program from the beginning.
• The Show Next Statement button allows you to go through your program
code line by code line.
• The first button allowing exact control of the program execution is the Step
Into button. The Step Into command performs the execution of the command
line to which the Current-Statement Arrow points. This can be a C command
line or a single assembler line, depending on the current display mode. If the
command line is a function call, Step Into jumps to the C function or
subroutine, enabling you to explore the code contained in the accessed
subroutine.
• The Step Over button is next on the debugger toolbar. The Step Over
command executes the command line, to which the Current-Statement Arrow
points. This can be a C command line or a single assembler line, depending
on the current display mode. If the command line is a function call, the
function will be executed without single stepping into the function.
• The next button is the Step Out button. Step Out is used to exit a function you
are currently in. Step Out is very useful if you find yourself in a function you
are not interested in and need to return quickly to your intended function.
• The Hex button toggles the display style of watch variables between
hexadecimal and decimal.
30
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Debugging
• The last button pops up a menu where you can choose different windows
useful for debugging, like watch windows, process information, memory
information and calling stack.
4.3 Using the Visual Studio 2005 Debug Features
• The Variables window – Auto tab automatically shows the value of the local
variable i. You can change the number base from decimal to hexadecimal by
right clicking on the variable and selecting hexadecimal Display.
• Click Step Over several times and watch the value of i count up.
• As you can see in the source code, the for{} loop will end if i
becomes equal to 5. To leave the for{} loop, change the value of i by selecting
the value, changing it to 10 and pressing <Enter>. Now repeat clicking on
Step Over until you leave the loop.
• Remove the breakpoint by clicking into the source code line that has the
breakpoint and press F9 or the Insert / Remove Breakpoint icon.
• Click in the source code, at return 0; and choose Run to Cursor from the
debug toolbar. Your program will be executed until it reaches this line.
• To run your program without stopping at any time, delete all breakpoints by
clicking on the Insert / Remove Breakpoint icon.
button.
• Click the Go
• Hello World! will be displayed on the screen of your phyCARD-L device.
• You can use the Stop Debugging
button to stop program execution at any
time.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
31
phyCARD®-L
QuickStart Instructions
4.54.4 Changing Target Settings for the "Executable Version"
After successfully debugging the program, next change the project and the target
settings in order to create an executable file that can then be downloaded to and
executed out of the memory on the phyCARD®-L.
•
•
•
•
Make sure the program execution is stopped.
Exit the current debug session by selecting Stop Debugging.
In the Solution Configurations pull down menu select ’Release’.
Build and execute your project as described in 3.3.
You can now watch your final example execute and Hello World! will be
displayed on the screen of your phyCARD-L device.
You have successfully finished the debug section of this
Quickstart. You learned how to set breakpoints, run your
program to a specific line of code and inspect variables.
32
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Building an image
5 Building an image
50 min
In this section you will learn how to add your own application to a WinCE
project, create a new image and download this image on the phyCARD-L. We
will use the application build and debugged in the chapters before as an
example.
5.1 Changing an image
First you need a project to build the image with. In this example you can use the
project we provide on the phyCARD-L WinCE-Kit CD, which is already
installed on your system.
• Open Visual Studio 2005, if not already open.
• To open the project select File / Open / Project/Solution… from the Visual
Studio 2005 menu bar.
• Browse to the folder C:\WINCE600\OSDesigns\OMAP35xxPhytec and select
the project OMAP35xxPhytec.
When the project is loaded you will see the project in the Solution Explorer Tab
in the left window. If a dialog “Missing Catalog Items in OS Design” appears,
just press Cancel.
Open the Tree OMAP35xxPhytec\Parameter Files\OMAP35xxPhytec: ARMV4I
(Active) and double click on project.bib. Under the “Files” section add the
following line:
HelloWorld.exe "C:\PHYTEC\PCA-A-L1_phyCARD-L\WinCE-Kit\QuickStart\Demos\
HelloWorld\HelloWorld\Phytec phyCARD-L SDK (ARMV4I)\Debug\HelloWorld.exe" NK
This will add the executable HelloWorld.exe to the Windows directory of the
target. The path tells the platform builder where to find the executable that
should be added to the image and the parameter NK specifies the name of the
memory reagion where it should be added to.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
33
phyCARD®-L
QuickStart Instructions
To build a new image select Build / Build Solution from the Visual Studio 2005
menu bar. The build process will take about 20 minutes, depending on your host
platform hardware.
You don’t have always to do a complete build process that takes
this long. If you just want to add a file to the image like in the
example before, you can do this by selecting Build / Copy Files to
Release Directory. This copies all necessary files to the Release
directory. Then you can build the image with Build / Make RunTime Image. This takes only about 5 minutes. Please refer to the
Visual Studio 2005/Platformbuilder documentation for more
information.
5.2 Download an image
In the next step we want to download the image to the target.
For this step you need a terminal program like HyperTerminal.
Start the HyperTerminal program within the Programs / Accessories bar.
The HyperTerminal main window will now appear:
Double-click on the HyperTerminal icon “Hypertrm” to create a new
HyperTerminal session.
The Connection Description window will now appear. Enter “COM Direct” in
the Name text field.
34
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Building an image
Next click OK. This creates a new HyperTerminal session named “COM Direct”
and advances you to the next HyperTerminal window.
The COM Direct Properties window will now appear. Specify Direct to
COM1/COM2 under the Connect Using pull-down menu (be sure to indicate the
correct COM setting for your system).
Click the Configure button in the COM Direct Properties window to advance to
the next window (COM1/COM2 Properties).
© PHYTEC Messtechnik GmbH 2011
L-744e_1
35
phyCARD®-L
QuickStart Instructions
• Set the following COM parameters: Bits per second = 115200; Data bits = 8;
Parity = None; Stop Bits = 1; Flow Control = None.
• Selecting OK advances you to the COM Direct–HyperTerminal monitoring
window. Notice the connection status report in the lower left corner of the
window.
• Connect the UART (connector P1) to the computer.
• Power up the baseboard.
• You will now see some output messages from the bootloader in the
HyperTerminal window. Press space to stop the bootloader.
• Connect the cross-over Ethernet cable with the ethernet connector on the
target and the right network card of your host.
• Press ‘4’ for submenu Network Settings. Press ‘6’ to change the IP address of
the device and ‘7’ to change the network mask. Change the default settings so
it will fit to the network settings on your PC.
• Press ‘5’ to disable DHCP.
• Press ‘a’ and enter the MAC you will find upon the little label on the module.
• Press ‘0’ to go back to main menu.
• Press ‘2’ for Select Boot Device and then choose ‘1’ for LAN9115 MAC.
• Press ‘7’ to save the configuration.
• Select Target / Connectivity Options… from the Visual Studio 2005 menu
bar.
36
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Building an image
• Select Ethernet for the Download and Transport settings from the drop down
box.
• Click the Settings button on the right of the Download Drop down box. A
window will appear. Leave this window open.
• Change to the Hyperterminal window and press ‘0’ (“Exit and Continue”) on
the keyboard to start the download of the image.
• You will see some output messages followed by a BOOTME message.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
37
phyCARD®-L
QuickStart Instructions
• Go back to Visual Studio. In the window Ethernet download settings a new
entry should appear in the Active target devices list. Select the device and
close the window by pressing OK in the first window and Apply and Close in
the second one.
• Select Target / Attach Device from the Visual Studio menu bar. A download
message with a status bar should appear and the download should start.
• When the download is finished, the image should start. Calibrate the touch
panel, then navigate to the folder MyDevice\Windows. There you find your
HelloWorld application that can be executed.
In this example the image that was build is a RAM image.
• Reset the device and press space to stop the bootloader.
• Press ‘2’ for Select Boot Device and then choose ‘3’ for NK from NAND.
• Press ‘7’ to save the configuration.
38
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Building an image
• Press ‘0’ and the original image from flash will be started again.
To build an image that can be stored in flash, go to Catalog Items View and
check the entry OMAP35xxPhytec / Third Party / BSP / OMAP35xxPhytec:
ARMV4I / Drivers / Flash Image.
Rebuild the solution. Please read Appendix A “How to install Windows CE on
the phyCARD-L” for information on how to flash the image.
You have successfully finished this QuickStart.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
39
phyCARD®-L
QuickStart Instructions
6 Summary
This QuickStart Instruction gave 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 phyCARD®-L in conjunction
with WinCE.
In the Getting started section you learned how to configure your host to
provide a basis for working with your target platform. You installed the
Rapid Development Kit software and you learned to copy and run a
program on the target.
In the Getting More Involved section you got a step-by-step instruction on
how to modify the example, create and build new projects and copy output
files to the phyCARD®-L using Visual Studio 2005.
The Debugging part of this QuickStart gave you information on setting up
and using the debugger with Visual Studio 2005. You learned how to set
breakpoints, watching and changing variables content.
In the Building an Image section you learned how to build a new image
based on a preconfigured BSP and project.
40
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Appendix A
Appendix A
L Kit
How to install WindowsCE on the phyCARD-
Installing the bootloader
• Configure the jumper JP1 to boot from UART first. Close JP1 at
position 1-2.
• Connect the UART (connector P1) to the computer.
• Start the program EVM FlashTool with Start -> Programs -> Texas
Instruments -> EVMFlash3530_v2.0 -> EVMFlash GUI
The EVM FlashTool dialog opens.
• Choose link type UART, select the right port and choose baud rate
115200 and mode BOOT ROM.
• Click Download in the tree Target Board under EVM1 / EVM2
Micron NAND OMAP35xx.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
41
phyCARD®-L
QuickStart Instructions
• Select the first rider Download and there the device type NAND.
• Check Erase Entire Flash.
• In the Program section, click << Add File, add file PHYTEC\PCA-AL1_phyCARD-L\WinCE-Kit\BSP\X-Loader\bin\OMAP35xx-nandlogo.raw from the CD and set its Address to 0x20000000.
• Click Download.
• When you’ll see the Message Reset Target to proceed, power up the
baseboard.
42
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Appendix A
• When finished, power down the baseboard.
• Configure the jumper JP1 to boot with NAND Flash. Open JP1 at
position 1-2.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
43
phyCARD®-L
QuickStart Instructions
Installing the image
Start the HyperTerminal program within the Programs / Accessories bar.
The HyperTerminal main window will now appear:
Double-click on the HyperTerminal icon “Hypertrm” to create a new
HyperTerminal session.
The Connection Description window will now appear. Enter “COM Direct”
in the Name text field.
Next click OK. This creates a new HyperTerminal session named “COM
Direct” and advances you to the next HyperTerminal window.
44
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Appendix A
The COM Direct Properties window will now appear. Specify Direct to
COM1/COM2 under the Connect Using pull-down menu (be sure to
indicate the correct COM setting for your system).
Click the Configure button in the COM Direct Properties window to
advance to the next window (COM1/COM2 Properties).
• Set the following COM parameters: Bits per second = 115200; Data bits
= 8; Parity = None; Stop Bits = 1; Flow Control = None.
• Selecting OK advances you to the COM Direct–HyperTerminal
monitoring window. Notice the connection status report in the lower left
corner of the window.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
45
phyCARD®-L
QuickStart Instructions
• Connect the UART 1 (connector P1) to the computer.
• Power up the baseboard.
• You will now see some output messages from the bootloader in the
HyperTerminal window. Press space to stop the bootloader.
• Connect the cross-over Ethernet cable with the ethernet connector on the
target and the right network card of your host.
• Press ‘4’ for submenu Network Settings. Press ‘6’ to change the IP
address of the device and ‘7’ to change the network mask. Change the
default settings so it will fit to the network settings on your PC.
• Press ‘5’ to disable DHCP.
• Press ‘a’ and enter the MAC you will find upon the little label on the
module.
• Press ‘0’ to go back to main menu.
• Press ‘2’ for Select Boot Device and then choose ‘1’ for LAN9115 MAC.
• Press ‘7’ to save the configuration.
• Start Microsoft Visual Studio 2005.
• Select Target / Connectivity Options… from the Visual Studio 2005
menu bar.
• Select Ethernet for the Download and Transport settings from the drop
down box.
46
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Appendix A
• Click the Settings button on the right of the Download Drop down box.
A window will appear. Leave this window open.
• Change to the Hyperterminal window and press ‘0’ (“Exit and
Continue”) on the keyboard to start the download of the image.
• You will see some output messages followed by a BOOTME message.
• Go back to Visual Studio. In the window Ethernet download settings a
new entry should appear in the Active target devices list. Select the
device and close the window by pressing OK in the first window and
Apply and Close in the second one.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
47
phyCARD®-L
QuickStart Instructions
• Select Target / Attach Device from the Visual Studio 2005 menu bar. In
the following Select a run-time image dialog, navigate to
C:\PHYTEC\PCA-A-L1_phyCARD-L\WinCE-Kit\BSP\EBOOT and select
nk.bin. A download message with a status bar should appear and the
download should start.
• When the download is finished, the image has been downloaded in flash
and WinCE should boot automatically.
But don’t forget that the bootloader still is set for booting from ethernet!
Thus, after a reset you’ll get BOOTME messages again instead of having
WinCE being booted.
• Reset the device and press space to stop the bootloader.
• Press ‘2’ for Select Boot Device and then choose ‘3’ for NK from
NAND.
48
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Appendix A
• Press ‘7’ to save the configuration.
• Press ‘0’. Booting will now always be done from flash again.
© PHYTEC Messtechnik GmbH 2011
L-744e_1
49
phyCARD®-L
50
QuickStart Instructions
© PHYTEC Messtechnik GmbH 2011
L-744e_1
Suggestions for Improvement
Document:
WinCE-Kit with phyCARD®-L QuickStart Instructions
Document number: L-744e_1 April 2011
How would you improve this manual?
Did you find any mistakes in this manual?
Submitted by:
Customer number:
Name:
Company:
Address:
Return to:
PHYTEC Technologie Holding AG
Robert-Koch-Str. 39
55129 Mainz, Germany
Fax: +49 (6131) 9221-26
© PHYTEC Messtechnik GmbH 2011
L-744e_1
page
Published by
© PHYTEC Messtechnik GmbH 2011
Ordering No. L-744e_1
Printed in Germany
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement