Smart ZYNQ（SP版) 工程二十六用zynq的PS的硬件SPI资源驱动彩色LCD

Smart ZYNQ SP主板上自带一块1.47寸彩色显示屏，分辨率是320X172，本文将通过ZYNQ的PS资源去点亮这个液晶屏幕，并显示彩色条纹

另外因为Smart ZYNQ SL 版不带LCD 所以此章节不适用

（备注此章节内容适用于 Smart ZYNQ SP，如果是Smart ZYNQ 标准版请看对应板子目录）

1.硬件介绍

LCD 接口如下图所示

LCD_BLK：LCD背光（默认常亮）

SPI 信号： CS 片选信号 SCL 时钟 SDA 数据

DC ：数据/命令信号

RES ：屏幕复位信号

管脚定义：CS P15 ,D/C R15 ,SCL N15 ,SDA M15 ,RES L16 ,BLK T16(BLK默认不去控制背光也会默认常亮输出)

彩色液晶屏资料（厂家提供的资料）店铺中景园电子

链接：https://pan.baidu.com/s/110uz88iQMA7wl9vdqG9R9A 提取码：8888

2.驱动思路

屏幕本身是连接到ZYNQ的PL资源上，点亮屏幕可以用纯fpga去驱动SPI的方式点亮，也可以用PS资源去点亮，为了方便演示，这里采用PS资源去实现

通过EMIO的方式将PS部分硬件SPI资源映射到 ZYNQ的PL口上去点亮屏幕

3.创建工程

1）新建一个项目，板子的芯片型号为 XC7Z020 封装是CLG484 所以型号我们选择 xc7z020clg484-1

2) 创建一个BLOCK设计，并添加ZYNQ7 PROCESSING SYSTEM模块，软件自动生成了一个 zynq的block 如下图所示，接下来要做一些相应的设置，双击下图中的ZYNQ核

3）在ZYNQ中设置时钟功能：

找到设置项目中的 Clock Configuration 选项，在PL Fabric Clocks 设置自己需要的时钟频率，这里一共有4种频率可以设置类似于我们的PLL功能。这里我们设置50M时钟

4）在zynq中设置DDR功能：

依次在弹窗里找到DDR Configuration→DDR Controller Configuration→DDR3，在Memory Part下拉菜单中根据自己板子上的DDR来选择相应的DDR3，本实验所用到型号：MT41K256M16RE-125，数据位宽选择16bit 最后点击“OK”,如下图所示。

5)在ZYNQ中配置SPI功能

因为屏幕的接口是连接到ZYNQ的PL口上，所以这里我们调用EMIO的SPI功能（即使用PS的SPI功能，但是内部连接映射到PL的GPIO口上）

MIO Configuration→SPI 0勾上并选择EMIO

6）由于屏幕的驱动除了SPI外，还需要3个额外的GPIO口来分别控制复位RES，D/C信号，和BLK信号，所以这里增加三个GPIO口，这里GPIO资源选择EMIO GPIO 位宽Width选择3（因为是3个IO口）

5）完成上述操作后，点击“Run Block Automation”如下图所示。在弹出的选项中保持默认，点击“OK”，即可完成对ZYNQ7 Processing System的配置，并用鼠标连接FCLK_CLK和 M_AXI_GP0_ACLK，得到下图

在上图中分别点击IO口进行以下操作：

右键GPIO_0选择Make External

右键SPI_0 选择Make External

6）source→Design Source ，右键我们创建的BLOCK工程，点击create HDL wrapper，打包BLOCK文件并生成.v代码

这时候我们可以看到软件的TOP层的verilog文件,打开后观察管脚信号,如下图

圈内的几个管脚是我们之前定义的SPI 管脚,和GPIO管脚, 其中

其中spi_0_io0为 SPI的MOSI信号, spi_0_io1_io 为MISO信号 ,SCK 为SPI时钟信号, SS,SS1,SS2分别为三组SPI 的CS信号

GPIO_0_0为刚才定义的三个GPIO (控制屏幕的背光, 复位和D/C用)

7) 因为我们的屏幕只用到了一组CS ，所以我们删除多余的CS

