Hand Held Products 5080, User Manual

Page: 25 / 64

5X80 Series Software Development Kit (SDK) User’s Guide 2 - 11
hhpSetHardwareLineDllFileName
The SDK API provides the ability to provide OEM device-dependent extensions to support the imager hardware sleep lines, and
hardware trigger and/or special COM port driver configuration/initialization. The definitions and function prototype are located in
the header file OemDll.h. Also see OEM-Configurable SDK Functionality on page 5-1.
Syntax hhpSetHardwareLineDllFileName
(
P TCHAR ptcHwrFilename
)
Parameter Description
ptcHwrFilename Name of DLL provided by OEM containing some or all of the function exports described in the header
file OemDll.h
hhpSetSymbologyDefaults
Resets an individual symbology or all symbologies to their default values.
Syntax hhpSetSymbologyDefaults
(
int nSymId
)
Parameter Description
nSymId One of the symbology enumerated types, e.g., SYM_CODE39, SYM_OCR, or SYM_ALL to default
all symbologies.
hhpUpgradeFirmware
The 5X80 SDK provides the ability to update the firmware application running on the imager. hhpUpgradeFirmware checks the
file contents to verify that it is a firmware application file before the file is downloaded to the imager. The firmware file is
transferred to the imager compressed (lossless) unless the SDK has determined that the imager is running in bootstrap code
instead of the current firmware application. In this case, the file is transferred uncompressed. This function only supports
synchronous operation, so it does not return until the firmware file has been transferred to the imager and the imager has burned
the new code into flash memory. When this function returns, the connection (host COM port) is connected at the default baud
rate of 115200.
Syntax hhpUpgradeFirmware
(
const P TCHAR ptcFirmwareFilename,
P DWORD DpdwTransferPercent,
HWND hTransferNotifyHwnd
)
Parameter Description
ptcFirmwareFilename String containing the fully qualified filename of the file that contains the code to be sent to the
imager. The file extension is usually .bin or .axf. The file is sent using an Hmodem, which is a
derivative of Xmodem 1K.
pdwTransferPercent Pointer to a DWORD that contains the current percent transferred value(0 to 100). If
pdwTransferPercent is valid, the transfer completion percent is written to it. This is updated after
each packet is sent.