Orangepi zero2w 驱动st7789v

移植
1.1修改设备树，添加st7789v节点
文件路径：arch/arm64/boot/dts/allwinner/sun50i-h616-orangepi-zero3.dts

&spi1  {
    #address-cells = <1>;
    #size-cells = <0>;
 
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&spi1_pins>,<&spi1_cs0_pins>;
 
    st7789v@1{
        compatible = "sitronix,st7789v";
        reg = <0>;
        status="okay";
        spi-max-frequency = <48000000>;
        rotate = <0>;
        fps = <60>;
        buswidth = <8>;
        dc = <&pio 8 5 GPIO_ACTIVE_HIGH>;//PI5
        reset = <&pio 7 3 GPIO_ACTIVE_HIGH>;//PH3
        //led = <&pio 2 9 GPIO_ACTIVE_HIGH>;//按照自己屏幕需求配置
        debug = <0>;
    };
};
1.2HDMI输出关闭，不关闭spi屏不会有显示
文件路径：arch/arm64/boot/dts/allwinner/sun50i-h616-orangepi-zero3.dts

&hdmi {
    //hvcc-supply = <&reg_bldo1>;
    status = "disabled";
};
1.3配置spi管脚，并上拉管脚
文件路径：arch/arm64/boot/dts/allwinner/sun50i-h616.dtsi

    spi1_pins: spi1-pins {
        pins = "PH6", "PH7"，PH8;
        function = "spi1";
        bias-pull-up; //管脚上拉
    };

2.1修改驱动文件
文件路径：drivers/staging/fbtft/fb_st7789v.c
 

// SPDX-License-Identifier: GPL-2.0+
/*
 * FB driver for the ST7789V LCD Controller
 *
 * Copyright (C) 2015 Dennis Menschel
 */
 
#include <linux/bitops.h>
#include <linux/delay.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <video/mipi_display.h>
#include <linux/gpio.h>
 
#include "fbtft.h"
 
#define DRVNAME "fb_st7789v"
 
#define DEFAULT_GAMMA \
    "D0 04 0D 11 13 2B 3F 54 4C 18 0D 0B 1F 23\n" \
    "D0 04 0C 11 13 2C 3F 44 51 2F 1F 1F 20 23"
 
/**
 * enum st7789v_command - ST7789V display controller commands
 *
 * @PORCTRL: porch setting
 * @GCTRL: gate control
 * @VCOMS: VCOM setting
 * @VDVVRHEN: VDV and VRH command enable
 * @VRHS: VRH set
 * @VDVS: VDV set
 * @VCMOFSET: VCOM offset set
 * @PWCTRL1: power control 1
 * @PVGAMCTRL: positive voltage gamma control
 * @NVGAMCTRL: negative voltage gamma control
 *
 * The command names are the same as those found in the datasheet to ease
 * looking up their semantics and usage.
 *
 * Note that the ST7789V display controller offers quite a few more commands
 * which have been omitted from this list as they are not used at the moment.
 * Furthermore, commands that are compliant with the MIPI DCS have been left
 * out as well to avoid duplicate entries.
 */
enum st7789v_command {
    PORCTRL = 0xB2,
    GCTRL = 0xB7,
    VCOMS = 0xBB,
    LCMCTRL = 0xC0,
    VDVVRHEN = 0xC2,
    VRHS = 0xC3,
    VDVS = 0xC4,
    VCMOFSET = 0xC5,
    FRCTRL2 = 0xC6,
    PWCTRL1 = 0xD0,
    PVGAMCTRL = 0xE0,
    NVGAMCTRL = 0xE1,
};
 
#define MADCTL_BGR BIT(3) /* bitmask for RGB/BGR order */
#define MADCTL_MV BIT(5) /* bitmask for page/column order */
#define MADCTL_MX BIT(6) /* bitmask for column address order */
#define MADCTL_MY BIT(7) /* bitmask for page address order */
 
 
 
/**
 * init_display() - initialize the display controller
 *
 * @par: FBTFT parameter object
 *
 * Most of the commands in this init function set their parameters to the
 * same default values which are already in place after the display has been
 * powered up. (The main exception to this rule is the pixel format which
 * would default to 18 instead of 16 bit per pixel.)
 * Nonetheless, this sequence can be used as a template for concrete
 * displays which usually need some adjustments.
 *
 * Return: 0 on success, < 0 if error occurred.
 */
