Arduino(9) Adafruit_ST7735ライブラリの修正(aitendoの1.8型LCD用)

arduino08-03.jpg
Adafruit_ST7735ライブラリ+aitendo M-Z18SPI-2Pでgraphicstest。
画面右端と下端にゴミが出ています。Hの字の左端が切れています。

Adafruit_ST7735ライブラリでaitendo M-Z18SPI-2Pを制御すると、画面右端と下端にゴミが残り、画面左端が欠けてしまいます。
初期化時、initRのパラメータにINITR_GREENTABを指定するとこの現象は無くなりますが、その代わり色の配列がRGBではなくBGRになってしまいます。

ST7735ではMADCTLというコマンドが色表現のRGB/BGR指定を担っており、これをINITR_BLACKTABのときだけ違う値に設定しているのが関数initRの中の最後の部分です。

void Adafruit_ST7735::initR(uint8_t options) {
    commonInit(Rcmd1);
    if(options == INITR_GREENTAB) {
        commandList(Rcmd2green);
        colstart = 2;
        rowstart = 1;
    } else if(options == INITR_144GREENTAB) {
        _height = ST7735_TFTHEIGHT_144;
        commandList(Rcmd2green144);
        colstart = 2;
        rowstart = 3;
    } else {
        // colstart, rowstart left at default '0' values                        
        commandList(Rcmd2red);
    }
    commandList(Rcmd3);

      // if black, change MADCTL color filter      
         if (options == INITR_BLACKTAB) {
             writecommand(ST7735_MADCTL);
             writedata(0xC0);
         }

                tabcolor = options;
}

これをINITR_GREENTABでも実行するように変更すれば、色がRGBの並びになります。

ただし、本家のINITR_GREENTABが違う動作になるのも困るので、新しくINITR_BLUETABを定義しました。

まずAdafruit_ST7735.hに以下の定義を追加します。(赤字部分)

// some flags for initR() :(
#define INITR_GREENTAB 0x0
#define INITR_REDTAB   0x1
#define INITR_BLACKTAB   0x2
#define INITR_BLUETAB 0x3

#define INITR_18GREENTAB    INITR_GREENTAB
#define INITR_18REDTAB      INITR_REDTAB
#define INITR_18BLACKTAB    INITR_BLACKTAB
#define INITR_144GREENTAB   0x1

そして、Adafruit_ST7735.cppのinitR関数を修正し、BLUETABではGREENTABの初期化+BLACKTAB用追加コードを実行するようにします。

void Adafruit_ST7735::initR(uint8_t options) {
    commonInit(Rcmd1);
    if((options == INITR_GREENTAB) || (options == \
INITR_BLUETAB)) {
            commandList(Rcmd2green);
            colstart = 2;
            rowstart = 1;
        } else if(options == INITR_144GREENTAB) {
        _height = ST7735_TFTHEIGHT_144;
        commandList(Rcmd2green144);
        colstart = 2;
        rowstart = 3;
    } else {
        // colstart, rowstart left at default '0' values                        
        commandList(Rcmd2red);
    }
    commandList(Rcmd3);

    // if black, change MADCTL color filter                                     
    if ((options == INITR_BLACKTAB)|| (options == \
INITR_BLUETAB)) {
            writecommand(ST7735_MADCTL);
            writedata(0xC0);
        }

    tabcolor = options;
}

これで、ノイズなし、かつ正しい色での表示ができるようになります。
(もちろん、setup()の中でinitRの引数をINITR_BLUETABにする必要があります。)

なお、以下のページにST7735の仕様の解説があり、参考になります。

表示器 (ST7735B 1.8″ TFT SPI)

・修正後のライブラリ+aitendo M-Z18SPI-2Pでgraphicstest

arduino08-04.jpg
ゴミが消え、画面の左端が見えるようになりました。

Arduino(8) Arduino Pro Mini+aitendoの1.8型LCDでブロック崩し

aitendoの1.8インチSPI LCDがPro mini(3.3V/8MHz)で動作するようになったので、先日UNOで作成したブロック崩しを動かしてみました。

基本的には、画面解像度の違いへの対応と、LCD初期化の処理を若干変更するだけて対応できました。

解像度の違いへの対応は、拡大率の変更で行います。
以前使っていた液晶の解像度は240×320ピクセルでしたが、この液晶は解像度が128×160ピクセルです。
ブロック崩しは、論理的な解像度を30×40として作成していますので、座標値を4倍にすればこの液晶にフルスクリーンで表示できます。
(横方向は120ピクセルになるので、8ピクセル余ってしまいますが。)

LCD初期化処理は、Adafruit-TFTLibraryと今回使うAdafruit_ST7735でスケッチ例を見比べて、以下のように修正しました。

・includeするライブラリおよび信号線の定義
(当然ですね。)

#include <Adafruit_GFX.h>    // Core graphics library
#include <Adafruit_ST7735.h> // Hardware-specific library
#include <SPI.h>

