background image

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

..

..

..

..

.

Infinite Peripherals, Inc.

Page 10

www.ipcprint.com
Version 2.00

  

Blackberry Devices

The Blackberry SDK and Shared Library is designed to aid software engineers in the
development of C++ and Java OS applications to be used with the PP-50 thermal
printer.  The PP-50 Shared Library is compatible with Blackberry Handheld SDK 2.5.0
and Blackberry JDE.

The following configuration is required to use the Printer SDK/Shared Library with the
development systems mentioned above.

Blackberry C++ SDK:

This SDK provides all required information about BlackBerry Library
"GSDK.DLL" including sample code for quick and easy implementation in the
different Integrated Development Environments (IDE) while developing your
own application with printing ability.

Blackberry Java SDK:

This SDK provides all required information about BlackBerry Library
"BBerrySDK.jar" including sample code for quick and easy implementation in
the different Integrated Development Enviroments (IDE) while developing your
own palm application with printing ability. To use this SDK please copy the file
to your project's folder, then add it from the project properties and include the
following line to the code: import sdk.BBerrySDK.*;

Note:  For more information, a set of readme and Reference.html files is with the SDK

of each of the mentioned IDE above.

Summary of Contents for PP-50

Page 1: ... F I N I T E S O L U T I O N S F R O M ATLANTA CHICAGO DALLAS LOS ANGELES NEW YORK PP 50 P D A P r i n t e r Developer s I N F I N I T E P E R I P H E R A L S Manufactured by Datecs Guide www ipcprint com ...

Page 2: ...m OS 9 Falch NET DeveloperStudio 9 AppForge 9 Satellite Forms 9 Blackberry Devices 10 Blackberry C SDK 10 Blackberry Java SDK 10 Pocket PC Devices 11 PocketPC iPAQ Driver SDK ARM 11 Direct Control Method 12 PP 50 Resident Commands List 13 Commands Details 15 PP 50 Serial Port Pin Assignments 30 PP 50 Carrier Pin Assignments 31 Pin Assignments for the PP 50 Palm III carrier 31 Pin Assignments for t...

Page 3: ... Infinite Peripherals Inc Page 2 www ipcprint com Version 2 00 Appendix A 32 Card Reader Example Code 32 Appendix B 33 External Function Example Code 33 Appendix C 34 Serial Cable Examples 34 ...

Page 4: ...Size 384 x 240 Printing columns Font A C 32 columns Font B D 42 columns Serial Communications Default 57600 N 8 1 Baud Parity Data Bits Stop Bit Using Hardware Handshaking Power supply Rechargeable battery pack 7 2V 1 3 1 5 or 1 8 AH Battery capacity 4 Rolls Alpha numeric data AC DC adapter 12V 0 5A Environment Operating temp 0 C 45 C 10 90 RH Storage temp 25 C 70 C 10 90 RH Reliability 50 Million...

Page 5: ... and 5400 series PP 50 Treo Treo 180 and 270 PP 50 B957 Blackberry 957 PP 50 B5810 Blackberry 5810 The PP 50 can be used in a variety of applications were hardcopy printouts and magnetic card reading is required ü End Users to print from standard palm applications Date Book Address To Do and Memo as well as freely resizable screen images generated by any PALM OS application or selected parts of it...

Page 6: ...method use is limited by the Driver or SDK s compatibility with the various application development tools See section on your device for details on Driver and SDK compatibility For example if the development tool you are using is not compatible with the SDK then controlling the PP 50 can be accomplish by the Direct Control method that access the PP 50 resident commands directly PP 50 printer Resid...

Page 7: ...howing how this is accomplish using the PP 50 Driver SDKs and Direct Control methods The application calls the Driver SDK MCR API or sends the PP 50 internal MCR command depending on method used to communicate with the PP 50 Within the application a storage variable is defined and used to store returned data The read data can then be process for further use by the applications See Driver SDK docum...

Page 8: ...al port interfaces with both the PDA device and External device Because of this configuration special functions in the SDK are use to direct the flow of data so that it can be process correctly by the intended device Notes Care must be taken when connecting external device to the PP 50 serial port as damage to port could result in the PP 50 not being able to communicate with the PDA The PP 50 seri...

Page 9: ...l communication If the registration is unsuccessful no external communication will be made DPSDK_ExtOpenConnection Initializes external connection with device attached to PP 50 s port The printer must be initialized successfully before The function sleeps the printer ends current connection and initializes a new one with the specified parameters DPSDK_ExtSendData Sends data to external device DPSD...

Page 10: ...e Warrior the DPSDKLib prc file must be loaded onto the Palm device The DPSDKLib h header file must be included in all Code Warrior projects Falch NET DeveloperStudio Place the file DPFN o in your library path or in the current directory and add in to the string of Linker options of the project The file DatecsPrinter h must be placed in the current directory or in thePalmSDK include directory AppF...

