user guide for j2me and blackberry printswipedemo v1 1

Blue Bamboo Print & Swipe Demo Application User Guide Java (J2ME & BlackBerry) Version

Print & Swipe Demo Application User Guide BLUE BAMBOO

Date: Dec 16, 2009

Version: 1.1

Copyright © 2010 BLUE BAMBOO All rights reserved.

No part of this publication may be copied, distributed, stored in a retrieval system, translated into any human or computer language, transmitted, in any form or by any means, without the prior written consent of BLUE BAMBOO. All other brand names and trademarks in this guide are the property of Blue Bamboo.

Information in this document is subject to change without notice.

www.bluebamboo.com

2

Print & Swipe Demo Application User Guide

Table of Contents

......................................................................................................................... 4 1 Introduction........................................................................................................... 4 2 Bluetooth Peripheral

.................................................................................................................. 4 2.1 P25 printer............................................................................................................... 4 2.2 P25M printer................................................................................................................ 4 2.3 H50 terminal

..................................................................................................................... 5 3 Printer Pairing....................................................................................................... 5 3.1 BlackBerry Phone

................................................................................................... 7 3.2 Java Enabled Phone....................................................................................................................... 9 4 Function List

................................................................................. 10 4.1 Receipt Print (P25/P25M/H50)............................................................................................ 12 4.2 Text Print (P25/M, H50)

.................................................................................... 13 4.3 Image Print (P25/P25M/H50)........................................................................................ 14 4.4 Barcode Print (P25/P25M)

.................................................................................................... 15 4.5 MSR (P25-M/H50)

.................................................................................................... 16 4.6 IC Card Test (H50).................................................................................................. 16 4.7 DebitPIN Test (H50)................................................................................................ 16 4.8 Get Printer Info (P25)

............................................................................................................... 20 5 Revision History

www.bluebamboo.com

3

Print & Swipe Demo Application User Guide 1 Introduction The Print Swipe Demo Application Guide is to describe how to use the functions of the application, including swipe card, print text, image, barcode using P25M printer and enter debit PIN, check card balance using H50 terminal.

2 Bluetooth Peripheral 2.1 P25 printer P25 printer has no MSR (Magnetic Strip Reader). It can only print but can not swipe magnetic card.

2.2 P25M printer P25M printer has MSR (Magnetic Strip Reader). It can both print and swipe card.

Note: P25 and P25M’s device name and PIN code for Bluetooth connection is located underneath the printer’s lid.

2.3 H50 terminal H50 terminal can print, swipe, enter debit PIN and read IC card data. Its protocol is the same with P25/P25M printer, but with more commands.

www.bluebamboo.com

4

Print & Swipe Demo Application User Guide You need to plug Bluetooth module into H50 terminal and set its mode as BlueGIGA slave by using the shell menu (please refer to H50 Shell User Guide for details.). And this Bluetooth module name is used as the device name for search. After you install the Device Service Application on H50 terminal, by running this application, H50 terminal can work as P25/P25M, with adding functions such as enter debit PIN and read IC card. But H50 can not print barcode or image which Device Service Application can not support.

3 Printer Pairing Before performing the demo process, the P25/P25M or H50 device has to connect to the phone via Bluetooth first.

3.1 BlackBerry Phone Step Action Display

Turn on the P25/P25M/ printer or H50 terminal.

1.

Select Setup Bluetooth icon on your Blackberry. 2.

Click OK to enable the device pairing mode. 3.

Click the thumbwheel and select Add Device. The BlackBerry will launch a scan to find available Bluetooth devices to connect with.

4.

www.bluebamboo.com

5


For example, select the P25-M Printer in the list. Confirm the P25-M Device ID matches the Device ID shown on screen.

5.

Note: Refer to the P25-M or H50 Quick Installation Guide to locate the Device ID & Pin Code.

Enter the P25-M Pin Code to establish the connection. 6.

www.bluebamboo.com

6


The P25-M and BlackBerry are now paired. 7.

3.2 Java Enabled Phone Searching and pairing Bluetooth devices for J2ME enabled phones is different with Blackberry phones. It can be done by using the option menu of the Print & Swipe Demo application. Step Action Display

Turn on the P25/P25-M Printer or H50 terminal

1.

Run the Print & Swipe Demo Application and select Device Pair, This option only exists in J2ME Version.

2.

The screen will display the Bluetooth device which the phone connects with currently. You can search new device, please select the category of device to search. P25/P25M: The target device name contains “P25”.

