echolot mqtt

echolot mqtt は、ターミナルからMQTTブローカーと通信します：subscribe は届いたメッセージを出力し、publish はメッセージを送信します。 どちらもデフォルトではMQTT 5.0を使い、指定すれば3.1.1を使います。接続はTCP（mqtt://）、TLS（mqtts://）、WebSocket（ws://、wss://）のいずれかです。 アプリでの同じ操作については、MQTTリクエストを参照してください。

例では、Alpenglowのリクエスト Warehouse sensors と同じように、Mac上の localhost にあるブローカーを使います。デモAPIはMQTTを動かせません。

echolot mqtt subscribeCopy Anchor Link

echolot mqtt subscribe [<options>] <broker> <filters> ...

<broker> は mqtt://host[:1883]、mqtts://host[:8883]、ws://host/mqtt、wss://host/mqtt のいずれかです。<filters> は1つ以上のトピックフィルターで、 + は1階層に、# は残りすべてに一致します。

echolot mqtt subscribe mqtt://localhost 'warehouses/+/temperature' --qos 1

warehouses/bern/temperature 4.5
warehouses/zurich/temperature 5.1

各メッセージは、標準出力に1行で出力されます：トピック、スペース、ペイロードの順です。UTF-8のテキストでないペイロードは、Base64で出力されます。--json を指定すると、 各メッセージは topic、payload（または payload_base64）、qos、retain を持つJSON行になり、そのまま jq に渡せます。

echolot mqtt subscribe mqtt://localhost 'warehouses/#' --count 10 --json | jq -r .payload

サブスクリプションは、あなたが停止する（⌃C）、ブローカーが切断する、--listen で指定した秒数が経過する、または --count で指定した数のメッセージが届くまで続きます。 ブローカーが拒否したフィルターは、標準エラーに表示されます。

echolot mqtt publishCopy Anchor Link

echolot mqtt publish [<options>] <broker> <topic>

-m でペイロードを指定します。指定しない場合は、標準入力の各行が1つのメッセージになります。

echolot mqtt publish mqtt://localhost warehouses/bern/temperature -m '4.5' --qos 1
tail -f readings.log | echolot mqtt publish mqtt://localhost warehouses/bern/log

QoS 1または2では、Echolotはブローカーがすべてのメッセージを確認応答するまで待ち、拒否されたメッセージがあればそれを表示します。QoS 0では、パブリッシュした数を表示します。

両方に共通のオプションCopy Anchor Link

ここでの -i は --insecure を意味し、echolot send のような「include」ではありません。

export ECHOLOT_MQTT_PASSWORD='…'
echolot mqtt publish mqtts://broker.example.com:8883 status/door -m open --retain -u heidi

終了コードCopy Anchor Link