{"type":"doc","content":[{"type":"paragraph","content":[{"text":"MQTTを利用してThingScaleのビルトインMQTTブローカにpublish/subscribeする方法を解説します。","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"panel","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e0cc2c6e-00e6-4bab-b2c7-a61befaf4c2f"},"schemaVersion":{"value":"1"},"title":"Panel"}},"localId":"cf82b84c-3401-4870-9342-ee60461aa643"},"content":[{"type":"paragraph","content":[{"text":"On this page:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b5f08302-b9ad-4c39-9564-0c3783debe78"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"61470a59-d5e9-4027-a71d-db6372f36fe9"}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"パブリッシュ/サブスクライブ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"MQTT Endpoint","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[302.0]},"content":[{"type":"paragraph","content":[{"text":"Protocol","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[457.0]},"content":[{"type":"paragraph","content":[{"text":"Address:Port","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[302.0]},"content":[{"type":"paragraph","content":[{"text":"MQTT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[457.0]},"content":[{"type":"paragraph","content":[{"text":"mqtt://m.thingscale.io:1883","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[302.0]},"content":[{"type":"paragraph","content":[{"text":"MQTTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[457.0]},"content":[{"type":"paragraph","content":[{"text":"mqtts://m.thingscale.io:8883","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[302.0]},"content":[{"type":"paragraph","content":[{"text":"Websocket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[457.0]},"content":[{"type":"paragraph","content":[{"text":"ws://m.thingscale.io:8083","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[302.0]},"content":[{"type":"paragraph","content":[{"text":"Secure Websocket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[457.0]},"content":[{"type":"paragraph","content":[{"text":"wss://m.thingscale.io:8084","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Version: 3.1 and 3.1.1","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"QoS0(最低1回) and QoS1(少なくとも1回) and QoS2(正確に1回)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wills:Yes","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Retained Message:Yes","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clean sesson/Durable connections:Yes","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"制限:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Publish APIはQoS2をサポートしません。","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"MQTT Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"クライアントIDは1~23文字の文字列です。以下の形式を推奨します。 _","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Username:ThingScale_ID(U******)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Password:DEVICE_TOKEN","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"MQTT Topic","type":"text"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[160.0]},"content":[{"type":"paragraph","content":[{"text":"Pub/Sub","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[965.0]},"content":[{"type":"paragraph","content":[{"text":"Topic","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Payload","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[160.0]},"content":[{"type":"paragraph","content":[{"text":"Publish","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[965.0]},"content":[{"type":"paragraph","content":[{"text":"DEVICE_TOKEN/json/DEVICE_ID/[","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"TAG_NAME","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":"]","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"(NOTE)","type":"text"},{"text":"TAG_NAME","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":" はオプションです。","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"JSON or Numeric","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[160.0]},"content":[{"type":"paragraph","content":[{"text":"Publish(binary_mode)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[965.0]},"content":[{"type":"paragraph","content":[{"text":"DEVICE_TOKEN/binary/DEVICE_ID/[","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"TAG_NAME","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":"]","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"(NOTE)","type":"text"},{"text":"TAG_NAME","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":" はオプションです。","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Binary(raw stream)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[160.0]},"content":[{"type":"paragraph","content":[{"text":"Subscribe","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[965.0]},"content":[{"type":"paragraph","content":[{"text":"DEVICE_TOKEN/DEVICE_ID/subscribe","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"JSON","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"トピックについて","type":"text"}]},{"type":"paragraph","content":[{"text":"Publish時にトピックに含まれるデバイストークンが不正な場合はThingScaleはpublishされたデータの受け取りを拒否します。","type":"text"}]},{"type":"paragraph","content":[{"text":"トピックが正しく、デバイスID(DEVICE_ID)がデバイスレジストリに存在しない場合に、ThingScale は新規デバイスとしてレジストリに登録します。（オートプロビジョニング）","type":"text"}]},{"type":"paragraph","content":[{"text":"Subscribe時は/#のトピックの購読だけが許可されます。ThingScaleからデバイスに対してコマンドを発行するには、デバイス側で//subscribeトピックをsubscribeする事でPublish Service(参照:","type":"text"},{"text":"Publish service一覧","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Publish service一覧","versionAtSave":"35"},"href":"/wiki/spaces/TD/pages/8454180"}}]},{"text":")から送信されたペイロードを受け取る事が可能です。","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"ペイロードについて","type":"text"}]},{"type":"paragraph","content":[{"text":"バイナリデータを取り扱う場合は、バイナリメッセージ用のトピックを指定してMQTTペイロードにはバイナリデータをそのまま格納してください。","type":"text"}]},{"type":"paragraph","content":[{"text":"バイナリメッセージはvalue1のペイロードとして、16進ダンプ文字列の形式に変換されStream APIから参照可能です。","type":"text"}]},{"type":"paragraph","content":[{"text":"バイナリメッセージのシリアライズはMessagePack(","type":"text"},{"text":"http://msgpack.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://msgpack.org"}}]},{"text":")形式で格納する事を推奨します。","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"NOTE","type":"text"}]},{"type":"paragraph","content":[{"text":"デバイスからpublishしたストリームが正しくハンドルされたか（デバイストークン認証の不一致etc）の確認メカニズムはMQTTにありません。","type":"text"}]},{"type":"paragraph","content":[{"text":"その他の詳しいMQTT関連の仕様については、","type":"text"},{"text":"MQTT V3.1 Protocol Specification","type":"text","marks":[{"type":"link","attrs":{"href":"http://public.dhe.ibm.com/software/dw/webservices/ws-mqtt/mqtt-v3r1.html"}}]},{"text":"を参照してください。","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"チュートリアル","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"パブリッシュ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ThingScaleにデータをパブリッシュする","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"mosquitto_pub -h m.thingscale.io -t '/json/' -m '{\"temp\":20, \"humidity\":50}' -d -u -P ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ThingScaleにMQTTS(MQTT over TLS)でデータをパブリッシュする","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"mosquitto_pub -h m.thingscale.io -p 8883 -t '/json/' -m \"25.6\" --cafile /etc/pki/tls/certs/ca-bundle.crt -d -u -P ","type":"text"}]},{"type":"paragraph","content":[{"text":"上記ケースでは、root証明書はCentOSの標準root証明書バンドルを指定しています。","type":"text","marks":[{"type":"textColor","attrs":{"color":"#737373"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"サブスクライブ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Publish Serviceからデバイスに送信されたコマンドを受け取る","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"mosquitto_sub -h m.thingscale.io -t '//subscribe' -u -P ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported