Windows/MacOSでWio Terminalを使用してHMIディスプレイを構築する
この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues
Windows/MacOSでWio Terminalを使用してHMIディスプレイを構築する

このWikiでは、Wio Terminalを使用して、Windows/Linux/MacOS上で動作するユーザーモードSDKを利用してHMIディスプレイを構築する方法を紹介します。これにより、Wio Terminalの産業用途での可能性が広がります!
Raspberry PiとWio Terminalを組み合わせてHMIディスプレイとして使用したい場合は、こちらのWikiをご覧ください。
必要なハードウェア
Wio Terminal ファームウェア
まず、PCを使用してWio TerminalにArduinoプログラムをアップロードする必要があります。
- Seeed_Arduino_USBDISPライブラリをこちらからダウンロードしてください。
以下の2つの例が含まれています:NullFunctional
と USBDisplayAndMouseControl
:
- Wio Terminalの画面リフレッシュレートを高めたい場合は、
NullFunctional
をWio Terminalにアップロードしてください。 - Wio TerminalをUSBマウスとしても使用したい場合は、
USBDisplayAndMouseControl
をWio Terminalにアップロードしてください。
注意事項を必ずお読みください。ユーザーモードSDKでは、USBDISP().begin(true);
が USBDISP().begin(true, true);
に変更されます。
uf2
メソッド
利便性のために、Wio Terminalのファームウェアをアップロードするためのuf2
メソッドも提供しています。以下からuf2
ファイルをダウンロードしてください。
NullFunctional の
uf2
ファイルをダウンロード。USBDisplayAndMouseControl の
uf2
ファイルをダウンロード。
電源スイッチを素早く2回スライドさせてブートローダーモードに入ります。詳細についてはこちらも参照してください。
PCにArduino
という名前の外部ドライブが表示されます。ダウンロードしたuf2
ファイルをArduino
ドライブにドラッグしてください。
ホストデバイスのファームウェア
今回はホストデバイスがPCになります。ユーザーモードSDKを使用してWio TerminalをHMIディスプレイとして使用する方法を見ていきましょう!
MacOS/Linux OS - C++ SDK
- ファームウェアリポジトリをダウンロードします:
cd ~
git clone https://github.com/Seeed-Studio/seeed-linux-usbdisp.git
- ユーザーモードSDKのパスに移動します:
cd ~/seeed-linux-usbdisp/drivers/usermode-sdk/rpusbdisp-drv/src
rpusbdisp.cc
を開き、Wio Terminalのファームウェア(NullFunctionalまたはUSBDisplayAndMouseControl)に応じてマクロを定義します。使用しているものをアンコメントしてください:

- ユーザーモードSDKのパスに戻ります:
cd ~/seeed-linux-usbdisp/drivers/usermode-sdk
- ドライバを作成してビルドします:
make
libusb
などの依存ライブラリが必要になる場合があります。MacOSではbrew
を、Linux OSではapt-get
を使用してインストールできます。
- ビルドディレクトリに移動します:
cd ~/seeed-linux-usbdisp/drivers/usermode-sdk/build/
- デモを実行します:
sudo ./rpusbdispdemo --demo 1

Wio Terminalが表示を開始し、グラフィックが描画されるのが確認できます。このソースコードは以下にあります:seeed-linux-usbdisp/drivers/usermode-sdk/demo/src/main.cc
。
複数画面
このC++ SDKは複数画面(複数のWio Terminal)もサポートしています。2画面を使用する場合は、デモ2を実行してください:
sudo ./rpusbdispdemo --demo 2
注意: 最大4画面までのデモが提供されています。アプリケーションの参考としてソースコードを確認してください。
Windows - Python SDK
Windowsでは、Python上でユーザーモードSDKを実行できます!まず、Pythonをインストールし、依存ライブラリをインストールしてください:
Pythonはクロスプラットフォームであり、このデモはWindows/Linux/MacOSのすべてで実行可能です。
pip3 install pyusb
- Pythonデモのパスに移動します:
cd ~/seeed-linux-usbdisp/drivers/python-demo/
simple-test.py
を開き、Wio Terminal内のファームウェアに応じて正しいマクロを定義し、保存します。

- Pythonデモを実行します:
python3 simple-test.py

複数画面
このPython SDKも複数画面(複数のWio Terminal)をサポートしています。USBDisplay.py
を参考にしてください。
この例では、4つのWio Terminalをディスプレイとして使用しており、以下のような形式になっています:
devices = list(usb.core.find(find_all=True, idVendor=0x2886, idProduct=0x802D))
dev1 = devices[0] # デバイス0
dev2 = devices[1] # デバイス1
dev3 = devices[2] # デバイス2
dev4 = devices[3] # デバイス3
シンプルデモ
この例では、Python を使用して PC 側から Wio Terminal に画像を簡単に転送します。
- デモのパスに移動します:
cd ~/seeed-linux-usbdisp/drivers/python-demo/
image.jpg
をダウンロードし、image-test.py
と同じ場所に保存します。
注意: 必ず Wio Terminal のファームウェアに対応するマクロを選択してください。そうしないとエラーが発生します。
- デモを実行します:
python3 image-test.py

リソース
技術サポート & 製品ディスカッション
弊社製品をお選びいただきありがとうございます!製品の使用体験がスムーズになるよう、さまざまなサポートを提供しています。異なる好みやニーズに対応するため、いくつかのコミュニケーションチャネルをご用意しています。