akadako 0.2.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 を使用します（依存に含まれます）。

クイックスタート

akadako.js が async/await 中心であるのと同様に、本ライブラリも asyncio を中心に設計されています。

import asyncio
from akadako import AkaDako

async def main():
    board = await AkaDako.connect()          # 接続待ち
    board.on_disconnected(lambda: print("切断されました"))
    try:
        while board.is_connected:
            print("温度:", await board.fetch_temperature())
            print("明るさ:", await board.fetch_brightness())
            await asyncio.sleep(0.1)          # 負荷軽減
    finally:
        board.disconnect()

asyncio.run(main())

JavaScript との対応

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

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

ライセンス

MIT License