Jetson Nano与Arduino串口通信实战：从硬件连接到Python数据采集

1. 项目概述与核心价值

在嵌入式开发和物联网项目中，经常需要将高性能的边缘计算设备与低功耗的微控制器结合起来。Jetson Nano作为一款功能强大的AI边缘计算设备，擅长处理复杂的视觉识别、模型推理等任务；而Arduino则以其简单易用、实时性强的特点，在传感器数据采集、电机控制等底层硬件交互方面表现出色。如何让这两者“对话”，就成了一个非常实际且高频的需求。串口通信，正是连接这两个不同世界最经典、最可靠的桥梁。

这个项目的核心，就是打通Jetson Nano与Arduino之间的数据通道。具体来说，我们将在Arduino上编写程序，周期性地采集或生成数据（比如温度传感器读数、超声波测距结果，或者简单的计数信号），然后通过其硬件串口（通常是TX/RX引脚）发送出来。在Jetson Nano这一端，我们将使用Python编写一个客户端程序，通过USB转串口线（或者直接连接GPIO上的UART引脚）监听指定的串行端口，实时读取Arduino发送过来的数据流，并将其显示在终端或用于后续的处理和分析。

为什么选择串口？首先，它几乎是所有微控制器和单板计算机的标准配置，硬件兼容性极佳。其次，协议简单，不需要复杂的网络协议栈，在资源受限的Arduino上实现起来轻松。再者，通信可靠，只要波特率等参数匹配，数据传输的稳定性很高。对于物联网和边缘计算场景，这种将“感知/控制”与“计算/决策”分离的架构非常典型：Arduino负责前端的、确定性的实时任务，Jetson Nano则负责后端的、算力密集型的智能分析。掌握这项技能，意味着你能灵活地构建各种智能硬件原型，从环境监测站到自主机器人，其应用场景非常广泛。

2. 硬件连接与通信原理剖析

2.1 硬件连接方案选择

要让Jetson Nano和Arduino通信，首先得在物理上把它们连起来。最常见、最便捷的方式是使用USB数据线。大多数Arduino开发板（如Uno, Mega, Leonardo）都集成了USB转串口芯片（如CH340、CP2102或ATmega16U2），当你用USB线将其连接到Jetson Nano的USB端口时，Nano的系统会自动将其识别为一个虚拟的串行端口（在Linux系统中通常表现为/dev/ttyUSB0或/dev/ttyACM0）。

另一种方式是使用直接的串口引脚连接，即连接Arduino的TX（发送）引脚到Jetson Nano某个UART接口的RX（接收）引脚，以及Arduino的RX引脚到Jetson Nano的TX引脚，并且需要共地（GND）。Jetson Nano的40针GPIO排针中包含了多个UART接口（如/dev/ttyTHS1）。这种方式省去了USB转接，但需要注意，大多数微控制器的串口电平是5V或3.3V TTL电平，而Jetson Nano的GPIO是3.3V电平。如果Arduino是5V系统（如Uno），直接连接可能会损坏Jetson Nano的GPIO。因此，强烈建议初学者和大多数应用场景直接使用USB连接，它提供了电气隔离，且即插即用，更为安全可靠。

注意：如果你必须使用GPIO直接连接，请务必确认电压电平兼容，必要时使用电平转换模块（如双向逻辑电平转换器）。

2.2 串口通信协议核心参数

串口通信是一种异步串行通信协议，双方需要约定好几个关键参数才能正确解码数据，这些参数通常在代码初始化时设置：

1. 波特率 (Baud Rate)：这是通信速度的度量，表示每秒传输的符号数。常见的波特率有9600, 19200, 38400, 115200等。发送端和接收端的波特率必须严格一致，否则接收到的将是乱码。更高的波特率意味着更快的传输速度，但也对硬件时序和线路质量要求更高。对于Arduino向Jetson Nano传输传感器数据这类应用，115200是一个在速度和稳定性之间取得很好平衡的常用值。
2. 数据位 (Data Bits)：表示每个字符由多少位数据组成。标准值是8位，这刚好可以传输一个字节（0-255）的二进制数据或一个ASCII字符。
3. 停止位 (Stop Bits)：用于表示一个字符传输的结束，通常为1位。它给接收方一点时间来处理当前字符并为接收下一个字符做准备。
4. 奇偶校验位 (Parity Bit)：一种简单的错误检测机制，可以是奇校验、偶校验或无校验。在要求不高的短距离通信中（如USB连接），通常选择“无校验”（None）。
5. 流控制 (Flow Control)：用于协调发送和接收速度，防止数据丢失。在Arduino与PC或Jetson Nano的简单通信中，硬件流控制（RTS/CTS）很少使用，通常设置为“无”（None）。

