inno-installers/PrinterInstaller/README.md

WJDT Printer Installer

Universal printer installer for network printers and card printers from ShopDB database.

Overview

This Inno Setup installer queries the ShopDB database for HP, Xerox, and HID printers, allows users to select which printers to install, and automatically:

• Installs appropriate printer drivers (HP UPD, Xerox Universal, HID FARGO DTC4500e)
• Creates TCP/IP Standard Printer Ports for network printers using FQDN or IP addresses
• Installs USB drivers for card printers (plug-and-play after driver installation)
• Adds selected printers to Windows

Features

• Database Integration: Queries ShopDB database via REST API at http://192.168.122.151:8080/api_printers.asp
• Multi-Printer Selection: Checkbox interface to select one or more printers (network or card printers)
• Smart Driver Installation:
  • HP Universal Print Driver PCL6 (x64 v7.9.0 and x32 v7.9.0)
  • Xerox Universal Print Driver PCL6 (x64 v5.1055.3.0 and x32 v5.1055.3.0)
  • HID FARGO DTC4500e Card Printer Driver (x64 v5.5.0.0)
  • Automatically selects correct driver based on Windows architecture
• Network Printer Support: Uses printer FQDN (preferred) or IP address for TCP/IP connectivity
• Card Printer Support: USB-connected badge/ID card printers (HID FARGO)
• Professional UI: Custom branding with GEA logo and Patrick artwork
• Admin Installation: Requires administrator privileges

Requirements

To Build

• Inno Setup 6.x installed on Windows
• Printer drivers in drivers/ subdirectories (already included)
• Access to build machine

To Run

• Windows 10/11 (32-bit or 64-bit)
• Administrator privileges
• Network access to ShopDB server (192.168.122.151:8080)

Project Structure

PrinterInstaller/
├── PrinterInstaller.iss         # Main Inno Setup script
├── README.md                     # This file
├── gea-logo.ico                  # Application icon
├── patrick.bmp                   # Large wizard image (164x314px)
├── patrick-sm.bmp                # Small wizard image (55x58px)
└── drivers/
    ├── hp_x64/                   # HP Universal Print Driver x64
    │   ├── hpcu345u.inf          # Main driver INF file
    │   └── ...                   # Supporting files
    ├── hp_x32/                   # HP Universal Print Driver x32
    │   ├── hpcu345u.inf
    │   └── ...
    ├── xerox_x64/                # Xerox Universal Print Driver x64
    │   └── UNIV_5.1055.3.0_PCL6_x64_Driver.inf/
    │       ├── x3UNIVX.inf       # Main driver INF file
    │       └── ...
    ├── xerox_x32/                # Xerox Universal Print Driver x32
    │   ├── x3UNIVX.inf           # Main driver INF file
    │   └── ...
    └── hid_dtc4500e_x64/         # HID FARGO DTC4500e Card Printer x64
        ├── DTC4500e.inf          # Main driver INF file
        ├── DTC4500e_x64.cat      # Digital signature catalog
        └── ...                   # Supporting DLLs and files

Building the Installer

On Windows

1. Open Inno Setup Compiler
2. File → Open → Select PrinterInstaller.iss
3. Build → Compile (or press F9)
4. Output file created at: C:\Users\570005354\Downloads\Output\PrinterInstaller.exe

Command Line

"C:\Program Files (x86)\Inno Setup 6\ISCC.exe" "C:\path\to\PrinterInstaller.iss"

Installation Process

When a user runs PrinterInstaller.exe:

1. Welcome Page: Explains what the installer does
2. Query Database: Fetches list of active HP/Xerox printers from ShopDB
3. Printer Selection: User selects which printers to install (checkboxes)
4. Ready Page: Confirms selections
5. Driver Installation:
   • Extracts drivers to temp folder
   • Uses pnputil to add driver packages
   • Adds print drivers with Add-PrinterDriver
6. Printer Installation:
   • Creates TCP/IP printer ports for each printer
   • Adds printers with appropriate drivers
7. Summary: Shows installation results

How It Works

Database Query

The installer queries the ShopDB API which returns JSON:

[
  {
    "printerid": 6,
    "printerwindowsname": "Coaching 112 LaserJet M254dw",
    "fqdn": "Printer-10-80-92-52.printer.geaerospace.net",
    "ipaddress": "10.80.92.52",
    "vendor": "HP",
    "modelnumber": "Color LaserJet M254dw",
    "isactive": 1
  },
  ...
]

Driver Mapping

