st7305.c

#include "st7305.h"
#include "st7305_reg.h"
#include "driver/gpio.h"
#include "esp_log.h"
#include "esp_err.h"
#include "esp_heap_caps.h"
#include "string.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"

static const char *TAG = "ST7305";

// 发送命令（DC=低电平）
static void send_cmd(st7305_dev_t *dev, uint8_t cmd)
{
    spi_transaction_t t = {
        .length = 8,
        .tx_buffer = &cmd,
        .user = (void *)0 // DC低电平
    };
    gpio_set_level(dev->config.dc_pin, 0);
    spi_device_transmit(dev->spi, &t);
}

// 发送数据（DC=高电平）
static void send_data(st7305_dev_t *dev, const uint8_t *data, size_t len)
{
    spi_transaction_t t = {
        .length = len * 8,
        .tx_buffer = data,
        .user = (void *)1 // DC高电平
    };
    gpio_set_level(dev->config.dc_pin, 1);
    spi_device_transmit(dev->spi, &t);
}

// 硬件复位
static void hardware_reset(st7305_dev_t *dev)
{
    gpio_set_level(dev->config.reset_pin, 1);
    vTaskDelay(pdMS_TO_TICKS(50));
    gpio_set_level(dev->config.reset_pin, 0);
    vTaskDelay(pdMS_TO_TICKS(100));
    gpio_set_level(dev->config.reset_pin, 1);
}

