ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀，每一条都经过真实交付验证。

首页 / 资讯中心 / 正文

树莓派SPI1接口配置MCP2515 CAN总线控制器完整指南

2026/8/5 9:06:16 拓冰建站 浏览量
树莓派SPI1接口配置MCP2515 CAN总线控制器完整指南 1. 项目概述当树莓派的SPI0口被占用时玩树莓派的朋友尤其是做物联网、机器人或者汽车电子相关项目的肯定对MCP2515这颗CAN总线控制器芯片不陌生。它价格便宜驱动成熟是让树莓派接入CAN网络最经典、最稳定的方案。通常的教程都会告诉你把MCP2515模块接到树莓派的SPI0接口也就是那组标着MOSI, MISO, SCK, CE0, CE1的引脚上然后加载spidev和mcp251x驱动一切就搞定了。但现实情况往往更复杂。你的树莓派上可能已经接了一个SPI屏幕、一个SPI接口的ADC芯片或者像我之前做的一个项目SPI0被一个高精度的惯性测量单元IMU给占用了。这时候你看着手头另一个急需CAN通信功能的项目难道要再买一块树莓派当然不。树莓派从3B开始其实就隐藏了第二组甚至第三组SPI硬件接口也就是SPI1和SPI2。它们没有像SPI0那样有现成的、物理引脚直接引出但通过配置设备树Device Tree我们可以将这些接口“映射”到指定的GPIO引脚上从而让MCP2515“移居”到新的SPI总线。这个项目要解决的就是这个“移居”问题。核心目标很明确在不干扰原有SPI0设备工作的前提下启用树莓派的SPI1或SPI2接口并成功驱动MCP2515 CAN控制器使其稳定工作。整个过程会深入到Linux的设备树配置、驱动加载和引脚复用是深入理解树莓派底层硬件和Linux驱动模型的一个绝佳实践。无论你是想扩展树莓派的接口能力还是单纯对设备树感到好奇这篇从踩坑到填坑的完整记录都能给你一份可以直接“抄作业”的指南。2. 硬件与原理深度解析2.1 树莓派的SPI硬件资源盘点很多人以为树莓派只有一个SPI其实不然。以最常见的树莓派3B/4B/5为例其博通BCM283x系列SoC内部通常包含多个SPI控制器SPI0 (Primary SPI): 这是主SPI接口对应物理引脚GPIO 9 (MISO), 10 (MOSI), 11 (SCLK)以及片选CE0 (GPIO 8)和CE1 (GPIO 7)。它被最广泛地支持默认在系统配置中启用。SPI1 (Auxiliary SPI): 这是一个辅助SPI接口。在树莓派上它通常没有预定义的标准引脚映射需要用户手动配置。其硬件控制器是独立的可以与SPI0并行工作。SPI2 (Secondary SPI): 在某些型号如CM4或特定配置下可用是另一个独立的SPI控制器。为什么默认只用SPI0主要是为了兼容性和简化用户入门。把一组功能固定、文档齐全的引脚留给最常用的外设可以避免新手混淆。SPI1和SPI2则留给了有更高级定制需求、或者系统设计者比如使用树莓派计算模块做载板去自由发挥。选择SPI1还是SPI2对于大多数让MCP2515“移居”的场景SPI1是更常见、更稳妥的选择。原因有三首先其驱动支持相对更完善其次可用的GPIO引脚选择更多更容易找到一组未被其他功能占用的“干净”引脚最后社区实践案例更丰富遇到问题更容易找到参考。SPI2通常在一些更专业的扩展板或计算模块的特定引脚上才有引出通用性稍弱。因此除非你的硬件设计明确要求使用SPI2否则建议优先考虑SPI1。2.2 MCP2515与SPI通信的关键细节MCP2515是一颗独立的CAN控制器它通过SPI接口接受主控制器这里是树莓派的指令并独立处理CAN协议帧的收发、滤波、缓冲等复杂任务。这意味着树莓派CPU的负载很低只需要通过SPI读写几个寄存器即可。通信的关键参数必须匹配SPI模式: MCP2515支持SPI模式0,0和1,1。绝大多数情况下使用Mode 0(CPOL0, CPHA0) 即可。这是最常用的SPI模式时钟空闲时为低电平数据在时钟上升沿采样。时钟频率: MCP2515的最高SPI时钟频率典型值为10 MHz。树莓派的SPI控制器可以轻松输出这个频率。在实际配置中我们通常会设置一个低于上限的值以确保稳定比如8 MHz或5 MHz。片选 (Chip Select, CS): 这是SPI通信中用于选择从设备的关键信号。每个SPI控制器可以管理多个片选线。我们需要为MCP2515分配一个独立的片选引脚。硬件连接示意以使用SPI1为例 假设我们选择GPIO 16作为SPI1的片选CE0那么连接如下树莓派 GPIO 引脚 (BCM编号)引脚功能 (SPI1)连接至 MCP2515 模块引脚GPIO 16 (Pin 36)SPI1_CE0_N (片选0)CS (Chip Select)GPIO 19 (Pin 35)SPI1_MISO (主入从出)SO (Serial Output)GPIO 20 (Pin 38)SPI1_MOSI (主出从入)SI (Serial Input)GPIO 21 (Pin 40)SPI1_SCLK (时钟)SCK (Clock)任意 3.3V 引脚 (如 Pin 1)3.3V PowerVCC任意 GND 引脚 (如 Pin 39)GroundGND注意务必确认你的MCP2515模块逻辑电平是3.3V。树莓派的GPIO是3.3V电平如果模块是5V的需要加电平转换电路否则可能损坏树莓派。2.3 设备树Device Tree的核心作用设备树是Linux内核用于描述硬件配置的一种数据结构。它就像一个“菜单”告诉内核“这块板子上在什么地方哪个GPIO有什么样的设备SPI控制器以及这个设备上又挂了什么子设备MCP2515”。在树莓派上默认的bcm2711-rpi-4-b.dtb对于Pi 4等设备树二进制文件只启用了SPI0。我们要使用SPI1就需要修改这个“菜单”增加关于SPI1控制器及其引脚配置的条目并在它下面挂载一个mcp2515子节点。修改方式不是直接编辑二进制文件而是编写一个“覆盖层”Device Tree Overlay。这是一个小型的、只描述我们想要修改或新增部分的设备树片段。系统启动时它会自动与基础设备树合并从而实现动态的硬件配置无需重新编译整个内核。这是我们本次项目的技术核心。3. 软件环境准备与配置3.1 系统与内核头文件首先确保你的树莓派系统是最新的并且安装了编译设备树覆盖层所必需的内核头文件。我使用的是树莓派官方64位Bullseye系统但方法适用于多数基于Debian的版本。# 更新软件包列表并升级系统 sudo apt update sudo apt full-upgrade -y # 安装设备树编译器dtc和内核头文件 sudo apt install -y device-tree-compiler raspberrypi-kernel-headers # 重启以确保使用新内核 sudo reboot安装内核头文件非常关键。因为编译覆盖层时需要引用内核源代码中的头文件来获取正确的引脚定义和驱动绑定信息。如果缺少头文件编译可能会失败或者生成错误的覆盖层。3.2 确认SPI驱动状态在开始之前先检查一下当前SPI接口的状态。# 查看已加载的SPI相关内核模块 lsmod | grep spi # 查看系统识别到的SPI控制器 ls /dev/spidev*正常情况下如果你从未启用过SPI/dev/spidev*可能不存在。如果你启用了SPI0通过raspi-config或/boot/config.txt你可能会看到/dev/spidev0.0和/dev/spidev0.1。我们的目标是让系统在配置后出现/dev/spidev1.0对应SPI1, CE0。同时检查MCP2515的驱动是否可用# 查找MCP2515相关的内核模块 find /lib/modules/$(uname -r) -name *mcp251* -type f你应该能看到类似mcp251x.ko的文件。如果没有可能需要安装或编译内核模块但树莓派官方内核通常已包含。4. 创建并编译SPI1设备树覆盖层这是整个过程中最核心的一步。我们将创建一个.dts设备树源文件描述如何启用SPI1并将其引脚映射到我们想要的GPIO上。4.1 编写设备树覆盖层源文件创建一个新文件例如spi1-mcp2515.dtssudo nano /boot/overlays/spi1-mcp2515.dts将以下内容粘贴进去。请仔细阅读注释理解每一部分的作用/dts-v1/; /plugin/; / { compatible brcm,bcm2835; // 与树莓派SoC兼容 fragment0 { target gpio; __overlay__ { // 定义SPI1引脚的状态使用pinctrl子系统 spi1_pins: spi1_pins { brcm,pins 19 20 21; // GPIO 19 (MISO), 20 (MOSI), 21 (SCLK) brcm,function 3; // 功能码3代表ALT4即SPI1功能 brcm,pull 0; // 上下拉电阻0关闭1下拉2上拉 }; spi1_cs_pins: spi1_cs_pins { brcm,pins 16; // GPIO 16 作为片选CE0 brcm,function 1; // 功能码1代表输出模式 // 注意片选引脚通常由驱动控制初始化为输出高电平不选中 }; }; }; fragment1 { target spi1; // 目标是SPI1控制器节点 __overlay__ { #address-cells 1; #size-cells 0; status okay; // 启用SPI1控制器 pinctrl-names default; pinctrl-0 spi1_pins spi1_cs_pins; // 应用上面定义的引脚配置 // 定义SPI1总线上的从设备MCP2515 mcp25150 { compatible microchip,mcp2515; // 驱动匹配的关键字 reg 0; // 片选编号0对应我们定义的spi1_cs_pins中的GPIO 16 spi-max-frequency 10000000; // SPI时钟频率10MHz interrupt-parent gpio; // 中断引脚连接到GPIO interrupts 26 8; // 使用GPIO 26高电平触发 (8 IRQ_TYPE_LEVEL_HIGH) clocks mcp2515_osc; // 引用下面的振荡器定义 // 定义MCP2515外部的振荡器 mcp2515_osc: oscillator { compatible fixed-clock; #clock-cells 0; clock-frequency 16000000; // MCP2515模块常见的16MHz晶振频率 }; }; }; }; fragment2 { target-path /; __overlay__ { // 这个片段可以留空或者用于其他全局定义 // 例如如果需要定义一个稳压器可以放在这里 }; }; };关键参数解析与避坑指南brcm,function: 这是最易出错的地方。树莓派每个GPIO有多个复用功能ALT0, ALT1, ALT2, ALT3, ALT4, ALT5。对于SPI1GPIO 19 (MISO): 功能应为ALT4GPIO 20 (MOSI): 功能应为ALT4GPIO 21 (SCLK): 功能应为ALT4GPIO 16 (CE0): 作为GPIO控制的片选设置为普通输出模式1。也可以设置为ALT4让硬件控制但软件控制更灵活。interrupts 26 8: 这一行定义了MCP2515的中断引脚。MCP2515的INT引脚需要连接到一个树莓派的GPIO这里以GPIO 26为例并在收到CAN消息时产生中断。26 8表示使用GPIO 26中断触发类型为“高电平有效”8。你必须将MCP2515模块的INT引脚实际连接到树莓派的GPIO 26或其他你指定的引脚并在此处修改对应的GPIO编号。如果不需要中断功能轮询模式可以删除interrupt-parent和interrupts这两行但强烈建议使用中断以提高效率。clock-frequency 16000000: 这个值必须与你MCP2515模块上焊接的晶振频率一致常见的有8MHz, 16MHz。用错了会导致CAN通信波特率计算错误无法通信。拆开模块看一下晶振上印的数字是最保险的。spi-max-frequency: 设置为10,000,000 (10MHz)。这是MCP2515的安全上限。如果你的布线较长或有干扰可以降低到5MHz或8MHz以提高稳定性。4.2 编译与部署覆盖层保存并退出编辑器在nano中按CtrlX然后按Y再按Enter。接下来使用设备树编译器dtc将这个.dts源文件编译成.dtbo二进制覆盖层文件# 编译设备树覆盖层 sudo dtc - -I dts -O dtb -o /boot/overlays/spi1-mcp2515.dtbo /boot/overlays/spi1-mcp2515.dts参数解释-: 允许使用符号引用对于覆盖层是必须的。-I dts: 输入格式为dts。-O dtb: 输出格式为dtb设备树二进制。-o: 指定输出文件路径。编译成功后/boot/overlays/目录下会生成spi1-mcp2515.dtbo文件。4.3 配置系统加载覆盖层现在需要告诉系统在启动时加载这个覆盖层。编辑树莓派的config.txt文件sudo nano /boot/config.txt在文件末尾添加以下行# 启用SPI1接口并加载MCP2515配置 dtoverlayspi1-mcp2515如果你想同时启用SPI0确保文件中没有dtparamspioff或者有dtparamspion。默认情况下SPI0是关闭的如果需要可以加上dtparamspion。保存并退出。5. 系统重启与驱动加载验证5.1 重启并检查内核日志执行重启命令sudo reboot系统重启后首先查看内核启动日志确认覆盖层是否加载成功以及设备是否被识别# 查看内核启动信息过滤出SPI和MCP2515相关日志 sudo dmesg | grep -E (spi|mcp2515|CAN)你应该能看到类似下面的输出这表明SPI1控制器和MCP2515设备已被成功识别和注册[ 5.123456] spi-bcm2835 3f804000.spi: SPI controller at 0x3f804000 (irq 93) [ 5.234567] mcp251x spi1.0: MCP2515 successfully initialized. [ 5.234568] mcp251x spi1.0: CAN device registered (irq123)如果看到错误比如“failed to claim CS pin”或“probe failed”请返回检查设备树覆盖层中的引脚定义是否正确是否有冲突以及硬件连接是否牢固。5.2 验证设备节点检查SPI设备节点和CAN网络接口是否创建# 查看SPI设备现在应该能看到spidev1.0 ls -l /dev/spidev* # 查看CAN网络接口应该能看到can0 ip link show如果一切正常ip link show命令的输出中会有一个can0接口状态是DOWN还未启动。5.3 配置并启动CAN接口CAN接口需要配置波特率后才能启动。使用ip命令和can-utils工具包需要安装sudo apt install can-utils# 设置CAN0的波特率为500kbps这是汽车CAN网络最常用的速率之一 sudo ip link set can0 type can bitrate 500000 # 启动CAN0接口 sudo ip link set up can0 # 再次查看接口状态现在应该是UP状态了 ip link show can0输出应显示state UP。你也可以使用ifconfig can0来查看。6. 功能测试与数据收发6.1 基础回环测试首先进行本地回环测试验证驱动和接口基本功能是否正常# 设置CAN0为回环模式自己发自己收 sudo ip link set can0 type can bitrate 500000 loopback on sudo ip link set up can0 # 在一个终端发送数据 candump can0 # 在另一个终端或新开一个SSH窗口发送一帧数据 cansend can0 123#1122334455667788如果回环测试成功你会在candump的终端看到接收到的帧ID是123数据是11 22 33 44 55 66 77 88。6.2 连接真实CAN网络测试关闭回环模式连接到真实的CAN总线例如连接一辆汽车的OBD-II接口或另一个CAN节点# 关闭接口取消回环模式 sudo ip link set down can0 sudo ip link set can0 type can bitrate 500000 loopback off # 重新启动接口 sudo ip link set up can0现在使用candump can0可以监听总线上的所有CAN帧。使用cansend can0 can_id#data可以向总线发送帧。例如读取车辆发动机转速标准OBD-II PID 0x0C的请求帧可能是cansend can0 7DF#02010C0000000000如果车辆支持并响应你会在candump中看到回复帧。6.3 使用SocketCAN高级工具can-utils提供了更多强大工具cangen: 自动生成并发送随机或规律的CAN帧用于压力测试。canbusload: 计算并显示CAN总线的负载率。canplayer: 播放之前录制的CAN日志文件.log格式。例如进行简单的总线负载测试# 在后台以100Hz频率发送随机ID和数据的帧 cangen can0 -g 10 -i -I 7FF -L 8 # 监控总线负载 canbusload can0 5000007. 故障排查与经验实录即使按照步骤操作也可能会遇到问题。以下是我在多次实践中总结的常见问题及解决方法。7.1 设备树覆盖层编译或加载失败问题现象dmesg中无相关日志或提示Failed to load overlay spi1-mcp2515。排查步骤检查语法确保.dts文件没有拼写错误特别是分号、括号是否匹配。可以使用dtc -I dts -O dtb -o /dev/null your_file.dts 21来检查语法不输出文件只检查错误。检查路径和权限确保.dtbo文件在/boot/overlays/目录下并且config.txt中的dtoverlay行拼写正确没有多余空格。引脚冲突这是最常见的原因。你选择的GPIO如16, 19, 20, 21, 26可能被系统其他功能占用比如UART, I2C或者被用户空间程序设置为输出。使用raspi-gpio get命令查看这些引脚当前的功能状态。确保它们在加载覆盖层前是INPUT状态且未被占用。有时需要禁用其他可能冲突的接口比如在config.txt中添加enable_uart0或dtparami2c_armoff如果它们和你的SPI1引脚冲突。内核头文件不匹配如果系统刚升级过内核但未重启或者raspberrypi-kernel-headers版本与运行的内核版本不一致会导致编译的覆盖层无法加载。确保uname -r显示的内核版本与已安装的头文件版本一致。7.2 CAN接口无法启动状态一直为DOWN问题现象ip link show can0显示state DOWN执行sudo ip link set up can0后报错或dmesg中有MCP2515相关的错误如“transmit error”、“bus-off”。排查步骤检查中断引脚如果设备树中配置了中断interrupts属性但硬件上没有连接或者连接错误比如接到了3.3V或GND会导致驱动初始化失败或工作异常。确认MCP2515的INT引脚正确连接到指定的GPIO并且该GPIO在设备树中配置正确。检查晶振频率这是导致CAN波特率不准、进而无法通信或频繁“bus-off”的元凶。百分之百确认clock-frequency的值与你模块上晶振的标称值完全一致。用放大镜看。检查物理连接和电源确保SPI四根线MISO, MOSI, SCLK, CS连接正确没有接反。用万用表测量MCP2515模块的VCC电压确保是稳定的3.3V。电压不足会导致芯片工作不稳定。检查CANH和CANL之间的终端电阻。高速CAN总线需要在两端各接一个120欧姆的终端电阻。如果只是点对点测试在两个节点上各接一个或者直接在总线两端接上。降低SPI速率在设备树覆盖层中将spi-max-frequency从10000000改为50000005MHz重新编译加载测试。长导线或干扰环境可能导致高速SPI通信出错。检查CAN总线电平使用示波器或CAN总线分析仪查看CANH和CANL的波形。隐性电平逻辑1时两者电压应接近2.5V且相等。显性电平逻辑0时CANH应约3.5VCANL应约1.5V。如果电平异常检查MCP2515的CAN收发器通常是TJA1050或SN65HVD230是否损坏或者VCC电压是否正常。7.3 能收到数据但发送失败问题现象candump能收到其他节点的数据但cansend发送后自己收不到非回环模式对方也收不到。排查步骤检查总线终端电阻缺少终端电阻会导致信号反射严重时可能无法通信。确保总线上至少有两个120欧姆电阻。检查波特率一致性总线上所有节点的波特率必须完全相同。哪怕有1%的误差长期通信也可能出问题。使用ip -details link show can0确认设置的波特率。如果可能用分析仪确认总线实际波特率。MCP2515发送缓冲区错误查看内核日志dmesg | grep mcp2515是否有“TX buffer full”或类似错误。这可能是软件发送过快而硬件来不及处理。可以尝试在发送命令间增加微小延迟。7.4 性能优化与稳定性建议中断与轮询设备树中配置中断是最佳实践。中断方式可以极大降低CPU占用率提高实时性。如果确实不想用中断驱动也支持轮询模式但需要在加载内核模块时传递参数oscillator16000000根据你的晶振修改并确保设备树中不定义interrupts属性。轮询模式下需要用一个内核线程不断检查芯片状态对简单应用可以但对负载重的总线不推荐。提高接收缓冲区默认的SocketCAN接收缓冲区可能较小在高负载下会丢帧。可以增加缓冲区大小sudo sysctl -w net.core.rmem_max262144 sudo sysctl -w net.core.rmem_default262144可以将这些命令添加到/etc/sysctl.conf中使其永久生效。使用更高效的发送方式对于需要高速、连续发送的应用如模拟ECU数据使用cangen或自己编写C程序使用SocketCAN接口比循环调用cansend脚本效率高得多因为后者每次都要建立和销毁Socket连接。经过以上步骤你应该已经成功将MCP2515挂载到了树莓派的SPI1接口上并建立了稳定的CAN通信。这个过程虽然涉及到底层的设备树配置但每一步都有其明确的目的。掌握这个方法后你就能让树莓派灵活地适配各种硬件连接需求不再受限于默认的引脚定义。下次当SPI0被占用时你完全可以自信地说“没关系我们还有SPI1。”