Example code for Lilygo T-Display-S3

[MisterAG]

Hi,

I just wanted to share some code in case anyone has problems to use Lovyangfx together with the Lilygo T-Display-S3 board.
See attached example code.

Best regards,
Jan
lilygo-basic-lovyangfx-test.txt

#include "Arduino.h"
#include <WiFi.h>
#include "time.h"
#define LGFX_USE_V1
#include <SPI.h>
#include <LovyanGFX.hpp>

class LGFX : public lgfx::LGFX_Device
{
    //lgfx::Panel_ILI9341 _panel_instance;
    lgfx::Panel_ST7789 _panel_instance;
    lgfx::Bus_Parallel8 _bus_instance; // 8ビットパラレルバスのインスタンス (ESP32のみ)
    lgfx::Light_PWM     _light_instance;

public:
    // コンストラクタを作成し、ここで各種設定を行います。
    // クラス名を変更した場合はコンストラクタも同じ名前を指定してください。
    LGFX(void)
    {
        {                                      // バス制御の設定を行います。
            auto cfg = _bus_instance.config(); // バス設定用の構造体を取得します。

            // 16位设置
           // cfg.i2s_port = I2S_NUM_0;  // 使用するI2Sポートを選択 (0 or 1) (ESP32のI2S LCDモードを使用します)
            cfg.freq_write = 20000000; // 送信クロック (最大20MHz, 80MHzを整数で割った値に丸められます)
            cfg.pin_wr = 8;           // WR を接続しているピン番号
            cfg.pin_rd = 9;           // RD を接続しているピン番号
            cfg.pin_rs = 7;           // RS(D/C)を接続しているピン番号

            cfg.pin_d0 = 39;
            cfg.pin_d1 = 40;
            cfg.pin_d2 = 41;
            cfg.pin_d3 = 42;
            cfg.pin_d4 = 45;
            cfg.pin_d5 = 46;
            cfg.pin_d6 = 47;
            cfg.pin_d7 = 48;
            

            _bus_instance.config(cfg);              // 設定値をバスに反映します。
            _panel_instance.setBus(&_bus_instance); // バスをパネルにセットします。
        }

        {                                        // 表示パネル制御の設定を行います。
            auto cfg = _panel_instance.config(); // 表示パネル設定用の構造体を取得します。

            cfg.pin_cs = 6;   // CS要拉低
            cfg.pin_rst = 5;  // RST和开发板RST相连
            cfg.pin_busy = -1; // BUSYが接続されているピン番号 (-1 = disable)

            // ※ 以下の設定値はパネル毎に一般的な初期値が設定されていますので、不明な項目はコメントアウトして試してみてください。

            cfg.memory_width = 240;   // ドライバICがサポートしている最大の幅
            cfg.memory_height = 320;  // ドライバICがサポートしている最大の高さ
            cfg.panel_width = 170;    // 実際に表示可能な幅
            cfg.panel_height = 320;  // 実際に表示可能な高さ
            cfg.offset_x = 35;         // パネルのX方向オフセット量
            cfg.offset_y = 0;         // パネルのY方向オフセット量
            cfg.offset_rotation = 0;  // 回転方向の値のオフセット 0~7 (4~7は上下反転)
            cfg.dummy_read_pixel = 8; // ピクセル読出し前のダミーリードのビット数
            cfg.dummy_read_bits = 1;  // ピクセル以外のデータ読出し前のダミーリードのビット数
            cfg.readable = true;      // データ読出しが可能な場合 trueに設定
            cfg.invert = true;       // パネルの明暗が反転してしまう場合 trueに設定
            cfg.rgb_order =false;    // パネルの赤と青が入れ替わってしまう場合 trueに設定
            cfg.dlen_16bit = false;    // データ長を16bit単位で送信するパネルの場合 trueに設定
            cfg.bus_shared = false;    // SDカードとバスを共有している場合 trueに設定(drawJpgFile等でバス制御を行います)

            _panel_instance.config(cfg);
        }

        setPanel(&_panel_instance); // 使用するパネルをセットします。
    
    { // バックライト制御の設定を行います。（必要なければ削除）
      auto cfg = _light_instance.config();    // バックライト設定用の構造体を取得します。

      cfg.pin_bl = 38;              // バックライトが接続されているピン番号
      cfg.invert = false;           // バックライトの輝度を反転させる場合 true
      cfg.freq   = 44100;           // バックライトのPWM周波数
      cfg.pwm_channel = 7;          // 使用するPWMのチャンネル番号

      _light_instance.config(cfg);
      _panel_instance.setLight(&_light_instance);  // バックライトをパネルにセットします。
    }
    }
};


static LGFX lcd;  

void setup(void)
{
   // pinMode(38, OUTPUT); // LED Pin not needed anymore since backlight controlled by lovyangfx library.
   //  digitalWrite(38, HIGH);
    //pinMode(15, OUTPUT); // This is LCD on/off led pin. Not sure if needed to set this. LCD works with and without this set.
    //digitalWrite(15, HIGH);
    
   // Serial.begin(115200);
    lcd.init();
    lcd.setRotation(1);
    lcd.setBrightness(1);
    lcd.fillScreen(TFT_RED);
    delay(500);
}
bool up=true;
int brightnessChange=5;
int myBrightness=0;
unsigned long myDelay=5;
unsigned long lastBrightnessChange=millis();
int currColor=0;
uint32_t myColors[]={0xFF0000,0xFFFF00,0x00FF00,0xCC00FF,0x0000FF};


void loop()
{
  if(millis()-lastBrightnessChange > myDelay){
    lastBrightnessChange=millis();
   // Serial.println(myBrightness);
    if(up) { 
      if(++myBrightness==253) up=false;
      lcd.setBrightness(myBrightness);
      
      } else {
        
        lcd.setBrightness(--myBrightness);
        if(myBrightness==1) 
        {up=true; // not going to 0, since I believe the LovYanGFX library puts the screen to sleep at 0.
        if(++currColor==5) currColor=0;
        lcd.fillScreen(myColors[currColor]);
        }
        }
    
    }

}

[lovyan03]

The memory_width for ST7789 is 240; setting it to 170 will cause inconvenience.
A negative offset should not be set.

[MisterAG]

Hi,

I compiled my code using these settings:

cfg.memory_width = 240;   // ドライバICがサポートしている最大の幅
            cfg.memory_height = 320;  // ドライバICがサポートしている最大の高さ
            cfg.panel_width = 170;    // 実際に表示可能な幅
            cfg.panel_height = 320;  // 実際に表示可能な高さ
            cfg.offset_x = 0;         // パネルのX方向オフセット量
            cfg.offset_y = 0;         // パネルのY方向オフセット量

but the output on the screen is not what I would expect, I presume because of the offset that I changed from -35 to 0.
I would expect a full yellow screen after lcd.fillscreen(0xFFFF00)? When I set the x offset to -35 I see a full yellow screen.

Apologies if i'm misunderstanding something.

[lovyan03]

You can use positive offset 35....

[MisterAG]

Hi,

Yes, you are correct. The positive offset works.
Thank you for your feedback!

Best regards,
Jan