Zebra Label Printer Plugin Set Up

20 Aug 2021

The label printer plugin for Mirus gives users the option to print an adhesive label that contains text and barcode information from a plot harvested with a HarvestMaster GrainGage. Any Zebra ZPL compatible printer can be used with this plugin. We have tested using the Zebra P4T and Zebra ZQ520 printers.

To set up the Zebra Printer to work with Mirus, 

  1. Install and Register the Zebra Plugin

  2. Install ZDesigner V.5 Driver for Windows

  3. Install Zebra Setup Utilities

  4. Configure Printer

  5. Setup Printer Language

  6. Customize Label with the Zebra Designer Program

  7. Finish Setup in Mirus


1. Install and Register the Zebra Plugin

  1. Verify Mirus is installed and registered on your device.

  2. Download the Zebra Label Printer Plugin to your device.

  3. Activate the plugin online or over the phone.

When the Zebra Plugin is purchased you will be sent a registration card with a serial number for the plugin. 

  1. If you chose to activate the plugin online, use the registration number, serial number, and unlock code to continue.

  1. Verify Mirus is closed.

  2. After the plugin is activated, click "Install Zebra Printer Plugin."

  3. Close the installation window.


2. Install ZDesigner V.5 Driver for Windows

  1. Go to the Zebra Printer Support and scroll down.

  2. Download the ZDesigner v. 5 Driver for Windows.

  3. Run the executable and install the driver.


3. Install Zebra Setup Utilities

  1. Verify the printer is not plugged into your device.

  2. Go to the Mobile Printer Support.

  3. Download the Zebra Setup Utilities for Windows.

  1. Run the executable and install the utility. 

    1. On the Welcome to InstallAware Wizard for Zebra Setup Utilities screen, click Next.

    2. Check the box to accept the terms. Click Next.

    3. Select the destination folder. Click Next.

    4. Select a program folder. Click Next.

    5. To complete the setup, click Finish


4. Configure Printer

  1. Plug the Zebra printer into your device.

  2. In the Zebra Setup Utilities, select "Install New Printer" and click Next.

    • The printer number can be found on the top of your printer. 

  3. On the Additional Install Options screen, verify both options are checked then click Finish.

  4. On the Zebra Printer Utilities screen under Printers, verify the correct printer is selected. 

  5. Select the USB port.

  6. Use a measuring tape to measure the dimensions of the label you will be printing on. 

  7. Under Printer Configuration, click Configure Printer Settings.

  8. On the Label Parameters screen, enter the width and height of the label. Click Next.

  1. Set the Speed and Darkness to your preference (we recommend a darkness of about 15). Click Next.

  2. Set the Media Type to your preference (we recommend Mark Sensing). Click Next.

    • Web Sensing: Used for media with inter-label gaps, notches, or holes.

  1. Configure the Advanced settings to your preference. Click Next.

  2. If necessary, you can set the Real Time Clock. Click Next.

  3. On the Front Panel Protection Screen, verify all the boxes are checked. Click Next.

  4. If necessary, manually set the Sensor Settings. Click Next.

  5. If you wish to save the settings to a file on your computer, check the box next to Save Settings to File.

  6. Select Finish.

  7. Calibrate the printer to prevent the label from starting in the incorrect position or skipping labels.

  8. Under Printer Configuration, click Open Printer Tools.

  9. Under the Action tab, click Calibrate Media > Send.


5. Setup Printer Language

  1. Verify the Zebra printer is connected to your device via USB.

  2. Open Zebra Setup Utilities.

  3. Verify the correct printer is highlighted.

  4. Click Open Communication with Printer.

  1. Enter one of the following commands.

    1. For a black mark between each label (Black Mark Media (P4T))

! U1 setvar "media.sense_mode" "bar"

! U1 setvar "device.languages" "zpl"


  1. For no black mark between each label (Gap Media QL220 Plus)

! U1 setvar "media.sense_mode" "gap"

! U1 setvar "device.languages" "zpl"


  1. Click Send to Printer.

    • The printer will feed about four labels as a system check.

    • If the printer prints random characters, it could be the default. To change the code language to ZPL, enter the following: 

! U1 setvar "device.languages" "zpl"