在本次实践中，我们将采用最通用的配置：波特率115200，8位数据位，1位停止位，无校验，无流控制。你需要在Arduino代码和Jetson Nano的Python代码中同时使用这个配置。

3. Arduino端程序编写与数据发送

在开始Jetson Nano端的配置之前，我们需要先让Arduino“有话说”。我们将编写一个简单的Arduino程序，周期性地通过串口发送数据。

3.1 基础数据发送示例

打开Arduino IDE，创建一个新的项目（Sketch）。以下是一个经典的示例，它每隔1秒向串口发送一个“Hello from Arduino!”的字符串，同时附带一个递增的计数。

void setup() { // 初始化串口通信，设置波特率为115200 Serial.begin(115200); // 等待串口连接建立。对于Leonardo等板子，这行是必需的。 while (!Serial) { ; } Serial.println("Arduino Booted and Ready!"); // 发送启动信息 } void loop() { static int counter = 0; // 静态变量，用于在loop函数调用间保持值 Serial.print("Counter: "); Serial.print(counter); Serial.print(" | Message: Hello from Arduino! | Timestamp: "); Serial.println(millis()); // 打印自启动以来的毫秒数 counter++; // 计数器增加 delay(1000); // 等待1000毫秒（1秒） }

代码解析与注意事项：

• Serial.begin(115200): 这是最关键的一步，设定了通信的波特率。必须与Python端设置的波特率完全一致。
• while (!Serial): 这一行代码对于像Arduino Leonardo、Micro这类使用虚拟串口的板子非常重要，它会等待真正的USB串口连接建立后才继续执行。对于Uno，它不是必须的，但加上也无害。
• Serial.print()和Serial.println():print()函数发送数据但不换行，println()则在发送数据后附加一个回车换行符（\r\n）。在接收端，这个换行符可以作为判断一行数据结束的标志，非常有用。
• millis(): 返回Arduino自启动以来的毫秒数，常用于生成时间戳。

将这段代码上传到你的Arduino开发板。上传完成后，你可以先打开Arduino IDE自带的“串口监视器”（Serial Monitor），将右下角的波特率设置为115200，如果能看到规律输出的数据，就证明Arduino端的发送程序工作正常。

3.2 发送结构化数据（如JSON）

在实际项目中，我们往往需要发送更结构化的数据，比如来自多个传感器的读数。一种很好的做法是将其格式化为JSON字符串，这样在Jetson Nano端可以用Python的json模块轻松解析。

#include <ArduinoJson.h> // 需要安装ArduinoJson库 void setup() { Serial.begin(115200); while (!Serial); } void loop() { // 模拟传感器读数 float temperature = random(200, 300) / 10.0; // 20.0-30.0度 int humidity = random(400, 700) / 10; // 40-70% bool motionDetected = random(0, 2); // 0或1 // 创建JSON文档 StaticJsonDocument<200> doc; doc["sensor"] = "environment"; doc["temp"] = temperature; doc["hum"] = humidity; doc["motion"] = motionDetected; doc["ts"] = millis(); // 序列化JSON并发送 serializeJson(doc, Serial); Serial.println(); // 添加换行，便于接收方按行读取 delay(2000); // 每2秒发送一次 }

实操心得：

• 使用Serial.println()添加换行符，是让接收端能够按行读取数据的最简单有效的方法。否则，接收端需要自己处理数据流的边界，复杂得多。
• 发送结构化数据（如JSON）比发送自定义格式的纯文本要好得多，因为它自描述、易扩展、易解析。
• 在loop()中频繁使用delay()会阻塞程序。对于更复杂的、需要同时处理多个任务的应用，可以考虑使用非阻塞的定时模式（如比较millis()），但这对于简单的数据发送示例来说已经足够。

4. Jetson Nano端环境配置与串口识别

现在，我们把焦点转移到Jetson Nano上。首先需要确保系统环境就绪，并能正确识别到连接的Arduino设备。

4.1 安装必要的软件包

通过SSH或直接连接显示器键盘登录到你的Jetson Nano系统。打开一个终端，首先更新软件包列表，然后安装Python3和关键的串口通信库pyserial。原教程中提到的python-serial是Python2的旧包，我们现在应该使用Python3。

# 更新软件包列表 sudo apt-get update # 安装Python3和pip3（如果尚未安装） sudo apt-get install python3 python3-pip -y # 使用pip3安装pyserial库 pip3 install pyserial # 也可以使用apt安装，但版本可能较旧 # sudo apt-get install python3-serial -y

安装完成后，可以通过以下命令验证pyserial是否安装成功：

python3 -c "import serial; print(serial.__version__)"

4.2 识别Arduino设备串口

将Arduino通过USB线连接到Jetson Nano。然后，在终端中使用ls命令列出设备文件，查找新出现的串口设备。

# 连接Arduino前，先查看一下现有的设备 ls /dev/tty* # 连接Arduino后，再次运行上述命令，观察多出来的设备。 # 最常见的设备名是： # /dev/ttyACM0 - 通常用于Arduino Leonardo, Micro，以及一些使用CDC/ACM驱动的板子。 # /dev/ttyUSB0 - 通常用于通过FTDI或CH340等USB转串口芯片连接的设备，如Arduino Uno（大部分情况）。

一个更系统的方法是使用dmesg命令查看内核日志，它会记录USB设备插拔的详细信息：

# 先清空一下内核环形缓冲区，方便观察新日志 sudo dmesg -c # 现在拔掉Arduino USB线，再重新插上。然后立即运行： dmesg | tail -20

你会在输出中看到类似下面的信息，这能明确告诉你设备被识别成了什么：

[ 1234.567890] usb 1-2.1: new full-speed USB device number 5 using tegra-xusb [ 1234.698765] usb 1-2.1: New USB device found, idVendor=2341, idProduct=0043 [ 1234.698777] usb 1-2.1: New USB device strings: Mfr=1, Product=2, SerialNumber=220 [ 1234.698783] usb 1-2.1: Product: Arduino Uno [ 1234.698788] usb 1-2.1: Manufacturer: Arduino (www.arduino.cc) [ 1234.701234] cdc_acm 1-2.1:1.0: ttyACM0: USB ACM device

这里明确显示设备被识别为ttyACM0。请记下你的设备名，假设为/dev/ttyACM0，我们将在Python代码中使用它。

重要注意事项：

1. 权限问题：普通用户通常没有直接访问串口设备（如/dev/ttyACM0）的权限。你会遇到Permission denied错误。有两种解决方法：
   • 临时方案（不推荐长期使用）：使用sudo来运行你的Python脚本。sudo python3 your_script.py
   • 推荐方案：将你的用户添加到dialout组，该组通常拥有串口设备的访问权限。

     sudo usermod -a -G dialout $USER

     执行此命令后，需要注销并重新登录，或者重启系统，用户组变更才会生效。之后你就可以不用sudo直接运行脚本了。
2. 端口占用：确保没有其他程序（如Arduino IDE的串口监视器、screen、minicom等）正在占用你要使用的串口，否则Python程序将无法打开它。

5. Python读取串口数据实战编程

环境准备好后，我们就可以编写Python程序来读取数据了。我们将从最简单的示例开始，逐步增加健壮性和功能性。

5.1 基础读取示例：按行读取

创建一个新的Python文件，例如read_serial.py。

import serial import time # 配置串口参数 SERIAL_PORT = '/dev/ttyACM0' # 请根据你的实际情况修改 BAUD_RATE = 115200 try: # 创建串口对象并打开连接 ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1) print(f"成功连接到串口 {SERIAL_PORT}，波特率 {BAUD_RATE}") # 等待一段时间让串口稳定（某些Arduino板子复位需要时间） time.sleep(2) # 清空缓冲区（可选，丢弃可能存在的旧数据） ser.reset_input_buffer() while True: # 如果缓冲区中有可读数据 if ser.in_waiting > 0: # 读取一行数据，以换行符\n为结束标志 # decode('utf-8') 将字节数据转换为字符串 # rstrip() 移除行尾的换行符和空格 line = ser.readline().decode('utf-8').rstrip() print(f"收到数据: {line}") except serial.SerialException as e: print(f"无法打开串口 {SERIAL_PORT}: {e}") except KeyboardInterrupt: print("\n程序被用户中断。") except Exception as e: print(f"发生未知错误: {e}") finally: # 确保程序退出前关闭串口 if 'ser' in locals() and ser.is_open: ser.close() print("串口连接已关闭。")

代码关键点解析：

• serial.Serial(): 这是pyserial库的核心类，用于创建串口连接对象。参数依次为端口名、波特率。timeout=1设置了读操作的超时时间为1秒，这意味着readline()最多等待1秒来收集一行数据，避免无限阻塞。
• ser.in_waiting: 返回输入缓冲区中等待读取的字节数。这是一个非阻塞的检查方式。
• ser.readline(): 读取直到遇到换行符（\n）或超时。这正好对应了Arduino端Serial.println()发送的数据。
• .decode('utf-8'): 串口通信传输的是字节（bytes）。readline()返回的是字节串，我们需要将其解码（decode）为Python字符串（str）才能方便处理。‘utf-8’是最常见的编码。
• try...except...finally: 这是编写健壮代码的关键。它妥善处理了串口打开失败、用户主动中断（Ctrl+C）以及其他异常，并确保在任何情况下串口连接都会被正确关闭，释放资源。

运行这个脚本（记得修改SERIAL_PORT为你的实际设备名）：

python3 read_serial.py

你应该能看到终端里每秒打印出一行来自Arduino的数据。

5.2 进阶处理：解析JSON数据与错误处理

如果我们发送的是3.2节中的JSON数据，那么接收端就需要解析JSON。同时，我们还需要考虑数据不完整或格式错误的情况。

import serial import time import json SERIAL_PORT = '/dev/ttyACM0' BAUD_RATE = 115200 def parse_sensor_data(line): """尝试解析一行JSON格式的传感器数据""" try: data = json.loads(line) return data except json.JSONDecodeError as e: print(f"JSON解析失败: {e}，原始数据: {line}") return None try: ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1) print(f"监听串口 {SERIAL_PORT} ...") time.sleep(2) ser.reset_input_buffer() while True: if ser.in_waiting > 0: line = ser.readline() try: # 尝试用utf-8解码，如果失败尝试其他常见编码 decoded_line = line.decode('utf-8').rstrip() except UnicodeDecodeError: # 有时可能会有非UTF-8字符（如初始化乱码），尝试忽略错误或使用其他编码 decoded_line = line.decode('utf-8', errors='ignore').rstrip() print(f"解码警告，数据可能不完整: {decoded_line[:50]}...") continue # 跳过这行无法解码的数据 # 跳过空行 if not decoded_line: continue # 解析JSON数据 sensor_data = parse_sensor_data(decoded_line) if sensor_data: # 成功解析，可以按字段访问数据 print(f"[{sensor_data.get('ts', 'N/A')}] 温度: {sensor_data['temp']:.1f}°C, " f"湿度: {sensor_data['hum']}%, 移动: {sensor_data['motion']}") except KeyboardInterrupt: print("\n数据监听停止。") except Exception as e: print(f"程序运行出错: {e}") finally: if 'ser' in locals() and ser.is_open: ser.close()

