Psion EP10 User Manual

EP10

HAND-HELD COMPUTER

HDK User Manual

November 15, 2011
Part No. 8000255.A

ISO 9001 Certified
Quality Management System

© Copyright 2011 by Psion Inc.

2100 Meadowvale Boulevard, Mississauga, Ontario, Canada L5N 7J9

http://www.psion.com

This document and the information it contains is the property of Psion Inc. This document is not to be
used, reproduced or copied, in whole or in part, except for the sole purpose of assisting in proper use of
Psion manufactured goods and services by their rightful owners and users. Any other use of this docu­ment is prohibited.

Disclaimer

Every effort has been made to make this material complete, accurate, and up-to-date. In addition, changes
are periodically incorporated into new editions of the publication.

Psion Inc. reserves the right to make improvements and/or changes in the product(s) and/or the pro­gram(s) described in this document without notice, and shall not be responsible for any damages includ­ing, but not limited to, consequential damages, caused by reliance on the material presented.

Psion, the Psion logo, EP10 and the names of other products and services provided by Psion are trade­marks of Psion Inc.

Windows® and the Windows Logo are trademarks or registered trademarks of Microsoft Corporation in
the United States and/or other countries.

The Bluetooth® word mark and logos are owned by Bluetooth SIG, Inc. and any use of such marks by
Psion Inc. is under license.

All trademarks used herein are the property of their respective owners.

Return-To-Factory Warranty

Psion Inc. provides a return to factory warranty on this product for a period of twelve (12) months in accord­ance with the Statement of Limited Warranty and Limitation of Liability provided at:

http://www.psion.com/warranty

The warranty on Psion manufactured equipment does not extend to any product that has been tampered
with, altered, or repaired by any person other than an employee of an authorized Psion service organiza­tion. See Psion terms and conditions of sale for full details.

Important: Psion warranties take effect on the date of shipment.

Service and Information

Psion provides a complete range of product support services and information to its customers worldwide.
Services include technical support and product repairs. To locate your local support services, please go to:

http://www.psion.com/service-and-support.htm

To access further information on current and discontinued products, please go to the Psion Community site
and click on “Sign In” to log in. If you do not already have an account, click on “Join” to create one. If you
already have an account for our old Teknet site, your Teknet username and password should be valid on the
Psion Community site.

http://community.psion.com/support

A section of archived product information is also available online:

http://www.psion.com/products

TABLE OF

CONTENTS

Table of ContentsIntroductionTable of Contents

Chapter 1: Introduction

1.1 About This Manual..................................................................................................3

1.2 Text Conventions....................................................................................................3

1.3 About the HDK.......................................................................................................3

1.4 Development Platform..............................................................................................3

1.5 Contents of the HDK................................................................................................4

1.5.1 Files in the HDK............................................................................................4

1.6 Obtaining the HDK ..................................................................................................5

1.7 About the EP10 Hand-Held Computer.............................................................................5

Chapter 2: Hardware

2.1 Overview .............................................................................................................9

2.2 Hardware Variants ..................................................................................................9

2.2.1 Keyboard Variants.........................................................................................9

2.2.2 Barcode Scanner/Imager Variants .......................................................................9

2.2.3 WWAN Radio Variants.....................................................................................9

2.3 Processor ............................................................................................................10

2.4 Identifying Hardware................................................................................................10

2.5 LEDs..................................................................................................................10

2.6 Power Management.................................................................................................11

2.6.1 Batteries....................................................................................................11

Chapter 3: Software

3.1 Overview.............................................................................................................15

3.2 Drivers................................................................................................................15

3.2.1 Windows Drivers...........................................................................................15

3.2.2 Non-Psion Drivers .........................................................................................15

3.3 System Initialization.................................................................................................15

3.4 Registry Keys........................................................................................................15

3.4.1 Peripheral Registry Settings..............................................................................15

3.4.1.1 Device Driver Registry Keys...................................................................16

3.4.2 Software Registry Entries.................................................................................17

3.5 Peripheral Detection and Driver Loading Sequence.............................................................18

3.6 Serial (COM) Port Assignments....................................................................................19

3.7 EP10 HDK Application Development Software....................................................................19

3.7.1 Psion Mobile Devices SDK ................................................................................19

3.7.2 EP10 HDK Development Files.............................................................................19

3.7.3 EP10 HDK API Functions ..................................................................................21

3.7.3.1 Hdk7515_Open .................................................................................21

3.7.3.2 Hdk7515_Close.................................................................................22

3.7.3.3 Hdk7515_SetPower ............................................................................23

