参数注册表

参数定义来自 proto/params_schema.json，客户端与服务端的单一真相源。 Schema 版本: 1.0.0。

各语言参数常量由 scripts/gen_params.py 自动生成（C: sdk/c/include/tijet_params.h、C++: sdk/cpp/include/tijet/params.h、Python: sdk/python/tijet_grpc/params.py、Java: Params.java、C#: Params.cs），修改参数请编辑 schema JSON 后重新运行 python3 scripts/gen_params.py all。

各语言通过编译期常量引用参数 key（如 TI_PARAM_PRINT_SPEED_TIMER），配合类型化辅助函数（ti_set_int / ti_get_int / ti_set_bool / …）使用。

打印控制指令（START_PRINT / STOP_PRINT / PAUSE_PRINT / RESUME_PRINT / ANALOG_TRIGGER）不属于参数，通过 ti_print_control() 派发。

参数列表

Key	类型	访问	默认值	约束	单位	描述
`LOG_ENABLE`	bool	读写	`True`	—	—	打印服务日志启用开关
`LOG_LEVEL`	int	读写	`2`	[0, 6]	—	打印服务日志输出级别，0为最低(任何等级都记录），6为最高（没有任何日志记录）
`BEEP_DURATION`	int	读写	`100`	[0, 10000]	ms	设备蜂鸣持续时间
`PRINT_SPEED_TIMER`	int	读写	`6250`	[6250, 49999999]	—	打印速度（定时器模式） — 数值越大，打印一份数据所需要的时间越长
`PRINT_SPEED_ENCODER`	int	读写	`0`	[0, 10000]	—	打印速度（编码器模式） — 编码器开启下的打印速度，数值越大，打印一份数据所需要的时间越长
`PRINT_DELAY_MS`	int	读写	`0`	[0, 99999999]	ms	打印延迟（毫秒） — 从触发器触发到喷头喷印之间的延迟
`PRINT_DELAY_MM`	int	读写	`0`	[0, 99999999]	mm	打印延迟（毫米） — 从触发器触发到喷头喷印之间的距离
`PRINT_INKJET_PASSES`	int	读写	`0`	[0, 4]	—	吐墨/加深打印 — 加深喷印的颜色，0为最浅，4为最深，加深喷印后喷印速度的上限将降低到原来的1/n
`PRINT_INTERVAL_MS`	int	读写	`1`	[1, 99999999]	ms	打印间隔（毫秒） — 触发间隔，一次触发多次打印的情况下，每次打印的间隔
`PRINT_INTERVAL_MM`	int	读写	`1`	[1, 99999999]	mm	打印间隔（毫米） — 编码器启用时的一次触发多次打印的情况下，每次打印的间隔
`PRINT_DIRECTION`	enum	读写	`LR`	`LR` `RL`	—	打印方向 — 打印方向，多头设备或多列的喷头设备所需的参数，影响从哪个喷头最先开始打印、哪个列最先打印
`PRINT_BURST_COUNT`	int	读写	`1`	[0, 999999999]	—	触发喷印份数 — 触发一次打印所打印的份数, 0–一直触发一直喷印，1–触发一次喷印一次，n–触发一次喷印n次
`PRINT_MIRROR_HORIZONTAL`	bool	读写	`False`	—	—	水平镜像 — 打印内容是否整体水平翻转
`PRINT_ENCODER_ENABLE`	bool	读写	`False`	—	—	编码器启用开关 — 是否启用编码器
`PRINT_ENCODER_PPR`	int	读写	`2500`	[1, 99999999]	PPR	编码器脉冲数/转 — 设定接入的编码器的转一圈的脉冲数，用于修正编码器模式下的喷印效果
`PRINT_ENCODER_DIAMETER`	int	读写	`50`	[1, 99999999]	mm	编码器滚轮直径 — 设定接入的编码器滚轮直径，用于修正编码器模式下的喷印效果
`PRINT_FLASH_JET_CONFIG`	int	读写	`0`	[0, 999]	—	喷头闪喷频次配置 — TIJ设备专用参数，定期喷出墨点防止堵头
`PRINT_FLASH_JET_LINES`	int	读写	`0`	[0, 15]	lines	喷头闪喷列数配置 — TIJ设备专用参数，定期喷出墨点防止堵头
`PRINT_TRIGGER_LEVEL`	enum	读写	`POSEDGE`	`POSEDGE` `NEGEDGE`	—	触发器信号触发模式
`PRINT_NOZZLE_ROW_SELECT`	enum	读写	`NONE`	`NONE` `A` `B`	—	喷嘴列选择 — 多列喷头设备参数，单列喷头设备需设置为NONE。HP半寸：默认为A列
`PRINT_MIRROR_HORIZONTAL_HEAD_X`	bool	读写	`False`	—	—	喷头水平翻转 — 设定X号喷头喷出的内容水平翻转。_X需替换为喷头号，如_1表示1号喷头
`PRINT_MIRROR_VERTICAL_HEAD_X`	bool	读写	`False`	—	—	喷头垂直翻转 — 设定X号喷头喷出的内容垂直翻转。_X需替换为喷头号，如_1表示1号喷头
`PRINT_HEAD_STITCH_X`	int	读写	`0`	[0, 999999]	—	喷头拼接校准 — 设定X号喷头的拼接校准值（延时量），用于多喷头拼接对齐。_X需替换为喷头号，如_1表示1号喷头
`PRINT_TIJ_VOLTAGE`	double	读写	`7.0`	[7.0, 12.0]	V	TIJ喷头电压 — TIJ设备专用，用于设定驱动喷头喷印的电压
`PRINT_TIJ_PULSE_WIDTH`	int	读写	`18`	[12, 23]	μs	TIJ喷头脉冲宽度 — TIJ设备专用，用于设定驱动喷头喷印的脉宽
`DEVICE_HEAD_TYPE`	string	只读	`(empty)`	—	—	打印服务支持的喷头类型，如：IUT HP2.5
`DEVICE_HEAD_COUNT`	int	只读	`1`	[1, 8]	—	打印服务支持的喷头数量
`DEVICE_PROJECT_VERSION`	string	只读	`(empty)`	—	—	打印服务版本号，如：1.0.0
`DEVICE_FIRMWARE_VERSION`	string	只读	`(empty)`	—	—	FPGA固件版本号，如：A100
`DEVICE_SERIAL_NUMBER`	string	只读	`(empty)`	—	—	设备序列号
`DEVICE_BOARD_NAME`	string	只读	`(empty)`	—	—	设备名称
`DEVICE_CPU_MODEL`	string	只读	`(empty)`	—	—	CPU架构
`DEVICE_CPU_TEMPERATURE`	int	只读	`0`	—	°C	CPU 温度
`DEVICE_MEMORY_SIZE`	int	只读	`0`	—	MB	设备内存大小
`VOLTAGE_HEAD_X`	double	只读	—	—	V	喷头高压 — 只读遥测。读取X号喷头当前高压（伏特）。_X需替换为喷头号，如_1表示1号喷头
`PULSE_WIDTH_HEAD_X`	double	只读	—	—	μs	喷头脉冲宽度 — 只读遥测。读取X号喷头当前脉冲宽度（微秒）。_X需替换为喷头号，如_1表示1号喷头
`TEMPERATURE_HEAD_X`	double	只读	—	—	°C	喷头温度 — 只读遥测（预留）。读取X号喷头当前温度（摄氏度）。_X需替换为喷头号，如_1表示1号喷头。当前服务端暂不支持该 key
`SYSTEM_DATETIME`	string	读写	—	—	—	系统时间同步 — 写入格式 yyyy-MM-dd HH:mm:ss，服务端执行 date -s 并同步硬件时钟（hwclock -w）

参数详情

`LOG_ENABLE`

属性	值
Key	`LOG_ENABLE`
类型	bool
访问权限	读写
默认值	`True`
取值约束	`true` `false`
作用域	全局
语言常量	C: `TI_PARAM_LOG_ENABLE`

打印服务日志启用开关

`LOG_LEVEL`

属性	值
Key	`LOG_LEVEL`
类型	int
访问权限	读写
默认值	`2`
取值约束	[0, 6]
作用域	全局
语言常量	C: `TI_PARAM_LOG_LEVEL`

打印服务日志输出级别，0为最低(任何等级都记录），6为最高（没有任何日志记录）

`BEEP_DURATION`

属性	值
Key	`BEEP_DURATION`
类型	int
访问权限	读写
默认值	`100`
取值约束	[0, 10000]
单位	ms
作用域	全局
语言常量	C: `TI_PARAM_BEEP_DURATION`

设备蜂鸣持续时间

`PRINT_SPEED_TIMER`

属性	值
Key	`PRINT_SPEED_TIMER`
类型	int
访问权限	读写
默认值	`6250`
取值约束	[6250, 49999999]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_SPEED_TIMER`

打印速度（定时器模式） — 数值越大，打印一份数据所需要的时间越长

`PRINT_SPEED_ENCODER`

属性	值
Key	`PRINT_SPEED_ENCODER`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 10000]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_SPEED_ENCODER`

打印速度（编码器模式） — 编码器开启下的打印速度，数值越大，打印一份数据所需要的时间越长

`PRINT_DELAY_MS`

属性	值
Key	`PRINT_DELAY_MS`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 99999999]
单位	ms
作用域	全局
语言常量	C: `TI_PARAM_PRINT_DELAY_MS`

打印延迟（毫秒） — 从触发器触发到喷头喷印之间的延迟

`PRINT_DELAY_MM`

属性	值
Key	`PRINT_DELAY_MM`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 99999999]
单位	mm
作用域	全局
语言常量	C: `TI_PARAM_PRINT_DELAY_MM`

