動作確認方法

apn: APN 名設定

APN を設定します。 ご利用になられる SIM カードの提供事業者から指定された APN 名を、ダブルクオテーションで囲んで設定してください。

auth_prot: ppp 認証方式設定

PPP 認証方式を設定します。 ご利用になられる SIM カードの提供事業者から指定された ppp 認証方式を、ダブルクオテーションで囲んで設定してください。 "pap"、"chap" または "none" (認証不要) が設定可能です。 ユーザー名とパスワードが不要な SIM の場合、 "none" を設定してください。

username: ユーザー名設定

ユーザー名を設定します。 ご利用になられる SIM カードの提供事業者から指定された ユーザー名を、ダブルクオテーションで囲んで設定してください。 auth_prot が "none" の場合設定は不要です。

password: パスワード設定

パスワードを設定します。 ご利用になられる SIM カードの提供事業者から指定された パスワードを、ダブルクオテーションで囲んで設定してください。 auth_prot が "none" の場合設定は不要です。

create_wvdial_conf: wvdial.conf 自動生成設定

ppp 接続を実行するアプリケーション wvdial が参照する設定ファイル /etc/wvdial.conf を自動生成する場合、 true を設定してください。 true 以外の文字列が設定された場合、 /etc/wvdial.conf の自動生成を行いません。 自動生成されるファイルの内容は以下の通りです。 これ以外の設定にしたい場合は、本パラメーターを無効にし、/etc/wvdial.conf を直接編集してご利用ください。

[Dialer Defaults]
Init1 = ATZ
Init2 = AT+CFUN=1
Init3 = AT+COPS?
Modem Type = Analog Modem
Dial Command = ATD
Baud = 460800
Modem = /dev/ttymxc1
New PPPD = yes
Dial Attemps = 0
ISDN = 0
APN = apn
Phone = *99***1#
Password = password の値
Username = username の値
Carrier Check = yes
Auto DNS = 1
Check Def Route = 1
Stupid Mode = yes
Check DNS = 1

[Dialer Defaults]
Init1 = ATZ
Init2 = AT+CFUN=1
Init3 = AT+COPS?
Modem Type = Analog Modem
Dial Command = ATD
Baud = 460800
Modem = /dev/ttymxc1
New PPPD = yes
Dial Attemps = 0
ISDN = 0
APN = apn
Phone = *99***1#
Password = ''
Username = ''
Carrier Check = yes
Auto DNS = 1
Check Def Route = 1
Stupid Mode = yes
Check DNS = 1

operator_id: オペレーターID 設定

オペレーターID を指定します。ローミング対応 SIM などオペレーター自動選択では接続できない場合、本パラメーターを設定することで接続できることがあります。
設定値は、SIM を提供している事象者に確認ください。
例として、 NTT ドコモの網を利用している SIM の場合 "44010" になります。
自動設定を指定する場合は、本パラメーターに "auto" を設定してください。
ダブルクォテーションで囲んで設定してください。

fix_profile: プロファイル指定設定

LTE モデムで使用するプロファイルを指定します。
通常は LTE モデムが自動でプロファイルを選択する為、設定する必要はありませんが、
ローミング対応 SIM など上手く接続出来ない場合に設定することで接続できることがあります。

sleep: Sleep 設定

LTE モデムとのシリアルインタフェースが指定時間通信がない時に Sleep モードへ遷移します。
"disable" を設定した場合、この設定が無効となります。
以下の表に示す値以外を設定した場合、LTE モデムへの設定を行いません。

suspend: Suspend 設定

Suspend の有効・無効を設定します。

LTE モデムの Suspend を有効にすると、LTE モデムは省電力・間欠動作機能のスリープモードに該当する動作となります。詳細は、「スリープモード」を参照ください。

psm: PSM 設定

PSM(Power Saving Mode) の設定を行います。
"disable" を設定すると PSM が無効になります。
有効にする場合、tau(periodic Tracking Area Update) と act-time(ACTive TIME) の組み合わせを設定します。

edrx: eDRX 設定

eDRX の設定を行います。
"disable" を設定すると eDRX が無効になります。
有効にする場合、 pcl(Paging Cycle Length) と ptw(Paging Time Window eDRX) の組み合わせを設定します。

auto_dial: 自動 ppp 接続設定

このパラメーターに true が設定されていると、ppp コネクションを自動確立し、確立出来た後 IP アドレスが付与されると IP 通信が可能となります。
true 以外の値が設定されている場合、何もしません。
作成されたアプリケーションのタイミングで ppp 接続を行いたい場合などは、 true を設定しないでください。

