Troubleshooting Print Agent

My USB Printer Isn’t Supported

Currently, the RFIDLinked Print Agent supports:

  • Network printers: Any network-enabled, ZPL-based RFID printer

  • USB printers: Chainway CP30 only

If you are attempting to use a USB-connected printer that is not supported, please contact RFIDLinked Support to see if support can be added for your specific hardware.


Where Can I Find Information About the Print Agent?

The RFIDLinked Print Agent includes an About section that provides useful diagnostic information, including:

  • The currently installed Print Agent version

  • Links to application log files

  • Build and runtime details that may be requested by support

To access this information:

  1. Open the RFIDLinked Print Agent.

  2. Navigate to About from the left navigation.

When contacting support, including details from the About section can help speed up troubleshooting.



The Print Agent Is Installed but Not Detected by the Web App

If the web application does not detect the Print Agent:

  • Confirm the Print Agent is running (visible in the system tray or menu bar)

  • Try restarting the Print Agent

  • Open Print Agent and click on About. Verify that both the "Worker Service" and "Api Service" entries have green check marks and indicate running.

If the issue persists, review the log files available from the About section or contact support.


Windows-Specific Troubleshooting

Checking Which USB Driver Is Installed

If you are using a Chainway CP30 USB printer and it is not detected or not functioning correctly, the issue may be related to the installed USB driver.

To check the installed driver:

  1. Ensure the printer is powered on and the USB cable is plugged into the computer.

  2. Right-click the Start Menu and select Device Manager.

  3. Locate the CP302 under one of the following sections:

    • Universal Serial Bus devices

    • Other devices

  4. Right-click the device and select Properties.

  5. Review the Driver tab to see the installed driver details and verify the following:

    • Driver Provider: RFIDLinked Inc.
    • Driver Version: 1.0.0.2 or newer.


Reinstalling the Chainway CP30 USB Driver

If the driver appears incorrect or corrupted, reinstalling the USB driver may resolve the issue.

General steps:

  1. With the CP30 connected to your computer.

  2. In Device Manager, right-click the CP30 device and select Uninstall device.

  3. If prompted, check Delete the driver software for this device.

  4. Restart your computer.

  5. Reinstall the RFIDLinked Print Agent (this will reinstall the required USB driver).

  6. Reconnect the CP30 after installation completes.

  7. After reinstalling, reopen Device Manager and confirm the CP30 is listed correctly.



Manually Re-installing the Chainway CP30 USB Driver

Alternatively, you can manually install the CP30 driver by:

  1. With the CP30 connected to your computer

  2. In Device Manager, right-click the CP30 device and select Update Driver

  3. Select Browse my computer for drivers

  4. The driver should be located under the install directory for the Print Agent software, typically found at "c:\program files\RFIDLinked Print Agent\driver\cp30"

  5. The driver should be detected / listed as CP30 USB RFID Enabled Printer





Adjusting Windows Firewall / Print Agent is Running but unable to be communicated with during Printing

If the Print Agent is running, the About section of Print Agent shows that the Api Service and Service Worker are both running, but when you attempt to print via the web app, it is unable to communicate with the Print Agent, Windows Firewall might be blocking access.


To confirm or adjust the windows firewall rules in Windows 11, please follow these steps:

1. Open Settings: Type “Settings” in the Start menu search and press Enter.

2. Navigate: Settings → Privacy & securityWindows SecurityFirewall & network protection.


3. Click Allow an app through the firewall. 

4.  Click Change settings (you’ll need administrator rights; UAC may prompt).
5.  Find the RFIDLinked Print Agent in the list and check Private and Public; then click OK.


MacOS-Specific Troubleshooting

This section covers troubleshooting steps specific to macOS.


When to Contact Support

If you are unable to resolve the issue after following the steps in this article, please contact RFIDLinked Support and include:

  • Your operating system and version

  • Print Agent version (from the About section)

  • Printer model and connection type (USB or Network)

  • Relevant log files, if available

Providing this information upfront will help us diagnose and resolve the issue more quickly.

Tags