Skip to content

EmiliaCloudPrinter Configuration Guide

Cloud POS Order Capture

This technical guide explains how to configure virtual printers on Windows that send print data directly to Emilia Vision's CloudPOS service.

Target audience: System administrators, support technicians, and POS vendors.


Overview

EmiliaCloudPrinter captures orders that your POS system sends to thermal printers (kitchen, bar, desserts, cashier) and stores them in the cloud for analysis.

Four configuration methods are available:

Method Driver Interface Time
Method A: PowerShell Generic / Text Only CLI 5 min
Method B: Graphical Interface Generic / Text Only GUI 15 min
Method C: Epson Driver (GUI) EPSON TM-T20II GUI 15 min
Method D: Epson Driver (PowerShell) EPSON TM-T20II CLI 2 min*

*Requires APD driver pre-installed (see Method C, Steps 1-2)


Prerequisites

  • Windows 10 or Windows 11
  • Administrator permissions
  • Internet connectivity

Connection data:

Parameter Value
Server printer.emiliavision.com
Port 9100
Protocol RAW
Driver Generic / Text Only

Verify connectivity (PowerShell):

Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100

Should display TcpTestSucceeded : True


Method A: PowerShell Configuration (Recommended)

This method is faster and allows creating multiple printers in seconds.

Step 1: Open PowerShell as Administrator

  1. Press Win + X
  2. Select "Windows PowerShell (Admin)" or "Terminal (Admin)"
  3. Accept the UAC prompt if it appears

Step 2: Create Basic Printer

Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter" -DriverName "Generic / Text Only" -PortName "EmiliaCloud"

Step 3: Create Multiple Printers per Station

Recommended configuration: One virtual printer per workstation.

Printer Name Port Station
EmiliaCloudPrinter-Kitchen EmiliaCloud-Kitchen Hot kitchen
EmiliaCloudPrinter-Bar EmiliaCloud-Bar Beverages
EmiliaCloudPrinter-Desserts EmiliaCloud-Desserts Cold kitchen / Desserts
EmiliaCloudPrinter-Cashier EmiliaCloud-Cashier Cashier / Receipts

Complete script:

# EmiliaCloudPrinter - Installation Script

# Kitchen
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Bar"

# Desserts
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Desserts"

# Cashier
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Cashier"

Write-Host "Installation completed" -ForegroundColor Green

Step 4: Verify Installation

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Method B: Graphical Interface Configuration

This method uses the Windows wizard to add printers.

Step 1: Open Printer Settings

  1. Press Win + I to open Settings
  2. Go to DevicesPrinters & scanners
  3. Click on "The printer that I want isn't listed"

Step 2: Select Connection Type

Select "Add a printer using a TCP/IP address or hostname" and click Next.

Step 3: Enter Connection Data

Field Value
Device type TCP/IP Device
Hostname or IP address printer.emiliavision.com
Port name EmiliaCloudPrinter

Important: Uncheck "Query the printer and automatically select the driver to use"

Step 4: Port Detection

Wait while Windows detects the TCP/IP port.

Step 5: Configure RAW Port

When the port configuration dialog appears:

Field Value
Protocol Raw
Port Number 9100

Leave "SNMP Status Enabled" unchecked.

Step 6: Select Driver

  • Manufacturer: Generic
  • Printer: Generic / Text Only

Step 7: Use Existing Driver

If the driver is already installed, select "Use the driver that is currently installed".

Step 8: Name the Printer

Enter the name: EmiliaCloudPrinter

Step 9: Installation Complete

The printer appears in the list of installed devices.

To create additional printers (Kitchen, Bar, Desserts, Cashier), repeat the process changing the port name and printer name.


Method C: Epson Driver (Graphical Interface)

This method uses the native EPSON TM-T20II driver with the Windows GUI wizard.

Prerequisites

  1. Complete Method A or B first to create the TCP/IP port
  2. Download and install the Epson APD (Advanced Printer Driver)

Step 1: Download Epson APD Driver

Go to the Epson support site for TM-T20II:

