BrachioGraph软件安装与配置教程：树莓派环境搭建从零开始

BrachioGraph软件安装与配置教程：树莓派环境搭建从零开始

【免费下载链接】BrachioGraphBrachioGraph is an ultra-cheap (total cost of materials: €14) plotter that can be built with minimal skills.项目地址: https://gitcode.com/gh_mirrors/br/BrachioGraph

想要体验用树莓派制作超低成本绘图机的乐趣吗？BrachioGraph是一款总成本仅约14欧元的极简绘图机，只需两根木棍、一支笔和一些胶水就能制作完成！本教程将手把手教你如何在树莓派上安装和配置BrachioGraph软件，从零开始搭建完整的绘图环境，让你轻松制作属于自己的DIY绘图机。

准备工作：系统环境搭建

选择合适的树莓派系统

BrachioGraph绘图机软件推荐使用树莓派Zero作为核心控制器，通过OTG（On-The-Go）模式，只需一根USB线就能同时提供电源和网络连接。首先需要下载并安装Raspberry Pi OS Lite（最小化镜像）：

1. 从树莓派官网下载最新的Raspberry Pi OS Lite镜像
2. 使用工具将镜像写入micro SD卡
3. 在SD卡的boot分区根目录创建空文件ssh以启用SSH访问
4. 编辑config.txt文件，在末尾添加：dtoverlay=dwc2
5. 编辑cmdline.txt文件，在rootwait后添加：modules-load=dwc2,g_ether

连接树莓派Zero

将配置好的SD卡插入树莓派Zero，使用USB线连接到电脑的USB端口（注意是标有"USB"的端口，不是旁边的"PWR"端口）。系统会自动识别设备：

• Mac系统：设备显示为"RNDIS/Ethernet Gadget"
• Ubuntu系统：显示为"有线连接"
• 通过SSH连接：ssh pi@raspberrypi.local（默认密码：raspberry）

安装系统依赖包

连接到树莓派后，首先更新系统并安装必要的软件包。根据你使用的操作系统选择相应的命令：

Raspberry PiOS（推荐系统）：

sudo apt update sudo apt upgrade -y sudo apt install -y python3-venv python3-tk pigpiod libjbig0 libjpeg-dev liblcms2-2 libopenjp2-7 libtiff5 libwebp6 libwebpdemux2 libwebpmux3 libzstd1 libatlas3-base libgfortran5 git tmux

Ubuntu系统（22.04及以上）：

sudo apt install -y python3-venv python3-tk libjbig0 libjpeg-dev liblcms2-2 libopenjp2-7 libtiff5 libwebpdemux2 libwebpmux3 libzstd1 libatlas3-base libgfortran5 git python3.10-venv python3-dev unzip make build-essential python3-pip

对于Ubuntu系统，还需要手动编译安装PIGPIO库：

cd /tmp wget https://github.com/joan2937/pigpio/archive/master.zip unzip master.zip cd pigpio-master make sudo make install cd

PIGPIO库是控制GPIO引脚的关键组件，能够提供精确的脉冲时序控制，确保伺服电机的准确运行。

设置Python虚拟环境

为了避免与系统Python包冲突，建议创建独立的虚拟环境：

python3 -m venv env source env/bin/activate

激活虚拟环境后，终端提示符会显示(env)前缀。每次使用BrachioGraph软件时都需要激活这个环境，可以使用source env/bin/activate重新激活。

获取BrachioGraph源代码

克隆代码仓库

使用Git克隆BrachioGraph项目到本地。如果你已配置SSH密钥，可以使用SSH方式：

git clone git@github.com:evildmp/BrachioGraph.git

或者使用HTTPS方式：

git clone https://github.com/evildmp/BrachioGraph.git

如果使用国内镜像源，可以替换为：

git clone https://gitcode.com/gh_mirrors/br/BrachioGraph.git

项目结构概览

进入项目目录查看主要文件：

cd BrachioGraph ls -la

核心文件包括：

• brachiograph.py- 主绘图机控制类
• plotter.py- 绘图机基类
• pen.py- 笔控制模块
• linedraw.py- 线条绘制工具
• turtle_plotter.py- Turtle图形接口
• requirements.txt- Python依赖包列表

安装Python依赖包

在激活的虚拟环境中安装所有必需的Python包：

pip install -r requirements.txt

安装的包包括：

