ステークカジノ ライトコイン通信（Downlink）
ステークカジノ ライトコイン通信（Downlink）
2021.10.01
ステークカジノ ライトコイン通信を行って、デバイスの制御（モード変更、メッセージ送信間隔の変更等）を行いたいと考えたことはありませんか。本記事では、Sigfoxネットワークにおけるステークカジノ ライトコイン通信の概要と設定方法について説明していきます。
ステークカジノ ライトコイン通信の概要
ネットワークにおけるステークカジノ ライトコイン通信が、どのような手順で行われているか説明します。
①上りメッセージ（12byte）+ステークカジノ ライトコイン要求
ステークカジノ ライトコイン通信は、必ずデバイスが起点となり始まり、デバイスから「ステークカジノ ライトコインメッセージを送って！」という要求を付加した上りメッセージを送ります。
②DATA BIDIR Callback
①上りメッセージを受信したSigfoxバックエンドは、Callback機能で、アプリケーションサーバーにメッセージを転送します。Callbackは、いくつか種類がありますが、ステークカジノ ライトコイン通信を行う際は、必ずDATA BIDIR Callbackを使用する必要があります。
ここでは、Callbackを使用して、アプリケーションサーバーよりステークカジノ ライトコインメッセージを応答する方法（CALLBACKモード）を説明していますが、Callbackを使用せず、Sigfoxバックエンドで設定したステークカジノ ライトコインメッセージを直接応答する方法（DIRECTモード）もあります。詳細は、後述の「ステークカジノ ライトコイン通信のモード設定」で説明します。
③Callback応答
アプリケーションサーバーは、転送されてきたメッセージに対して、ステークカジノ ライトコインメッセージを応答します。
④ステークカジノ ライトコインメッセージ（8byte）
この応答をSigfoxバックエンドが受け取ると、①上りメッセージを受信した基地局の中から、ステークカジノ ライトコイン通信を行うのに最適な1基地局を選択し、ステークカジノ ライトコインメッセージを送るように指示をします。
⑤ステークカジノ ライトコインメッセージ（8byte）
④で選択された基地局からステークカジノ ライトコインメッセージが送信されます。このステークカジノ ライトコインメッセージをデバイスが受信すると、ステークカジノ ライトコイン通信が成功となります。ステークカジノ ライトコイン通信の回数カウントは、基地局から⑤ステークカジノ ライトコインメッセージが送信されると1回としてカウントされます。デバイスの受信有無は、カウントに関係しません。
- ※もしデバイスが移動している状態にある場合、①上りメッセージを受信した局から遠ざかり、ステークカジノ ライトコインメッセージを受け取れなくなる可能性があります。
このようにステークカジノ ライトコイン通信は、必ずデバイスのステークカジノ ライトコイン要求オプション付きの上りメッセージ（①上りメッセージ）を起点に開始されます。アプリケーションサーバーから任意のタイミングでステークカジノ ライトコインメッセージを送信することはできません。
ではステークカジノ ライトコイン通信を行う際、デバイスはどのような動作をしているのでしょうか。デバイスは、ステークカジノ ライトコイン要求オプション付きの上りメッセージ（①上りメッセージ）を送信してから約20秒後にステークカジノ ライトコインメッセージを受信するモードになります。受信モード中に、Sigfox基地局から送信されるステークカジノ ライトコインメッセージを受信すると、ステークカジノ ライトコイン通信は成功です。受信モード開始後、約35秒の間にステークカジノ ライトコインメッセージを受信できなかった場合は、ステークカジノ ライトコイン通信は失敗となり、受信モードは終了します。
- ※受信モード開始のタイミングと受信モードの時間は、Sigfoxのプロトコルにより定められており、変更することはできません。Sigfox基地局側もデバイスの受信モード中にステークカジノ ライトコインメッセージを送信するよう設計されています。
ステークカジノ ライトコイン通信の設定
ステークカジノ ライトコイン通信を行うためには、Sigfoxバックエンド、もしくはアプリケーションサーバーで、ステークカジノ ライトコイン要求オプション付き上りメッセージに対して、どのような内容のステークカジノ ライトコインメッセージを応答するか設定する必要があります。ここからは、Sigfoxバックエンド及びアプリケーションサーバーの設定方法を説明していきます。
ステークカジノ ライトコイン通信のモード設定（Device type情報の編集）
ステークカジノ ライトコイン通信には、下記2つのモードがあります。これらのモードはSigfoxバックエンド上のDevice typeで設定することができます。ここでは、Device type情報の編集を行い、どちらのモードでステークカジノ ライトコイン通信を行うか設定してきます。
DIRECTモード：Sigfoxバックエンドで設定したステークカジノ ライトコインメッセージを応答する。
CALLBACKモード：アプリケーションサーバーで設定したステークカジノ ライトコインメッセージを応答する。
①DEVICE TYPEメニューより、ステークカジノ ライトコイン通信を行うデバイスが所属するDevice type Nameを選択します。
②Device type Information画面右上[Edit]ボタンをクリックします。
③Device type Edition画面のDownlink dataの項目を編集します。
- Downlink mode
NONE：ステークカジノ ライトコイン通信を行わない。
DIRECT：Sigfoxバックエンドで設定したステークカジノ ライトコインメッセージを応答する。
CALLBACK：アプリケーションサーバーで設定したステークカジノ ライトコインメッセージを応答する。
- Downlink data in hexa：上記でDIRECTを選択した場合、ステークカジノ ライトコインメッセージを設定します。
8バイト固定長（16進数表で16桁）で入力する必要があります。
DIRECTモード（Sigfoxバックエンドで設定したステークカジノ ライトコインメッセージを応答する）を選択した場合は、これで設定完了です。「ステークカジノ ライトコイン要求オプション付きの上りメッセージの送信」の項目に進み、実際にステークカジノ ライトコイン通信を試してみましょう。
CALLBACKモード（アプリケーションサーバーで設定したステークカジノ ライトコインメッセージを応答）を選択した場合は、この設定に加え、Callback設定、アプリケーションサーバーでCallbackに対してステークカジノ ライトコインメッセージを応答する仕組みを実装する必要があります。
Callback設定
CALLBACKモード（アプリケーションサーバーで設定したステークカジノ ライトコインメッセージを応答）を使用する場合、デバイスからのステークカジノ ライトコイン要求オプション付き上りメッセージをアプリケーションサーバーに転送する必要があります。ここでは、上りメッセージを転送するためにCallback設定を行っていきます。
※Callback機能については、こちらの記事を参考にしてください。
①DEVICE TYPEメニューより、ステークカジノ ライトコイン通信を行うデバイスが所属するDevice type Nameを選択します。
②CALLBACKメニューを選択し、画面右上[New]ボタンをクリックします。
③Custom callbackを選択します。
④Callback edition画面にて、必要項目を入力します。
今回は、下記設定でCallbackを作成します。
- Type：必ず[DATA BIDIR]のCallbackを設定してください。
- HTTP Method：POST
- Content type：application/json
- Body：下記変数を使用しています。
{device} ：デバイスID
{time} ：Sigfox基地局がメッセージを受信した時刻（UNIX time）
{data} ：最大12バイトのペイロード
{ack}：ステークカジノ ライトコイン要求オプションの有無、要求有りの場合はtrue、無しの場合はfalseがCallbackされます。- ※ {ack}の変数を使用することで、アプリケーションサーバーがステークカジノ ライトコイン要求のオプションの有無を判断できるようになります。
⑤Callbackを作成すると、作成したCallbackの一覧が表示されますので、今回作成したCallbackのDownlinkの[◯]をクリックします。[●]に変われば設定完了です。これでCallbackの設定は完了です。
アプリケーションサーバーの設定
前項のCallback設定を行うことで、デバイスからのステークカジノ ライトコイン要求付き上りメッセージがアプリケーションサーバーまで届くようになります。アプリケーションサーバーは、届いたCallbackに対して、ステークカジノ ライトコインメッセージを応答する必要があります。ステークカジノ ライトコインメッセージを応答することで、Sigfoxバックエンドを経由し、Sigfox基地局からステークカジノ ライトコインメッセージが送信されます。ここでは、アプリケーションサーバーのCallbackに対する応答設定をしていきます。
アプリケーションサーバーは、Sigfoxバックエンドからメッセージが転送されてきたら、10秒以内に下記フォーマットで応答する必要があります。
{
"デバイスID":{
"downlinkData": "ステークカジノ ライトコインデータ"
}
}
例えば、デバイスID：B42E24に対し、0x1234567890ABCDEFというステークカジノ ライトコインメッセージを応答する場合は、下記のように応答します。
- ※ステークカジノ ライトコインメッセージは8バイトの固定長となります。必ず16進数16桁で応答してください。
{
"B42E24":{
"downlinkData": "1234567890ABCDEF"
}
}
SigfoxバックエンドからJson形式でメッセージがPOSTされてきた際のアプリケーションサーバーのPHPの実装例を下記に示しています。ステークカジノ ライトコイン通信要求オプションの有無を確認し、もしステークカジノ ライトコイン通信の要求があれば、指定されたフォーマットを応答する内容になっています。
<?php
$_POST = json_decode（file_get_contents（'php://input'）, true）;
$_device = $_POST["device"];
$_time = $_POST["time"];
$_ack = $_POST["ack"];
$_data = $_POST["data"];
if （ $_ack == "true" ） {
echo "{";
echo "\"$_device\":{\"downlinkData\":\"1234567890ABCDEF\"}";
echo "}";
}
header（"HTTP/1.0 200 OK"）;
header（"Content-Type : application/json"）;
?
これでアプリケーションサーバーの設定は完了です。実際にデバイスからステークカジノ ライトコイン要求オプション付きの上りメッセージを送ってみましょう。
ステークカジノ ライトコイン要求オプション付きの上りメッセージの送信
Sigfoxバックエンド、アプリケーションサーバーの設定が完了したら、デバイスからステークカジノ ライトコイン要求オプション付きの上りメッセージを送信して、ステークカジノ ライトコイン通信を試してみましょう。ステークカジノ ライトコイン通信を行った際、Sigfoxバックエンド上のメッセージ画面でどのように表示されるのか見ていきます。
ステークカジノ ライトコイン要求オプション付きの上りメッセージ送信方法は、各デバイスの仕様をご確認ください。
- ※こちらの記事にDevkit（開発キット）であるBRKWS01の上りメッセージ・ステークカジノ ライトコイン要求オプション付き上りメッセージの送信方法について記載がありますので参考にしてください。
下図は、デバイスのメッセージ画面です。ステークカジノ ライトコイン要求オプション付き上りメッセージを送信するとCallbacksの項目に[↓]が表示されます。Callbacksの[↓]をクリックすると、Downlink statusのwindowが表示され、ステークカジノ ライトコイン通信の状況と送信したステークカジノ ライトコインメッセージを確認できます。Status：[ACEKD]は、Sigfox基地局からステークカジノ ライトコインメッセージを送信したことを表しています。
- ※デバイスがステークカジノ ライトコインメッセージを受け取ったことを表していませんのでご注意ください。
Sigfox基地局からステークカジノ ライトコインメッセージを送信できなかった場合は、Callbacksの[↓]が赤色となります。 下図では、Status：[INVALID_PAYLOAD]となっており、これは、応答したステークカジノ ライトコインメッセージのフォーマットが不正の場合に発生します。ステークカジノ ライトコインメッセージが8バイト固定長（16進数16桁）でなかったり、SigfoxバックエンドからのCallbackに対して、10秒以内にアプリケーションサーバーが応答できていない場合に発生しますので、もしこのエラーが発生する場合は、アプリケーションサーバーの設定を確認してみてください。
Tips：ステークカジノ ライトコイン要求オプション付き上りメッセージに応答しない
CALLBACKモード（アプリケーションサーバーで設定したステークカジノ ライトコインメッセージを応答） を使用している場合、デバイスからのステークカジノ ライトコイン要求オプション付き上りメッセージ対して、ステークカジノ ライトコインメッセージを応答しないことができます。
下記2通りの方法があり、いずれかの応答をすることで、Sigfox基地局からステークカジノ ライトコインメッセージが送信されなくなります。
- HTTP NO_CONTENTコード（204）を応答する。
- 下記のJsonデータを応答する。
{
"デバイスID":{
"noData":true
}
}
上記応答をした場合のデバイスのメッセージ画面を見てみましょう。Callbacksの[↓]をクリックするとStatus：[NO_ANSWER]となっています。このStatusの場合、Sigfox基地局からステークカジノ ライトコインメッセージが送信されていません。
Sigfoxネットワークのステークカジノ ライトコイン通信の上限回数は、プランにより異なりますが、1日最大4回となります。この方法を使用することで、ステークカジノ ライトコイン通信の送信回数を制御することができます。但し、デバイスは、ステークカジノ ライトコインオプション付きの上りメッセージを送信すると、必ず受信モードとなり、上りメッセージを送信するだけの場合と比較すると、バッテリーを消耗してしまいますので、ご注意ください。
著者情報