#define TFT_CS     10
#define TFT_RST    9
#define TFT_DC     8
#define TFT_SCLK 13   // set these to be whatever pins you like!
#define TFT_MOSI 11   // set these to be whatever pins you like!

・初期化シーケンス

void setup(void) {
tft.initR(INITR_GREENTAB);   // initialize a ST7735S chip, green tab
tft.fillScreen(BLACK);

gameStatus = GAME_RESTART;
BallInit(ball);
}

1行目のinitRの引数になっている「INITR_GREENTAB」は、液晶モジュールのバージョンによって、異なる値を与えなければならないようです。

Adafruit_ST7735の現状のヘッダファイルでは、この引数に使える値は「INITR_BLACKTAB」「INITR_GREENTAB」「INITR_REDTAB」の3種類が定義されています。
この値によって、液晶コントローラに送られる初期化コマンド列が変わります。

液晶モジュールの種類をどう見分けるかですが、この「BLACK」「GREEN」「RED」は液晶パネルの保護シールの引き剥がし用の耳(tab)の色なのだそうです。
少し昔のバージョンのAdafruit_ST7735を使ったスケッチ例を見ると、コメントでそのように記載されていました。
以下引用です。

  // Our supplier changed the 1.8" display slightly after Jan 10, 2012
// so that the alignment of the TFT had to be shifted by a few pixels
// this just means the init code is slightly different. Check the
// color of the tab to see which init code to try. If the display is
// cut off or has extra 'random' pixels on the top & left, try the
// other option!
// If you are seeing red and green color inversion, use Black Tab

// If your TFT's plastic wrap has a Black Tab, use the following:
tft.initR(INITR_BLACKTAB);   // initialize a ST7735S chip, black tab
// If your TFT's plastic wrap has a Red Tab, use the following:
//tft.initR(INITR_REDTAB);   // initialize a ST7735R chip, red tab
// If your TFT's plastic wrap has a Green Tab, use the following:
//tft.initR(INITR_GREENTAB); // initialize a ST7735R chip, green tab

今回使用した液晶はAdafruitの製品ではありませんが、青緑色のプルタブが付いていました。

arduino08-02.jpg

Adafruit製品のLCDモジュールと今回のaitendoのLCDモジュールが同一サプライヤの製品であるかどうかは定かではありません。
ネットの情報では、緑のタブの製品でもINITR_BLACKTABを指定すると正しく動いた、という例もあるようで、結局3種類を試して一番正常なものを選ぶのが良さそうです。

ちなみに私が試したところ、今回のaitendoの液晶モジュールは

・INITR_BLACKTAB・・・画面の下端と右端にランダムな色のノイズピクセルが出る。
上端と左端が2ピクセルほど切れる。
(aitendoの商品ページでもそうなっています)

・INITR_REDTAB・・・画面の下半分が表示されない。

・INITR_GREENTAB・・・ピクセルは表示されるが、色指定がRGBではなくBGRとなる。

となりました。

ピクセルが正常に表示されるのは、INITR_GREENTABですが、赤と青が入れ替わるので、まったく違う色調になってしまいます。

今回のブロック崩しは、もともとカラーを8色しか使っていないので、この問題へはスケッチファイル側で色の定義を変更することで対応しました。
スケッチファイル側を変更したくない場合は、ライブラリのソースコード(Adafruit_ST7735.cpp)を編集することで対応することもできます。
ライブラリの修正部分は別記事で載せておきます。

配線は、下図のようにしました。
コントローラ用の可変抵抗器はA1、圧電ブザーは3番の信号線を使用しています。
液晶への配線は前回と変わっていません。

arduino08-01.png

以上の変更を反映したスケッチファイルと、動作の様子は以下の通りです。

Arduino(7) Arduino Pro MiniにSPI接続のカラーLCDをつないでみる

前回まで使ったArduino UNOと2.4インチTFT液晶は、簡単に動かすことができて良かったのですが、不満点もあります。

一つは、前回触れたように、このLCDを使うとArduino UNOのI/Oポートをほとんど使ってしまうので、センサなど他のデバイスを接続する余地が非常に小さいことです。

もう一つは、Arduino UNOは5V動作なので、3.3V動作のセンサ類を直接つなげられないことです。
3.3Vのデバイスをつなぐには、ブレッドボードなどにArduino UNOの線を引き出し、レベルコンバータを通してから接続する必要があります。

そこで、Arduino UNOの代わりに3.3V動作のArduino Pro Miniを使い、LCDもSPI接続のものにしてはどうかと考えました。

Arduino Pro Miniは、UNOをそのまま小さくして、動作時に不要なUSBシリアル変換やAVRプログラマなどの機能を削除したような製品です。
ただし、PCとの接続では、USB-シリアル変換器が必要になります。
また、3.3V動作製品があり、これをつかえば3.3V動作のセンサ等と直結できます。

SPIとは4つの信号線でシリアル通信を行う規格で、8本のデータバスに加えて制御信号線も必要になるパラレルインタフェースよりも、使用するI/Oポートを大幅に減らせます。
arduino07-02.jpg

