デュプロ列車
-
class DuploTrain(name=None, timeout=10000, connect=True)
LEGO® デュプロ列車ハブ(セット 10874, 10875, 10427, 10428 など)。
デュプロハブは更新できないため、Pybricks をインストールできません。ただし、Pybricks が動作する対応ハブをデュプロハブに接続すれば、列車を制御できます。
モーター、サウンド、ヘッドライトを制御したり、速度センサーやカラーセンサーの値を読み取ったりできます。
- パラメータ:
name (str) -- ハブの Bluetooth 名。名前が与えられていない場合、ハブは最初に見つかったデュプロ列車ハブに接続します。
timeout (Number, ms) -- ハブを検索する時間。無期限に待機するには None を指定します。
connect (bool) -- 接続をスキップするには False を指定します。後で connect() を呼び出すことで接続できます。
- 例外:
OSError -- 接続に失敗またはタイムアウトした場合に発生します。
-
awaitconnect()
デバイスに接続します。切断した場合、または connect=False で初期化した場合にのみ必要です。
- 例外:
OSError -- 接続に失敗またはタイムアウトした場合に発生します。
-
awaitdisconnect()
デバイスを切断します。
- 例外:
OSError -- 切断に失敗した場合に発生します。
-
name(name)
-
name() → str
デバイスの Bluetooth 名を設定または取得します。
- パラメータ:
name (str) -- デバイスの新しい Bluetooth 名。名前を指定しない場合、このメソッドは現在の名前を返します。
- 例外:
OSError -- デバイスが接続されていない場合に発生します。
-
awaitdrive(speed)
指定の速度で列車のモーターを駆動します。
- パラメータ:
speed (int) -- 速度をパーセンテージ(-100~100)で表したもの。負の値は後退を意味します。
- 例外:
OSError -- ハブが接続されていない場合に発生します。
-
awaitheadlights(color)
列車のヘッドライトの色を設定します。すべての色がサポートされているわけではないため、ハブは生成可能な最も近い色を選択します。
- パラメータ:
color (Color) -- ヘッドライトの色。
- 例外:
OSError -- ハブが接続されていない場合に発生します。
-
awaitsound(sound)
内蔵の列車の音の1つを再生します。
新しい(濃い青色の)列車については、まだ適切なサウンドコードが特定できていません。もしご存知でしたら、ディスカッションまたはプルリクエストを作成してください。よろしくお願いします。
- パラメータ:
sound (str) -- 再生する音の名前。"brake", "depart", "water", "horn", "steam" から選択してください。
- 例外:
OSError -- ハブが接続されていない場合に発生します。
-
speed() → int: %
最新の受信通知から列車の速度を読み取ります。
- 戻り値:
速度をパーセンテージで表したもの(-100~100)。
- 例外:
OSError -- ハブが接続されていない場合に発生します。
-
color() → Color
受信した最新の通知からカラーセンサーが検出した色を読み取ります。
- 戻り値:
検出した色。
- 例外:
OSError -- ハブが接続されていない場合に発生します。