---
tag: m7219
title: MAX7219 Control
brief: Control Max7219 Segmented LEDs
author: thinkyhead

group: debug
requires: MAX7219_DEBUG

codes: [ M7219 ]

images:
- title: Max7219 with 8x8 Matrix
  caption: This single-unit Max7219 with 8x8 Matrix is commonly found online in both assembled and kit form for only a few dollars.
  path: max7219-board.png

- title: Settings for Max7219 Orientation
  caption: Use the `MAX7219_ROTATE` and `MAX7219_SIDE_BY_SIDE` settings that best suit the orientation of your matrix according to this chart.
  path: max7219-rotation.svg

parameters:

- tag: C
  optional: true
  description: Set the column specified by `C` to bit pattern `V`.
  values:
  - tag: column
    type: int

- tag: D
  optional: true
  description: Directly set a Max7219 native row (on the unit specified by `U`) to the 8-bit pattern `V`.
  values:
  - tag: row
    type: int

- tag: R
  optional: true
  description: Set the row specified by `R` to bit pattern `V`.
  values:
  - tag: row
    type: int

- tag: I
  optional: true
  description: Initialize (clear) all matrixes.

- tag: F
  optional: true
  description: Fill the matrix by turning on all LEDs.

- tag: P
  optional: true
  description: Print the LED array state for debugging.

- tag: U
  optional: true
  description: Used with `D` to specify which matrix unit to set.
  values:
  - tag: index
    type: int

- tag: V
  optional: true
  description: Value to apply when using the `C`, `R`, or `X`/`Y` parameters.
  values:
  - tag: bits
    type: long

- tag: X
  optional: true
  description: Set a matrix LED at the given `X` position to the `V` value. If no `V` is given, toggle the LED state.
  values:
  - tag: index
    type: int

- tag: Y
  optional: true
  description: Set a matrix LED at the given `Y` position to the `V` value. If no `V` is given, toggle the LED state.
  values:
  - tag: index
    type: int

videos:
- JXMEKXsmTpA

---

Set the state of one or more Max7219 matrix displays or 7-segment digital displays.