屏幕实际只用到了 SPI的数据SDA和时钟SCL和CS三个信号, 所以SPI 我们只需要引出 MOSI (SDA) 和 SCK(SCL)，和CS(SS)即可

删除如下框图中的信号的位置

同样也需要删除内部 buf(否则外部管脚不调用会报错)

8) 点击绿色箭头RUN 对代码进行编译

9) 点击RTL 中的SCHEMATIC , 并选择右边出现的 IO Ports 来增加SPI的管脚定义(这一步也可以在约束文件中定义, 可看之前的例子)

修改GPIO 管脚定义和SPI管脚定义,如下图所示 ,修改后保存(如弹出窗口需要,则在窗口中输入约束文件名,然后保存)

CS P15 ,D/C R15 ,SCL N15 ,SDA M15 ,RES L16 ,BLK T16

10) 生成bit文件 :按下Generate Bitstream 完成综合以及生成bit文件

5.SDK程序编写

1）File→Export→Export hardware…，在弹出的对话框中勾选“include bitstream”，点击“OK”确认，如下图所示。

2）File→Lauch SDK，在弹出的对话框中，保存默认，点击“OK”，如下图所示。

系统将自动打开SDK开发环境

3）新建一个工程 file→new→Application Project，来新建一个“Application Project”，如下图所示。

4）在新建工程名中输入自己的工程名称，点击NEXT

5)选择一个空工程,点击完成

6) 在空工程中创建我们自己的代码

展开我们创建的工程,在src目录上右键，选择New->Source File，如下图所示：

在弹出的窗口中创建一个main.c文件

6）书写自己的代码

6.1小贴士：

在初次写PS部分的代码时，如GPIO代码和SPI代码，不知道怎么写的情况下，其实可以通过打开 BSP工程下的 system.mss文件，然后在右边导入需要的参考例程，然后将例程中自己需要的部分（如GPIO初始化，或者SPI的写和读代码COPY到自己工程的main函数中）

6.2定义GPIO部分

下面进入正题，我们要点亮屏幕，屏幕这里用了3个GPIO 都是用了ZYNQ PS端的EMIO资源， EMIO的GPIO资源是从54开始的，所以我们根据FPGA管脚约束中的 GPIO 0-3 分别对应 EMIO的54-55-56，如下图对GPIO进行定义

#define EMIO_LCD_CD  	54
#define EMIO_LCD_RES 	55
#define EMIO_LCD_BLK 	56

接下来简单介绍下GPIO的调用

a. GPIO的初始化

如下图所示，需要先定义一个XgpioPs 的结构体指针，这个指针的内容包括gpio分配的ID和基地址，这些信息通常在xparameter.h头文件中，可以通过使用XGpioPs_LookupConfig函数，它能够在配置信息中找到对应ID的配置信息

ConfigPtr=XGpioPs_LookupConfig(GPIO_DEVICE_ID); 就相当于把获得到的信息赋予给之前定义的ConfigPtr结构体

最终再用 XGpioPs_CfgInitialize 函数来初始化GPIO

void Lcd_Gpio_Init(void){
	XGpioPs_Config *ConfigPtr;

	ConfigPtr = XGpioPs_LookupConfig(GPIO_DEVICE_ID);
	XGpioPs_CfgInitialize(&Gpio, ConfigPtr,ConfigPtr->BaseAddr);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_CD, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_CD, 1);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_RES, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_RES, 1);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_BLK, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_BLK, 1);

	XGpioPs_WritePin(&Gpio, EMIO_LCD_CD, 0);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 0);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_BLK, 0);
}

b.GPIO的使用（EMIO_LCD_RES为之前定义的 EMIO 54 的管脚）

XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_RES, 1);//设置成输出模式
XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_RES, 1);//打开输出使能

XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 0);// 0置低
XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 1);// 1拉高

6.3 SPI部分的定义，和GPIO类似 SPI也有初始化和使用两部分

a.SPI的初始化和GPIO类似，也是定义了一个结构体，也同样通过 LookupConfig 来获得对应的硬件配置信息，最终用 XSpiPs_CfgInitialize来完成初始化，值得注意的是程序当中 XSpiPs_SetClkPrescaler 函数是用来为SPI功能提供主时钟的分频用的，可以根据自己需要的速率选择分频参数

