M5StackでUnit Puzzle を使う

Using the Unit Puzzle ・使用 Unit Puzzle

M5StackのUnit Puzzleをコントローラーに接続する最小構成。配線とBOMつき。

部品リスト（BOM）

部品	役割	ポート	リンク・価格
AtomS3 Lite	Controller	grove_i2c, gpio, usb_c	official page — $7.5
Unit Puzzle	unit	grove_analog, grove	official page — $7.5

配線

AtomS3 Lite → Unit Puzzle (grove_analog)

作り方

AtomS3 LiteとUnit Puzzleで作る、カラフルな8x8 LEDマトリックス表示装置です。Unit Puzzleは64個のアドレス指定可能なRGB LEDを搭載しており、AtomS3 Liteから制御して様々な色やパターンを表示できます。Groveケーブル1本で簡単に接続でき、プログラミングでアニメーションも楽しめます。

部品を用意する — 用意するもの：AtomS3 Lite本体、Unit Puzzle、Groveケーブル（アナログ用、黒色）1本、AtomS3 LiteとパソコンをつなぐUSB-Cケーブル。
Groveケーブルで接続する — Unit Puzzleはアナログ（黒）接続です。Groveケーブルの一端をUnit PuzzleのGroveポートに、もう一端をAtomS3 LiteのPort.B（黒色ポート）に差し込みます。コネクタは一方向にしか入らないので、無理に押し込まないでください。
パソコンにつないでMicroPythonを書き込む — USB-CケーブルでAtomS3 Liteをパソコンにつなぎます。UIFlowやThonnyなどのツールで、AtomS3 LiteにMicroPythonファームウェアが入っていることを確認し、下のコードをデバイスにコピーして実行します。
LEDが光るかテストする — コードを実行すると、Unit PuzzleのLEDが虹色に順番に光ります。すべてのLEDが正しく光ることを確認してください。もし一部のLEDが光らない、または色がおかしい場合は、配線とコードのピン設定を再確認してください。
パターンを変更して遊ぶ — コード内のパターン生成部分を変更することで、好きな色やアニメーションを表示できます。例えば、すべてのLEDを同じ色にしたり、テキストを表示したりすることも可能です。

サンプルコード（micropython）

# M5Stack AtomS3 Lite + Unit Puzzle (8x8 RGB LED matrix)
# Wiring: Unit Puzzle -> AtomS3 Lite black Port.B (Grove analog, but used as digital output for NeoPixel)
# Note: AtomS3 Lite Port.B uses GPIO 1 for data (check your device, may vary)
import time
from machine import Pin
from neopixel import NeoPixel

# Define the NeoPixel pin (Port.B on AtomS3 Lite is typically GPIO 1)
# If your unit uses a different pin, change this.
PIN = 1
NUM_LEDS = 64  # 8x8 matrix

np = NeoPixel(Pin(PIN), NUM_LEDS)

def rainbow_cycle(wait):
    for j in range(255):
        for i in range(NUM_LEDS):
            pixel_index = (i * 256 // NUM_LEDS) + j
            np[i] = wheel(pixel_index & 255)
        np.write()
        time.sleep_ms(wait)

def wheel(pos):
    if pos < 85:
        return (pos * 3, 255 - pos * 3, 0)
    elif pos < 170:
        pos -= 85
        return (255 - pos * 3, 0, pos * 3)
    else:
        pos -= 170
        return (0, pos * 3, 255 - pos * 3)

# Main loop
while True:
    rainbow_cycle(10)

コツ・安全上の注意

安全：AtomS3 LiteとUnit Puzzleは低電圧（5V）で動作しますが、水や金属片の近くで使用しないでください。配線は必ず電源を切った状態で行ってください。
Unit Puzzleは最大約93mA（8%輝度時）を消費します。AtomS3 Liteのポートから供給できる電流を超えないように注意してください。明るさを上げすぎると電源が不安定になる可能性があります。
LEDが正しく光らない場合、まず配線を確認してください。特にGroveケーブルの向きや、Port.Bのピン番号がコードと合っているか確認してください。
コード内のPINの値は、お使いのAtomS3 LiteのPort.Bの実際のGPIO番号に合わせて変更してください。通常はGPIO 1ですが、個体差がある場合があります。

この作り方はAIが構成から生成したものです（未検証）。通電前に配線とコードをご確認ください。

この構成はAIが実在するM5Stack部品から設計し、ポート互換をサーバで検証したものです。編集・共有できます。

エディタで開く →

UnitKit は M5Stack® 製品向けの非公式ツール。作りたいものを書くと、部品リストと配線図が出ます。