Argox PT-9130 Owner's manual

PT-9130 Mobile Computer
SDK Programming Manual
DOC NO. UM-PT905-01
July 2015
Version 2.0
© 2010-2012 ARGOXInformationCo.,Ltd.
http://www.argox.com

PT-90 Mobile Computer SDK Programming Manual II
Table of Contents
OVERVIEW...............................................................................................................................................................................................................................2
SDKFUNCTIONS..................................................................................................................................................................................................................3
SYSAPIAX.DLL.......................................................................................................................................................................................................................4
AUDIORELATEDFUNCTIONS..................................................................................................................................................................................9
Audio_GetVolume..........................................................................................................................................................................9
Audio_SetVolume.........................................................................................................................................................................10
BATTERYRELATEDFUNCTION............................................................................................................................................................................ 11
GetBatteryStatus............................................................................................................................................................................11
DISPLAYRELATEDFUNCTIONS........................................................................................................................................................................... 13
BacklightOn...................................................................................................................................................................................13
Display_QueryBacklightIntensity..........................................................................................................................................14
GetBacklightStatus......................................................................................................................................................................16
PowerOnLCD..............................................................................................................................................................................17
SetBacklightPWM.......................................................................................................................................................................18
EnableTouchPanel......................................................................................................................................................................19
GetTouchPanelStatus.................................................................................................................................................................20
KEYPAD RELATEDFUNCTIONS...........................................................................................................................................................................21
EnablePowerButton...................................................................................................................................................................21
GetKeypadAlphaMode.............................................................................................................................................................22
SendKbdVirtualKey....................................................................................................................................................................23
SetKeypadAlphaMode..............................................................................................................................................................24
LEDRELATEDFUNCTIONS..................................................................................................................................................................................25
GetKeypadLEDStatus...............................................................................................................................................................25
GoodReadLEDOn.....................................................................................................................................................................26
KeypadLEDOn............................................................................................................................................................................27
QueryKeypadLEDIntensity.....................................................................................................................................................28
SetKeypadPWM..........................................................................................................................................................................30
SYSTEMRELATEDFUNCTIONS............................................................................................................................................................................ 31
CallSuspend...................................................................................................................................................................................31
EnableAutoConnect...................................................................................................................................................................32
RegisterAlphaKeyNotification................................................................................................................................................33
ShowChineseIME.......................................................................................................................................................................34
ShowDesktop................................................................................................................................................................................35
ShowExploreToolbar..................................................................................................................................................................36
ShowTaskbar.................................................................................................................................................................................37

PT-90 Mobile Computer SDK Programming Manual III
UnRegisterAlphaKeyNotification..........................................................................................................................................38
RegisterTriggerKeyNotification..............................................................................................................................................39
UnregisterTriggerKeyNotification.........................................................................................................................................40
VIBRATORRELATEDFUNCTIONS........................................................................................................................................................................41
VibratorOn.....................................................................................................................................................................................41
WLANRELATEDFUNCTION...............................................................................................................................................................................42
WL_Enable....................................................................................................................................................................................42
WL_Disable...................................................................................................................................................................................43
BLUETOOTHRELATEDFUNCTION.....................................................................................................................................................................44
BT_On.............................................................................................................................................................................................44
BT_Off..............................................................................................................................................................................................45
SetDiscoverMode........................................................................................................................................................................46
GetDiscoverMode.......................................................................................................................................................................47
SetSPPService...............................................................................................................................................................................48
GetSPPService.............................................................................................................................................................................49
SetFTPService..............................................................................................................................................................................50
GetFTPService.............................................................................................................................................................................51
SetFTPWriteable..........................................................................................................................................................................52
GetFTPWriteable........................................................................................................................................................................53
SetFTPShareFolder....................................................................................................................................................................54
GetFTPShareFolder..................................................................................................................................................................55
InitSearchBTDevice....................................................................................................................................................................56
FindNextBTDevice.....................................................................................................................................................................57
EndSearchBTDevice..................................................................................................................................................................59
InitSearchFTPDevice.................................................................................................................................................................60
FindFirstFTPDevice..................................................................................................................................................................61
FindNextFTPDevice..................................................................................................................................................................63
PairDevice......................................................................................................................................................................................65
UnPairDevice...............................................................................................................................................................................66
GetComInfo...................................................................................................................................................................................67
ConnectDevice.............................................................................................................................................................................69
GetConnectStatus........................................................................................................................................................................70
GetSPPClientChannel...............................................................................................................................................................71
FindFirstFTPFile........................................................................................................................................................................72
FindNextFTPFile........................................................................................................................................................................73
GetFTPFile....................................................................................................................................................................................74
PutFTPFile....................................................................................................................................................................................75
CreateFTPFolder........................................................................................................................................................................76
DeleteFTPFolder........................................................................................................................................................................77