3 H50: The target device name contains “H50”. History: The target device which had been connected with phone previously

Manual: You can input that target device name manually.

www.bluebamboo.com

7

Print & Swipe Demo Application User Guide 4. The phone is searching the

Bluetooth device, and it maybe need about one minute, please wait.

Bluetooth devices

P25_000061_0 Blue Bamboo P25_1 P25_345678_2

Found Device List Screen and select your target device. 5.

Select Back

Make a local connection?

URL:btspp://00081BCAED12:1

The security authorization message will be displayed to confirm if make a local connection with the device, please select one to connect or exit.

Yes, Always Grant Access

6. Yes, Ask Once Yes, Always Ask No, Ask Later

Note: In some mobile phone, this message may not be displayed.

No, Never Grant Access

Select Back

www.bluebamboo.com

8

Print & Swipe Demo Application User Guide Please Wait…

7. The phone is processing to

connect with the Bluetooth device.

Processing…

Cancel

Info

SN: HW ver: H1.0

SW ver: S1.0.25 The information of the device will be displayed after successful connection, press OK to go back the main menu.

8.

OK

4 Function List Function list screen shows the functions which the Print & Swipe Demo Application contains. The device type listed in the bracket can support this function.

www.bluebamboo.com

9


4.1 Receipt Print (P25/P25M/H50) It will print a receipt bounding with device information, Image, 1D Barcode, 2D Barcode, and text with different language(Chinese and English) , different font size(big, small , double height and double width ) and different font style(underline and reverse) Step Action Display

1. Select Receipt (P25, P25-M),

Printing

Processing… 2. The phone is printing the receipt.

Cancel

www.bluebamboo.com

10


3. Receipt sample

www.bluebamboo.com

11


4.2 Text Print (P25/M, H50) It will show you how to print Chinese or English text. Step Action Display

1. Select Text (P25/M, H50),

Select Language

English Chinese Please select the language you want to print. 2.

Select Back

Printing

Processing… 3. The phone is printing the text.

Cancel

www.bluebamboo.com

12


4.3 Image Print (P25/P25M/H50) It will print image in two formats, one is byte array (one byte means 8 black-white pixels, you can use P25 Device Manager to convert image file to byte array), the other is file image and can be converted into byte array by application on mobile phone.

1. Select Image (P25, P25-M),

Select Image Type

Byte Array Image File Image Please select the image type you want to print. 2.

Select Back

Printing

Processing… 3. The phone is printing the text.

Cancel

www.bluebamboo.com

13


4.4 Barcode Print (P25/P25M) It will show how to print one dimension barcode

1. Select Barcode (P25, P25-M),

Printing

Processing… The phone is printing the barcode. 2.

Cancel

www.bluebamboo.com

14


4.5 MSR (P25-M/H50) It will show swipe card waiting screen and after Bluetooth LED turns blue, you can swipe card on P25M printer or H50 terminal. The phone will display 3 tracks card data, and you can use P25M or H50 to print these data.

1. Select MSR (P25-M, H50),

MSR

Please Swipe card…

The swipe card screen will be displayed, please swipe card on the P25-M printer or H50 terminal.

2.

Cancel

Card Data:

Track1=

Track2=

The card data will be displayed,

and you can print the data or select OK to exit.

3. Track3=

OK Print

www.bluebamboo.com

15


4.6 IC Card Test (H50) You can insert IC card into H50 terminal. Select IC Card Test option and it will show the balance in the card.

4.7 DebitPIN Test (H50) It will send command of reading debit pin to H50 terminal, and H50 will prompt to enter PIN. Device Service Application can check if PIN is right and send result back to mobile phone.

4.8 Get Printer Info (P25) It will show you the hardware and software information of the printer.

1. Select Get Printer Info (P25),

Please wait…

Processing… 2. The phone is processing.

Cancel

www.bluebamboo.com

16

Print & Swipe Demo Application User Guide Info

3. The information of the device will

be displayed, press OK to go back the main menu.

SN: HW ver: H1.0 SW ver: S1.0.25

