Skip to main content

概要

この Wiki では、Wio Terminal のワイヤレスコア Realtek RTL8720 の最新ファームウェアを更新する方法と、Wio Terminal にワイヤレス接続を有効にするためのすべての依存ライブラリをインストールする方法を紹介します。

note

Wi-Fi ソフトウェアを新しい eRPC 構造に移行しました。この構造はより安定しており、Bluetooth と同時に動作することができます！eRPC Wi-Fi ファームウェアと関連ライブラリの更新手順に従ってください！

ワイヤレスコアファームウェアの更新​

まず、Wio Terminal の Realtek RTL8720 ワイヤレスコアのファームウェアを更新する必要があります。これは重要であり、例を進める前に最新のファームウェアに更新する必要があります。

attention icon

注意

使用前に Wi-Fi コアを更新してください！

ステップ 1 - 初期工場ファームウェアの消去​

初めて Wio Terminal を手にした場合、初期の RTL8720 ファームウェアを消去し、最新のファームウェアをフラッシュする必要があります。このために ambd_flash_tool というツールを用意しています。このツールを実行すると、まず SAMD51 から RTL8720 へのシリアル接続を有効にし、RTL8720 にファームウェアをインストールできるようにします。これは RTL8720 と直接通信できないためです。その後、このツールを使用して RTL8720 上の既存のファームウェアを消去し、最新のファームウェアをフラッシュすることができます。

注意: 初期工場ファームウェアを消去するのは最初の一回だけです。その後は、新しいファームウェアをフラッシュして既存のファームウェアを上書きすることができます。

Windowsの場合​

  • ステップ 1: PC 上で Windows PowerShell を開き、以下のコマンドを実行してフラッシュツールをダウンロードします。
cd ~
git clone https://github.com/Seeed-Studio/ambd_flash_tool

注意: cd ~ コマンドはホームディレクトリに移動し、git clone コマンドは GitHub からリポジトリをダウンロードします。

  • ステップ 2: ambd_flash_tool ディレクトリに移動します。
cd ambd_flash_tool

  • ステップ 3: Wio Terminal を PC に接続して電源を入れます。

  • ステップ 4: 以下のコマンドを実行して初期ファームウェアを消去します。

.\ambd_flash_tool.exe erase

注意: 初期消去プロセスには時間がかかる場合があります。ウィンドウを閉じずにお待ちください。

Wio Terminal の接続されたシリアルポートは自動的に検出されます！

注意: 使用方法のヘルプを開きたい場合は、.\ambd_flash_tool.exe を実行してください。

pir

Mac/Linuxの場合​

  • ステップ 1: Mac/Linux 上で Terminal を開き、以下のコマンドを実行してフラッシュツールをダウンロードします。
cd ~
git clone https://github.com/Seeed-Studio/ambd_flash_tool

注意: cd ~ コマンドはホームディレクトリに移動し、git clone コマンドは GitHub からリポジトリをダウンロードします。

  • ステップ 2: ambd_flash_tool ディレクトリに移動します。
cd ambd_flash_tool

  • ステップ 3: Wio Terminal を PC に接続して電源を入れます。

  • ステップ 4: 以下のコマンドを実行して初期ファームウェアを消去します。

python3 ambd_flash_tool.py erase

注意: Mac/Linux に Python 3 がインストールされていることを確認してください。スクリプトはすべての依存ライブラリを自動的にダウンロードします。

場合によっては、PC に Python 3 のみがインストールされている場合があります。その場合は python3 ambd_flash_tool.py を python ambd_flash_tool.py に置き換えてください。

注意: 初期消去プロセスには時間がかかる場合があります。ウィンドウを閉じずにお待ちください。

Wio Terminal の接続されたシリアルポートは自動的に検出されます！

注意: 使用方法のヘルプを開きたい場合は、python3 ambd_flash_tool.py を実行してください。

pir

ステップ 2 - 最新ファームウェアのフラッシュ​

Windowsの場合​

  • ambd_flash_tool ディレクトリ内にいる間に、以下のコマンドを実行して RTL8720 に 最新ファームウェア をフラッシュします。
.\ambd_flash_tool.exe flash

Mac/Linuxの場合​

  • ambd_flash_tool ディレクトリ内にいる間に、以下のコマンドを実行して RTL8720 に 最新ファームウェア をフラッシュします。
python3 ambd_flash_tool.py flash

古いファームウェアのフラッシュ (追加 - スキップ可能)​

古いファームウェアリリースでコードをテストしたい場合は、以下の手順に従うことで可能です。ただし、最新のファームウェアで始めたい場合は、上記のステップ (ステップ 2) に従い、このステップをスキップしてください。

