# adafruit/adafruit_mcp2515 architecture

> Architecture diagram of the GitHub repository adafruit/adafruit_mcp2515, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adafruit/adafruit_mcp2515
- Repository: https://github.com/adafruit/adafruit_mcp2515

## Overview

Adafruit MCP2515 is an Arduino library for the MCP2515 FeatherWing. An Arduino application uses the library’s CAN-controller API to initialize the chip, send and receive CAN packets, and configure filters or operating modes. The implementation communicates with the MCP2515 over SPI and inherits common controller behavior from CANControllerClass. The README establishes the library’s product role; the sampled source shows SPI access and the main driver capabilities, but not example sketches or the full interrupt flow.

Main entry points: [`src/Adafruit_MCP2515.cpp`](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp) (Chip setup), [`src/Adafruit_MCP2515.h`](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.h) (Controller API)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_arduino_app(("Arduino application"))
node_controller_api["Controller API<br/>[Adafruit_MCP2515.h]"]
node_driver_setup["Chip setup"]
node_can_io["CAN packet I/O"]
node_filters_modes["Filters and modes"]
node_register_tools["Register tools"]
node_can_base["CANControllerClass"]
node_spi_busio["Adafruit SPI device"]
node_mcp2515{{"MCP2515 chip"}}

node_arduino_app -->|"uses library"| node_controller_api
node_controller_api -->|"declares API"| node_driver_setup
node_driver_setup -->|"initializes base"| node_can_base
node_can_io -->|"delegates packet"| node_can_base
node_driver_setup -->|"starts SPI"| node_spi_busio
node_can_io -->|"reads and writes"| node_spi_busio
node_filters_modes -->|"accesses registers"| node_spi_busio
node_register_tools -->|"reads registers"| node_spi_busio
node_spi_busio -->|"transfers SPI"| node_mcp2515

click node_controller_api "https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.h"
click node_driver_setup "https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp"
click node_can_io "https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp"
click node_filters_modes "https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp"
click node_register_tools "https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_arduino_app,node_can_base,node_spi_busio,node_mcp2515 toneIndigo
class node_controller_api toneMint
class node_driver_setup,node_can_io,node_filters_modes,node_register_tools toneTeal
```

## Components

### Other components

- **Arduino application**
- [Controller API](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.h): `src/Adafruit_MCP2515.h`
- [Chip setup](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp): `src/Adafruit_MCP2515.cpp`
- [CAN packet I/O](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp): `src/Adafruit_MCP2515.cpp`
- [Filters and modes](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp): `src/Adafruit_MCP2515.cpp`
- [Register tools](https://github.com/adafruit/adafruit_mcp2515/blob/main/src/Adafruit_MCP2515.cpp): `src/Adafruit_MCP2515.cpp`
- **CANControllerClass**
- **Adafruit SPI device**
- **MCP2515 chip**

## Connections

- Arduino application → Controller API: uses library (evidence: `README.md`)
- Controller API → Chip setup: declares API (evidence: `src/Adafruit_MCP2515.h`)
- Chip setup → CANControllerClass: initializes base (evidence: `src/Adafruit_MCP2515.cpp`)
- CAN packet I/O → CANControllerClass: delegates packet (evidence: `src/Adafruit_MCP2515.cpp`)
- Chip setup → Adafruit SPI device: starts SPI (evidence: `src/Adafruit_MCP2515.cpp`)
- CAN packet I/O → Adafruit SPI device: reads and writes (evidence: `src/Adafruit_MCP2515.cpp`)
- Filters and modes → Adafruit SPI device: accesses registers (evidence: `src/Adafruit_MCP2515.cpp`)
- Register tools → Adafruit SPI device: reads registers (evidence: `src/Adafruit_MCP2515.cpp`)
- Adafruit SPI device → MCP2515 chip: transfers SPI
