QISHU DOCUMENT ARCHIVE
Qishu Archives
A shared entry for product documents, interface references, engineering notes, and release-ready delivery records.
commands / cpcl/boxliy
CPCL Boxliy
CPCL commands exposed by CpclBoxliy.
CpclBoxliy is the base NIB CPCL family for page-style labels and mobile label printers.
Boxliy Command list
The supported protocols, families, and parameter values depend on the target firmware. Ask engineering or support for the printer support list.
| SDK method | Emitted command | Parameters | Purpose | Response / notes |
|---|---|---|---|---|
begin(height, copies) / page(...)Print and layout | ! 0 200 200 {height} {copies} | height: page height; copies: copy count. | Starts a CPCL page. | - |
pageWidth(width)Print and layout | PAGE-WIDTH {width} | width: page width. | Sets page width. | - |
gapSense()Paper and media | GAP-SENSE | - | Enables gap sensing. | - |
barSense()Paper and media | BAR-SENSE | - | Enables black-mark sensing. | Exposed by Java. |
paperType(type)Paper and media | GAP-SENSE / BAR-SENSE / no-op | type: GAP, BLACK_MARK, CONTINUOUS. | Selects sensing command by paper type. | - |
text(...)Print and layout | T{rotation} {fontFamily} {fontSize} {x} {y} {content} | Font, size, position, content, rotation, charset. | Prints text. | - |
setMag(font)Print and layout | SETMAG {ex} {ey} | font: font enum. | Sets font magnification. | Exposed by TypeScript. |
bold(enable)Print and layout | SETBOLD 1|0 | enable: bold on/off. | Sets bold style. | - |
underline(enable)Print and layout | UNDERLINE ON|OFF | enable: underline on/off. | Sets underline style. | - |
waterMark(value) / watermark(value)Print and layout | WM {value} / WAT {value} | value: watermark value. | Sets watermark. | Java uses WM; TypeScript uses WAT. |
line(...)Print and layout | LINE ... / LPLINE ... / L ... / LP ... | Start/end points, width, dashed flag. | Draws a line. | SDKs use long or short prefixes. |
box(...)Print and layout | BOX {x1} {y1} {x2} {y2} {width} | Box bounds and line width. | Draws a box. | - |
inverse(...) / inverseLine(...)Print and layout | INVERSE-LINE {x1} {y1} {x2} {y2} {height} | Inverse area. | Draws inverse area. | - |
barcode(...)Print and layout | {rotation} {type} {width} {ratio} {height} {x} {y} {value} | Barcode type, width, ratio, height, position, value. | Prints a 1D barcode. | - |
qrcode(...)Print and layout | SETQRVER ... + QR ... + {level}A,{content} + ENDQR | Position, content, width, level, rotation. | Prints a QR code. | - |
image(...)Images and graphics | CG {byteWidth} {height} {x} {y} {bitmap} / ZG {byteWidth} {height} {xByte} {y} {len} {bitmap} | Image, position, threshold, reverse, compression. | Sends CPCL bitmap data. | - |
form()Print and layout | FORM | - | Finalizes page content. | - |
print(mode)Print and layout | PRINT / POPRINT | mode: normal or horizontal. | Starts printing. | - |
status()Status queries | ! U1 STATUS / 10 04 05 | - | Queries status. | Java emits text status query; TypeScript currently emits realtime status bytes. |
realtimeStatus()Status queries | 10 04 05 | - | Queries realtime status. | Exposed by Java. |
querySerialNumber()Device information | 10 FF EF F2 | - | Binary serial number query. | Exposed by Java. |
sn()Device information | ! U1 SN | - | Text serial number query. | Exposed by Java. |
queryModel()Device information | 10 FF EF F0 | - | Binary model query. | Exposed by Java. |
model()Device information | ! U1 MODEL | - | Text model query. | Exposed by Java. |
queryVersion()Device information | 10 FF EF F1 | - | Binary version query. | Exposed by Java. |
version()Device information | ! U1 VERSION | - | Text version query. | Exposed by Java. |
queryBatteryLevel() / batteryVolume()Status queries | 10 FF EF F3 | - | Queries battery level. | Exposed by Java. |
feed()Composites and aliases | ! 0 200 200 0 1 + PAGE-WIDTH 576 + GAP-SENSE + FORM + PRINT | - | Composite feed flow. | - |
raw(...)Composites and aliases | Caller-provided CPCL text. | template/args. | Sends an unwrapped CPCL command. | - |