SPI LCD Controller ST7735 Driver 更多...

#include <xwos/standard.h>
#include <xwcd/ds/spi/peripheral.h>
#include <xwcd/peripheral/spi/lcd/st7735/device.h>

driver.h 的引用(Include)关系图:

此图展示该文件直接或间接的被哪些文件引用了:

结构体
struct	xwds_st7735_driver
	ST7735驱动函数表更多...

函数

xwer_t	xwds_st7735_drv_start (struct xwds_device *dev)
	ST7735基本驱动：启动设备

xwer_t	xwds_st7735_drv_stop (struct xwds_device *dev)
	ST7735基本驱动：停止设备

xwer_t	xwds_st7735_drv_resume (struct xwds_device *dev)
	ST7735基本驱动：暂停设备

xwer_t	xwds_st7735_drv_suspend (struct xwds_device *dev)
	ST7735基本驱动：继续设备

xwer_t	xwds_st7735_read_id (struct xwds_st7735 st7735, xwu32_t id, xwtm_t to)
	ST7735 API：读取ID

xwer_t	xwds_st7735_read_status (struct xwds_st7735 *st7735, xwu8_t st[5], xwtm_t to)
	ST7735 API：读取状态

xwer_t	xwds_st7735_read_madctl (struct xwds_st7735 *st7735, xwu8_t madctl[2], xwtm_t to)
	ST7735 API：读取RDDMADCTL寄存器的值

xwer_t	xwds_st7735_read_colmod (struct xwds_st7735 *st7735, xwu8_t colmod[2], xwtm_t to)
	ST7735 API：读取RDDCOLMOD寄存器的值

xwer_t	xwds_st7735_display_on (struct xwds_st7735 *st7735, xwtm_t to)
	ST7735 API：开启显示

xwer_t	xwds_st7735_display_off (struct xwds_st7735 *st7735, xwtm_t to)
	ST7735 API：关闭显示

xwer_t	xwds_st7735_set_brightness (struct xwds_st7735 *st7735, xwu32_t brightness)
	ST7735 API：设置亮度

void	xwds_st7735_get_brightness (struct xwds_st7735 st7735, xwu32_t brightness)
	ST7735 API：读取亮度

xwer_t	xwds_st7735_set_orientation (struct xwds_st7735 *st7735, xwu8_t orientation, xwtm_t to)
	ST7735 API：设置显示方向

void	xwds_st7735_get_orientation (struct xwds_st7735 st7735, xwu8_t orientation)
	ST7735 API：读取显示方向

xwer_t	xwds_st7735_set_cursor (struct xwds_st7735 *st7735, xwu8_t x, xwu8_t y, xwtm_t to)
	ST7735 API：设置光标坐标

xwer_t	xwds_st7735_set_window (struct xwds_st7735 *st7735, xwu8_t x, xwu8_t y, xwu8_t width, xwu8_t height, xwtm_t to)
	ST7735 API：设置窗口

xwer_t	xwds_st7735_invert_color (struct xwds_st7735 *st7735, bool inv, xwtm_t to)
	ST7735 API：设置是否翻转颜色

xwer_t	xwds_st7735_set_pixel (struct xwds_st7735 *st7735, xwu8_t x, xwu8_t y, xwu16_t color, xwtm_t to)
	ST7735 API：设置点的颜色

xwer_t	xwds_st7735_fill_rect (struct xwds_st7735 *st7735, xwu8_t x, xwu8_t y, xwu8_t width, xwu8_t height, xwu16_t color, xwtm_t to)
	ST7735 API：绘制矩形

xwer_t	xwds_st7735_draw (struct xwds_st7735 *st7735, xwu8_t x, xwu8_t y, xwu8_t width, xwu8_t height, const xwu8_t img[], xwtm_t to)
	ST7735 API：绘制位图

详细描述

SPI LCD Controller ST7735 Driver

作者

隐星魂 (Roy Sun) xwos@.nosp@m.xwos.nosp@m..tech

Copyright © 2015 xwos.tech, All Rights Reserved.
‍Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
```
  http://www.apache.org/licenses/LICENSE-2.0
```
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

注解

所有API只可被单一线程访问。

在文件 driver.h 中定义.

函数说明

◆ xwds_st7735_display_off()

xwer_t xwds_st7735_display_off	(	struct xwds_st7735 *	st7735,
		xwtm_t	to
	)