避坑技巧：

1. 解码错误处理：实际通信中，一开始可能会收到一些乱码（例如Arduino复位时产生的字符），或者因干扰产生非UTF-8字节。使用errors='ignore'参数可以忽略无法解码的字节，避免程序因一个解码错误而崩溃。
2. JSON解析容错：将json.loads()放在try...except块中至关重要。网络传输或硬件干扰可能导致数据包不完整，从而产生无效的JSON字符串。捕获JSONDecodeError异常可以让程序继续运行，而不是直接中断。
3. 数据校验：对于关键任务，除了格式解析，还应考虑添加更严格的数据校验，例如检查必要字段是否存在、数值是否在合理范围内等。

5.3 将数据写入文件或数据库

仅仅在终端显示数据还不够，我们通常需要将其持久化存储，用于后续分析。下面示例将数据同时打印到屏幕并追加写入到CSV文件中。

import serial import time import json import csv from datetime import datetime SERIAL_PORT = '/dev/ttyACM0' BAUD_RATE = 115200 LOG_FILE = 'sensor_data.csv' # 初始化CSV文件，写入表头（如果文件不存在） def init_csv_file(filename): try: with open(filename, 'x', newline='') as f: # 'x'模式表示创建文件，如果已存在则失败 writer = csv.writer(f) writer.writerow(['timestamp', 'local_time', 'temperature', 'humidity', 'motion', 'raw_data']) except FileExistsError: pass # 文件已存在，跳过初始化 def log_to_csv(filename, data_dict, raw_line): """将数据字典和原始行记录到CSV文件""" with open(filename, 'a', newline='') as f: # 'a'模式表示追加 writer = csv.writer(f) local_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S') writer.writerow([ data_dict.get('ts', ''), local_time, data_dict.get('temp', ''), data_dict.get('hum', ''), data_dict.get('motion', ''), raw_line ]) # 主程序 init_csv_file(LOG_FILE) try: ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1) print(f"开始记录数据到 {LOG_FILE} ...") time.sleep(2) ser.reset_input_buffer() while True: if ser.in_waiting > 0: line = ser.readline() try: decoded_line = line.decode('utf-8').rstrip() except UnicodeDecodeError: continue if not decoded_line: continue try: sensor_data = json.loads(decoded_line) # 打印到终端 print(f"[{datetime.now().strftime('%H:%M:%S')}] 数据入库: {sensor_data}") # 写入CSV文件 log_to_csv(LOG_FILE, sensor_data, decoded_line) except json.JSONDecodeError: # 如果不是JSON，也记录原始数据 print(f"[{datetime.now().strftime('%H:%M:%S')}] 非JSON数据: {decoded_line}") with open(LOG_FILE, 'a', newline='') as f: writer = csv.writer(f) writer.writerow(['', datetime.now().strftime('%Y-%m-%d %H:%M:%S'), '', '', '', decoded_line]) except KeyboardInterrupt: print(f"\n数据记录已停止。数据保存在 {LOG_FILE}") except Exception as e: print(f"程序运行出错: {e}") finally: if 'ser' in locals() and ser.is_open: ser.close()

