# sanandapatel/ads1220_adc architecture

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

- Interactive diagram: https://gitdiagram.com/sanandapatel/ads1220_adc
- Repository: https://github.com/sanandapatel/ads1220_adc

## Overview

This is Pico firmware for polling a TI ADS1220 and streaming alternating-channel raw samples over UART. At startup, `main.c` configures MCU peripherals and initializes the ADC; its loop waits for DRDY, reads a 24-bit result, switches the MUX, then sends a packet. The README also describes a downstream Arduino/PC receiver. Only `polling_adc/main.c` was sampled: its packet uses A5 5A and has no checksum, differing from the README’s packet-format description.

Main entry points: [`polling_adc/main.c`](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c) (Main Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Firmware Control"]
  node_firmware["Main Loop<br/>[main.c]"]
  node_mcu_io["MCU I/O Setup<br/>[main.c]"]
end

subgraph group_acquisition["ADC Acquisition"]
  node_adc_init["ADS1220 Setup<br/>[main.c]"]
  node_drdy["DRDY Polling<br/>[main.c]"]
  node_sample_read["Raw Sample Read<br/>[main.c]"]
  node_mux["MUX Switching<br/>[main.c]"]
end

subgraph group_streaming["Data Streaming"]
  node_packet["Packet Assembly<br/>[main.c]"]
  node_uart_tx["UART Output<br/>[main.c]"]
end

node_power(("Power On"))
node_ads1220["ADS1220 ADC"]
node_receiver(("Serial Receiver"))

node_power -->|"starts"| node_firmware
node_firmware -->|"configures"| node_mcu_io
node_firmware -->|"calls"| node_adc_init
node_adc_init -->|"configures via SPI"| node_ads1220
node_firmware -->|"polls"| node_drdy
node_drdy -->|"checks ready pin"| node_ads1220
node_firmware -->|"reads after ready"| node_sample_read
node_sample_read -->|"reads via SPI"| node_ads1220
node_firmware -->|"advances channel"| node_mux
node_mux -->|"writes register via SPI"| node_ads1220
node_firmware -->|"assembles sample"| node_packet
node_firmware -->|"writes packet"| node_uart_tx
node_uart_tx -->|"streams bytes"| node_receiver

click node_firmware "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_mcu_io "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_adc_init "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_drdy "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_sample_read "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_mux "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_packet "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"
click node_uart_tx "https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c"

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_firmware,node_mcu_io toneBlue
class node_adc_init,node_drdy,node_sample_read,node_mux toneAmber
class node_packet,node_uart_tx toneMint
class node_power,node_ads1220,node_receiver toneIndigo
```

## Components

### Firmware Control

- [Main Loop](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`
- [MCU I/O Setup](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`

### ADC Acquisition

- [ADS1220 Setup](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`
- [DRDY Polling](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`
- [Raw Sample Read](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`
- [MUX Switching](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`

### Data Streaming

- [Packet Assembly](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`
- [UART Output](https://github.com/sanandapatel/ads1220_adc/blob/main/polling_adc/main.c): `polling_adc/main.c`

### Other components

- **Power On**
- **ADS1220 ADC**
- **Serial Receiver**

## Connections

- Power On → Main Loop: starts (evidence: `README.md`)
- Main Loop → MCU I/O Setup: configures (evidence: `polling_adc/main.c`)
- Main Loop → ADS1220 Setup: calls (evidence: `polling_adc/main.c`)
- ADS1220 Setup → ADS1220 ADC: configures via SPI (evidence: `polling_adc/main.c`)
- Main Loop → DRDY Polling: polls (evidence: `polling_adc/main.c`)
- DRDY Polling → ADS1220 ADC: checks ready pin (evidence: `polling_adc/main.c`)
- Main Loop → Raw Sample Read: reads after ready (evidence: `polling_adc/main.c`)
- Raw Sample Read → ADS1220 ADC: reads via SPI (evidence: `polling_adc/main.c`)
- Main Loop → MUX Switching: advances channel (evidence: `polling_adc/main.c`)
- MUX Switching → ADS1220 ADC: writes register via SPI (evidence: `polling_adc/main.c`)
- Main Loop → Packet Assembly: assembles sample (evidence: `polling_adc/main.c`)
- Main Loop → UART Output: writes packet (evidence: `polling_adc/main.c`)
- UART Output → Serial Receiver: streams bytes (evidence: `README.md`)