void Lcd_Spi_Init(){
	XSpiPs_Config *SpiConfig;

	SpiConfig = XSpiPs_LookupConfig(SPI_DEVICE_ID);
	XSpiPs_CfgInitialize(&SpiInstance, SpiConfig,
			SpiConfig->BaseAddress);

	XSpiPs_SetOptions(&SpiInstance, XSPIPS_MASTER_OPTION |
				   XSPIPS_FORCE_SSELECT_OPTION);
	XSpiPs_SetClkPrescaler(&SpiInstance, XSPIPS_CLK_PRESCALE_64);
}

b.传输传输是用 XSpiPs_PolledTransfer 函数进行的，其中 SendBufPtr 是发送的数据， RecvBufPtr 是接受的数据， ByteCount 可以定义我们的SPI 是8位 16位或者32位，下面是这个函数的定义

s32 XSpiPs_PolledTransfer(XSpiPs *InstancePtr, u8 *SendBufPtr,
u8 *RecvBufPtr, u32 ByteCount)

7）上面简单介绍了PS部分的GPIO和，SPI功能，接下来在main.c中完善屏幕的代码，将下面的完整代码复制到工程中

#include "xparameters.h"
#include "xgpiops.h"
#include "xstatus.h"
#include "xplatform_info.h"
#include "xspips.h"

#include <xil_printf.h>

#define WHITE         	 0xFFFF
#define BLACK         	 0x0000
#define BLUE         	 0x001F
#define BRED             0XF81F
#define GRED 		 	 0XFFE0
#define GBLUE		 	 0X07FF
#define RED           	 0xF800
#define MAGENTA       	 0xF81F
#define GREEN         	 0x07E0
#define CYAN          	 0x7FFF
#define YELLOW        	 0xFFE0
#define BROWN 	         0XBC40
#define BRRED 		 	 0XFC07
#define GRAY  		 	 0X8430

#define EMIO_LCD_CD  	54
#define EMIO_LCD_RES 	55
#define EMIO_LCD_BLK 	56


#define GPIO_DEVICE_ID  	XPAR_XGPIOPS_0_DEVICE_ID
#define SPI_DEVICE_ID		XPAR_XSPIPS_0_DEVICE_ID

XGpioPs Gpio;	/* The driver instance for GPIO Device. */
static XSpiPs SpiInstance;


void Lcd_Gpio_Init(void){
	XGpioPs_Config *ConfigPtr;

	ConfigPtr = XGpioPs_LookupConfig(GPIO_DEVICE_ID);
	XGpioPs_CfgInitialize(&Gpio, ConfigPtr,ConfigPtr->BaseAddr);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_CD, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_CD, 1);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_RES, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_RES, 1);

	XGpioPs_SetDirectionPin(&Gpio, EMIO_LCD_BLK, 1);
	XGpioPs_SetOutputEnablePin(&Gpio, EMIO_LCD_BLK, 1);

	XGpioPs_WritePin(&Gpio, EMIO_LCD_CD, 0);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 0);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_BLK, 0);
}


void Lcd_Spi_Init(){
	XSpiPs_Config *SpiConfig;

	SpiConfig = XSpiPs_LookupConfig(SPI_DEVICE_ID);
	XSpiPs_CfgInitialize(&SpiInstance, SpiConfig,
			SpiConfig->BaseAddress);

	XSpiPs_SetOptions(&SpiInstance, XSPIPS_MASTER_OPTION |
				   XSPIPS_FORCE_SSELECT_OPTION);
	XSpiPs_SetClkPrescaler(&SpiInstance, XSPIPS_CLK_PRESCALE_64);
}


void delay(unsigned char i){
	volatile int Delay;
	volatile int k;
	for(k=0;k<i;k++)
	for (Delay = 0; Delay < 10000; Delay++);
}

void LCD_WR_DATA8(u8 dat){
	XGpioPs_WritePin(&Gpio, EMIO_LCD_CD, 1);
	XSpiPs_PolledTransfer(&SpiInstance, &dat, NULL, 1);
}

