zedboard第十六课(弹琴法控制OLED的GPIO)

OLED驱动，最原始的方式就是，把OLED的引脚以S_AXI_GPIO的方式连到引脚上，这样，PL实现的功能最简单，时序由PS来生成。这是RAW_TIMING的方式。
在RAW_TIMING的方式下，CPU用函数的形式，数节拍来生成时序，在特定的时机，控制GPIO，改变GPIO的状态，函数返回时，一段时序就结束了。一般成为“弹琴法”，就好像照着乐谱，按节奏弹奏钢琴一样。

适合使用弹琴法的应用，必须是单线程任务，也就是说，PS在弹琴时，不能做别的事，所以在弹琴的过程中，要关掉中断。虽然弹琴法并没有太多的实用价值，但是用来学习GPIO的使用，以及分析程序架构，还是一个很好的素材。

弹琴法涉及到多层抽象。
第一层，是bit level的抽象。成为BIT_OPERRATION_LEVEL。简称BOL。BOL要实现每个特定BIT的操作函数。这是针对PIN而进行的抽象。对于单个BIT，只有两个操作，即SetHigh和SetLow，也简称为Set和Clear。
对于每个BIT，都设计好这两个操作函数，BOL就算完备了。
BOL通常使用宏拟函数来实现。例如，

// DC
#define Set_OLED_DC  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_DC)))
#define Clr_OLED_DC  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_DC))))
// RES
#define Set_OLED_RES  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_RES)))
#define Clr_OLED_RES  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_RES))))

// SCLK
#define Set_OLED_SCLK  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_SCLK)))
#define Clr_OLED_SCLK  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_SCLK))))
// SDIN
#define Set_OLED_SDIN  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_SDIN)))
#define Clr_OLED_SDIN  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_SDIN))))
// OLED_VBAT
#define Set_OLED_VBAT  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_VBAT)))
#define Clr_OLED_VBAT  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_VBAT))))

// OLED_VDD
#define Set_OLED_VDD  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)|(1<<OLED_VDD)))
#define Clr_OLED_VDD  (Xil_Out32(OLED_BASE_ADDR,Xil_In32(OLED_BASE_ADDR)&(~(1<<OLED_VDD))))

第二层，是操作周期级别的抽象。CYCLE_OPERATION_LEVEL。简称COL。COL要利用BOL实现每个特定的操作周期。这是针对一个INTERFACE而进行的抽象。对于一个接口，常见的几种操作周期是，read，write，ioctrl。具体根据器件的手册来设计。在本例中，设计了write_data,write_cmd这两个操作周期。

void OLED_write_cmd(u8 data)
{
	u8 i;
	Clr_OLED_DC;

	for(i=0;i<8;i++)
	{
		Clr_OLED_SCLK;

		if(data&0x80)
			Set_OLED_SDIN;
		else
			Clr_OLED_SDIN;
		Set_OLED_SCLK;
		data<<=1;
	}

}

void OLED_write_data(u8 data)
{
	u8 i;
	Set_OLED_DC;

	for(i=0;i<8;i++)
	{
		Clr_OLED_SCLK;

		if(data&0x80)
			Set_OLED_SDIN;
		else
			Clr_OLED_SDIN;
		Set_OLED_SCLK;
		data<<=1;
	}

}

第三层，是功能操作级别的抽象。FUNCTION_OPERATION_LEVEL。简称FOL。FOL要利用COL完成特定的功能。这是针对一个DEVICE而进行的抽象。对于一个器件，常见的功能操作有，
init，enable，disable，do_transfer，do_transaction,等等。在本例中，设计了如下几个功能操作。