Page 11: ...ary GSDK DLL including sample code for quick and easy implementation in the different Integrated Development Environments IDE while developing your own application with printing ability Blackberry Java SDK This SDK provides all required information about BlackBerry Library BBerrySDK jar including sample code for quick and easy implementation in the different Integrated Development Enviroments IDE ...

Page 12: ...exception Page size the page size it is calculated as proportional to given size for example A4 size is treated as page with dimensions 48mm x 68 mm User can obtain information about the driver via dc function GetDeviceCaps The driver incorporates functions such as PASSTHROUGH that enables the developers to send printer resident commands to the PP 50 through the driver Other commands such as the R...

Page 13: ...t provides Text Formatting Barcodes and Graphics printing capability Using this method gives programmers greater flexibility and control of the PP 50 however using this method also requires more programming efforts PDA Device PP 50 PP 50 MS Custom Application Device Serial Port Cradle Serial Port Resident Commands Print Mechanism Card Reader ...

Page 14: ...n characters 5 ESC Setting the absolute position for print 6 ESC Set cancel custom selected characters for printing 7 ESC Loading custom selected symbols 8 ESC Setting the text printing mode 9 ESC Print graphic information 10 ESC Set cancel underlining 11 ESC Diagnostic information self test 12 ESC 2 Specifying 1 6 inch line height 13 ESC 3 Specifying n 203 inch line height 14 ESC Data input contr...

Page 15: ...the printer status 31 ESC x Set the automatic switch off time 32 ESC Setting canceling the inverted characters 33 GS k Printing the bar code 34 GS w Set the bar code horizontal size 35 GS h Set the bar code height 36 GS H Set the position of the bar code duplicate text 37 GS f Set the font of the bar code duplicate text 38 GS Loading a graphic image logo 39 GS Print the downloaded graphic image 40...

Page 16: ...the set line pitch CR Print Line command Code 0Dh This command is ignored ESC SP Sets the space between the characters Code 1Bh 20h n 0 n 20h The entered data is binary The distance between the characters is measured in dots 1 203 inches The initial value is n 0 When the width of characters is doubled the distance between them is relatively doubled too ESC Setts the Absolute Position for print Cod...

Page 17: ...built font B over the loadable font B All parameters after the number of the command are not entered 2 or 2 Defines a set of consecutive symbols for font A 12 x 24 3 or 3 Defines a set of consecutive symbols for font B 9 x 16 n is the ASCII code of the first and m is the ASCII code of the last of m n 1 the consecutive symbols For defining only one symbol m n The data for the symbols is marked with...

Page 18: ...idth The spaces entered with the horizontal tabulator are not underlined as well as those rotated to 90 C ESC Print graphic information Code 1Bh 2Ah m n1 n2 D1 Dk m 0 1 20h or 21h Graphic mode see the table below 0 n1 FF Sets the number of horizontal dots LS byte 0 n2 01 Sets the number of horizontal dots MS byte Di i from 1 to k Data on the graphic image The number of horizontal dots is n1 n2 256...

Page 19: ...t sent 11h Compressed data 24 lines high Byte a and byte 00h are not sent 12h Compressed data with a height of a lines 0 n 40h defines the horizontal size Di is the graphic data the number of which is n 24 bytes in mode 10h The compressed data in mode 11h must produce the same number but only after decompression The number of the bytes for mode 12h must be a n after decompression The compression i...

Page 20: ...rlining 1 or 31h Single thickness underline 2 or 32h Double thickness underline ESC Printing diagnostic information self test Code 1Bh 2Eh A test page is printed containing current parameters including printing density temperature of the printing head battery level mode RS232 or IrDA and baud rate in case RS232 is selected ESC 2 Setting 1 6 inch line height Code 1B 32h If the line contains symbols...

Page 21: ...ith 00h If nothing has been read only 00h is returned n is a parameter defining the tracks we wish to read For a three track reader the possible values are bit 1 if set reads Track 1 bit 2 if set reads Track 2 bit 3 if set reads Track 3 bit 4 if set a prefix byte is added before the every track Setting bit 4 the tracks are prefixed with a single byte for better recognition of where they start If o...

Page 22: ...which is defined by this command from the beginning of the line The width of the character at this point includes the distance between the characters and is doubled when double increase is set The maximum number of tab positions is 32 ESC D 00h clears the set tab positions After clearing the horizontal tabulator is ignored ESC E Set cancel bold print Code 1Bh 45h n n may have a value between 0 to ...

Page 23: ...serial interface The command is not executed in the IrDA mode Possible values of the parameter n are 0 or 0 2400 bps 1 or 1 9600 bps 2 or 2 19200 bps 3 or 3 57600 bps 4 or 4 115200 bps The set baud rate is valid only when controlling the printer via a serial cable The last set value remains valid after printer switch OFF even when it has not been operated in the IrDA mode The default value is 1 96...