Region URL
USA epson.com/Support/.../TM-T20II
Colombia epson.com.co/Soporte/.../TM-T20II

Download: Advanced Printer Driver (APD) v5.13 (~70 MB)

Step 2: Install the APD Driver

Extract the ZIP and run APD_513_T20II.exe as Administrator:

Step 3: Add Printer with Manual Settings

  1. Go to SettingsDevicesPrinters & scanners
  2. Click "The printer that I want isn't listed"
  3. Select "Add a local printer or network printer with manual settings"

Step 4: Use Existing Port

Select "Use an existing port" and choose the EmiliaCloudPrinter port you created earlier.

Step 5: Select Epson Driver

  • Manufacturer: EPSON
  • Printer: EPSON TM-T20II Receipt5

Step 6: Use Installed Driver

Select "Use the driver that is currently installed (recommended)"

Step 7: Printer Sharing (Optional)

Configure sharing if needed. Share name: EmiliaCloudPrinterEpson

Step 8: Installation Complete

The Epson printer is now configured to send data to EmiliaVision cloud.


Method D: Epson Driver (PowerShell)

The fastest method if you already have the Epson APD driver installed.

Prerequisites

  • Epson APD driver installed (see Method C, Steps 1-2)

Single Printer

# Create port and printer with Epson driver
Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinterEpson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud"

Multiple Printers with Epson Driver

# Kitchen
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Bar"

# Desserts
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Desserts"

# Cashier
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Cashier"

Verify Installation

Get-Printer | Where-Object {$_.Name -like "*Epson*"} | Format-Table Name, DriverName, PortName

When to Use Epson Driver vs Generic

Aspect Generic / Text Only EPSON TM-T20II
Setup Built-in Windows Requires APD download
ESC/POS Basic pass-through Native support
POS Compatibility Good Better with Epson software
Recommended for Most cases POS requiring Epson driver

Functionality Tests

Individual Test

"EmiliaCloudPrinter print test" | Out-Printer -Name "EmiliaCloudPrinter"

Test per Station

"=== KITCHEN ===`r`nTable: 12`r`n2x Burger`r`n1x Salad" | Out-Printer -Name "EmiliaCloudPrinter-Kitchen"
"=== BAR ===`r`nTable: 12`r`n2x Margarita`r`n1x Beer" | Out-Printer -Name "EmiliaCloudPrinter-Bar"
"=== DESSERTS ===`r`nTable: 12`r`n1x Cheesecake" | Out-Printer -Name "EmiliaCloudPrinter-Desserts"
"=== CASHIER ===`r`nTable: 12`r`nTotal: $45.50" | Out-Printer -Name "EmiliaCloudPrinter-Cashier"

Contact the Emilia Vision team to confirm data reception.


Useful Commands

List Available Drivers

Get-PrinterDriver | Format-Table Name

Check if Epson Driver is Installed

Get-PrinterDriver | Where-Object {$_.Name -like "*TM-T20II*"}

If the command returns empty, the Epson APD driver is not installed. See Method C, Steps 1-2.

List All Printers

Get-Printer | Format-Table Name, DriverName, PortName

List Only EmiliaCloud Printers

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Delete a Printer

Remove-Printer -Name "EmiliaCloudPrinter"

Delete a Printer Port

Remove-PrinterPort -Name "EmiliaCloud"

Delete All EmiliaCloud Printers and Ports

# Remove printers
Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Remove-Printer

# Remove ports
Get-PrinterPort | Where-Object {$_.Name -like "*Emilia*"} | Remove-PrinterPort

Troubleshooting

Error: "Windows cannot connect to the printer"

  1. Verify connectivity:
    Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100
    
  2. Check firewall configuration

Data arrives as binary/garbage

  • Verify you are using the Generic / Text Only driver
  • DO NOT use "Microsoft Software Printer Driver"

Printer doesn't appear in the list

Restart-Service Spooler

Configuration Summary

Parameter Value
Server printer.emiliavision.com
Port 9100
Protocol RAW
Driver Generic / Text Only

Configuration Complete!

For technical support, contact the Emilia Vision team.