multiplex: Multiplex 機能設定

このパラメーターに auto または enable が設定されており、Linux カーネルのバージョンが at43 以降の場合、Multiplex を有効にします。 通常、ppp コネクション確立中は一部のaiot-modem-control コマンドの機能が使用できませんが、 Multiplex 機能を有効にすることで使用可能になります。

register_check_interval: ネットワーク登録確認周期設定

指定された間隔(秒)でネットワーク登録を確認します。
suspend が "enable" に設定されている場合、確認を実行しません。
また、ネットワーク登録が確認された後、auto_dial の設定が true であれば、自動的に ppp 接続を試みます。
確認周期は 30 秒から 300 秒の間で設定可能です。

ping_check: LTE 再接続機能設定

このパラメータが true に設定されており、"register_check_interval" "ping_ip_addr" "ping_failed_threshold" に有効な値が設定されている場合、LTE 再接続機能を有効にします。
詳細は「LTE 再接続機能」をご確認ください。

ping_ip_addr: LTE 再接続機能ping 導通先

LTE 再接続機能の ping 導通確認先の IP アドレスを設定します。
設定されていない場合、"ping_check" が true である場合でもLTE 再接続機能は無効になります。

ping_failed_threshold: LTE 再接続機能ping連続失敗閾値

LTE 再接続機能の ping 導通確認が連続で何回失敗した場合にLTE再接続を実行するかの閾値を設定します。
この値は 1以上の数値を設定してください。
0以下または設定されていない場合、"ping_check" が true である場合でもLTE 再接続機能は無効になります。

	設定ファイルを更新した場合
	LTE 設定ファイル (/etc/aiot-modem-control/startup.conf) を更新した場合、設定を適用するにはArmadillo-IoT ゲートウェイ A6 の再起動または LTE モデムを制御するサービスの再起動が必要です。必要に応じて実施してください。 [armadillo ~]# reboot # Armadillo-IoT ゲートウェイ A6 を再起動する [armadillo ~]# systemctl restart aiot-modem-controld.service # LTE モデムを制御するサービスの再起動を行う 設定ファイルで自動 ppp 接続設定を有効 (auto_dial=true) にしていない場合、図6.16「aiot-modem-control dial コマンド」を使用して ppp 接続を確立する必要があります。

set-apn: APN 設定

パラメーターに指定した APN を LTE モデムに設定します。
APN はダブルクオテーションで囲んでください。

[armadillo ~]# aiot-modem-control set-apn "example.com"

dial: ppp コネクション確立

wvdial を使用して ppp コネクションの確立を試みます。
既に wvdial が動作しているときは何もせずコマンドを終了します。

[armadillo ~]# aiot-modem-control dial

hangup: ppp コネクション切断

wvdial を停止して ppp コネクションを切断します。
既に wvdial が動作していないときは何もせずコマンドを終了します。

[armadillo ~]# aiot-modem-control hangup

切断後、 /etc/aiot-modem-control/startup.conf で auto_dial に true を設定、かつ register_check_interval に有効な値を設定している場合、次の確認周期でネットワーク登録が出来ている場合、自動的に ppp の接続を行います。

get-phone-number: 電話番号取得

SIM カードに設定されている電話番号を取得します。

[armadillo ~]# aiot-modem-control get-phone-number
123456789012

get-signal-quality: 電波品質(RSRQ)取得

現在の電波品質(RSRQ: Reference Signal Received Quality)を取得します。
Sleep 中などは 255 になります。

[armadillo ~]# aiot-modem-control get-signal-quality
21

wwan-force-restart :LTE モデム再起動

LTE モデムを再起動します。
再起動後、 /etc/aiot-modem-control/startup.conf に記載された設定を実行します。
/etc/aiot-modem-control/startup.conf の設定によっては、コマンドが終了するまでに時間がかかります。

[armadillo ~]# aiot-modem-control wwan-force-restart

poweron: LTE モデム 電源オン

LTE モデムを起動します。
起動後、 /etc/aiot-modem-control/startup.conf に記載された設定を実行します。
/etc/aiot-modem-control/startup.conf の設定によっては、コマンドが終了するまでに時間がかかります。
既に起動している場合、何もせずにコマンドを終了します。

[armadillo ~]# aiot-modem-control poweron

poweroff: LTE モデム 電源オフ

LTE モデムの電源をオフします。
既にオフされている場合、何もせずにコマンドを終了します。

