M5StackでUnit Scroll を使う

Using the Unit Scroll ・ 使用 Unit Scroll

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

部品リスト（BOM）

配線

• AtomS3 → Unit Scroll (grove_i2c)

作り方

AtomS3とUnit ScrollをGrove I2Cケーブルで接続し、スクロールホイールの回転とボタン入力を読み取る最小構成のビルドです。

1. 部品を用意する — 必要なもの：AtomS3本体、Unit Scroll、Groveケーブル（4ピン、オス-オス）、AtomS3とパソコンをつなぐUSB-Cケーブル。
2. Groveケーブルで接続する — Unit ScrollはI2C通信（赤いPort.A）を使います。Groveケーブルの一端をUnit Scrollのポートに、もう一端をAtomS3の赤いPort.A（I2Cポート）に差し込みます。コネクタは一方向にしか入らないので、無理に押し込まないでください。
3. パソコンにつないでMicroPythonを書き込む — USB-CケーブルでAtomS3をパソコンにつなぎます。UIFlowやThonnyなどのツールで、AtomS3にMicroPythonファームウェアが入っていることを確認し、下のコードをデバイスにコピーして実行します。
4. 動作を確認する — コードを実行すると、スクロールホイールを回したときのカウント値と、ボタンを押したときの状態が画面に表示されます。ホイールを回すと数字が増減し、ボタンを押すと「Button pressed!」と表示されるはずです。

サンプルコード（micropython）

# M5Stack AtomS3 + Unit Scroll (I2C rotary encoder)
# Wiring: Unit Scroll -> AtomS3 red Port.A (I2C)
import time
from machine import Pin, I2C
from m5stack import lcd

# AtomS3 I2C pins for Port.A: SDA=G32, SCL=G33
i2c = I2C(0, scl=Pin(33), sda=Pin(32), freq=400000)

# Unit Scroll I2C address (default 0x41)
SCROLL_ADDR = 0x41

# Register addresses (from datasheet)
REG_ENCODER = 0x00  # 16-bit encoder value (read only)
REG_BUTTON = 0x10   # button state (read only, 0=pressed, 1=released)
REG_RGB = 0x20      # RGB LED color (3 bytes: R, G, B)

def read_encoder():
    data = i2c.readfrom_mem(SCROLL_ADDR, REG_ENCODER, 2)
    return (data[0] << 8) | data[1]

def read_button():
    data = i2c.readfrom_mem(SCROLL_ADDR, REG_BUTTON, 1)
    return data[0]

def set_rgb(r, g, b):
    i2c.writeto_mem(SCROLL_ADDR, REG_RGB, bytes([r, g, b]))

# Initialize RGB LED off
set_rgb(0, 0, 0)

prev_encoder = read_encoder()

while True:
    encoder_val = read_encoder()
    button_val = read_button()
    
    lcd.clear()
    lcd.print('Encoder: %d' % encoder_val, 10, 20)
    if button_val == 0:
        lcd.print('Button pressed!', 10, 50)
        set_rgb(0, 0, 255)  # blue when pressed
    else:
        lcd.print('Button released', 10, 50)
        set_rgb(0, 0, 0)    # off when released
    
    time.sleep(0.1)

コツ・安全上の注意

• 接続は必ず電源を切った状態で行ってください。通電中にケーブルを抜き差しすると、端子がショートして故障の原因になります。
• Unit ScrollのI2Cアドレスはデフォルトで0x41です。もし他のI2Cデバイスとアドレスが重複する場合は、ユニットの裏面のジャンパで変更できます。
• コードが動かない場合、まずI2Cデバイスが認識されているか確認してください。i2c.scan()でアドレス0x41が見つかるはずです。

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

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

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