! U1 setvar "device.languages"


  1. After the labels stop cycling, close the screen. Do NOT save the changes. 

  2. Open Printer Tools. 

  3. To verify the printer is working correctly, select Feed one label under the Print tab and click Send.


6. Customize Label with the Zebra Designer Program

Install the Zebra Designer Program

  1. Open the ZebraDesigner3 Software Support. Scroll down to Software and select ZebraDesigner3 Software Support. 

  2. Run the executable (Zebradesigner3-321570.exe).

  3. Select your preferred language.

  4. When the installer opens, select Next.

  5. Accept the terms of the license agreement and click Next.

  6. Select the Product install path and click Next.

  7. On the Start Installation screen, click Install.

  8. After the install is complete, click Done.


Setup Label

  1. Open ZebraDesign3.

  1. Click Open...

  2. Go to C:\HarvestMaster\Mirus\Plugins\ZebraPrinterAttachment\DefaultDesignerLabels

  3. Click on the label that matches the dimensions of your label.

  4. Choose a printer. Click OK.

  5. Select File > Print

  6. Click Printer Settings.

  1. Click on the Advanced Setup tab.

  1. Under Tracking Mode, verify Mark Sensing is selected. 

  2. Click Calibrate > OK.

  3. Select Print to File.

  1. Click Print.

  2. Locate the Labels folder at C:\HarvestMaster\Mirus\Plugins\ZebraPrinterAttachment\Labels.

  3. Make sure the file type is .prn.

  1. Click Save


Additional Label Customization Option

To include the weight, moisture, and test weight as part of barcode reading,

  1. Open ZebraDesign3.

  1. Click Open...

  2. Go to C:\HarvestMaster\Mirus\Plugins\ZebraPrinterAttachment\DefaultDesignerLabels

  3. Click on the label you set up in the section above.

  4. Click on the barcode in the label.

  5. Click on the blue icon on the top right of the barcode.

  1. In the pop-up window, click on the Source tab.

    1. In the Data drop-down, select Variable keyboard input.

    2. In the Data type drop-down, select Text.

    3. Under Initial value enter HM_weight,HM_moist,HM_testw

    4. Verify Auto generated is checked. 

    5. Click Apply.

  1. Click Print.
  2. Select Print to file.

  1. Click Print.
  2. Locate the Labels folder at C:\HarvestMaster\Mirus\Plugins\ZebraPrinterAttachment\Labels.
  3. Change the file name (if desired). Make sure the file type is .prn. 

  1. Click Save.


Label Troubleshooting

If the file did not save as a .prn file,

  1. Find the default file with the dimensions for the label you selected in step 4 above.

  2. Change the file extension from .lbl to .prn. Rename the file to make it unique.

  3. Confirm the file is saved at C:\HarvestMaster\Mirus\Plugins\ZebraPrinterAttachment\Labels.

  4. Verify the file ends in .prn.

  5. When you are asked if you are sure you want to make the change, click Yes.

  6. Verify the label prints by unchecking Print to file then clicking Print.


7. Finish Setup in Mirus

  1. Take your device and printer out to your combine.

  2. Ensure your device is connected to your GrainGage via USB.

  3. Turn on the GrainGage console and open Mirus.

  4. Mirus should connect to the GrainGage.

    • If Mirus doesn't connect, click the Connect Plugin icon and select the correct GrainGage.

  5. Tap the Connect Plugin icon.

  6. Tap Attachments.

  7. Tap on the Zebra Printer icon. A green check should appear in the icon's corner.

  1. Tap the green check in the bottom right.

  2. Tap Setup.

  3. Under Zebra > Printer > Printer select the correct printer.

  1. Under Label > Label Template, select the label that you created and customized in ZebraDesigner3 from the drop-down list.

  1. If you leave the Label Trigger ID option blank, a label will be printed for each plot.

    • You can use an imported map to specify plots to print labels on. The column name can be anything you like. In the example below, we use "Print."

    • To specify if a plot should print a specific value, place that value in the print column for that plot. In the example below, we use "T." Leave the column blank for plots you don't want a printed label for. 

  1. Enter Harvest and use F3 to print a test label to verify the printer works as expected.