【GD32307E-START】06 ST7735 SPI-LCD显示模块移植

软硬件平台

1. GD32F307E-START Board开发板
2. GCC Makefile
3. 1.8寸TFTLCD 分辨率128*160 驱动IC ST7735S
   
   

接口定义

ST7735的LCD模块有128x128, 128x160等不同分辨率, 对外的接线除了VCC和GND外有6根, 接线方式都是一样的

• SCL SPI时钟, 对应上位机SPI的SCK
• SDA SPI数据输入, 对应上位机SPI的MOSI
• RES 重启, 低电平有效, 工作时处于高电平
• DC 命令模式和数据模式切换位, 低电平为命令模式, 高电平为数据模式
• CS 片选信号, 对应上位机SPI的CS
• BL 背光, 高电平亮, 低电平灭

如果使用软件SPI, IO口可以随便选择, 如果是硬件SPI, 其中的CS, SCK, MOSI 和 MISO(ST7735未使用)只能使用特定的IO口。

SPI通信协议简介

CSX为从机片选，仅当CSX为低电平时，芯片才会被使能。D/CX为芯片的数据/命令控制引脚，当DCX为低电平时写命令，为高电平时写数据。SCL为SPI总线时钟，每个上升沿传输1bit数据；SDA为SPI传输的数据，一次传输8bit数据，数据格式如下图所示：

高位在前，先传输
对于SPI通信而言，数据是有传输时序的，即时钟相位（CPHA）与时钟极性（CPOL）的组合：
CPOL的高低决定串行同步时钟的空闲状态电平，CPOL=0，为低电平。CPOL对传输协议没有很多的影响；
CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集，当CPHL=0，在第一个跳变沿进行数据采集；

模拟SPI移植LCD屏幕

1. 工程模板建立

   在之前的gcc makefile的工程模板上进行添加文件，同时lcd部分代码参考梁山派GD32F4开发板资料进行。

   lcd_drive.c lcd_drive.h // lcd底层驱动文件，包括软件spi实现，lcd引脚配置，lcd初始化

   lcd_draw.c lcd_draw.h // lcd应用层文件，主要是绘图api实现（可以移植到其他开发板，不需要改，仅配置好驱动文件即可）

   

2. 配置引脚

   选择引脚，进入工程开始编写屏幕引脚初始化代码。

   为了方便后续移植，我在oled_driver.h处宏定义了每一个引脚，后续根据需要进行修改即可。

   //-----------------LCD屏幕接口宏定义---------------- 
   #define RCU_LCD_SCLK     RCU_GPIOB
   #define PORT_LCD_SCLK    GPIOB
   #define GPIO_LCD_SCLK    GPIO_PIN_10
   
   #define RCU_LCD_MOSI     RCU_GPIOB
   #define PORT_LCD_MOSI    GPIOB
   #define GPIO_LCD_MOSI    GPIO_PIN_11
   
   #define RCU_LCD_RES      RCU_GPIOB
   #define PORT_LCD_RES     GPIOB
   #define GPIO_LCD_RES     GPIO_PIN_12
   
   #define RCU_LCD_DC       RCU_GPIOB
   #define PORT_LCD_DC      GPIOB
   #define GPIO_LCD_DC      GPIO_PIN_13
   
   #define RCU_LCD_CS       RCU_GPIOB
   #define PORT_LCD_CS      GPIOB
   #define GPIO_LCD_CS      GPIO_PIN_14
   
   #define RCU_LCD_BLK      RCU_GPIOB
   #define PORT_LCD_BLK     GPIOB
   #define GPIO_LCD_BLK     GPIO_PIN_15
   

