当前位置:首页 > 嵌入式 > 嵌入式教程
[导读]基于GWES的WinCE Display驱动开发介绍

引言

在WinCE中,Display驱动由GWES模块来管理。WinCE提供了两种架构的Display驱动模型,可以满足不同的硬件需求。一种是基于WinCE DDI的Display驱动模型,另一种是基于DirectDraw的Display驱动模型。下面将对两种架构作简单介绍。

1 Display驱动模型

WinCE下的Display驱动直接由GWES模块管理,它会直接被GWES模块管理和调用。Display驱动实际上也是分层的,其中包括GPE库,该库处理一些默认的绘图,相当于驱动的MDD层。用户只需要开发和硬件相关的PDD层驱动就可以了。在WinCE中,整个架构如图1:

 

 

图1

如图,ApplicatiON为一个应用程序,该程序会调用图形设备接口函数(GDI),而GDI函数是由Coredll.dll模块导出的。Coredll.dll会将函数调用的参数打包,然后触发对另一个进程的本地过程调用(LPC),所有的绘图和开窗口的工作被传给内核中GWES模块。GWES模块被称为图形,窗口和事件子系统,专门处理图形输出和用户输入等事件及相关的所有交互。GWES模块会调用Display驱动完成对显示硬件的操作。Display驱动由GPE和DDL.dll组成,GPE完成基本的默认绘图工作,而DDI.dll实际上从GPE类上继承而来的,并实现了相关的显示硬件的操作。

2 DirectDraw Display驱动模型

DirectDraw提供了独立于硬件的直接访问显示设备的能力。它可以通过直接访问硬件抽象层(HAL)中的一些函数来达到直接操作显示设备的目的,在这个过程中,不再需要图形设备接口(GDI)的转换。这种直接的方法可以使图像更加连贯,也提高了显示的性能。为了实现这样的功能,需要在显示驱动上扩展能够直接访问相关硬件的函数。这些函数会被DirectDraw模块调用,并形成DirectDraw的硬件抽象层(DDHAL)。DirectDraw显示驱动架构如图2:

 

 

如图,DirectDraw的真正实现代码都驻在gwes.dll模块中,应用程序只是连接了一个小的客户端,被称为DDRAW.dll代理,该代理主要负责用户进程与系统之间的远程DirectDraw COM接口连接。这样,用户请求会被传送到内核的GWES模块中。针对DirectDraw,WinCE提供了一个名为DirectDraw的GPE库(DDGPE),它是从GPE类上面继承而来的。实际上,DirectDraw显示驱动是由DDGPE和DDHAL组成,而DDGPE中已经包含了DDHAL的功能。用户需要从DDGPE类继承并实现相关函数即可。GWES.dll模块中包含GDI和DDRAW两个组件,这两个组件会调用驱动中的DDGPE的相关接口完成对硬件的操作。

在上述两种架构中,用户可以根据自己的硬件情况选择相应的架构。第一种架构是基于GPE类继承来实现的,第二种架构是基于DDGPE类继承来实现的,而第二种架构的DDGPE类又是从第一种架构的GPE类继承而来。关于两种类的具体定义,可参见” WINCE600PUBLICCOMMONOAKINC”路径下的gpe.h和ddgpe.h文件。

本Blog将基于Display驱动模型来介绍,DirectDraw Display驱动模型不在这里介绍。

WinCE下的Display驱动是基于GPE类来实现的,其中GPE中已经实现了基本的绘制工作,相当于MDD层。用户需要继承该类,并实现里面的其他一些函数,所以用户实现的相当于PDD层。

GPE类是一个抽象类,其中包含很多纯虚函数,只能用于继承。用户在继承了GPE类以后,要对GPE类中的纯虚函数做相应的实现。开发Display驱动的大致步骤如下:

(1) 继承GPE类并定义一个该类的实例。

(2) 实现GetGPE()函数,把该类的实例返回给上层的DDI接口。

(3) 实现DrvEnabLEDriver()和DisplayInit()函数并导出这两个接口。

(4) 实现GPE类中的函数。

下面将具体介绍实现的步骤:

2.1 继承GPE类

首先,基于GPE类进行继承,如果想在Display驱动支持Rotation可以从GPERotate类上面继承。实际上,在”gpe.h”中有如下定义:

typedef GPE GPERotate;

可以看出GPERotate类就是GPE类。在这里,用户从GPE类上面继承就可以了,举个例子如下:

class NewGPE: public GPE

