How to Use MCP3008 SPI ADC with Raspberry Pi: Simple Guide

To use the MCP3008 SPI ADC with a Raspberry Pi, connect the MCP3008 pins to the Pi's SPI pins and enable SPI interface on the Pi. Then, use Python's spidev library to communicate and read analog values from the MCP3008 channels.

Syntax

The basic steps to use MCP3008 with Raspberry Pi are:

• Import the spidev library to handle SPI communication.
• Open SPI bus and device (usually bus 0, device 0).
• Send a 3-byte command to MCP3008 to select the channel and start conversion.
• Receive 3 bytes back containing the 10-bit analog value.
• Process the received bytes to get the ADC reading.

python

import spidev

spi = spidev.SpiDev()
spi.open(0, 0)  # Open SPI bus 0, device 0
spi.max_speed_hz = 1350000

def read_channel(channel):
    # MCP3008 expects 3 bytes: start bit, single/diff bit + channel bits, and a dummy byte
    cmd = 0b11 << 6 | (channel & 0x07) << 3
    resp = spi.xfer2([1, cmd, 0])
    # Combine response bytes to get 10-bit result
    result = ((resp[1] & 0x03) << 8) | resp[2]
    return result

# Example: read channel 0
value = read_channel(0)
print(value)

Example

This example shows how to read analog input from channel 0 of MCP3008 and print the value continuously every second.

python

import spidev
import time

spi = spidev.SpiDev()
spi.open(0, 0)  # SPI bus 0, device 0
spi.max_speed_hz = 1350000

def read_channel(channel):
    cmd = 0b11 << 6 | (channel & 0x07) << 3
    resp = spi.xfer2([1, cmd, 0])
    result = ((resp[1] & 0x03) << 8) | resp[2]
    return result

try:
    while True:
        analog_value = read_channel(0)
        print(f"Analog value from channel 0: {analog_value}")
        time.sleep(1)
except KeyboardInterrupt:
    spi.close()

Output

Analog value from channel 0: 512
Analog value from channel 0: 513
Analog value from channel 0: 510
... (updates every second)

Common Pitfalls

• SPI not enabled: The Raspberry Pi SPI interface must be enabled via raspi-config or device tree overlays.
• Incorrect wiring: Ensure MCP3008 pins (MOSI, MISO, CLK, CS) connect correctly to Pi SPI pins.
• Wrong SPI bus/device: Usually bus 0, device 0 is used; verify with ls /dev/spidev*.
• Not closing SPI: Always close SPI connection to free resources.
• Channel number out of range: MCP3008 has 8 channels (0-7); using invalid channel causes errors.

python

## Wrong way: Not enabling SPI or wrong channel
# spi.open(0, 1)  # Device 1 may not exist
# value = read_channel(8)  # Invalid channel

## Right way:
spi.open(0, 0)  # Correct device
value = read_channel(0)  # Valid channel

Quick Reference

Summary tips for using MCP3008 with Raspberry Pi:

• Enable SPI interface on Raspberry Pi before running code.
• Use spidev Python library for SPI communication.
• Connect MCP3008 pins: VDD to 3.3V, VREF to 3.3V, AGND and DGND to ground, CLK to SCLK, DOUT to MISO, DIN to MOSI, CS/SHDN to CE0.
• Read analog values by sending 3-byte commands and processing response.
• Close SPI connection when done.

Key Takeaways

Enable SPI on Raspberry Pi before using MCP3008.

Use Python spidev library to communicate via SPI bus 0, device 0.

Send correct 3-byte commands to read 10-bit analog values from MCP3008 channels.

Check wiring carefully to match MCP3008 and Raspberry Pi SPI pins.

Always close the SPI connection after use to avoid resource issues.