SymbolicTools Port SDK 1.3 Readme

May 2003

For more information about Port SDK, please visit www.symbolictools.de.

To locate material in these Release Notes, select one of the general categories under Contents, or choose Find from the Edit menu of the browser.

Contents

• Supported Devices
• Requirements
• Installation
• Using the Emulator
• Known Issues
• Legal Information

Supported Devices

This release supports the following Pocket PC devices:

• Pocket PC's with ARM, SH3 or MIPS processor and with Microsoft® Windows® for Pocket PC or Microsoft® Windows® for Pocket PC 2002
• Emulator for Microsoft® Pocket PC 2002

Requirements

To use Port SDK 1.2, you need to have the following:

• PocketConsole installed on your Pocket PC. You can download PocketConsole from www.symbolictools.de
• A desktop computer with a Pentium class processor. A Pentium 90-MHz or higher processor is recommended.
• Microsoft Windows® 2000 Professional, Microsoft Windows NT® Workstation 4.0 (with SP5, Internet Explorer 5.01, and MDAC 2.1; all included with eMbedded Visual Tools), or Microsoft Windows® 98 Second Edition. Microsoft Windows® 2000 Professional or Microsoft Windows NT Workstation 4.0 is the recommended debug host for your development environment. The eMbedded Visual Tools can be installed on Windows 98, and you can build your application from there. However, emulation does not work on Windows 98; instead use Windows 2000 or Windows NT as your host machine.
• 64 MB memory for Windows 2000 Professional (128 MB recommended). 32 MB for Windows NT Workstation 4.0 or Windows 98 (48 MB recommended).
• CD-ROM drive compatible with multimedia desktop computer specification.
• VGA or higher-resolution monitor required. A Super VGA monitor is recommended.
• Mouse device or compatible pointing device.
• 200 MB hard disk space.
• Microsoft® Embedded Visual C++ 3.0
• Microsoft® Windows® Platform SDK for Pocket PC or Pocket PC 2002
• Microsoft® ActiveSync® 3.5

Installation

1. Close all running embedded Visual C++ instances.
2. Run PortSDK.msi by double clicking. In the following PORTSDK_ROOT will be called the directory you have choosen to install Port SDK and EVC_ROOT the directory where embedded Visual C++ is installed.
3. Move the following file from your Port SDK installation directory to your embedded Visual C++ directory:
   PORTSDK_ROOT\extra\pozard.awk --> EVC_ROOT\Common\EVC\Template
4. Start embedded Visual C++
   • Goto Tools->Options->directories
   • Add PORTSDK_ROOT\include and PORTSDK_ROOT\include\stl to the include path for your platforms
   • For all platforms PLATFORM you will support add a entry PORTSDK_ROOT\lib\PLATFORM to the library path. PLATFORM can be one of ARM, MIPS, SH3 or X86.
   • For all platforms PLATFORM you will support add a entry PORTSDK_ROOT\bin\PLATFORM to the executable path. PLATFORM can be one of ARM, MIPS, SH3 or X86.

Testing the installation

1. Make sure that PocketConsole is installed on your Pocket PC device. You can download PocketConsole from www.symbolictools.de.
2. In embedded Visual C++ clickFile->New
   In the projects tab there should be a new application wizard visible called "PocketConsole Application". Select this applcation wizard and choose a name for your project.
3. When the PocketConsole wizard dialogbox pops up, select "A hello world progam". check also the "Use Portlib" checkbox and click Ok.
4. Select your Pocket PC platform as active configuration.
5. Press Ctrl-F5 to compile and run.
6. After a few seconds there should appear a console on your Pocket PC displaying the magic words "Hello World".
7. To close the application press any key on one of your Pocket PC keyboards or clickFile->Close on the console-menu

Using PocketConsole with the Emulator

In order to use Port SDK and PocketConsole with the Pocket PC 2002 Emulator you have to perform the following steps:

• copy the PocketConsole.x86.cab file from the PORTSDK_ROOT\bin\x86\extras\emulator directory to the Emulator and execute the file inside the emulator.
• optional: copy the cmd.x86.cab file from the PORTSDK_ROOT\bin\x86\extras\emulator directory to the Emulator and execute the file inside the emulator.
• copy the portd.dll file from the PORTSDK_ROOT\bin\x86\ directory to the \windows directory of the emulator.

Known Issues

Legal Information

Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, people and events depicted herein are fictitious and no association with any real company, organization, product, person or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user.

© 2002-2003 SymbolicTools.

The names of actual companies and products mentioned herein may be the trademarks of their respective owners.