というような目論見で、以下の製品を購入しました。

Arduino Pro Mini(3.3V)

arduino07-04.jpg

FTDI USBシリアル変換アダプター(5V/3.3V切り替え機能付き)

arduino07-05.jpg

aitendo TFT液晶with基板 [M-Z18SPI-2P]

arduino07-09.jpg

なお、Pro Miniはピンヘッダを自分でハンダ付けする必要があります。
ピンヘッダを持っていない場合は別途購入が必要です。
(普通のタイプのほかに、L字型も買っておくと良いと思います。)

また、aitendoの上記液晶は、フレキシブル基板をプリント基板にハンダ付けする必要があります。
ただし、このハンダ付けはピン間隔が狭いので、初心者には難しいと思います。

というわけで、今回は実質的にソフトウェアではなくハードウェアの話のみです。
ともかくニッパでベキベキとピンヘッダを切り離していきます。
切ったものが飛ばないように、切るときは指で抑えておきます。

arduino07-06.jpg

Pro Miniは14本×2列の信号線と、PCに接続するための6本×1列の信号線、さらにアナログポートのための2本×1列の信号線が2つ、合計5箇所にピンヘッダを取り付けます。

どのようなピンヘッダ(またはピンソケット)を付けるかは用途次第です。
前回使ったような、足の長いピンソケットを使えば、ブレッドボードに挿すことも、UNOのようにボードにジャンパピンを挿すことも可能になります。

私はブレッドボードを使う想定で、14本×2列のピンを下向きに付けました。
アナログポートの信号線は位置がずらされていますので、ピンヘッダを上向きに取り付けます。
また、PC接続用のピンは裏表を間違えにくいようにL字型ピンで横へ引き出しました。

arduino07-07.jpg

ちなみに、私は上のように2枚重ねのユニバーサル基板を用意して、そこにハンダ付けしたいピンヘッダを挿し、その上に基板を乗せてハンダ付けしています。
こうするとピンヘッダがグラついたり抜けたりしません。

USBシリアル変換アダプターは、特にハンダ付けは必要ありません。
今回のPro Miniは3.3V用ですので、ジャンパピンを3.3Vのほうへ付け直しておきます。

液晶基板は、フレキシブル基板と本体側のパターンを慎重に合わせて、まずカプトンテープでフレキ基板を仮止めします。
カプトンテープは耐熱性があるので、多少ハンダ付けの熱が伝わっても大丈夫です。
カプトンテープ(あるいはポリイミドテープ)もaitendoやamazonなどで入手できます。

arduino07-08.jpg

カプトンテープは褐色の透明なテープです。
分かりにくいですが、上の写真だと、基板の上にフレキをカプトンテープで貼り付けていますので、緑のレジストが一部だけオレンジ色っぽく見えています。その部分がカプトンテープです。

このフレキ基板のハンダ付けですが、ベース基板には予備ハンダをし、フレキ基板は予備ハンダなしで、ハンダ付けの際は追いハンダをそれなりの量を流し込む感じで行いました。
ベース基板のパターンと重なるあたりのフレキ基板のパターンにごく小さな穴が開いていますが、ハンダが十分な量であればそこからハンダが少し出てきます。
最初はハンダが少なすぎて、接触不良になっていました。

液晶モジュールの外部接続端子は、今回はピンソケットを取り付けて、ジャンパピンを挿せるようにしてみました。
また、この基板はバックライトのLEDに流す電流を決める抵抗を自分で取り付ける必要があります。
5V電源のときは150Ωが標準ということですが、今回はバックライトも3.3Vを使いたいので、100Ωを取り付けました。(昼間使うには若干暗いかもしれません。)

完成したら、早速接続です。

その前に、PCにUSBシリアル変換モジュールのドライバを、下記からダウンロードしてインストールする必要があります。

Virtual COM Port Drivers

無事認識されたら、まずはLチカで動作確認です。

Arduino IDEで、

ボード:”Arduino Pro or Pro Mini”
プロセッサ:”ATMega328(3.3V, 8MHz)”

を選択します。
arduino07-01.jpg

あとはUNOのときと同じようにBlinkのスケッチを開いて、コンパイルして転送すればPro Miniボード上のLEDが点滅するはずです。

次に、今回使うSPI接続LCDをArduinoから制御するためのソフトウェアですが、Adafruitから公開されている以下のライブラリを使います。

adafruit/Adafruit-ST7735-Library · GitHub

Arduino IDEにこのライブラリを追加する方法は、以前書いたのと同じです
なお、今回使った液晶モジュールはSDカードのインタフェースやタッチパネルは付いていませんので、利用できるのは描画関係の機能だけです。

ArduinoとLCD基板との接続方法はaitendoのページに書かれている通りです。
実際の配線図は以下のようになります。
arduino07-03.png

ライブラリを追加すると、スケッチの例も追加されます。
これも、今回のLCDで動作するのはgraphicstestとrotationtestだけです。
特に変更は行わなくても、上記の接続であれば動作するはずです。