Node.js中使用SerialPort无分隔符解析单字节数据的问题

我需要对接一台legacy设备，该设备发送串口数据时不携带分隔符，因此需要将收到的每个字节都传入处理函数。我的代码基于Node.js v16.17.0开发，使用npm的serialport v10.5.0包。我尝试了如下代码，但只有收到回车符（\r）时，数据才会传入serialHandler函数，而我期望无需分隔符，每收到一个字节就触发该函数。请问如何实现无分隔符的单字节实时解析？

const {SerialPort} = require('serialport');  
const { ByteLengthParser } = require('@serialport/parser-byte-length'); 
const port = new SerialPort({                           //set serial port pins and baudrate
    path: '/dev/ttyAMA1',
    baudRate: 115200
});
const serialParser = port.pipe(new ByteLengthParser({ length: 1 }));
serialParser.on('data', serialHandler);     

function serialHandler(serialChar){
   //does stuff

}

解决方案 #

方法一：直接监听SerialPort的data事件 #

不需要使用ByteLengthParser，直接给串口端口绑定data事件，串口收到原始数据时会立即触发该事件，回调参数data是包含当前所有收到字节的Buffer，你可以遍历逐个处理单字节：

const {SerialPort} = require('serialport');  

const port = new SerialPort({
    path: '/dev/ttyAMA1',
    baudRate: 115200
});

port.on('data', (data) => {
    // 遍历每个收到的字节并传入处理函数
    for (let i = 0; i < data.length; i++) {
        serialHandler(data[i]);
    }
});

function serialHandler(serialByte){
   // serialByte为数值类型的单字节值，可直接处理
   console.log('收到单字节:', serialByte);
}

方法二：确保ByteLengthParser正确生效 #

如果坚持使用ByteLengthParser，需避免默认的换行解析逻辑干扰，可通过手动打开端口的方式确保解析器绑定正确：

const {SerialPort} = require('serialport');  
const { ByteLengthParser } = require('@serialport/parser-byte-length'); 

const port = new SerialPort({
    path: '/dev/ttyAMA1',
    baudRate: 115200,
    autoOpen: false
});

port.open((err) => {
    if (err) {
        console.error('端口打开失败:', err);
        return;
    }
    // 端口打开后再绑定解析器
    const serialParser = port.pipe(new ByteLengthParser({ length: 1 }));
    serialParser.on('data', (buffer) => {
        // buffer为长度1的Buffer，取第一个字节传入处理函数
        serialHandler(buffer[0]);
    });
});

function serialHandler(serialByte){
   // 处理单字节逻辑
   console.log('收到单字节:', serialByte);
}

关键说明 #

• 直接监听port的data事件是最可靠的单字节处理方式，无额外解析层干扰，数据到达即触发。
• ByteLengthParser失效通常是因为SerialPort默认启用了换行解析，手动打开端口并重新绑定解析器可规避该问题。

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