st77xx.h

Go to the documentation of this file.

/*
 * This file is part of the Ultibo project, https://ultibo.org/
 *
 * The MIT License (MIT)
 *
 * Copyright (c) 2026 Garry Wood <garry@softoz.com.au>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
#ifndef _ULTIBO_ST77XX_H
#define _ULTIBO_ST77XX_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "ultibo/gpio.h"
#include "ultibo/spi.h"
#include "ultibo/framebuffer.h"

#define ST77XX_FRAMEBUFFER_DESCRIPTION  "ST77XX TFT LCD DRIVER" 

#define ST77XX_SPI_RATE 32000000 
 
#define ST_CMD_DELAY    0x80 

#define ST77XX_NOP  0x00 
#define ST77XX_SWRESET  0x01 
#define ST77XX_RDDID    0x04 
#define ST77XX_RDDST    0x09 
 
#define ST77XX_SLPIN    0x10 
#define ST77XX_SLPOUT   0x11 
#define ST77XX_PTLON    0x12 
#define ST77XX_NORON    0x13 
 
#define ST77XX_INVOFF   0x20 
#define ST77XX_INVON    0x21 
#define ST77XX_GAMSET   0x26 
#define ST77XX_DISPOFF  0x28 
#define ST77XX_DISPON   0x29 
#define ST77XX_CASET    0x2A 
#define ST77XX_RASET    0x2B 
#define ST77XX_RAMWR    0x2C 
#define ST77XX_RGBSET   0x2D 
#define ST77XX_RAMRD    0x2E 
 
#define ST77XX_RDDPM    0x0A 
#define ST77XX_RDD_MADCTL   0x0B 
#define ST77XX_RDD_COLMOD   0x0C 
#define ST77XX_RDDIM    0x0D 
#define ST77XX_RDDSM    0x0E 
#define ST77XX_RDDSR    0x0F 
 
#define ST77XX_PTLAR    0x30 
#define ST77XX_VSCRDEF  0x33 
#define ST77XX_TEOFF    0x34 
#define ST77XX_TEON 0x35 
#define ST77XX_MADCTL   0x36 
#define ST77XX_IDMOFF   0x38 
#define ST77XX_IDMON    0x39 
#define ST77XX_RAMWRC   0x3C 
#define ST77XX_RAMRDC   0x3E 
#define ST77XX_COLMOD   0x3A 
 

#define ST77XX_MADCTL_MY    0x80 
#define ST77XX_MADCTL_MX    0x40 
#define ST77XX_MADCTL_MV    0x20 
#define ST77XX_MADCTL_ML    0x10 
#define ST77XX_MADCTL_MH    0x04 
#define ST77XX_MADCTL_RGB   0x00 
#define ST77XX_MADCTL_BGR   0x08
 
#define ST77XX_RAMCTRL  0xB0 
#define ST77XX_RGBCTRL  0xB1 
#define ST77XX_PORCTRL  0xB2 
#define ST77XX_FRCTR1   0xB3 
#define ST77XX_PARCTRL  0xB5 
#define ST77XX_GCTRL    0xB7 
#define ST77XX_GTADJ    0xB8 
#define ST77XX_DGMEN    0xBA 
#define ST77XX_VCOMS    0xBB 
#define ST77XX_DISCTRL  0xB6 
 
#define ST77XX_LCMCTRL  0xC0 
#define ST77XX_IDSET    0xC1 
#define ST77XX_VDVVRHEN 0xC2 
#define ST77XX_VRHS 0xC3 
#define ST77XX_VDVSET   0xC4 
#define ST77XX_VCMOFSET 0xC5 
#define ST77XX_FRCTR2   0xC6 
#define ST77XX_CABCCTRL 0xC7 
#define ST77XX_REGSEL1  0xC8 
#define ST77XX_REGSEL2  0xCA 
#define ST77XX_PWMFRSEL 0xCC 
 
#define ST77XX_PWCTRL1  0xD0 
#define ST77XX_VAPVANEN 0xD2 
#define ST77XX_CMD2EN   0xDF 
 
#define ST77XX_VMCTRL1  0xC5 
#define ST77XX_VMCTRL2  0xC7 
 
#define ST77XX_PGAMCTRL 0xE0 
#define ST77XX_NGAMCTRL 0xE1 
#define ST77XX_DGMLUTR  0xE2 
#define ST77XX_DGMLUTB  0xE3 
#define ST77XX_GATECTRL 0xE4 
#define ST77XX_SPI2EN   0xE7 
#define ST77XX_PWCTRL2  0xE8 
#define ST77XX_EQCTRL   0xE9 
#define ST77XX_PROMCTRL 0xEC 
 
#define ST77XX_PROMEN   0xFA 
#define ST77XX_NVMSET   0xFC 
#define ST77XX_PROMACT  0xFE 
 
#define ST77XX_COLOR_MODE_16bit 0x55
#define ST77XX_COLOR_MODE_18bit 0x66

typedef struct _ST77XX_FRAMEBUFFER ST77XX_FRAMEBUFFER;
struct _ST77XX_FRAMEBUFFER
{
    // TFT Properties
    TFT_FRAMEBUFFER tft;
    // ST77XX Properties
};


FRAMEBUFFER_DEVICE * STDCALL st77xx_framebuffer_create(SPI_DEVICE *spi, uint16_t chipselect, char *name, uint32_t rotation, uint32_t width, uint32_t height, uint32_t colstart, GPIO_INFO *rst, GPIO_INFO *dc, GPIO_INFO *bl);

uint32_t STDCALL st77xx_framebuffer_destroy(FRAMEBUFFER_DEVICE *framebuffer);
 
#ifdef __cplusplus
}
#endif
 
#endif // _ULTIBO_ST77XX_H