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.js と同じく AkaDako のメンバーとしても参照できます。from akadako import AkaDako だけで一通り使えます（個別に from akadako import ServoWrite, Color のように import することも可能）。

from akadako import AkaDako

board = AkaDako.connect()
board.run_servo_turn(AkaDako.ServoWrite.A1, 50, 90)
board.run_color_led_fill_color(AkaDako.ColorLed.A1, AkaDako.Color.RED)

利用できるメンバー: DigitalRead / DigitalReadPin / DigitalWrite / AnalogRead / ServoWrite / PwmWrite / ColorLed / IrRemoteWrite / PinBias / Color / Rainbow、および各種エラー（NotSupportedError など）。

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

ライセンス

MIT License