[armadillo ~]# aiot-modem-control poweroff

set-psm: PSM 設定

PSM の設定を行います。
パラメーターに enable を指定した場合、 その後ろに tau(periodic Tracking Area Update) と act-time(ACTive TIME) の順に値を指定します。
disable を指定すると、 PSM が無効になります。
default を指定すると、 PSM が無効になり、tau と act-time が初期値に設定されます。
初期値は、 tau が 3 分、 act-time が 1 分です。

[armadillo ~]# aiot-modem-control set-psm enable 3m 1m

[armadillo ~]# aiot-modem-control set-psm disable

[armadillo ~]# aiot-modem-control set-psm default

set-edrx: eDRX 設定

eDRX の設定を行います。
パラメーターに enable を指定した場合、 その後ろに pcl(Paging Cycle Length) と ptw(Paging Time Window eDRX) の値を指定します。
disable を指定すると、 eDRX が無効になります。
default を指定すると、 eDRX が無効になり、pcl と ptw が初期値に設定されます。
初期値は、 pcl が 20.48 秒、 ptw が 5.12 秒です。

[armadillo ~]# aiot-modem-control set-edrx enable 20.48 5.12

[armadillo ~]# aiot-modem-control set-edrx disable

[armadillo ~]# aiot-modem-control set-edrx default

set-sleep: Sleep 設定

パラメーターに enable を指定した場合、その後ろに LTE モデムとのシリアルインタフェースが指定時間通信がない時に Sleep モードへ遷移する時間(ミリ秒)を指定します。100ミリ秒から5000ミリ秒の間の値を指定可能です。
disable を設定した場合、この設定が無効となります。

[armadillo ~]# aiot-modem-control set-sleep enable 5000

[armadillo ~]# aiot-modem-control set-sleep disable

set-suspend: Suspend 設定

LTE モデムの Suspend 設定を行います。enable または disable を指定可能です。

LTE モデムの Suspend を有効にすると、LTE モデムは省電力・間欠動作機能のスリープモードに該当する動作となります。詳細は、「スリープモード」を参照ください。

[armadillo ~]# aiot-modem-control set-suspend enable

[armadillo ~]# aiot-modem-control set-suspend disable

activate: LTE モデム活性化

LTE モデムを suspned 状態へ移行させます。
suspend を有効に設定しているときのみ有効なコマンドです。
データー通信中など suspend 状態へ即座に移行出来ないこともあります。

[armadillo ~]# aiot-modem-control activate

deactivate: LTE モデム非活性化

LTE モデムを suspned 状態から復帰させます。
suspend を有効に設定しているときのみ有効なコマンドです。

[armadillo ~]# aiot-modem-control deactivate

send-at: AT コマンド送信

パラメーターに指定した AT コマンドを送信します。
AT コマンドはダブルクオテーションで囲んでください。

[armadillo ~]# aiot-modem-control send-at "AT"

send-at-echo: AT コマンド送信(応答表示)

パラメーターに指定した AT コマンドを送信します。
LTE モデムからの応答が標準出力に表示されます。
AT コマンドはダブルクオテーションで囲んでください。

[armadillo ~]# aiot-modem-control send-at-echo "AT"
AT
OK

status: 簡易状態表示

LTE モデムの状態を表示します。
最新の状態ではなく、それぞれ最後に取得できた値のキャッシュになります。
特に rsrq と rsrp は ppp コネクション確立中は更新できませんので、最新の値にはなりません。 最新の状態を確認する場合は、「LTE 設定ファイル (/etc/aiot-modem-control/startup.conf) の編集」 でMultiplex 機能設定を有効にする、または 図6.17「aiot-modem-control hangup コマンド」 でppp 接続を終了させた上で 図6.19「aiot-modem-control get-signal-quality コマンド」 などを使用してください。

[armadillo ~]# aiot-modem-control status
    manufacturer: Cinterion
           model: EMS31-J
        revision: REVISION 04.014
     app revison: A-REVISION 01.000.17
         port(s): /dev/ttymxc1
          status: registered
    phone number: 01234567890
            imei: 012345678900123
signale quality
            rsrq: 19 [-10.5 dB <= rsrq < -10.0 dB]
            rsrp: 44 [-97 dBm <= rsrq < -96 dBm]
        sim slot: 1
     operator id: "12345"

aiot-modem-control 処理結果

aiot-modem-control の戻り値と意味を表6.16「aiot-modem-control 処理結果」に示します。