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 J ava 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 P25Ms device name and PIN code for Bluetooth connection is located
underneath the printers 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


Print & Swipe Demo Application User Guide



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


Print & Swipe Demo Application User Guide


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



3.2 Java Enabled Phone
Searching and pairing Bluetooth devices for J 2ME 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
J 2ME 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://00081BC
AED12: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


Print & Swipe Demo Application User Guide


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


Print & Swipe Demo Application User Guide

3. Receipt sample



www.bluebamboo.com

11


Print & Swipe Demo Application User Guide

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


Print & Swipe Demo Application User Guide

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


Print & Swipe Demo Application User Guide

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


Print & Swipe Demo Application User Guide

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


Print & Swipe Demo Application User Guide

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 LICENSEEs products developed with BLUE
BAMBOOs 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 BAMBOOs
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