Windowsの場合​

  • ステップ 1: GitHub 上の RTL8720 Firmware リポジトリにアクセスします。

  • ステップ 2: 任意の リリースバージョン を選択し、xxx-seeed-ambd-firmware-rpc-vxxx.zip をクリックして .zip ファイル としてダウンロードします。

  • ステップ 3: 前述のように Windows PowerShell を使用して ambd_flash_tool ディレクトリに移動し、以下のコマンドを実行します。

.\ambd_flash_tool.exe flash -d [RTL8720-firmware-path]

注意: [RTL8720-firmware-path] を上記でダウンロードした RTL8720 のパスに置き換えてください。このフォルダには以下の3つのファイルが含まれている必要があります: km0_boot_all.bin, km0_km4_image2.bin, km4_boot_all.bin

すべてが正常に進めば、成功メッセージが表示されるはずです。これで RTL8720 のファームウェアを RTL8720 コアに書き込むことができました！

Mac/Linuxの場合​

  • ステップ 1: GitHubの RTL8720 Firmware リポジトリにアクセスします。

  • ステップ 2: 任意のリリースバージョンを選択し、xxx-seeed-ambd-firmware-rpc-vxxx.zip をクリックして .zip ファイル としてダウンロードします。

  • ステップ 3: 前述のように terminal を使用して ambd_flash_tool ディレクトリに移動し、以下のコマンドを実行します。

python3 ambd_flash_tool.py flash -d [RTL8720-firmware-path]

注意: [RTL8720-firmware-path] を上記でダウンロードした RTL8720 のパスに置き換えてください。このフォルダには以下の3つのファイルが含まれている必要があります: km0_boot_all.bin, km0_km4_image2.bin, km4_boot_all.bin

すべてが正常に進めば、成功メッセージが表示されるはずです。これで RTL8720 のファームウェアを RTL8720 コアに書き込むことができました！

Arduino IDEでRTL8720ファームウェアバージョンを確認する​

上記のファームウェアをインストールした後、以下のコードを Arduino IDE を使用して Wio Terminal にアップロードすることで、ファームウェアが正しくインストールされているか確認できます。

#include "rpcWiFi.h"
#include <erpc/erpc_port.h>
 
void setup() {
    Serial.begin(115200);
    while(!Serial); // シリアルモニタが開くまで待機
    char* version = rpc_system_version();
    Serial.print("RTL8720 Firmware Version: ");
    Serial.println(version);
    erpc_free(version);
}
 
void loop() {
}

シリアルモニタ を開くと、ファームウェアバージョン が表示されるはずです。

Seeed SAMD ArduinoCoreの更新​

note

Seeed SAMD ArduinoCore を最新バージョン (1.8.1) に更新してください！

  • ステップ 1: Arduino IDE を開き、ツール -> ボード -> ボードマネージャ をクリックし、検索ボックスに Wio Terminal を入力します。

  • ステップ 2: 最新バージョン (1.8.1) がインストールされていることを確認します。インストールされていない場合は、バージョンを選択 ドロップダウンメニューをクリックし、最新バージョンを選択して インストール をクリックします。

pir

Seeed SAMD ArduinoCore のソースコードは こちら で確認できます。

ライブラリのインストール​

ワイヤレス接続にはいくつかの Arduino ライブラリが必要です。Wio Terminal 用のワイヤレス関連ライブラリはすべて Arduino Library Manager に含まれています。そのため、Arduino IDE 内で Arduino Library Manager を開き、必要なライブラリを検索して簡単にインストールすることができます！

Arduino Library Managerからライブラリをインストールする方法​

  • ステップ 1: Arduino IDE を開き、スケッチ -> ライブラリを含める -> ライブラリを管理... をクリックします。

  • ステップ 2: 必要なライブラリの名前を入力し、ドロップダウンメニューから最新バージョンを選択します（利用可能な場合）。

  • ステップ 3: インストール をクリックします。

pir

Wi-Fi用に必要なライブラリ​

Wi-Fi を使用するために、Wio Terminal で以下のライブラリが必要です。Arduino Library Manager の検索ボックスにライブラリ名を入力して検索してください。

利便性のため、すべてのライブラリをまとめています。そのため、将来のドキュメントや現在のドキュメントの更新では、rpcwifi をインストールするだけで、Wi-Fi に依存するすべてのライブラリがインストールされます。

pir

リリース​

更新日作成者詳細
10.12BILL と LAKSHANTHA必要なライブラリをすべてまとめて組み立てる

技術サポート & 製品ディスカッション​

技術的な問題がある場合は、問題を私たちのフォーラムに投稿してください。
弊社製品をお選びいただきありがとうございます！製品の使用体験ができるだけスムーズになるよう、さまざまなサポートを提供しています。異なる好みやニーズに対応するため、いくつかのコミュニケーションチャネルを用意しています。

Loading Comments...