PT-90 Mobile Computer SDK Programming Manual IV
DeleteFTPFile..............................................................................................................................................................................78
CAMERARELATEDFUNCTION............................................................................................................................................................................79
Camera_On..................................................................................................................................................................................79
Camera_Off...................................................................................................................................................................................80
SetPreviewSize..............................................................................................................................................................................81
GetPreviewSize.............................................................................................................................................................................82
EnablePreview..............................................................................................................................................................................83
SetStillCaptureSize.......................................................................................................................................................................84
GetStillCaptureSize......................................................................................................................................................................85
StartStillCapture............................................................................................................................................................................86
SetFlash...........................................................................................................................................................................................87
GetFlash..........................................................................................................................................................................................88
SetDarkMode................................................................................................................................................................................89
GetDarkMode..............................................................................................................................................................................90
SetInvert...........................................................................................................................................................................................91
GetInvert..........................................................................................................................................................................................92
GPRSRELATEDFUNCTION..................................................................................................................................................................................93
GPRS_On......................................................................................................................................................................................93
GPRS_Off.......................................................................................................................................................................................94
GetGPRSPowerStatus..............................................................................................................................................................95
SendATCommand......................................................................................................................................................................96
GetATResponse............................................................................................................................................................................97
GetIMEINumber.........................................................................................................................................................................98
GetIMSINumber..........................................................................................................................................................................99
GetModuleInfo...........................................................................................................................................................................100
GetSignalQuality........................................................................................................................................................................101
ConnectRAS................................................................................................................................................................................102
DisconnectRAS...........................................................................................................................................................................103
GetRASConnStatus...................................................................................................................................................................104
CreateRASEntry.........................................................................................................................................................................105
DeleteRASEntry.........................................................................................................................................................................106
ChangeRASEntryName.........................................................................................................................................................107
ChangeRASEntryProperty....................................................................................................................................................108
GetRASEntryProperty.............................................................................................................................................................109
GetRASEntryCount..................................................................................................................................................................110
MenuRASEntries........................................................................................................................................................................111
GetPINCounter..........................................................................................................................................................................112
GetPINStatus...............................................................................................................................................................................113
SetPINLock..................................................................................................................................................................................114

PT-90 Mobile Computer SDK Programming Manual V
GetPINLockStatus.....................................................................................................................................................................115
CheckPINCode..........................................................................................................................................................................116
CheckPUKCode.......................................................................................................................................................................117
ChangePINCode.......................................................................................................................................................................118
ReadPhonebook.........................................................................................................................................................................119
WritePhonebook........................................................................................................................................................................120
DeletePhonebook......................................................................................................................................................................121
ReadMultiPhonebook..............................................................................................................................................................122
GetPhonebookTotal..................................................................................................................................................................124
GetPhoneMaxLength..............................................................................................................................................................125
SendSMS.......................................................................................................................................................................................126
ReadSMS......................................................................................................................................................................................127
DeleteSMS....................................................................................................................................................................................129
ReadMultiSMS...........................................................................................................................................................................130
WriteStorageSMS......................................................................................................................................................................132
SendStorageSMS.......................................................................................................................................................................133
GetSMSTotal...............................................................................................................................................................................134
SetSMSCentre.............................................................................................................................................................................135
GetSMSCentre............................................................................................................................................................................136
SMS_Register..............................................................................................................................................................................137
SMS_UnRegister.......................................................................................................................................................................138
GPS..............................................................................................................................................................................................................................139
BLUETOOTHSTRUCTURE....................................................................................................................................................................................140
CONNECT_INFOStructure................................................................................................................................................140
FTP_FILEStructure................................................................................................................................................................141
GPRSSTRUCTURE................................................................................................................................................................................................142
RAS_ENTRYStructure............................................................................................................................................................142
PHONEBOOK_INFOStructure.......................................................................................................................................144
SMS_INFOStructure...............................................................................................................................................................145
RFID.DLL................................................................................................................................................................................................................................146
RFIDRELATEDFUNCTION.................................................................................................................................................................................148
OpenComPort............................................................................................................................................................................148
CloseComPort............................................................................................................................................................................149
GetFWVersion............................................................................................................................................................................150
APIVersion....................................................................................................................................................................................151
SetWorkingType..........................................................................................................................................................................152
AntennaContro...........................................................................................................................................................................153
Inventory15693...........................................................................................................................................................................154