3. 引脚gpio初始化 （重点1）

   //==================================================================================================
   //  实现功能: LCD_GPIO_Init
   //  函数说明: 液晶IO初始化配置
   //  函数备注: 
   //--------------------------------------------------------------------------------------------------
   //  |   -   |   -   |   0   |   1   |   2   |   3   |   4   |   5   |   6   |   7   |   8   |   9   
   //==================================================================================================
   void lcd_gpio_init(void)
   {
     
     rcu_periph_clock_enable(RCU_LCD_SCLK);
     rcu_periph_clock_enable(RCU_LCD_MOSI);
     rcu_periph_clock_enable(RCU_LCD_RES);
     rcu_periph_clock_enable(RCU_LCD_DC);
     rcu_periph_clock_enable(RCU_LCD_CS);
     rcu_periph_clock_enable(RCU_LCD_BLK); 
   
     /* 配置SCLK SCL*/
     gpio_init(PORT_LCD_SCLK,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_SCLK);
     gpio_bit_write(PORT_LCD_SCLK, GPIO_LCD_SCLK, SET);
     /* 配置MOSI SDA */
     gpio_init(PORT_LCD_MOSI,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_MOSI);
     gpio_bit_write(PORT_LCD_MOSI, GPIO_LCD_MOSI, SET);
   
      /* 配置RES*/
     gpio_init(RCU_LCD_RES,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_RES);
     gpio_bit_write(RCU_LCD_RES, GPIO_LCD_RES, SET);
     /* 配置DC */
     gpio_init(PORT_LCD_DC,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_DC);
     gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET);
   
   
    /* 配置CS*/
     gpio_init(PORT_LCD_CS,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_CS);
     gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET);
     /* 配置BLK */
     gpio_init(PORT_LCD_BLK,GPIO_MODE_OUT_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_BLK);
     gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET);
   
   }
   

4. 端口宏定义设置

   #define SOFTWARE_SPI_ENABLE    1
   
   #if SOFTWARE_SPI_ENABLE  
   
   #define LCD_SCLK_Clr()  gpio_bit_reset(PORT_LCD_SCLK,GPIO_LCD_SCLK)//SCL=SCLK
   #define LCD_SCLK_Set()  gpio_bit_set(PORT_LCD_SCLK,GPIO_LCD_SCLK)
   
   #define LCD_MOSI_Clr()  gpio_bit_reset(PORT_LCD_MOSI,GPIO_LCD_MOSI)//SDA=MOSI
   #define LCD_MOSI_Set()  gpio_bit_set(PORT_LCD_MOSI,GPIO_LCD_MOSI)
   
       
   #define LCD_RES_Clr()   gpio_bit_reset(PORT_LCD_RES,GPIO_LCD_RES)//RES  rst
   #define LCD_RES_Set()   gpio_bit_set(PORT_LCD_RES,GPIO_LCD_RES)
   
   #define LCD_DC_Clr()    gpio_bit_reset(PORT_LCD_DC,GPIO_LCD_DC)//DC  data command select
   #define LCD_DC_Set()    gpio_bit_set(PORT_LCD_DC,GPIO_LCD_DC)
                
   
   #define LCD_CS_Clr()    gpio_bit_reset(PORT_LCD_CS,GPIO_LCD_CS)//CS
   #define LCD_CS_Set()    gpio_bit_set(PORT_LCD_CS,GPIO_LCD_CS)
   
   #define LCD_BLK_LOW()   gpio_bit_reset(PORT_LCD_BLK,GPIO_LCD_BLK)//BLK
   #define LCD_BLK_Set()   gpio_bit_set(PORT_LCD_BLK,GPIO_LCD_BLK)
   
   #endif
   

5. 软件SPI代码实现

   //==============================================
   //  实现功能: lcd_write_bus
   //  函数说明: 向SPI总线传输一个8位数据
   //==============================================
   void lcd_write_bus(unsigned char data)
   {
   	uint8_t i;
   	LCD_CS_Clr();
   	for(i=0;i<8;i++)
   	{			  
   		LCD_SCLK_Clr();
   		if(data&0x80)
   		{
   		   LCD_MOSI_Set();
   		}
   		else
   		{
   		   LCD_MOSI_Clr();
   		}
   		LCD_SCLK_Set();
   		data<<=1;
   	}	
     LCD_CS_Set();	
   }
   

   如果传输的数据位为1，则将SPI数据引脚拉高；传输的数据位为0，则将SPI数据引脚拉低。每次传输一个字节数据，高位在前，每个时钟上升沿传输1位数据。