3.7.3.4 Hdk7515_GetPower............................................................................23

3.7.3.5 Hdk7515_SetPowerMode......................................................................24

3.7.3.6 Hdk7515_GetPowerMode......................................................................25

3.7.4 API Enumerations .........................................................................................26

Psion EP10 HDK User Manual

i

Table of Contents

3.7.4.1 Hdk7515_PowerMode..........................................................................26

3.7.4.2 Hdk7515_Connector........................................................................... 27

3.8 EP10 HDK Demo Application....................................................................................... 27

Chapter 4: Mechanical Considerations

4.1 Overview............................................................................................................. 31

4.2 Materials............................................................................................................. 31

4.3 HDK Mechanical Files ............................................................................................... 31

4.3.1 3D Files ..................................................................................................... 31

4.3.2 2D Files .....................................................................................................31

4.4 Peripheral Design...................................................................................................31

4.4.1 Physical Design Considerations..........................................................................31

4.4.2 USB-Serial Configuration ................................................................................. 32

Chapter 5: Connections

5.1 Overview............................................................................................................. 35

5.2 Docking Connector.................................................................................................. 35

5.3 Snap Module Connectors........................................................................................... 36

5.3.1 RV4001 Snap Module USB Connector................................................................... 36

5.3.2 RV4002 Snap Module RS-232 DB9...................................................................... 36

Appendix A: Resources

A.1 Psion User Manuals................................................................................................. A-1

A.2 Psion Downloadable Software ..................................................................................... A-1

A.3 Psion Accessory And Parts Information ..........................................................................A-1

Appendix B: EP10 Specifications

B.1 EP10 Specifications – Model No. 7515 ............................................................................. B-3

B.1.1 Hardware................................................................................................... B-3

B.1.2 Software.................................................................................................... B-3

B.1.3 Wireless Communication.................................................................................. B-4

B.1.4 Power Management.......................................................................................B-4

B.1.5 Expansion Slot.............................................................................................B-4

B.1.6 Bar Code Scanner ......................................................................................... B-4

B.1.7 Digital Camera............................................................................................. B-4

B.1.8 Voice Over IP (VOIP) ......................................................................................B-4

B.1.9 Accessories................................................................................................ B-4

B.1.10 Approvals................................................................................................... B-5

B.1.11 Environmental Specifications ............................................................................ B-5

B.2 Radio Specifications................................................................................................ B-5

B.2.1 Murata 802.11 a/b/g/n Direct Sequence Spread Spectrum Radio..................................... B-5

B.2.2 Murata Bluetooth Radio................................................................................... B-6

B.2.3 Sierra Wireless MC5728V................................................................................. B-7

B.2.4 Cinterion PH8 GSM/GPRS/EDGE/UMTS Radio ......................................................... B-7

B.3 Lithium-Ion 2400 mAh Battery Specifications................................................................... B-9

B.4 Lithium-Ion 3600 mAh Battery Specifications................................................................... B-10

B.5 Internal Imager...................................................................................................... B-10

B.5.1 EA11 Decoded 2D Imager.................................................................................. B-10

B.5.1.1 EA11 Typical Reading Distances............................................................... B-11

Psion EP10 HDK User Manual

ii

Table of Contents

Appendix C: HDK License Agreement

C.1 HARDWARE DEVELOPER KIT LICENSE AGREEMENT........................................................... C-3

C.2 GRANT OF LICENSE ................................................................................................ C-3

C.3 REQUIREMENTS, RESTRICTIONS, RIGHTS AND LIMITATIONS.................................................. C-3

C.4 HIGH RISK ACTIVITIES.............................................................................................. C-3

C.5 DISCLAIMER OF WARRANTY ...................................................................................... C-4

C.6 LIMITATION OF LIABILITY..........................................................................................C-4

C.7 COPYRIGHTS, OWNERSHIP AND PROPRIETARY RIGHTS....................................................... C-4

C.8 CONFIDENTIALITY.................................................................................................. C-4

C.9 ENDING THIS AGREEMENT ........................................................................................ C-4

C.10 GENERAL ............................................................................................................ C-4

Index ...........................................................................................I

Psion EP10 HDK User Manual

iii

INTRODUCTION

1

INTRODUCTION 1

1.1 About This Manual........................................................3

1.2 Text Conventions.........................................................3

1.3 About the HDK..........................................................3

1.4 Development Platform......................................................3

1.5 Contents of the HDK.......................................................4

1.5.1 Files in the HDK....................................................4

1.6 Obtaining the HDK........................................................5

1.7 About the EP10 Hand-Held Computer.............................................5