OK Software License Agreement This is a legal agreement between you (either as an individual or as an authorized representative of your employer) and BLUE BAMBOO. It concerns your rights to use this file and any accompanying written materials (the "P25 BlackBerry Source code"). In consideration for BLUE BAMBOO allowing you to access the P25 BlackBerry Source code, you are agreeing to be bound by the terms of this Agreement. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, DO NOT INSTALL THE P25 BlackBerry Source code. If you change your mind later, stop using the P25 BlackBerry Source code and delete all copies of the P25 BlackBerry Source code in your possession or control. Any copies of the P25 BlackBerry Source code that you have already distributed, where permitted, and do not destroy will continue to be governed by this Agreement. Your prior use will also continue to be governed by this Agreement. 1. Definitions. (i) "P25 BlackBerry Source code" means all files including source code, .java,.h, files, and documentation contained within the installation package. (ii)"DERIVATIVE WORKS" shall mean a work which is based on one or more preexisting works, such as a revision, modification, translation, abridgment, condensation, expansion, collection, compilation or any other form in which such preexisting works may be recast, transformed or adapted. 2. License. For as long as LICENSEE complies with its obligations under this Agreement, BLUE BAMBOO hereby grants to LICENSEE for the sole purposes of incorporating the corresponding P25 BlackBerry Source code with BLUE BAMBOO's transaction terminal devices, a personal, worldwide, non-exclusive, nontransferable (except as set forth below), paid-up, royalty-free license and right: (i) to use, execute, perform and copy the P25 BlackBerry Source code, and (ii)to prepare DERIVATIVE WORKS using the P25 BlackBerry Source code. For as long as licensee complies with its obligations under this Agreement, BLUE BAMBOO hereby grants to LICENSEE for the sole purposes of distributing LICENSEE’s products developed with BLUE BAMBOO’s P25 BlackBerry Source code, a personal, worldwide, non-exclusive, paid-up, royalty-free license and right: (i) to distribute DERIVATIVE WORKS

www.bluebamboo.com

17

Print & Swipe Demo Application User Guide (ii)to sublicense to others the right to use DERIVATIVE WORKS This license is not a sale of any interest in the P25 BlackBerry Source code's Copyright or any copy thereof. LICENSEE agrees not to remove or destroy any Copyright notices, proprietary markings or confidential legends placed upon, contained within or associated with the P25 BlackBerry Source code. 3. Non-disclosure. LICENSEE hereby agrees (i) to hold Blue Bamboo Confidential Information (the SOURCE CODE and all other BLUE BAMBOO information marked with "Blue Bamboo CONFIDENTIAL" or similar legend) furnished hereunder in confidence. These confidential obligations shall not apply to information that: (a) is in or enters the public domain without breach of this Agreement by LICENSEE; or (b) is disclosed without restrictions by a third party to LICENSEE; or (c) is independently developed by LICENSEE; or (d) is already known to LICENSEE at the time of disclosure under this Agreement as shall be proved by contemporaneous written records; or (e) is disclosed by BLUE BAMBOO to any other person or entity without similar restrictions, or (f) is required to be disclosed by law, governmental agency or court order, except where such disclosure is disclosure of P25 BlackBerry Source code SOURCE CODE as Restricted Rights under Section 4. 4. U.S. Government Disclosure. LICENSOR will allow LICENSEE to disclose the P25 BlackBerry Source code SOURCE CODE to those employees of the U.S. Government that require access to the P25 BlackBerry Source code SOURCE CODE to approve the LICENSEE 'S Products; LICENSOR understands that the U.S. Government is legally restricted in its ability to distribute contractor proprietary information. LICENSEE will maintain a legally binding contract with the U.S. Government to enforce the confidentiality of the BlueTools SDK and require the U.S. Government not to disclose the BlueTools SDK SOURCE CODE to any and all persons; and will treat the BlueTools SDK SOURCE CODE as Restricted Rights as stated in the Defense Federal Acquisition Regulation Supplement and under DFARS clause #252.227-7014. 5. Limitation of Liability. THE P25 BlackBerry Source code IS PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND INCLUDING WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT OF THIRD-PARTY INTELLECTUAL PROPERTY, OR FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT SHALL BLUE BAMBOO BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION, LOSS OF INFORMATION AND, INSOFAR AS IS LEGALLY POSSIBLE, CONSEQUENTIAL OR INCIDENTAL DAMAGES) ARISING OUT OF THE USE OF OR INABILITY TO USE THE P25 BlackBerry Source code, EVEN IF BLUE BAMBOO HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BLUE BAMBOO SHALL NOT BE RESPONSIBLE FOR ANY ERRORS THAT MAY APPEAR IN THE P25 BlackBerry Source code OR DERIVATIVE WORKS NOR SHALL BLUE BAMBOO BE UNDER ANY OBLIGATION TO SUPPORT OR UPDATE THE P25 BlackBerry Source code. BLUE BAMBOO RETAINS THE RIGHT TO MAKE CHANGES TO ITS P25 BlackBerry Source code AT ANY TIME, WITHOUT NOTICE TO LICENSEE. 6. Maintenance. BLUE BAMBOO shall be under no obligation to assist Licensee to use, execute, perform or copy the P25 BlackBerry Source code, or to provide support to Licensee of the P25 BlackBerry Source code, or to provide maintenance, correction, modification, enhancement, or upgrades to the BLUETOOLS SDK. BLUE BAMBOO may however provide such support, maintenance, correction, modification, enhancement or upgrades in its sole discretion, and, if provided, such support, maintenance, correction, modification, enhancement, or upgrades shall be considered part of the P25 BlackBerry Source code and shall be subject to all terms and conditions of this Agreement. 7. Termination.