6. LCD初始化函数

 //==================================================================================================
 //  实现功能: Lcd_Init
 //  函数说明: LCD硬件初始化
 //  函数备注: LCD Init For 1.70Inch LCD Panel with ST7735R.
 //--------------------------------------------------------------------------------------------------
 //  |   -   |   -   |   0   |   1   |   2   |   3   |   4   |   5   |   6   |   7   |   8   |   9   
 //==================================================================================================
 void lcd_init(void)
 {	
 	
 	
 	lcd_gpio_init();
     LCD_RES_Clr();//复位
 	delay_1ms(100);
 	LCD_RES_Set();
 	delay_1ms(50);
      //    LCD_BLK_Set();//打开背光
      //    delay_1ms(100);
 
 	lcd_writeindex(0x11);//Sleep exit 退出睡眠模式
 	delay_1ms(120);
 
 	lcd_writeindex(0xB1); 
 	lcd_writedata(0x05); 
 	lcd_writedata(0x3C); 
 	lcd_writedata(0x3C); 
 	lcd_writeindex(0xB2); 
 	lcd_writedata(0x05);
 	lcd_writedata(0x3C); 
 	lcd_writedata(0x3C); 
 	lcd_writeindex(0xB3); 
 	lcd_writedata(0x05); 
 	lcd_writedata(0x3C); 
 	lcd_writedata(0x3C); 
 	lcd_writedata(0x05); 
 	lcd_writedata(0x3C); 
 	lcd_writedata(0x3C); 
 	//------------------------------------End ST7735S Frame Rate---------------------------------// 
 	lcd_writeindex(0xB4); //Dot inversion 
 	lcd_writedata(0x03); 
 	//------------------------------------ST7735S Power Sequence---------------------------------// 
 	lcd_writeindex(0xC0); 
 	lcd_writedata(0x28); 
 	lcd_writedata(0x08); 
 	lcd_writedata(0x04); 
 	lcd_writeindex(0xC1); 
 	lcd_writedata(0XC0); 
 	lcd_writeindex(0xC2); 
 	lcd_writedata(0x0D); 
 	lcd_writedata(0x00); 
 	lcd_writeindex(0xC3); 
 	lcd_writedata(0x8D); 
 	lcd_writedata(0x2A); 
 	lcd_writeindex(0xC4); 
 	lcd_writedata(0x8D); 
 	lcd_writedata(0xEE); 
 	//---------------------------------End ST7735S Power Sequence-------------------------------------// 
 	lcd_writeindex(0xC5); //VCOM 
 	lcd_writedata(0x1A); 
 	lcd_writeindex(0x36); //MX, MY, RGB mode 
 	
 	if(USE_HORIZONTAL==0)
 		lcd_writedata(0x00);
 	else if(USE_HORIZONTAL==1)
 		lcd_writedata(0xC0);
 	else if(USE_HORIZONTAL==2)
 		lcd_writedata(0x70);
 	else 
 		lcd_writedata(0xA0); 
 	//------------------------------------ST7735S Gamma Sequence---------------------------------// 
 	lcd_writeindex(0xE0); 
 	lcd_writedata(0x04); 
 	lcd_writedata(0x22); 
 	lcd_writedata(0x07); 
 	lcd_writedata(0x0A); 
 	lcd_writedata(0x2E); 
 	lcd_writedata(0x30); 
 	lcd_writedata(0x25); 
 	lcd_writedata(0x2A); 
 	lcd_writedata(0x28); 
 	lcd_writedata(0x26); 
 	lcd_writedata(0x2E); 
 	lcd_writedata(0x3A); 
 	lcd_writedata(0x00); 
 	lcd_writedata(0x01); 
 	lcd_writedata(0x03); 
 	lcd_writedata(0x13); 
 	
 	lcd_writeindex(0xE1); 
 	lcd_writedata(0x04); 
 	lcd_writedata(0x16); 
 	lcd_writedata(0x06); 
 	lcd_writedata(0x0D); 
 	lcd_writedata(0x2D); 
 	lcd_writedata(0x26); 
 	lcd_writedata(0x23); 
 	lcd_writedata(0x27); 
 	lcd_writedata(0x27); 
 	lcd_writedata(0x25); 
 	lcd_writedata(0x2D); 
 	lcd_writedata(0x3B); 
 	lcd_writedata(0x00); 
 	lcd_writedata(0x01); 
 	lcd_writedata(0x04); 
 	lcd_writedata(0x13); 
 	//------------------------------------End ST7735S Gamma Sequence-----------------------------// 
 	lcd_writeindex(0x3A); //65k mode 
 	lcd_writedata(0x05); 
 	lcd_writeindex(0x29); //Display on
 }