{

private:

GPEMode m_ModeInfo;

DWORD m_colorDepth;

DWORD m_VirtualFrameBuffer;

DWORD m_FrameBufferSize;

BOOL m_CursorDisabLED;

BOOL m_CursorVisible;

public:

NewGPE(void);

virtual INT NumModes(void);

virtual SCODE SetMode(INT modeId, HPALETTE *palette);

virtual INT InVBlank(void);

virtual SCODE SetPalette(conST PALETTEENTRY *source, USHORT firstEntry, USHORT numEntries);

virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber);

virtual SCODE SetPointerShape(GPESurf *mask, GPESurf *colorSurface, INT xHot, INT yHot, INT cX, INT cY);

virtual SCODE MovePointer(INT xPosition, INT yPosition);

virtual void WaitForNotBusy(void);

virtual INT IsBusy(void);

virtual void GetPhysicalVideoMemory(unsigned long *physicalMemoryBase, unsigned long *videoMemorySize);

virtual SCODE AllocSurface(GPESurf **surface, INT width, INT height, EGPEFormat format, INT surfaceFlags);

virtual SCODE Line(GPELineParms *lineParameters, EGPEPhase phase);

virtual SCODE BltPrepare(GPEBltParms *blitParameters);

virtual SCODE BltComplete(GPEBltParms *blitParameters);

virtual ULONG GetGraphicsCaps();

virtual ULONG DrvEscape(

SURFOBJ *pso,

ULONG iEsc,

ULONG cjIn,

PVOID pvIn,

ULONG cjOut,

PVOID pvOut);

SCODE WrappedEmulatedLine (GPELineParms *lineParameters);[!--empirenews.page--]

void CursorOn(void);

void CursorOff(void);

#ifdef ROTATE

void SetRotateParms();

LONG DynRotate(int angle);

#endif

};

类NewGPE从GPE类上面继承,其中包括一些属性,如下:

m_ModeInfo:显示模式,结构如下

struct GPEMode {

int modeId; //开发者定义的显示模式的索引号

int width; //显示宽度

int height; //显示高度

int Bpp; //显示深度

int frequency; //显示频率

EGPEFormat format; // RGB格式,各占多少bit

};

m_colorDepth:显示深度

m_VirtualFrameBuffer:FrameBuffer的地址

m_FrameBufferSize:FrameBuffer的大小

m_CursorDisabled:光标使能标记

m_CursorVisible:光标可视标记

用户可以根据需要定义相应的属性,在NewGPE类中,需要定义并实现基类中的纯虚函数,上面的NewGPE类中已经包含了这些函数的定义,还包括了其他一些函数,将在下面介绍。

2.2 实现GetGPE函数

在定义了NewGPE类之后,我们需要实现一个实例,首先定义一个该类的指针:

static GPE *gGPE = (GPE*)NULL;

然后实现GetGPE函数,如下:

GPE *GetGPE(void)

{

if (!gGPE)

{

gGPE = new NewGPE();

}

return gGPE;

}

在该函数中,创建了一个NewGPE的实例。在这个时候NewGPE构造函数会被调用,一般我们会在这里面作一些与显示相关的初始化的工作。该函数返回gGPE指针给上层接口。

2.3 实现DrvEnableDriver和DisplayInit函数

Display驱动对上层的GWES模块提供了20多个函数接口,但是这些函数并不是直接提供出来的,实际上只是通过一个DrvEnableDriver()函数来完成的。该函数在Display驱动的MDD层中没有实现,所以需要在PDD层中定义,如下:

BOOL APIENTRY DrvEnableDriver(ULONG engineVersion, ULONG cj, DRVENABLEDATA *data, PENGCALLBACKS engineCallbacks)

{

BOOL fOk = FALSE;

// make sure we know where our registry configuration is

if(gszBaseInstance[0] != 0) {

fOk = GPEEnableDriver(engineVersion, cj, data, engineCallbacks);

}

return fOk;

}

engineVersion:DDI版本号,目前为DDI_DRIVER_VERSION。

cj:DRVENABLEDATA结构的大小。

data:指向DRVENABLEDATA结构体。

engineCallbacks:指向一个回调函数结构体,传入一些GDI函数到Display驱动中。

其中,DRVENABLEDATA结构中包含了Display驱动中的设备接口函数的指针,在DrvEnableDriver函数中调用了GPEEnableDriver函数,该函数会导出GWES模块所需的所有Display驱动的接口函数。同时GWES模块通过第四个参数engineCallbacks提供回调函数供Display驱动调用。该函数在”ddi_if”中定义。

另一个重要的函数是DisplayInit函数,它是第一个被执行的Display驱动中的函数,该函数主要用于读取注册表中的一些信息并作判断。该函数是可选的,也可以不在驱动中实现它。

BOOL APIENTRY DisplayInit(LPCTSTR pszInstance, DWORD dwNumMonitors)

