☁️くもをもくもくまなぶ

クラウドコンピューティングサービスの学んだことを中心につらつらと書いています
2022-03-06
SORACOMIoT

新しいSIMとAK-020が届いたので初期設定をやってみた＆SORACOM CLIの設定

はじめに環境デバイスのネットワーク状態確認インストール前インストール後不要な通信を防ぐためにインターフェース停止SORACOM CLIのインストールSORACOM CLI インストール紹介ページ配布しているページ（Windowsユーザ用）CLI実行用のAPIキーとシークレットキーの生成実行ファイル（EXE）の配置Windowsで利用できるjqまとめ

はじめに

基本的にはSORACOMさんが公開している手順に沿えば問題なく繋がりました。
https://users.soracom.io/ja-jp/guides/starter-kits/ultrasonic/setup-raspberry-pi/

環境
Image in a image block
$ cat /etc/os-release
PRETTY_NAME="Raspbian GNU/Linux 9 (stretch)"
NAME="Raspbian GNU/Linux"
VERSION_ID="9"
VERSION="9 (stretch)"
VERSION_CODENAME=stretch
ID=raspbian
ID_LIKE=debian
HOME_URL="<http://www.raspbian.org/>"
SUPPORT_URL="<http://www.raspbian.org/RaspbianForums>"
BUG_REPORT_URL="<http://www.raspbian.org/RaspbianBugs>"
$
$ uname -a
Linux raspberrypi 4.19.66-v7+ #1253 SMP Thu Aug 15 11:49:46 BST 2019 armv7l GNU/Linux
$
  • セットアップファイルと実行
    • curl <https://soracom-files.s3.amazonaws.com/setup_air.sh> | sudo bash

$ curl <https://soracom-files.s3.amazonaws.com/setup_air.sh> | sudo bash
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  7210  100  7210    0     0  32279      0 --:--:-- --:--:-- --:--:-- 32331
--- 1. Check required packages
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
Found un-initilized modem. Trying to initialize it ...
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'.
$
デバイスのネットワーク状態確認
インストール前
$ ifconfig
eth0:

lo:

wlan0:

$
インストール後
$ ifconfig
eth0:

lo:

ppp0: flags=4305<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST>  mtu 1464
        inet 10.x.xx.xx  netmask 255.255.255.255  destination 10.xx.xx.xx
        ppp  txqueuelen 3  (Point-to-Pointプロトコル)
        RX packets 46  bytes 226 (226.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 47  bytes 985 (985.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

wlan0:

wwan0:

$
不要な通信を防ぐためにインターフェース停止
  • まだ何も転送する元データを生成する準備がができていないので疎通確認して終了します
    • sudo ifdown wwan0
      • 再度利用するときは sudo ifup wwan0

$ sudo ifdown wwan0
$
$ ifconfig
eth0:

lo:

wlan0:

wwan0:

$

SORACOM CLIのインストール

SORACOM CLI インストール紹介ページ

https://users.soracom.io/ja-jp/tools/cli/

配布しているページ（Windowsユーザ用）

https://github.com/soracom/soracom-cli/releases

  • コマンドプロンプトの set PROCESSOR で出力される PROCESSOR_ARCHITECTURE で確認できます
C:\\>set PROCESSOR
PROCESSOR_ARCHITECTURE=AMD64
PROCESSOR_IDENTIFIER=Intel64 Family 6 Model 142 Stepping 10, GenuineIntel
PROCESSOR_LEVEL=6
PROCESSOR_REVISION=8e0a

C:\\>
  • PowerShellの Get-ChildItem env:processor* で出力される PROCESSOR_ARCHITECTURE で確認できます
PS C:\\> Get-ChildItem env:processor*

Name                           Value
----                           -----
PROCESSOR_IDENTIFIER           Intel64 Family 6 Model 142 Stepping 10, GenuineIntel
PROCESSOR_ARCHITECTURE         AMD64
PROCESSOR_REVISION             8e0a
PROCESSOR_LEVEL                6


PS C:\\>
Image in a image block


自身の環境に合ったファイルを取得してください

CLI実行用のAPIキーとシークレットキーの生成
Image in a image block


あくまでも今回はサンプルのため、強い権限（管理者権限）を設定しています。本番環境では非推奨です。

Image in a image block


KeyId- と secret- で始まる文字列は外部に公開しないように注意してください！

実行ファイル（EXE）の配置
Image in a image block
  • PATHが通っている先にEXEを配置します
    • 今回はC:\\Windows\\System32\\ に置いています
C:\\>where soracom
C:\\Windows\\System32\\soracom.exe

C:\\>soracom version
SORACOM API client v0.11.0

C:\\>
C:\\>soracom configure --profile soracom-cli-user1
--- SORACOM CLI セットアップ ---
C:\\~\\.soracom ディレクトリがなければ作成し、そこにファイル 'soracom-cli-user1.json' を作成します。

カバレッジタイプを選択してください。

1. Global
2. Japan

選択してください (1-2) > 2


認証方法を選択してください。

1. AuthKeyId と AuthKey を入力する（推奨）
2. オペレーターのメールアドレスとパスワードを入力する
3. SAM ユーザーの認証情報を入力する（オペレーターID、ユーザー名、パスワード）

選択してください (1-3) > 1
authKeyId: keyId-****
authKey:
C:\\>
C:\\>
C:\\>soracom configure get --profile soracom-cli-user1
{
        "sandbox": false,
        "coverageType": "jp",
        "authKeyId": "keyId-****",
        "authKey": "secret-****",
        "registerPaymentMethod": false
}

C:\\>
C:\\>
Windowsで利用できるjq

https://stedolan.github.io/jq/

こちらも同様にPATHに配置します。

  • 利用しているSIMの情報を確認するコマンド

soracom sims list --profile soracom-cli-user1 | jq -r ".[] | [.tags.name, .serialNumber, .speedClass, .status, .sessionStatus.online, .sessionStatus.subscription] | @csv"

C:\\>soracom sims list --profile soracom-cli-user1 | jq -r ".[] | [.tags.name, .serialNumber, .speedClass, .status, .sessionStatus.online, .sessionStatus.subscription] | @csv"
"AK-020","DN0605821776710","s1.4xfast","active",false,"plan-D"
"GPS繝槭Ν繝√Θ繝九ャ繝茨ｼ・,"AX0605913722310","s1.standard","active",false,"plan-D"

C:\\>

まとめ

SIM の設定はSORACOMさんが公開している公式の手順で問題なく設定できました。
スピードクラスはデフォルトだと s1.4xfast なのかな？
今回は疎通確認なので特に速度を変えてはいないですが...うーん、分からない...

SORACOM CLIは、AWS CLIと基本的な思想は同じなので使い方は問題なくできました。
Windows 環境なので jqで文字化けしたのは残念でしたが...

Macで実行すると文字化けなく表示されました。soracom sims list --profile soracom-cli-user1 | jq -r '.[] | [.tags.name, .serialNumber, .speedClass, .status, .sessionStatus.online, .sessionStatus.subscription] | @csv'

soracom sims list --profile soracom-cli-user1 | jq -r '.[] | [.tags.name, .serialNumber, .speedClass, .status, .sessionStatus.online, .sessionStatus.subscription] | @csv'
"AK-020","DN0605821776710","s1.4xfast","active",false,"plan-D"
"GPSマルチユニット１","AX0605913722310","s1.standard","active",false,"plan-D"
Image in a image block

SORACOMIoT