Psion EP10 HDK User Manual

1

1.1 About This Manual

>

This manual provides guidance on using the EP10 HDK to create peripherals that attach to the docking con­nector of the Psion EP10 hand-held computer. The manual is organised into the following chapters:

Chapter 1: Introduction

provides an overview of the EP10 Hand-Held Computer and the EP10 HDK.

Chapter 2: Hardware

describes, in general terms, the hardware of EP10.

Chapter 3: Software

gives an overview of the registry entries and API for controlling peripherals and the installa­tion of device drivers.

Chapter 4: Mechanical Considerations

describes the physical considerations of designing peripherals.

Chapter 5: Connections

describes the physical and electrical aspects of the docking connector of the EP10, and of the
connectors available on the EP10 snap modules.

Chapter 6: HDK Demo Application

describes the features and functions of the HDK Demo application program.

Appendix A: Resources

lists extra resources which may be of use in conjunction with the HDK.

Appendix B: EP10 Specifications

lists the specifications of the EP10.

Appendix C: HDK License Agreement

provides the license agreement that is assumed by using the EP10 HDK.

Chapter 1: Introduction

About This Manual

1.2 Text Conventions

The following conventions and syntax are followed throughout this document:

Note: Notes highlight additional helpful information.

Important: These statements provide important instructions or additional information that is critical

Warning: These statements provide important information that may prevent injury, damage to the

An arrow next to field description information (usually in tables) indicates a recommended or suggested
configuration setting.

to the operation of the computer or other equipment.

equipment, or loss of data.

1.3 About the HDK

The EP10 HDK (Hardware Development Kit) provides the software tools and technical information neces­sary to design and integrate peripherals for your EP10 hand-held computer.

The docking connector on the EP10 provides access to USB and serial interfaces for connecting to standard
devices (barcode scanners, imagers, RFID readers, etc.).

3D model files and 2D schematic drawings are provided which give the precise measurements needed for
designing custom devices that fit snugly with the main housing around the docking connector.

Finally, the EP10 HDK API library provides the software tools necessary to access and control the peripheral
attached to the docking connector.

1.4 Development Platform

The EP10 API library is designed for application development using Visual Studio 9 (2008).

Psion EP10 HDK User Manual

3

Chapter 1: Introduction
Contents of the HDK

1.5 Contents of the HDK

The HDK (Hardware Development Kit) for EP10 includes the following items:

• This manual.

• Installer for development files, including C header files for managing peripherals and HDK Demo appli­cation. See Section 3.7 EP10 HDK Application Development Software and Section 3.8 EP10 HDK Demo

Application for more details on these files.

• 2D drawings and 3D models of the EP10 outer shell, and existing EP10 snap modules for reference.

1.5.1 Files in the HDK

The following files are included with the EP10 Hardware Development Kit:

Table 1.1 Files in the HDK

Filename Description

Hdk7515.h EP10 HDK header file

Hdk7515Const.h EP10 HDK constants header file

7515HDK.exp EP10 HDK export file

7515HDK.lib EP10 HDK library file

7515HDK.dll EP10 HDK dynamic link library

EP10HDKDemo.exe EP10 HDK demo application

EP10HDKDemoSrc.zip Zip file containing the source code of the demo application

EP10.stp 3D step file of the EP10 external case

EP10_Case_Front.pdf 2D drawing of EP10 front case

EP10_Case_Rear.pdf 2D drawing of EP10 rear case

Serial_SnapOn.stp 3D step file of the DE9 RS-232 snap module assembly

Serial_SnapOn_Lower.pdf 2D drawing of the lower housing of the DE9 RS-232 snap module

Serial_SnapOn_Upper.pdf 2D drawing of the upper housing of the DE9 RS-232 snap module

Snap_On_Latch_Left.pdf 2D drawing of the left latch for an EP10 snap module

Snap_On_Latch_Right.pdf 2D drawing of the right latch for an EP10 snap module

USB_SnapOn_Lower.pdf 2D drawing of the lower housing of the USB snap module

USB_SnapOn_Upper.pdf 2D drawing of the upper housing of the USB snap module

USB_SnapOn.stp 3D step file of the USB snap module assembly

Serial_SnapOn_Schematics.pdf Electrical schematics of the DE9 RS-232 snap module

USB_SnapOn_Schematics.pdf Electrical schematics of the USB snap module

licenseagreement.doc Psion HDK License Agreement document

Psion EP10 HDK User Manual This document (P/N 8000255)

Software Development Files

EP10 HDK Demo Application

