Arduino IDE は標準では Wio LTE の開発環境が入っていませんが、環境設定から追加することができるため、その設定をおこないます。
できるようになる事
- Arduino IDE にて Wio LTE を用いた開発
このハンズオンでサポートしない事 (前提知識)
- Arduino IDE のセットアップ (Windows 編 をご覧ください (約15～20分))
このコンテンツの進め方
ページの内容を読み、また作業を行ったら右下の［Next］を押して次のステップへ進みます。また、［Back］を使って戻ったり、左のナビゲーションメニューでもページの移動が可能です。
左上の［×］を押してコンテンツを終了することができます。また、ページを開きなおすことで再開できます。ページのアドレスはブラウザの［履歴］メニューを利用してください。
ハードウェア
品名 | 数量 | 価格 | 購入先 | 備考 |
Wio LTE JP Version | 1 | 9,800円 | ソラコム 等 | 手元くなくても「WinUSB のインストール」までは進めることができます。 その他のキットに同梱されている Wio LTE でも OK です。 |
microUSB ケーブル | 1 | ― | ― | Wio LTE JP Version に付属しています。 それ以外のものを利用する場合は 1A 以上の電力が利用可能な品質のものをご利用ください。 |
(必要な方のみ) USB 変換アダプタ | ― | ― | ― | Wio LTE とパソコンを USB ケーブルで接続する際に利用します。 1A 以上の電力が供給できるものを利用してください。(USB 3.0以上に対応していれば概ね安心です) |
※ 金額は本コンテンツ作成時となります。ソラコムで販売している金額は税抜き・送料別です。
それ以外で必要となるもの
Arduino IDE がセットアップ済みのパソコン |
|
Arduino IDE の［ファイル］>［環境設定］を開きます。
追加のボードマネージャのURL の 
をクリックします。
ボード定義の URL を入力します。
テキストボックスに以下の URL を入力します。(".json" まで1行で入力してください)
https://www.seeed.co.jp/package_SeeedJP_index.json
入力したら［OK］をクリックします。
環境設定の OK をクリックします。
環境設定のウィンドウに戻ってきたら［OK］をクリックします。
Arduino IDE の［ツール］>［ボード: ...］>［ボードマネージャ...］をクリックします。
"SeeedJP STM32 Boards" をインストールします。
ボードマネージャの一覧から SeeedJP STM32 Boards (by Seeed K.K.) を選んで［インストール］をクリックします。
バージョンはインストール時における最新バージョンを選んでください。
※ 約350MBのダウンロードが発生します。早くても 20分、遅いと 60分以上かかることがあります。
インストールが終了したら［閉じる］をクリックします。
以上で、Wio LTE 用ボード定義のインストールは完了です。
Arduino IDE の［スケッチ］>［ライブラリをインクルード］>［ライブラリを管理...］をクリックします。
Wio LTE for Arduino をインストールします。
ライブラリマネージャの一覧から Wio LTE for Arduino (by Seeed K.K.) を選んで［インストール］をクリックします。
バージョンはインストール時における最新バージョンを選んでください。
※ 約 54KBのダウンロードが発生します。
インストールが終了したら［閉じる］をクリックします。
ここまでのセットアップが正常にできているか、実際にサンプルのプログラム (スケッチと呼ばれる) をコンパイルしてみます。
ここでは Wio LTE 実機はまだ使用しません。
ボード定義を "Seeed Wio LTE Cat.1" に変更する
［ツール］>［ボード: ...］>［Seeed Wio LTE Cat.1］をクリックします。
サンプルスケッチ "LedSetRGB" を開く
［ファイル］>［スケッチ例］>［Wio LTE for Arduino］>［basic］>［LedSetLGB］をクリックします。
コンパイルをする
新しく開いたウィンドウで
ボタンをクリックします。スケッチのコンパイルが始まります。
ウィンドウの下部で進行状況が確認できます。
進行状況の部分にコンパイルが完了しました。と表示されれば、開発環境は正しくセットアップできています。
エラー発生時の対処
コンパイル時にエラーが発生すると以下のように表示されます。
ここまでのセットアップで不備が無かったか、再度確認してください。
※ エラーメッセージは一例です。他にも複数のパターンがあります。
Wio LTE のシリアルポートをパソコンで認識するためのドライバです。
Virtual COM Port ドライバのダウンロードページを開き stsw-stm32102.zip をダウンロードします。
ダウンロードした stsw-stm32102.zip 内の VCP_V1.4.0_Setup.exe を実行します。
※ stsw-stm32102.zip の中に、さらに en.stsw-stm32102.zip があり、その中に VCP_V1.4.0_Setup.exe があります。
「インストーラーのような画面」にしたがって、実行してください。
最後に［Finish］をクリックします。
スタートボタンを右クリックして [ファイル名を指定して実行] をクリックした後、 [名前] へ以下のファイル名を入力して [OK] を押します。
※ ".exe" まで、1行で入力してください
C:\Program Files (x86)\STMicroelectronics\Software\Virtual comport driver\Win8\dpinst_amd64.exe
続いて表示されるダイアログに従って作業を進めてください。デバイスソフトウェアのインストールには［インストール］をクリックします。
最後に［完了］をクリックします。
Wio LTE にプログラムを書き込む際に必要なドライバです。
Zadig を開き、Download にある Zadig 2.5 をクリックして zadig-2.5.exe (以下 zadig と表記します) をダウンロードします。
Wio LTE 本体を用意します
Wio LTE 本体が無い場合はここで終了です。
後日、Wio LTE 本体を入手した後に、ここから再開してください。
zadig を実行します。
※ 最初に表示されるダイアログ(Zadig update policy)は [No] としておいてください。
［Options］>［List All Devices］を選択します。
Wio LTE を DFUモード に切り替えます。
Wio LTE に microUSB を挿し、パソコンと接続してから下記の操作を行います。
- Wio LTE の BOOTボタンを押し、 押し続けてください
- Wio LTE の RSTボタンを押し、すぐ離します
- 押し続けていた BOOTボタン を離します
※動画では microUSB 接続をしていませんが、実際は接続した状態で行ってください
zadig の一覧から STM32 BOOTLOADER を選んだ後、Driver欄が STTub30 もしくは (none) になっていることを確認し、その右を WinUSB に変更してから、 ［Replace Driver］もしくは［Install Driver］ をクリックします。
ここまでのセットアップで「デバイスマネージャー」で Wio LTE の動作モードが確認できます。
Wio LTE の動作モードとは？
Wio LTE は 2 つのモードを持っています。このモードを切り替えていくことで、プログラムを書き込んだり、実行したりする事になります。
電源 ON (= microUSB を接続した直後) は、通常モードで動き出します。
モード | 利用シーン |
通常モード | 書き込まれたプログラムを実行するときに使用 |
DFUモード | プログラムを書き込む時に使用 |
切り替え方と確認方法
DFU モードへの切り替え
Wio LTE とパソコンが microUSB でつながれた状態で、下記の操作を行います。(いつ行っても構いません)
- Wio LTE の BOOTボタンを押し、 押し続けてください
- Wio LTE の RSTボタンを押し、すぐ離します
- 押し続けていた BOOTボタン を離します
確認方法: デバイスマネージャを起動し、一覧の中で ユニバーサル シリアル バス デバイス (Windows 7 の場合は Universal Serial Bus Devices) の一覧に STM32 BOOTLOADER が表示されていれば、DFUモードで動作しています。
通常モードへの切り替え
Wio LTE とパソコンが microUSB でつながれた状態で、下記の操作を行います。(いつ行っても構いません)
- Wio LTE の RSTボタンを押し、すぐ離します
確認方法: デバイスマネージャを起動し、一覧の中でポートの一覧に STMicroelectronics Virtual COM Port が表示されていれば、通常モードで動作しています。
いよいよ Wio LTE 本体でスケッチを実行します。
Wio LTE をパソコンにつなげる
Wio TE 本体と USB ケーブルを用意して接続してください。
この時 Wio LTE の電源が自動的に ON になりますが特に問題ありません。
サンプルスケッチ "LedSetRGB" を開く
［ファイル］>［スケッチ例］>［Wio LTE for Arduino］>［basic］>［LedSetLGB］をクリックします。
Wio LTE を DFU モードにする
Wio LTE を DFU モードにしてください。
マイコンボードに書き込む
"LedSetLGB" を表示しているウィンドウで
ボタンをクリックします。
スケッチのコンパイルと、スケッチの書き込みが始まります。
ボードへの書き込みが完了しました。と表示されたら正常終了です。
エラーが発生した場合
「マイコンボードに書き込む」を実行した結果、ウィンドウに下記のように表示された
| "ボード" が "Seeed Wio LTE Cat.1" になっていません。メニューの［ツール］>［ボード: ...］ から Seeed Wio LTE Cat.1 を選択してください。 |
「マイコンボードに書き込む」を実行した結果、ウィンドウに下記のように表示された
| Wio LTE が「通常モード」の状態、もしくはつながっていない状態で書き込もうとしています。Wio LTE を「DFU モード」にしてから、再度「マイコンボードに書き込む」を実行してください。 |
「マイコンボードに書き込む」を実行した結果、ウィンドウに下記のように表示された
| 主に Windows で発生するエラーです。Arduino IDE のシリアルモニタ―を表示ている状態で発生します。原因はシリアルポートの解放に失敗しています。Arduino IDE 1.18.10 以降であれば発生しにくいエラーですが、発生してしまった場合は Arduino IDE 終了＆再度立ち上げてから書き込みを行ってください。また Arduino IDE のシリアルモニターは使わずに TeraTerm を使うことで回避しやすくなります。 |
「マイコンボードに書き込む」を実行した結果、ウィンドウに下記のように表示された
| macOS で発生するエラーです。 libusb がインストールされていません。 libusb のインストールを参照して作業してから、再度「マイコンボードに書き込む」を実行してください。 |
「マイコンボードに書き込む」を実行した結果、ウィンドウに下記のように表示された
| Arduino IDE 1.8.8 以降の最新版をインストールしてください。もしくは、一度 Wio LTE を通常モードにした後 Arduino IDE の [ツール] > [シリアルポート] に表示される一覧の中から Wio LTE として認識されているシリアルポートを選択してください。その後に Wio LTE を DFU モードにして、再度「マイコンボードに書き込む」を実行してください。 シリアルポートの選択方法 (Windows): シリアルポートが複数表示される場合はデバイスマネージャーの「ポート」から STMicroelectoronics Virtual COM Port を探して割り当てられている番号のものを選択してください。(Wio LTE が接続されたシリアルポートが表示されない場合は Virtual COM Port ドライバのインストールが終わっていません。 Wio LTE 開発環境の準備 / Virtual COM Port ドライバのインストール をご覧いただき再確認をしてください。特に「終わってる」と思っていてもよくある間違いがあります。) シリアルポートの選択方法(macOS): シリアルポートが複数表示される場合は |
実行の様子
書き込みが完了したら Wio LTE を「通常モード」にします。すると Wio LTE に書き込んだプログラムが実行されます。
Wio LTE 上の LED が点灯したら成功です。
以上で Wio LTE 開発環境を Arduino IDE への追加するハンズオンは終了です。