Seeed Studio Round Display for XIAO 入門ガイド

はじめに
Seeed Studio Round Display for XIAOは、すべてのXIAO開発ボードと互換性のある拡張ボードです。片面に完全に覆われたタッチスクリーンを搭載し、39mmディスクとして設計されています。コンパクトなサイズの中にオンボードRTC、充電チップ、TFカードスロットを内蔵しており、スマートホーム、ウェアラブルデバイスなどのインタラクティブディスプレイに最適です。
REV | 説明 | 日付 | 担当者 |
---|---|---|---|
v1.0 | 初期バージョン | 2023/1/29 | Linus.Liao |
v1.1 | 1.リチウムバッテリー充電ICの変更 2.A0とD6にスイッチを追加 | 2023/4/7 | Linus.Liao |
仕様
項目 | 詳細 |
---|---|
電源供給 | USB Type-C: 5V @35 mA バッテリー充電: 3.7V @37mA |
充電電流 | ~ 485 mA |
拡張可能メモリ | 最大32GB FATまでのTFカードスロット |
スクリーン | 1.28インチタッチスクリーン 240×240解像度 65K色 |
その他の外部機器 | JST 1.25コネクタ |
寸法 | 39mm x 39mm |
機能
- 静電容量式タッチスクリーン拡張ボード: 1.28インチ円形、240×240解像度、65K色のディスプレイで、鮮明でカラフルな画像表示を提供
- 高い互換性: すべてのXIAOシリーズ製品と高い互換性を持ち、現在のプロジェクトに簡単に統合可能
- 豊富な周辺機能: オンボードRTC、バッテリー充電チップ、TFカードスロット、JST 1.25コネクタを搭載し、すべてがコンパクトなサイズに収められています
- 腕時計サイズのデザイン: 39mm円形デザインで、ウェアラブルおよびスペースが限られたプロジェクトに適しています
- プラグアンドプレイ: すべてのピンが引き出されており、はんだ付けは不要です
ハードウェア概要
開始する前に、以下の画像を参照してRound Displayのピン設計を理解し、Round Displayの機能の理解を促進できます。

2023年4月7日以降、改良されたRound Displayには、画面のバックライトとバッテリー電圧読み取りを制御する2ビットスイッチが追加されました。ユーザーがピンを使用するか解放するかを自由に選択できます。詳細についてはこちらをクリックしてお読みください。

はじめに
ハードウェアの準備
Round Displayの全機能を活用し、優れた体験を得たい場合は、Round Displayのマザーボードとして当社のXIAOシリーズを購入することを強くお勧めします。
XIAO SAMD21、RP2040、RA4M1は、メモリ不足により円形スクリーンと互換性がない場合があります。
Seeed Studio XIAO nRF52840 (Sense) | Seeed Studio XIAO ESP32C3 | Seeed Studio XIAO ESP32S3 (Sense) | Seeed Studio XIAO ESP32C6 |
---|---|---|---|
![]() | ![]() | ![]() | ![]() |
Round Displayの背面にあるピンの列は、XIAOシリーズ用に設計されています。XIAOをお持ちの場合、追加のケーブルを準備する必要はありません。XIAOのピンを合わせて、Round Displayに直接差し込むだけです。

XIAOを接続する際は、XIAOのType-Cコネクタが Round Displayの外側を向くようにしてください。誤って極性を逆にしてしまっても、あまり心配する必要はありません。Round Displayには電源保護回路があり、簡単には損傷しませんが、長時間逆接続のままにしておくことはお勧めしません。
Round Displayの推奨向きは、Round Displayに向かって、XIAOのType-Cコネクタが右側を向くようにすることです。これにより、Round Displayのオン/オフボタンが左下角に位置します。