Vendor	Driver Name	INF File (x64)	INF File (x32)
HP	HP Universal Printing PCL 6	hpcu345u.inf	hpcu345u.inf
Xerox	Xerox Global Print Driver PCL6	x3UNIVX.inf	x3UNIVX.inf

Printer Port Naming

Format: IP_<FQDN or IP Address>

Examples:

• IP_Printer-10-80-92-52.printer.geaerospace.net
• IP_10.80.92.52

Supported Printers

HP Models (23 printers)

• Color LaserJet M254dw
• Color LaserJet M255dw
• HP DesignJet T1700dr PS
• LaserJet 4250tn
• LaserJet M406
• LaserJet M454dn
• LaserJet M506
• LaserJet M602
• LaserJet P3015dn
• LaserJet Pro 4001n
• LaserJet Pro 4100dn
• And more...

Xerox Models (12 printers)

• Altalink C8135
• Versalink B405DN
• Versalink B7125
• Versalink C7125
• Xerox EC8036

HID Card Printers (USB)

• HID FARGO DTC4500e - Dual-sided card printer for badge/ID printing
  • Connection: USB
  • Driver installed, device auto-configures on USB connection
  • Used for employee badges, access cards, ID cards

Command-Line Parameters

Auto-Select Specific Printer

Pre-select a specific printer by name using the /PRINTER parameter:

PrinterInstaller.exe /PRINTER="CSF04-WJWT05-ColorLaserJetM254dw"

This will:

• Launch the installer normally
• Automatically check the matching printer(s) in the selection list
• Allow user to proceed with installation or modify selection

Use cases:

• Create direct download links for specific printers on your website
• QR codes that install specific printers
• Department-specific installer shortcuts

Partial matching supported:

PrinterInstaller.exe /PRINTER="CSF04"      # Matches CSF04-WJWT05-ColorLaserJetM254dw
PrinterInstaller.exe /PRINTER="Coaching"   # Matches all Coaching printers
PrinterInstaller.exe /PRINTER="LaserJet"   # Matches all LaserJet printers

Silent Installation

Run installer silently (no UI):

PrinterInstaller.exe /VERYSILENT /NORESTART

Combine with auto-select for fully automated installation:

PrinterInstaller.exe /PRINTER="CSF04" /VERYSILENT /NORESTART

Troubleshooting

"Failed to query printers"

• Check network connectivity
• Verify ShopDB server is accessible at http://192.168.122.151:8080
• Test API manually: http://192.168.122.151:8080/api_printers.asp

"Driver installation failed"

• Ensure running as Administrator
• Check Windows version compatibility
• Verify driver files are present in drivers/ folder

"Printer already exists"

• Normal behavior - installer skips existing printers
• Delete printer from Windows first if you want to reinstall

Multiple Architecture Support

• Both HP and Xerox drivers support 32-bit (x86) and 64-bit (x64) Windows
• Installer automatically detects Windows architecture and uses appropriate drivers
• All printers (HP and Xerox) work on both 32-bit and 64-bit systems

API Endpoint

The installer expects a REST API at:

GET http://192.168.122.151:8080/api_printers.asp

Returns JSON array of printer objects with fields:

• printerid (number)
• printerwindowsname (string)
• fqdn (string)
• ipaddress (string)
• vendor (string: "HP" or "Xerox")
• modelnumber (string)
• isactive (number: 1 or 0)

Customization

Change Database Server

Edit PrinterInstaller.iss line 67:

'    $url = "http://YOUR-SERVER:PORT/api_printers.asp"' + #13#10 +

Add More Vendors

1. Add driver files to drivers/ folder
2. Update [Files] section to include new drivers
3. Modify Install-PrinterDriver function to support new vendor
4. Update Install-NetworkPrinter function for driver mapping

Change Branding

Replace these files:

• gea-logo.ico - Application icon (32x32 or 48x48)
• patrick.bmp - Large wizard image (164x314px)
• patrick-sm.bmp - Small wizard image (55x58px)

Version History

Version 1.0 (2025-10-15)

• Initial release
• Support for HP and Xerox printers
• Database integration with ShopDB
• TCP/IP installation via FQDN
• x64 and x32 architecture support
• HP Universal Print Driver v7.9.0
• Xerox Global Print Driver v5.1055.3.0

Credits

• Development: WJDT
• Template: Based on MappedDrive.iss
• Drivers: HP Inc., Xerox Corporation
• Installer Framework: Inno Setup by Jordan Russell

License

Internal use only - WJDT / GE Aerospace