static int init_display(struct fbtft_par *par)
{
    par->fbtftops.reset(par);
    mdelay(50);
    write_reg(par,0x11);
    
    mdelay(120);
    write_reg(par,0x36,0x00);
    write_reg(par,0x3A,0x05);
    write_reg(par,0xB2,0x0C,0x0C,0x00,0x33,0x33);
    write_reg(par,0xB7,0x35);
    write_reg(par,0xBB,0x19);
    write_reg(par,0xC0,0x2C);
    write_reg(par,0xC2,0x01);
    write_reg(par,0xC3,0x12);
    write_reg(par,0xC4,0x20);
    write_reg(par,0xC6,0x0F);
    write_reg(par,0xD0,0xA4,0xA1);
    write_reg(par,0xE0,0xD0,0x04,0x0D,0x11,0x13,0x2B,0x3F,0x54,0x4C,0x18,0x0D,0x0B,0x1F,0x23);
    write_reg(par,0xE1,0xD0,0x04,0x0C,0x11,0x13,0x2C,0x3F,0x44,0x51,0x2F,0x1F,0x1F,0x20,0x23);
    write_reg(par,0x21);
//    write_reg(par,0x11);
//    mdelay(50);
    write_reg(par,0x29);
    mdelay(200);
    pr_info("fbtft_%s ok!\n", __func__);
    return 0;
}
 
static void set_addr_win(struct fbtft_par *par, int xs, int ys, int xe, int ye)
{
    write_reg(par, MIPI_DCS_SET_COLUMN_ADDRESS,
          xs >> 8, xs & 0xFF, xe >> 8, xe & 0xFF);
 
    write_reg(par, MIPI_DCS_SET_PAGE_ADDRESS,
          ys >> 8, ys & 0xFF, ye >> 8, ye & 0xFF);
 
    write_reg(par, MIPI_DCS_WRITE_MEMORY_START);
}
 
 
/**
 * set_var() - apply LCD properties like rotation and BGR mode
 *
 * @par: FBTFT parameter object
 *
 * Return: 0 on success, < 0 if error occurred.
 */
static int set_var(struct fbtft_par *par)
{
    u8 madctl_par = 0;
 
    if (par->bgr)
        madctl_par |= MADCTL_BGR;
    switch (par->info->var.rotate) {
    case 0:
        break;
    case 90:
        madctl_par |= (MADCTL_MV | MADCTL_MY);
        break;
    case 180:
        madctl_par |= (MADCTL_MX | MADCTL_MY);
        break;
    case 270:
        madctl_par |= (MADCTL_MV | MADCTL_MX);
        break;
    default:
        return -EINVAL;
    }
    write_reg(par, MIPI_DCS_SET_ADDRESS_MODE, madctl_par);
    return 0;
}
 
/**
 * set_gamma() - set gamma curves
 *
 * @par: FBTFT parameter object
 * @curves: gamma curves
 *
 * Before the gamma curves are applied, they are preprocessed with a bitmask
 * to ensure syntactically correct input for the display controller.
 * This implies that the curves input parameter might be changed by this
 * function and that illegal gamma values are auto-corrected and not
 * reported as errors.
 *
 * Return: 0 on success, < 0 if error occurred.
 */
static int set_gamma(struct fbtft_par *par, u32 *curves)
{
    int i;
    int j;
    int c; /* curve index offset */
 
    /*
     * Bitmasks for gamma curve command parameters.
     * The masks are the same for both positive and negative voltage
     * gamma curves.
     */
    static const u8 gamma_par_mask[] = {
        0xFF, /* V63[3:0], V0[3:0]*/
        0x3F, /* V1[5:0] */
        0x3F, /* V2[5:0] */
        0x1F, /* V4[4:0] */
        0x1F, /* V6[4:0] */
        0x3F, /* J0[1:0], V13[3:0] */
        0x7F, /* V20[6:0] */
        0x77, /* V36[2:0], V27[2:0] */
        0x7F, /* V43[6:0] */
        0x3F, /* J1[1:0], V50[3:0] */
        0x1F, /* V57[4:0] */
        0x1F, /* V59[4:0] */
        0x3F, /* V61[5:0] */
        0x3F, /* V62[5:0] */
    };
 
    for (i = 0; i < par->gamma.num_curves; i++) {
        c = i * par->gamma.num_values;
        for (j = 0; j < par->gamma.num_values; j++)
            curves[c + j] &= gamma_par_mask[j];
        write_reg(par, PVGAMCTRL + i,
              curves[c + 0],  curves[c + 1],  curves[c + 2],
              curves[c + 3],  curves[c + 4],  curves[c + 5],
              curves[c + 6],  curves[c + 7],  curves[c + 8],
              curves[c + 9],  curves[c + 10], curves[c + 11],
              curves[c + 12], curves[c + 13]);
    }
    return 0;
}
 
