给linux移植fbtft驱动st7735s小屏幕(f1c100s)

内核版本5.4
在使用spi总线接上了一个小网卡,实现了我们开发板对网络的访问之后,我还想接一个小的spi屏幕 1.44寸款,来画一只小企鹅,顺便显示一些系统的调试信息。但是由于我这个开发板向外暴露出来的spi接口就两个,而且有一个已经因为串口的设置而不能使用。所以我们只能让这个小屏幕和enc28j60共用一个spi外设。

内核配置

直接make menuconfig,进入Device Drivers,打开SPI,打开ST7735R的驱动。保存,再make -j16.

接线与修改设备树

我打算让enc28j60使用spi自己的cs作为片选线,然后另外找一个GPIO作为spi屏幕的片选。
那这样的话又得改设备树。我们这个spi屏幕的驱动器芯片是"st7735s"。但是linux有st7735r,这俩
是兼容的,可以直接用。

/ {
	model = "Lichee Pi Nano";
	compatible = "licheepi,licheepi-nano", "allwinner,suniv-f1c100s";

	aliases {
		serial1 = &uart1;
	};

	chosen {
		stdout-path = "serial1:115200n8";
		/delete-node/ framebuffer@0;
	};
	
	reg_vcc3v3: vcc3v3 {
			compatible = "regulator-fixed";
			regulator-name = "vcc3v3";
			regulator-min-microvolt = <3300000>;
			regulator-max-microvolt = <3300000>;
	};

	backlight: backlight {
		compatible = "gpio-backlight";
		gpios = <&pio 4 4 GPIO_ACTIVE_HIGH>;
		default-on;
	};
};

&spi1{
	status = "okay";
	pinctrl-names = "default";
	pinctrl-0 = <&spi1_pins>;
	cs-gpios = <0>,<&pio 4 5 GPIO_ACTIVE_LOW>;
	enc28j60: ethernet@0 {
		compatible = "microchip,enc28j60";
		pinctrl-names = "default";
		pinctrl-0 = <&enc28j60_pins>;
		reg = <0x0>;
		interrupt-parent = <&pio>;
		interrupts = <4 11 IRQ_TYPE_EDGE_FALLING>;
		spi-max-frequency = <12000000>;
	};
	display@1{
		compatible = "okaya,rh128128t", "sitronix,st7735r";
		reg = <0x1>;
		status = "okay";
		spi-max-frequency = <48000000>;
		spi-cpol;
		spi-cpha;
		bgr;
		rotate = <90>;
		fps = <30>;
		buswidth = <8>;
		dc-gpios = <&pio 4 2 GPIO_ACTIVE_HIGH>;
		reset-gpios = <&pio 4 3 GPIO_ACTIVE_LOW>;
		backlight = <&backlight>;
	};
};

我们在spi节点下增加了一个display设备,进入linux主线的设备的DTC绑定信息都是在内核源码中可以找得到的。例如我们要找"sitronix,st7735r"的设备树绑定信息,我们直接打开内核根目录,一搜,就可以在Documentation/devicetree/bindings/display/sitronix,st7735r.yaml找到我们要的信息。

这个yaml给的是最新的drm驱动匹配方式,不过我们目前还是使用比较简单,资料比较多的framebuffer TFT驱动比较好。下一次可以尝试用这个drm驱动。

我们这个spi屏幕由于和enc28j60共用一个spi,所以我们需要指定其片选。我们可以在spi节点下直接设置cs-gpios = <0>,<&pio 4 5 GPIO_ACTIVE_LOW>。这是什么意思呢?第一个<0>代表了对于第一个spi设备,我们使用spi默认的片选引脚。第二个<&pio 4 5 GPIO_ACTIVE_LOW>,代表的是我们指定第二个spi设备的片选引脚为PE5,并且低电平有效。GPIO_ACTIVE_LOW的意思是低电平有效,这样做可以在内核中配置不同设备的正负逻辑。

引脚正负逻辑与代码分析

fbtft设备在申请GPIO时,其实用的是gpio子系统的api。这些api用来用去最后是调用了

struct gpio_desc *of_find_gpio(struct device_node *np, const char *con_id,
			       unsigned int idx, unsigned long *flags)

它调用了

desc = of_get_named_gpiod_flags(np, prop_name, idx, &of_flags);
*flags = of_convert_gpio_flags(of_flags);

来获取设备树下gpio属性的flag。在设置gpio的输出值时,即调用gpiod_set_value时,会调用

static void gpiod_set_value_nocheck(struct gpio_desc *desc, int value)
{
	if (test_bit(FLAG_ACTIVE_LOW, &desc->flags))
		value = !value;
	if (test_bit(FLAG_OPEN_DRAIN, &desc->flags))
		gpio_set_open_drain_value_commit(desc, value);
	else if (test_bit(FLAG_OPEN_SOURCE, &desc->flags))
		gpio_set_open_source_value_commit(desc, value);
	else
		gpiod_set_raw_value_commit(desc, value);
}

所以我们在设备树中配置引脚的正负逻辑,会在这里被处理。如果是正逻辑,直接输出,如果是负逻辑,则需要取反。

配置引脚正负逻辑

为了知道我们到底应该在哪些引脚配置我们的正负逻辑,我们应该直接看源代码,因为压根就没有文档说这些。

static void fbtft_reset(struct fbtft_par *par)
{
	if (!par->gpio.reset)
		return;

	fbtft_par_dbg(DEBUG_RESET, par, "%s()\n", __func__);

	gpiod_set_value_cansleep(par->gpio.reset, 1);
	usleep_range(20, 40);
	gpiod_set_value_cansleep(par->gpio.reset, 0);
	msleep(120);

	gpiod_set_value_cansleep(par->gpio.cs, 1);  /* Activate chip */
}

