1. 树莓派5系统初始化与环境准备
树莓派5到手后第一件事就是系统初始化,这个环节看似简单但实际踩坑不少。我刚开始玩树莓派的时候,就因为SD卡烧录问题折腾了好几个小时。现在官方推荐的Raspberry Pi Imager工具确实方便,支持一键下载系统镜像并烧录到SD卡,还能预先配置Wi-Fi、SSH和地区设置。
烧录系统时有个细节要注意:一定要用Class 10以上的高速SD卡,不然系统运行会卡顿。我之前用老旧的Class 4卡,光是启动系统就花了三分钟,更别说跑代码了。烧录完成后把SD卡插入树莓派5,接上电源和网线,等待指示灯稳定闪烁就说明系统启动成功了。
没有显示器的话,可以通过SSH远程连接。首先需要获取树莓派的IP地址,可以在路由器后台查看,或者用Advanced IP Scanner这类工具扫描局域网。找到IP后,用SSH客户端连接,默认用户名是pi,密码是raspberry。第一次登录会要求修改密码,这个步骤千万别跳过,毕竟安全第一。
系统基础配置还包括时区设置和语言包安装。建议直接运行sudo raspi-config进行可视化配置,这里面可以设置时区、键盘布局、分辨率等常用选项。我习惯先把时区调到Asia/Shanghai,避免后面日志时间对不上。
提示:如果烧录过程中SD卡出现问题,可以在Windows下用diskpart工具清理。打开管理员权限的CMD,输入diskpart → list disk → select disk X(X是你的SD卡编号)→ attributes disk clear readonly → clean。这样就能重新烧录了。
2. 开发环境依赖安装与优化
系统搞定后就要搭建开发环境了。树莓派5的ARM架构和x86平台有些差异,直接安装某些库可能会遇到兼容性问题。我的经验是先用apt update和apt upgrade更新系统,确保所有包都是最新版本。
基础开发工具链是必须的:
sudo apt install -y build-essential cmake pkg-config git
这些工具是编译C/C++程序的基础,后续安装OpenCV等库都会用到。
Python环境是重点。树莓派5预装了Python 3.9,但建议用虚拟环境管理项目依赖。由于PEP 668规范的限制,现在系统Python环境不能直接pip安装包,必须用venv:
sudo apt install python3-venv
python3 -m venv ~/pyenv
source ~/pyenv/bin/activate
激活虚拟环境后,提示符前面会出现(pyenv)标识,这时候用pip安装的包都会放在这个隔离环境里。
换源是必须操作,能大幅提升下载速度。清华源和中科大源都不错,我习惯用中科大的源:
sudo sed -i 's|raspbian.raspberrypi.org|mirrors.ustc.edu.cn/raspbian|g' /etc/apt/sources.list
sudo sed -i 's|archive.raspberrypi.org|mirrors.ustc.edu.cn/raspberrypi|g' /etc/apt/sources.d/raspberrypi.list
pip源也要换,创建~/.pip/pip.conf文件:
[global]
index-url = https://pypi.mirrors.ustc.edu.cn/simple
trusted-host = pypi.mirrors.ustc.edu.cn
GPIO库是树莓派特色,安装官方推荐的版本:
sudo apt install python3-rpi-lgpio
这个库支持树莓派5的新GPIO控制器,比之前的RPi.GPIO性能更好。
3. OpenCV的编译安装与验证
OpenCV是计算机视觉项目的核心依赖,但在树莓派上安装比较耗时。我试过直接pip安装opencv-python,但缺少GTK支持,无法显示图像窗口。所以推荐从源码编译,虽然要花一两个小时,但功能最完整。
先安装编译依赖:
sudo apt install -y libjpeg-dev libtiff5-dev libjasper-dev \
libpng-dev libwebp-dev libopenexr-dev \
libavcodec-dev libavformat-dev libswscale-dev \
libv4l-dev libxvidcore-dev libx264-dev \
libgtk-3-dev libatlas-base-dev libblas-dev \
libeigen3-dev liblapack-dev gfortran
创建虚拟环境并安装numpy(OpenCV编译需要):
source ~/pyenv/bin/activate
pip install numpy
下载OpenCV源码(建议用4.5.5这种稳定版本):
cd ~
wget -O opencv.zip https://github.com/opencv/opencv/archive/4.5.5.zip
wget -O opencv_contrib.zip https://github.com/opencv/opencv_contrib/archive/4.5.5.zip
unzip opencv.zip
unzip opencv_contrib.zip
编译配置是关键步骤,参数设置不好会影响性能:
cd opencv-4.5.5
mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=RELEASE \
-D CMAKE_INSTALL_PREFIX=/usr/local \
-D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib-4.5.5/modules \
-D ENABLE_NEON=ON \
-D ENABLE_VFPV3=ON \
-D BUILD_TESTS=OFF \
-D INSTALL_PYTHON_EXAMPLES=OFF \
-D OPENCV_ENABLE_NONFREE=ON \
-D BUILD_EXAMPLES=OFF ..
注意ENABLE_NEON和ENABLE_VFPV3要开启,这是ARM架构的SIMD指令集,能加速图像处理。
开始编译(用4线程加快速度):
make -j4
sudo make install
sudo ldconfig
编译完成后验证安装:
import cv2
print(cv2.__version__)
print(cv2.getBuildInformation())
测试摄像头功能:
import cv2
cap = cv2.VideoCapture(0)
while True:
ret, frame = cap.read()
if not ret:
break
cv2.imshow("Pi Camera", frame)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
cap.release()
cv2.destroyAllWindows()
如果能看到摄像头画面,说明OpenCV安装成功。
4. VSCode远程开发环境配置
VSCode远程开发真的太方便了,就像在本地写代码一样流畅。Windows端需要安装Remote-SSH插件,在扩展市场搜索"Remote - SSH"点击安装就行。
树莓派端要确保SSH服务正常运行:
sudo systemctl enable ssh
sudo systemctl start ssh
检查SSH配置,确保X11转发开启:
sudo nano /etc/ssh/sshd_config
确认有这两行:
X11Forwarding yes
X11DisplayOffset 10
然后重启服务:sudo systemctl restart ssh
Windows端按Ctrl+Shift+P打开命令面板,输入"Remote-SSH: Connect to Host",然后输入ssh pi@你的树莓派IP。第一次连接会提示保存主机配置,选Linux然后输入密码就行。
连接成功后,左下角会显示SSH:你的树莓派IP。这时候点击文件→打开文件夹,就能看到树莓派上的文件系统了。我习惯在/home/pi下创建project目录存放代码。
安装Python扩展是必须的。在扩展市场搜索Python,安装MS官方那个版本。安装后VSCode会自动检测虚拟环境,右下角可以选择解释器路径,选~/pyenv/bin/python就行。
调试配置需要设置launch.json:
{
"version": "0.2.0",
"configurations": [
{
"name": "Python Debugger",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal",
"justMyCode": true,
"args": [],
"env": {
"DISPLAY": ":0"
}
}
]
}
注意env里的DISPLAY设置,这是图形界面显示的关键。
5. 图形化调试与X11转发配置
在远程开发中显示图形界面是个痛点,我最初怎么试都出不来窗口,后来发现是X11配置问题。Windows需要安装X Server软件,推荐VcXsrv,下载后运行XLaunch,选择"One large window",Display number设为0,其他保持默认。
树莓派端要安装x11-apps测试工具:
sudo apt install x11-apps
连接时要用-Y参数启用信任转发:
ssh -Y pi@你的树莓派IP
测试X11转发:
xclock
如果出现一个时钟窗口,说明X11配置成功。
在Python中显示OpenCV窗口需要设置环境变量:
export DISPLAY=你的WindowsIP:0.0
这个IP是Windows电脑在局域网中的IP,可以在CMD里用ipconfig查看。
为了方便,可以把这行加到~/.bashrc里:
echo "export DISPLAY=192.168.1.100:0.0" >> ~/.bashrc
source ~/.bashrc
这样每次登录都会自动设置DISPLAY变量。
调试OpenCV程序时,可以在VSCode里直接设断点。比如在imshow这行设断点,运行到这时会暂停,可以在左侧查看变量值,右上角有调试工具栏可以步进。这时候图像窗口会卡住,继续运行后窗口就会更新。
注意:如果遇到Cannot connect to X server错误,检查Windows防火墙是否放行了VcXsrv。有时候重启XLaunch也能解决问题。
6. Systemd服务配置与自启动管理
让程序开机自启动是部署项目的关键步骤。Systemd是目前主流的服务管理工具,比以前的init.d方式更强大。
创建服务文件:
sudo nano /etc/systemd/system/my_service.service
基本配置模板:
[Unit]
Description=My Python Service
After=network.target
Wants=network.target
[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/project
Environment=PYTHONUNBUFFERED=1
Environment=DISPLAY=:0
ExecStart=/home/pi/pyenv/bin/python /home/pi/project/main.py
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target
几个关键参数解释:
- After=network.target 表示等网络就绪后再启动
- Type=simple 适用于持续运行的程序
- Restart=on-failure 在程序异常退出时自动重启
- Environment=DISPLAY=:0 设置图形界面显示
启用服务:
sudo systemctl daemon-reload
sudo systemctl enable my_service
sudo systemctl start my_service
查看服务状态:
sudo systemctl status my_service
查看日志:
journalctl -u my_service -f
调试服务时经常需要修改配置,每次改完都要重新加载:
sudo systemctl daemon-reload
sudo systemctl restart my_service
如果服务启动失败,可以用debug模式手动运行:
sudo -u pi /home/pi/pyenv/bin/python /home/pi/project/main.py
这样能看到具体的错误信息。
我遇到过权限问题,因为systemd服务默认以root运行,但我的程序需要pi用户权限。解决方法就是在Service段指定User=pi。还有一次是环境变量问题,Python找不到虚拟环境下的模块,后来在ExecStart里写了绝对路径就解决了。
对于需要图形界面的服务,还要设置XAUTHORITY:
Environment=XAUTHORITY=/home/pi/.Xauthority
这个文件存储了X11认证信息,没有的话无法显示窗口。
7. 镜像备份与快速恢复技巧
开发环境配置这么麻烦,当然要做好备份。树莓派的系统在SD卡上,容易出问题,有备份就能快速恢复。
用dd命令全盘备份:
sudo dd if=/dev/mmcblk0 of=/path/to/backup.img bs=4M status=progress
但这样备份的镜像和SD卡一样大,64G卡就会生成64G文件,很大一部分是空白空间。
推荐用PiShrink工具压缩镜像。先安装依赖:
sudo apt install -y e2fsprogs parted
下载PiShrink脚本:
wget https://raw.githubusercontent.com/Drewsif/PiShrink/master/pishrink.sh
chmod +x pishrink.sh
sudo mv pishrink.sh /usr/local/bin
压缩镜像:
sudo pishrink.sh /path/to/backup.img
这个工具会自动移除空白空间,我的64G系统压缩后只剩3.2G。
恢复镜像到新SD卡:
sudo dd if=/backup.img of=/dev/sdX bs=4M status=progress
其中sdX是新SD卡的设备名,可以用lsblk查看。
我还习惯用rsync增量备份项目文件:
rsync -av --delete /home/pi/project /path/to/backup/
这样每次只同步变化的文件,节省时间和空间。
最后建议把备份的镜像上传到网盘,我试过SD卡突然损坏,幸好有云端备份才没丢失工作成果。整个环境配置要几个小时,而恢复只要二十分钟,这个时间投入绝对是值得的。
备份完成后,可以放心大胆地折腾树莓派了。就算系统玩坏了,也能快速恢复到最新状态。这种安全感对于开发者来说太重要了,毕竟我们的时间是宝贵的。
595



被折叠的 条评论
为什么被折叠?