打印延迟（毫米） — 从触发器触发到喷头喷印之间的距离

`PRINT_INKJET_PASSES`

属性	值
Key	`PRINT_INKJET_PASSES`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 4]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_INKJET_PASSES`

吐墨/加深打印 — 加深喷印的颜色，0为最浅，4为最深，加深喷印后喷印速度的上限将降低到原来的1/n

`PRINT_INTERVAL_MS`

属性	值
Key	`PRINT_INTERVAL_MS`
类型	int
访问权限	读写
默认值	`1`
取值约束	[1, 99999999]
单位	ms
作用域	全局
语言常量	C: `TI_PARAM_PRINT_INTERVAL_MS`

打印间隔（毫秒） — 触发间隔，一次触发多次打印的情况下，每次打印的间隔

`PRINT_INTERVAL_MM`

属性	值
Key	`PRINT_INTERVAL_MM`
类型	int
访问权限	读写
默认值	`1`
取值约束	[1, 99999999]
单位	mm
作用域	全局
语言常量	C: `TI_PARAM_PRINT_INTERVAL_MM`

打印间隔（毫米） — 编码器启用时的一次触发多次打印的情况下，每次打印的间隔

`PRINT_DIRECTION`

属性	值
Key	`PRINT_DIRECTION`
类型	enum
访问权限	读写
默认值	`LR`
取值约束	`LR` `RL`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_DIRECTION`