这个脚本创建了一个sensor_data.csv文件，每次收到有效数据都会追加一行，包含了传感器数值、本地时间戳以及原始数据字符串。这种存储方式简单通用，可以直接用Excel、Python pandas或数据库工具进行后续分析。

6. 常见问题排查与性能优化技巧

在实际操作中，你几乎一定会遇到一些问题。下面是一个常见问题速查表，以及对应的排查思路和解决方案。

6.1 性能优化建议

对于需要高速或稳定传输数据的应用，可以考虑以下优化：

1. 使用更高的波特率：在硬件和线路允许的情况下，将波特率从9600提升到115200甚至更高，可以显著提高数据传输速率。
2. 二进制传输替代文本：如果传输的是纯数值数据（如整数、浮点数），使用二进制格式（例如Serial.write((byte*)&sensorValue, sizeof(sensorValue))）比发送文本形式的数字（如“25.6”）效率高得多，数据量小，解析速度快。当然，接收端的解析代码也会稍复杂。
3. 非阻塞读取与多线程/异步：在Python主循环中，如果数据处理（如写入数据库、进行复杂计算）很耗时，会阻塞串口数据的读取，可能导致数据丢失。可以采用threading模块创建生产者-消费者模型，或使用asyncio配合支持异步的串口库（如pyserial-asyncio）。
4. 硬件流控制：如果数据量非常大，可以考虑启用硬件流控制（RTS/CTS），这需要连接额外的引脚，但可以防止接收端缓冲区溢出导致的数据丢失。

6.2 长期运行与稳定性

如果你打算让这个数据采集程序在Jetson Nano上7x24小时长期运行：

• 使用系统服务：将Python脚本配置为systemd服务，这样它可以在系统启动时自动运行，并在崩溃后自动重启。
• 完善的日志：不要只依赖print，使用Python的logging模块将程序运行状态、错误信息记录到文件中，方便后期排查。
• 看门狗机制：可以在脚本内实现一个简单的看门狗，定期检查数据接收是否正常，如果超时无数据，可以尝试重新初始化串口连接。
• 电源管理：确保Jetson Nano和Arduino的电源稳定可靠，避免因电压波动导致设备重启或通信中断。

通过以上步骤，你应该已经能够建立起一个稳定、可靠的Jetson Nano与Arduino串口通信链路。这套流程不仅适用于简单的数据回传，更是构建更复杂物联网和边缘智能应用的基石。当你熟悉了这些基础操作后，就可以尝试在其中加入更强大的功能，比如让Jetson Nano在分析完数据后，再通过串口发送控制指令给Arduino，形成完整的“感知-决策-控制”闭环。