// 初始化序列
static void initialize_sequence(st7305_dev_t *dev)
{
    // NVM Load
    send_cmd(dev, 0xD6);
    send_data(dev, (uint8_t[]){0x13, 0x02}, 2);
    // Booster Enable
    send_cmd(dev, 0xD1);
    send_data(dev, (uint8_t[]){0x01}, 1);
    // Gate Voltage Setting
    // VGH 00:8V  04:10V  08:12V   0E:15V   12:17V
    // VGL 00:-5V   04:-7V   0A:-10V
    send_cmd(dev, 0xC0);
    send_data(dev, (uint8_t[]){0x12, 0x0A}, 2);
    // VLC=3.6V (12/-5)(delta Vp=0.6V)
    // VSHP Setting (4.8V) VSHP1 VSHP2 VSHP3 VSHP4
    send_cmd(dev, 0xC1);
    send_data(dev, (uint8_t[]){0x3C, 0x3E, 0x3C, 0x3C}, 4);
    // VSLP Setting (0.98V) VSLP1 VSLP2 VSLP3 VSLP4
    send_cmd(dev, 0xC2);
    send_data(dev, (uint8_t[]){0x23, 0x21, 0x23, 0x23}, 4);
    // VSHN Setting (-3.6V) VSHN1 VSHN2 VSHN3 VSHN4
    send_cmd(dev, 0xC4);
    send_data(dev, (uint8_t[]){0x5A, 0x5C, 0x5A, 0x5A}, 4);
    // VSLN Setting (0.22V) VSLN1 VSLN2 VSLN3 VSLN4
    send_cmd(dev, 0xC5);
    send_data(dev, (uint8_t[]){0x37, 0x35, 0x37, 0x37}, 4);
    // OSC Setting
    // Enable OSC, HPM Frame Rate Max = 51hZ
    send_cmd(dev, 0xD8);
    send_data(dev, (uint8_t[]){0x80, 0xE9}, 2);
    // Frame Rate Control
    /*-- HPM=51hz ; LPM=> 0x15=8Hz 0x14=4Hz 0x13=2Hz 0x12=1Hz 0x11=0.5Hz 0x10=0.25Hz---*/
    send_cmd(dev, 0xB2);
    send_data(dev, (uint8_t[]){0x12}, 1); // HPM=51hz ; LPM=1hz
    // Update Period Gate EQ Control in HPM
    send_cmd(dev, 0xB3);
    send_data(dev, (uint8_t[]){0xE5, 0xF6, 0x17, 0x77, 0x77, 0x77, 0x77, 0x77, 0x77, 0x71}, 10);
    // Update Period Gate EQ Control in LPM
    // LPM EQ Control
    send_cmd(dev, 0xB4);
    send_data(dev, (uint8_t[]){0x05, 0x46, 0x77, 0x77, 0x77, 0x77, 0x76, 0x45}, 8);
    // Gate Timing Control
    send_cmd(dev, 0x62);
    send_data(dev, (uint8_t[]){0x32, 0x03, 0x1F}, 3);
    // Source EQ Enable
    send_cmd(dev, 0xB7);
    send_data(dev, (uint8_t[]){0x13}, 1);
    // Gate Line Setting
    // 384 line = 96 * 4
    send_cmd(dev, 0xB0);
    send_data(dev, (uint8_t[]){0x60}, 1);
    // Sleep out
    send_cmd(dev, 0x11);
    vTaskDelay(pdMS_TO_TICKS(100));
    // Source Voltage Select
    // VSHP1; VSLP1 ; VSHN1 ; VSLN1
    send_cmd(dev, 0xC9);
    send_data(dev, (uint8_t[]){0x00}, 1);

    // Memory Data Access Control
    send_cmd(dev, 0x36);
    send_data(dev, (uint8_t[]){0x00}, 1); // Memory Data Access Control: MX=0 ; DO=0
    // send_data(dev, (uint8_t[]){0x48}, 1); // MX=1 ; DO=1
    // send_data(dev, (uint8_t[]){0x4C}, 1); //MX=1 ; DO=1 GS=1
    // Data Format Select
    send_cmd(dev, 0x3A);
    send_data(dev, (uint8_t[]){0x11}, 1); // 10:4write for 24bit ; 11: 3write for 24bit
    // Gamma Mode Setting
    send_cmd(dev, 0xB9);
    send_data(dev, (uint8_t[]){0x20}, 1); // 20: Mono 00:4GS
    // Panel Setting
    send_cmd(dev, 0xB8);
    send_data(dev, (uint8_t[]){0x29}, 1); // Panel Setting: 0x29: 1-Dot inversion, Frame inversion, One Line Interlace
    // WRITE RAM 168*384 Column Address Setting
    send_cmd(dev, 0x2A);
    send_data(dev, (uint8_t[]){0x17, 0x24}, 2); // 0X24-0X17=14 // 14*12=168
    // Row Address Setting
    send_cmd(dev, 0x2B);
    send_data(dev, (uint8_t[]){0x00, 0xBF}, 2); // 192*2=384
    // TE
    send_cmd(dev, 0x35);
    send_data(dev, (uint8_t[]){0x00}, 1);
    // Auto power dowb OFF
    send_cmd(dev, 0xD0);
    // send_data(dev, (uint8_t[]){0x7F}, 1);//Auto power dowb OFF
    send_data(dev, (uint8_t[]){0xFF}, 1); // Auto power dowb ON

    // send_cmd(dev, 0x39); //LPM:Low Power Mode ON
    send_cmd(dev, 0x38); // HPM:high Power Mode ON
    dev->lpmode = false;

    send_cmd(dev, ST7305_CMD_DISP_ON); // DISPLAY ON
    // send_cmd(dev, ST7305_CMD_DISP_OFF); //DISPLAY OFF

    // send_cmd(dev, ST7305_CMD_DISP_INV_ON); //Display Inversion On
    // send_cmd(dev, ST7305_CMD_DISP_INV_OFF); // Display Inversion Off

    // send_cmd(dev, 0xBB);                  // Enable Clear RAM
    // send_data(dev, (uint8_t[]){0x4F}, 1); // CLR=0 ; Enable Clear RAM,clear RAM to 0
    vTaskDelay(pdMS_TO_TICKS(100));
}

// 主初始化函数
esp_err_t st7305_init(const st7305_config_t *config, st7305_dev_t **ret_dev)
{
    if (config == NULL)
        return ESP_ERR_INVALID_ARG;
    st7305_dev_t *dev = calloc(1, sizeof(st7305_dev_t));
    if (!dev)
        return ESP_ERR_NO_MEM;

    dev->config = *config;

    // 配置GPIO
    gpio_reset_pin(config->dc_pin);
    gpio_set_direction(config->dc_pin, GPIO_MODE_OUTPUT);
    gpio_reset_pin(config->reset_pin);
    gpio_set_direction(config->reset_pin, GPIO_MODE_OUTPUT);

    // 先初始化总线
    spi_bus_config_t buscfg = {
        .mosi_io_num = config->sda_pin,
        .miso_io_num = -1, // 单色屏通常不需要MISO
        .sclk_io_num = config->scl_pin,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        .max_transfer_sz = 4096};
    ESP_ERROR_CHECK(spi_bus_initialize(config->host, &buscfg, SPI_DMA_CH_AUTO));
    // 配置SPI
    spi_device_interface_config_t devcfg = {
        .clock_speed_hz = config->clk_speed,
        .mode = 0,
        .spics_io_num = config->cs_pin,
        .queue_size = 3};
    ESP_ERROR_CHECK(spi_bus_add_device(config->host, &devcfg, &dev->spi));

    // 分配显存
    dev->framebuffer = heap_caps_malloc(8064, MALLOC_CAP_DMA);
    if (!dev->framebuffer)
    {
        free(dev);
        return ESP_ERR_NO_MEM;
    }

    // 初始化硬件
    hardware_reset(dev);
    initialize_sequence(dev);
    dev->initialized = true;

    ESP_LOGI(TAG, "st7305_init success\n");
    *ret_dev = dev;
    return ESP_OK;
}

