Skip to main content

Seeed Studio Round Display for XIAO 入門ガイド

はじめに

Seeed Studio Round Display for XIAOは、すべてのXIAO開発ボードと互換性のある拡張ボードです。片面に完全に覆われたタッチスクリーンを搭載し、39mmディスクとして設計されています。コンパクトなサイズの中にオンボードRTC、充電チップ、TFカードスロットを内蔵しており、スマートホーム、ウェアラブルデバイスなどのインタラクティブディスプレイに最適です。

REV説明日付担当者
v1.0初期バージョン2023/1/29Linus.Liao
v1.11.リチウムバッテリー充電ICの変更
2.A0とD6にスイッチを追加
2023/4/7Linus.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シリーズを購入することを強くお勧めします。

tip

XIAO SAMD21、RP2040、RA4M1は、メモリ不足により円形スクリーンと互換性がない場合があります。

Seeed Studio XIAO nRF52840 (Sense)Seeed Studio XIAO ESP32C3Seeed Studio XIAO ESP32S3 (Sense)Seeed Studio XIAO ESP32C6

Round Displayの背面にあるピンの列は、XIAOシリーズ用に設計されています。XIAOをお持ちの場合、追加のケーブルを準備する必要はありません。XIAOのピンを合わせて、Round Displayに直接差し込むだけです。

caution

XIAOを接続する際は、XIAOのType-Cコネクタが Round Displayの外側を向くようにしてください。誤って極性を逆にしてしまっても、あまり心配する必要はありません。Round Displayには電源保護回路があり、簡単には損傷しませんが、長時間逆接続のままにしておくことはお勧めしません。

Round Displayの推奨向きは、Round Displayに向かって、XIAOのType-Cコネクタが右側を向くようにすることです。これにより、Round Displayのオン/オフボタンが左下角に位置します。

ソフトウェアの準備

Round Displayを使用するには、XIAOシリーズをプログラムする必要があります。推奨されるプログラミングツールはArduino IDEで、XIAOのArduino環境を設定し、オンボードパッケージを追加する必要があります。

tip

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つはグラフィックス表示ライブラリで、グラフィックスを描画するための非常に一般的なインターフェースを提供します。

  1. GitHubからSeeed_Arduino_RoundDisplayライブラリをダウンロードします:

  1. GitHubからSeeed_GFXライブラリをダウンロードします:

  1. Arduino IDEでZIPファイルを追加してライブラリをインストールします。Sketch > Include Library > Add .ZIP Libraryに移動し、ダウンロードしたZIPファイルを選択します。
note

以前にTFT_eSPIライブラリをインストールしている場合、競合を避けるために、ArduinoライブラリフォルダからTFT_eSPIライブラリを一時的に削除または名前を変更する必要があるかもしれません。Seeed_GFXは追加機能を持つTFT_eSPIのフォークです。

Arduino ライブラリ概要

上記のチュートリアルからおそらくわかるように、Round Display は主に LVGLTFT_eSPIArduino GFX ライブラリを使用しています。スペースの都合上、ダイアルの描画例を使って LVGLTFT_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ディスプレイの動作を確認できます!

caution

以降のすべての画面のコードには、使用する画面の種類を選択するために使用されるdriver.hファイルが必要であることに注意してください。

デモ2: TFTクロック

caution

Demo1を参照して、.inoファイルと同じディレクトリに新しいdriver.hファイルを作成し、以下のコードを保持してください:#define BOARD_SCREEN_COMBO 501

tip

ラウンドディスプレイのRTC機能を使用する必要があるため、I2C BM8563 RTCライブラリも検索してインストールする必要があります。

ハードウェアとソフトウェアの準備ができたら、最初のサンプルプログラムのアップロードを開始します。このサンプルプログラムは、ラウンドディスプレイのRTCクロックが正常に動作しているかどうかを確認するために使用できます。このデモは少量のメモリしか必要としないため、すべてのXIAOモデルに適しています。

tip

このデモを変更してより複雑な表示を実装したい場合は、使用しているXIAOのメモリサイズに注意してください。具体的なサイズは、そのXIAOの紹介ページで確認できます。

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

使用しているXIAOとXIAOが接続されているポート番号を選択し、コンパイルしてアップロードするだけです。

ラウンドディスプレイのスイッチがON位置に切り替わっていることを確認してください。

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

デモ3: ハードウェアテスト

caution

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カード、タッチ機能が正常に動作しているかどうかを確認するために使用できます。

tip

Round Displayでは RTC 機能を使用する必要があるため、I2C BM8563 RTC ライブラリも検索してインストールする必要があります。

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

使用しているXIAOとXIAOが接続されているポート番号を選択し、コンパイルしてアップロードするだけです。

Round Displayのスイッチが ON 位置に切り替わっていることを確認してください。

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

note

このサンプルプログラムは、RTC機能を含む拡張ボードのすべての機能項目をテストします。I2C BM8563 RTCライブラリがインストールされていない場合、エラーが報告される可能性があります。その場合は、関数 lv_hardware_test() をコメントアウトすることで、SDカードの機能検出もオフになります。

キャリブレーションファームウェアアップデート

tip

タッチが時々反応しない場合は、以下の手順に従って画面のキャリブレーションファームウェアを更新できます。

  1. このリンクからコードをダウンロードします
  1. 同じディレクトリに配置し、このファームウェアを実行します。
  1. シリアルモニターを開くと、以下の画像のような成功メッセージが表示されます。これは更新が成功したことを意味し、プログラムをアップロードして試すことができます!

トラブルシューティング

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

Tech Support & Product Discussion

私たちの製品をお選びいただき、ありがとうございます!私たちは、お客様の製品体験が可能な限りスムーズになるよう、さまざまなサポートを提供しています。異なる好みやニーズに対応するため、複数のコミュニケーションチャンネルを用意しています。

Loading Comments...