7. 驱动完整代码见仓库代码

测试

1. 主函数

   #include "main.h"
   
   
   void Hardware_Init(void)
   {
   
       SystemInit (); 
       systick_config();
       bsp_uart_init();
       printf("SystemInit [ok] \r\n");
       printf("systick_config[ok] \r\n");
       printf("bsp_uart_init [ok] \r\n");
       HW_LED_Init();  
       printf("LED_Init [ok] \r\n");
       OLED_Init();
       printf("OLED_Init [ok] \r\n");
       lcd_init();
       printf("LCD_Init [ok] \r\n");
   }
   //==================================================================================================
   //  实现功能: oled_test测试函数
   //  函数说明: 采用软件IIC 进行配置   SDA PB9  SCL in 
   //  函数备注:  测试正常
   //--------------------------------------------------------------------------------------------------
   //  |   -   |   -   |   0   |   1   |   2   |   3   |   4   |   5   |   6   |   7   |   8   |   9   
   //==================================================================================================  
   void oled_example(void)
   {
         OLED_ShowString_08x16(0,0,"GD32 SWSPI OLED");
         OLED_ShowNumber_SignedInteger_06x08(16,2,1234,5);
         OLED_ShowNumber_UnsignedInteger_06x08(64,2,1234,4);
         OLED_ShowString_06x08(32,3,"Time:2023.12.03");
         OLED_ShowNumber_Float_06x08(32,4,123.46,3,3);
         OLED_ShowString_06x08(32,5,"By:Endhub");
         OLED_ShowCHinese(32,6,5);
         OLED_ShowCHinese(48,6,6);
         OLED_ShowCHinese(64,6,7);
         OLED_ShowCHinese(80,6,8);
         //OLED_Clear();
   }      
   
   int main(void)
   {
       // static uint8_t num   = 1;
       // num = num+1;
       // TFT_ShowNumber_UnsignedInteger_16x16(8,25,num,3,Blue1,White);
       // if (num >100)
       //   num = 0;
       // 
       Hardware_Init();
       printf("Hardware_Init [ok] \r\n");
       printf("GD32307E-START Baord Testing\r\n");
       printf("gd32f307_spi_lcd 20231216! \r\n");
       lcd_clear(White);               //清屏
       TFT_ShowString_16x16(0,5,"HELLO-GD32F307",Blue1,White);
       TFT_ShowString_16x16(0,25,"GD32-START Baord",Blue1,White);
       TFT_ShowString_16x16(0,45,"By 2023-12-17",Blue1,White);
       TFT_ShowString_16x16(0,65,"By CoderEnd",Blue1,White);
       TFT_ShowChinese(0,90,0,16,Gray0,Red);
       TFT_ShowChinese(20,90,1,16,Gray0,Red);
       TFT_ShowChinese(40,90,2,16,Gray0,Red);
       TFT_ShowChinese(60,90,3,16,Gray0,Red);
       TFT_ShowChinese(80,90,4,16,Gray0,Red);
   
       while(1)
       { 
   
       }
   }
   

2. 效果

本栏目推荐文章
• openpyxl模块---------------------------------------------提取身份证信息及计算年龄
• argparse模块的使用
• IDEA项目名称后面出现中括号，模块Modules的名子和文件夹名称不同，可以右键修改名称也可以在File->Project Structure 修改Modules的Name(快捷键ctrl+Shift+Alt+s)
• openpyxl模块--------------------------------重复数据
• NUS CS1101S：SICP JavaScript 描述：三、模块化、对象和状态
• 测试模块是否导入成功
• 【C语言】模块划分、编译器工作原理
• openpyxl模块------------------------------------------统计加班时间
• pickle模块
• 学习方法：知识模块

模块 E-START SPI-LCD 32307 START模块e-start spi-lcd 32307 模块spi-oled e-start 32307 tinymaix e-start数字32307 rt-thread e-start thread 32307 e-start 模板e-start环境 工程 spi-lcd 32307 start start-dfs