Printer Integration

PrintHand Setup & Configuration
BluPrints Printer -- ViruKiosk USB Testing & Troubleshooting Guide

PrintHand Setup & Configuration

Overview

PrintHand is a mobile and desktop application that allows users to print documents, photos, emails, and other files directly from their devices to a wide range of printers. It supports both wired and wireless printing methods, making it a convenient solution for printing without relying on a PC.

This guide explains how to install, configure, and troubleshoot the PrintHand application on a VirtuBox Kiosk.

Prerequisites

Before starting the installation, ensure the following requirements are met:

Android Box is connected to the Kiosk.
Kiosk is configured and ready.
A valid Kiosk Account is available.
Printer Integration is enabled.
Printer License is assigned.
Printer is connected.
USB cable is available.
No Google Account should be logged into the Android Box.

Check Google Account

Before installing PrintHand, verify that no Google Account is signed in.

Steps

Go to the Home Screen.
Open Settings.
Navigate to Accounts & Sign In.
Check whether any Google Account is logged in.

Note

If no account is logged in, continue with the installation.

If a Google Account is logged in, remove it first by following the FAQ section.

Download PrintHand

Download the PrintHand application from the following URL:

https://www.virtubox.io/download

After downloading, install the application.

Install & Configure PrintHand

Follow the steps below to configure PrintHand.

Step 1

Open the PrintHand application.

Step 2

Tap the three-dot menu located in the top-right corner.

Step 3

Select Settings.

Step 4

Open Libraries.

Step 5

Download all available libraries.

Wait until all libraries have been downloaded successfully.

Step 6

Press the Back button.

Step 7

Press Back once again to return to the PrintHand home screen.

Step 8

Tap Add Printer.

Step 9

Select Printer Setup Wizard.

Step 10

Connect the printer to the Android Box using a USB cable.

Step 12

Click Next.

Step 13

When the printer is detected, select:

1 Printer Found

Wait until the processing is completed.

Step 14

Scroll down and select Print Test.

Step 15

Click Next.

Wait until processing completes.

Step 16

Print the Test Page.

Step 17

Verify that the Test Page has been printed successfully.

Step 18

Click Next.

Congratulations! 🎉

PrintHand has been configured successfully.

Prepare a Kiosk for PrintHand

Before using PrintHand, prepare your Kiosk using the following steps.

Step 1

Connect the Android Box to the Kiosk using:

HDMI Cable
Touch USB Cable
Power Adapter

Step 2

Install the Kiosk Application.

Step 3

Add the Kiosk Account.

Step 4

Navigate to:

Kiosk Account → Kiosk Integration → Printer

Enable Printer Integration.

Step 5

Assign a Printer License to the Kiosk.

Contact Ashish to obtain a Printer License.

Step 6

Click Update Kiosk.

Your Kiosk is now ready to use PrintHand.

Configure Paper Size (EPSON PM-520)

To enable borderless printing:

Open PrintHand.
Tap the three-dot menu.
Select Settings.
Open Manage Printer.
Select the connected printer.
Open Paper.
Select:

10 × 15 cm (4 × 6 in) Borderless

Supported Printers

Before using PrintHand, verify that your printer is supported.

Visit:

https://printhand.com/supported_printers.php

Frequently Asked Questions (FAQ)

Q1. What should I do if the Test Print is not generated after Step 18?

If the Test Print is not generated after completing Step 18, follow these steps:

Go to the Home Screen of the Kiosk.
Open Settings.
Navigate to Apps.
Locate and open the PrintHand application.
Tap Clear Data, then Force Stop.
Reopen the PrintHand application.
Repeat the installation process starting from Step 2 of the PrintHand Installation & Configuration section.

Q2. What should I do if a Google Account is logged in?

PrintHand should be configured without any Google Account logged into the Android Box.

To remove the account:

Go to the Home Screen.
Open Settings.
Navigate to Accounts & Sign In.
Select the Google Account.
Tap Remove Account.
Restart the installation process from Step 1 of the PrintHand Installation & Configuration section.

Q3. How do I prepare a Kiosk before using the PrintHand application?

Before installing PrintHand, ensure that the Kiosk is properly configured.

Connect the Android Box to the Kiosk using:
- HDMI Cable
- Touch USB Cable
- Power Adapter
Install the Kiosk Application.
Add the Kiosk Account.
Navigate to:

Kiosk Account → Kiosk Integration → Printer
Enable Printer Integration.
Assign a Printer License to the Kiosk (Contact Ashish for the license).
Click Update Kiosk.

The Kiosk is now ready for PrintHand installation.

Q4. How do I configure the paper size for EPSON PM-520 Borderless Printing?

To configure borderless printing:

Open the PrintHand application.
Tap the three-dot menu in the top-right corner.
Open Settings.
Select Manage Printer.
Choose the connected printer.
Select Paper.
Choose 10 × 15 cm (4 × 6 in) Borderless.

This will enable borderless printing for the EPSON PM-520 printer.

