Jetson Nano新手必看：用Python3搞定UART串口通信（附禁用控制台避坑指南）
Jetson Nano硬件通信实战：Python3 UART串口开发全流程指南
第一次拿到Jetson Nano开发板时，最让人兴奋的莫过于通过代码直接控制硬件接口。但当我真正尝试用Python操作UART串口时，却发现系统默认的控制台服务成了"拦路虎"——发送的数据总是莫名其妙被截断。这个问题困扰了我整整两天，直到发现nvgetty服务这个隐藏设定。本文将带你完整走通从环境配置到实际通信的全流程，特别针对那些官方文档没有明确说明的"坑点"。
1. 硬件准备与环境配置
1.1 认识Jetson Nano的串口接口
Jetson Nano开发板的40针GPIO接头中，UART1默认映射在ttyTHS1设备节点上（对应物理引脚8-TX和10-RX）。与树莓派等开发板不同，NVIDIA在出厂系统中默认启用了串口控制台服务，这是大多数通信失败的根源。
关键硬件清单：
- TTL转USB适配器（如CP2102、CH340等）
- 杜邦线（建议使用母对母）
- 万用表（可选，用于电压检测）
注意：Jetson Nano的UART工作电压为3.3V，务必确认你的转换器兼容该电平标准，否则可能损坏设备。
1.2 禁用系统控制台服务
这是最关键的准备工作，也是新手最容易忽略的步骤。执行以下命令序列：
# 停止当前运行的服务 sudo systemctl stop nvgetty # 禁止开机自启 sudo systemctl disable nvgetty # 刷新设备规则 sudo udevadm trigger # 建议重启生效 sudo reboot禁用后可以通过以下命令验证是否成功：
systemctl status nvgetty正确的状态应显示inactive (dead)。如果遇到权限问题，可能需要检查/etc/systemd/system/nvgetty.service文件是否存在。
2. Python串口通信基础实现
2.1 安装必要软件包
推荐使用Python3的serial库进行开发：
sudo apt-get update sudo apt-get install python3-serial验证安装是否成功：
python3 -c "import serial; print(serial.__version__)"2.2 最小化通信示例
创建一个uart_demo.py文件，包含以下基础代码：
import serial import time # 配置串口参数 ser = serial.Serial( port='/dev/ttyTHS1', baudrate=115200, bytesize=serial.EIGHTBITS, parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE, timeout=1 ) try: print("串口通信测试开始 (按Ctrl+C终止)") while True: # 发送数据 ser.write(b'Hello UART\n') # 接收数据 if ser.in_waiting > 0: received = ser.readline() print(f"接收到: {received.decode('utf-8').strip()}") time.sleep(1) except KeyboardInterrupt: print("程序终止") finally: ser.close()运行脚本需要超级用户权限：
sudo python3 uart_demo.py3. 进阶应用与调试技巧
3.1 多线程双向通信实现
实际项目中常需要同时处理发送和接收，下面是一个改进版架构：
import serial import threading class UARTManager: def __init__(self): self.ser = serial.Serial('/dev/ttyTHS1', 115200, timeout=1) self.running = True def receiver_thread(self): while self.running: if self.ser.in_waiting: data = self.ser.readline().decode('utf-8').strip() print(f"[接收] {data}") def start(self): self.thread = threading.Thread(target=self.receiver_thread) self.thread.start() try: while self.running: message = input("输入发送内容 (或输入quit退出): ") if message.lower() == 'quit': break self.ser.write(f"{message}\n".encode('utf-8')) finally: self.running = False self.thread.join() self.ser.close() if __name__ == "__main__": manager = UARTManager() manager.start()3.2 常见问题排查指南
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法打开设备 | 权限不足/服务冲突 | 使用sudo执行/确认nvgetty已禁用 |
| 发送数据无响应 | 接线错误/波特率不匹配 | 检查TX/RX交叉连接/确认双方波特率 |
| 接收乱码 | 电平不匹配/参数错误 | 确认3.3V电平/检查数据位停止位设置 |
| 随机断开 | 电源不稳定 | 使用独立电源供电/检查接地 |
硬件连接检查清单：
- Jetson TX → 转换器 RX
- Jetson RX → 转换器 TX
- 共地连接（GND到GND）
- 确认转换器驱动已安装（Windows设备管理器检查）
4. 扩展应用场景
4.1 与Arduino通信实例
通过UART可以实现Jetson Nano与Arduino的协同工作。以下是Arduino端的示例代码：
void setup() { Serial.begin(115200); } void loop() { if (Serial.available()) { String received = Serial.readStringUntil('\n'); Serial.print("Arduino收到: "); Serial.println(received); } delay(100); }对应的Python端可以这样交互：
def arduino_control(): ser = serial.Serial('/dev/ttyTHS1', 115200, timeout=1) try: while True: command = input("控制Arduino (1-LED ON, 0-LED OFF): ") ser.write(f"{command}\n".encode()) response = ser.readline() print(response.decode('utf-8').strip()) finally: ser.close()4.2 数据日志记录系统
结合Python的文件操作，可以创建简单的串口数据记录器：
import serial from datetime import datetime def log_serial_data(log_file="uart_log.txt"): ser = serial.Serial('/dev/ttyTHS1', 115200) with open(log_file, 'a') as f: try: while True: if ser.in_waiting: data = ser.readline().decode('utf-8').strip() timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") log_entry = f"{timestamp} - {data}\n" f.write(log_entry) f.flush() # 确保及时写入 except KeyboardInterrupt: ser.close()5. 性能优化与安全实践
5.1 缓冲区管理技巧
高速通信时需要特别注意缓冲区处理：
# 清空输入缓冲区 ser.reset_input_buffer() # 清空输出缓冲区 ser.reset_output_buffer() # 设置缓冲区大小（默认值通常足够） ser.set_buffer_size(rx_size=1024, tx_size=1024)5.2 错误处理最佳实践
健壮的工业级代码应该包含完善的错误处理：
import serial from serial.tools import list_ports def safe_serial_connect(): max_retries = 3 for attempt in range(max_retries): try: # 自动检测可用端口 available_ports = list_ports.comports() if not available_ports: raise RuntimeError("未检测到可用串口设备") ser = serial.Serial( port='/dev/ttyTHS1', baudrate=115200, timeout=2, write_timeout=2 ) return ser except serial.SerialException as e: print(f"尝试 {attempt + 1} 失败: {str(e)}") if attempt == max_retries - 1: raise time.sleep(1)5.3 系统服务自动化
对于生产环境，可以创建systemd服务自动管理串口应用：
创建/etc/systemd/system/uart_service.service：
[Unit] Description=Jetson UART Communication Service After=network.target [Service] ExecStart=/usr/bin/python3 /path/to/your_script.py Restart=always User=root [Install] WantedBy=multi-user.target启用服务：
sudo systemctl daemon-reload sudo systemctl enable uart_service sudo systemctl start uart_service