// 清屏
void st7305_clear(st7305_dev_t *dev, uint8_t color)
{
    memset(dev->framebuffer, color ? 0xFF : 0x00, 8064);
}

// 刷新显示
void st7305_refresh(st7305_dev_t *dev)
{
    send_cmd(dev, ST7305_CMD_CASET);
    send_data(dev, (uint8_t[]){0x17, 0x24}, 2); // 0X24-0X17=14 // 14*4*3=168
    send_cmd(dev, ST7305_CMD_RASET);
    send_data(dev, (uint8_t[]){0x00, 0xBF}, 2); // 192*2=384
    send_cmd(dev, ST7305_CMD_RAMWR);
    send_data(dev, dev->framebuffer, 192 * 14 * 3);
}

// 绘制像素
void st7305_draw_pixel(st7305_dev_t *dev, int x, int y, uint8_t color)
{
    if (x >= dev->config.width || y >= dev->config.height)
        return;

    // 找到是哪一行的数据
    uint16_t real_x = x / 4; // 0->0, 3->0, 4->1, 7->1
    uint16_t real_y = y / 2; // 0->0, 1->0, 2->1, 3->1
    uint16_t write_byte_index = real_y * 42 + real_x;
    uint16_t one_two = (y % 2 == 0) ? 0 : 1; // 0 1
    uint16_t line_bit_4 = x % 4;             // 0 1 2 3
    uint8_t write_bit = 7 - (line_bit_4 * 2 + one_two);

    if (color)
        dev->framebuffer[write_byte_index] |= (1 << write_bit);
    else
        dev->framebuffer[write_byte_index] &= ~(1 << write_bit);
}

void st7305_sleep(st7305_dev_t *dev, bool enabled)
{
    if (enabled)
    {
        if (dev->lpmode)
        {
            send_cmd(dev, 0x38); // HPM:high Power Mode ON
            vTaskDelay(pdMS_TO_TICKS(300));
        }
        send_cmd(dev, 0x10); // sleep ON
        vTaskDelay(pdMS_TO_TICKS(100));
    }
    else
    {
        send_cmd(dev, 0x11); // sleep OFF
        vTaskDelay(pdMS_TO_TICKS(100));
    }
}

void st7305_set_power_mode(st7305_dev_t *dev, bool low_power)
{
    if (low_power)
    {
        dev->lpmode = true;
        send_cmd(dev, 0x39); // LPM:Low Power Mode ON
        vTaskDelay(pdMS_TO_TICKS(100));
    }
    else
    {
        dev->lpmode = false;
        send_cmd(dev, 0x38); // HPM:high Power Mode ON
        vTaskDelay(pdMS_TO_TICKS(300));
    }
}

void st7305_display_on(st7305_dev_t *dev, bool enabled)
{
    if (enabled)
        send_cmd(dev, ST7305_CMD_DISP_ON); // DISPLAY ON
    else
        send_cmd(dev, ST7305_CMD_DISP_OFF); // DISPLAY OFF
}

void st7305_display_inversion(st7305_dev_t *dev, bool enabled)
{
    if (enabled)
        send_cmd(dev, ST7305_CMD_DISP_INV_ON); // Display Inversion On
    else
        send_cmd(dev, ST7305_CMD_DISP_INV_OFF); // Display Inversion Off
}

uint16_t st7305_get_width(st7305_dev_t *dev)
{
    return dev->config.width;
}

uint16_t st7305_get_height(st7305_dev_t *dev)
{
    return dev->config.height;
}