• Numpy- Python数学计算库
• PIGPIO Python库- GPIO控制接口
• Pillow- Python图像处理库
• tqdm- 进度条显示
• readchar- 用户输入处理
• pytest- 测试框架

配置GPIO引脚连接

了解引脚布局

BrachioGraph使用树莓派的GPIO引脚控制三个伺服电机。你需要了解树莓派Zero的引脚布局：

连接伺服电机

根据官方文档的指导，正确连接三个伺服电机：

• 肩部伺服电机（控制外臂）
• 肘部伺服电机（控制内臂）
• 笔升降伺服电机（控制笔的抬起和放下）

确保使用正确的电源供应，伺服电机需要稳定的5V电源。可以使用外部电源或通过树莓派供电，但要注意电流限制。

启动绘图机服务

启动PIGPIO守护进程

PIGPIO库需要以守护进程方式运行：

sudo pigpiod

测试基本功能

启动Python交互环境测试绘图机：

source env/bin/activate cd BrachioGraph python

在Python中导入并测试BrachioGraph：

from brachiograph import BrachioGraph bg = BrachioGraph() bg.test_pattern()

校准与调试

基本校准

首次使用需要进行校准，确保绘图机能够准确移动到指定位置。BrachioGraph提供了多种校准方法：

# 手动校准模式 bg.drive() # 自动校准 bg.calibrate() # 测试绘图区域 bg.box()

高级校准选项

对于更精确的绘图，可以使用高级校准功能：

• 滞后校正（Hysteresis correction）
• 伺服电机角度映射
• 绘图区域边界设置

参考校准文档获取详细指导。

使用绘图功能

基本绘图

BrachioGraph支持多种绘图方式：

# 绘制简单图形 bg.plot_file("test-patterns/accuracy.json") # 使用Turtle图形接口 from turtle_plotter import TurtlePlotter tp = TurtlePlotter() tp.forward(100) tp.right(90)

图像转换

可以使用linedraw.py将图像转换为绘图机可识别的矢量路径：

python linedraw.py input_image.png output.json

常见问题解决

连接问题

如果无法通过SSH连接到树莓派：

1. 检查USB线连接是否牢固
2. 确认SD卡中的ssh文件是否存在
3. 尝试使用ping raspberrypi.local测试连接

伺服电机不响应

1. 检查GPIO引脚连接是否正确
2. 确认PIGPIO守护进程已启动：sudo systemctl status pigpiod
3. 检查电源供应是否充足

绘图精度问题

如果绘图不准确：

1. 重新运行校准程序
2. 检查机械结构是否稳固
3. 调整伺服电机脉冲宽度参数

进阶配置与优化

设置固定MAC地址

为了避免每次重启后设备识别问题，可以设置固定的MAC地址。创建文件/etc/modprobe.d/rndis.conf并添加：

options g_ether host_addr=ae:ad:f5:9d:9f:ba dev_addr=7a:26:9f:3e:97:6c

使用tmux管理会话

安装tmux可以保持SSH会话，即使连接断开也能恢复：

sudo apt install tmux tmux new -s brachiograph

自动化启动脚本

可以创建启动脚本，简化每次使用流程：

#!/bin/bash sudo pigpiod source ~/BrachioGraph/env/bin/activate cd ~/BrachioGraph python -c "from brachiograph import BrachioGraph; bg = BrachioGraph()"

总结与下一步

恭喜！你已经成功在树莓派上安装并配置了BrachioGraph绘图机软件。通过本教程，你学会了：

✅ 树莓派Zero系统配置与网络连接
✅ 系统依赖包和Python虚拟环境安装
✅ BrachioGraph源代码获取与依赖安装
✅ GPIO引脚连接与伺服电机控制
✅ 绘图机校准与基本功能测试

现在你可以开始探索BrachioGraph的更多功能：

• 尝试绘制更复杂的图案
• 调整绘图参数获得更好的效果
• 探索pantograph.py中的平行四边形连杆机构
• 参考官方文档了解更多高级功能

BrachioGraph的魅力在于它的极简设计和低成本，让你能够以最小的投入体验DIY绘图机的乐趣。无论是教育用途、艺术创作还是技术探索，这款开源绘图机都能带给你独特的体验。

开始你的绘图创作之旅吧！🎨

【免费下载链接】BrachioGraphBrachioGraph is an ultra-cheap (total cost of materials: €14) plotter that can be built with minimal skills.项目地址: https://gitcode.com/gh_mirrors/br/BrachioGraph