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

requires: MAX7219_DEBUG
group: 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

notes: Requires `MAX7219_DEBUG`.

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

examples:

---

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