如何使用Java Swing实现CP20 POS机客显屏的数值设置？

首先确认CP20客显的基础通信配置：CP20通用默认串口参数为波特率9600，8位数据位，1位停止位，无校验，USB版本的CP20一般会模拟为串口设备，先从设备管理器中确认客显对应的端口号（Windows为COMx，Linux一般为/dev/ttyUSBx）。

实现核心步骤 #

• 引入串口通信依赖：Java Swing环境推荐使用jSerialComm库实现串口通信，跨平台兼容性更好，无需额外配置原生依赖，直接导入对应jar包到项目中即可。
• 封装客显控制指令：CP20客显兼容ESC/POS指令集，清屏指令为0x0C，直接发送GBK/ASCII编码的文本即可完成内容展示，换行指令为0x0A。
• 绑定Swing业务逻辑：在订单总金额计算完成的业务逻辑处，触发客显内容刷新，串口通信逻辑需放在独立子线程执行，避免阻塞Swing的UI渲染线程导致界面卡顿。

核心代码示例 #

import com.fazecast.jSerialComm.SerialPort;

public class CustomerDisplayUtil {
    // 替换为实际的客显对应端口号
    private static final String DISPLAY_PORT = "COM3";
    private static final int BAUD_RATE = 9600;

    public static void updateTotalAmount(String totalAmount) {
        SerialPort serialPort = SerialPort.getCommPort(DISPLAY_PORT);
        serialPort.setComPortParameters(BAUD_RATE, 8, 1, SerialPort.NO_PARITY);
        serialPort.setComPortTimeouts(SerialPort.TIMEOUT_WRITE_BLOCKING, 2000, 0);
        
        if (serialPort.openPort()) {
            try {
                // 先发送清屏指令
                byte[] clearScreenCmd = {0x0C};
                serialPort.writeBytes(clearScreenCmd, clearScreenCmd.length);
                Thread.sleep(100);
                // 组装展示文本，字符集按客显实际支持配置调整，国内版本默认GBK
                String showContent = "总计: " + totalAmount + " 元";
                byte[] contentBytes = showContent.getBytes("GBK");
                serialPort.writeBytes(contentBytes, contentBytes.length);
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                serialPort.closePort();
            }
        }
    }
}

在Swing的业务逻辑处调用示例：

// 订单总金额计算完成后执行
String orderTotal = "256.80";
// 子线程调用避免阻塞UI
new Thread(() -> CustomerDisplayUtil.updateTotalAmount(orderTotal)).start();

常见问题排查 #

• 客显无内容输出：先使用串口调试工具直接发清屏+文本指令测试，确认端口号、串口参数和客显实际配置一致，部分客显需要切换到客显模式才能正常显示。
• 显示内容乱码：检查发送文本的编码是否和客显支持的字符集匹配，可尝试切换为ASCII/GB2312编码测试。
• 操作时Swing界面卡顿：确认串口通信逻辑没有放在Swing的EDT事件调度线程中执行，所有IO操作都要放到独立子线程处理。

内容的提问来源于stack exchange，提问作者Dilshan Chathuranga