{

DWORD dwStatus;

HKEY hkDisplay;

BOOL fOk = FALSE;

if(pszInstance != NULL) {

_tcsncpy(gszBaseInstance, pszInstance, dim(gszBaseInstance));

}

// sanity check the path by making sure it exists

dwStatus = RegOpenKeyEx(HKEY_LOCAL_MACHINE, gszBaseInstance, 0, 0, &hkDisplay);

if(dwStatus == ERROR_SUCCESS) {

RegCloseKey(hkDisplay);

fOk = TRUE;

}

else

{

RETAILMSG(0, (_T("SALCD2: DisplayInit: can‘t open ‘%s‘rn"), gszBaseInstance));

}

return fOk;

}

pszInstance:注册表中显示驱动的相关注册表值

dwNumMonitors:支持的Monitor的个数

在该函数中主要通过读取注册表信息判断显示驱动的存在,如果返回错误,则GWES会停止Display驱动的初始化。当然,用户可以根据自己的要求灵活掌握,也可以在这里初始化显示设备或做其他的初始化工作。

2.4 实现GPE类中的函数

由于NewGPE继承于GPE类,所以必须实现GPE类中的所有纯虚函数,这些函数实际上就是PDD层驱动中需要实现的函数,如下:

2.4.1 virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber)

获得显示模式。

pMode:输出显示模式结构

modeNumber:显示模式索引号

2.4.2 virtual int NumModes(void)

获得当前驱动支持的显示模式的个数

2.4.3 virtual SCODE SetMode(INT modeId, HPALETTE *palette)

设置显示模式。

modeId:显示模式索引号

palette:调色板指针,指向一个由EngCreatePalette函数创建的调色板

2.4.4 virtual SCODE AllocSurface(GPESurf **surface, INT width, INT height, EGPEFormat format, INT surfaceFlags)

在系统内存中创建一个绘图平面。

surface:指向被分配的内存的指针

width:宽度

height:高度

format:绘图平面格式

surfaceFlags:标记位,标明在哪分配内存

2.4.5 virtual SCODE SetPointerShape(GPESurf *pMask, GPESurf *pColorSurface, INT xHot, INT yHot, INT cX, INT cY);

设置光标形状。

pMask:指向一个包含光标形状的掩码

pColorSurface:指向被光标使用的颜色绘图平面

xHot:光标热点的X坐标

yHot:光标热点的Y坐标

cX:光标宽度

cY:光标高度

2.4.6 virtual SCODE MovePointer(int x, int y)

移动光标到指定位置或者隐藏光标

x:光标移动位置的x坐标,若为-1表示隐藏光标。[!--empirenews.page--]

y:光标移动位置的y坐标

2.4.7 virtual SCODE BltPrepare(GPEBltParms *blitParameters)

在做位块传输前会先执行该函数,用于确定执行BLT的函数

blitParameters:指向一个GPE的位块传输参数的结构体

2.4.8 virtual SCODE BltComplete(GPEBltParms *blitParameters)

该函数用于释放在BltPrepare中申请的资源

blitParameters:指向一个GPE的位块传输参数的结构体

2.4.9 virtual SCODE Line(GPELineParms *lineParameters, EGPEPhase phase)

画线函数

lineParameters:指向一个GPE的Line结构体,描述所画的线

phase:画线所处的阶段,具体描述如下

gpeSingle:画单根线

gpePrepare:准备画线

gpeContinue:画线过程中

gpeComplete:画线完成

在这里要提一点,有时我们会看到在该函数中调用另一个函数WrappedEmulatedLine(),这个函数在WinCE的PUBLIC目录下的参考Display驱动中也可以找到,该函数是一个快速的画线函数,里面采用了Bresenham画线算法,通过采用运行速度快的加减和移位运算来完成画线。

2.4.10 virtual SCODE SetPalette(const PALETTEENTRY *pSource, USHORT firstEntry, USHORT numEntries)

设置调色板

pSource:指向一个调色板入口信息的结构体

firstEntry:第一个入口

numEntries:入口的个数

2.4.11 virtual int InVBlank(void)

显示设备是否处于垂直消隐期间

上述函数在GPE类中均被定义为纯虚函数,需要在继承类中实现,也就是在我们的驱动程序中实现。这些函数是必须实现的。根据显示的需求,还可以在显示驱动中添加其他的函数,比如对光标的支持,对旋转的支持等,如下:

2.4.12 void CursorOn(void)

使能光标显示。

2.4.13 void CursorOff(void)

禁止光标显示。

2.4.14 void SetRotateParms(void)

设置屏幕翻转参数。

2.4.15 void DynRotate(int angel)

支持动态翻转。

angel:翻转角度

