Python玩转龙邱树莓派扩展板从LED闪烁到智能小车全功能开发指南树莓派作为一款功能强大的微型计算机配合扩展板可以实现各种有趣的硬件交互项目。本文将带您从最基础的LED控制开始逐步掌握红外循迹、电机驱动、超声波避障等核心功能最终打造一个完整的智能小车系统。我们将重点比较GPIOZero和RPi.GPIO两种常用库的优劣并提供可直接运行的代码示例。1. 开发环境搭建与基础GPIO控制在开始硬件编程前我们需要先完成开发环境的配置。树莓派官方系统Raspbian已经预装了Python环境但我们需要额外安装一些必要的库sudo apt-get update sudo apt-get install python3-gpiozero python3-rpi.gpioGPIOZero vs RPi.GPIO这两个库各有特点GPIOZero高级抽象代码简洁适合初学者RPi.GPIO底层控制灵活性高适合需要精确控制的场景让我们从最简单的LED闪烁开始分别用两种方式实现# GPIOZero实现LED闪烁 from gpiozero import LED from time import sleep led LED(17) # 使用BCM编号17号引脚 while True: led.on() sleep(1) led.off() sleep(1)# RPi.GPIO实现LED闪烁 import RPi.GPIO as GPIO from time import sleep GPIO.setmode(GPIO.BCM) GPIO.setup(17, GPIO.OUT) try: while True: GPIO.output(17, GPIO.HIGH) sleep(1) GPIO.output(17, GPIO.LOW) sleep(1) finally: GPIO.cleanup() # 清理GPIO设置提示使用RPi.GPIO时务必在程序结束时调用GPIO.cleanup()否则可能导致引脚状态异常。2. 扩展板功能模块详解与代码实战2.1 红外循迹模块开发红外循迹是智能小车的基础功能之一龙邱扩展板提供了4路红外传感器接口。每路传感器返回一个数字信号0或1表示是否检测到预设的轨迹线。红外传感器的灵敏度调节非常重要正确的调节步骤将小车放置在测试轨道上使用小螺丝刀调节传感器上的电位器观察LED指示灯确保传感器能稳定检测黑白分界重复调整直到所有传感器灵敏度一致下面是一个完整的红外循迹程序from gpiozero import DigitalInputDevice from time import sleep # 定义红外传感器引脚BCM编号 ir_sensors { right: DigitalInputDevice(17), mid_right: DigitalInputDevice(18), mid_left: DigitalInputDevice(27), left: DigitalInputDevice(22) } def read_sensors(): return { name: not sensor.value # 反转值使1表示检测到线 for name, sensor in ir_sensors.items() } while True: sensor_values read_sensors() print(传感器状态:, sensor_values) # 简单循迹逻辑 if sensor_values[mid_left] and sensor_values[mid_right]: print(直行) elif sensor_values[left] or sensor_values[mid_left]: print(向右调整) elif sensor_values[right] or sensor_values[mid_right]: print(向左调整) else: print(未检测到轨道) sleep(0.1)2.2 电机驱动与控制龙邱扩展板支持双电机控制每个电机需要PWM信号控制速度DIR信号控制方向。电机驱动是智能小车运动的核心正确的电机控制需要考虑以下几个方面PWM频率选择通常500Hz-1kHz为宜电机死区处理避免PWM占空比过小导致电机不转但发热加速度控制突然的速度变化可能导致车轮打滑下面是一个完整的电机控制类实现from gpiozero import PWMOutputDevice, DigitalOutputDevice from time import sleep class Motor: def __init__(self, pwm_pin, dir_pin): self.pwm PWMOutputDevice(pwm_pin, frequency1000) self.dir DigitalOutputDevice(dir_pin) self.current_speed 0 def set_speed(self, speed): 设置电机速度范围-1.0到1.0 if speed 1.0: speed 1.0 if speed -1.0: speed -1.0 self.current_speed speed if speed 0: self.dir.off() self.pwm.value speed else: self.dir.on() self.pwm.value -speed def stop(self): self.set_speed(0) # 初始化左右电机 motor_left Motor(pwm_pin19, dir_pin13) motor_right Motor(pwm_pin6, dir_pin5) # 测试电机控制 def test_motors(): print(前进) motor_left.set_speed(0.5) motor_right.set_speed(0.5) sleep(2) print(右转) motor_left.set_speed(0.5) motor_right.set_speed(-0.5) sleep(1) print(停止) motor_left.stop() motor_right.stop() test_motors()2.3 超声波避障模块超声波模块可以测量前方障碍物的距离是实现自动避障的关键传感器。HC-SR04模块需要两个GPIO引脚一个用于触发(Trig)一个用于接收回波(Echo)。超声波测距的基本原理发送至少10μs的高电平脉冲触发测距模块发射8个40kHz的超声波脉冲模块检测回波并输出高电平脉冲脉冲宽度与距离成正比from gpiozero import DigitalInputDevice, DigitalOutputDevice from time import time, sleep class Ultrasonic: def __init__(self, trig_pin, echo_pin): self.trig DigitalOutputDevice(trig_pin) self.echo DigitalInputDevice(echo_pin) self.speed_of_sound 343 # 声速单位m/s def get_distance(self): # 发送触发信号 self.trig.on() sleep(0.00001) # 10μs self.trig.off() # 等待回波开始 while not self.echo.value: pulse_start time() if time() - pulse_start 0.1: # 超时处理 return -1 # 等待回波结束 while self.echo.value: pulse_end time() if time() - pulse_end 0.1: # 超时处理 return -1 # 计算距离单位米 pulse_duration pulse_end - pulse_start distance (pulse_duration * self.speed_of_sound) / 2 return distance # 初始化超声波模块 ultrasonic Ultrasonic(trig_pin9, echo_pin11) # 测试测距功能 while True: dist ultrasonic.get_distance() if dist 0: print(f距离: {dist:.2f}米) else: print(测距失败) sleep(0.5)注意超声波测距在实际应用中需要考虑多次测量取平均、异常值过滤等问题以提高测量稳定性。3. 智能小车系统集成与高级功能3.1 多传感器数据融合将红外循迹、超声波避障等功能整合可以实现更智能的小车控制。我们需要设计一个状态机来处理不同的传感器输入class SmartCar: MODE_IDLE 0 MODE_LINE_FOLLOWING 1 MODE_OBSTACLE_AVOID 2 def __init__(self): self.mode self.MODE_IDLE self.ir_sensors [...] # 红外传感器初始化 self.ultrasonic ... # 超声波传感器初始化 self.motors [...] # 电机初始化 def update(self): if self.mode self.MODE_LINE_FOLLOWING: self.line_following() elif self.mode self.MODE_OBSTACLE_AVOID: self.obstacle_avoid() def line_following(self): # 实现循迹逻辑 pass def obstacle_avoid(self): distance self.ultrasonic.get_distance() if distance 0.3: # 30厘米内有障碍物 self.motors[0].set_speed(-0.3) self.motors[1].set_speed(0.3) sleep(0.5) else: self.motors[0].set_speed(0.5) self.motors[1].set_speed(0.5)3.2 PID控制算法实现对于更精确的运动控制可以使用PID算法。下面是一个简单的PID控制器实现class PIDController: def __init__(self, Kp, Ki, Kd): self.Kp Kp self.Ki Ki self.Kd Kd self.last_error 0 self.integral 0 def compute(self, error, dt): self.integral error * dt derivative (error - self.last_error) / dt output self.Kp * error self.Ki * self.integral self.Kd * derivative self.last_error error return output # 在循迹中应用PID控制 pid PIDController(Kp0.5, Ki0.01, Kd0.1) last_time time() while True: current_time time() dt current_time - last_time last_time current_time # 计算位置误差假设从红外传感器获取 position_error calculate_position_error() # 计算控制量 control pid.compute(position_error, dt) # 应用控制量到电机 motor_left.set_speed(0.3 control) motor_right.set_speed(0.3 - control) sleep(0.02) # 50Hz控制频率3.3 无线遥控与状态监控通过添加蓝牙或WiFi模块可以实现对小车的无线控制。下面是一个使用socket实现简单网络控制的例子import socket from threading import Thread class RemoteControl: def __init__(self, car): self.car car self.server socket.socket(socket.AF_INET, socket.SOCK_STREAM) self.server.bind((0.0.0.0, 8888)) self.server.listen(1) def start(self): Thread(targetself._accept_connections, daemonTrue).start() def _accept_connections(self): while True: conn, addr self.server.accept() print(连接来自:, addr) self._handle_client(conn) def _handle_client(self, conn): try: while True: data conn.recv(1024).decode().strip() if not data: break if data forward: self.car.set_motors(0.5, 0.5) elif data backward: self.car.set_motors(-0.3, -0.3) elif data left: self.car.set_motors(-0.3, 0.3) elif data right: self.car.set_motors(0.3, -0.3) elif data stop: self.car.set_motors(0, 0) finally: conn.close()4. 调试技巧与性能优化4.1 常见问题排查在开发过程中可能会遇到各种问题这里列出一些常见问题及解决方法电机不转但发热检查PWM频率是否合适500Hz-1kHz确保占空比足够大10%检查电机驱动模块供电是否充足红外传感器误检测重新调节传感器灵敏度检查环境光线是否太强考虑添加软件滤波多次采样取平均超声波测距不稳定确保测量面平整添加多次测量取中值逻辑检查电源是否稳定4.2 性能优化建议使用硬件PWM软件PWM可能不够精确树莓派的硬件PWM引脚BCM 12, 13, 18, 19from gpiozero import PWMOutputDevice # 使用硬件PWM motor_pwm PWMOutputDevice(18, pin_factoryPiGPIOFactory())降低CPU占用避免使用繁忙等待改用事件驱动方式from gpiozero import Button from signal import pause button Button(23) button.when_pressed lambda: print(按下!) pause() # 保持程序运行但不占用CPU电源管理电机工作时可能导致电压波动建议为树莓派和电机使用独立电源在电源线上添加大容量电容监测系统电压防止低电压导致异常4.3 扩展功能思路完成基础功能后可以考虑添加更多高级功能摄像头视觉处理使用OpenCV实现颜色跟踪、人脸检测等IMU姿态感知添加MPU6050等传感器实现姿态检测SLAM建图导航使用激光雷达或视觉SLAM算法实现自主导航ROS集成将小车作为ROS节点实现更复杂的机器人功能# 简单的OpenCV颜色检测示例 import cv2 cap cv2.VideoCapture(0) while True: ret, frame cap.read() hsv cv2.cvtColor(frame, cv2.COLOR_BGR2HSV) # 定义红色范围 lower_red (0, 100, 100) upper_red (10, 255, 255) mask cv2.inRange(hsv, lower_red, upper_red) contours, _ cv2.findContours(mask, cv2.RETR_TREE, cv2.CHAIN_APPROX_SIMPLE) for cnt in contours: area cv2.contourArea(cnt) if area 500: x, y, w, h cv2.boundingRect(cnt) cv2.rectangle(frame, (x,y), (xw,yh), (0,255,0), 2) cv2.imshow(Frame, frame) if cv2.waitKey(1) 0xFF ord(q): break cap.release() cv2.destroyAllWindows()
用Python玩转龙邱树莓派扩展板：从LED闪烁到小车循迹的保姆级代码实战
Python玩转龙邱树莓派扩展板从LED闪烁到智能小车全功能开发指南树莓派作为一款功能强大的微型计算机配合扩展板可以实现各种有趣的硬件交互项目。本文将带您从最基础的LED控制开始逐步掌握红外循迹、电机驱动、超声波避障等核心功能最终打造一个完整的智能小车系统。我们将重点比较GPIOZero和RPi.GPIO两种常用库的优劣并提供可直接运行的代码示例。1. 开发环境搭建与基础GPIO控制在开始硬件编程前我们需要先完成开发环境的配置。树莓派官方系统Raspbian已经预装了Python环境但我们需要额外安装一些必要的库sudo apt-get update sudo apt-get install python3-gpiozero python3-rpi.gpioGPIOZero vs RPi.GPIO这两个库各有特点GPIOZero高级抽象代码简洁适合初学者RPi.GPIO底层控制灵活性高适合需要精确控制的场景让我们从最简单的LED闪烁开始分别用两种方式实现# GPIOZero实现LED闪烁 from gpiozero import LED from time import sleep led LED(17) # 使用BCM编号17号引脚 while True: led.on() sleep(1) led.off() sleep(1)# RPi.GPIO实现LED闪烁 import RPi.GPIO as GPIO from time import sleep GPIO.setmode(GPIO.BCM) GPIO.setup(17, GPIO.OUT) try: while True: GPIO.output(17, GPIO.HIGH) sleep(1) GPIO.output(17, GPIO.LOW) sleep(1) finally: GPIO.cleanup() # 清理GPIO设置提示使用RPi.GPIO时务必在程序结束时调用GPIO.cleanup()否则可能导致引脚状态异常。2. 扩展板功能模块详解与代码实战2.1 红外循迹模块开发红外循迹是智能小车的基础功能之一龙邱扩展板提供了4路红外传感器接口。每路传感器返回一个数字信号0或1表示是否检测到预设的轨迹线。红外传感器的灵敏度调节非常重要正确的调节步骤将小车放置在测试轨道上使用小螺丝刀调节传感器上的电位器观察LED指示灯确保传感器能稳定检测黑白分界重复调整直到所有传感器灵敏度一致下面是一个完整的红外循迹程序from gpiozero import DigitalInputDevice from time import sleep # 定义红外传感器引脚BCM编号 ir_sensors { right: DigitalInputDevice(17), mid_right: DigitalInputDevice(18), mid_left: DigitalInputDevice(27), left: DigitalInputDevice(22) } def read_sensors(): return { name: not sensor.value # 反转值使1表示检测到线 for name, sensor in ir_sensors.items() } while True: sensor_values read_sensors() print(传感器状态:, sensor_values) # 简单循迹逻辑 if sensor_values[mid_left] and sensor_values[mid_right]: print(直行) elif sensor_values[left] or sensor_values[mid_left]: print(向右调整) elif sensor_values[right] or sensor_values[mid_right]: print(向左调整) else: print(未检测到轨道) sleep(0.1)2.2 电机驱动与控制龙邱扩展板支持双电机控制每个电机需要PWM信号控制速度DIR信号控制方向。电机驱动是智能小车运动的核心正确的电机控制需要考虑以下几个方面PWM频率选择通常500Hz-1kHz为宜电机死区处理避免PWM占空比过小导致电机不转但发热加速度控制突然的速度变化可能导致车轮打滑下面是一个完整的电机控制类实现from gpiozero import PWMOutputDevice, DigitalOutputDevice from time import sleep class Motor: def __init__(self, pwm_pin, dir_pin): self.pwm PWMOutputDevice(pwm_pin, frequency1000) self.dir DigitalOutputDevice(dir_pin) self.current_speed 0 def set_speed(self, speed): 设置电机速度范围-1.0到1.0 if speed 1.0: speed 1.0 if speed -1.0: speed -1.0 self.current_speed speed if speed 0: self.dir.off() self.pwm.value speed else: self.dir.on() self.pwm.value -speed def stop(self): self.set_speed(0) # 初始化左右电机 motor_left Motor(pwm_pin19, dir_pin13) motor_right Motor(pwm_pin6, dir_pin5) # 测试电机控制 def test_motors(): print(前进) motor_left.set_speed(0.5) motor_right.set_speed(0.5) sleep(2) print(右转) motor_left.set_speed(0.5) motor_right.set_speed(-0.5) sleep(1) print(停止) motor_left.stop() motor_right.stop() test_motors()2.3 超声波避障模块超声波模块可以测量前方障碍物的距离是实现自动避障的关键传感器。HC-SR04模块需要两个GPIO引脚一个用于触发(Trig)一个用于接收回波(Echo)。超声波测距的基本原理发送至少10μs的高电平脉冲触发测距模块发射8个40kHz的超声波脉冲模块检测回波并输出高电平脉冲脉冲宽度与距离成正比from gpiozero import DigitalInputDevice, DigitalOutputDevice from time import time, sleep class Ultrasonic: def __init__(self, trig_pin, echo_pin): self.trig DigitalOutputDevice(trig_pin) self.echo DigitalInputDevice(echo_pin) self.speed_of_sound 343 # 声速单位m/s def get_distance(self): # 发送触发信号 self.trig.on() sleep(0.00001) # 10μs self.trig.off() # 等待回波开始 while not self.echo.value: pulse_start time() if time() - pulse_start 0.1: # 超时处理 return -1 # 等待回波结束 while self.echo.value: pulse_end time() if time() - pulse_end 0.1: # 超时处理 return -1 # 计算距离单位米 pulse_duration pulse_end - pulse_start distance (pulse_duration * self.speed_of_sound) / 2 return distance # 初始化超声波模块 ultrasonic Ultrasonic(trig_pin9, echo_pin11) # 测试测距功能 while True: dist ultrasonic.get_distance() if dist 0: print(f距离: {dist:.2f}米) else: print(测距失败) sleep(0.5)注意超声波测距在实际应用中需要考虑多次测量取平均、异常值过滤等问题以提高测量稳定性。3. 智能小车系统集成与高级功能3.1 多传感器数据融合将红外循迹、超声波避障等功能整合可以实现更智能的小车控制。我们需要设计一个状态机来处理不同的传感器输入class SmartCar: MODE_IDLE 0 MODE_LINE_FOLLOWING 1 MODE_OBSTACLE_AVOID 2 def __init__(self): self.mode self.MODE_IDLE self.ir_sensors [...] # 红外传感器初始化 self.ultrasonic ... # 超声波传感器初始化 self.motors [...] # 电机初始化 def update(self): if self.mode self.MODE_LINE_FOLLOWING: self.line_following() elif self.mode self.MODE_OBSTACLE_AVOID: self.obstacle_avoid() def line_following(self): # 实现循迹逻辑 pass def obstacle_avoid(self): distance self.ultrasonic.get_distance() if distance 0.3: # 30厘米内有障碍物 self.motors[0].set_speed(-0.3) self.motors[1].set_speed(0.3) sleep(0.5) else: self.motors[0].set_speed(0.5) self.motors[1].set_speed(0.5)3.2 PID控制算法实现对于更精确的运动控制可以使用PID算法。下面是一个简单的PID控制器实现class PIDController: def __init__(self, Kp, Ki, Kd): self.Kp Kp self.Ki Ki self.Kd Kd self.last_error 0 self.integral 0 def compute(self, error, dt): self.integral error * dt derivative (error - self.last_error) / dt output self.Kp * error self.Ki * self.integral self.Kd * derivative self.last_error error return output # 在循迹中应用PID控制 pid PIDController(Kp0.5, Ki0.01, Kd0.1) last_time time() while True: current_time time() dt current_time - last_time last_time current_time # 计算位置误差假设从红外传感器获取 position_error calculate_position_error() # 计算控制量 control pid.compute(position_error, dt) # 应用控制量到电机 motor_left.set_speed(0.3 control) motor_right.set_speed(0.3 - control) sleep(0.02) # 50Hz控制频率3.3 无线遥控与状态监控通过添加蓝牙或WiFi模块可以实现对小车的无线控制。下面是一个使用socket实现简单网络控制的例子import socket from threading import Thread class RemoteControl: def __init__(self, car): self.car car self.server socket.socket(socket.AF_INET, socket.SOCK_STREAM) self.server.bind((0.0.0.0, 8888)) self.server.listen(1) def start(self): Thread(targetself._accept_connections, daemonTrue).start() def _accept_connections(self): while True: conn, addr self.server.accept() print(连接来自:, addr) self._handle_client(conn) def _handle_client(self, conn): try: while True: data conn.recv(1024).decode().strip() if not data: break if data forward: self.car.set_motors(0.5, 0.5) elif data backward: self.car.set_motors(-0.3, -0.3) elif data left: self.car.set_motors(-0.3, 0.3) elif data right: self.car.set_motors(0.3, -0.3) elif data stop: self.car.set_motors(0, 0) finally: conn.close()4. 调试技巧与性能优化4.1 常见问题排查在开发过程中可能会遇到各种问题这里列出一些常见问题及解决方法电机不转但发热检查PWM频率是否合适500Hz-1kHz确保占空比足够大10%检查电机驱动模块供电是否充足红外传感器误检测重新调节传感器灵敏度检查环境光线是否太强考虑添加软件滤波多次采样取平均超声波测距不稳定确保测量面平整添加多次测量取中值逻辑检查电源是否稳定4.2 性能优化建议使用硬件PWM软件PWM可能不够精确树莓派的硬件PWM引脚BCM 12, 13, 18, 19from gpiozero import PWMOutputDevice # 使用硬件PWM motor_pwm PWMOutputDevice(18, pin_factoryPiGPIOFactory())降低CPU占用避免使用繁忙等待改用事件驱动方式from gpiozero import Button from signal import pause button Button(23) button.when_pressed lambda: print(按下!) pause() # 保持程序运行但不占用CPU电源管理电机工作时可能导致电压波动建议为树莓派和电机使用独立电源在电源线上添加大容量电容监测系统电压防止低电压导致异常4.3 扩展功能思路完成基础功能后可以考虑添加更多高级功能摄像头视觉处理使用OpenCV实现颜色跟踪、人脸检测等IMU姿态感知添加MPU6050等传感器实现姿态检测SLAM建图导航使用激光雷达或视觉SLAM算法实现自主导航ROS集成将小车作为ROS节点实现更复杂的机器人功能# 简单的OpenCV颜色检测示例 import cv2 cap cv2.VideoCapture(0) while True: ret, frame cap.read() hsv cv2.cvtColor(frame, cv2.COLOR_BGR2HSV) # 定义红色范围 lower_red (0, 100, 100) upper_red (10, 255, 255) mask cv2.inRange(hsv, lower_red, upper_red) contours, _ cv2.findContours(mask, cv2.RETR_TREE, cv2.CHAIN_APPROX_SIMPLE) for cnt in contours: area cv2.contourArea(cnt) if area 500: x, y, w, h cv2.boundingRect(cnt) cv2.rectangle(frame, (x,y), (xw,yh), (0,255,0), 2) cv2.imshow(Frame, frame) if cv2.waitKey(1) 0xFF ord(q): break cap.release() cv2.destroyAllWindows()
