参数注册表

TiJet SDK 使用区分大小写的参数 Key 访问设备配置、遥测和状态信息。

使用约定

约定	说明
大小写	key 区分大小写，全部为大写字母 + 下划线；写成小写按未知 key 处理
值类型	参数值使用字符串。bool 用 `"true"` / `"false"`，int 用十进制，double 用十进制小数，enum 用分组表中的枚举 token，string 原样传递
数字后缀 `_X`	把 `X` 替换成该参数指定的编号。大部分参数表示喷头号；`PRINT_COLUMN_SPACING_X` 表示列号
访问方向	`rw` 可读可写；`ro` 只读；`wo` 只写（写入有效，读取按未知 key 返回错误；当前：`SYSTEM_DATETIME`）
未知 key 或非法值	操作返回错误，参数保持原值

类型化辅助函数（C：ti_set_int() / ti_get_bool() / ti_get_double() 等）只是对字符串做转换，不改变上述约定。

参数列表

1. 日志与提示

Key	类型	访问	默认值	取值范围	单位	说明
`LOG_ENABLE`	bool	rw	`true`	true / false	—	打印服务日志启用开关 — 读取返回运行期实际的日志启用状态
`LOG_LEVEL`	int	rw	`2`	[0, 6]	—	打印服务日志输出级别，0为最低(任何等级都记录），6为最高（没有任何日志记录）
`BEEP_DURATION`	int	rw	`100`	[0, 10000]	ms	设备蜂鸣持续时间

2. 打印速度 / 延迟 / 间隔

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_SPEED_TIMER`	int	rw	`6250`	[6250, 49999999]	—	打印速度（定时器模式） — 数值越大，打印一份数据所需要的时间越长
`PRINT_SPEED_ENCODER`	int	rw	`0`	[0, 10000]	—	打印速度（编码器模式） — 编码器开启下的打印速度，数值越大，打印一份数据所需要的时间越长
`PRINT_DELAY_MS`	int	rw	`0`	[0, 99999999]	ms	打印延迟（毫秒） — 从触发器触发到喷头喷印之间的延迟
`PRINT_DELAY_MM`	int	rw	`0`	[0, 99999999]	mm	打印延迟（毫米） — 从触发器触发到喷头喷印之间的距离
`PRINT_INKJET_PASSES`	int	rw	`0`	[0, 4]	—	吐墨/加深打印 — 加深喷印的颜色，0为最浅，4为最深，加深喷印后喷印速度的上限将降低到原来的1/n
`PRINT_INTERVAL_MS`	int	rw	`1`	[1, 99999999]	ms	打印间隔（毫秒） — 触发间隔，一次触发多次打印的情况下，每次打印的间隔
`PRINT_INTERVAL_MM`	int	rw	`1`	[1, 99999999]	mm	打印间隔（毫米） — 编码器启用时的一次触发多次打印的情况下，每次打印的间隔
`PRINT_DIRECTION`	enum（LR / RL）	rw	`LR`	LR / RL	—	打印方向 — 打印方向，多头设备或多列的喷头设备所需的参数，影响从哪个喷头最先开始打印、哪个列最先打印
`PRINT_BURST_COUNT`	int	rw	`1`	[0, 999999999]	—	触发喷印份数 — 触发一次打印所打印的份数, 0–一直触发一直喷印，1–触发一次喷印一次，n–触发一次喷印n次

3. 打印方向与镜像

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_MIRROR_HORIZONTAL`	bool	rw	`false`	true / false	—	水平镜像 — 打印内容是否整体水平翻转
`PRINT_MIRROR_HORIZONTAL_HEAD_X`	bool	rw	`false`	true / false	—	喷头水平翻转 — 设定X号喷头喷出的内容水平翻转。_X需替换为喷头号，如_1表示1号喷头
`PRINT_MIRROR_VERTICAL_HEAD_X`	bool	rw	`false`	true / false	—	喷头垂直翻转 — 设定X号喷头喷出的内容垂直翻转。_X需替换为喷头号，如_1表示1号喷头

4. 编码器

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_ENCODER_ENABLE`	bool	rw	`false`	true / false	—	编码器启用开关 — 是否启用编码器
`PRINT_ENCODER_PPR`	int	rw	`2500`	[1, 99999999]	PPR	编码器脉冲数/转 — 设定接入的编码器的转一圈的脉冲数，用于修正编码器模式下的喷印效果
`PRINT_ENCODER_DIAMETER`	double	rw	`50.0`	[1.0, 99999999.0]	mm	编码器滚轮直径 — 设定接入的编码器滚轮直径，用于修正编码器模式下的喷印效果；修改后设备会重算编码器相关的延迟/间隔

5. 喷头维护（闪喷）

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_FLASH_JET_CONFIG`	int	rw	`0`	[0, 999]	—	喷头闪喷频次配置 — TIJ设备专用参数，定期喷出墨点防止堵头
`PRINT_FLASH_JET_LINES`	int	rw	`0`	[0, 15]	lines	喷头闪喷列数配置 — TIJ设备专用参数，定期喷出墨点防止堵头

6. 触发与提示

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_TRIGGER_LEVEL`	enum（POSEDGE / NEGEDGE）	rw	`POSEDGE`	POSEDGE / NEGEDGE	—	触发器信号触发模式

7. 报警灯

Key	类型	访问	默认值	取值范围	单位	说明
`ALARM_RED`	bool	rw	`false`	true / false	—	报警灯红色通道 — 控制报警灯红色点亮/熄灭
`ALARM_YELLOW`	bool	rw	`false`	true / false	—	报警灯黄色通道 — 控制报警灯黄色点亮/熄灭
`ALARM_GREEN`	bool	rw	`false`	true / false	—	报警灯绿色通道 — 控制报警灯绿色点亮/熄灭
`ALARM_BUZZER`	bool	rw	`false`	true / false	—	报警蜂鸣器 — 控制报警灯蜂鸣器鸣响/静音

8. 喷嘴列与列间距

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_NOZZLE_ROW_SELECT`	enum（NONE / A / B）	rw	`NONE`	NONE / A / B	—	喷嘴列选择 — 多列喷头设备参数，单列喷头设备需设置为NONE。HP半寸：默认为A列
`PRINT_COLUMN_SPACING_X`	int	rw	`0`	[0, 999999]	—	喷头列间距 — 设定X号列的列间距（列偏移量）。_X需替换为列号，如_1表示1号列
`PRINT_HEAD_STITCH_X`	int	rw	`0`	[0, 999999]	—	喷头拼接校准 — 设定X号喷头的拼接校准值（延时量），用于多喷头拼接对齐。_X需替换为喷头号，如_1表示1号喷头

9. TIJ 专用

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_TIJ_VOLTAGE`	double	rw	`7.0`	[7.0, 12.0]	V	TIJ喷头电压 — TIJ设备专用，用于设定驱动喷头喷印的电压
`PRINT_TIJ_PULSE_WIDTH`	int	rw	`18`	[12, 23]	μs	TIJ喷头脉冲宽度 — TIJ设备专用，用于设定驱动喷头喷印的脉宽
`PRINT_TIJ_PEN_CHECK_MODE`	bool	rw	`false`	true / false	—	墨盒检测模式 — 开启或关闭墨盒检测。TIJ设备专用
`PRINT_TIJ_CLEAN_NOZZLE_MODE`	bool	rw	`false`	true / false	—	清洗喷嘴模式 — 开启后喷头连续喷出全黑图案。TIJ设备专用
`PRINT_TIJ_CLEAN_NOZZLE_POWER`	int	rw	`100`	[10, 100]	%	清洗喷嘴功率 — 连续喷全黑时的频率百分比，范围为 10~100。TIJ设备专用

10. 喷头屏蔽

Key	类型	访问	默认值	取值范围	单位	说明
`PRINT_PEN_MUTE_X`	bool	rw	`false`	true / false	—	喷头屏蔽 — 设定X号喷头静默（不参与喷印）。_X需替换为喷头号，如_1表示1号喷头

11. 设备信息（只读）

Key	类型	访问	默认值	取值范围	单位	说明
`DEVICE_HEAD_TYPE`	string	ro	`(empty)`	—	—	打印服务支持的喷头类型，如：HP2.5
`DEVICE_HEAD_COUNT`	int	ro	`1`	[1, 8]	—	打印服务支持的喷头数量
`DEVICE_PROJECT_VERSION`	string	ro	`(empty)`	—	—	打印服务版本号，如：1.0.0
`DEVICE_FIRMWARE_VERSION`	string	ro	`(empty)`	—	—	FPGA固件版本号，如：A100
`DEVICE_SERIAL_NUMBER`	string	ro	`(empty)`	—	—	设备序列号
`DEVICE_BOARD_NAME`	string	ro	`(empty)`	—	—	设备名称
`DEVICE_CPU_MODEL`	string	ro	`(empty)`	—	—	CPU架构
`DEVICE_CPU_TEMPERATURE`	int	ro	`0`	—	°C	CPU 温度
`DEVICE_MEMORY_SIZE`	int	ro	`0`	—	MB	设备内存大小
`DEVICE_MEMORY_USAGE`	int	ro	`0`	—	MB	设备内存占用（已用内存）
`DEVICE_AGENT_ID`	string	ro	`(empty)`	—	—	代理代码 — 设备代理 ID
`DEVICE_ROOTFS_VERSION_CODE`	string	ro	`(empty)`	—	—	rootfs 版本号 — 读取设备根文件系统版本信息
`DEVICE_APP_VERSION_CODE`	string	ro	`(empty)`	—	—	应用程序版本号 — 读取设备应用程序版本信息

12. 喷头遥测与驱动板（只读）

Key	类型	访问	默认值	取值范围	单位	说明
`VOLTAGE_HEAD_X`	double	ro	`(empty)`	—	—	喷头高压 — 只读遥测。读取X号喷头当前高压（伏特）。_X需替换为喷头号，如_1表示1号喷头
`PULSE_WIDTH_HEAD_X`	double	ro	`(empty)`	—	—	喷头脉冲宽度 — 只读遥测。读取X号喷头当前脉冲宽度（微秒）。_X需替换为喷头号，如_1表示1号喷头
`TEMPERATURE_HEAD_X`	double	ro	`(empty)`	—	—	喷头温度 — 只读遥测（预留，暂不支持读取）。_X需替换为喷头号，如_1表示1号喷头
`DRIVER_BOARD_MCU_VERSION_X`	string	ro	`(empty)`	—	—	驱动板 MCU 版本号 — 读取X号喷头对应驱动板的 MCU APP 版本，格式为主.次.修订（如 2.1.0）。_X需替换为喷头号，如_1表示1号喷头

13. 墨水卡信息（只读）

Key	类型	访问	默认值	取值范围	单位	说明
`INK_CARD_INK_TOTAL_X`	double	ro	`(empty)`	—	pL	墨水卡墨水总量 — 读取X号喷头墨水卡记录的墨水总量，原始值单位为皮升（pL）。_X需替换为喷头号，如_1表示1号喷头
`INK_CARD_INK_REMAINING_X`	double	ro	`(empty)`	—	pL	墨水卡剩余墨量 — 读取X号喷头墨水卡记录的剩余墨量，原始值单位为皮升（pL）。_X需替换为喷头号，如_1表示1号喷头

14. 时间同步（只写）

Key	类型	访问	默认值	取值范围	单位	说明
`SYSTEM_DATETIME`	string	wo	`(empty)`	—	—	设定设备时间 — 写入格式 yyyy-MM-dd HH:mm:ss

示例

C SDK

#include <tijet/tijet.h>

ti_client_t *cli = ti_create();
ti_connect(cli, NULL);

// 写入（值都是字符串）
ti_set_int(cli, TI_PARAM_PRINT_SPEED_TIMER, 10000);
ti_set_bool(cli, TI_PARAM_PRINT_MIRROR_HORIZONTAL, 1);
ti_set_parameter(cli, TI_PARAM_SYSTEM_DATETIME, "2026-09-17 10:30:00");

// 读取
int32_t speed = 0;
char    head_count[TI_MAX_PARAM_VALUE];
ti_get_int(cli, TI_PARAM_PRINT_SPEED_TIMER, &speed);
ti_get_parameter(cli, TI_PARAM_DEVICE_HEAD_COUNT, head_count, sizeof(head_count));

// 带 _X 的参数：传入对应编号的字面量
ti_set_int(cli, TI_PARAM_PRINT_COLUMN_SPACING(1), 100);
ti_set_parameter(cli, TI_PARAM_PRINT_HEAD_STITCH(1), "120");
double voltage = 0.0;
ti_get_double(cli, TI_PARAM_VOLTAGE_HEAD(1), &voltage);

ti_destroy(cli);

C 的 _X 宏应传入数字字面量；运行时变量会被转换成变量名。编号来自变量时，应显式构造 Key：

char key[64];
snprintf(key, sizeof(key), "INK_CARD_INK_TOTAL_%u", head_no);
ti_get_double(cli, key, &ink_total);

Key 常量

C 和 C++ 使用相同的函数式宏与函数调用；_X 参数调用时传入参数指定的编号。

语言	命名规则	示例
C / C++	`TI_PARAM_<KEY>`	`TI_PARAM_PRINT_SPEED_TIMER`

参数注册表

使用约定

参数列表

1. 日志与提示

2. 打印速度 / 延迟 / 间隔

3. 打印方向与镜像

4. 编码器

5. 喷头维护（闪喷）

6. 触发与提示

7. 报警灯

8. 喷嘴列与列间距

9. TIJ 专用

10. 喷头屏蔽

11. 设备信息（只读）

12. 喷头遥测与驱动板（只读）

13. 墨水卡信息（只读）

14. 时间同步（只写）

示例

C SDK

Key 常量

相关文档