Page 2
PDT 1100 Terminal DLL Guide 70-36556-01 Revision B — May 2001 Symbol Technologies, Inc. One Symbol Plaza, Holtsville N.Y. 11742...
Page 3
PDT 1100 Terminal DLL Guide 70-36556-01 Revision B May 2001...
Page 4
The software is provided strictly on an “as is” basis. All software, including firmware, furnished to the user is on a licensed basis. Symbol grants to the user a non-transferable and non-exclusive license to use each software or firmware program delivered hereunder (licensed program).
Chapter 2, DLL File Formats describes the file formats used in the Ir-Transfer Utility C and E DLL. Chapter 3, Setting up the PDT 1100 in System Mode describes how to set up the PDT 1100 to accept downloading and uploading from the host.
This warranty is provided to the original owner only and is not transferable to any third party. It shall not apply to any product (i) which has been repaired or altered unless done or approved by Symbol, (ii) which has not been maintained in accordance with any operating or handling instructions supplied by...
Shipments from the US or other locations will be made F.O.B. Symbol’s manufacturing plant. Symbol will use new or refurbished parts at its discretion and will own all parts removed from repaired products. Customer will pay for the replacement product in case it does not return the replaced product to Symbol within 3 days of receipt of the replacement product.
Chapter 1 Introduction The Dynamic Link Library for IR-Transfer Utility C V1.04 and IR-Transfer Utility E V1.02 transmits program files and data files between the PDT 1100 Terminal and the host computer. ® ® ® The DLL runs on Microsoft...
IR-Transfer Utility C DLL is a set of DLL programs which uploads and downloads program files, data files, or function files between the PDT 1100 and the host computer. This transfer is done according to the PDT 1100-IR protocol in the Windows 95 or Windows NT 3.51/4.0 environment.
Introduction The PDT 1100-IR protocol is a PDT 1100 terminal’s format for transmitting data between the PDT 1100 and the host computer. For details, refer to the PDT 1100 Product Reference Guide. Computers Available for IR-Transfer Utility C DLL IR-Transfer Utility C DLL can run on personal computers equipped with the Intel 80386 CPU or higher capability that can operate Microsoft Windows 95 or Microsoft Windows NT3.51/...
PDT 1100 Terminal DLL Guide External IR Transceivers The table below lists supported external IR transceivers and their corresponding DLL files for initializing them. To use any of these external IR transceivers, specify the corresponding DLL file using the +I option (refer to Options on page 2-7).
Ir-Transfer Utility C DLL regards MS-DOS files with the extension .PD3 as user program files (object program files). Files are developed using the PDT 1100-BASIC 3.0 Compiler. As shown, each record in a user program file is fixed to 128 bytes in length (except the last record) and suffixed by a set of CR and LF codes (CR-LF codes), 0Dh and 0Ah.
When downloading: Record length (128 bytes) Zero Codes Note: In the PDT 1100-Ir protocol, CR-LF codes that are used as record separators in data are removed before file transmission. When receiving downloaded user programs, the PDT 1100 packs two-byte ASCII characters into two 4-bit hexadecimal codes in a single byte, to improve the PDT 1100’s performance and memory...
Page 17
DLL File Formats Each record in a function file is fixed to 130 bytes in length (except the last record) and suffixed by a set of CR-LF codes, as follows. Record length (130 bytes) Record When downloading a function file, if the length of the last record is less than 130 bytes, the blank bytes (130 bytes minus last record length) are zero-filled, so that every record is 130 bytes long.
PDT 1100 Terminal DLL Guide Note: In the PDT 1100-Ir protocol, CR-LF codes that are used as record separators in data are removed before file transmission. When receiving downloaded function files, the PDT 1100 packs two- byte ASCII characters into two 4-bit hexadecimal codes in a single byte, to improve the PDT 1100’s performance and memory...
Page 19
DLL File Formats In downloading a data file, if the actual record length is less than the specified record length, the blank bytes are filled with space codes (20h); if it exceeds the specified record length, the excess is discarded. Specified Record Length Record 1 = Equal to the specified record length...
Page 20
If [Ignore] is selected (or no T option is specified), the PDT 1100 ignores space codes in the tail of a data field and data is not transferred correctly.
Specify the name of a file to be sent or received. If you set the +R option for file reception and specified “(file)” as a file name, the host computer creates a receive file with the original file name used in the PDT 1100. Note: You cannot specify more than one file name in one function. To send or receive more than one file, add more than one line of the file transfer functions.
Page 22
Determines whether to check the name of a received file. When the +R is specified, the DLL compares the file name used in the PDT 1100 with the received file name. If any discrepancy is found, an error occurs. This command switch is ignored when the -R is specified.
Page 23
DLL File Formats Table 2-1. Options (Continued) Options Functions Defaults +T, -T Determines whether to insert field separators. Inserts field separators (specified by <DelimiterChar> or <HexCode>) between fields when writing a received data file. This option should be specified in either of the following two formats.
Page 24
Specification of only +L makes the default (30 seconds) active. +X x-coordinate Specifies the x-coordinate of the PDT 1100 Sending or PDT 1100 Receiving dialog box. n=-65535 to 65535 This specifies the location of the left side of the dialog box.
DLL File Formats Start of File Transmission is initiated, the Ir Sending dialog box (when downloading) or PDT 1100-Ir It3cw32d Receiving dialog box (when uploading) is displayed, and file transmission starts. The PDT 1100-Ir Receiving appears in PDT 1100-Ir Sending uploading.
Chapter 3 Setting up the PDT 1100 in System Mode This chapter describes the PDT 1100 preparation required for using Ir-Transfer Utility C and E DLL. File Transfer in System Mode For file transfer in System Mode, use the following procedure: 1.
System Mode. For details, refer to the PDT 1100 Product Reference Guide. Select the PDT 1100-Ir protocol in the PDT 1100 when using Ir-Transfer Utility C and E DLL. The PDT 1100-Ir protocol automatically adds the serial number and horizontal parity, so other settings made in the PDT 1100 are ignored.
XFILE the PDT 1100 Programmer’s Guide. To download data files to the PDT 1100 using +C option specified in the DLL, specify the T option to the “protocolspec” of the statement to treat space codes in the tail of a data XFILE field as data.
Chapter 4 DLL Functions Ir-Transfer Utility C DLL supports the following three functions: Gets the version of the current DLL. GetIt3cDllVersion() Transfers files. ExecIt3c() Aborts the current file transfer. AbortIt3c() You can call these functions from VC++4.0 or VB4.0. For VC++4.0, include “ ”...
PDT 1100 Terminal DLL Guide GetIt3cDllVersion() Description Gets the version of the current DLL. Syntax For VC++4.0 char *GetIt3cDllVersion(char *Param); For VB4.0 Declare Function GetIt3eDclVersion Lib “It3cw32c.dll” (ByVal Param As String) As String where: Param = Character string where the version character string of the DLL is to be stored.
PDT 1100 Terminal DLL Guide Returned value “ ” For VC++4.0: for the Macro code (enum type) for the returned codes. It3capi.h. For VB++4.0: Refer to “It3cw32.bas.” for the returned code.
DLL Functions AbortIt3c() Description Aborts the current file transmission. Syntax For VC++4.0 int AbortIt3c(void); For VB4.0 Declare Function AbortIt3c Lib “It3cw32d.dll” () As Long Returned value This function returns the same value as an error code, showing the current file transfer status when it is called.
Appendix A Error Codes If an error occurs during execution of Ir-Transfer Utility C or E DLL, one of the error codes from Table 1-1 is returned. Table 1-1. Error Codes Code Description Normal end. Ir-Transfer Utility C DLL could not find the designated file. Filename entered in the wrong format.
Page 38
The correct DLL is not found. The IR device does not support the designated transmission speed. Ir-Transfer Utility C DLL was aborted by clicking the Abort button in the PDT 1100-Ir Sending (or Receiving) dialog box. Any other error has occurred.
Index IT3EAIRM.DLL ..... 1-4 It3eApi.h ......1-2 bullets .
Page 40
+A ....... . 2-8 symbol support center ....vii +B transmissionspeed .
Page 41
We’d like to know what you think about this Manual. Please take a moment to fill out this questionaire and fax this form to: (631) 738-3318, or mail to: Symbol Technologies, Inc. One Symbol Plaza M/S B-4 Holtsville, NY 11742-1300 Attn: Technical Publications Manager IMPORTANT: If you need product support, please call the appropriate cus- tomer support number provided.
Need help?
Do you have a question about the PDT 1100 and is the answer not in the manual?
Questions and answers