Troubleshooting Checklist

Before raising a support ticket, verify the following:

Android Box is powered on.
Printer is connected via USB.
Printer License is assigned.
Printer Integration is enabled.
All PrintHand libraries are downloaded.
No Google Account is logged in.
Printer is supported by PrintHand.
Test Print has been attempted.

Notes

Important

Always download all PrintHand libraries before configuring the printer.

Do not log in with a Google Account while using PrintHand.

If you clear PrintHand data, repeat the configuration process.

Verify printer compatibility before installation.

BluPrints Printer -- ViruKiosk USB Testing & Troubleshooting Guide

Overview

This document covers the USB connection, printer detection, printing, test cases, and troubleshooting procedure for the BluPrints printer connected to a VirtuKiosk Android device.

The purpose of this guide is to:

Verify that the printer is detected correctly.
Identify USB connection problems.
Reproduce the intermittent printer-disconnection issue.
Provide a simple recovery procedure.
Help anyone troubleshoot and resolve the printer connection issue.

Printer Information

Item	Value
Printer	BluPrints
Manufacturer	AMSPL
USB VID	0416
USB PID	5011
USB Type	USB Printer

Test Cases

Test Case ID	Test Case	Steps / Scenario	Expected Result	Actual Result	Status
T01	Normal Printer Connection	Turn ON Kiosk → Turn ON Printer → Connect USB cable	BluPrints should be detected	BluPrints detected successfully	PASS
T02	Printer Power Cycle	Keep USB connected → Turn Printer OFF → Wait → Turn Printer ON	Printer should reconnect automatically	Printer re-enumerated successfully	PASS
T03	Kiosk Reboot With Printer Connected	Keep Printer ON + USB connected → Reboot Kiosk	Printer should be detected after Android boots	BluPrints detected successfully	PASS
T04	USB Disconnect/Reconnect While Printer Remains ON	Disconnect USB → Reconnect USB without turning OFF printer	Printer should be detected again	USB enumeration failed with `error -71`	FAIL
T05	Printer-Side USB Disconnect/Reconnect	Disconnect USB from printer side → Reconnect while printer remains ON	Printer should be detected	USB enumeration failed with `error -71`	FAIL
T06	Printer Power Reset + USB Reconnect	Printer OFF → Remove USB → Printer ON → Reconnect USB	Printer should be detected	BluPrints detected successfully	PASS
T07	Printer Startup Wait – 15 Seconds	Printer OFF → Remove USB → Printer ON → Wait 15 sec → Connect USB	Printer should be detected	BluPrints detected successfully	PASS
T08	Printer Fully ON Before USB Connection	Printer ON → Wait 30 sec → Connect USB	Printer should be detected	BluPrints detected successfully	PASS
T09	Kiosk Cold Power Cycle	Printer ON + USB connected → Turn Kiosk OFF → Turn Kiosk ON	Printer should be detected after boot	BluPrints detected successfully	PASS
T10	VirtuKiosk Application Restart	Printer connected → Close VirtuKiosk → Reopen VirtuKiosk	Application should detect already-connected printer	BluPrints detected successfully	PASS
T11	Actual Printing	Connect printer → Open VirtuKiosk → Click printer button → Print test value	Printer should print successfully	Test value printed successfully	PASS
T12	USB Disconnect/Reconnect While VirtuKiosk Is Running	Keep VirtuKiosk open → Disconnect USB → Reconnect USB	Printer should reconnect	USB enumeration failed with `error -71`	FAIL
T13	Replacement USB Data Cable	Replace USB data cable → Repeat printer connection test	Printer should connect if original cable is faulty	Same failure pattern occurred	FAIL
T14	Printer Disconnect Recovery Procedure	Remove USB cable from both sides → Printer OFF → Printer ON → Wait 10 sec → Reconnect USB	Printer should reconnect	BluPrints connected successfully	PASS

Normal Printer Connection

Follow these steps when connecting the printer normally.

Steps

Turn ON the Kiosk.
Turn ON the printer.
Wait until the printer is fully powered.
Connect the USB/data cable to the printer.
Connect the other end of the USB/data cable to the Kiosk.
Wait approximately 5–10 seconds.
Open/check VirtuKiosk.
Verify that BluPrints / Printer Connected is displayed.
Perform a test print.

Main Failure

The main failure observed during testing occurs when the printer is powered ON and the USB/data cable is disconnected and reconnected while the Kiosk remains powered ON.

Failure Scenario

Kiosk ON.
Printer ON.
VirtuKiosk Running.
USB Connected.
Disconnect USB Cable.
Reconnect USB Cable.
Printer is not Connectd.

How to Fix

Remove USB Cable (connection between Kiosk and Printer) .
Turn Off Printer (wait 5-10 second).
Turn On printer (wait 5-10 second).
Reconnect USB (wait untill kiosk connect with USB printer).
Now check VirtuKiosk.
Perform Test print.

Notes

In case of any failure, follow the guidelines above to reconnect the printer.