2.4.16 ULONG *APIENTRY DrvGetMasks(DHPDEV dhpdev)

获得显示模式的RGB掩码

dhpdev:指向掩码信息,比如RGB565模式为(0xf800,0x07e0,0x001f)

NOTE:该函数必须在驱动中被实现。

2.4.17 PowerHandler(BOOL bOff)

电源控制。

bOff:TRUE表示关闭电源,FALSE表示打开电源

2.4.18 ULONG DrvEscape(DHPDEV dhpdev, SURFOBJ* pso, ULONG iEsc, ULONG cjIn, PVOID pvIn, ULONG cjOut, PVOID pvOut)

该函数提供给应用程序的一个直接访问显示驱动的接口,和流设备驱动中的IoCtls函数类似。应用程序通过调用ExtEscape函数传送操作码和数据给显示设备驱动,DrvEscape函数会接收到数据并进行处理,然后返回相应结果给EstEscape函数。用户也可以根据需要自己定义相应的操作码。

dhpdev:设备句柄

pso:指向一个绘图平面的结构

iEsc:操作码

cjIn:输入数据buffer的大小

pvIn:指向输入数据buffer

cjOut:输出数据buffer的大小

pvOut:指向输出数据buffer

本站声明: 本文章由作者或相关机构授权发布,目的在于传递更多信息,并不代表本站赞同其观点,本站亦不保证或承诺内容真实性等。需要转载请联系该专栏作者,如若文章内容侵犯您的权益,请及时联系本站删除。
换一批
延伸阅读

北京2023年8月31日 /美通社/ -- 与狭义的人工智能相比,通用人工智能通过跨领域、跨学科、跨任务和跨模态的大模型,能够满足更广泛的场景需求、实现更高程度的逻辑理解能力与使用工具能力。2023年,随着 LLM 大规...

关键字: 模型 AI TOKEN GP

北京2023年8月31日 /美通社/ -- 进入2023年,ChatGPT推动世界步入一个全新时代——大模型时代,它不仅引发了AI产业的整体升级换代,同时也让各种大模型层出不穷,背后的关键原因在于,大模型能普遍提升生产力...

关键字: 模型 向量 开源 GP

解决了人工智能模型落地方面最大的瓶颈-能源成本-与行业及以往耐能的芯片相比,KL730在能效方面的进步达到了3到4倍。 KL730芯片提供每秒0.35 - 4 tera有效计算能力,支持最先进的轻量级GPT大语...

关键字: AI芯片 GP 模型 人工智能

纽约2023年3月11日 /美通社/ -- 北京时间2月25日,由海投全球和学说平台联合推出的《全球资产配置》系列课程之《风险投资入门》公开课正式上线,同步在海投全球微信视频号和学说平台进行直播。本课程共6节,涵盖风险投...

关键字: GP PPM GE GO

厦门2023年3月1日 /美通社/ -- 2023年2月24日,普普文化集团—代码(CPOP)宣布,目前公司在AIGC和ChatGPT等人工智能领域已经取得了阶段性的成果,其中:ChatGPT技术应用方面,公司旗下的深圳...

关键字: AI 人工智能 数字化 GP

扬州2023年2月8日 /美通社/ -- 美华国际医疗技术有限公司("MHUA "或 "公司") (NASDAQ: MHUA)是一家在中国拥有运营子公司的信誉良好的第一、第二和第三...

关键字: 人工智能 GP BSP 医疗器械

北京2023年2月1日 /美通社/ -- 微云全息公司(纳斯达克:HOLO)(以下简称为"HOLO"或"公司"),一家提供全息数字孪生技术服务提供商,今日宣布其研发出全息数字人GP...

关键字: NAS DAQ ASDA GP

EFFISAYIL™ 2临床试验显示,佩索利单抗能显著预防泛发性脓疱型银屑病(GPP)发作长达48周1,2 该研究结果建立在EFFISAYIL™ 1临床试验数据基础之上,EFFISAYIL™ 1临床试验表明使...

关键字: GP UI

基于EFFISAYIL®1 临床试验结果,EC授予有条件的上市许可,该临床试验表明超过半数接受佩索利单抗治疗的患者在接受单次剂量治疗后一周内实现脓疱清除[1,2] 泛发性脓疱型银屑病 (GPP...

关键字: GP PS OV GENERALIZED

史胜辉,在MTK工作了11年,一直在基带芯片的USB驱动领域做开发和验证。从最开始做USB2.0/3.0 IP验证和驱动开发到后面带领团队做上层协议驱动开发,以及跟硬件设计部门合作开发全新的USB硬件加速器。

关键字: 基带芯片 驱动领域 驱动开发
关闭
关闭