akadako 0.3.0

Python library for the AkaDako board (TFabWorks)

akadako (Python)

フィジカルコンピューティングデバイス AkaDako（TFabWorks）を Python から制御するためのライブラリです。 公式 JavaScript ライブラリ akadako.js と同じ API 設計を Python に移植しています。

• 📖 マニュアル: https://tfabworks.github.io/akadako-python/
• AkaDako ボードとは MIDI 上の Firmata プロトコルで通信します。

インストール

pip install akadako

ネットワーク通信（共有サーバ）機能も使う場合:

pip install "akadako[share]"

ボードとの接続には python-rtmidi を使用します（依存に含まれます）。

クイックスタート

本ライブラリは同期（ブロッキング）API です。akadako.js は async/await 中心ですが、これはブラウザにブロッキング I/O が無いための制約で、Python ではその必要がありません。gpiozero などの Python フィジカルコンピューティング系ライブラリと同じく、await 無しでそのまま呼び出せます。

import time
from akadako import AkaDako

board = AkaDako.connect()                 # 接続（ブロッキング）
board.on_disconnected(lambda: print("切断されました"))
try:
    while board.is_connected:
        print("温度:", board.fetch_temperature())
        print("明るさ:", board.fetch_brightness())
        time.sleep(0.1)                   # 負荷軽減
finally:
    board.disconnect()

JavaScript との対応

akadako.js の camelCase メソッドは Python では snake_case になります（例: fetchTemperature() → fetch_temperature()、runServoTurn() → run_servo_turn()）。 列挙やクラスは同名です（AkaDako.Color → akadako.Color、AkaDako.DigitalRead → akadako.DigitalRead など）。

詳細はマニュアルを参照してください。

ライセンス

MIT License