# codeljo/aa_mcp2515 architecture

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

- Interactive diagram: https://gitdiagram.com/codeljo/aa_mcp2515
- Repository: https://github.com/codeljo/aa_mcp2515

## Overview

AA_MCP2515 is an Arduino library for configuring MCP2510/MCP2515 CAN controllers and sending and receiving CAN frames. The principal workflow is application code configuring bitrate and SPI/pins, initializing the controller, then transmitting frames or receiving them through polling or interrupt callbacks. The controller also provides operating modes, receive filters, and error status. The sampled implementation shows the controller delegating register transfers to a SPI adapter and interrupt routing to a dispatcher; README capabilities not visible in sampled internals are retained as documented API responsibilities.

Main entry points: [`src/CANController.cpp`](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANController.cpp) (CAN controller), [`src/CANIO.cpp`](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANIO.cpp) (SPI register I/O), [`src/CANConfig.h`](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANConfig.h) (Bus configuration), [`src/CANFrame.cpp`](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANFrame.cpp) (Frame codec)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Configuration"]
  node_bitrate["Bitrate presets<br/>[CANBitrate.h]"]
  node_config["Bus configuration<br/>[CANConfig.h]"]
end

subgraph group_can["CAN operations"]
  node_public_header["Library entry<br/>[AA_MCP2515.h]"]
  node_controller["CAN controller<br/>[CANController.cpp]"]
  node_frame["Frame codec<br/>[CANFrame.cpp]"]
  node_filters["Receive filters<br/>[CANController.cpp]"]
end

subgraph group_hardware["Hardware access"]
  node_spi_io["SPI register I/O<br/>[CANIO.cpp]"]
  node_registers["MCP registers<br/>[CANRegisters.h]"]
end

subgraph group_interrupts["Interrupt handling"]
  node_interrupt_dispatch["Interrupt dispatcher"]
end

node_application(("Arduino application"))
node_spi["Arduino SPI"]
node_can_device["MCP2510/2515"]

node_application -->|"includes"| node_public_header
node_application -->|"configures"| node_config
node_application -->|"initializes"| node_controller
node_bitrate -->|"supplies timing"| node_config
node_controller -->|"uses settings"| node_config
node_controller -->|"transfers registers"| node_spi_io
node_controller -->|"reads and writes"| node_frame
node_controller -->|"configures filters"| node_filters
node_controller -->|"registers handler"| node_interrupt_dispatch
node_frame -->|"encodes fields"| node_registers
node_spi_io -->|"uses commands"| node_registers
node_spi_io -->|"transfers bytes"| node_spi
node_spi_io -->|"accesses controller"| node_can_device
node_interrupt_dispatch -->|"dispatches interrupt"| node_controller
node_application -->|"polls or registers callbacks"| node_controller

click node_public_header "https://github.com/codeljo/aa_mcp2515/blob/main/src/AA_MCP2515.h"
click node_bitrate "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANBitrate.h"
click node_config "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANConfig.h"
click node_controller "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANController.cpp"
click node_frame "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANFrame.cpp"
click node_filters "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANController.cpp"
click node_spi_io "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANIO.cpp"
click node_registers "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANRegisters.h"
click node_interrupt_dispatch "https://github.com/codeljo/aa_mcp2515/blob/main/src/CANInterruptHandler.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_bitrate,node_config toneBlue
class node_public_header,node_controller,node_frame,node_filters toneAmber
class node_spi_io,node_registers toneMint
class node_interrupt_dispatch toneRose
class node_application,node_spi,node_can_device toneIndigo
```

## Components

### Configuration

- [Bitrate presets](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANBitrate.h): `src/CANBitrate.h`
- [Bus configuration](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANConfig.h): `src/CANConfig.h`

### CAN operations

- [Library entry](https://github.com/codeljo/aa_mcp2515/blob/main/src/AA_MCP2515.h): `src/AA_MCP2515.h`
- [CAN controller](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANController.cpp): `src/CANController.cpp`
- [Frame codec](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANFrame.cpp): `src/CANFrame.cpp`
- [Receive filters](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANController.cpp): `src/CANController.cpp`

### Hardware access

- [SPI register I/O](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANIO.cpp): `src/CANIO.cpp`
- [MCP registers](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANRegisters.h): `src/CANRegisters.h`

### Interrupt handling

- [Interrupt dispatcher](https://github.com/codeljo/aa_mcp2515/blob/main/src/CANInterruptHandler.cpp): `src/CANInterruptHandler.cpp`

### Other components

- **Arduino application**
- **Arduino SPI**
- **MCP2510/2515**

## Connections

- Arduino application → Library entry: includes (evidence: `README.md`)
- Arduino application → Bus configuration: configures (evidence: `README.md`)
- Arduino application → CAN controller: initializes (evidence: `README.md`)
- Bitrate presets → Bus configuration: supplies timing (evidence: `src/CANConfig.h`)
- CAN controller → Bus configuration: uses settings (evidence: `src/CANController.cpp`)
- CAN controller → SPI register I/O: transfers registers (evidence: `src/CANController.cpp`)
- CAN controller → Frame codec: reads and writes (evidence: `src/CANController.cpp`)
- CAN controller → Receive filters: configures filters (evidence: `src/CANController.cpp`)
- CAN controller → Interrupt dispatcher: registers handler (evidence: `src/CANController.cpp`)
- Frame codec → MCP registers: encodes fields (evidence: `src/CANFrame.cpp`)
- SPI register I/O → MCP registers: uses commands (evidence: `src/CANIO.cpp`)
- SPI register I/O → Arduino SPI: transfers bytes (evidence: `src/CANIO.cpp`)
- SPI register I/O → MCP2510/2515: accesses controller (evidence: `README.md`)
- Interrupt dispatcher → CAN controller: dispatches interrupt (evidence: `src/CANInterruptHandler.cpp`)
- Arduino application → CAN controller: polls or registers callbacks (evidence: `README.md`)