打印方向 — 打印方向，多头设备或多列的喷头设备所需的参数，影响从哪个喷头最先开始打印、哪个列最先打印

`PRINT_BURST_COUNT`

属性	值
Key	`PRINT_BURST_COUNT`
类型	int
访问权限	读写
默认值	`1`
取值约束	[0, 999999999]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_BURST_COUNT`

触发喷印份数 — 触发一次打印所打印的份数, 0–一直触发一直喷印，1–触发一次喷印一次，n–触发一次喷印n次

`PRINT_MIRROR_HORIZONTAL`

属性	值
Key	`PRINT_MIRROR_HORIZONTAL`
类型	bool
访问权限	读写
默认值	`False`
取值约束	`true` `false`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_MIRROR_HORIZONTAL`

水平镜像 — 打印内容是否整体水平翻转

`PRINT_ENCODER_ENABLE`

属性	值
Key	`PRINT_ENCODER_ENABLE`
类型	bool
访问权限	读写
默认值	`False`
取值约束	`true` `false`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_ENCODER_ENABLE`

编码器启用开关 — 是否启用编码器

`PRINT_ENCODER_PPR`

属性	值
Key	`PRINT_ENCODER_PPR`
类型	int
访问权限	读写
默认值	`2500`
取值约束	[1, 99999999]
单位	PPR
作用域	全局
语言常量	C: `TI_PARAM_PRINT_ENCODER_PPR`

编码器脉冲数/转 — 设定接入的编码器的转一圈的脉冲数，用于修正编码器模式下的喷印效果

`PRINT_ENCODER_DIAMETER`

属性	值
Key	`PRINT_ENCODER_DIAMETER`
类型	int
访问权限	读写
默认值	`50`
取值约束	[1, 99999999]
单位	mm
作用域	全局
语言常量	C: `TI_PARAM_PRINT_ENCODER_DIAMETER`

编码器滚轮直径 — 设定接入的编码器滚轮直径，用于修正编码器模式下的喷印效果

`PRINT_FLASH_JET_CONFIG`

属性	值
Key	`PRINT_FLASH_JET_CONFIG`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 999]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_FLASH_JET_CONFIG`

