デュプロ列車

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 -- ハブが接続されていない場合に発生します。