RESET引脚在低电平的时候将会导致屏幕复位,Chip-Select在低电平时将会使能设备。所以这两个引脚都是负逻辑。我们应当在他们设备树的GPIO后边加一个GPIO_ACTIVE_LOW

上电测试

我上电后,屏幕一直白屏,调试了很久,代码改来改去,TF卡不知道插拔了多少次,也找不到原因。

最后插上逻辑分析仪,逻辑分析仪真的是电子工程师的眼睛,以前屏幕从来就没调通过,这次插了逻辑分析仪,能够分析逻辑后,调试就变得很容易了。一直看波形,发现RESET引脚一直被拉低。才发现原来linux的gpio子系统有这么一套正负逻辑的区别。

配置好之后,屏幕时好时坏。有多时好时坏呢,一插上逻辑分析仪,屏幕就成功初始化。一拔掉逻辑分析仪,这个屏幕又白屏了。最后一联想,就想到逻辑分析仪不是自带上拉吗?是不是因为我的RESET,CS,MOSI,CLK这些引脚都没有上拉?找了两个上拉电阻,一试,屏幕跑起来了!小企鹅出现了!

背光驱动的修改

其实我一开始把PE4的一个引脚设置为背光引脚(这样做似乎不太对,应该用mosfet或者三极管来驱动这个tft,因为电流大了会把f1c100s的引脚给烧了)。但是这个屏幕不知道为什么,就是不亮,亮都不亮一下。于是我就把这根线拔了,直接把TFT的LED引脚连了3V3。但是我觉得这样不够优雅,一定要让linux自己能够设置这个背光。

backlight: backlight {
    compatible = "gpio-backlight";
    gpios = <&pio 4 4 GPIO_ACTIVE_HIGH>;
    default-on;
};

这个backlight会注册一个class,位置在/sys/class/backlight/backlight,这个目录下有一个文件叫brightness,即亮度,可以通过echo 1 > brightness,打开我们的背光。

这里我们把gpio配置为正逻辑,这样1就对应着打开背光,符合人类的操作逻辑。

但是为什么,这个背光不工作呢?设置成1或者0,在调试后,发现

static int gpio_backlight_update_status(struct backlight_device *bl)
{
	struct gpio_backlight *gbl = bl_get_data(bl);
	int brightness = bl->props.brightness;

	if (bl->props.power != FB_BLANK_UNBLANK ||
	    bl->props.fb_blank != FB_BLANK_UNBLANK ||
	    bl->props.state & (BL_CORE_SUSPENDED | BL_CORE_FBBLANK))
		brightness = 0;

	gpiod_set_value_cansleep(gbl->gpiod, brightness);

	return 0;
}

是它判断这些power fb_blakn state的时候,直接把brightness设置成0了。我们直接去掉这几行代码。但是它调用gpiod_set_value_cansleep(gbl->gpiod, brightness);,我们的gpio也没有输出。

最后看了几遍代码,发现原来是它没有配置好gpio为输出。

static int gpio_backlight_probe_dt(struct platform_device *pdev,
				   struct gpio_backlight *gbl)
{
	struct device *dev = &pdev->dev;
	int ret;

	gbl->def_value = device_property_read_bool(dev, "default-on");

	gbl->gpiod = devm_gpiod_get(dev, NULL, GPIOD_ASIS);
	if (IS_ERR(gbl->gpiod)) {
		ret = PTR_ERR(gbl->gpiod);

		if (ret != -EPROBE_DEFER) {
			dev_err(dev,
				"Error: The gpios parameter is missing or invalid.\n");
		}
		return ret;
	}

	return 0;
}

问题就在gbl->gpiod = devm_gpiod_get(dev, NULL, GPIOD_ASIS);的这个GPIOD_ASIS

/**
 * enum gpiod_flags - Optional flags that can be passed to one of gpiod_* to
 *                    configure direction and output value. These values
 *                    cannot be OR'd.
 *
 * @GPIOD_ASIS:			Don't change anything
 * @GPIOD_IN:			Set lines to input mode
 * @GPIOD_OUT_LOW:		Set lines to output and drive them low
 * @GPIOD_OUT_HIGH:		Set lines to output and drive them high
 * @GPIOD_OUT_LOW_OPEN_DRAIN:	Set lines to open-drain output and drive them low
 * @GPIOD_OUT_HIGH_OPEN_DRAIN:	Set lines to open-drain output and drive them high
 */
enum gpiod_flags {
	GPIOD_ASIS	= 0,
	GPIOD_IN	= GPIOD_FLAGS_BIT_DIR_SET,
	GPIOD_OUT_LOW	= GPIOD_FLAGS_BIT_DIR_SET | GPIOD_FLAGS_BIT_DIR_OUT,
	GPIOD_OUT_HIGH	= GPIOD_FLAGS_BIT_DIR_SET | GPIOD_FLAGS_BIT_DIR_OUT |
			  GPIOD_FLAGS_BIT_DIR_VAL,
	GPIOD_OUT_LOW_OPEN_DRAIN = GPIOD_OUT_LOW | GPIOD_FLAGS_BIT_OPEN_DRAIN,
	GPIOD_OUT_HIGH_OPEN_DRAIN = GPIOD_OUT_HIGH | GPIOD_FLAGS_BIT_OPEN_DRAIN,
};

我们改成GPIOD_OUT_LOW,即成功解决问题。当然,最新的驱动已经修复了这些问题。

热门相关:有个人爱你很久   未来兽世:买来的媳妇,不生崽   后福   无关紧要的外遇   我更喜欢它,因为它有肉