喷头闪喷频次配置 — TIJ设备专用参数，定期喷出墨点防止堵头

`PRINT_FLASH_JET_LINES`

属性	值
Key	`PRINT_FLASH_JET_LINES`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 15]
单位	lines
作用域	全局
语言常量	C: `TI_PARAM_PRINT_FLASH_JET_LINES`

喷头闪喷列数配置 — TIJ设备专用参数，定期喷出墨点防止堵头

`PRINT_TRIGGER_LEVEL`

属性	值
Key	`PRINT_TRIGGER_LEVEL`
类型	enum
访问权限	读写
默认值	`POSEDGE`
取值约束	`POSEDGE` `NEGEDGE`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_TRIGGER_LEVEL`

触发器信号触发模式

`PRINT_NOZZLE_ROW_SELECT`

属性	值
Key	`PRINT_NOZZLE_ROW_SELECT`
类型	enum
访问权限	读写
默认值	`NONE`
取值约束	`NONE` `A` `B`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_NOZZLE_ROW_SELECT`

喷嘴列选择 — 多列喷头设备参数，单列喷头设备需设置为NONE。HP半寸：默认为A列

`PRINT_MIRROR_HORIZONTAL_HEAD_X`

属性	值
Key	`PRINT_MIRROR_HORIZONTAL_HEAD_X`
类型	bool
访问权限	读写
默认值	`False`
取值约束	`true` `false`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_MIRROR_HORIZONTAL_HEAD_X`

喷头水平翻转 — 设定X号喷头喷出的内容水平翻转。_X需替换为喷头号，如_1表示1号喷头

`PRINT_MIRROR_VERTICAL_HEAD_X`

属性	值
Key	`PRINT_MIRROR_VERTICAL_HEAD_X`
类型	bool
访问权限	读写
默认值	`False`
取值约束	`true` `false`
作用域	全局
语言常量	C: `TI_PARAM_PRINT_MIRROR_VERTICAL_HEAD_X`

喷头垂直翻转 — 设定X号喷头喷出的内容垂直翻转。_X需替换为喷头号，如_1表示1号喷头

`PRINT_HEAD_STITCH_X`

属性	值
Key	`PRINT_HEAD_STITCH_X`
类型	int
访问权限	读写
默认值	`0`
取值约束	[0, 999999]
作用域	全局
语言常量	C: `TI_PARAM_PRINT_HEAD_STITCH_X`

喷头拼接校准 — 设定X号喷头的拼接校准值（延时量），用于多喷头拼接对齐。_X需替换为喷头号，如_1表示1号喷头

`PRINT_TIJ_VOLTAGE`

属性	值
Key	`PRINT_TIJ_VOLTAGE`
类型	double
访问权限	读写
默认值	`7.0`
取值约束	[7.0, 12.0]
单位	V
作用域	全局
语言常量	C: `TI_PARAM_PRINT_TIJ_VOLTAGE`

TIJ喷头电压 — TIJ设备专用，用于设定驱动喷头喷印的电压

`PRINT_TIJ_PULSE_WIDTH`

属性	值
Key	`PRINT_TIJ_PULSE_WIDTH`
类型	int
访问权限	读写
默认值	`18`
取值约束	[12, 23]
单位	μs
作用域	全局
语言常量	C: `TI_PARAM_PRINT_TIJ_PULSE_WIDTH`

TIJ喷头脉冲宽度 — TIJ设备专用，用于设定驱动喷头喷印的脉宽

`DEVICE_HEAD_TYPE`

属性	值
Key	`DEVICE_HEAD_TYPE`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_HEAD_TYPE`