void OLED_Init(void)
{
	Clr_OLED_VDD;
	usleep(300);		// 300us
	Clr_OLED_RES;
	usleep(30000);		// 30ms
	Set_OLED_RES;
	usleep(30000);		// 30ms
	Clr_OLED_VBAT;

/*	write_cmd(0xAE); //关闭显示
	write_cmd(0xD5); //设置时钟分频因子,震荡频率
	write_cmd(0x80);   //[3:0],分频因子;[7:4],震荡频率
	write_cmd(0xA8); //设置驱动路数
	write_cmd(0X3F); //默认0X3F(1/64)
	write_cmd(0xD3); //设置显示偏移
	write_cmd(0X00); //默认为0

	write_cmd(0x40); //设置显示开始行 [5:0],行数.

	write_cmd(0x8D); //电荷泵设置
	write_cmd(0x14); //bit2，开启/关闭


	write_cmd(0x20); //设置内存地址模式
	write_cmd(0x02); //[1:0],00，列地址模式;01，行地址模式;10,页地址模式;默认10;
	write_cmd(0xA1); //段重定义设置,bit0:0,0->0;1,0->127;
	write_cmd(0xC0); //设置COM扫描方向;bit3:0,普通模式;1,重定义模式 COM[N-1]->COM0;N:驱动路数
	write_cmd(0xDA); //设置COM硬件引脚配置
	write_cmd(0x12); //[5:4]配置

	write_cmd(0x81); //对比度设置
	write_cmd(0xEF); //1~255;默认0X7F (亮度设置,越大越亮)
	write_cmd(0xD9); //设置预充电周期
	write_cmd(0xf1); //[3:0],PHASE 1;[7:4],PHASE 2;
	write_cmd(0xDB); //设置VCOMH 电压倍率
	write_cmd(0x30); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;

	write_cmd(0xA4); //全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)
	write_cmd(0xA6); //设置显示方式;bit0:1,反相显示;0,正常显示
	write_cmd(0xAF); //开启显示
	OLED_Clear();*/
}
//开启OLED显示
void OLED_Display_On(void)
{
	write_cmd(0X8D);  //SET DCDC命令
	write_cmd(0X14);  //DCDC ON
	write_cmd(0XAF);  //DISPLAY ON
}
//关闭OLED显示
void OLED_Display_Off(void)
{
	write_cmd(0X8D);  //SET DCDC命令
	write_cmd(0X10);  //DCDC OFF
	write_cmd(0XAE);  //DISPLAY OFF
	Set_OLED_VDD;
	Set_OLED_VBAT;
}
//更新显存到LCD
void OLED_Refresh_Gram(void)
{
	u8 i,n;
	for(i=0;i<8;i++)
	{
		write_cmd (0xb0+i);    //设置页地址（0~7）
		write_cmd (0x02);      //设置显示位置—列低地址,偏移了2列
		write_cmd (0x10);      //设置显示位置—列高地址
		for(n=0;n<128;n++)
			write_data(OLED_GRAM[n][i]);
	}
}

第四层，是应用操作级别的抽象。APPICATION_OPERATION_LEVEL。简称AOL。AOL要利用FOL完成特定的复杂任务。这是针对APP而进行的抽象。不再属于硬件驱动的范畴。当然，也可以有更高层次的封装和抽象，但是都统一归为AOL。
本例中，设计了以下几个应用操作。

void OLED_Clear(void)
{
	u8 i,n;
	for(i=0;i<8;i++)
		for(n=0;n<128;n++)
			OLED_GRAM[n][i]=0X00;
	OLED_Refresh_Gram();//更新显示
}
//画点
//x:0~127
//y:0~63
//t:1 填充 0,清空
void OLED_DrawPoint(u8 x,u8 y,u8 t)
{
	u8 pos,bx,temp=0;

	if(x>127||y>63)
		return;//超出范围了.
	pos=7-y/8;
	bx=y%8;
	temp=1<<(7-bx);

	if(t)
		OLED_GRAM[x][pos]|=temp;
	else
		OLED_GRAM[x][pos]&=~temp;
}

再继续进一步封装，可以显示多个点，从而形成图案，