void LCD_WR_REG(u8 dat){
	XGpioPs_WritePin(&Gpio, EMIO_LCD_CD, 0);
	XSpiPs_PolledTransfer(&SpiInstance, &dat, NULL, 1);
}



#define USE_HORIZONTAL 2

void Lcd_Init(void){
	XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 0);
	delay(30);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_RES, 1);
	delay(100);
	LCD_WR_REG(0x11);
	delay(100);
	LCD_WR_REG(0x36);
	if(USE_HORIZONTAL==0)LCD_WR_DATA8(0x00);
	else if(USE_HORIZONTAL==1)LCD_WR_DATA8(0xC0);
	else if(USE_HORIZONTAL==2)LCD_WR_DATA8(0x70);
	else LCD_WR_DATA8(0xA0);

	LCD_WR_REG(0x3A);
	LCD_WR_DATA8(0x05);

	LCD_WR_REG(0xB2);
	LCD_WR_DATA8(0x0C);
	LCD_WR_DATA8(0x0C);
	LCD_WR_DATA8(0x00);
	LCD_WR_DATA8(0x33);
	LCD_WR_DATA8(0x33);

	LCD_WR_REG(0xB7);
	LCD_WR_DATA8(0x35);

	LCD_WR_REG(0xBB);
	LCD_WR_DATA8(0x35);

	LCD_WR_REG(0xC0);
	LCD_WR_DATA8(0x2C);

	LCD_WR_REG(0xC2);
	LCD_WR_DATA8(0x01);

	LCD_WR_REG(0xC3);
	LCD_WR_DATA8(0x13);

	LCD_WR_REG(0xC4);
	LCD_WR_DATA8(0x20);

	LCD_WR_REG(0xC6);
	LCD_WR_DATA8(0x0F);

	LCD_WR_REG(0xD0);
	LCD_WR_DATA8(0xA4);
	LCD_WR_DATA8(0xA1);

	LCD_WR_REG(0xD6);
	LCD_WR_DATA8(0xA1);

	LCD_WR_REG(0xE0);
	LCD_WR_DATA8(0xF0);
	LCD_WR_DATA8(0x00);
	LCD_WR_DATA8(0x04);
	LCD_WR_DATA8(0x04);
	LCD_WR_DATA8(0x04);
	LCD_WR_DATA8(0x05);
	LCD_WR_DATA8(0x29);
	LCD_WR_DATA8(0x33);
	LCD_WR_DATA8(0x3E);
	LCD_WR_DATA8(0x38);
	LCD_WR_DATA8(0x12);
	LCD_WR_DATA8(0x12);
	LCD_WR_DATA8(0x28);
	LCD_WR_DATA8(0x30);

	LCD_WR_REG(0xE1);
	LCD_WR_DATA8(0xF0);
	LCD_WR_DATA8(0x07);
	LCD_WR_DATA8(0x0A);
	LCD_WR_DATA8(0x0D);
	LCD_WR_DATA8(0x0B);
	LCD_WR_DATA8(0x07);
	LCD_WR_DATA8(0x28);
	LCD_WR_DATA8(0x33);
	LCD_WR_DATA8(0x3E);
	LCD_WR_DATA8(0x36);
	LCD_WR_DATA8(0x14);
	LCD_WR_DATA8(0x14);
	LCD_WR_DATA8(0x29);
	LCD_WR_DATA8(0x32);

	LCD_WR_REG(0x21);

	LCD_WR_REG(0x11);
	delay(150);
	LCD_WR_REG(0x29);
	delay(150);
	XGpioPs_WritePin(&Gpio, EMIO_LCD_BLK, 1);
}




 void LCD_WR_DATA(u16 dat)
{
	u8 spi_dat[2];
	XGpioPs_WritePin(&Gpio, EMIO_LCD_CD, 1);
    spi_dat[0]=dat>>8;
    spi_dat[1]=dat;
    XSpiPs_PolledTransfer(&SpiInstance, spi_dat, NULL, 2);
}