ST7735 API：关闭显示

参数

[in]	st7735	ST7735对象指针
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

在文件 driver.c 第 379 行定义.

{
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        return xwds_st7735_write(st7735,
                                 XWDS_ST7735_DISPOFF, NULL, 0,
                                 to);
}

函数调用图:

◆ xwds_st7735_display_on()

xwer_t xwds_st7735_display_on	(	struct xwds_st7735 *	st7735,
		xwtm_t	to
	)

ST7735 API：开启显示

参数

[in]	st7735	ST7735对象指针
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

在文件 driver.c 第 369 行定义.

{
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        return xwds_st7735_write(st7735,
                                 XWDS_ST7735_DISPON, NULL, 0,
                                 to);
}

函数调用图:

◆ xwds_st7735_draw()

xwer_t xwds_st7735_draw	(	struct xwds_st7735 *	st7735,
		xwu8_t	x,
		xwu8_t	y,
		xwu8_t	width,
		xwu8_t	height,
		const xwu8_t	img[],
		xwtm_t	to
	)

ST7735 API：绘制位图

参数

[in]	st7735	ST7735对象指针
[in]	x	位图起始点X轴坐标
[in]	y	位图起始点Y轴坐标
[in]	width	位图的宽
[in]	height	位图的高
[in]	img	位图数组的指针
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

在文件 driver.c 第 660 行定义.

{
        xwer_t rc;
        xwsz_t total;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(image, "nullptr", -EFAULT);
 
        rc = xwds_st7735_set_window(st7735, x, y, width, height, to);
        if (rc < 0) {
                goto err_set_window;
        }
 
        total = (xwsz_t)width * (xwsz_t)height * (xwsz_t)2;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_RAMWR, img, total,
                               to);
 
err_set_window:
        return rc;
}

函数调用图:

◆ xwds_st7735_drv_resume()

xwer_t xwds_st7735_drv_resume ( struct xwds_device * dev )

ST7735基本驱动：暂停设备

在文件 driver.c 第 269 行定义.

{
        return xwds_st7735_drv_start(dev);
}

函数调用图:

◆ xwds_st7735_drv_start()

xwer_t xwds_st7735_drv_start ( struct xwds_device * dev )

ST7735基本驱动：启动设备

<No error

在文件 driver.c 第 104 行定义.

