BBPOS Chipper OTA User manual

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
User Manual
Chipper OTA
Date: December 31, 2021
Document Version Number: 1.5

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 2 of 18
Table of Content
1. Introduction 4
1.1. Purpose 4
2. How does Chipper OTA work? 4
3. How to upgrade your Chipper? 5
4. Error Messages 16

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 3 of 18
BBPOS Corp.
Room 1902, 19/F, Tower 2, Nina Tower, No.8 Yeung Uk Road, Tsuen Wan,
Hong Kong
bbpos.com
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 BBPOS. All other brand names and trademarks appearing in this guide are the
property of their respective holders.
Information in this document is subject to change without notice.
BBPOS Corp © 2021. All rights reserved.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 4 of 18
1. Introduction
The Chipper OTA is an offering of standalone applications developed to aid users in updating their
Chipper series devices to the latest firmware version that ensures CAPK readiness.
It is imperative that the firmware in your Chipper series device(s) is updated to the latest version to
ensure that there is no interruption in your transaction processing.
Starting on January 1, 2022, all EMV transactions will be declined regardless of card brand if the
firmware is not updated to the latest recommended version.
1.1. Purpose
The purpose of this document is to help understand the applications designed to update
the Chipper series firmware to a specific version necessary to address CAPK readiness.
2. How does Chipper OTA work?
BBPOS has developed a standalone Android, iOS, Windows, and Mac application that will update a
Chipper series device via Bluetooth or USB.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 5 of 18
3. How to upgrade your Chipper?
Expected time taken:
Platform
Expect time taken
ni d
4 –5 minutes
iOS
7–8 minutes
4 minutes
<4 minutes
Reminder: In the merchant environment, the firewall of Intranet/WIFI network must have a rule to
allow traffic to the BBPOS TMS server. The rule is to allow ingress/egress traffic of HTTPS to the
domain api.emms.bbpos.com
The standalone Chipper OTA application has been developed with simplicity in mind and designed
to be “plug and play”. The instructions on how to use the application are as follows:
Android/iOS Version:

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 6 of 18
Step
Screen
Description
1.
Turn on the device to be updated. Ensure
that your Chipper is powered on with
network connectivity.
2.
Download the Chipper OTA.
Android version: Scan the QR code or Click
the link below to download the Chipper
OTA.
QR code:
URL:
https://play.google.com/store/apps/detail
s?id=com.bbpos.chipperotaapp
iOS version: Scan the QR code or Click the
link below to download the Chipper OTA.
QR code:
URL:
https://apps.apple.com/app/chipper-
ota/id1589744317

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 7 of 18
3.
Open the Chipper OTA.
4.
If prompted, select “While Using the App”
to allow location permissions usage.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 8 of 18
5.
If prompted, open the Bluetooth in system
settings, Click OK.
6.
Click Get Started to connect to the Chipper
through Bluetooth with your Android/iOS
device.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 9 of 18
7.
Click Select to pick the Chipper you want
to upgrade from the available device list.
8.
Connecting > Collect Chipper Information

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 10 of 18
9.
Click Yes , then the update will be started.
Reminder: Do not close the app or turn off
the reader during update.
10.
Updating > Rebooting > Waiting for
connection
Reminder: Do not close the app or turn off
the reader during update.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 11 of 18
11.
Update Success! Click Done.
12.
You may now close the application or
select another device to update

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 12 of 18
Windows and Mac Version:
Step
Screen
Description
1.
Turn on the device to be updated.
Ensure that your Chipper is powered on
with network connectivity.
2.
Connect Chipper with a USB cable.
3.
Download the Chipper OTA.
Windows version: Click the link below
to download the Chipper OTA.
URL:
https://developer.bbpos.com/app/chip
per-ota-app/chipper-ota-app.exe
Mac version: Click the link below to
download the Chipper OTA.
URL:
https://apps.apple.com/ app/chipper-
ota/id1589744317?l=en

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 13 of 18
4.
Open the Chipper OTA.
5.
Waiting for connection.
Reminder: Do not remove the USB cable
while connecting.
6.
Connect Success!

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 14 of 18
7.
Collect Device Information.
8.
Click Yes , then update will be set.
Reminder: Do not close the app or turn
off the reader during update.
9.
Updating > Rebooting > Waiting for
connection
Reminder: Do not close the app or turn
off the reader during update.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 15 of 18
10.
Update Success!
Click Done , then disconnect the device.
11.
Safe to remove the USB cable.
12.
You may now close the application or
connect another device to update.

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 16 of 18
4. Error Messages
Error Message
Suggested Action
Device disconnect BT before update finish.
Place the device close to the mobile phone.
Reset the device and try again
Device no response
Reset the device and try again
Device cannot re-connect after 5 min scanning.
Run the OTA again and check the firmware is
updated or not.
Bluetooth (error code - 3029).
Place the device close to the mobile phone.
Reset the device and try again
Bluetooth (error code - 30XX).
Place the device close to the mobile phone.
Reset the device and try again
BT connection timeout (01).
Place the device close to the mobile phone.
Reset the device and try again
BT connection timeout (02).
Place the device close to the mobile phone.
Reset the device and try again
Device fails to update - 1. not update to target
FW version
Use the latest Chipper OTA app and try again
Bluetooth 2.0 Disconnected.
Place the device close to the mobile phone.
Reset the device and try again

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 17 of 18
Bluetooth disconnected.
Place the device close to the mobile phone.
Reset the device and try again
Device error.
Reset the device and try again
Device timeout
Reset the device and try again
Failed to exchange K1.
Device broken. Contact supporter
Missing input parameters -
SignedTermPubKey.
Device broken. Contact supporter
An SSL error has occurred and a secure
connection to the server cannot be made.
Check Internet connection and try again. Please
turn off any firewall. Use another mobile phone
to try again.
Request timeout
Check Internet connection and try again. Please
turn off any firewall. Use another mobile phone
to try again.
Exchange K1 fail.
Device broken. Contact supporter
The network connection was lost.
Check Internet connection and try again.
Error code: (0C95).
Contact supporter
Cannot connect to server.
Check Internet connection and try again. Please
turn off any firewall
Firmware not found - Failed: Target firmware
cannot be found.
Contact supporter
Terminal is not registered in TMS - Failed:
Terminal cannot be found.
Contact supporter
terminal not found.
Contact supporter
WS Timeout (key-getter).
Check Internet connection and try again. Please
turn off any firewall
Cannot connect to server
Check Internet connection and try again. Please
turn off any firewall
Cannot start USB again while USB is
connecting
Check Internet connection and try again. Please
turn off any firewall
Error 0x0C0F
Contact supporter
Error 0x0C07
Contact supporter

BBPOS Chipper OTA v1.5
CONFIDENTIAL
BBPOS Limited © 2021
Page 18 of 18
Error 0x0CAF
Contact supporter
Invalid session
Contact supporter
Please connect to power source and charge up
the device to 10% or above before doing OTA.
Charge the device to full battery and try again
Please connect to power source and charge up
the device to 50% or above before doing OTA.
Charge the device to full battery and try again
Fail to connect to TMS - The remote server
returned an error: (502) Bad Gateway.
Contact supporter
Product not found - Failed: Product version
cannot be found
Contact supporter