ST7735S简介

ST7735S 是一款由台湾晶宏科技（Sitronix Technology Corp.）生产的单芯片TFT LCD驱动控制器。它被广泛应用于各种需要彩色显示功能的中小型电子设备中，以其高性价比、低功耗和易于集成的特点而备受工程师和爱好者的青睐。

数据手册

ST7735S数据手册

屏幕模块

我使用的是一块来自淘宝上购买的1.8寸，128*160分辨率，SPI协议的TFT_LCD屏幕模块，店铺链接 台湾铼宝[OLED]

产品参数

接口定义

以上信息来自 台湾铼宝[OLED]

ST7735驱动

使用 afiskon 大佬的开源库 stm32-st7735 ，将 Adafruit 的 ST7735 库移植到了 STM32 上.

作者原文链接 : https://eax.me/stm32-st7735/ ，在使用之前推荐阅读一下.

使用说明

1. 配置引脚及屏幕参数

在st7735.h文件中，修改句柄以及引脚定义

同样的，在该文件中，作者提供了一些屏幕参数预设，可以根据描述，找到符合你的屏幕模块对应参数，取消注释使用.

对于我购买的这款屏幕，参数应为：

这个宏定义表示当前使用的是160×128分辨率的屏幕。值为1表示启用此配置。

这两个宏定义了屏幕的实际显示区域尺寸：宽度为128像素，高度为160像素。

这两个宏定义了显示内容的起始偏移量：

• X轴（水平方向）起始偏移量为2像素
• Y轴（垂直方向）起始偏移量为1像素

注意坐标轴原点为左上角的像素点，向右向下为正。

这个宏定义了屏幕的旋转方向和颜色顺序，它是通过组合以下几个控制位实现的：

• ST7735MADCTLMX （值为0x40）：启用X轴镜像/水平翻转
• ST7735MADCTLMY （值为0x80）：启用Y轴镜像/垂直翻转
• ST7735MADCTLRGB （值为0x00）：设置RGB颜色顺序（而不是BGR） 这些位是通过ST7735控制器的MADCTL（存储器访问控制）寄存器设置的，用于控制显示方向和颜色格式。

文件中还定义了其他MADCTL控制位，虽然当前配置未使用，但它们提供了更多显示选项：

• ST7735MADCTLMV （值为0x20）：行/列交换，用于90°或270°旋转
• ST7735MADCTLML （值为0x10）：LCD刷新顺序（垂直刷新方向）
• ST7735MADCTLBGR （值为0x08）：设置BGR颜色顺序（而不是RGB）
• ST7735MADCTLMH （值为0x04）：LCD刷新顺序（水平刷新方向）

驱动函数说明

初始化函数

void ST7735_Init(void)

• 功能：初始化ST7735 LCD控制器。
• 参数：无
• 返回值：无
• 说明：在使用其他任何函数前必须先调用此函数进行初始化。初始化过程包括：硬件复位、发送初始化命令序列、配置显示方向等。

绘制像素点函数

void ST7735_DrawPixel(uint16_t x, uint16_t y, uint16_t color)

• 功能：在指定坐标绘制一个像素点。
• 参数：
  • x：X坐标，范围0~ ST7735_WIDTH - 1
  • y：Y坐标，范围0~ ST7735_HEIGHT - 1
  • color：像素颜色，16位RGB565格式
• 返回值：无
• 说明：如果坐标超出显示范围，函数将直接返回不执行任何操作。

• 使用示例

  CodeBlock Loading...

绘制填充矩形函数

void ST7735_FillRectangle(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color)

• 功能：绘制一个填充矩形。
• 参数：
  • x：矩形左上角X坐标
  • y：矩形左上角Y坐标
  • w：矩形宽度
  • h：矩形高度
  • color：填充颜色，16位RGB565格式
• 返回值：无
• 说明：如果矩形部分超出显示范围，会自动裁剪到显示区域内。
• 使用示例

快速绘制填充矩形函数

void ST7735_FillRectangleFast(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color)

• 功能：使用优化算法快速绘制填充矩形。
• 参数：
  • x：矩形左上角X坐标
  • y：矩形左上角Y坐标
  • w：矩形宽度
  • h：矩形高度
  • color：填充颜色，16位RGB565格式
• 返回值：无
• 说明：此函数通过预先准备整行数据并一次性传输，比ST7735_FillRectangle更高效，适合绘制较大面积的矩形。
• 使用示例

填充屏幕函数

void ST7735_FillScreen(uint16_t color)

• 功能：用指定颜色填充整个屏幕。
• 参数：
  • color：填充颜色，16位RGB565格式
• 返回值：无
• 说明：内部调用ST7735_FillRectangle实现。
• 使用示例

快速填充屏幕函数

void ST7735_FillScreen(uint16_t color)

• 功能：快速填充整个屏幕。
• 参数：
  • color：填充颜色，16位RGB565格式
• 返回值：无
• 说明：内部调用ST7735FillRectangleFast实现，比ST7735FillScreen更高效。
• 使用示例

文本显示函数

void ST7735_WriteString(uint16_t x, uint16_t y, const char* str, FontDef font, uint16_t color, uint16_t bgcolor)

• 功能：在指定位置显示字符串。
• 参数：
  • x：字符串起始X坐标
  • y：字符串起始Y坐标
  • str：要显示的字符串
  • font：字体定义，可选值为Font7x10、Font11x18等（在fonts.h中定义）
  • color：文本颜色，16位RGB565格式
  • bgcolor：背景颜色，16位RGB565格式
• 返回值：无
• 说明：
  • 如果字符串超出屏幕右边界，会自动换行继续显示
  • 如果字符串超出屏幕底部边界，会停止显示
  • 换行时会自动跳过行首的空格字符
• 使用示例

图像显示函数

void ST7735_DrawImage(uint16_t x, uint16_t y, uint16_t w, uint16_t h, const uint16_t* data)

• 功能：在指定位置显示图像。
• 参数：
  • x：图像左上角X坐标
  • y：图像左上角Y坐标
  • w：图像宽度
  • h：图像高度
  • data：图像数据指针，16位RGB565格式的数组
• 返回值：无
• 说明：
  • 图像数据必须是16位RGB565格式
  • 如果图像超出显示范围，函数将直接返回不执行任何操作
• 使用示例

反转颜色函数

void ST7735_WriteString(uint16_t x, uint16_t y, const char* str, FontDef font, uint16_t color, uint16_t bgcolor)

• 功能：反转显示颜色。
• 参数：
  • invert：是否反转颜色，true表示反转，false表示正常显示
• 返回值：无
• 说明：
  • 颜色反转后，原来的黑色变为白色，白色变为黑色，其他颜色也会相应反转。
• 使用示例

设置伽马值函数

void ST7735_WriteString(uint16_t x, uint16_t y, const char* str, FontDef font, uint16_t color, uint16_t bgcolor)

• 功能：设置显示伽马值。
• 参数：
  • gamma：伽马值，可选值为：
    • GAMMA_10：伽马值1.0
    • GAMMA_25：伽马值2.5
    • GAMMA_22：伽马值2.2
    • GAMMA_18：伽马值1.8
• 返回值：无
• 说明：不同的伽马值会影响显示的亮度和对比度。
• 使用示例

显示效果

图中是我使用ST7735_DrawImage( )函数将一个128*160的图片显示到lcd屏幕上

推荐的图片取模软件：【硬件图片取模软件！支持单色与彩色，图片编辑与裁剪以及阈值调整！】