Switch to WebUSB - Dutchie POS

Dutchie POS now supports WebUSB, which allows you to connect receipt and label printers to your Registers without PrintNode and also allows you to connect an A&D scale without the 232key app. Making this switch streamlines your point-of-sale hardware setup, simplifies troubleshooting, and requires no new hardware.

PrintNode is now only required for Backoffice label printers and remote fulfillment printing (i.e., multiple registers printing pick tickets to the same receipt printer). We recommend switching all other printers to WebUSB.

Remove printers from PrintNode

To switch point of sale receipt and label printers to WebUSB, first remove them from PrintNode. 

Only remove a printer from PrintNode if you are connecting it directly to a Register via USB. Printers used for remote fulfillment printing or for printing product or exit labels from the Backoffice should remain in PrintNode.

  1. Go to https://api.printnode.com/app/login and sign in with the PrintNode email and password shown in the Dutchie Backoffice under Settings > Devices > Printers.
    printnode web_sign in.png
    bo_settings_devices_printers_printnode email and password.png
  2. In PrintNode, select Devices.
  3. Click the trash icon next to a printer you want to switch to WebUSB. 
    printnode web_delete printer.png
    If you don't see a trash icon, open the PrintNode desktop app and deactivate the printer(s) you want to remove by unchecking the boxes in the Printers tab, then quit the PrintNode app.
    printnode client_printers deactivated.png
  4. Repeat for all other printers you want to switch to WebUSB.
  5. In the Dutchie Backoffice, go to Settings > Devices > Printers and click Sync printers.
  6. Refresh the page. The printers you removed from PrintNode should disappear from the list of printers below.
    bo_settings_devices_printers_sync printers button.png

Windows only: Install printer drivers

A third-party driver must be installed on each printer to support WebUSB connection to Windows computers or Surface tablets. Mac users can skip this section.

Once you've installed this driver, you won’t need to manage or install printers through Windows device settings anymore and you will be able to manage all printer connections directly in the Chrome web browser.

Download the Zadig application

Zadig is a Windows application that is used to install the required USB driver on your printer(s). To get started, download and run the .exe file. 

zadig .exe file on github.png

When asked if you want to allow the app to make changes to your device, click Yes.

Connect printers

Connect a receipt or label printer to your Windows device using a USB cable. You can use a USB hub or adapter as needed. Connect only one printer at a time.

Install the driver

These steps will replace any driver previously installed on the printer, and as a result, the printer may no longer work with applications other than Dutchie POS (including PrintNode) unless you uninstall the Zadig driver and restore the original driver.

  1. Open the Zadig application and select Options > List all devices.
    zadig_list all devices.png
  2. Choose your printer from the dropdown.
    zadig_select printer.png
  3. Click Reinstall Driver. Installation may take several minutes.
    zadig_reinstall driver.png
  4. Repeat the above steps for all printers that you want to connect via WebUSB, including both receipt and label printers.

Set up printers in the Register

Receipt, fulfillment, z-report, and label printers all have the same setup steps, except that label printers also have a default label selection:

label printer.gif
  1. Connect your receipt printer and/or label printer to your Register device via USB. You can use USB hubs or adapters as needed.
  2. Select Settings from the left navigation menu.
    reg_menu_settings button.png
  3. Select Label printer or Receipt printer.reg_settings_receipt printer label printer.png
  4. Select Add new printer.
    reg_settings_receipt printer_add new printer.png
  5. Select Authorize printer.
    reg_settings_receipt printer_authorize printer.png
  6. A browser pop-up will show connected devices. Select your printer and then Connect.
    chrome_connect receipt printer dialog.png
  7. Click Done.
    reg_settings_receipt printer_authorize printer_done.png
  8. Your printer should now appear in the dropdown. Choose whether to Auto-print receipts/Auto-print labels, and Print a test receipt or label.
    reg_settings_receipt printer_auto print on_test print.pngFor label printers, also select the Default label that this register should use.
    reg_settings_label printer_default label.png
  9. Click Save settings and then Return to settings to connect another printer.

If you use a USB barcode scanner connected to a Star mC-Print3 receipt printer, connect and configure the scanner once you've connected the receipt printer.

Set up an A&D scale in the Register

WebUSB connection is not supported for non-A&D scales. If your scale is a different brand, continue using the 232key app to connect to a Dutchie Register.

scale.gif

  1. Use an RS232 serial cable and USB-to-serial adapter to connect your A&D scale to your register device. You can use a USB hub or adapter if you need additional USB ports or your device has USB-C ports.
  2. Sign in to the Dutchie Register and select Settings from the left navigation menu.
    reg_menu_settings button.png
  3. Select Scale.
    reg_settings_scale.png
  4. Select Add new scale.
    reg_settings_scaler_add new scale.png
  5. Select Authorize scale.
    reg_settings_scale_authorize scale.png
  6. A browser dialog will prompt you to connect to a serial port or USB-serial controller. Click Connect.
    reg_settings_scale_authorize scale chrome permissions dialog.png
  7. Click Done.
    reg_settings_scale_add new scale_done.png
  8. Click Advanced settings and then Auto-configure scale.
    reg_settings_scale_autoconfigure scale.png
  9. Click Save. You should now see the weight reading from the scale appear in the Test weight reading field in the Register. You may need to press the PRINT button on your scale to transmit the weight reading.
    reg_settings_scale_test weight reading.png

Remove a WebUSB device

To remove a WebUSB device, reset its WebUSB permission in your Chrome settings:

  1. Click the three vertical dots near the upper right of your Chrome window and select Settings.chrome settings.png
  2. Navigate to Privacy and security > Site Settings > Additional permissions. 
    chrome permission 1.pngchrome permission 2.png
  3. Under USB devices, click the trash icon next to the device you want to remove.chrome permission 3.png
    chrome permission 4.png

What's next?

Was this article helpful?