RT-Thread-RT-Thread Studio使用记录（七）STemWinRT-Thread问答社区

RT-Thread Studio使用记录（七）STemWin

发布于 2021-01-30 09:07:13 浏览：3672 订阅该版

[RT-Thread Studio使用记录（一）点亮led](https://club.rt-thread.org/ask/article/2519.html)
[RT-Thread Studio使用记录（二）pwm呼吸灯](https://club.rt-thread.org/ask/article/2520.html)
[RT-Thread Studio使用记录（三）flash挂载文件系统](https://club.rt-thread.org/ask/article/2521.html)
[RT-Thread Studio使用记录（四）SD-Card 挂载文件系统](https://club.rt-thread.org/ask/article/2526.html)
[RT-Thread Studio使用记录（五）USB 虚拟串口](https://club.rt-thread.org/ask/article/2524.html)
[RT-Thread Studio使用记录（六）ESP8266网络设备](https://club.rt-thread.org/ask/article/2527.html)
[RT-Thread Studio使用记录（七）STemWin](https://club.rt-thread.org/ask/article/2529.html)
[RT-Thread Studio使用记录（八）LittlevGL2RTT](https://club.rt-thread.org/ask/article/2530.html)
[RT-Thread Studio使用记录（九）LittlevGL2RTT触摸屏](https://club.rt-thread.org/ask/article/2531.html)
[RT-Thread Studio使用记录（十）LittlevGL2RTT 贪吃蛇](https://club.rt-thread.org/ask/article/2534.html)
[RT-Thread Studio使用记录（十一）LittlevGL2RTT 贪吃蛇+俄罗斯方块](https://club.rt-thread.org/ask/article/2544.html)

本章使用 RT-Thread 的 STemWin 软件包，使用 STM32 的 FSMC 接口做 lcd 的驱动，运行STemWin 的例程。
为节省片上 flash 和 ram ，后续章节都不使用 AT 设备， 也不挂载文件系统。

参考：[RT-Thread学习笔记系列之LCD驱动及emwin示例](https://blog.csdn.net/weixin_39137443/article/details/109962978)，[在 studio 中添加emwin，编译报错问题](https://club.rt-thread.org/ask/question/424997.html)

1、 打开 RT-Thread Settings, 使能 STemWin 软件包。

![rt-settings.png](https://oss-club.rt-thread.org/uploads/20210130/c9e139f3a1cbb3187880bfc6ad4eaa87.png)

2、 打开 CubeMX 配置文件，配置 FSMC 选项。删除生成的 main.c 及 stm32f4xx_it.c ，注释掉 stm32f4xx_fal_msp.c 中的 ' #include "main.h" '，并添加 ' #include "drv_common.c" '。

![原理图.png](https://oss-club.rt-thread.org/uploads/20210130/efa9636da5a203b58605402263a46488.png)

![cube-config.png](https://oss-club.rt-thread.org/uploads/20210130/52a02adc1bfb728b38e9a65ff1336cd2.png)

3、打开 SRAM 和 CRC 模块使能。此处用的 stm32f4xx_hal_conf.h 文件是在 drivers 文件夹中，不是上一步生成的那个。

![hal-config.png](https://oss-club.rt-thread.org/uploads/20210130/33d83c81967f9c524fc458574b8624c6.png)

4、添加 stm32f4xx_II_fsmc.c 到 libraries/STM32F4xx_HAL_Driver/Src 文件夹。
复制 STemWin_CM4_OS_wc16_ot.lib 改名为 libSTemWin_CM4_OS_wc16_ot.a 。
在 GUI_Test.c 中添加 CRC 使能代码。
详情请参阅参考连接。

![II-fsmc.png](https://oss-club.rt-thread.org/uploads/20210130/0705c15c407963111fbdcb0bd342e34e.png)

![lib.png](https://oss-club.rt-thread.org/uploads/20210130/f61c2bb2f16c5fa67b383bc643267591.png)

![CRC.png](https://oss-club.rt-thread.org/uploads/20210130/74eb15997289722202cbf3041fbcbfdb.png)

5、复制 packages/STemWin-latest/demo 文件夹中的 drv_lcd.c 和 drv_lcd.h 两个文件到 drivers 文件夹。 LCD 的驱动芯片为 ILI9481 ，根据 ILI9481 的驱动例程，更改文件内容如下：

![驱动文件.png](https://oss-club.rt-thread.org/uploads/20210130/a27bc91e27b1ba348f247998570bab36.png)

```

#ifndef __DRV_LCD_H
#define __DRV_LCD_H
#include <rtthread.h>
#include "rtdevice.h"
#include <drv_common.h>

//LCD重要参数集
typedef struct  
{		 	 
	uint16_t width;			//LCD 宽度
	uint16_t height;			//LCD 高度
	uint16_t id;				//LCD ID
	uint8_t  dir;			//横屏还是竖屏控制：0，竖屏；1，横屏。
	uint16_t wramcmd;		//开始写gram指令
	uint16_t setxcmd;		//设置x坐标指令
	uint16_t setycmd;		//设置y坐标指令
}_lcd_dev;

//LCD参数
extern _lcd_dev lcddev;	//管理LCD重要参数

typedef struct
{
  __IO uint16_t REG;
  __IO uint16_t RAM;
}LCD_CONTROLLER_TypeDef;

//扫描方向定义
#define L2R_U2D  0 		//从左到右,从上到下
#define L2R_D2U  1 		//从左到右,从下到上
#define R2L_U2D  2 		//从右到左,从上到下
#define R2L_D2U  3 		//从右到左,从下到上

#define U2D_L2R  4 		//从上到下,从左到右
#define U2D_R2L  5 		//从上到下,从右到左
#define D2U_L2R  6 		//从下到上,从左到右
#define D2U_R2L  7		//从下到上,从右到左

#define DFT_SCAN_DIR  L2R_U2D  //默认的扫描方向

//LCD分辨率设置
#define SSD_HOR_RESOLUTION		480		//LCD水平分辨率
#define SSD_VER_RESOLUTION		273		//LCD垂直分辨率
//LCD驱动参数设置
#define SSD_HOR_PULSE_WIDTH		1		//水平脉宽
#define SSD_HOR_BACK_PORCH		46		//水平前廊
#define SSD_HOR_FRONT_PORCH		210		//水平后廊

#define SSD_VER_PULSE_WIDTH		1		//垂直脉宽
#define SSD_VER_BACK_PORCH		23		//垂直前廊
#define SSD_VER_FRONT_PORCH		22		//垂直前廊
//如下几个参数，自动计算
#define SSD_HT	(SSD_HOR_RESOLUTION+SSD_HOR_BACK_PORCH+SSD_HOR_FRONT_PORCH)
#define SSD_HPS	(SSD_HOR_BACK_PORCH)
#define SSD_VT 	(SSD_VER_RESOLUTION+SSD_VER_BACK_PORCH+SSD_VER_FRONT_PORCH)
#define SSD_VPS (SSD_VER_BACK_PORCH)

void LCD_Clear(uint16_t color);
void LCD_Fast_DrawPoint(const char *pixel, int x, int y);
void LCD_HLine(const char *pixel, int x1, int x2, int y);
void LCD_VLine(const char *pixel, int x, int y1, int y2);

#endif

```

#include <board.h>
#include "drv_lcd.h"
#include "string.h"

//#define DRV_DEBUG
#define LOG_TAG "drv.lcd"
#include <drv_log.h>

_lcd_dev lcddev;
SRAM_HandleTypeDef hsram1;

#define LCD_BL GET_PIN(D, 12)
#define LCD_BASE ((uint32_t)(0x60000000 | 0x0001FFFE))
#define LCD ((LCD_CONTROLLER_TypeDef *)LCD_BASE)

#define LCD_DEVICE(dev) (struct drv_lcd_device *)(dev)

struct drv_lcd_device
{
    struct rt_device parent;

struct rt_device_graphic_info lcd_info;
};
static struct drv_lcd_device _lcd;

//写寄存器函数
//regval:寄存器值
void LCD_WR_REG(uint16_t regval)
{
    LCD->REG = regval; //写入要写的寄存器序号
}
//写LCD数据
//data:要写入的值
void LCD_WR_DATA(uint16_t data)
{
    LCD->RAM = data;
}
//读LCD数据
//返回值:读到的值
uint16_t LCD_RD_DATA(void)
{
    return LCD->RAM;
}
//写寄存器
//LCD_Reg:寄存器地址
//LCD_RegValue:要写入的数据
void LCD_WriteReg(uint16_t LCD_Reg, uint16_t LCD_RegValue)
{
    LCD->REG = LCD_Reg;      //写入要写的寄存器序号
    LCD->RAM = LCD_RegValue; //写入数据
}
//读寄存器
//LCD_Reg:寄存器地址
//返回值:读到的数据
uint16_t LCD_ReadReg(uint16_t LCD_Reg)
{
    LCD_WR_REG(LCD_Reg);  //写入要读的寄存器序号
    return LCD_RD_DATA(); //返回读到的值
}
//开始写GRAM
void LCD_WriteRAM_Prepare(void)
{
    LCD->REG = lcddev.wramcmd;
}
//LCD写GRAM
//RGB_Code:颜色值
void LCD_WriteRAM(uint16_t RGB_Code)
{
    LCD->RAM = RGB_Code; //写十六位GRAM
}

//从ILI93xx读出的数据为GBR格式，而我们写入的时候为RGB格式。
//通过该函数转换
//c:GBR格式的颜色值
//返回值：RGB格式的颜色值
uint16_t LCD_BGR2RGB(uint16_t c)
{
    uint16_t r, g, b, rgb;
    b = (c >> 0) & 0x1f;
    g = (c >> 5) & 0x3f;
    r = (c >> 11) & 0x1f;
    rgb = (b << 11) + (g << 5) + (r << 0);
    return (rgb);
}

//设置光标位置(对RGB屏无效)
//Xpos:横坐标
//Ypos:纵坐标
void LCD_SetCursor(uint16_t Xstart, uint16_t Xend, uint16_t Ystart, uint16_t Yend)
{
    Ystart += 24;
    Yend   += 24;

LCD->REG = 0x2a;
    LCD->RAM = Xstart>>8;
    LCD->RAM = (Xstart&0xff);
    LCD->RAM = (Xend>>8);
    LCD->RAM = (Xend&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((Ystart)>>8);
    LCD->RAM = ((Ystart)&0xff);
    LCD->RAM = ((Yend)>>8);
    LCD->RAM = ((Yend)&0xff);
}

//读取个某点的颜色值
//x,y:坐标
//返回值:此点的颜色
void LCD_ReadPoint(char *pixel, int x, int y)
{
    uint16_t *color = (uint16_t *)pixel;
    uint16_t r = 0, g = 0, b = 0;
    int temp = y+24;
    if (x >= lcddev.width || y >= lcddev.height)
    {
        *color = 0; //超过了范围,直接返回
        return;
    }
    LCD->REG = 0x2a;
    LCD->RAM = x>>8;
    LCD->RAM = (x&0xff);
    LCD->RAM = (x>>8);
    LCD->RAM = (x&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((temp)>>8);
    LCD->RAM = ((temp)&0xff);
    LCD->RAM = ((temp)>>8);
    LCD->RAM = ((temp)&0xff);

LCD->REG = (0x2e);

r = LCD->RAM;      //dummy Read
    r = LCD->RAM;
    g = LCD->RAM;
    b = LCD->RAM;

*color = ((r&0xf8)<<8) + ((g&0xfc)<<3) + ((b&0xf8)>>3); //ILI9341/NT35310/NT35510需要公式转换一下
}
//LCD开启显示
void LCD_DisplayOn(void)
{
    LCD_WR_REG(0X29); //开启显示
}
//LCD关闭显示
void LCD_DisplayOff(void)
{
    LCD_WR_REG(0X28); //关闭显示
}

//快速画点
//x,y:坐标
//color:颜色
void LCD_Fast_DrawPoint(const char *pixel, int x, int y)
{
    uint16_t color = *((uint16_t *)pixel);
    int temp = y+24;

LCD->REG = 0x2a;
    LCD->RAM = x>>8;
    LCD->RAM = (x&0xff);
    LCD->RAM = (x>>8);
    LCD->RAM = (x&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((temp)>>8);
    LCD->RAM = ((temp)&0xff);
    LCD->RAM = ((temp)>>8);
    LCD->RAM = ((temp)&0xff);

LCD->REG = (0x2C);

LCD->RAM = color>>8;
    LCD->RAM = color;
}

//清屏函数
//color:要清屏的填充色
void LCD_Clear(uint16_t color)
{
    uint32_t index = 0;
    uint32_t totalpoint = lcddev.width;
    totalpoint *= lcddev.height; //得到总点数
    LCD_SetCursor(0, lcddev.width, 0, lcddev.height); //设置光标位置
    LCD_WriteRAM_Prepare();      //开始写入GRAM
    for (index = 0; index < totalpoint; index++)
    {
        LCD->RAM = color>>8;
        LCD->RAM = color;
    }
}

void LCD_HLine(const char *pixel, int x1, int x2, int y)
{
    int xsize = x2 - x1 + 1;

LCD->REG = 0x2a;
    LCD->RAM = x1>>8;
    LCD->RAM = (x1&0xff);
    LCD->RAM = (x2>>8);
    LCD->RAM = (x2&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((y+24)>>8);
    LCD->RAM = ((y+24)&0xff);
    LCD->RAM = ((y+24)>>8);
    LCD->RAM = ((y+24)&0xff);

LCD->REG = (0x2C);

uint16_t *p = (uint16_t *)pixel;
    for (; xsize > 0; xsize--)
    {
        LCD->RAM = *p>>8;
        LCD->RAM = *p;
    }
}

void LCD_VLine(const char *pixel, int x, int y1, int y2)
{
    int ysize = y2 - y1 + 1;

LCD->REG = 0x2a;
    LCD->RAM = x>>8;
    LCD->RAM = (x&0xff);
    LCD->RAM = (x>>8);
    LCD->RAM = (x&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((y1+24)>>8);
    LCD->RAM = ((y1+24)&0xff);
    LCD->RAM = ((y2+24)>>8);
    LCD->RAM = ((y2+24)&0xff);

LCD->REG = (0x2C);

uint16_t *p = (uint16_t *)pixel;
    for (; ysize > 0; ysize--)
    {
        LCD->RAM = *p>>8;
        LCD->RAM = *p;
    }
}

void LCD_BlitLine(const char *pixel, int x, int y, rt_size_t size)
{
    LCD->REG = 0x2a;
    LCD->RAM = x>>8;
    LCD->RAM = (x&0xff);
    LCD->RAM = ((x+size)>>8);
    LCD->RAM = ((x+size)&0xff);

LCD->REG = (0x2b);
    LCD->RAM = ((y+24)>>8);
    LCD->RAM = ((y+24)&0xff);
    LCD->RAM = ((y+24)>>8);
    LCD->RAM = ((y+24)&0xff);

LCD->REG = (0x2C);
    uint16_t *p = (uint16_t *)pixel;
    for (; size > 0; size--, p++)
    {
        LCD->RAM = *p>>8;
        LCD->RAM = *p;
    }
}

static rt_err_t drv_lcd_init(struct rt_device *device)
{
    FSMC_NORSRAM_TimingTypeDef Timing;
    static SRAM_HandleTypeDef* hsram;
    
    __HAL_RCC_GPIOD_CLK_ENABLE();
    __HAL_RCC_GPIOE_CLK_ENABLE();
    __HAL_RCC_GPIOF_CLK_ENABLE();
    __HAL_RCC_GPIOG_CLK_ENABLE();
    __HAL_RCC_GPIOB_CLK_ENABLE();

HAL_SRAM_MspInit(hsram);
    rt_pin_mode(LCD_BL, PIN_MODE_OUTPUT);

/** Perform the SRAM1 memory initialization sequence*/
    hsram1.Instance = FSMC_NORSRAM_DEVICE;
    hsram1.Extended = FSMC_NORSRAM_EXTENDED_DEVICE;
    /* hsram1.Init */
    hsram1.Init.NSBank = FSMC_NORSRAM_BANK1;
    hsram1.Init.DataAddressMux = FSMC_DATA_ADDRESS_MUX_DISABLE;
    hsram1.Init.MemoryType = FSMC_MEMORY_TYPE_SRAM;
    hsram1.Init.MemoryDataWidth = FSMC_NORSRAM_MEM_BUS_WIDTH_16;
    hsram1.Init.BurstAccessMode = FSMC_BURST_ACCESS_MODE_DISABLE;
    hsram1.Init.WaitSignalPolarity = FSMC_WAIT_SIGNAL_POLARITY_LOW;
    hsram1.Init.WrapMode = FSMC_WRAP_MODE_DISABLE;
    hsram1.Init.WaitSignalActive = FSMC_WAIT_TIMING_BEFORE_WS;
    hsram1.Init.WriteOperation = FSMC_WRITE_OPERATION_ENABLE;
    hsram1.Init.WaitSignal = FSMC_WAIT_SIGNAL_DISABLE;
    hsram1.Init.ExtendedMode = FSMC_EXTENDED_MODE_DISABLE;
    hsram1.Init.AsynchronousWait = FSMC_ASYNCHRONOUS_WAIT_DISABLE;
    hsram1.Init.WriteBurst = FSMC_WRITE_BURST_DISABLE;
    hsram1.Init.PageSize = FSMC_PAGE_SIZE_NONE;
    /* Timing */
    Timing.AddressSetupTime = 5;
    Timing.AddressHoldTime = 1;
    Timing.DataSetupTime = 9;
    Timing.BusTurnAroundDuration = 0;
    Timing.CLKDivision = 2;
    Timing.DataLatency = 2;
    Timing.AccessMode = FSMC_ACCESS_MODE_A;
    /* ExtTiming */

if (HAL_SRAM_Init(&hsram1, &Timing, &Timing) != HAL_OK)
    {
        Error_Handler();
    }

rt_thread_mdelay(50);

lcddev.width = SSD_HOR_RESOLUTION;
    lcddev.height = SSD_VER_RESOLUTION;
    lcddev.setxcmd = 0x2a;
    lcddev.setycmd = 0x2b;
    lcddev.wramcmd = 0x2c;

LCD_WR_REG(0X11);
    rt_thread_mdelay( 20 );
    LCD_WR_REG(0X13);
    LCD_WR_REG(0XD0);//VCI1  VCL  VGH  VGL DDVDH VREG1OUT power amplitude setting
    LCD_WR_DATA(0X07);
    LCD_WR_DATA(0X42);
    LCD_WR_DATA(0X18);
    LCD_WR_REG(0XD1);//VCOMH VCOM_AC amplitude setting
    LCD_WR_DATA(0X00);
    LCD_WR_DATA(0X07);
    LCD_WR_DATA(0X10);
    LCD_WR_REG(0XD2);//Operational Amplifier Circuit Constant Current Adjust , charge pump frequency setting
    LCD_WR_DATA(0X01);
    LCD_WR_DATA(0X02);
    LCD_WR_REG(0XC0);//REV SM GS
    LCD_WR_DATA(0X10);
    LCD_WR_DATA(0X3B);
    LCD_WR_DATA(0X00);
    LCD_WR_DATA(0X02);
    LCD_WR_DATA(0X11);

LCD_WR_REG(0XC5);// Frame rate setting = 72HZ  when setting 0x03
    LCD_WR_DATA(0X03);

LCD_WR_REG(0xC8);
    LCD_WR_DATA(0x00);//P114
    LCD_WR_DATA(0x14);//P114
    LCD_WR_DATA(0x33);//P114
    LCD_WR_DATA(0x10);//P114
    LCD_WR_DATA(0x00);//P114
    LCD_WR_DATA(0x16);//P114
    LCD_WR_DATA(0x44);//P114
    LCD_WR_DATA(0x36);//P114
    LCD_WR_DATA(0x77);//P114
    LCD_WR_DATA(0x00);//P114
    LCD_WR_DATA(0x0F);//P114
    LCD_WR_DATA(0x00);//P114

LCD_WR_REG(0x3A);
    LCD_WR_DATA(0x55);

LCD_WR_REG(0x2A);
    LCD_WR_DATA(0x00);
    LCD_WR_DATA(0x00);
    LCD_WR_DATA(0x01);
    LCD_WR_DATA(0x10);

LCD_WR_REG(0x2B);
    LCD_WR_DATA(0x00);
    LCD_WR_DATA(0x00);
    LCD_WR_DATA(0x01);
    LCD_WR_DATA(0xE0);
    rt_thread_mdelay(12);
    LCD_WR_REG(0x29);
    LCD_WR_REG(0x2c);

LCD_WR_REG(0x36); //Set_address_mode
    LCD_WR_DATA(0x28);

rt_pin_write(LCD_BL, PIN_HIGH);
    LCD_Clear(0x001f);

return RT_EOK;
}

struct rt_device_graphic_ops fsmc_lcd_ops =
{
    LCD_Fast_DrawPoint,
    LCD_ReadPoint,
    LCD_HLine,
    LCD_VLine,
    LCD_BlitLine,
};

static rt_err_t drv_lcd_control(struct rt_device *device, int cmd, void *args)
{
    struct drv_lcd_device *lcd = LCD_DEVICE(device);
    switch (cmd)
    {
        case RTGRAPHIC_CTRL_GET_INFO:
        {
            struct rt_device_graphic_info *info = (struct rt_device_graphic_info *)args;

RT_ASSERT(info != RT_NULL);

//this needs to be replaced by the customer
            info->pixel_format  = lcd->lcd_info.pixel_format;
            info->bits_per_pixel = lcd->lcd_info.bits_per_pixel;
            info->width = lcddev.width;
            info->height = lcddev.height;
        }
        break;
    }

return RT_EOK;
}

#ifdef RT_USING_DEVICE_OPS
const static struct rt_device_ops lcd_ops =
    {
        drv_lcd_init,
        RT_NULL,
        RT_NULL,
        RT_NULL,
        RT_NULL,
        drv_lcd_control};
#endif

int drv_lcd_hw_init(void)
{
    rt_err_t result = RT_EOK;
    struct rt_device *device = &_lcd.parent;
    /* memset _lcd to zero */
    memset(&_lcd, 0x00, sizeof(_lcd));

_lcd.lcd_info.bits_per_pixel = 16;
    _lcd.lcd_info.pixel_format = RTGRAPHIC_PIXEL_FORMAT_RGB565;
    _lcd.lcd_info.height = SSD_VER_RESOLUTION;
    _lcd.lcd_info.width = SSD_HOR_RESOLUTION;

device->type = RT_Device_Class_Graphic;
#ifdef RT_USING_DEVICE_OPS
    device->ops = &lcd_ops;
#else
    device->init = drv_lcd_init;
    device->control = drv_lcd_control;
#endif
    device->user_data = &fsmc_lcd_ops;
    /* register lcd device */
    rt_device_register(device, "lcd", RT_DEVICE_FLAG_RDWR | RT_DEVICE_FLAG_STANDALONE);

return result;
}
INIT_DEVICE_EXPORT(drv_lcd_hw_init);

```

6、
完整例程所需 ROM 较多，编译报错。所以在 GUIDEMO.h 中，关闭 treeview 和 iconview 两个占用空间较多的项。

![demo.png](https://oss-club.rt-thread.org/uploads/20210130/9746f519964f02db5411d07f9d3a5033.png)

7、编译，无视 STemWin 库警告，下载。

![Video_20210129_034533_816.gif](https://oss-club.rt-thread.org/uploads/20210130/3ec72fd0d8fe369d4ad4a67f834f2c0b.gif)