M5StackでUnit ByteButton を使う

Using the Unit ByteButton ・ 使用 Unit ByteButton

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

部品リスト（BOM）

配線

• AtomS3 Lite → Unit ByteButton (grove_i2c)

作り方

AtomS3 LiteとUnit ByteButtonをGrove I2Cケーブルで接続する、最小構成のボタン入力装置です。8つのタクトスイッチと9つのRGB LEDを備えたByteButtonを、AtomS3 LiteからI2Cで制御します。

1. 部品を用意する — 用意するもの：AtomS3 Lite本体、Unit ByteButton、Groveケーブル（4ピン、I2C用）、AtomS3 LiteとパソコンをつなぐUSB Type-Cケーブル。
2. Groveケーブルで接続する — Unit ByteButtonはI2C接続です。Groveケーブルの一端をByteButtonのGroveポートに、もう一端をAtomS3 LiteのGroveポート（Port.A、赤色）に差し込みます。コネクタは一方向にしか入らないので、無理に押し込まないでください。
3. パソコンにつなぐ — USB Type-CケーブルでAtomS3 Liteをパソコンにつなぎます。AtomS3 Liteの電源が入り、内蔵LEDが点灯します。
4. MicroPythonコードを書き込む — UIFlowまたはThonnyなどのツールで、AtomS3 LiteにMicroPythonファームウェアが入っていることを確認し、下のコードをデバイスにコピーして実行します。
5. 動作を確認する — コードを実行すると、ByteButtonの各ボタンを押したときに、AtomS3 Liteのシリアルモニタにボタン番号が表示されます。また、押したボタンに対応するLEDが光ります。

サンプルコード（micropython）

# M5Stack AtomS3 Lite + Unit ByteButton
# Wiring: ByteButton -> AtomS3 Lite Grove Port (Port.A, I2C)
# I2C address of ByteButton: 0x62
import time
from machine import Pin, I2C

# Initialize I2C on AtomS3 Lite (Grove port: SDA=GPIO1, SCL=GPIO2)
i2c = I2C(0, scl=Pin(2), sda=Pin(1), freq=100000)

# ByteButton I2C address
ADDR = 0x62

# Register addresses (from datasheet)
REG_BUTTON = 0x00  # read button states (8 bits)
REG_LED = 0x10     # write LED states (9 bits, but we use first 8)

def read_buttons():
    data = i2c.readfrom(ADDR, 1)
    return data[0]

def set_leds(led_mask):
    # led_mask: 8-bit mask, bit0 = LED0 (button0), etc.
    i2c.writeto(ADDR, bytes([REG_LED, led_mask]))

# Turn off all LEDs initially
set_leds(0x00)

while True:
    buttons = read_buttons()
    # buttons: bit0 = button0 pressed (active low? check datasheet)
    # Assuming active low: 0 = pressed
    pressed = (~buttons) & 0xFF
    if pressed:
        # Light up the pressed button's LED
        set_leds(pressed)
        # Print pressed buttons
        for i in range(8):
            if pressed & (1 << i):
                print('Button %d pressed' % i)
    else:
        # No button pressed, turn off LEDs
        set_leds(0x00)
    time.sleep(0.05)

コツ・安全上の注意

• 安全：AtomS3 LiteとByteButtonは低電圧（5V/3.3V）で動作しますが、水や金属片がかからないように注意してください。接続は必ず電源を切った状態で行ってください。
• I2Cアドレスは0x62固定です。複数のByteButtonをカスケード接続する場合、各ユニットのアドレス設定が必要です（本ガイドでは1台のみ）。
• ボタンの読み取りはアクティブロー（押すと0）です。コード内のコメントを参照し、必要に応じて反転してください。
• LEDの点灯パターンを変更したい場合は、set_leds()に渡すビットマスクを変更してください。

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

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

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