QISHU DOCUMENT ARCHIVE
Qishu Archives
A shared entry for product documents, interface references, engineering notes, and release-ready delivery records.
commands / esc/boxliy
ESC Boxliy
ESC commands exposed by EscBoxliy.
EscBoxliy is the base NIB ESC family for common thermal printing, media setup, and device queries.
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 |
|---|---|---|---|---|
reset()Print and layout | 1B 40 | - | Initializes ESC printer state. | - |
newLine()Print and layout | 0A | - | Prints a line feed. | Exposed by the Java SDK. |
feed(lines) / lineRow(rows)Print and layout | 1B 64 {lines} | lines: number of feed lines. | Feeds by line count. | Exposed by Java; TypeScript currently uses lineDot. |
lineDot(dot)Print and layout | 1B 4A {dot} | dot: feed distance in dots. | Feeds forward by dots. | - |
backLineDot(dot)Print and layout | 10 FF 81 {dot} | dot: reverse feed distance in dots. | Feeds backward by dots. | - |
location(loc)Print and layout | 1B 61 {loc} | loc: alignment value. | Sets text alignment. | - |
line(x, y)Print and layout | 00 01 {x} {y} | x/y: line parameters. | Writes the Boxliy line command. | Exposed by TypeScript. |
cut()Print and layout | 1D 56 00 | - | Cuts paper. | - |
lineDotCut()Print and layout | 1D 56 42 01 | - | Feeds a short distance and cuts. | - |
position()Print and layout | 1D 0C | - | Positions the current label or media. | - |
image(...)Images and graphics | 1D 76 30 {mode} {widthL} {widthH} {heightL} {heightH} {bitmap} | image, threshold, reverse, compress, mode. | Sends an ESC raster image. | Compressed mode uses the 1F 00 header. Grayscale is listed under Lin8inch. |
thickness(level) / line(thickness)Paper and media | 10 FF 10 00 {level} | level: density or line thickness level. | Sets density/thickness-like parameter. | - |
learnLabelGap()Paper and media | 10 FF 03 | - | Starts label gap learning. | - |
paperType(type)Paper and media | 10 FF 10 03 {type} | type: paper type enum. | Sets paper type. | - |
queryBatteryLevel() / batteryVolume()Status queries | 10 FF 50 F1 | - | Queries battery level. | - |
queryStatus() / state() / status()Status queries | 10 FF 40 / 10 FF FE 20 | - | Queries printer status. | The state command differs between SDK versions; follow the source for the target language. |
queryDeviceInfo() / info()Device information | 10 FF 70 | - | Queries device information. | - |
queryModel() / model()Device information | 10 FF 20 F0 | - | Queries model. | - |
queryFirmwareVersion() / version()Device information | 10 FF 20 F1 | - | Queries firmware version. | - |
printerVersion()Device information | 10 FF 20 FF / 10 FF 20 F1 | - | Queries printer version. | Java and TypeScript currently emit different bytes. |
querySerialNumber() / sn()Device information | 10 FF 20 F2 | - | Queries serial number. | - |
name()Device information | 10 FF 30 11 | - | Queries Bluetooth/device name. | - |
mac()Device information | 10 FF 30 12 | - | Queries MAC address. | - |
nn()Device information | 10 FF 20 F9 | - | Queries NN device information. | Exposed by TypeScript. |
enable()Device settings | 10 FF FE 01 | - | Enables the device or print task. | - |
stopJob()Device settings | 10 FF FE 45 | - | Stops the current job. | - |
wakeup(length)Device settings | 00 ... 00 | length: defaults to 12 zero bytes. | Wakes the device. | - |
setBTType()Device settings | 1F B2 10 | - | Sets Bluetooth type or transport mode. | - |
setShutdownTime(time)Device settings | 10 FF 12 {timeH} {timeL} | time: auto-shutdown value. | Sets auto-shutdown time. | Exposed by TypeScript. |
getShutdownTime()Device settings | 10 FF 13 | - | Queries auto-shutdown time. | Exposed by TypeScript. |
setCurrentTime(options)Device settings | 10 FF 14 02 {sec} {min} {hour} {day} {week} {month} {year} | Time fields, defaulting to 0. | Sets current device time. | Exposed by TypeScript. |
raw(...)Composites and aliases | Caller-provided raw bytes or text. | bytes/template. | Escape hatch for commands not wrapped by the SDK. | - |