/**
 * blank() - blank the display
 *
 * @par: FBTFT parameter object
 * @on: whether to enable or disable blanking the display
 *
 * Return: 0 on success, < 0 if error occurred.
 */
static int blank(struct fbtft_par *par, bool on)
{
    if (on)
        write_reg(par, MIPI_DCS_SET_DISPLAY_OFF);
    else
        write_reg(par, MIPI_DCS_SET_DISPLAY_ON);
    return 0;
}
 
static struct fbtft_display display = {
    .regwidth = 8,
    .width = 240,
    .height = 240,
    .gamma_num = 2,
    .gamma_len = 14,
    .gamma = DEFAULT_GAMMA,
    .fbtftops = {
        .init_display = init_display,
        .set_addr_win = set_addr_win,
        .set_var = set_var,
        .set_gamma = set_gamma,
        .blank = blank,
    },
};
 
FBTFT_REGISTER_DRIVER(DRVNAME, "sitronix,st7789v", &display);
 
MODULE_ALIAS("spi:" DRVNAME);
MODULE_ALIAS("platform:" DRVNAME);
MODULE_ALIAS("spi:st7789v");
MODULE_ALIAS("platform:st7789v");
 
MODULE_DESCRIPTION("FB driver for the ST7789V LCD Controller");
MODULE_AUTHOR("Dennis Menschel");
MODULE_LICENSE("GPL");

2.2修改fbtft-core.c
文件路径：drivers/staging/fbtft/fbtft-core.c
添加头文件

#include <linux/gpio.h>
#include <linux/of_gpio.h>

static int fbtft_request_one_gpio(struct fbtft_par *par,
                  const char *name, int index,
                  struct gpio_desc **gpiop)
{
    struct device *dev = par->info->device;
    struct device_node *node = dev->of_node;
    int gpio, flags, ret = 0;
    enum of_gpio_flags of_flags;
 
    if (of_find_property(node, name, NULL)) {
        gpio = of_get_named_gpio_flags(node, name, index, &of_flags);
        if (gpio == -ENOENT)
            return 0;
        if (gpio == -EPROBE_DEFER)
            return gpio;
        if (gpio < 0) {
            dev_err(dev,
                "failed to get '%s' from DT\n", name);
            return gpio;
        }
 
         //active low translates to initially low 
        flags = (of_flags & OF_GPIO_ACTIVE_LOW) ? GPIOF_OUT_INIT_LOW :
                            GPIOF_OUT_INIT_HIGH;
        ret = devm_gpio_request_one(dev, gpio, flags,
                        dev->driver->name);
        if (ret) {
            dev_err(dev,
                "gpio_request_one('%s'=%d) failed with %d\n",
                name, gpio, ret);
            return ret;
        }
 
        *gpiop = gpio_to_desc(gpio);
        fbtft_par_dbg(DEBUG_REQUEST_GPIOS, par, "%s: '%s' = GPIO%d\n",
                            __func__, name, gpio);
    }
 
    return ret;
}

static void fbtft_reset(struct fbtft_par *par)
{
    if (!par->gpio.reset)
        return;
 
    gpiod_set_value_cansleep(par->gpio.reset, 1);
    msleep(10);
    gpiod_set_value_cansleep(par->gpio.reset, 0);
    msleep(200);
    gpiod_set_value_cansleep(par->gpio.reset, 1);  /* Activate chip */
    msleep(10);
}
3.1编译配置

把st7789v驱动并编译进内核中，如下：
Device Drivers —>　　
　　　　[*] Staging drivers —>　　
　　　　　　　　<*> Support for small TFT LCD display modules —>
　　　　　　　　　　　　　　<*> FB driver for the ST7789V LCD Controller