PT-90 Mobile Computer SDK Programming Manual VI
ReadSingleBlock........................................................................................................................................................................155
WriteSingleBlock........................................................................................................................................................................156
WriteAFI........................................................................................................................................................................................157
WriteDSFID................................................................................................................................................................................158
LockAFI........................................................................................................................................................................................159
LockDSFID.................................................................................................................................................................................160
LockBlock.....................................................................................................................................................................................161
TagSystemInfo.............................................................................................................................................................................162
TagStayQuiet................................................................................................................................................................................163
TagSelect.......................................................................................................................................................................................164
TagResetToReady......................................................................................................................................................................165
OpenCard14443A....................................................................................................................................................................166
ReadMifareBlock.......................................................................................................................................................................167
WriteMifareBlock.......................................................................................................................................................................168
ReadUltraLightBlock...............................................................................................................................................................169
WriteUltraLightBlock...............................................................................................................................................................170
GetUid14443B...........................................................................................................................................................................171
SRIX4KChipID..........................................................................................................................................................................172
SRIX4KReadBlock...................................................................................................................................................................173
SRIX4KWriteBlock...................................................................................................................................................................174
RFIDREQUESTFLAGS.........................................................................................................................................................................................175
SRIX4KFLOWCHART........................................................................................................................................................................................176
SCANAPIAX.DLL.............................................................................................................................................................................................................177
API_SCANRELATEDFUNCTIONS.................................................................................................................................................................180
API_Register...............................................................................................................................................................................180
API_Unregister..........................................................................................................................................................................181
API_GetBarData......................................................................................................................................................................182
API_GetBarDataLength........................................................................................................................................................184
API_GetBarType.......................................................................................................................................................................185
API_GetError.............................................................................................................................................................................186
API_GetSysError......................................................................................................................................................................187
API_GoodRead.........................................................................................................................................................................188
API_LoadSettingsFromFile..................................................................................................................................................189
API_Reset.....................................................................................................................................................................................190
API_ResetBarData...................................................................................................................................................................191
API_SaveSettingsToFile..........................................................................................................................................................192
API_SaveSettingsToScanner.................................................................................................................................................193
S2K_IsLoad.................................................................................................................................................................................194