{
        struct xwds_st7735 * st7735;
        struct xwds_st7735_parameter * param;
        struct xwds_st7735_driver * drv;
        const struct xwds_st7735_cmd_table * init;
        xwu8_t buffer[4];
        xwsq_t i;
        xwtm_t to;
        xwer_t rc;
 
        st7735 = xwds_cast(struct xwds_st7735 *, dev);
        param = &st7735->parameter;
        drv = xwds_cast(struct xwds_st7735_driver *, st7735->spip.dev.drv);
        init = xwds_st7735_init_table;
 
        if (!((drv) && (drv->write) && (drv->read))) {
                rc = -EINVAL;
                goto err_drv;
        }
        if (!((XWDS_ST7735_ORIENTATION_PORTRAIT == param->orientation) ||
              (XWDS_ST7735_ORIENTATION_PORTRAIT_ROT180 == param->orientation) ||
              (XWDS_ST7735_ORIENTATION_LANDSCAPE == param->orientation) ||
              (XWDS_ST7735_ORIENTATION_LANDSCAPE_ROT180 == param->orientation))) {
                rc = -EINVAL;
                goto err_param;
        }
        if (!(XWDS_ST7735_FORMAT_RBG565 == param->pixelformat)) {
                rc = -EINVAL;
                goto err_param;
        }
        if (!((XWDS_ST7735_INVERSION_OFF == param->inversion) ||
              (XWDS_ST7735_INVERSION_ON == param->inversion))) {
                rc = -EINVAL;
                goto err_param;
        }
        if (!((XWDS_ST7735_RGBSEQ_RGB == param->rgbseq) ||
              (XWDS_ST7735_RGBSEQ_BGR == param->rgbseq))) {
                rc = -EINVAL;
                goto err_param;
        }
 
        /* Init process */
        to = XWTM_MAX;
        for (i = 0; i < xw_array_size(xwds_st7735_init_table); i++) {
                rc = xwds_st7735_write(st7735,
                                       init[i].reg, init[i].data, init[i].size,
                                       to);
                if (rc < 0) {
                        goto err_write;
                }
        }
 
        /* Set color mode */
        buffer[0] = param->pixelformat;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_COLMOD, buffer, 1,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Set inversion mode */
        if (XWDS_ST7735_INVERSION_ON == param->inversion) {
                rc = xwds_st7735_write(st7735,
                                       XWDS_ST7735_INVON, NULL, 0,
                                       to);
        } else {
                rc = xwds_st7735_write(st7735,
                                       XWDS_ST7735_INVOFF, NULL, 0,
                                       to);
        }
        if (rc < 0) {
                goto err_write;
        }
 
        /* Set the display orientation & RGB seq */
        buffer[0] = param->orientation | param->rgbseq;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_MADCTL, buffer, 1,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Column Address Set */
        buffer[0] = 0;
        buffer[1] = param->width_offset;
        buffer[2] = 0;
        buffer[3] = param->width + param->width_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_CASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Row Address Set */
        buffer[0] = 0;
        buffer[1] = param->height_offset;
        buffer[2] = 0;
        buffer[3] = param->height + param->height_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_RASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Display On */
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_DISPON, NULL, 0,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Set brightness */
        rc = xwds_st7735_set_brightness(st7735, param->brightness);
        if (rc < 0) {
                goto err_set_brightness;
        }
        return XWOK;
 
err_set_brightness:
err_write:
err_param:
err_drv:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

◆ xwds_st7735_drv_stop()

xwer_t xwds_st7735_drv_stop ( struct xwds_device * dev )

ST7735基本驱动：停止设备

<No error

在文件 driver.c 第 242 行定义.

{
        struct xwds_st7735 * st7735;
        const struct xwds_st7735_cmd_table * deinit;
        xwsq_t i;
        xwtm_t to;
        xwer_t rc;
 
        st7735 = xwds_cast(struct xwds_st7735 *, dev);
        deinit = xwds_st7735_deinit_table;
        to = XWTM_MAX;
        for (i = 0; i < xw_array_size(xwds_st7735_deinit_table); i++) {
                rc = xwds_st7735_write(st7735,
                                       deinit[i].reg, deinit[i].data, deinit[i].size,
                                       to);
                if (rc < 0) {
                        goto err_write;
                }
        }
        return XWOK;
 
err_write:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

◆ xwds_st7735_drv_suspend()

xwer_t xwds_st7735_drv_suspend ( struct xwds_device * dev )

ST7735基本驱动：继续设备

在文件 driver.c 第 275 行定义.

{
        return xwds_st7735_drv_stop(dev);
}

函数调用图:

◆ xwds_st7735_fill_rect()

xwer_t xwds_st7735_fill_rect	(	struct xwds_st7735 *	st7735,
		xwu8_t	x,
		xwu8_t	y,
		xwu8_t	width,
		xwu8_t	height,
		xwu16_t	color,
		xwtm_t	to
	)

ST7735 API：绘制矩形

参数

[in]	st7735	ST7735对象指针
[in]	x	矩形起始点X轴坐标
[in]	y	矩形起始点Y轴坐标
[in]	width	矩形的宽
[in]	height	矩形的高
[in]	color	填充颜色的RGB565值
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 615 行定义.

{
        xwer_t rc;
        xwsz_t i, total, wrsz;
        xwu8_t fb[64];
        xwu8_t colorh, colorl;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        colorh = color >> 8;
        colorl = color & 0xFF;
        for (i = 0; i < sizeof(fb); i = i + 2) {
                fb[i] = colorh;
                fb[i + 1] = colorl;
        }
        rc = xwds_st7735_set_window(st7735, x, y, width, height, to);
        if (rc < 0) {
                goto err_set_window;
        }
        total = (xwsz_t)width * (xwsz_t)height * (xwsz_t)2;
        wrsz = 0;
        while (wrsz < total) {
                if (wrsz + sizeof(fb) < total) {
                        i = sizeof(fb);
                } else {
                        i = total - wrsz;
                }
                rc = xwds_st7735_write(st7735,
                                       XWDS_ST7735_RAMWR, fb, i,
                                       to);
                if (rc < 0) {
                        goto err_write;
                }
                wrsz += i;
        }
        return XWOK;
 
err_write:
err_set_window:
        return rc;
}

函数调用图:

◆ xwds_st7735_get_brightness()

void xwds_st7735_get_brightness	(	struct xwds_st7735 *	st7735,
		xwu32_t *	brightness
	)

ST7735 API：读取亮度

参数

[in]	st7735	ST7735对象指针
[out]	brightness	指向缓冲区的指针，通过此缓冲区返回亮度

返回: 错误码

注解

上下文：线程

在文件 driver.c 第 409 行定义.

{
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(brightness, "nullptr", -EFAULT);
 
        *brightness = st7735->parameter.brightness;
}

◆ xwds_st7735_get_orientation()

void xwds_st7735_get_orientation	(	struct xwds_st7735 *	st7735,
		xwu8_t *	orientation
	)

ST7735 API：读取显示方向

参数

[in]	st7735	ST7735对象指针
[out]	orientation	指向缓冲区的指针，通过此缓冲区返回显示方向

返回: 错误码

注解

上下文：线程

在文件 driver.c 第 472 行定义.

{
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(orientation, "nullptr", -EFAULT);
 
        *orientation = st7735->parameter.orientation;
}

◆ xwds_st7735_invert_color()

xwer_t xwds_st7735_invert_color	(	struct xwds_st7735 *	st7735,
		bool	inv,
		xwtm_t	to
	)

ST7735 API：设置是否翻转颜色

参数

[in]	st7735	ST7735对象指针
[in]	inv	是否翻转颜色
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

在文件 driver.c 第 572 行定义.

{
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        if (inv) {
                rc = xwds_st7735_write(st7735,
                                       XWDS_ST7735_INVON, NULL, 0,
                                       to);
        } else {
                rc = xwds_st7735_write(st7735,
                                       XWDS_ST7735_INVOFF, NULL, 0,
                                       to);
        }
        return rc;
}

函数调用图:

◆ xwds_st7735_read_colmod()

xwer_t xwds_st7735_read_colmod	(	struct xwds_st7735 *	st7735,
		xwu8_t	colmod[2],
		xwtm_t	to
	)

ST7735 API：读取RDDCOLMOD寄存器的值

参数

[in]	st7735	ST7735对象指针
[out]	colmod	指向缓冲区的指针，通过此缓冲区返回寄存器的值
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 347 行定义.

{
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(id, "nullptr", -EFAULT);
 
        rc = xwds_st7735_grab(st7735);
        if (rc < 0) {
                goto err_st7735_grab;
        }
        rc = xwds_st7735_read(st7735, XWDS_ST7735_RDDCOLMOD, colmod, 2, to);
        xwds_st7735_put(st7735);
        return XWOK;
 
err_st7735_grab:
        return rc;
}

函数调用图:

◆ xwds_st7735_read_id()

xwer_t xwds_st7735_read_id	(	struct xwds_st7735 *	st7735,
		xwu32_t *	id,
		xwtm_t	to
	)

ST7735 API：读取ID

参数

[in]	st7735	ST7735对象指针
[out]	id	指向缓冲区的指针，通过此缓冲区返回ID
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 283 行定义.

{
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(id, "nullptr", -EFAULT);
 
        rc = xwds_st7735_grab(st7735);
        if (rc < 0) {
                goto err_st7735_grab;
        }
        rc = xwds_st7735_read(st7735, XWDS_ST7735_RDDID, (xwu8_t *)id, 4, to);
        xwds_st7735_put(st7735);
        return XWOK;
 
err_st7735_grab:
        return rc;
}

函数调用图:

◆ xwds_st7735_read_madctl()

xwer_t xwds_st7735_read_madctl	(	struct xwds_st7735 *	st7735,
		xwu8_t	madctl[2],
		xwtm_t	to
	)

ST7735 API：读取RDDMADCTL寄存器的值

参数

[in]	st7735	ST7735对象指针
[out]	madctl	指向缓冲区的指针，通过此缓冲区返回寄存器的值
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 325 行定义.

{
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(id, "nullptr", -EFAULT);
 
        rc = xwds_st7735_grab(st7735);
        if (rc < 0) {
                goto err_st7735_grab;
        }
        rc = xwds_st7735_read(st7735, XWDS_ST7735_RDDMADCTL, madctl, 2, to);
        xwds_st7735_put(st7735);
        return XWOK;
 
err_st7735_grab:
        return rc;
}

函数调用图:

◆ xwds_st7735_read_status()

xwer_t xwds_st7735_read_status	(	struct xwds_st7735 *	st7735,
		xwu8_t	st[5],
		xwtm_t	to
	)

ST7735 API：读取状态

参数

[in]	st7735	ST7735对象指针
[out]	st	指向缓冲区的指针，通过此缓冲区返回状态
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 303 行定义.

{
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE(id, "nullptr", -EFAULT);
 
        rc = xwds_st7735_grab(st7735);
        if (rc < 0) {
                goto err_st7735_grab;
        }
        rc = xwds_st7735_read(st7735, XWDS_ST7735_RDDST, st, 5, to);
        xwds_st7735_put(st7735);
        return XWOK;
 
err_st7735_grab:
        return rc;
}

函数调用图:

◆ xwds_st7735_set_brightness()

xwer_t xwds_st7735_set_brightness	(	struct xwds_st7735 *	st7735,
		xwu32_t	brightness
	)

ST7735 API：设置亮度

参数

[in]	st7735	ST7735对象指针
[in]	brightness	亮度

返回: 错误码

注解

上下文：线程

<No error

在文件 driver.c 第 389 行定义.

{
        struct xwds_st7735_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        drv = xwds_cast(struct xwds_st7735_driver *, st7735->spip.dev.drv);
        if ((drv) && (drv->set_brightness)) {
                rc = drv->set_brightness(st7735, brightness);
                if (XWOK == rc) {
                        st7735->parameter.brightness = brightness;
                }
        } else {
                rc = -ENOSYS;
        }
        return rc;
}

这是这个函数的调用关系图:

◆ xwds_st7735_set_cursor()

xwer_t xwds_st7735_set_cursor	(	struct xwds_st7735 *	st7735,
		xwu8_t	x,
		xwu8_t	y,
		xwtm_t	to
	)

ST7735 API：设置光标坐标

参数

[in]	st7735	ST7735对象指针
[in]	x	X轴坐标
[in]	y	Y轴坐标
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 481 行定义.

{
        struct xwds_st7735_parameter * param;
        xwu8_t buffer[4];
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        param = &st7735->parameter;
 
        XWDS_VALIDATE((x < param->width), "nullptr", -ERANGE);
        XWDS_VALIDATE((y < param->height), "nullptr", -ERANGE);
 
        /* Column Address Set */
        buffer[0] = 0;
        buffer[1] = x + param->width_offset;
        buffer[2] = 0;
        buffer[3] = param->width + param->width_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_CASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Row Address Set */
        buffer[0] = 0;
        buffer[1] = y + param->height_offset;
        buffer[2] = 0;
        buffer[3] = param->height + param->height_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_RASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
        return XWOK;
 
err_write:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

◆ xwds_st7735_set_orientation()

xwer_t xwds_st7735_set_orientation	(	struct xwds_st7735 *	st7735,
		xwu8_t	orientation,
		xwtm_t	to
	)

ST7735 API：设置显示方向

参数

[in]	st7735	ST7735对象指针
[in]	orientation	方向

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 418 行定义.

{
        struct xwds_st7735_parameter * param;
        xwu8_t tmp;
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        XWDS_VALIDATE(((XWDS_ST7735_ORIENTATION_PORTRAIT == orientation) ||
                       (XWDS_ST7735_ORIENTATION_LANDSCAPE_ROT180 == orientation) ||
                       (XWDS_ST7735_ORIENTATION_PORTRAIT == orientation) ||
                       (XWDS_ST7735_ORIENTATION_LANDSCAPE_ROT180 == orientation)),
                      "nullptr", -EINVAL);
 
        param = &st7735->parameter;
        tmp = orientation;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_MADCTL, &tmp, 1,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        if ((XWDS_ST7735_ORIENTATION_PORTRAIT == param->orientation) ||
            (XWDS_ST7735_ORIENTATION_PORTRAIT_ROT180 == param->orientation)) {
                if ((XWDS_ST7735_ORIENTATION_LANDSCAPE == orientation) ||
                    (XWDS_ST7735_ORIENTATION_LANDSCAPE_ROT180 == orientation)) {
                        tmp = param->width;
                        param->width = param->height;
                        param->height = tmp;
                        tmp = param->width_offset;
                        param->width_offset = param->height_offset;
                        param->height_offset = tmp;
                }
        } else {
                if ((XWDS_ST7735_ORIENTATION_PORTRAIT == orientation) ||
                    (XWDS_ST7735_ORIENTATION_PORTRAIT_ROT180 == orientation)) {
                        tmp = param->width;
                        param->width = param->height;
                        param->height = tmp;
                        tmp = param->width_offset;
                        param->width_offset = param->height_offset;
                        param->height_offset = tmp;
                }
        }
        param->orientation = orientation;
        return XWOK;
 
err_write:
        return rc;
}

函数调用图:

◆ xwds_st7735_set_pixel()

xwer_t xwds_st7735_set_pixel	(	struct xwds_st7735 *	st7735,
		xwu8_t	x,
		xwu8_t	y,
		xwu16_t	color,
		xwtm_t	to
	)

ST7735 API：设置点的颜色

参数

[in]	st7735	ST7735对象指针
[in]	x	点X轴坐标
[in]	y	点Y轴坐标
[in]	color	颜色的RGB565值
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

在文件 driver.c 第 591 行定义.

{
        xwu8_t buffer[2];
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
 
        rc = xwds_st7735_set_cursor(st7735, x, y, to);
        if (rc < 0) {
                goto err_set_cursor;
        }
        buffer[0] = color >> 8;
        buffer[1] = color & 0xFF;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_RAMWR, buffer, 2,
                               to);
 
err_set_cursor:
        return rc;
}

函数调用图:

◆ xwds_st7735_set_window()

xwer_t xwds_st7735_set_window	(	struct xwds_st7735 *	st7735,
		xwu8_t	x,
		xwu8_t	y,
		xwu8_t	width,
		xwu8_t	height,
		xwtm_t	to
	)

ST7735 API：设置窗口

参数

[in]	st7735	ST7735对象指针
[in]	x	窗口起始点X轴坐标
[in]	y	窗口起始点Y轴坐标
[in]	width	窗口的宽
[in]	height	窗口的高
[in]	to	期望唤醒的时间点

返回: 错误码

注解

上下文：线程

to 表示等待超时的时间点：

to 通常是未来的时间，即 当前系统时间 + delta ，可以使用 xwtm_ft(delta) 表示；
如果 to 是过去的时间点，将直接返回 -ETIMEDOUT 。

<No error

在文件 driver.c 第 525 行定义.

{
        struct xwds_st7735_parameter * param;
        xwu8_t buffer[4];
        xwer_t rc;
 
        XWDS_VALIDATE(st7735, "nullptr", -EFAULT);
        XWDS_VALIDATE((x < width), "nullptr", -ERANGE);
        XWDS_VALIDATE((y < height), "nullptr", -ERANGE);
 
        param = &st7735->parameter;
 
        XWDS_VALIDATE((width < param->width), "nullptr", -ERANGE);
        XWDS_VALIDATE((height < param->height), "nullptr", -ERANGE);
 
        /* Column Address Set */
        buffer[0] = 0;
        buffer[1] = x + param->width_offset;
        buffer[2] = 0;
        buffer[3] = width + param->width_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_CASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
 
        /* Row Address Set */
        buffer[0] = 0;
        buffer[1] = y + param->height_offset;
        buffer[2] = 0;
        buffer[3] = height + param->height_offset - 1;
        rc = xwds_st7735_write(st7735,
                               XWDS_ST7735_RASET, buffer, 4,
                               to);
        if (rc < 0) {
                goto err_write;
        }
        return XWOK;
 
err_write:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

结构体

函数

详细描述

函数说明

◆ xwds_st7735_display_off()

◆ xwds_st7735_display_on()

◆ xwds_st7735_draw()

◆ xwds_st7735_drv_resume()

◆ xwds_st7735_drv_start()

◆ xwds_st7735_drv_stop()

◆ xwds_st7735_drv_suspend()

◆ xwds_st7735_fill_rect()

◆ xwds_st7735_get_brightness()

◆ xwds_st7735_get_orientation()

◆ xwds_st7735_invert_color()

◆ xwds_st7735_read_colmod()

◆ xwds_st7735_read_id()

◆ xwds_st7735_read_madctl()

◆ xwds_st7735_read_status()

◆ xwds_st7735_set_brightness()

◆ xwds_st7735_set_cursor()

◆ xwds_st7735_set_orientation()

◆ xwds_st7735_set_pixel()

◆ xwds_st7735_set_window()