Skip to content

JT/T 808 ゲートウェイ ​

EMQX 5.4 には、中国で広く使用されている車両端末通信プロトコルである JT/T 808 プロトコルが含まれており、車両と監視センター間のデータ通信に利用されます。EMQX の JT/T 808 ゲートウェイは、JT/T 808 クライアントからの接続を受け入れ、そのイベントやメッセージを MQTT パブリッシュメッセージに変換します。

現在の実装には以下の制限があります:

  • TCP 伝送に基づいています。
  • JT/T 808 2011、2013、および 2019 のみをサポートし、JT/T 808 2021 はまだサポートしていません。
  • 端末の登録および登録解除メッセージを SMS 経由で送信できません。
  • EMQX の組み込み認証システムは使用できず、端末登録/アクセス認証のための HTTP サービスアドレスの設定が必要です。

JT/T 808 ゲートウェイの有効化 ​

JT/T 808 ゲートウェイは、ダッシュボード、REST API、または base.hocon 設定ファイルを通じて有効化および設定できます。

ダッシュボードでのゲートウェイ有効化 ​

このセクションでは、ダッシュボードを使って JT/T 808 ゲートウェイを有効化する方法を説明します。

EMQX ダッシュボードの左ナビゲーションバーで Management -> Gateway をクリックします。Gateway ページにはサポートされているすべてのゲートウェイが一覧表示されます。JT/T 808 を見つけ、Action 列の Configure ボタンをクリックすると、Initialize JT/T 808 ページに入ります。

TIP

EMQX がクラスターで稼働している場合、ダッシュボードや REST API での設定はクラスター全体に反映されます。単一ノードのみ設定したい場合は、base.hocon でゲートウェイを設定してください。

設定を簡略化するために、EMQX は Gateway ページのすべての必須フィールドにデフォルト値を提供しています。カスタム設定が不要な場合は、以下の3ステップで JT/T 808 ゲートウェイを有効化できます:

  1. Basic Parameters ステップページでデフォルト設定をすべて受け入れ、Next をクリックします。
  2. 次に表示される Listeners ステップページでは、EMQX がポート 6207 で TCP リスナーを事前設定しています。設定を確認して再度 Next をクリックします。
  3. Enable ボタンをクリックして JT/T 808 ゲートウェイを有効化します。

ゲートウェイの有効化が完了すると、Gateway ページに戻り、JT/T 808 ゲートウェイのステータスが Enabled になっていることが確認できます。

jt808-enabled

REST API または設定ファイルでのゲートウェイ有効化 ​

JT/T 808 ゲートウェイは REST API または設定ファイルを通じても有効化および設定できます:

TIP

EMQX がクラスターで稼働している場合、ダッシュボードや REST API での設定はクラスター全体に反映されます。単一ノードのみ設定したい場合は、base.hocon でゲートウェイを設定してください。

JT/T 808 ゲートウェイは TCP タイプリスナーのみをサポートしています。設定可能なパラメータの完全な一覧については、Gateway Configuration - Listeners を参照してください。

JT/T 808 ゲートウェイのカスタマイズ ​

デフォルト設定に加え、EMQX はさまざまな設定オプションを提供しており、特定のビジネス要件に合わせて柔軟に対応できます。このセクションでは、Gateways ページで利用可能な設定オプションを詳しく解説します。

基本設定 ​

Gateways ページで JT/T 808 を見つけ、Actions 列の Settings をクリックします。Settings パネルで JT/T 808 ゲートウェイをカスタマイズできます。

jt808-settings

  • MountPoint:パブリッシュやサブスクライブ時にすべてのトピックの前に付加される文字列を設定します。これにより、異なるプロトコル間でのメッセージルーティングの分離を実現できます。例:jt808/${clientid}/。このトピックプレフィックスはゲートウェイが管理し、クライアントはパブリッシュやサブスクライブ時に明示的に追加する必要はありません。
  • Max Length of Frame:ゲートウェイが処理可能なフレームの最大サイズ(バイト単位)。デフォルトは 8192 バイトです。EMQX 6.0.5 以降では、この制限を超えるフレームを受信すると、Ignore Unsupported Frames 設定に関わらずフレームを拒否し、クライアントとの接続を切断します。
  • Parse Unknown Message IDs:標準プロトコルに定義されていないメッセージIDを解析するかどうか。
    • true に設定すると、未知のメッセージIDを持つメッセージを処理し、そのペイロードを Base64 エンコードして転送します。デフォルトは true です。
    • false に設定すると、メッセージを無視するか、Ignore Unsupported Frames の設定に応じてクライアントを切断します。
  • String Encoding:端末から報告される文字列の解析および端末への文字列のパッケージング・配信時に使用する文字エンコーディングを指定します。
    • utf8 に設定すると、UTF-8 エンコーディングで文字列を解析します。デフォルトは UTF-8 です。
    • gbk に設定すると、GBK エンコーディングで文字列を解析し、EMQX にパブリッシュする前に UTF-8 に変換します。
  • Retry Interval:メッセージ配信失敗時の再試行間隔。デフォルトは 8s です。
  • Max Retry Times:メッセージ配信の最大再試行回数。超過すると配信できなかったメッセージは破棄されます。デフォルトは 3 です。
  • Max message queue length:ダウンロードストリームメッセージ配信の最大メッセージキュー長。デフォルトは 100 です。
  • Idle Timeout:接続中のクライアントが非アクティブとみなされ、切断されるまでの秒数。デフォルトは 30 秒です。
  • Enable Statistics:ゲートウェイが統計情報を収集・報告するかどうか。デフォルトは true、選択肢は true または false です。
  • Registry:JT/T 808 端末のレジストリセンター。allow_anonymous が false の場合は必須です。ゲートウェイが JT/T 808 登録メッセージを受信すると、このアドレスに HTTP リクエストで登録情報を送信します。詳細は Configure Client Authentication/Authorization を参照してください。
  • Authentication URL:クライアント認証のための外部サービスの URL を指定します。
  • Up Topic:ゲートウェイから EMQX へメッセージをパブリッシュする際の MQTT トピックパターン。JT/T 808 クライアントからのメッセージがどのように MQTT トピックにマッピングされるかを定義します。デフォルトは jt808/${clientid}/${phone}/up です。
  • Down Topic:ブローカーからゲートウェイ経由で JT/T 808 クライアントに送信されるメッセージの MQTT トピックパターン。MQTT ブローカーから JT/T 808 クライアントへのメッセージルーティングを定義します。デフォルトは jt808/${clientid}/${phone}/dn です。
  • Ignore Unsupported Frames:標準プロトコルに準拠しない JT/T 808 フレームの処理方法を決定します。
    • true に設定すると、サポートされていないフレームをログに記録しつつ、他の有効なメッセージの処理を継続します。カスタムまたは非標準メッセージによる切断を防止します。デフォルトは true です。
    • false に設定すると、サポートされていないフレームを受信した際にクライアントを切断します。
  • Allow Anonymous:クライアントが認証なしで接続できるかどうかを設定します。true に設定すると認証情報なしで接続可能です。

