标签设备

Zebra ZPL Datamatrix 码 ^BX 语法说明

Admin2026年10月14日

语法格式

^BXo,h,s,c,r,f,g,a

紧跟 _^BX 后面用逗号分隔参数；参数可留空用逗号占位，末尾不填则使用默认值；条码数据放在后面 _^FDxxx^FS

参数	名称	取值说明
o	旋转方向 Orientation	N 正常 (0°)；R 顺时针 90°；I 180° 倒置；B 270°(从下往上读) 默认：继承 ^FW 设置
h	模块单元高度 (dot)	单个 DM 码小黑方块的边长，1~ 标签宽度；0 / 留空则读取^BY模块高度
s	ECC 纠错等级 Quality	0,50,80,100,140,200 新项目必须用 200 (ECC200，Reed-Solomon)；0~140 是旧卷积编码，仅封闭场景使用
c	列数 Columns	9~49；ECC0~140 只能奇数；ECC200 只能偶数；填0自动适配数据选择符号尺寸
r	行数 Rows	9~49；填0自动适配数据选择符号尺寸
f	Format ID 字符集	仅 ECC0~140 生效，ECC200 忽略 1: 纯数字 + 空格 2: 大写字母数字 + 空格 3: 字母数字 + . , - / 符号 4: 同 2 5:7 位 ASCII 6: 完整 8bit ISO（默认）
g	转义控制字符 Escape char	默认 ~；GS1-DM 强烈建议设为_ 仅 ECC200 生效，用于嵌入 FNC1 等特殊控制序列 _1 = FNC1
a	宽高比 Aspect Ratio	新增参数（新版固件） 1= 正方形 (默认)；2= 矩形 DataMatrix

重点：ECC200 是工业 / UDI/GS1 标准，推荐固定 s=200，c=0,r=0，g=_，让打印机自动选择 DM 符号尺寸

^XA
^FO50,50^BXN,7,200,0,0,,_
^FDABC123456^FS
^XZ

^XA
^FO50,50^BXN,7,200,0,0,,_
^FD_101069012345678921SN123456^FS
^XZ

_{_1} 代表 FNC1，GS1 前缀，后面跟随 AI + 数据

^XA
^FO50,50^BXN,6,200,16,8,,_,2
^FDRECT-DM-TEST^FS
^XZ

_^FH 开启十六进制转义模式，放在 _^FD 之前。_{_} 作为十六进制前缀，_{_XX} 代表一字节十六进制值。

注意：_^BX 的 g 参数（DM 内部转义符）和 _^FH 的前缀不要冲突；推荐_^FH使用默认_{_}，若冲突可通过_^FH^修改前缀。

原始文字：_{测试中文123} UTF8 字节序列：E6 B5 8B E8 AF 95 E4 B8 AD E6 96 87 31 32 33 转为 ZPL：_{_E6_B5_8B_E8_AF_95_E4_B8_AD_E6_96_87123}

^XA
^FO50,50^BXN,7,200,0,0,,_
^FH^FD_E6_B5_8B_E8_AF_95_E4_B8_AD_E6_96_87123^FS
^XZ

写入二进制：0x00 0x0A ABC ZPL：_{_00_0AABC}

^XA
^FO50,50^BXN,7,200,0,0,,_
^FH^FD_00_0AABC^FS
^XZ

FNC1：_{_1}（DM 内部转义，由 ^BX 的 g=_控制），和 ^FH 的_{_}共存，注意区分

^XA
^FO50,50^BXN,7,200,0,0,,_
^FH^FD_1010690123456789_E6_B5_8B_E8_AF_95^FS
^XZ

说明：

当业务同时大量使用 DM 内部_{_1}(FNC1) + ^FH 十六进制_{_XX}，部分固件解析歧义。解决：修改 ^FH 前缀为_^

^FH^,^FD^E6^B5^8B^E8^AF^95^FS

_^FH^,：设置 ^FH 转义前缀为_^，不再使用_{_}，_{_}仅留给 DM 内部 FNC1 _{_1}。