ソフトウェアの準備
Round Displayを使用するには、XIAOシリーズをプログラムする必要があります。推奨されるプログラミングツールはArduino IDEで、XIAOのArduino環境を設定し、オンボードパッケージを追加する必要があります。
Arduinoを初めて使用する場合は、Getting Started with Arduinoを参照することを強くお勧めします。
ステップ1. お使いのオペレーティングシステムに応じて、Arduino IDEの安定版をダウンロードしてインストールします。
ステップ2. Arduinoアプリケーションを起動します。
ステップ3. 使用するXIAO用にArduino IDEを設定します。
-
後のルーチンでSeeed Studio XIAO RP2350を使用したい場合は、**このチュートリアル**を参照して追加を完了してください。
-
後のルーチンでSeeed Studio XIAO nRF52840を使用したい場合は、**このチュートリアル**を参照して追加を完了してください。
-
後のルーチンでSeeed Studio XIAO ESP32C3を使用したい場合は、**このチュートリアル**を参照して追加を完了してください。
-
後のルーチンでSeeed Studio XIAO ESP32C6を使用したい場合は、**このチュートリアル**を参照して追加を完了してください。
-
後のルーチンでSeeed Studio XIAO ESP32S3を使用したい場合は、**このチュートリアル**を参照して追加を完了してください。
ステップ4. グラフィックスライブラリとスクリーンドライバーライブラリのインストール
Round Displayを使用するには、事前に2つのライブラリをインストールする必要があります。1つはRound Displayデバイスドライバーライブラリで、デバイスのスクリーンとタッチ機能を駆動するために使用されます。もう1つはグラフィックス表示ライブラリで、グラフィックスを描画するための非常に一般的なインターフェースを提供します。
- GitHubからSeeed_Arduino_RoundDisplayライブラリをダウンロードします:
- GitHubからSeeed_GFXライブラリをダウンロードします:
- Arduino IDEでZIPファイルを追加してライブラリをインストールします。Sketch > Include Library > Add .ZIP Libraryに移動し、ダウンロードしたZIPファイルを選択します。
以前にTFT_eSPIライブラリをインストールしている場合、競合を避けるために、ArduinoライブラリフォルダからTFT_eSPIライブラリを一時的に削除または名前を変更する必要があるかもしれません。Seeed_GFXは追加機能を持つTFT_eSPIのフォークです。
Arduino ライブラリ概要
上記のチュートリアルからおそらくわかるように、Round Display は主に LVGL、TFT_eSPI、Arduino GFX ライブラリを使用しています。スペースの都合上、ダイアルの描画例を使って LVGL と TFT_eSPI ライブラリの使用方法を別々に紹介します。
-
TFT_eSPI ライブラリのインターフェースと使用方法については、こちら をクリックして学習できます。
-
LVGL ライブラリのインターフェースと使用方法については、こちら をクリックして学習できます。
-
Arduino GFX ライブラリのインターフェースと使用方法については、こちら をクリックして学習できます。
Round Display を点灯させる
デモ 1: Arduino Life - Round Display で Seeed_GFX ライブラリを使用する方法
Seeed_GFX ライブラリからサンプルスケッチを開きます:File > Seeed_GFX > Examples > Round Display > Arduino_Life
Arduino スケッチと同じフォルダに driver.h
という名前の新しいファイルを作成します。サンプルタブの横にある矢印をクリックして「New Tab」を選択してください。
新しいファイルに driver.h
という名前を付けます。

Seeed GFX Configuration Tool にアクセスし、画像に示すように「TRMNL 7.5" (OG) DIY Kit」を選択します。

生成されたコードをコピーして、作成した driver.h
ファイルに貼り付けます。コードは次のようになります:
#define BOARD_SCREEN_COMBO 501 // Round Display for Seeed Studio XIAO (GC9A01)
今すぐサンプルをTRMNL DIYキットにアップロードして、ePaperディスプレイの動作を確認できます!

以降のすべての画面のコードには、使用する画面の種類を選択するために使用されるdriver.hファイルが必要であることに注意してください。
デモ2: TFTクロック
Demo1を参照して、.ino
ファイルと同じディレクトリに新しいdriver.h
ファイルを作成し、以下のコードを保持してください:#define BOARD_SCREEN_COMBO 501
ラウンドディスプレイのRTC機能を使用する必要があるため、I2C BM8563 RTCライブラリも検索してインストールする必要があります。

ハードウェアとソフトウェアの準備ができたら、最初のサンプルプログラムのアップロードを開始します。このサンプルプログラムは、ラウンドディスプレイのRTCクロックが正常に動作しているかどうかを確認するために使用できます。このデモは少量のメモリしか必要としないため、すべてのXIAOモデルに適しています。
このデモを変更してより複雑な表示を実装したい場合は、使用しているXIAOのメモリサイズに注意してください。具体的なサイズは、そのXIAOの紹介ページで確認できます。
このサンプルプログラムは、Arduino IDEのFile -> Examples -> Seeed Arduino Round display -> TFT_Clockで見つけることができます。

使用しているXIAOとXIAOが接続されているポート番号を選択し、コンパイルしてアップロードするだけです。
ラウンドディスプレイのスイッチがON位置に切り替わっていることを確認してください。

プログラムが正常に実行されると、以下の効果が表示されます。