Page 24: ...s 3 100 ESC Specifying the relative horizontal printing position Code 1Bh 5Ch n1 n2 0 n1 FFh Horizontal shift in dots LS byte 0 n2 FFh Horizontal shift in dots MS byte The shift is n1 256 n2 dots Positions before and after the line are unacceptable Shifting to the left of the current position is done by entering the addition to the necessary digit up to 65536 N 65536 N ESC Returning data on batter...

Page 25: ... 255 but only the LS bit is of importance Value 0 The LF button is enabled Value 1 The LF button is disabled The default value is 0 ESC d Printing and Advancing paper by n lines Code 1Bh 64h n n may have a value between 0 to 255 The data accumulated in the graphic buffer is printed out and paper is advanced to n lines The beginning of the line is accepted as a new starting position for print ESC v...

Page 26: ...no automatic switch OFF The set time is stored even after the printer is switched OFF The default value is 10 minutes ESC Set Cancel Inverted Characters 180 Code 1Bh 7Bh n n may have a value between 0 to 255 but only the LS bit is of importance 0 Canceling inverted characters 1 Setting inverted characters The default value is 0 GS k Printing Bar Codes Code 1Dh 6Bh n Di 00h n sets the type of bar c...

Page 27: ... n n has a value between 1 and FFh and sets the height of the bar code in dots 1 203 inches The default value of n is 162 GS h Set the Printing Position of the bar code duplicate text Code 1Dh 48h n n has a value between 0 and 3 or 0 or 3 included and sets the exact location of the duplicate text Value Duplicate Text 0 No Printing 1 Above the bar code 2 Below the bar code 3 Both above and below th...

Page 28: ... OFF The loaded image is printed out with the command GS GS Printing a downloaded graphic image Code 1Dh 2Fh m m sets the printing mode which may be m Mode Name Dots in Vertical Direction Dots in Horizontal Direction 0 Normal mode 203 DPI 203 DPI 1 Double wide mode 203 DPI 101 DPI 2 Double high mode 101 DPI 203 DPI 3 DW DH mode 101 DPI 101 DPI When no graphic image has been loaded the command is i...

Page 29: ...by n2 1 For every execution the LF button must be pressed GS L Left margin alignment setting Code 1Dh 4Ch n1 n2 Sets the position in dots 1 203 inches for the beginning of each printed line The command is executed only when sent at the beginning of the line The set shift is n1 256 n2 from left to right The default value is 0 FS Enable the table of symbols JIS FS Code 1Ch 26h FS Disable the table o...

Page 30: ...g in the JIS and Shift JIS modes Code 1Ch 21h n n has a value between 00h and FFh where the separate bits have the following meanings Bit Function Value 0 Value 1 0 Undefined 1 Undefined 2 Double width Canceled Enabled 3 Double height Canceled Enabled 4 Undefined 5 Undefined 6 Underline 7 Underline Canceled Enabled ...

Page 31: ...ing is the PP 50 s serial port pin assignment Pin Name Description 1 GND 2 If connected to GND Enable the HotSync and disable printer function 3 If connected to GND Enable Vout on the pin 12 4 NC 5 RTS 6 NC 7 TxD For Printer 8 NC 9 TxD for PDA or RxD for Printer 10 NC 11 CTS 12 Vout Direct battery or 5V regulated 80mA switched with a jumper on the interface board of PP 50 only applies to new board...

Page 32: ...arrier Pin Number Signal 1 NC 2 VBAT 3 RD 4 RTS 5 TD 6 CTS 7 Hot Sync 8 NC 9 NC 10 GND Pin Assignments for the PP 50 Palm V carrier Pin Number Signal 1 NC 2 VBAT 3 RD 4 RTS 5 TD 6 CTS 7 Hot Sync 8 V Charge 9 NC 10 GND Pin Assignments for the PP 50 Visor carrier Pin Number Signal 1 RD TTL 2 GND 3 Hot Sync 4 GND 5 NC 6 NC 7 NC 8 TD TTL ...

Page 33: ...ve datastream intCount 1 cardTrack 0 delay 1 Send the read card information command Call SerialOpen 57600 0 Open the serial port strSend chr 27 chr 63 chr cardTrack Send the read card command err SerialSend strSend 3 Send the command 3 bytes Get the card information from the serial buffer one character at a time err SerialReceive received 1 delay Do while err 0 And intCount 400 datastream datastre...

Page 34: ...OpenLibrary DPSDK_Ref Context FatalErr error errNone Can t load DPSDK if DPSDK_REGISTER DPSDK_Ref REGISTRATION NUMBER GOES HERE FrmCustomAlert InfoAlert cannot register 0 0 if DPSDK_InitPrinter DPSDK_Ref if DPSDK_ExtOpenConnection DPSDK_Ref 9600 8 1 0 send receive DPSDK_ExtCloseConnection DPSDK_Ref else FrmCustomAlert InfoAlert cannot initialize printer 0 0 error DPSDKLib_CloseLibrary DPSDK_Ref Co...

Page 35: ... Infinite Peripherals Inc Page 34 www ipcprint com Version 2 00 Appendix C Serial Cable Examples ...

Reviews: