Icop VDX-6318 User manual

VDX-6318
Windows Embedded Compact 7
Getting Started Guide
Samuel Phung
Windows Embedded MVP
ICOP Technology Inc.
Screen captured with Snagit

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 2
Table of Contents
Introduction .................................................................................................................................................. 6
Part 1 –Development Environment Overview ............................................................................................. 7
Windows Embedded Compact 7 .............................................................................................................. 7
Windows Embedded Compact 7 –Platform Builder................................................................................ 7
Windows Embedded Compact 7 Remote Tools ....................................................................................... 7
Visual Studio 2008 Integrated Development Environment...................................................................... 8
Develop Compact 7 Devices: Typical Development Steps....................................................................... 8
Develop Compact 7 Applications with VS2008......................................................................................... 9
Silverlight for Windows Embedded .......................................................................................................... 9
The Target Device..................................................................................................................................... 9
Common Terminology ............................................................................................................................11
Compact 7 Environment and Directory Variables ..................................................................................12
OEM Environment Variables ..................................................................................................................12
Part 2 –Development Environment Connectivity ......................................................................................13
Ethernet Connectivity.............................................................................................................................13
Develop Compact 7 OS Run-time Image –OS Design.................................................................... 13
Develop Compact 7 Applications with Visual Studio .....................................................................13
Serial Debug Connectivity....................................................................................................................... 13
Development Environment Setup with DHCP........................................................................................14
Using Wireless Access Point Router ....................................................................................................... 14
Development Environment Setup with Static IP ....................................................................................15
Local Area Network without DHCP Service.................................................................................... 15
Direct Connection using Cross-Over RJ-45 Ethernet Cable............................................................15
Static IP Addresses ......................................................................................................................... 15
Part 3 –Required Software & Installation .................................................................................................. 16
Recommended Software Installation Sequence .................................................................................... 16
Windows Embedded Compact 7 Installation .........................................................................................16
Board-Support-Package Installation.......................................................................................................17
SDK Installation....................................................................................................................................... 18
AutoLaunch Component Installation......................................................................................................18
CoreCon Connectivity Component................................................................................................... 18
Part 4 –OS Design (Platform Builder Project) ............................................................................................19
Visual Studio 2008 .................................................................................................................................. 19
Windows Embedded Compact 7 OS Design Wizard............................................................................... 19

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 3
OS Design Wizard –Board Support Package (BSP).................................................................................20
OS Design Wizard –Design Templates ...................................................................................................21
OS Design Wizard –Applications & Media............................................................................................. 21
OS Design Wizard –Networking & Communications.............................................................................22
Security Warning - Catalog Item Notification.........................................................................................23
Part 5 –Configure and Customize Compact 7 OS Design ........................................................................... 24
Customize the OS Design –Add Additional Components ...................................................................... 24
Customize the OS Design –Locate Component by Search..................................................................... 29
Customize the OS Design –Configuration Manager ..............................................................................30
Customize the OS Design –Build Options .............................................................................................. 31
Customize the OS Design –The Registry ................................................................................................ 32
Registry Entries for FTP Server Component................................................................................... 32
Registry Entries for the Telnet Server Component........................................................................ 32
Registry Entries for the AutoLaunch Component.......................................................................... 32
Adding Registry Entries to OS Design ............................................................................................ 33
Static IP Address ..................................................................................................................................... 33
Other Compact 7 Components...............................................................................................................34
Part 6 –Build and Generate Compact 7 OS Run-time Image .....................................................................35
The Build Process –Starting ...................................................................................................................35
The Build Process –Completed .............................................................................................................. 35
Part 7 –Download Compact 7 OS Run-time to Target Device.................................................................... 37
Target Device Preparation......................................................................................................................37
Create Connectivity Profile for a Target Device .....................................................................................38
Associate VDX-6318 to MyTargetDevice Connectivity Profile ............................................................... 39
Download Compact 7 OS Run-time Image to VDX-6318........................................................................ 42
Deploy Compact 7 OS Run-time Image to Target Device....................................................................... 43
Part 8 –Software Development Kit (SDK)................................................................................................... 45
Create and Configure Compact 7 SDK .................................................................................................... 45
Build and Generate Compact 7 SDK ....................................................................................................... 47
Part 9 –Develop Native Code App with VS2008.........................................................................................48
Create a New Native Code Application Project......................................................................................48
Add Codes and Build the Application Project.........................................................................................51
Preparing Target Device to Connect to VS2008 IDE...............................................................................52
Configure VS2008 Device Connectivity Settings..................................................................................... 54
Establish Connectivity to Compact 7 Target Device ............................................................................... 56

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 4
Download Application to Target Device.................................................................................................57
Part 10 –Develop Managed Code App with VS2008..................................................................................58
Create a New Managed Code Application Project .................................................................................58
Add Codes and Build the Application Project.........................................................................................60
Preparing Target Device to Connect to VS2008 IDE...............................................................................61
Establish Connectivity to Compact 7 Target Device ............................................................................... 61
Download Application to Target Device.................................................................................................62
Debug Application Running on Target Device........................................................................................64
Part 11 –Debug and Remote Tools ............................................................................................................ 67
Download KITL Enabled Compact 7 OS Image to Target Device ............................................................68
Remote Tool: Process Viewer................................................................................................................ 68
Remote Tool: Registry Editor.................................................................................................................70
Remote Tool: System Information......................................................................................................... 71
Part 12 –Silverlight for Windows Embedded .............................................................................................73
Congratulations! –You’ve completed all the steps.................................................................................... 74
Appendix A –Development station Setup with DHCP................................................................................75
Connecting to Local Area Network with DHCP.......................................................................................75
Using Wireless Access Point Router ....................................................................................................... 75
Capturing Serial Debug Messages .......................................................................................................... 76
Appendix B –Development station Setup with Static IP ............................................................................ 77
Connecting to Ethernet Hub or Switch without DHCP ...........................................................................77
Direct Connection with Cross-Over RJ-45 Ethernet Cable......................................................................77
Static IP Address ..................................................................................................................................... 77
Capturing Serial Debug Messages .......................................................................................................... 78
Appendix C –Windows Embedded Compact Resources ............................................................................ 79
Appendix D –VDX-6318-MSJK Technical Information................................................................................82
Appendix E –Startup Options..................................................................................................................... 91
Configure the SBC to boot from USB Flash Storage ............................................................................... 91
Appendix F –BIOSLoader............................................................................................................................92
Primary BIN File.................................................................................................................................. 92
Alternative BIN File ............................................................................................................................92
BIOSLoader Configuration File for VDX-6318...............................................................................93
Appendix G –Using Static IP Address ......................................................................................................... 95
Configure Static IP for Prebuilt Compact 7 OS Run-time........................................................................ 95
Configure OS Design with Static IP Address ........................................................................................... 96

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 5
Appendix H –Deploy OS Run-time with DiskPrep ......................................................................................97
Appendix I –CoreCon Connectivity ..........................................................................................................100
Appendix J –Recover Jump Start Kit’s Original Files ................................................................................102
VDX-6318-MSJK Preconfigured Files ....................................................................................................102
Recover Files with DiskPrep.................................................................................................................. 102
Appendix K –VDX-6318 System BIOS ....................................................................................................... 104
Appendix L –Using Watchdog Timer........................................................................................................106
Using WDT0 .......................................................................................................................................... 106
Using WDT1 .......................................................................................................................................... 108
Watchdog Timer DLL: WDT.dll............................................................................................................. 109
Appendix M –Using GPIO......................................................................................................................... 110
Using the GPIO......................................................................................................................................110
Windows Embedded CE Sample Codes .......................................................................................110
Configure GPIO to Output Mode ................................................................................................. 111
Configure GPIO to Input Mode .................................................................................................... 112
GPIO.DLL ......................................................................................................................................113

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 6
Introduction
This Windows Embedded Compact 7 (Compact 7) getting started guide, with hands-on exercises, is
written in step-by-step format to show how to create a Compact 7 OS design, build customized OS run-
time image from the OS design, configure the development environment to download the OS run-time
image to a target device, develop Compact 7 applications using the Visual Studio 2008 (VS2008)
Integrated Development Environment (IDE).
The following subjects are covered in this guide:
Development environment overview
Required software and recommended installation sequences
Develop and configure Compact 7 OS design project
Build customized Compact 7 OS run-time image
Establish connectivity and download OS run-time image to target device
Develop VS2008 managed and native code application for Compact 7 device
Develop managed and native code applications for Compact 7 using Visual Studio 2008,
establish connectivity and download the application to target device for testing and debugging
Using Kernel Independent Transport Layer (KITL) and Remote Tools to debug Compact 7 OS run-
time on a target device
While it’s possible to use a Virtual PC as the target device and work through similar exercises, using a
real hardware provides a practical environment, and helps improve the learning process. The VDX-6318
Single-Board-Computer (SBC), configured with the necessary software components, is used as the target
device for the exercises in this guide.
To minimize unnecessary problem caused by missing software components and improper development
environment setup, follow the recommended software installation sequences and setup provided as
part of this getting started guide to install the necessary software.
The primary objective for this guide is to show how to use Compact 7 development tools. It’s not within
this guide’s objective to talk about programming language and concept. Short and simple exercises are
used in this guide to keep the subject matter simple and easy to understand.
Update to this getting started guide and other Compact 7 resources are available from the following
URLs:
http://www.embeddedpc.net/VDX6318MSJK/
http://www.embeddedpc.net/download/VDX6318.htm

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 7
Part 1 –Development Environment Overview
The Windows Embedded Compact 7 Platform Builder (Platform Builder) development tool is a plug-in to
the Visual Studio 2008 integrated development environment (VS2008 IDE). All Compact 7 development
tasks are supported within the VS2008 IDE, a developer friendly, efficient and intuitive development
environment with templates and wizard to help simplify complicate development tasks.
Windows Embedded Compact 7
Windows Embedded Compact 7 is a hard Real-time operating system with ability to handle 32,000
concurrent processes and 2GB memory footprint for each process. Compact 7 delivers reliable,
secure performance in a small footprint package along with the latest networking, multimedia and
communications technologies. Compact 7 provides broad range of device support with enhanced
features, including robust file system, Web services for device, Silverlight for Windows Embedded,
voice over IP, network gateway configurations, platform development tool enhancements, greater
application compatibility with other Windows Embedded Compact based devices, Internet Explorer,
Windows Media CODECs, Microsoft .NET Compact Framework, and a number of other newly
supported protocols and services.
Combining large pool of production quality BSPs, device drivers, programming libraries and effective
development tools, Compact 7 provides an ideal rapid application development environment to help
create the next generation of smart, media rich, connected and service oriented devices. For more
information about Compact 7, visit:
http://www.microsoft.com/windowsembedded/en-us/products/windowsce/compact7.mspx
Windows Embedded Compact 7 –Platform Builder
Platform Builder is the development tool used to create Compact 7 OS design projects, build custom
Compact 7 OS run-time images and develop Compact 7 device drivers. It also provides the remote
tools to debug Compact 7 OS run-time image, device drivers and software components on a target
device.
Platform Builder for Compact 7 is a plug-in to the VS2008 IDE, and requires the VS2008 IDE to
function.
Note:
The previous version, Windows Embedded CE 6.0 Platform Builder, is a plug-in to the Visual Studio
2005 IDE.
For Windows CE 5.0 and earlier versions, Platform Builder was a standalone development tool.
Windows Embedded Compact 7 Remote Tools
Using remote tools provided as part of the Compact 7 development environment, you are able to
remotely debug Compact 7 OS run-time image running on a target device, built with KITL enabled.
The following remote tools are provided as part of the Compact 7 development environment:
File Viewer
Kernel Tracker
Performance Monitor
Power Monitor

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 8
Process Viewer
Profiler
Registry Editor
Resource Consumer
Resource Leak Detector
System Information
Timeline Viewer
Zoom
Visual Studio 2008 Integrated Development Environment
Visual Studio 2008 is a popular developer friendly development tool to develop broad range of
applications for different version of the Windows operating system. From the VS2008 IDE, you can
develop applications for the following Windows operating system:
Windows 7 and Windows Embedded Standard 7
Windows Vista, Windows XP and Windows XP Embedded
Windows 2003 and 2008 Server
Windows Phone 7, Windows Mobile Smartphones and Windows Embedded Handheld
devices
Windows Embedded CE 6.0 and Windows Embedded Compact 7 devices
More…
The VS2008 IDE provides a centralized development environment to develop broad range of
applications, such as:
Windows Form application
Win32, ATL and MFC project
DLL, ActiveX control, ASP.NET Web service, Windows service
SQL Server project, Console application, Class libraries
Windows Embedded Compact and Mobile Smart Device application
Windows Embedded Compact OS design
More…
Develop Compact 7 Devices: Typical Development Steps
After the hardware platform is selected, a typical Compact 7 device development project goes
through the following development phases:
Develop Compact 7 bootloader, device drivers and BSP for the selected hardware (some
hardware vendors provide device driver and BSP to support their hardware)
Create and customize an OS design project for the hardware
Build customized Compact 7 OS run-time image for the hardware
Deploy Compact 7 OS run-time image to the hardware for testing and debugging
Generate Compact 7 SDK from the OS design to support application development
Develop application for the Compact 7 device

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 9
Application development can take place concurrently, as the hardware and OS design being
fine-tuned
After the satisfied Compact 7 OS run-time image and application are created, deploy the
solution to the final hardware for distribution
Develop Compact 7 Applications with VS2008
Visual Studio 2008 supports application development for Compact 7 devices. There are multiple
options to develop Compact 7 applications using the VS2008 IDE:
Develop Native code application with Visual C++
Develop Managed code application with Visual C#
Develop Managed code application with Visual Basic
A Software Development Kit (SDK), generate from the OS design for the target device, is needed to
support native code application development for the target device using VS2008.
The Visual Studio IDE provides an efficient development environment, making it possible to
download the OS run-time image and application from the development station to the target device
for testing and debugging.
From the Visual Studio 2008 IDE with KITL and CoreCon connectivity, you are able to download OS
run-time image and application to a Compact 7 target device, launche the application, set
breakpoint and step through the codes one-line-at-a-time as the application runs on the target
device.
Silverlight for Windows Embedded
Silverlight is a user interface (UI) development framework designed to separate the graphical
presentation from the programming logic. Silverlight enables graphic designer to design the
graphical presentation for the application without the need to understanding the programming logic
and provides a structured system for the application developer and graphic designer to work
together, doing what they do best.
While the desktop and Windows Phone 7 Silverlight application’s code behind is based on managed
code, Silverlight for Windows Embedded application’s code behind is based on native code, which
provides an environment to develop small and efficient code to support embedded devices typically
built with limited hardware resources.
Silverlight for Windows Embedded enables UI designers to develop stunning UI for the device
without the need to understand complicated application code. At the same time, application
developer can focus on their core expertise, develop the application logic and leverage UI graphic
designer’s expertise to design user interface for the project.
Silverlight for Windows Embedded application for Compact 7 is developed using the combination of
C++ and XAML code, using Visual Studio 2008 and Expression Blend 3.
The Target Device
The term target device is referring to the hardware platform used in a Compact 7 development
project. For the exercises in this guide, the VDX-6318 single-board-computer (SBC) is used as the
target device.

VDX-6318 Windows Embedded Compact 7 - Getting Started Guide
Windows Embedded Compact 7 Getting Started Rev 2.00 Page 10
A VDX-6318 BSP which includes the necessary hardware adaptation codes, device drivers and
configuration files to support Compact 7 OS development, is used for the exercises in this guide to
develop the OS design project, as shown in Figure 1.
Note:
We will refer to the VDX-6318 SBC as “SBC” or “Target Device” within this getting started guide.
Fig. 1 –ICOP_VDX6318_70B BSP for Compact 7
In addition to the device drivers, the following DLLs are included as part of the BSP to help
developers access the SBC’s GPIOs and Watchdog timers:
GPIO.dll (To access the GPIOs)
WDT.dll (To access the Watchdog timers)
When developing an OS design using the ICOP_VDX6318_70B BSP, these DLLs are included to the OS
design and compile into the OS run-time image by default.
Sample native and managed code projects showing how to use these DLLs are provided on the jump
start CD-ROM.
Refer to appendix L for more information about watchdog timer.
Refer to appendix M for more information about GPIO.