ge-aerospace/inno-installers
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ef66a3444345014861607205aa147ccb5c2b78ba
inno-installers/PrinterInstaller/INTEGRATION_SUMMARY.md
cproudlock 28541cd3ed Initial commit: Inno Setup installer packages 
Installer packages for GE manufacturing tools:
- BlueSSOFix: Blue SSO authentication fix
- HIDCardPrinter: HID card printer setup
- HPOfflineInstaller: HP printer offline installer
- MappedDrive: Network drive mapping
- PrinterInstaller: General printer installer
- ShopfloorConnect: Shopfloor connectivity tool
- XeroxOfflineInstaller: Xerox printer offline installer

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 13:15:54 -05:00

4.8 KiB
Raw Blame History

HID Card Printer Integration Summary

Date: 2025-10-24
Project: PrinterInstaller (Unified Printer Installer)

What Was Done

Successfully integrated HID FARGO DTC4500e card printer support into the existing PrinterInstaller project, creating a unified installer for both network printers and USB card printers.

Changes Made

1. Driver Files Added

  • Location: /home/camp/projects/inno/PrinterInstaller/drivers/hid_dtc4500e_x64/
  • Files: Complete HID FARGO DTC4500e driver package (v5.5.0.0)
    • DTC4500e.inf (main driver file)
    • DTC4500e_x64.cat (digital signature)
    • All supporting DLLs, help files, color profiles, test prints

2. Code Updates in PrinterInstaller.iss

Database Query (Lines 81-96)

  • Added HID vendor support to API query filter
  • Added logic to handle USB vs network printer addresses
  • HID printers automatically get "USB" as their address

[Files] Section (Lines 44-45)

  • Added HID driver files to be extracted to temp directory
  • Only x64 support for now (can add x32 later if needed)

Install-PrinterDriver Function (Lines 462-464)

  • Added HID case to driver name mapping
  • Maps to "HID FARGO DTC4500e Card Printer" driver
  • Uses DTC4500e.inf file

Install-NetworkPrinter Function (Lines 625-639)

  • Added HID to driver name mapping
  • Added USB printer detection logic
  • USB printers don't create TCP/IP ports
  • Driver installation only - Windows auto-configures on USB connection

Driver Installation Section (Lines 694-700)

  • Added HID driver installation call alongside HP and Xerox
  • Calls Install-PrinterDriver for HID with path to extracted drivers

3. Documentation Updates

PrinterInstaller/README.md

  • Updated title and overview to include card printers
  • Added HID to features list
  • Added hid_dtc4500e_x64 to project structure
  • Added "HID Card Printers (USB)" section to supported printers
  • Documented USB connection and auto-configuration behavior

Welcome Message (Line 29)

  • Updated to mention both network and card printers
  • Added HID FARGO DTC4500e to printer types
  • Added USB connection information

Error Messages (Lines 266-269)

  • Updated to include HID printers in supported types
  • Changed "network printers" to "printers" for accuracy

How It Works

For Database Administrators

  1. Add HID card printer to ShopDB database
  2. Set vendor field to "HID"
  3. Set fqdn/ipaddress field to anything (will be overridden to "USB")
  4. Mark as active (isactive = 1)

For End Users

  1. Run PrinterInstaller.exe
  2. Select HID card printer from checkbox list
  3. Installer installs driver package using pnputil
  4. User plugs in USB card printer
  5. Windows auto-detects and configures using installed driver
  6. Printer appears in "Devices and Printers"

Comparison: Network vs Card Printers

Feature Network Printers Card Printers
Vendors HP, Xerox HID
Connection TCP/IP (Ethernet) USB
Port Creation Yes (Add-PrinterPort) No (USB auto)
Address Format FQDN or IP "USB"
Installation Driver + Port + Printer Driver only
Auto-configuration No Yes (plug-and-play)

Testing Checklist

  • Build installer on Windows with Inno Setup
  • Test with HID printer in database
  • Verify driver extraction to temp folder
  • Confirm pnputil installs driver successfully
  • Check Windows detects USB device after driver install
  • Verify printer appears in Devices and Printers
  • Test alongside network printer selection

Future Enhancements

  1. Add x32 Support for HID

    • Extract x32 driver files from MSI
    • Add to drivers/hid_dtc4500e_x32/
    • Update [Files] section with Check: not Is64BitInstallMode

  2. Support Multiple HID Models

    • Add DTC1250e, HDP5000, etc.
    • Update Install-PrinterDriver to map models correctly
    • Add conditional logic based on model field from database

  3. Better USB Detection

    • Check if USB device is currently connected
    • Provide more specific instructions per model
    • Detect if driver is already in use

Files Modified

  1. /home/camp/projects/inno/PrinterInstaller/PrinterInstaller.iss
  2. /home/camp/projects/inno/PrinterInstaller/README.md

Files Added

  1. /home/camp/projects/inno/PrinterInstaller/drivers/hid_dtc4500e_x64/* (all driver files)
  2. /home/camp/projects/inno/PrinterInstaller/INTEGRATION_SUMMARY.md (this file)

Benefits of Unified Installer

  1. Single Tool: Users install all printer types from one installer
  2. Consistent UI: Same selection interface for all printers
  3. Database Driven: IT controls which printers appear
  4. Easier Maintenance: One codebase instead of two
  5. Better User Experience: No confusion about which installer to use

Status: ✅ Complete and ready for testing on Windows

Reference in New Issue View Git Blame Copy Permalink