Soracom

Users

スタートガイド
Home スタートガイド USB ドングル Soracom Onyx - LTE™ USB ドングルをセットアップする 設定方法

Raspberry Pi (Raspberry Pi OS) の設定

Soracom Onyx - LTE™ USB ドングル (以下、USB ドングル) は Quectel EG25-G を通信モジュールとして使用しています。Linux カーネル 2.6 以上では、Linux にドライバーが付属しているため、ドライバーのインストールは不要です。ただし、セルラー通信を行うために追加パッケージのインストールと設定が必要です。

ここでは、Linux に追加パッケージをインストールし、3G / 4G 接続に利用する PPP (Point-to-Point Protocol) の設定を行うスクリプト setup_air.sh を利用する手順を説明します。

setup_air.sh をダウンロードするために、有線 LAN などでインターネットに接続する必要があります。

  1. Raspberry Pi がインターネットに接続できていることを確認します。

  2. USB ドングルを Raspberry Pi の USB ポートに差し込みます。

    USB ドングルの LED が点滅します。

  3. USB ドングルが Raspberry Pi にシリアルポートとして認識されていることを確認します。

    $ ls /dev/ttyUSB*
    
    /dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3
    
    USB ドングルが認識されない場合

    以下のようなメッセージが表示され USB ドングルが認識されていないときは、USB ドングルを Raspberry Pi から一度取り外して、手順 2 からやり直してください。もしくは、Raspberry Pi を再起動してください。

    ls: cannot access '/dev/ttyUSB*': No such file or directory
    
  4. setup_air.sh をダウンロードします。

    $ curl -O https://soracom-files.s3.amazonaws.com/setup_air.sh
    

    curl コマンドのオプションは数字のゼロ (0) ではなくアルファベットのオー (O) です。

  5. setup_air.sh を実行します。

    plan-DU の IoT SIM を利用している場合は、コマンドが異なります。

    $ sudo bash setup_air.sh du.soracom.io # plan-DU をご利用の場合
    $ sudo bash setup_air.sh # それ以外の SIM をご利用の場合
    
    bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
    --- 1. Check required packages
    wvdial is not installed! installing wvdial...
    
    ...
    
    # please ignore message above, as /etc/wvdial.conf will be created soon.
    
    ok.
    
    --- 2. Patching /lib/systemd/system/ifup@.service
    ok.
    
    --- 3. Generate config files
    Adding network interface 'wwan0'.
    Adding udev rules for modem detection.
    ok.
    
    --- 4. Initialize Modem
    /bin/bash: warning: setlocale: LC_ALL: cannot change locale (en_US.UTF-8)
    ok.
    Now you are all set.
    
    Tips:
    - When you plug your usb-modem, it will automatically connect.
    - If you want to disconnect manually or connect again, you can use 'sudo ifdown wwan0' / 'sudo ifup wwan0' commands.
    - Or you can just execute 'sudo wvdial'.
    

以上で USB ドングルが初期化され Raspberry Pi が SORACOM 経由でインターネットに接続されるようになりました。OS 再起動時や USB ドングルを接続した際にも自動的に接続されます。

接続確認

USB ドングルを Raspberry Pi から取り外し、再度 USB ポートに差し込むと、セルラー通信が開始されます。

ifconfig ppp0 で、PPP が利用できることが確認できます。

$ ifconfig ppp0
ppp0      Link encap:Point-to-Point Protocol
          inet addr:10.xxx.xxx.xxx  P-t-P:10.64.64.64  Mask:255.255.255.255
          UP POINTOPOINT RUNNING NOARP MULTICAST  MTU:1500  Metric:1
          RX packets:133 errors:0 dropped:0 overruns:0 frame:0
          TX packets:134 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:3
          RX bytes:2092 (2.0 KiB)  TX bytes:4039 (3.9 KiB)

また、PING 応答サービスを利用すると、SORACOM に接続できていることが確認できます。

$ ping -c 4 pong.soracom.io
PING pong.soracom.io (100.127.100.127) 56(84) bytes of data.
64 bytes from 100.127.100.127 (100.127.100.127): icmp_seq=1 ttl=64 time=113 ms
64 bytes from 100.127.100.127 (100.127.100.127): icmp_seq=2 ttl=64 time=112 ms
64 bytes from 100.127.100.127 (100.127.100.127): icmp_seq=3 ttl=64 time=111 ms
64 bytes from 100.127.100.127 (100.127.100.127): icmp_seq=4 ttl=64 time=110 ms

--- pong.soracom.io ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 3003ms
rtt min/avg/max/mdev = 109.986/111.469/112.955/1.097 ms
setup_air.sh を実行しても SORACOM に接続できない場合

以下の操作を行い、SORACOM に接続できることを確認してください。

  • Raspberry Pi を再起動します。たとえば、sudo reboot -h now を実行します。
  • IoT SIM が正しく挿入されていることを確認します。正しく挿入されていない場合は、SORACOM に接続できません。
  • LAN ケーブルを抜く、または Wi-Fi を無効にします。LAN ケーブルや Wi-Fi による接続が優先されていると、SORACOM に接続できません。