feat: add ESP32-S3 ST7789 LCD and GT911 wiring test
This commit is contained in:
319
main/esp_lcd_st7735.c
Normal file
319
main/esp_lcd_st7735.c
Normal file
@@ -0,0 +1,319 @@
|
||||
/*
|
||||
* SPDX-FileCopyrightText: 2026
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*/
|
||||
|
||||
#include <assert.h>
|
||||
#include <stdlib.h>
|
||||
#include <sys/cdefs.h>
|
||||
|
||||
#include "freertos/FreeRTOS.h"
|
||||
#include "freertos/task.h"
|
||||
#include "driver/gpio.h"
|
||||
#include "esp_check.h"
|
||||
#include "esp_lcd_panel_commands.h"
|
||||
#include "esp_lcd_panel_interface.h"
|
||||
#include "esp_lcd_panel_io.h"
|
||||
#include "esp_lcd_panel_ops.h"
|
||||
#include "esp_log.h"
|
||||
|
||||
#include "esp_lcd_st7735.h"
|
||||
|
||||
#define ST7735_CMD_FRMCTR1 0xB1
|
||||
#define ST7735_CMD_FRMCTR2 0xB2
|
||||
#define ST7735_CMD_FRMCTR3 0xB3
|
||||
#define ST7735_CMD_INVCTR 0xB4
|
||||
#define ST7735_CMD_PWCTR1 0xC0
|
||||
#define ST7735_CMD_PWCTR2 0xC1
|
||||
#define ST7735_CMD_PWCTR3 0xC2
|
||||
#define ST7735_CMD_PWCTR4 0xC3
|
||||
#define ST7735_CMD_PWCTR5 0xC4
|
||||
#define ST7735_CMD_VMCTR1 0xC5
|
||||
#define ST7735_CMD_GMCTRP1 0xE0
|
||||
#define ST7735_CMD_GMCTRN1 0xE1
|
||||
|
||||
static const char *TAG = "st7735";
|
||||
|
||||
static esp_err_t panel_st7735_del(esp_lcd_panel_t *panel);
|
||||
static esp_err_t panel_st7735_reset(esp_lcd_panel_t *panel);
|
||||
static esp_err_t panel_st7735_init(esp_lcd_panel_t *panel);
|
||||
static esp_err_t panel_st7735_draw_bitmap(esp_lcd_panel_t *panel, int x_start, int y_start, int x_end, int y_end,
|
||||
const void *color_data);
|
||||
static esp_err_t panel_st7735_invert_color(esp_lcd_panel_t *panel, bool invert_color_data);
|
||||
static esp_err_t panel_st7735_mirror(esp_lcd_panel_t *panel, bool mirror_x, bool mirror_y);
|
||||
static esp_err_t panel_st7735_swap_xy(esp_lcd_panel_t *panel, bool swap_axes);
|
||||
static esp_err_t panel_st7735_set_gap(esp_lcd_panel_t *panel, int x_gap, int y_gap);
|
||||
static esp_err_t panel_st7735_disp_on_off(esp_lcd_panel_t *panel, bool on_off);
|
||||
static esp_err_t panel_st7735_sleep(esp_lcd_panel_t *panel, bool sleep);
|
||||
|
||||
typedef struct {
|
||||
uint8_t cmd;
|
||||
const void *data;
|
||||
size_t data_bytes;
|
||||
unsigned int delay_ms;
|
||||
} st7735_lcd_init_cmd_t;
|
||||
|
||||
typedef struct {
|
||||
esp_lcd_panel_t base;
|
||||
esp_lcd_panel_io_handle_t io;
|
||||
int reset_gpio_num;
|
||||
bool reset_level;
|
||||
int x_gap;
|
||||
int y_gap;
|
||||
uint8_t fb_bits_per_pixel;
|
||||
uint8_t madctl_val;
|
||||
uint8_t colmod_val;
|
||||
} st7735_panel_t;
|
||||
|
||||
static const st7735_lcd_init_cmd_t vendor_specific_init_default[] = {
|
||||
{ST7735_CMD_FRMCTR1, (uint8_t []){0x01, 0x2C, 0x2D}, 3, 0},
|
||||
{ST7735_CMD_FRMCTR2, (uint8_t []){0x01, 0x2C, 0x2D}, 3, 0},
|
||||
{ST7735_CMD_FRMCTR3, (uint8_t []){0x01, 0x2C, 0x2D, 0x01, 0x2C, 0x2D}, 6, 0},
|
||||
{ST7735_CMD_INVCTR, (uint8_t []){0x07}, 1, 0},
|
||||
{ST7735_CMD_PWCTR1, (uint8_t []){0xA2, 0x02, 0x84}, 3, 0},
|
||||
{ST7735_CMD_PWCTR2, (uint8_t []){0xC5}, 1, 0},
|
||||
{ST7735_CMD_PWCTR3, (uint8_t []){0x0A, 0x00}, 2, 0},
|
||||
{ST7735_CMD_PWCTR4, (uint8_t []){0x8A, 0x2A}, 2, 0},
|
||||
{ST7735_CMD_PWCTR5, (uint8_t []){0x8A, 0xEE}, 2, 0},
|
||||
{ST7735_CMD_VMCTR1, (uint8_t []){0x0E}, 1, 0},
|
||||
{ST7735_CMD_GMCTRP1, (uint8_t []){0x02, 0x1C, 0x07, 0x12, 0x37, 0x32, 0x29, 0x2D,
|
||||
0x29, 0x25, 0x2B, 0x39, 0x00, 0x01, 0x03, 0x10}, 16, 0},
|
||||
{ST7735_CMD_GMCTRN1, (uint8_t []){0x03, 0x1D, 0x07, 0x06, 0x2E, 0x2C, 0x29, 0x2D,
|
||||
0x2E, 0x2E, 0x37, 0x3F, 0x00, 0x00, 0x02, 0x10}, 16, 0},
|
||||
};
|
||||
|
||||
esp_err_t esp_lcd_new_panel_st7735(const esp_lcd_panel_io_handle_t io,
|
||||
const esp_lcd_panel_dev_config_t *panel_dev_config,
|
||||
esp_lcd_panel_handle_t *ret_panel)
|
||||
{
|
||||
esp_err_t ret = ESP_OK;
|
||||
st7735_panel_t *st7735 = NULL;
|
||||
|
||||
ESP_GOTO_ON_FALSE(io && panel_dev_config && ret_panel, ESP_ERR_INVALID_ARG, err, TAG, "invalid argument");
|
||||
st7735 = calloc(1, sizeof(st7735_panel_t));
|
||||
ESP_GOTO_ON_FALSE(st7735, ESP_ERR_NO_MEM, err, TAG, "no mem for st7735 panel");
|
||||
|
||||
if (panel_dev_config->reset_gpio_num >= 0) {
|
||||
gpio_config_t io_conf = {
|
||||
.mode = GPIO_MODE_OUTPUT,
|
||||
.pin_bit_mask = 1ULL << panel_dev_config->reset_gpio_num,
|
||||
};
|
||||
ESP_GOTO_ON_ERROR(gpio_config(&io_conf), err, TAG, "configure GPIO for RST line failed");
|
||||
}
|
||||
|
||||
switch (panel_dev_config->rgb_ele_order) {
|
||||
case LCD_RGB_ELEMENT_ORDER_RGB:
|
||||
st7735->madctl_val = 0;
|
||||
break;
|
||||
case LCD_RGB_ELEMENT_ORDER_BGR:
|
||||
st7735->madctl_val = LCD_CMD_BGR_BIT;
|
||||
break;
|
||||
default:
|
||||
ESP_GOTO_ON_FALSE(false, ESP_ERR_NOT_SUPPORTED, err, TAG, "unsupported RGB element order");
|
||||
break;
|
||||
}
|
||||
|
||||
switch (panel_dev_config->bits_per_pixel) {
|
||||
case 16:
|
||||
st7735->colmod_val = 0x05;
|
||||
st7735->fb_bits_per_pixel = 16;
|
||||
break;
|
||||
case 18:
|
||||
st7735->colmod_val = 0x06;
|
||||
st7735->fb_bits_per_pixel = 24;
|
||||
break;
|
||||
default:
|
||||
ESP_GOTO_ON_FALSE(false, ESP_ERR_NOT_SUPPORTED, err, TAG, "unsupported pixel width");
|
||||
break;
|
||||
}
|
||||
|
||||
st7735->io = io;
|
||||
st7735->reset_gpio_num = panel_dev_config->reset_gpio_num;
|
||||
st7735->reset_level = panel_dev_config->flags.reset_active_high;
|
||||
st7735->base.del = panel_st7735_del;
|
||||
st7735->base.reset = panel_st7735_reset;
|
||||
st7735->base.init = panel_st7735_init;
|
||||
st7735->base.draw_bitmap = panel_st7735_draw_bitmap;
|
||||
st7735->base.invert_color = panel_st7735_invert_color;
|
||||
st7735->base.set_gap = panel_st7735_set_gap;
|
||||
st7735->base.mirror = panel_st7735_mirror;
|
||||
st7735->base.swap_xy = panel_st7735_swap_xy;
|
||||
st7735->base.disp_on_off = panel_st7735_disp_on_off;
|
||||
st7735->base.disp_sleep = panel_st7735_sleep;
|
||||
|
||||
*ret_panel = &(st7735->base);
|
||||
ESP_LOGD(TAG, "new st7735 panel @%p", st7735);
|
||||
return ESP_OK;
|
||||
|
||||
err:
|
||||
if (st7735) {
|
||||
if (panel_dev_config->reset_gpio_num >= 0) {
|
||||
gpio_reset_pin(panel_dev_config->reset_gpio_num);
|
||||
}
|
||||
free(st7735);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_del(esp_lcd_panel_t *panel)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
|
||||
if (st7735->reset_gpio_num >= 0) {
|
||||
gpio_reset_pin(st7735->reset_gpio_num);
|
||||
}
|
||||
ESP_LOGD(TAG, "del st7735 panel @%p", st7735);
|
||||
free(st7735);
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_reset(esp_lcd_panel_t *panel)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
esp_lcd_panel_io_handle_t io = st7735->io;
|
||||
|
||||
if (st7735->reset_gpio_num >= 0) {
|
||||
gpio_set_level(st7735->reset_gpio_num, st7735->reset_level);
|
||||
vTaskDelay(pdMS_TO_TICKS(10));
|
||||
gpio_set_level(st7735->reset_gpio_num, !st7735->reset_level);
|
||||
vTaskDelay(pdMS_TO_TICKS(120));
|
||||
} else {
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_SWRESET, NULL, 0), TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(120));
|
||||
}
|
||||
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_init(esp_lcd_panel_t *panel)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
esp_lcd_panel_io_handle_t io = st7735->io;
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_SLPOUT, NULL, 0), TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(120));
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_MADCTL, (uint8_t []) {
|
||||
st7735->madctl_val,
|
||||
}, 1), TAG, "send command failed");
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_COLMOD, (uint8_t []) {
|
||||
st7735->colmod_val,
|
||||
}, 1), TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(10));
|
||||
|
||||
for (int i = 0; i < sizeof(vendor_specific_init_default) / sizeof(vendor_specific_init_default[0]); i++) {
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, vendor_specific_init_default[i].cmd,
|
||||
vendor_specific_init_default[i].data,
|
||||
vendor_specific_init_default[i].data_bytes),
|
||||
TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(vendor_specific_init_default[i].delay_ms));
|
||||
}
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_NORON, NULL, 0), TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(10));
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_draw_bitmap(esp_lcd_panel_t *panel, int x_start, int y_start, int x_end, int y_end,
|
||||
const void *color_data)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
assert((x_start < x_end) && (y_start < y_end) && "start position must be smaller than end position");
|
||||
esp_lcd_panel_io_handle_t io = st7735->io;
|
||||
|
||||
x_start += st7735->x_gap;
|
||||
x_end += st7735->x_gap;
|
||||
y_start += st7735->y_gap;
|
||||
y_end += st7735->y_gap;
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_CASET, (uint8_t []) {
|
||||
(x_start >> 8) & 0xFF,
|
||||
x_start & 0xFF,
|
||||
((x_end - 1) >> 8) & 0xFF,
|
||||
(x_end - 1) & 0xFF,
|
||||
}, 4), TAG, "send command failed");
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(io, LCD_CMD_RASET, (uint8_t []) {
|
||||
(y_start >> 8) & 0xFF,
|
||||
y_start & 0xFF,
|
||||
((y_end - 1) >> 8) & 0xFF,
|
||||
(y_end - 1) & 0xFF,
|
||||
}, 4), TAG, "send command failed");
|
||||
|
||||
size_t len = (x_end - x_start) * (y_end - y_start) * st7735->fb_bits_per_pixel / 8;
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_color(io, LCD_CMD_RAMWR, color_data, len), TAG, "send color failed");
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_invert_color(esp_lcd_panel_t *panel, bool invert_color_data)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
int command = invert_color_data ? LCD_CMD_INVON : LCD_CMD_INVOFF;
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(st7735->io, command, NULL, 0), TAG, "send command failed");
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_mirror(esp_lcd_panel_t *panel, bool mirror_x, bool mirror_y)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
|
||||
if (mirror_x) {
|
||||
st7735->madctl_val |= LCD_CMD_MX_BIT;
|
||||
} else {
|
||||
st7735->madctl_val &= ~LCD_CMD_MX_BIT;
|
||||
}
|
||||
if (mirror_y) {
|
||||
st7735->madctl_val |= LCD_CMD_MY_BIT;
|
||||
} else {
|
||||
st7735->madctl_val &= ~LCD_CMD_MY_BIT;
|
||||
}
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(st7735->io, LCD_CMD_MADCTL, (uint8_t []) {
|
||||
st7735->madctl_val,
|
||||
}, 1), TAG, "send command failed");
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_swap_xy(esp_lcd_panel_t *panel, bool swap_axes)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
|
||||
if (swap_axes) {
|
||||
st7735->madctl_val |= LCD_CMD_MV_BIT;
|
||||
} else {
|
||||
st7735->madctl_val &= ~LCD_CMD_MV_BIT;
|
||||
}
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(st7735->io, LCD_CMD_MADCTL, (uint8_t []) {
|
||||
st7735->madctl_val,
|
||||
}, 1), TAG, "send command failed");
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_set_gap(esp_lcd_panel_t *panel, int x_gap, int y_gap)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
|
||||
st7735->x_gap = x_gap;
|
||||
st7735->y_gap = y_gap;
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_disp_on_off(esp_lcd_panel_t *panel, bool on_off)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
int command = on_off ? LCD_CMD_DISPON : LCD_CMD_DISPOFF;
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(st7735->io, command, NULL, 0), TAG, "send command failed");
|
||||
return ESP_OK;
|
||||
}
|
||||
|
||||
static esp_err_t panel_st7735_sleep(esp_lcd_panel_t *panel, bool sleep)
|
||||
{
|
||||
st7735_panel_t *st7735 = __containerof(panel, st7735_panel_t, base);
|
||||
int command = sleep ? LCD_CMD_SLPIN : LCD_CMD_SLPOUT;
|
||||
|
||||
ESP_RETURN_ON_ERROR(esp_lcd_panel_io_tx_param(st7735->io, command, NULL, 0), TAG, "send command failed");
|
||||
vTaskDelay(pdMS_TO_TICKS(120));
|
||||
return ESP_OK;
|
||||
}
|
||||
Reference in New Issue
Block a user