//x1,y1,x2,y2 填充区域的对角坐标
//确保x1<=x2;y1<=y2 0<=x1<=127 0<=y1<=63
//dot:0,清空;1,填充
void OLED_Fill(u8 x1,u8 y1,u8 x2,u8 y2,u8 dot)
{
	u8 x,y;
	for(x=x1;x<=x2;x++)
	{
		for(y=y1;y<=y2;y++)
			OLED_DrawPoint(x,y,dot);
	}
	OLED_Refresh_Gram();//更新显示
}
//在指定位置显示一个字符,包括部分字符
//x:0~127
//y:0~63
//mode:0,反白显示;1,正常显示
//size:选择字体 16/12
void OLED_ShowChar(u8 x,u8 y,u8 chr,u8 size,u8 mode)
{
	u8 temp,t,t1;
	u8 y0=y;
	chr=chr-' ';//得到偏移后的值
	for(t=0;t<size;t++)
	{
		if(size==12)temp=asc2_1206[chr][t];  //调用1206字体
		else temp=asc2_1608[chr][t];		 //调用1608字体
		for(t1=0;t1<8;t1++)
		{
			if(temp&0x80)OLED_DrawPoint(x,y,mode);
			else OLED_DrawPoint(x,y,!mode);
			temp<<=1;
			y++;
			if((y-y0)==size)
			{
				y=y0;
				x++;
				break;
			}
		}
	}
}
//显示2个数字
//x,y :起点坐标
//len :数字的位数
//size:字体大小
//mode:模式	0,填充模式;1,叠加模式
//num:数值(0~4294967295);
void OLED_ShowNum(u8 x,u8 y,u32 num,u8 len,u8 size)
{
	u8 t,temp;
	u8 enshow=0;
	for(t=0;t<len;t++)
	{
		temp=(num/mypow(10,len-t-1))%10;
		if(enshow==0&&t<(len-1))
		{
			if(temp==0)
			{
				OLED_ShowChar(x+(size/2)*t,y,' ',size,1);
				continue;
			}else enshow=1;

		}
		OLED_ShowChar(x+(size/2)*t,y,temp+'0',size,1);
	}
}

再进一步封装，显示出字符串。

//显示字符串
//x,y:起点坐标
//*p:字符串起始地址
//用16字体
void OLED_ShowString(u8 x,u8 y,const u8 *p)
{
	#define MAX_CHAR_POSX 122
	#define MAX_CHAR_POSY 58
	while(*p!='\0')
	{
		if(x>MAX_CHAR_POSX){x=0;y+=16;}
		if(y>MAX_CHAR_POSY){y=x=0;OLED_Clear();}
		OLED_ShowChar(x,y,*p,16,1);
		x+=8;
		p++;
	}
}

下面来看看怎么应用。

int main()
{
    init_platform();

    	Xil_Out32(OLED_BASE_ADDR,0xff);
    	OLED_Init();			//初始化液晶
    	
    	OLED_ShowString(0,0, "MY OLED TEST");
    	
    	OLED_Refresh_Gram();

    	while(1);	//等待
   cleanup_platform();
    return 0;
}

弹琴法控制GPIO，没有发挥PL侧的作用，如果在PL侧生成一个S_AXI的外设，来负责生成OLED的时序，那么会提高效率。
我们前面已经分析过了，PS负责BOL的操作，会十分影响PS的效率，如果把BOL交给PL来实现，那么PS和PL交互COL层的数据，就可以提高PS的效率。
如果希望PS层实现更高级别的操作，例如FOL或者AOL级别的操作，就可以把更多的时序操作交给PL来实现，那么PS和PL交互FOL层或者AOL层的数据即可。

OLED是静态显示的器件，相当于内部带有FrameBuffer，所以我们并不需要在PL内再为之配置framebuffer，这样可以节省BRAM数据。基于此，PS侧和OLED的交互数据，就是CMD或者DATA的序列。
为了进一步提高效率，我们可以设置一个AXI_FIFO，PS侧通过AXI总线将CMD或者DATA序列化写入FIFO，而PL侧则通过FIFO取出CMD或者DATA的序列。