启枢科技文档

启枢档案馆

这里是后续撰写产品文档的入口页。左侧负责文档分类与章节层级，右侧保留正式文档正文、提示块、代码、表格与上一页 / 下一页的位置。

commands / esc/boxliy

ESC Boxliy

EscBoxliy 支持的 ESC 指令清单。

EscBoxliy 是 NIB ESC 指令的基础 Family，覆盖常见热敏打印、纸张设置和设备查询。

Boxliy 命令清单

具体机器支持哪些协议、Family 和参数值，需要以目标机器固件为准；机器支持列表请联系开发人员或客服确认。

SDK 方法	实际指令	参数	作用	返回 / 备注
`reset()` 打印与版面	`1B 40`	-	初始化 ESC 打印机状态。	-
`newLine()` 打印与版面	`0A`	-	输出换行。	Java SDK 暴露。
`feed(lines) / lineRow(rows)` 打印与版面	`1B 64 {lines}`	lines: 走纸行数。	按行走纸。	Java SDK 暴露；TypeScript 当前使用 lineDot。
`lineDot(dot)` 打印与版面	`1B 4A {dot}`	dot: 走纸点数。	按点数正向走纸。	-
`backLineDot(dot)` 打印与版面	`10 FF 81 {dot}`	dot: 回退点数。	按点数反向走纸。	-
`location(loc)` 打印与版面	`1B 61 {loc}`	loc: 对齐值。	设置打印对齐方式。	-
`line(x, y)` 打印与版面	`00 01 {x} {y}`	x/y: 线段参数。	写入 Boxliy 线条指令。	TypeScript SDK 暴露。
`cut()` 打印与版面	`1D 56 00`	-	执行切纸。	-
`lineDotCut()` 打印与版面	`1D 56 42 01`	-	走纸后切纸。	-
`position()` 打印与版面	`1D 0C`	-	定位标签或当前位置。	-
`image(...)` 图片与图形	`1D 76 30 {mode} {widthL} {widthH} {heightL} {heightH} {bitmap}`	image、threshold、reverse、compress、mode。	发送 ESC 光栅图片。	压缩模式使用 1F 00 头。灰度位图见 Lin8inch。
`thickness(level) / line(thickness)` 纸张 / 介质	`10 FF 10 00 {level}`	level: 打印浓度或线条厚度等级。	设置浓度/厚度类参数。	-
`learnLabelGap()` 纸张 / 介质	`10 FF 03`	-	触发标签间隙学习。	-
`paperType(type)` 纸张 / 介质	`10 FF 10 03 {type}`	type: 纸张类型枚举。	设置纸张类型。	-
`queryBatteryLevel() / batteryVolume()` 状态查询	`10 FF 50 F1`	-	查询电量。	-
`queryStatus() / state() / status()` 状态查询	`10 FF 40 / 10 FF FE 20`	-	查询设备状态。	不同 SDK 版本中 state 的底层指令存在差异，按目标语言源码为准。
`queryDeviceInfo() / info()` 设备信息	`10 FF 70`	-	查询设备信息。	-
`queryModel() / model()` 设备信息	`10 FF 20 F0`	-	查询型号。	-
`queryFirmwareVersion() / version()` 设备信息	`10 FF 20 F1`	-	查询固件版本。	-
`printerVersion()` 设备信息	`10 FF 20 FF / 10 FF 20 F1`	-	查询打印机版本。	Java 与 TypeScript 当前输出不同。
`querySerialNumber() / sn()` 设备信息	`10 FF 20 F2`	-	查询序列号。	-
`name()` 设备信息	`10 FF 30 11`	-	查询蓝牙名称或设备名称。	-
`mac()` 设备信息	`10 FF 30 12`	-	查询 MAC 地址。	-
`nn()` 设备信息	`10 FF 20 F9`	-	查询设备 NN 信息。	TypeScript SDK 暴露。
`enable()` 设备设置	`10 FF FE 01`	-	使能设备或打印任务。	-
`stopJob()` 设备设置	`10 FF FE 45`	-	停止当前任务。	-
`wakeup(length)` 设备设置	`00 ... 00`	length: 默认 12 个 0 字节。	唤醒设备。	-
`setBTType()` 设备设置	`1F B2 10`	-	设置蓝牙类型或传输模式。	-
`setShutdownTime(time)` 设备设置	`10 FF 12 {timeH} {timeL}`	time: 自动关机时间。	设置自动关机时间。	TypeScript SDK 暴露。
`getShutdownTime()` 设备设置	`10 FF 13`	-	查询自动关机时间。	TypeScript SDK 暴露。
`setCurrentTime(options)` 设备设置	`10 FF 14 02 {sec} {min} {hour} {day} {week} {month} {year}`	时间字段，缺省为 0。	设置设备当前时间。	TypeScript SDK 暴露。
`raw(...)` 组合方法 / 别名	`调用方提供的原始 bytes 或文本。`	bytes/template。	逃生口：发送 SDK 尚未封装的指令。	-