Pythonのコマンド｜さっとつかむ

from intelino.trainlib import TrainScannerは、スマートトレイン本体を探す道具を使えるようにする行です。

with … as train:で見つかったスマートトレイン本体をtrainという名前で扱います。その下で字下げした行が、接続中に行う処理です。timeoutは探す時間の上限で、走る時間ではありません。

何台も電源が入っていると、最初に見つかった別のスマートトレイン本体につながることがあります。対象を限定するときはdevice_identifierにスマートトレイン本体のBluetooth/UUIDアドレスを指定します。

最初のうちはwithを使う例で十分です。複数台の作例では、get_trains(2)のように台数を指定してスマートトレイン本体をまとめて受け取ります。

受け取った複数台には、それぞれ停止と切断が必要です。複数台の動かし方は共通の「Pythonの作例」に、終了処理まで含めて載せています。

countを省略、または0にすると時間内に見つかったスマートトレイン本体を取得します。at_mostで上限だけ指定する方法もあります。

値を読むだけの項目には、命令を実行する()を付けません。printは画面に表示するPythonの命令です。

Trueなら接続中、Falseなら未接続です。ただし、その後も通信が続く保証ではありません。実行中にスマートトレイン本体の電源が切れれば接続は失われます。

この案内の通信ライブラリでは、切断後も接続中の値が残る場合があります。接続・再接続の細かな条件は技術リファレンスで確認してください。

withを使う例では、字下げした部分を抜けると自動でdisconnectが呼ばれます。初心者向けの例では自分で追加する必要はありません。

切断は走行停止と同じではありません。まずstop_drivingで停止を送り、そのあと切断します。切断済みのtrainへさらに命令を送らず、新しい接続を作ります。

30は1秒あたり30 cmという速さの指定です。「30 cmだけ進む」という距離の指定ではありません。

実際の目標速度は本体の刻みに合わせて調整される場合があります。sleep(3)と合わせても正確な90 cmの移動を保証するものではありません。

後進する場合は、ファイル先頭でfrom intelino.trainlib.enums import MovementDirectionを追加し、direction=MovementDirection.BACKWARDを指定します。

sleep(3)はPythonを3秒待たせるだけです。走り続けているスマートトレイン本体を止めるにはstop_driving()が必要です。

最初の例ではfinallyの中に置いています。途中で通常の例外やCtrl+Cが起きたときも停止を試みるためです。ただし通信が切れていれば停止命令を届けられません。

数値で速さを指定する代わりに、決められた段階で動かせます。drive_at_speedと使い方を区別します。

ファイル先頭にfrom intelino.trainlib.enums import SpeedLevelを追加します。段階の名前を文字列の引用符で囲む必要はありません。

ファイル先頭にfrom intelino.trainlib.enums import SteeringDecisionを追加します。次に通る分岐へ着く前に命令を送ります。

これはスマートトレイン本体を発進させる命令ではありません。分岐レールと、その進行方向から選べる道を確認してから走らせます。LEFTとRIGHTはスマートトレイン本体の進行方向から見た左右です。

切り離す位置を決め、貨車を正しい向きで連結して試します。この命令は、白・黄のスナップを置かずにPythonから切り離しを指示するものです。

切り離しだけで目的地まで運べるわけではありません。走る・止める処理と組み合わせて、切り離した後の動きも確かめます。

3つの数字は光の赤・緑・青の強さです。例えば(255, 0, 0)は赤、(0, 0, 255)は青です。

最初のコードのtryの中を、次の3行に替えて試せます。sleepの間に色を見て、最後の行で上のライトを消します。

frontとbackはそれぞれ3つの数字の組です。上のライトの命令とは別に、走行用の前後ライトを設定します。

set_headlight_color()は直前に指定した色を記憶して戻す機能ではなく、本体の標準の色へ戻す呼び出しです。

スナップの色を読んだときに本体が行う動作をオン・オフする設定です。Pythonのイベントを登録する命令とは別です。

Falseにしたままだと、スナップだけで遊ぶときの動きも変わります。試した後はTrueへ戻します。色の検出と、読み取った命令の実行を区別してください。

対応する本体のBLE APIが1.2未満では使えません。実行に失敗するときは、単なる入力ミスと決めつけず対応条件を確認します。

紫を含むスナップに、ゲームアプリで動きを登録していると、Pythonの処理と本体の動きが重なる場合があります。

この命令はその設定を消します。見ているだけの確認用命令ではありません。残したい設定がある場合は、消す必要があるかを先に考えます。

train.distance_cmのように書くと、本体から受け取っている値を読めます。数字を表示するだけならprintと組み合わせます。

読み取った値には通信や更新のタイミングがあります。目で見た位置と常に完全一致する測定値とは考えず、何度か試して比較します。

関数は、名前を付けてまとめた処理です。def on_color(train, event):の下に、色が変わったときに行うことを書きます。

listenerは、その変化を受け取る関数です。登録するときはon_colorと名前だけを書き、on_color()とはしません。すぐ実行するのではなく、変化したときに呼んでもらうためです。

下の完成例を別の.pyファイルへ保存して実行します。色スナップを通る線路を用意し、表示される色を確かめます。複数色の並びを受け取るイベントとは別です。

from time import sleep
from intelino.trainlib import TrainScanner


def on_color(train, event):
    print(event.color)


with TrainScanner(timeout=10.0) as train:
    train.add_front_color_change_listener(on_color)
    try:
        train.drive_at_speed(30)
        sleep(5)
    finally:
        train.stop_driving()
        train.remove_front_color_change_listener(on_color)

前側センサーの単色はcolor、スナップコマンドとして受け取った色の並びはcolorsです。末尾のsを見落とさないようにします。

「検出した」と「本体がその命令を実行した」も別の出来事です。add_snap_command_execution_listenerは実行側のイベントを受け取る命令です。

色の並びを使った完成コードは「スナップを合図にする」の作例で試せます。受け取る処理を登録した後、接続をすぐ終わらせないことも必要です。

次の分岐を選ぶset_next_split_steering_decisionと違い、こちらは分岐の判断が起きたことを受け取ります。

イベントを受け取る関数は、同期版でも別のスレッドで動きます。複数台で同じ変数や区間を扱う処理では、順番の衝突を考慮する必要があります。完成作例の終了処理と合わせて確認してください。