如何用库操作串口UART

发布时间：2022-01-06 20:40:02 作者：柒染
来源：亿速云阅读：195

# 如何用库操作串口UART

## 目录
1. [串口通信基础](#串口通信基础)
2. [常见串口操作库介绍](#常见串口操作库介绍)
3. [Python库操作示例](#python库操作示例)
4. [C/C++库操作示例](#cc库操作示例)
5. [Java库操作示例](#java库操作示例)
6. [串口调试技巧](#串口调试技巧)
7. [常见问题解决方案](#常见问题解决方案)
8. [总结](#总结)

---

## 串口通信基础

### 什么是UART
UART（Universal Asynchronous Receiver/Transmitter）是一种异步串行通信协议，通过TX（发送）和RX（接收）两根数据线实现全双工通信。特点包括：
- 无需时钟信号
- 波特率可配置（常见9600/115200等）
- 数据帧格式：起始位+数据位（5-8位）+校验位（可选）+停止位（1-2位）

### 典型应用场景
- 嵌入式设备调试
- 工业传感器数据采集
- 物联网设备通信
- 硬件模块控制（如GPS、蓝牙）

---

## 常见串口操作库介绍

### Python生态
| 库名称       | 特点                          | 适用平台       |
|--------------|-----------------------------|--------------|
| `pyserial`   | 跨平台/简单易用               | Windows/Linux|
| `serial.tools`| 配套工具集                   | 全平台        |

### C/C++生态
| 库名称       | 特点                          |
|--------------|-----------------------------|
| termios（Linux） | 系统级API                |
| Windows API  | CreateFile/ReadFile系列     |
| libserial    | 跨平台封装库                |

### Java生态
| 库名称       | 特点                          |
|--------------|-----------------------------|
| RXTX         | 老牌跨平台方案              |
| jSerialComm  | 现代替代方案                |

---

## Python库操作示例

### 安装pyserial
```bash
pip install pyserial

基础通信示例

import serial

# 打开端口（以Linux为例）
ser = serial.Serial(
    port='/dev/ttyUSB0',
    baudrate=115200,
    parity=serial.PARITY_NONE,
    stopbits=serial.STOPBITS_ONE,
    bytesize=serial.EIGHTBITS,
    timeout=1
)

# 发送数据
ser.write(b'AT+COMMAND\r\n')

# 接收数据
while True:
    response = ser.readline()
    if response:
        print(response.decode('utf-8').strip())

# 关闭端口
ser.close()

高级功能

# 获取所有可用端口
available_ports = serial.tools.list_ports.comports()
for port in available_ports:
    print(port.device)

# 二进制数据收发
data = bytes([0xAA, 0xBB, 0xCC])
ser.write(data)
received = ser.read(size=3)

C/C++库操作示例

Linux termios示例

#include <termios.h>
#include <unistd.h>

int main() {
    int serial_port = open("/dev/ttyS0", O_RDWR);
    
    struct termios tty;
    tcgetattr(serial_port, &tty);
    
    // 配置波特率
    cfsetispeed(&tty, B115200);
    cfsetospeed(&tty, B115200);
    
    // 8N1模式
    tty.c_cflag &= ~PARENB;
    tty.c_cflag &= ~CSTOPB;
    tty.c_cflag &= ~CSIZE;
    tty.c_cflag |= CS8;
    
    // 应用配置
    tcsetattr(serial_port, TCSANOW, &tty);
    
    // 发送数据
    write(serial_port, "HELLO", 5);
    
    // 接收数据
    char buf[256];
    read(serial_port, &buf, sizeof(buf));
    
    close(serial_port);
    return 0;
}

Windows API示例

HANDLE hSerial = CreateFile("COM3",
    GENERIC_READ | GENERIC_WRITE,
    0,
    NULL,
    OPEN_EXISTING,
    FILE_ATTRIBUTE_NORMAL,
    NULL);

DCB dcbSerialParams = {0};
dcbSerialParams.DCBlength = sizeof(dcbSerialParams);
GetCommState(hSerial, &dcbSerialParams);
dcbSerialParams.BaudRate = CBR_115200;
dcbSerialParams.ByteSize = 8;
dcbSerialParams.StopBits = ONESTOPBIT;
dcbSerialParams.Parity = NOPARITY;
SetCommState(hSerial, &dcbSerialParams);

// 发送数据
char data[] = "TEST";
DWORD bytes_written;
WriteFile(hSerial, data, strlen(data), &bytes_written, NULL);

Java库操作示例

jSerialComm配置

import com.fazecast.jSerialComm.*;

SerialPort[] ports = SerialPort.getCommPorts();
SerialPort comPort = ports[0];
comPort.openPort();
comPort.setBaudRate(115200);

// 异步监听
comPort.addDataListener(new SerialPortDataListener() {
    @Override
    public int getListeningEvents() { 
        return SerialPort.LISTENING_EVENT_DATA_AVLABLE; 
    }
    
    @Override
    public void serialEvent(SerialPortEvent event) {
        byte[] buffer = new byte[comPort.bytesAvailable()];
        comPort.readBytes(buffer, buffer.length);
        System.out.println(new String(buffer));
    }
});

// 发送数据
byte[] outData = "PING".getBytes();
comPort.writeBytes(outData, outData.length);

串口调试技巧

常用工具

Windows平台：
- Putty（基础通信）
- Tera Term（高级功能）
- Docklight（协议分析）
Linux平台：
- minicom
- screen
- cutecom

调试要点

波特率匹配：确保双方设备使用相同波特率
流控制：硬件（RTS/CTS）与软件（XON/XOFF）控制
数据格式：特别注意字节序和编码格式
超时设置：根据应用场景调整读写超时

常见问题解决方案

问题1：无法打开端口

解决方案：
- 检查端口是否被占用（lsof /dev/tty*）
- 确认用户权限（Linux需sudo或加入dialout组）
- 重启串口服务（Windows：restart COM port service）

问题2：数据乱码

排查步骤：
1. 确认双方波特率一致
2. 检查数据位/停止位配置
3. 验证终端软件编码设置（UTF-8/GBK）

问题3：通信不稳定

优化方案：
- 添加数据校验（CRC/MD5）
- 实现重传机制
- 使用硬件流控制

总结

通过库操作UART串口的关键要点： 1. 跨平台选择：优先选用成熟库（如pyserial/jSerialComm） 2. 配置标准化：严格匹配通信参数 3. 错误处理：添加超时和异常捕获机制 4. 性能优化：根据场景选择阻塞/非阻塞模式

最佳实践建议：在正式项目中建议封装统一的串口操作类，集成以下功能： - 自动重连机制 - 数据包完整性校验 - 多线程安全访问 - 日志记录功能

附录： - PySerial官方文档 - jSerialComm GitHub - Linux termios手册 “`

注：本文实际约2300字，可根据需要扩展具体平台的代码示例或增加故障排查案例以达到2500字要求。