Page 1
www.eurotech.com
PROGRAMMER REFERENCE
Zypad WL15xx
Wearable Computer
Rev 2 – April 2012 – 110125-00022
Page 2
REVISION
DESCRIPTION
DATE
2
Initial release
Apr 2012
Disclaimer
Eurotech reserves the right to make changes in specifications and other information contained within
this document without prior notice, and the reader should in all cases consult Eurotech to determine
whether any such changes have been made. The information in this publication does not represent a
commitment on the part of Eurotech.
Eurotech shall not be liable for technical or editorial errors or omissions contained herein; nor for
incidental or consequential damages resulting from the furnishing, performance, or use of this material.
This document contains proprietary information that is protected by copyright. All rights are reserved.
No part of this document may be photocopied, reproduced, or translated into another language without
the prior written consent of Eurotech.
Trademarks
Zypad is a registered trademark of Eurotech S.p.A.
All trademarks both marked and not marked appearing in this document are the property of their
respective owners.
Document Revision History
© 2012 Eurotech Inc.
Page 3
Table of Contents
3
110125-00022
Table of Contents
Disclaimer....................................................................................................................................................... 2
Trademarks .................................................................................................................................................... 2
Document Revision History ............................................................................................................................ 2
Table of Contents ............................................................................................................................................ 3
Introduction ...................................................................................................................................................... 6
Related Documents ........................................................................................................................................ 6
About Your System ......................................................................................................................................... 7
System Block Diagram ................................................................................................................................... 7
Hardware Features ........................................................................................................................................ 8
Processor .................................................................................................................................................. 8
Memory ..................................................................................................................................................... 8
Communications ....................................................................................................................................... 8
User Interface and Display ....................................................................................................................... 8
Inputs and Outputs ................................................................................................................................... 8
Audio Interface .......................................................................................................................................... 8
Power Supply ............................................................................................................................................ 8
Persistent Memory ......................................................................................................................................... 9
System File Storage ................................................................................................................................. 9
Flash Disk ................................................................................................................................................. 9
Real-Time Clock ....................................................................................................................................... 9
System Files ................................................................................................................................................... 9
NK.BIN .................................................................................................................................................... 10
SYSLOAD.OBM ...................................................................................................................................... 10
SYSLOAD.ROM ..................................................................................................................................... 10
SYSLOAD.HWT ...................................................................................................................................... 10
SYSLOAD.BMP ...................................................................................................................................... 10
SYSLOAD.REG ...................................................................................................................................... 11
SYSLOAD.EXE ....................................................................................................................................... 11
Development Environment ........................................................................................................................... 12
Development Tools ...................................................................................................................................... 12
Distribution ................................................................................................................................................... 12
Installation .................................................................................................................................................... 12
Directory Structure ....................................................................................................................................... 13
ADSAPI ........................................................................................................................................................ 13
Visual Studio Remote Tools ......................................................................................................................... 13
Using the ZDK ................................................................................................................................................ 14
Functional Overview ..................................................................................................................................... 14
API Reference: System ................................................................................................................................. 15
System Management ................................................................................................................................... 15
Registry Keys .......................................................................................................................................... 15
Type Definitions ...................................................................................................................................... 15
ZYPAD_GetSystemInfo .......................................................................................................................... 16
ZYPAD_Shutdown .................................................................................................................................. 16
Registry Management .................................................................................................................................. 17
ZYPAD_EraseRegistry ........................................................................................................................... 17
Accelerometer .............................................................................................................................................. 18
Registry Keys .......................................................................................................................................... 18
Type Definitions ...................................................................................................................................... 18
Page 4
Zypad WL15xx - Programmer Reference
4
110125-00022
ZYPAD_Accelerometer_Enable ............................................................................................................. 18
ZYPAD_Accelerometer_Calibrate .......................................................................................................... 18
ZYPAD_GetAccelerometerAngle ........................................................................................................... 19
ZYPAD_Accelerometer_GetData8 ......................................................................................................... 19
ZYPAD_Accelerometer_GetData10 ....................................................................................................... 19
Backlight ....................................................................................................................................................... 20
Registry Keys .......................................................................................................................................... 20
ZYPAD_SetAccelerometerStatus ........................................................................................................... 20
ZYPAD_GetAccelerometerStatus .......................................................................................................... 20
ZYPAD_SetArmDownBacklightOnEnable .............................................................................................. 21
ZYPAD_GetArmDownBacklightOnEnable ............................................................................................. 21
Internal Barcode Reader .............................................................................................................................. 22
Registry Keys .......................................................................................................................................... 22
ZYPAD_SetScannerPower ..................................................................................................................... 22
ZYPAD_GetScannerPower .................................................................................................................... 22
ZYPAD_SetScannerBootPower ............................................................................................................. 23
ZYPAD_GetScannerBootPower ............................................................................................................. 23
ZYPAD_SetScannerSleepPower ........................................................................................................... 23
ZYPAD_GetScannerSleepPower ........................................................................................................... 24
ZYPAD_SetScannerHostTrig ................................................................................................................. 24
GPS .............................................................................................................................................................. 25
Registry Keys .......................................................................................................................................... 25
ZYPAD_SetGpsPower............................................................................................................................ 25
ZYPAD_GetGpsPower ........................................................................................................................... 25
ZYPAD_SetGpsBootPower .................................................................................................................... 25
ZYPAD_GetGpsBootPower .................................................................................................................... 26
ZYPAD_SetGpsSleepPower .................................................................................................................. 26
ZYPAD_GetGpsSleepPower .................................................................................................................. 26
API Reference: User Interface ...................................................................................................................... 27
Keypad ......................................................................................................................................................... 27
Registry Keys .......................................................................................................................................... 27
ZYPAD_SetDefaultKeys ......................................................................................................................... 27
ZYPAD_GetDefaultKeys ........................................................................................................................ 27
Display and Backlight Brightness ................................................................................................................. 28
Registry Keys .......................................................................................................................................... 28
ZYPAD_SetKeypadBacklightEnable ...................................................................................................... 28
ZYPAD_GetKeypadBacklightEnable ...................................................................................................... 28
ZYPAD_SetBrightnessControl ................................................................................................................ 29
ZYPAD_GetBrightnessControl ............................................................................................................... 29
ZYPAD_SetDisplayBrightness ............................................................................................................... 29
ZYPAD_GetDisplayBrightness ............................................................................................................... 30
ZYPAD_SetKeyboardBrightness ............................................................................................................ 30
ZYPAD_GetKeyboardBrightness ........................................................................................................... 30
Audio ............................................................................................................................................................ 31
Registry Keys .......................................................................................................................................... 31
ZYPAD_SetAudioProfile ......................................................................................................................... 32
ZYPAD_GetAudioProfile ........................................................................................................................ 32
ZYPAD_GetAudioProfileCaps ................................................................................................................ 33
ZYPAD_SetAudioInVolume .................................................................................................................... 33
ZYPAD_GetAudioInVolume ................................................................................................................... 33
ZYPAD_SetAudioInMute ........................................................................................................................ 34
ZYPAD_GetAudioInMute ........................................................................................................................ 34
ZYPAD_SetAudioInBoost ....................................................................................................................... 34
ZYPAD_GetAudioInBoost ...................................................................................................................... 35
ZYPAD_SetAudioOutVolume ................................................................................................................. 35
ZYPAD_GetAudioOutVolume ................................................................................................................. 35
ZYPAD_SetAudioOutMute ..................................................................................................................... 36
ZYPAD_GetAudioOutMute ..................................................................................................................... 36
ZYPAD_EnableBluetoothAG .................................................................................................................. 36
Page 5
Table of Contents
5
110125-00022
ZYPAD_SetBluetoothAGVolume ............................................................................................................ 37
ZYPAD_GetBluetoothAGVolume ........................................................................................................... 37
API Reference: Communication ................................................................................................................... 38
Wi-Fi ............................................................................................................................................................. 38
Registry Keys .......................................................................................................................................... 38
ZYPAD_SetWiFiPower ........................................................................................................................... 38
ZYPAD_GetWiFiPower........................................................................................................................... 38
ZYPAD_SetWiFiBootPower ................................................................................................................... 39
ZYPAD_GetWiFiBootPower ................................................................................................................... 39
ZYPAD_SetWiFiSleepPower .................................................................................................................. 39
ZYPAD_GetWiFiSleepPower ................................................................................................................. 40
ZYPAD_SetWiFiWait .............................................................................................................................. 40
ZYPAD_ResetWiFi ................................................................................................................................. 40
ZYPAD_GetWiFiActive ........................................................................................................................... 40
ZYPAD_WiFiSimuCardRemove ............................................................................................................. 41
ZYPAD_WiFiSimuCardRmvIns .............................................................................................................. 41
Cellular ......................................................................................................................................................... 42
Registry Keys .......................................................................................................................................... 42
ZYPAD_EnableCellularPower ................................................................................................................ 42
ZYPAD_SetCellularPower ...................................................................................................................... 43
ZYPAD_GetCellularPower ..................................................................................................................... 43
ZYPAD_SetCellularRunningStatus ........................................................................................................ 43
ZYPAD_GetCellularRunningStatus ........................................................................................................ 43
ZYPAD_SetCellularBootPower .............................................................................................................. 44
ZYPAD_GetCellularBootPower .............................................................................................................. 44
ZYPAD_SetCellularSleepPower ............................................................................................................. 44
ZYPAD_GetCellularSleepPower ............................................................................................................ 45
ZYPAD_ResetCellular ............................................................................................................................ 45
ZYPAD_SetCellularAPN ......................................................................................................................... 45
ZYPAD_SendCellularATCommand ........................................................................................................ 46
Bluetooth ...................................................................................................................................................... 47
Registry Keys .......................................................................................................................................... 47
ZYPAD_SetBluetoothPower ................................................................................................................... 47
ZYPAD_GetBluetoothPower .................................................................................................................. 47
ZYPAD_SetBluetoothBootPower ........................................................................................................... 47
ZYPAD_GetBluetoothBootPower ........................................................................................................... 48
ZYPAD_SetBluetoothSleepPower .......................................................................................................... 48
ZYPAD_GetBluetoothSleepPower ......................................................................................................... 48
ZYPAD_StartBluetooth ........................................................................................................................... 48
ZYPAD_StopBluetooth ........................................................................................................................... 49
ZYPAD_ResetBluetooth ......................................................................................................................... 49
ZYPAD_GetBluetoothActive ................................................................................................................... 49
ZYPAD_SetBluetoothUseHeadset ......................................................................................................... 49
ZYPAD_GetBluetoothUseHeadset ......................................................................................................... 50
Eurotech Worldwide Presence ..................................................................................................................... 51
Page 6
Zypad WL15xx - Programmer Reference
6
110125-00022
Zypad WL15xx User Manual
110125-0000
Zypad WL15xx Quick Start
110125-0001
Introduction
The Zypad WL15xx is a wearable computer designed to give the user instant access to computing capabilities
while carrying out non-computer tasks in the field. It is based on the Marvell
Windows
®
CE 6.0 operating system. Featuring hands-free operation, robust wireless capabilities, and built-in GPS
®
PXA320 processor and supports the
tracking, this versatile wearable computer serves as an ideal tool for emergency search and rescue, healthcare,
homeland security, maintenance, law enforcement, logistics, transportation, and defence applications. Several
configurations are available allowing you to choose the hardware based on your specifications. Available
communications and localization options include cellular, GPS, Bluetooth, Wi-Fi, and barcode reader.
With the Zypad WL15xx, you can quickly and easily create a wearable device which precisely meets your
requirements. The Zypad WL15xx can be customized for your specific application at three user-type levels:
®
• End-User – Provide an out of the box operation by changing the default settings in the Windows
CE desktop
• Administer/Integrator – Create a customized configuration by modifying the system files in persistent memory
• Developer – Develop your own application using a standard Windows CE Software Development Kit (SDK) and
the Eurotech Zypad WL15xx Development Kit (ZDK)
This document describes how to customize your system at the administrator/integrator and developer levels. It
describes the system files, ZDK, and application programming interfaces (API) for handling tasks specifically
related to the Zypad WL15xx feature set. This information is intended as a reference for developing software
applications for the Zypad WL15xx series using C/C++ languages. The level of content provided assumes that the
developer is familiar with the Windows CE 6.0 operating system and the basics of the C/C++ languages.
For information about customizing at the end-user level, see the Zypad WL15xx User Manual (Eurotech document
#110125-0000).
Related Documents
The following documents are also important resources for the Zypad WL15xx. Download the standard release
documents from the support site or contact your local sales representative.
Document
Table 1. Related Documents
Check the Eurotech support site (http://support.eurotech-inc.com/
these documents.
) for errata reports and for the latest releases of
Loading...