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 などでインターネットに接続する必要があります。
Raspberry Pi がインターネットに接続できていることを確認します。
USB ドングルを Raspberry Pi の USB ポートに差し込みます。
USB ドングルの LED が点滅します。
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
setup_air.sh
をダウンロードします。$ curl -O https://soracom-files.s3.amazonaws.com/setup_air.sh
curl
コマンドのオプションは数字のゼロ (0
) ではなくアルファベットのオー (O
) です。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 に接続できません。