秋月の1.54インチ240×240 LCDモジュールをSTM32で使ってみた

液晶モジュールに文字を表示しているところ 電子工作

秋月電子で売られている1.54インチで240×240ドットのLCDモジュールをSTM32のNucleoで動かしてみました。

LCDモジュールは1.54インチ、240×240ドットというスペックにしては比較的安く750円です。
https://akizukidenshi.com/catalog/g/g131019

使用したマイコンはNucleo F103RBというもので安くベーシックな機能のマイコン STM32F103が搭載されています。
https://akizukidenshi.com/catalog/g/g107724

開発環境はSTM32CubeIDEを使用します。

液晶の制御には、Floyd-Fish さんが公開している ST7789-STM32 ライブラリを使わせてもらいました。ライセンスは GPL-3.0 です。https://github.com/Floyd-Fish/ST7789-STM32

結線

それではさっそくマイコンと液晶モジュールを結線していきましょう。
秋月電子の商品ページにあるデータシートを見てピンの種類を確認します。

GNDとVCCはマイコンに接続します。VCCはマイコンの3.3Vピンに配線しました。
注意点として、今回の液晶モジュールは電源電圧の最大が3.3Vになっているので本来であれば3.0Vのような電源を用意して給電する方がよく、マイコンの3.3Vピンにつなぐのは定格ギリギリのリスクの高い状態です。
今回は試しにそのままつないでみましたが、3.3Vで問題なく動きました。

次に信号線をつないでいきます。今回のモジュールは通信方式が4線式SPI通信ですがモジュールからマイコンに送る信号はないのでSCK, MOSI, CSの3つだけ配線します。
3: SCLにSCKを
4: SDAにMOSIを
7: CSにCSを
それぞれつなぎます。
SCKとMOSIはSPI1のピンで、PA5とPA7です。CSはSPIの機能は使わず、GPIOのPB10をソフトウェアで操作します。

残りは制御のピンをつなぎます。
5: RESはリセット信号でマイコンの適当なGPIOに
6: DCはデータとコマンドの切り替えをするピンでこちらもマイコンの適当なGPIO
にそれぞれつなぎます。
RESはPA10、DCはPB5にしました。

8: BLKはバックライトの制御ピンで、Hにすると点灯します。今回はPB4につないで、起動時にHにしてそのまま点灯させています。

結線をまとめると次のとおりです。CubeIDEのピン配置の画面も載せます。

STM32CubeIDEのピン配置の画面
液晶のピンSTM32のピン備考
1: GNDGND
2: VCC3V33.3Vで動作
3: SCLPA5SPI1_SCK
4: SDAPA7SPI1_MOSI
5: RESPA10GPIO出力
6: DCPB5GPIO出力
7: CSPB10GPIO出力(ソフトウェア制御)
8: BLKPB4GPIO出力(起動時にH)

実際に配線したところです。

液晶モジュール側の配線
Nucleoの信号ピン側の配線
Nucleoの電源ピン(3V3とGND)側の配線

SPIの設定

STM32CubeIDEで、SPI1を次のように設定しました。他のマイコンで試すときも、SPIの設定は同じ考え方で合わせられます。

STM32CubeIDEのSPI1のパラメータ設定の画面
項目設定意味
ModeFull-Duplex Masterマイコンが親(マスター)になる。送受信できる設定
Hardware NSS SignalDisableCSはSPIの機能ではなく、GPIOで操作する
Frame FormatMotorola標準的なSPIの形式
Data Size8 bit1回の通信は8ビット
First BitMSB First上位のビットから送る
Clock Polarity (CPOL)Low通信していないときのクロックはL
Clock Phase (CPHA)1 Edgeクロックの最初の変化でデータを読む(モード0)
NSS Signal TypeSoftwareCSは自分で(GPIOで)操作する
Baud Rate Prescaler464MHzを4分周して、16Mbit/s
  • SPI1のMISO(PA6)も自動で割り当てられていますが、液晶からマイコンに送る信号はないので、配線していません。
  • システムクロックは64MHzです。PLLで作っています。
  • ST7789はモード0で動きました。
  • CS、DC、RES、BLKは、GPIOの出力に設定しています。デバッグはSWDです。

ライブラリの設定は、st7789.hで次のようにしました。設定の行だけ抜き出しています。

/* choose whether use DMA or not */
//#define USE_DMA

/* Choose a type you are using */
//#define USING_135X240
#define USING_240X240
//#define USING_170X320

/* Choose a display rotation you want to use: (0-3) */
//#define ST7789_ROTATION 0
//#define ST7789_ROTATION 1
#define ST7789_ROTATION 2
//#define ST7789_ROTATION 3
項目設定意味
画面サイズUSING_240X240240×240ドットの液晶を使う。ほかの2つ(135×240、170×320)はコメントアウト
向きST7789_ROTATION 2向きは0〜3から選ぶ。240×240では、通常これを使う(ファイルのコメントより)
DMAUSE_DMA をコメントアウトDMAは使わない

プログラム

main.cに書いたのは、ライブラリを呼び出す前の初期化と、ループの中の呼び出しだけです。

#include "st7789.h"
int main(void)
{
  // 省略(HAL_Init、SystemClock_Config、MX_GPIO_Init、MX_SPI1_Init など)

  /* USER CODE BEGIN 2 */
  HAL_GPIO_WritePin(GPIOA, GPIO_PIN_10, GPIO_PIN_SET);  // Reset: H
  HAL_Delay(1);
  HAL_GPIO_WritePin(GPIOB, GPIO_PIN_4, GPIO_PIN_SET);   // Back Light: H
  HAL_GPIO_WritePin(GPIOB, GPIO_PIN_10, GPIO_PIN_SET);  // CS: H
  HAL_GPIO_WritePin(GPIOB, GPIO_PIN_5, GPIO_PIN_SET);   // DC: H
  unsigned char buf[8] = {0};
  HAL_SPI_Transmit(&hspi1, buf, 1, 100);
  HAL_Delay(50);
  ST7789_Init();
  /* USER CODE END 2 */

  while (1) {
    ST7789_Test();
    HAL_Delay(500);
  }
}

動かしてみる

ST7789_Test() は、画面を色で塗りつぶして、文字や図形を順に表示します。

液晶モジュールが画面全体を色で塗りつぶしているところ

まずは画面全体を、1色で塗りつぶします。

液晶モジュールに文字を表示しているところ

文字は、大きさと色を変えて表示できます。「Font test.」と「Hello Steve!」を表示しているところです。

液晶モジュールに図形を表示しているところ

図形は、赤く塗りつぶした画面に、四角を描いています。

ライブラリに入っているサンプル画像(128×128ドット)も表示できました。

液晶モジュールにライブラリのサンプル画像を表示しているところ

最後に、配線と基板の全体が分かる写真を載せます。画面は小さく見えますが、1.54インチあります。

液晶モジュールにサンプル画像を表示しているところ(配線と基板全体)
液晶モジュールに文字を表示しているところ(配線と基板全体)
液晶モジュールに図形を表示しているところ(配線と基板全体)

まとめ

秋月電子の750円の1.54インチ液晶を、Nucleo F103RBにつないで、文字と図形と画像を表示できました。電源は3.3Vのままで、問題なく動きました。

コメント