デモ3: ハードウェアテスト
Demo1を参照して、.ino
ファイルと同じディレクトリに新しいdriver.h
ファイルを作成し、以下のコードを保持してください:#define BOARD_SCREEN_COMBO 501
HardwareTestデモは少し複雑で、より大きなメモリ容量を占有するため、一部のXIAOモデルではメモリ不足により正常に実行できない場合があります。TFTライブラリとArduino GFXライブラリを使用して、参考用のテスト表を作成しました。
TFTライブラリ | Arduino GFX | |
---|---|---|
XIAO SAMD21 | ❌ | ❌ |
XIAO RP2040 | ❌ | ❌ |
XIAO RA4M1 | ❌ | ❌ |
XIAO nRF52840 non mbed version | ✅ | ❌ |
XIAO nRF52840 mbed version | ❌ | ✅ |
XIAO ESP32C3 | ✅ | ✅ |
XIAO ESP32C6 | ✅ | ❌ |
XIAO ESP32S3 | ✅ | ✅ |
このサンプルプログラムは、Round DisplayのRTCクロック、SDカード、タッチ機能が正常に動作しているかどうかを確認するために使用できます。
Round Displayでは RTC 機能を使用する必要があるため、I2C BM8563 RTC ライブラリも検索してインストールする必要があります。

このサンプルプログラムは、Arduino IDEの File -> Examples -> Seeed Arduino Round display -> HardwareTest で見つけることができます。

使用しているXIAOとXIAOが接続されているポート番号を選択し、コンパイルしてアップロードするだけです。
Round Displayのスイッチが ON 位置に切り替わっていることを確認してください。

プログラムが正常に実行されると、以下のような効果が表示されます。

このサンプルプログラムは、RTC機能を含む拡張ボードのすべての機能項目をテストします。I2C BM8563 RTCライブラリがインストールされていない場合、エラーが報告される可能性があります。その場合は、関数 lv_hardware_test()
をコメントアウトすることで、SDカードの機能検出もオフになります。
キャリブレーションファームウェアアップデート
タッチが時々反応しない場合は、以下の手順に従って画面のキャリブレーションファームウェアを更新できます。
- このリンクからコードをダウンロードします

- 同じディレクトリに配置し、このファームウェアを実行します。

- シリアルモニターを開くと、以下の画像のような成功メッセージが表示されます。これは更新が成功したことを意味し、プログラムをアップロードして試すことができます!

トラブルシューティング
Q1: プログラムをアップロードした後、ディスプレイに何も表示されないのはなぜですか?
A: Round Displayのスイッチがオンになっていることを確認してください。XIAO ESP32C3 を使用している場合は、プログラムをアップロードした後にリセットを押して動作させる必要がある場合もあります。
Q2: Seeed Studio XIAO ESP32S3 Senseをこの拡張画面に接続したい場合、2つのTFカードスロットで競合が発生しますか?
A: これは競合を引き起こしません。異なるSDカードスロットはチップセレクトによって制御されます。Sense上のmicroSDカードスロットを使用したい場合、チップセレクトピンは 21 にする必要があり、Round Display上のmicroSDカードスロットを使用したい場合、チップセレクトピンは D2 にする必要があります。
S3 Senseカメラチュートリアルには、ハードウェアとmicroSDカードの両方を使用する例があります。
Q3: XIAO RP2040 でRound DisplayのHardwareTestコードを使用すると、非常に奇妙なC++エラーが発生するのはなぜですか?
A: これは、XIAO RP2040 に適切なコンパイルオプションを選択していないことが原因である可能性があります。以下の図を参考に設定し、プログラムを再アップロードしてください。

Resources
- [PDF] 充電IC データシート
- [PDF] ETA3410 データシート
- [PDF] RTC PCF8563 データシート
- [PDF] 1.28'' a-Si TFT液晶ディスプレイ データシート
- [PDF] Seeed Studio Round Display for XIAO 回路図
- [PDF] Seeed Studio Round Display for XIAO 回路図 v1.1
- [PDF] GJX0128A4-15HY データシート
- [ZIP] Seeed Studio Round Display for XIAO 回路図&PCB
- [ZIP] Seeed Studio Round Display for XIAO 回路図&PCB v1.1
- [3DM] Round Display for XIAOの3Dモデル
- [STL] Round Display用シェルの3Dモデル図
- [STL] Seeed Studio XIAO ESP32 S3 Sense ラウンドスクリーン付きケース
Tech Support & Product Discussion
私たちの製品をお選びいただき、ありがとうございます!私たちは、お客様の製品体験が可能な限りスムーズになるよう、さまざまなサポートを提供しています。異なる好みやニーズに対応するため、複数のコミュニケーションチャンネルを用意しています。