From 5defe405d6650e36e6422577d9d20057688899d0 Mon Sep 17 00:00:00 2001
From: Lance Edgar <lance@wuttaproject.org>
Date: Sun, 16 Feb 2025 00:24:47 -0600
Subject: [PATCH] Add Hardware-Zebra-QL320Plus

---
 Hardware-Zebra-QL320Plus.-.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 Hardware-Zebra-QL320Plus.-.md

diff --git a/Hardware-Zebra-QL320Plus.-.md b/Hardware-Zebra-QL320Plus.-.md
new file mode 100644
index 0000000..561e982
--- /dev/null
+++ b/Hardware-Zebra-QL320Plus.-.md
@@ -0,0 +1,32 @@
+# Zebra QL 320Plus
+
+This document contains various notes relating to the Zebra QL 320Plus mobile printer, often used for product labels.
+
+## ZPL II
+
+The QL 320Plus uses the [CPCL](https://km.zebra.com/kb/index?page=content&id=SO6753&actp=LIST_POPULAR) language by default, but also allows for [ZPL II](https://km.zebra.com/kb/index?page=content&id=SO6755) (as well as [EPL2](https://km.zebra.com/kb/index?page=content&id=SO6632&actp=LIST)) emulation.  However, getting it to "play nicely" may take some tweaking of printer settings initially.
+
+**NOTE:** *Instructions on how to send command sequences to the printer are documented [elsewhere](http://www.zebra.com/us/en/support-downloads/mobile/ql-320-plus.html#mainpartabscontainer=manuals) and will not be covered here.*
+
+### Emulation
+
+The first step in my testing was to configure the printer's emulation to use ZPL II ''instead of'' EPL2 (etc.).  This involved sending the following CPCL command to the printer:
+
+```
+! U1 setvar "device.languages" "ZPL"
+```
+
+### Calibration
+
+According to this [knowledge base article](https://km.zebra.com/kb/index?page=content&id=SO8313&actp=LIST):
+
+ If using ZPL emulation, the printer needs to be calibrated before it will recognize label lengths within ZPL.
+
+The article further references a [calibration document](https://support.zebra.com/cpws/docs/comtec/mobile_printer_calibration.htm) with some more specifics.  The step required in my testing was to send a ZPL command sequence to the printer which basically instructs it to calibrate itself:
+
+```
+~JC
+^XA
+^JUS
+^XZ
+```