PT-90 Mobile Computer SDK Programming Manual VII
S2K_Load....................................................................................................................................................................................195
SCAN_QueryStatus..................................................................................................................................................................196
SCAN_SendCommand...........................................................................................................................................................197
SCAN_ResumeSystem............................................................................................................................................................198
SCAN_BatchSetting.................................................................................................................................................................199
SCAN_BatchRead....................................................................................................................................................................200
SCAN2KEYRELATEDFUNCTIONS...................................................................................................................................................................201
PT_OpenScan2Key.................................................................................................................................................................201
PT_CloseScan2Key.................................................................................................................................................................202
PT_SetToDefault........................................................................................................................................................................203
SCANNERRELATEDFUNCTIONS.......................................................................................................................................................................204
PT_EnableScanner...................................................................................................................................................................204
PT_DisableScanner.................................................................................................................................................................205
PT_CheckBarcodeData.........................................................................................................................................................206
PT_GetBarcodeData...............................................................................................................................................................207
PT_SetDefault.............................................................................................................................................................................209
SCANKEYRELATEDFUNCTIONS.....................................................................................................................................................................210
EnableTriggerKey.....................................................................................................................................................................210
GetLibraryVersion.....................................................................................................................................................................211
GetTriggerKeyStatus................................................................................................................................................................212
PressTriggerKey.........................................................................................................................................................................213
TriggerStatus................................................................................................................................................................................214
SCANSTRUCTURE..................................................................................................................................................................................................215
ScannerSettingStructure..........................................................................................................................................................215
GeneralSettingStructure..........................................................................................................................................................218
Code11_SettingStructure........................................................................................................................................................219
Code39_SettingStructure.......................................................................................................................................................220
Code93_SettingStructure.......................................................................................................................................................221
Code128_SettingStructure.....................................................................................................................................................222
Codabar_SettingStructure.....................................................................................................................................................223
EAN8_SettingStructure...........................................................................................................................................................224
EAN13_SettingStructure........................................................................................................................................................225
Industrial25_SettingStructure...............................................................................................................................................226
Interleaved25_SettingStructure............................................................................................................................................227
MSI_SettingStructure...............................................................................................................................................................228
UK_SettingStructure................................................................................................................................................................229
Telepen_SettingStructure........................................................................................................................................................230
UPCA_SettingStructure.........................................................................................................................................................231
UPCE_SettingStructure.........................................................................................................................................................232

PT-90 Mobile Computer SDK Programming Manual VIII
Matrix25_SettingStructure.....................................................................................................................................................233
UEGeneral_SettingStructure................................................................................................................................................234
IATA25_SettingStructure........................................................................................................................................................235
Trioptic_SettingStructure........................................................................................................................................................236
RSS_SettingStructure...............................................................................................................................................................237
SCANCOMMANDTABLE.......................................................................................................................................................................................238
FUNCTIONRETURNVALUES.............................................................................................................................................................................246

PT-90 Mobile Computer SDK Programming Manual 2
Overview
The Argox PT-90 Mobile Computer Software Developer Kit (SDK) Programming Manual is
prepared to assist programmers on developing application programs using Argox PT-90 Mobile
Computers under Microsoft® Windows® CE6.0 Operating System. It gives all the details needed
to call functional subroutines controling the devices on the Argox PT-90 Mobile Computer or
access value-added devices on board such as Scanning and Wireless module.
This Programming Manual is organized as two major sections, one for the system related functions
and the other for value-added scanning functions with the following information:
Argox Mobile Computer standard Application Programming Interface (API) Definitions
for system related functions:
Audio
Display
Keypad
Led and Vibrator Indicators
Battery Status
System Settings
Bluetooth
WLAN
Argox Scanning module Application Programming Interface (API) Definitions
API definitions illustrate how to call a given functional subroutine. The API definitions are
structed with information including: prototypes, parameters, return values, examples, and
requirements of each API. The “Requirements” section gives information on whether or not a
device supports a specific API function and the files to be included.

PT-90 Mobile Computer SDK Programming Manual 3
SDK Functions
When using SDK to develop their own application program, the programmer should link DLL file
or LIB file, then, include header file SYSAPIAX.H.
The following two examples are given to show how to use LIB file and DLL file while developing
an application program. We will use Visual Studio 2005 to illustrate.
Example 1: Using LIB file.
First, programmer should include sysapiax.lib in the application project.
#include "Sysapiax.h"
main()
{
. . . . .
SetBacklightPWM(100, 100);
. . . . .
}
Example 2: Using DLL file.
HINSTANCE dllHandle = NULL;
typedef DWORD (_stdcall *pfnSetBacklightPWM)(int nACPowerPercent, int
nBatteryPercent);
pfnSetBacklightPWM m_SetBacklightPWM;
main()
{
dllHandle = LoadLibrary(L"SYSAPIAX.dll");
m_SetBacklightPWM = (pfnSetBacklightPWM) ::GetProcAddress(dllHandle,
_T("SetBacklightPWM"));
m_SetBacklightPWM(0, 0);
FreeLibrary(dllHandle);
}