www.bluebamboo.com

18

Print & Swipe Demo Application User Guide This Agreement and the licenses granted by BLUE BAMBOO herein shall terminate immediately without notice from BLUE BAMBOO or by a judicial resolution, if LICENSEE fails to comply with any provisions of this Agreement. Following termination of this Agreement, LICENSEE covenants that it shall only use DERIVATIVE WORK(S) of the BLUETOOLS SDK to incorporate BLUE BAMBOO's transaction terminal products with Licensee's products. Any other use of DERIVATIVE WORK(S) of the P25 BlackBerry Source code is strictly prohibited. 8. Taxes. The amount of any taxes of any kind, if any are applicable to this transaction or to the use or possession of the P25 BlackBerry Source code covered hereby shall be paid by LICENSEE. The parties agree that the tangible portion of the property delivered and to be delivered by BLUE BAMBOO to LICENSEE or by LICENSEE to BLUE BAMBOO is valued at one hundred dollars ($100.00). 9. Governing Law. This Agreement shall be governed and construed in accordance with the laws of the Hong Kong S.A.R. as applied to contracts entered into in the Hong Kong S.A.R by a corporation based in Hong Kong S.A.R. 10. Damage Limitation. INDEPENDENTLY OF ANY OTHER REMEDY LIMITATION HEREOF AND NOTWITHSTANDING ANY ESSENTIAL PURPOSE OF ANY SUCH LIMITED REMEDY, IT IS AGREED THAT IN NO EVENT SHALL BLUE BAMBOO BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY KIND UNDER THIS AGREEMENT. 11. Transferability. LICENSEE may not divide its interests under this Agreement and transfer same to different parties; however, LICENSEE may assign and transfer all its rights under this Agreement solely to a party controlling, controlled by or under common control with LICENSEE, a successor in interest in the event of a merger, consolidation or sale of substantially all of the LICENSEE'S assets or stock, or to a successor to the portion of its business that designs or markets products incorporating the BLUE BAMBOO P25 BlackBerry Source code. 12. Intellectual Property Ownership. BLUE BAMBOO shall retain title to and ownership of all proprietary rights with respect to the P25 BlackBerry Source code and copies thereof. LICENSEE shall retain title to and ownership of all proprietary rights in DERIVATIVE WORKS of the P25 BlackBerry Source code made by or for LICENSEE, and all copies thereof, excluding the portions owned by BLUE BAMBOO made reference to under the previous sentence. Except as expressly provided herein, BLUE BAMBOO does not grant any express or implied right to Licensee under BLUE BAMBOO’s patents, Copyrights, trademarks, or trade secrets. 13. Survival Clauses. The following provisions shall survive expiration or termination of this Agreement for any reason: Section 3 (Non-disclosure), Section 5 (Limitation of Liability), Section 10 (Damage Limitation), Section 12 (Intellectual Property Ownership). 14. Entire Agreement. This Agreement and its Exhibits contain the entire Agreement and understanding between the parties with respect to the subject matter hereof and merges and supersedes all prior agreements, understandings and representations. No addition or modification to the

www.bluebamboo.com

19

Print & Swipe Demo Application User Guide Agreement is valid unless made in writing and signed by both parties hereto. To the extent that this Agreement contains a provision that contradicts any provision in the Exhibits hereto, this Agreement shall control. This Agreement shall be construed and controlled by the law of the Hong Kong S.A.R. In the event of any dispute hereunder, the parties agree to jurisdiction in the Hong Kong S.A.R.

5 Revision History Revision 1.0 (August 13, 2009) Initial Release.

Revision 1.1 (Dec 16, 2009) Update some functions’ name, add Receipt print and Get Printer Info

www.bluebamboo.com

20

user guide for j2me and blackberry printswipedemo v1 1

Documents