void Address_set(unsigned int x1,unsigned int y1,unsigned int x2,unsigned int y2)
{
	LCD_WR_REG(0x2a);
	LCD_WR_DATA(x1);
	LCD_WR_DATA(x2);
	LCD_WR_REG(0x2b);
	LCD_WR_DATA(y1+34);
	LCD_WR_DATA(y2+34);
	LCD_WR_REG(0x2c);
}



void LCD_Test()
{
    unsigned int i,j;
    Address_set(0,0,320-1,172-1);

    for(i=0;i<172;i++){

    	if(i>=0&&i<43)
    		for (j=0;j<320;j++)LCD_WR_DATA(WHITE);

    	else if(i>=43&&i<86)
    		for (j=0;j<320;j++)LCD_WR_DATA(RED);

    	else if(i>=86&&i<129)
    		for (j=0;j<320;j++)LCD_WR_DATA(GREEN);

    	else if(i>=129&&i<172)
    		for (j=0;j<320;j++)LCD_WR_DATA(BLUE);
    }
}


int main(void)
{
	Lcd_Gpio_Init();
	Lcd_Spi_Init();

	Lcd_Init();
	LCD_Test();

	while(1){
	};

	return XST_SUCCESS;
}

8）用之前生成的二进制文件对FPGA进行编程，Xilinx Tools -> Program FPGA 然后点击 “Program”

9）当FPGA编程成功后，我们需要初始化zynq中的处理器，右键点击刚才创建的空工程，选择Run As -> Launch on Hardware (System Debugger) 或者 Launch on Hardware (GDB).

经过上述操作，屏幕就被成功点亮了，正常显示 4色彩条纹，如下图所示

代码解释

以上是完整的工程图文创建过程，除了上面提到的GPIO和 SPI部分的代码外，下面简单介绍下工程中的其余的一些函数代码

1）关于颜色

屏幕本身是16色也就是RGB565的颜色驱动方式，所以这里可以用 16字节来定义不同的颜色，如程序中的红绿蓝白，以及下面标注的其他颜色，当然也可以根据RGB的颜色组合来合成自己需要的颜色

#define WHITE         	 0xFFFF
#define BLACK         	 0x0000
#define BLUE         	 0x001F
#define BRED             0XF81F
#define GRED 		 0XFFE0
#define GBLUE		 0X07FF
#define RED           	 0xF800
#define MAGENTA       	 0xF81F
#define GREEN         	 0x07E0
#define CYAN          	 0x7FFF
#define YELLOW        	 0xFFE0
#define BROWN 	         0XBC40
#define BRRED 		 0XFC07
#define GRAY  		 0X8430

2)关于彩色条纹，如下代码，0-42行显示白色，43-85显示红色，86-128显示绿色，129-172显示蓝色

Address_set(0,0,320-1,172-1); 相当于是定义一块矩形区域，0，0，320，172分别是这个矩形的四个坐标点（这里涵盖了整个屏幕的空间，也可以自定义部分区域，详细看屏幕手册）

void LCD_Test()
{
    unsigned int i,j;
    Address_set(0,0,320-1,172-1);

    for(i=0;i<172;i++){

    	if(i>=0&&i<43)
    		for (j=0;j<320;j++)LCD_WR_DATA(WHITE);

    	else if(i>=43&&i<86)
    		for (j=0;j<320;j++)LCD_WR_DATA(RED);

    	else if(i>=86&&i<129)
    		for (j=0;j<320;j++)LCD_WR_DATA(GREEN);

    	else if(i>=129&&i<172)
    		for (j=0;j<320;j++)LCD_WR_DATA(BLUE);
    }
}

最后介绍main 函数，其实特别简单，包括GPIO的初始化，SPI的初始化，以及屏幕的初始化（屏幕内部寄存器的配置配置信息由厂家直接提供），以及屏幕测试函数的调用

int main(void)
{
	Lcd_Gpio_Init();
	Lcd_Spi_Init();

	Lcd_Init();
	LCD_Test();

	while(1);

	return XST_SUCCESS;
}

以下附件为本页内容的完整工程

另外屏幕可以根据需求设置成横屏和竖屏模式

26_PS_LCD_TEST_XC7Z020 下载

1.硬件介绍

2.驱动思路

3.创建工程

5.SDK程序编写

代码解释

发表回复 取消回复

发表回复取消回复