打印服务支持的喷头类型，如：IUT HP2.5

`DEVICE_HEAD_COUNT`

属性	值
Key	`DEVICE_HEAD_COUNT`
类型	int
访问权限	只读
默认值	`1`
取值约束	[1, 8]
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_HEAD_COUNT`

打印服务支持的喷头数量

`DEVICE_PROJECT_VERSION`

属性	值
Key	`DEVICE_PROJECT_VERSION`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_PROJECT_VERSION`

打印服务版本号，如：1.0.0

`DEVICE_FIRMWARE_VERSION`

属性	值
Key	`DEVICE_FIRMWARE_VERSION`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_FIRMWARE_VERSION`

FPGA固件版本号，如：A100

`DEVICE_SERIAL_NUMBER`

属性	值
Key	`DEVICE_SERIAL_NUMBER`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_SERIAL_NUMBER`

设备序列号

`DEVICE_BOARD_NAME`

属性	值
Key	`DEVICE_BOARD_NAME`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_BOARD_NAME`

设备名称

`DEVICE_CPU_MODEL`

属性	值
Key	`DEVICE_CPU_MODEL`
类型	string
访问权限	只读
默认值	`(empty)`
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_CPU_MODEL`

CPU架构

`DEVICE_CPU_TEMPERATURE`

属性	值
Key	`DEVICE_CPU_TEMPERATURE`
类型	int
访问权限	只读
默认值	`0`
单位	°C
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_CPU_TEMPERATURE`

CPU 温度

`DEVICE_MEMORY_SIZE`

属性	值
Key	`DEVICE_MEMORY_SIZE`
类型	int
访问权限	只读
默认值	`0`
单位	MB
作用域	设备
语言常量	C: `TI_PARAM_DEVICE_MEMORY_SIZE`

设备内存大小

`VOLTAGE_HEAD_X`

属性	值
Key	`VOLTAGE_HEAD_X`
类型	double
访问权限	只读
单位	V
作用域	设备
语言常量	C: `TI_PARAM_VOLTAGE_HEAD_X`

喷头高压 — 只读遥测。读取X号喷头当前高压（伏特）。_X需替换为喷头号，如_1表示1号喷头

`PULSE_WIDTH_HEAD_X`

属性	值
Key	`PULSE_WIDTH_HEAD_X`
类型	double
访问权限	只读
单位	μs
作用域	设备
语言常量	C: `TI_PARAM_PULSE_WIDTH_HEAD_X`

喷头脉冲宽度 — 只读遥测。读取X号喷头当前脉冲宽度（微秒）。_X需替换为喷头号，如_1表示1号喷头

`TEMPERATURE_HEAD_X`

属性	值
Key	`TEMPERATURE_HEAD_X`
类型	double
访问权限	只读
单位	°C
作用域	设备
语言常量	C: `TI_PARAM_TEMPERATURE_HEAD_X`

喷头温度 — 只读遥测（预留）。读取X号喷头当前温度（摄氏度）。_X需替换为喷头号，如_1表示1号喷头。当前服务端暂不支持该 key

`SYSTEM_DATETIME`

属性	值
Key	`SYSTEM_DATETIME`
类型	string
访问权限	读写
作用域	设备
语言常量	C: `TI_PARAM_SYSTEM_DATETIME`

系统时间同步 — 写入格式 yyyy-MM-dd HH:mm:ss，服务端执行 date -s 并同步硬件时钟（hwclock -w）