# Printer Integration # 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 1. Go to the **Home Screen**. 2. Open **Settings**. 3. Navigate to **Accounts & Sign In**. 4. 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](https://docs.virtubox.io/attachments/1) 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: 1. HDMI Cable 2. Touch USB Cable 3. 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: 1. Open **PrintHand**. 2. Tap the **three-dot menu**. 3. Select **Settings**. 4. Open **Manage Printer**. 5. Select the connected printer. 6. Open **Paper**. 7. 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](https://docs.virtubox.io/attachments/2)
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: 1. Go to the **Home Screen** of the Kiosk. 2. Open **Settings**. 3. Navigate to **Apps**. 4. Locate and open the **PrintHand** application. 5. Tap **Clear Data**, then **Force Stop**. 6. Reopen the **PrintHand** application. 7. 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: 1. Go to the **Home Screen**. 2. Open **Settings**. 3. Navigate to **Accounts & Sign In**. 4. Select the **Google Account**. 5. Tap **Remove Account**. 6. 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. 1. Connect the **Android Box** to the Kiosk using: - HDMI Cable - Touch USB Cable - Power Adapter 2. Install the **Kiosk Application**. 3. Add the **Kiosk Account**. 4. Navigate to: **Kiosk Account → Kiosk Integration → Printer** 5. Enable **Printer Integration**. 6. Assign a **Printer License** to the Kiosk (Contact **Ashish** for the license). 7. 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: 1. Open the **PrintHand** application. 2. Tap the **three-dot menu** in the top-right corner. 3. Open **Settings**. 4. Select **Manage Printer**. 5. Choose the connected printer. 6. Select **Paper**. 7. 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 1. Turn **ON the Kiosk**. 2. Turn **ON the printer**. 3. Wait until the printer is fully powered. 4. Connect the USB/data cable to the **printer**. 5. Connect the other end of the USB/data cable to the **Kiosk**. 6. Wait approximately **5–10 seconds**. 7. Open/check **VirtuKiosk**. 8. Verify that **BluPrints / Printer Connected** is displayed. 9. 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 1. Kiosk ON. 2. Printer ON. 3. VirtuKiosk Running. 4. USB Connected. 5. Disconnect USB Cable. 6. Reconnect USB Cable. 7. Printer is not Connectd. ## How to Fix 1. Remove USB Cable (connection between Kiosk and Printer) . 2. Turn Off Printer (wait 5-10 second). 3. Turn On printer (wait 5-10 second). 4. Reconnect USB (wait untill kiosk connect with USB printer). 5. Now check VirtuKiosk. 6. Perform Test print. #### Notes - In case of any failure, follow the guidelines above to reconnect the printer.