リスナーの追加 ​

デフォルトで、ポート 6207 に名前が default の TCP リスナーが1つ設定されており、1秒あたり最大1,000接続、最大1,024,000の同時接続をサポートしています。より詳細な設定を行うには、Listeners タブをクリックしてリスナーの編集、削除、新規追加が可能です。

jt808-listeners

+ Add Listener をクリックすると Add Listener ページが開き、以下の設定項目を入力できます:

基本設定

  • Name:リスナーの一意識別子を設定します。
  • Type:プロトコルタイプを選択します。MQTT-SN の場合は udp または dtls を選択可能です。
  • Bind:リスナーが接続を受け付けるポート番号を設定します。
  • MountPoint(任意):パブリッシュやサブスクライブ時にすべてのトピックの前に付加される文字列を設定し、異なるプロトコル間でのメッセージルーティングの分離を実現します。

リスナー設定

  • Acceptor:アクセプタプールのサイズを設定します。デフォルトは 16 です。
  • Max Connections:リスナーが処理可能な最大同時接続数を設定します。デフォルトは 1024000 です。
  • Max Connection Rate:リスナーが1秒あたり受け入れ可能な新規接続の最大レートを設定します。デフォルトは 1000 です。
  • Proxy Protocol:EMQX クラスターが HAProxy や NGINX の背後にある場合に Proxy Protocol V1/V2 を有効にします。デフォルトは false です。
  • Proxy Protocol Timeout:Proxy Protocol パケットがタイムアウト内に受信されない場合、EMQX が TCP 接続を切断するまでの時間(秒)。デフォルトは 3 秒です。

TCP 設定

  • ActiveN:ソケットの {active, N} オプションを設定します。これはソケットが積極的に処理できる受信パケット数を意味します。詳細は Erlang Documentation - setopts/2 を参照してください。
  • Buffer:受信および送信パケットを格納するバッファのサイズ(KB単位)を設定します。
  • TCP_NODELAY:接続に対して TCP_NODELAY フラグを設定します。デフォルトは false です。
  • SO_REUSEADDR:ローカルのポート番号再利用を許可するかどうかを設定します。デフォルトは true です。
  • Send Timeout:接続の TCP 送信タイムアウト時間(秒)。デフォルトは 15 秒です。
  • Send Timeout Close:送信タイムアウト時に接続を切断するかどうか。デフォルトは true です。

クライアント認証/認可の設定 ​

JT/T 808 プロトコル仕様における独自の登録/認証ロジックのため、JT/T 808 ゲートウェイは特定の登録サービス HTTP サービスに認証をリクエストする方式の認証のみをサポートしています。

TIP

ここでの「認証」は JT/T 808 プロトコルで定義される認証を指し、MQTT の Pub/Sub アクセス制御とは異なります。

gateway.jt808.proto.auth.allow_anonymous = true を設定すると匿名認証が有効になり、クライアントの登録/認証ロジックをスキップできます。

登録/認証リクエストの詳細フォーマットは以下の通りです:

登録リクエスト ​

properties
URL: http://127.0.0.1:8991/jt808/registry
Method: POST
Body:
   { "province": 58,
     "city": 59,
     "manufacturer": "Infinity",
     "model": "Q2",
     "license_number": "ZA334455",
     "dev_id": "xx11344",
     "color": 3,
     "phone", "00123456789"
   }

登録レスポンス:

戻りコードの意味は以下の通りです:

0: 成功
1: 車両はすでに登録済み
2: データベースに該当車両なし
3: 端末はすでに登録済み
4: データベースに該当端末なし

認証リクエスト ​

properties
URL: http://127.0.0.1:8991/jt808/auth
Method: POST
Body:
   { "code": "authcode",
     "phone", "00123456789"
   }

認証レスポンス:

HTTP ステータスコード 200: 認証成功
その他: 認証失敗

注意:認証リクエストは、システムに認証コードが保存されていない場合(端末が直接認証メッセージを送信してシステムにログインする場合)のみ呼び出されます。

データ交換フォーマット ​

詳細は JT/T 808 Gateway Data Exchange Format を参照してください。

ユーザーレイヤーインターフェース ​