Skip to content
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 methodEmitted commandParametersPurposeResponse / 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 ... 00length: 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.-