C# 实现TSC打印机状态监控与任务队列管理

1. TSC打印机监控系统设计思路在仓储管理和物流标签打印场景中打印机状态监控是保障业务连续性的关键。我见过太多因为打印机缺纸、卡纸导致流水线停机的案例这种问题往往发生在业务高峰期造成的损失远超想象。用C#构建监控系统时核心要解决三个问题实时状态获取、异常快速响应和任务队列管理。传统轮询方式会大量消耗系统资源而通过TSCLIB.dll的usbportqueryprinterAPI可以直接获取打印机硬件状态。实测发现最佳轮询间隔是300-500毫秒这个频率既能及时发现问题又不会给系统带来明显负担。状态检测线程需要独立运行这里我用AutoResetEvent实现阻塞控制当打印机空闲时才允许新任务入队。任务队列管理要注意线程安全问题。我推荐使用ConcurrentQueue这种线程安全集合配合lock关键字实现生产-消费模式。曾经有个项目因为没做线程同步导致标签内容错乱最后不得不人工核对上千个包裹。打印任务建议封装成独立对象包含内容、份数、优先级等属性方便实现紧急插单功能。2. 多线程架构实现细节2.1 状态监控线程核心代码结构是这样的private void WorkThreadFun() { while (!_cancellationToken.IsCancellationRequested) { _resetEvent.WaitOne(); int status TSCLIB.usbportqueryprinter(); ParseStatus(status); Thread.Sleep(300); } }这里有几个坑要特别注意线程退出机制要用CancellationToken直接Abort会导致资源泄露Sleep时间太短会CPU占用高太长会影响响应速度状态解析要处理所有可能的返回值我见过有人只判断了0和4结果遇到碳带用尽时系统毫无反应2.2 打印任务队列任务队列的核心是生产者-消费者模式。这是我的实现方案private ConcurrentQueuePrintJob _printQueue new ConcurrentQueuePrintJob(); private readonly object _printLock new object(); public void EnqueueJob(PrintJob job) { _printQueue.Enqueue(job); if(Monitor.TryEnter(_printLock, 100)) { try { ProcessQueue(); } finally { Monitor.Exit(_printLock); } } }实际使用中发现不加锁会导致多个任务同时操作打印机端口。最严重的一次事故是两个标签内容交叉打印变成了杂交标签。后来我加了双重检查锁并用Monitor.TryEnter设置超时避免死锁。3. 异常处理与恢复机制3.1 状态码全解析TSC打印机状态码远比文档描述的复杂。经过大量实测我整理出完整的状态对照表十六进制值十进制值状态描述建议处理方式0x0000044缺纸暂停队列触发报警0x0000088碳带用尽暂停队列通知更换0x00000B11打印头开启卡纸无碳带立即停止需要人工干预0x000080128其他硬件错误检查打印机电源和连接3.2 自动恢复策略对于可自动恢复的异常如临时卡纸我设计了三级重试机制首次检测到异常立即重试1次第二次失败等待5秒后重试第三次失败暂停队列并报警关键代码逻辑private void HandlePaperJam() { for(int i0; i3; i) { Thread.Sleep(i * 5000); if(TSCLIB.usbportqueryprinter() 0) { ResumePrinting(); return; } } TriggerAlarm(持续卡纸需要人工处理); }4. 高级功能实现技巧4.1 优先级打印控制物流场景常需要加急打印运单我在任务对象中增加了优先级属性public class PrintJob { public string Content { get; set; } public int Copies { get; set; } public DateTime CreateTime { get; set; } public int Priority { get; set; } //0-普通 1-加急 2-特急 }处理队列时使用LINQ重新排序var orderedJobs _printQueue .OrderByDescending(x x.Priority) .ThenBy(x x.CreateTime);4.2 二进制指令控制很多高级功能需要通过二进制指令实现比如// 暂停打印机 byte[] pauseCmd { 0x1B, 0x21, 0x50 }; // ESC!P TSCLIB.sendBinaryData(pauseCmd, pauseCmd.Length); // 恢复打印 byte[] resumeCmd { 0x1B, 0x21, 0x4F }; // ESC!O TSCLIB.sendBinaryData(resumeCmd, resumeCmd.Length);有个项目需要批量取消排队任务我通过发送ESC指令实现打印机软复位比单独取消每个任务效率高得多。但要注意复位会清空打印机缓冲区正在打印的标签可能会不完整。