2D Schematic and 3D Model Files

Documentation

Psion EP10 HDK User Manual

4

1.6 Obtaining the HDK

The EP10 HDK is available for download on the Psion Community website (http://community.psion.com).
You will need an account on the website in order to download files. An account can be easily created by
clicking on the Join link in the upper right corner of the home page.

To download the HDK:

1. Click on the Downloads link in the top bar of the Community home page.

2. Click on Psion HDK in the list that appears.

3. Click on Hardware Development Kit (HDK) for EP10.

4. Click on the link to view the license agreement and download the .zip file containing the HDK files.

5. Open the .zip file and extract the files within to a folder on your PC hard drive.

To continue with installing the HDK files required for developing applications to work with your peripherals,
see Section 3.7 EP10 HDK Application Development Software.

1.7 About the EP10 Hand-Held Computer

The EP10 hand-held computer is a small and durable PDA device that has been built to withstand
challenging weather and environmental conditions. EP10 uses the Microsoft® Windows® Embedded 6.5
operating system.

For more information on the EP10 operation, refer to the EP10 Hand-Held Computer User Manual
(P/N 8000227).

Chapter 1: Introduction

Obtaining the HDK

Psion EP10 HDK User Manual

5

HARDWARE

2

HARDWARE 2

2.1 Overview..............................................................9

2.2 Hardware Variants........................................................9

2.2.1 Keyboard Variants ..................................................9

2.2.2 Barcode Scanner/Imager Variants.........................................9

2.2.3 WWAN Radio Variants................................................9

2.3 Processor ............................................................ 10

2.4 Identifying Hardware...................................................... 10

2.5 LEDs...............................................................10

2.6 Power Management.......................................................11

2.6.1 Batteries........................................................11

Psion EP10 HDK User Manual

7

2.1 Overview

This chapter gives an overview of the hardware of EP10.

2.2 Hardware Variants

2.2.1 Keyboard Variants

EP10 has three standard variants for the keyboard layout: numeric, QWERTY and AZERTY.

Numeric Keyboard

This numeric keyboard has the number keys arranged telephone-style, with the numbers 1,2,3 along the top
row. The alphabetic characters are also arranged telephone-style, in groups of 3 or 4 [FN]-shifted charac­ters on the number keys.

QWERTY Keyboard

This alphabetic keyboard has the alpha keys arranged in standard QWERTY layout. The number keys are ac­cessed as [FN]-shifted characters on the left-middle side of the keyboard, and are arranged tele­phonic-style, with the numbers 1,2,3 along the top row (on the E, R, and T keys, respectively).

AZERTY Keyboard

This alphabetic keyboard has the alpha keys arranged in the AZERTY layout favoured by many
French-speaking parts of Europe. It is identical to the QWERTY keyboard in all respects except that the loca­tions of the Q and W keys are interchanged with the A and Z keys, respectively.

Chapter 2: Hardware

Overview

2.2.2 Barcode Scanner/Imager Variants

EP10 comes standard with no barcode scanner/imager installed. An optional EA11 2D imager is available.
Specifications of the EA11 imager can be found in Appendix B: “EP10 Specifications”.

2.2.3 WWAN Radio Variants

The EP10 is available with one of the following Wireless WAN (WWAN) radio options:

• Cinterion PH8 GSM/UMTS (worldwide)

• Sierra Wireless MC5728v CDMA Sprint (US)

• Sierra Wireless MC5728v CDMA Verizon (US)

Specifications of these radios can be found in Appendix B: “EP10 Specifications”.

Psion EP10 HDK User Manual

9

Chapter 2: Hardware

Main Board

CPU

AM 3715

Power Supply

And Charger

Display

Proconn

(U)SIM

WAN

(PH8)

(Sierra)

MicroSD

Camera

SysCon

RTC

Audio Codec

POP

mDDR

256MB

eMMC

2GB

WI-FI a/b/g/n

Bluetooth

GPS

Star IV

SPI

FLASH

Speaker

Co-extistence

WAN

Antenna

5G

Antenna

GPS

Antenna

I2S

I2C

PCM

Keyboard

Data

Capture

Display Module

Speaker

Camera Modu le

Sharp LCD

3.7" with
Touch panel

3Mpix

Flash

LED x 2

Docking Port

LED Backlight

Microphone

I2C

USB OTG

USB Host 2.0

Power In/O ut

S Modules

(USB/RS232)

Vehicle Cr adles

Desk Dock

Quad Dock

2D imager

EA11

Sensor

2.4G
Antenna

Sensor

Imager

Receiver

Receiver

I/O

WAN 2'nd

Antenna

GPS 2'nd

Antenna

Light Sensor

+ Proximit y

Accelerometer

+ Compass

Gyroscope

Side Key

Buttons

SDIO

UART

UART

High

Speed

USB

PHY

USB

USB

SDIO

SDIO

I2C

VibratorIndicators

Indicators

LED x 3

Vibrator

Dual MIPI

To CIF

Camera to

MIPI Conver ter

MIPI

Camera Interface

MIPI

Display I nterface

Camera Interface

MIC

Keyboard

MIC

Side Key

Buttons

Quad Batter y

Charger

CLA

AC

Wall

Adpt

Battery

Fuel

Gauge

AC

brick

Adpt

SIM/SD

Socket

Radios

Processor

2.3 Processor

EP10 is built around a Texas Instruments AM3715 800MHz ARM Cortex-A8 processor.

2.4 Identifying Hardware

An overview of the operating system and the installed hardware on EP10 can be viewed by opening the
System applet in the Windows Control Panel.

2.5 LEDs

Three LEDs are located on the upper-right side of the EP10, just above the display. When you press the

Power button, the LED flashes yellow to indicate that the EP10 has been powered up.

10

Psion EP10 HDK User Manual

Chapter 2: Hardware

Power Management

Keep in mind that the application running on the EP10 can dictate how the application LED operates.
Review the documentation provided with your application to determine LED behaviour.

Table 2.1 Function of EP10 LEDs

LED Function

Green/Yellow/Red Charge LED
(left-most LED)

Yellow Application LED (centre LED) Application LED. The behaviour of this LED is application dependent.

Blue Radio Power LED (right-most LED) Radio power indicator.

Charge indicator, when connected to an external power supply. See the
table below for descriptions of Charge LED behaviour.

If the EP10 is attached to an external power supply (through a snap module or dock), the charge LED (the
left-most LED) reflects the battery charge status.

Table 2.2 EP10 Charge LED Behaviour

Charging Status LED Colour LED Flash Rate Duty Cycle

No external power detected. Not applicable OFF Not applicable

Battery charge complete. GREEN Solid ON Continuous

Battery charging normally. GREEN Slow Regular

Battery not charging because battery
temperature is outside the allowable
range: 0° C to 40° C, 32° to 104° F.

Battery charge failure. Unable to read
battery or non Psion battery.

YELLOW Normal Regular

RED Solid ON Continuous

2.6 Power Management

EP10 is powered by a lithium-ion rechargeable battery pack and can also be powered from external power.
When EP10 is powered from external power, the battery pack also charges.

Use only power sources recommended or sold by Psion for EP10.

2.6.1 Batteries

Two Lithium-Ion battery pack variants are available for the EP10: High Capacity 3600 mAh battery pack,
Model Number RV3010 and Standard Capacity 2400 mAh battery pack, Model Number RV3005. For more
details on battery safety, charging and usage, refer to the EP10 Hand-Held Computer User Manual
(P/N 8000227).

Psion EP10 HDK User Manual

11

SOFTWARE

3

SOFTWARE 3

3.1 Overview............................................................. 15

3.2 Drivers.............................................................. 15

3.2.1 Windows Drivers................................................... 15

3.2.2 Non-Psion Drivers.................................................. 15

3.3 System Initialization...................................................... 15

3.4 Registry Keys..........................................................15

3.4.1 Peripheral Registry Settings............................................ 15

3.4.1.1 Device Driver Registry Keys......................................16

3.4.2 Software Registry Entries............................................. 17

3.5 Peripheral Detection and Driver Loading Sequence.................................... 18

3.6 Serial (COM) Port Assignments................................................ 19

3.7 EP10 HDK Application Development Software....................................... 19

3.7.1 Psion Mobile Devices SDK............................................. 19

3.7.2 EP10 HDK Development Files........................................... 19

3.7.3 EP10 HDK API Functions.............................................. 21

3.7.3.1 Hdk7515_Open.............................................. 21

3.7.3.2 Hdk7515_Close..............................................22

3.7.3.3 Hdk7515_SetPower...........................................23

3.7.3.4 Hdk7515_GetPower...........................................23

3.7.3.5 Hdk7515_SetPowerMode........................................24

3.7.3.6 Hdk7515_GetPowerMode........................................25

3.7.4 API Enumerations..................................................26

3.7.4.1 Hdk7515_PowerMode..........................................26

3.7.4.2 Hdk7515_Connector...........................................27

3.8 EP10 HDK Demo Application.................................................27

Psion EP10 HDK User Manual

13