How to configure LCM resolution User Guide (Simplified Chinese Version)

MStar XMMI

How to configure LCM resolution User Guide (Simplified Chinese Version）Preliminary Version 0.2

在XMMI平台增加一种新的LCM指导说明（简体中文版）

目录

概述 (3)

1.模拟器 (3)

1.1.增加Phone Profile ID (3)

1.2.增加SVGA phone profile文件 (4)

1.3.修改配置文件 (5)

1.4.配置Simulator CUS (6)

1.5.Simulator配置结果 (6)

2.修改Compile Option (7)

2.1修改option.mak (7)

2.2修改bld.mak (8)

2.3修改product.mak (9)

2.4使用./tng/configure.pl命令同步option (9)

3.MMI (10)

3.1.增加Mmi_layout_XXX.h (10)

3.2.增加MMI_WDG_LAYOUT_XXXX_.h (11)

3.3.修改MMI_LAYOUT.h (12)

3.4.修改MMI_WDG_LAYOUT.H (13)

3.5.修改panelinfo.h (14)

3.6.修改panelinfohw.h (14)

3.7.修改touchscreen.h (14)

4.XRG Project (15)

4.1打开XRG Base project (15)

4.2基于Base project创建delta工程： (15)

4.3编译XRG工程 (16)

4.4编译Visual studio (17)

5.新LCM开发 (21)

5.1准备材料 (23)

5.2分析Layout文档 (24)

5.3修改Layout定义 (25)

5.4编译运行 (26)

概述

本文以SVGA（分辨率320 x 320）为例，介绍如何在MSTAR XMMI平台上增加一种新的LCM solution。主要内容包括配置新的simulator profile，增加XRG Delta工程，修改layout相关的头文件，要修改的Driver，最后以Mianmenu AP为例介绍如何将现有的QVGA调整为SVGA。

注意：本指导说明中的示例基于MSTAR XMMI平台v1.05版开发，不同版本的profile可能有所差异，凡是需要注意版本差异的地方本说明书都有提示，读者需自行判断！

1.模拟器

1.1. 增加Phone Profile ID

路径: SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug

文件名: MStarUISim.ini

对文件MStarUISim.ini需要做如下修改：

[Config]

ProfileNum=6 总共分辨率的个数，等于原profile个数加1,不同版本的值可能不同ProductProfile=..\..\..\..\config.mak

ComplierOptionBatch=.\buildOpt.bat

OptionRte=..\..\..\..\MStarStudio_Config\option.rte.2005

……

[Profile1]

Name=QVGA version

PhoneProfile=.\PhoneProfile\D300\config.ini

KernelProfile=MKernelWin32_QVGA.ini

[Profile2]

Name=CINTA

PhoneProfile=.\PhoneProfile\Cinta\config.ini

KernelProfile=MKernelWin32_QVGA.ini

……

[Profile6] 需要增加的SVGA部分（不同版本profile 号码可能不同）

Name=SVGA version

PhoneProfile=.\PhoneProfile\SVGA\config.ini

KernelProfile=MKernelWin32_SVGA.ini

;[Profile2]

;Name=Aug version

;PhoneProfile=..\..\..\MStarOut\PhoneProfile\Augusta\config.ini

;KernelProfile=MKernelWin32.ini

;KernelProfile=MKernelWin32.ini

1.2. 增加SVGA phone profile文件

路径：SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug\PhoneProfile

1.在此路径下新建SVGA文件夹

2.把D300文件夹中所有的内容copy至SVGA文件夹中(其中D300是QVGA的profile)

3.修改profile图片，本例子只修改section0.bmp，此图片是simulator profile的主界面，我们只是将

屏幕显示区域扩大成320 x 320，如下图所示：

1.3. 修改配置文件

路径: SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug\PhoneProfile\SVGA

文件: config.ini

config.ini文件包含了组成simulator的所有图片的属性,包括图片坐标(pos),大小(size)等。我们需要在此配置LCM屏幕区域大小和按键的布局和图片等信息。

……

[TouchLcd0_0]

ImgDefault=

ImgPosX=103 显示屏区域在正个simulator中的位置(x,y)

Name=KEY_CAMERA

Cmdcode=95

RowCode=1

ColCode=5

IsActive=0

ImgPressed=key_shutter_P.BMP

ImgReleased=key_shutter_R.BMP

ImgDefault=key_shutter_D.BMP

ImgNoValid=key_shutter_N.BMP

……

1.4. 配置Simulator CUS

路径: SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug

1在此目录下新建文件命名为：MKernelWin32_SVGA.ini

2 把此目录MKernelWin32_QVGA.ini文件的内容拷贝到MKernelWin32_SVGA.ini中

1.5. Simulator配置结果

路径: SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug

文件：MStarSimulator.exe

双击打开MStarSimulator.exe，我们可以看到显示如下图

2.修改Compile Option

2.1 修改option.mak

路径：SRC\ proj\sc\customer\SZ\cinta_v2\mak

文件：options.mak

打开options.mak，对该文件做如下改动：

# Feature_Name=LCM Resolution

# Description=Option for LCM resolution

# Pre_Condition_On= N/A

# Pre_Condition_Off= N/A

# Option_Selection= __LCM_QVGA__, __LCM_WQVGA_240_400__, __LCM_QCIF_PLUS__,

__LCM_HVGA_320_480__,LCM_SVGA_320_320__

PP_OPT_COMMON += __LCM_SVGA_320_320__ #开启宏SVGA，关闭原有宏QVGA

……

# Feature_Name=LCM Resolution - HVGA (DRV)

# Description=LCM Resolution

# Pre_Condition_On= __LCM_HVGA_320_480__

# Pre_Condition_Off= N/A

# Option_Selection= N/A

ifeq ($(filter __LCM_HVGA_320_480__ ,$(PP_OPT_COMMON)),__LCM_HVGA_320_480__)

PP_OPT_COMMON += __LCM_HVGA_DRV__

endif

# Feature_Name=LCM Resolution - SVGA (DRV)

# Description=LCM Resolution

# Pre_Condition_On= __LCM_SVGA_320_320__

# Pre_Condition_Off= N/A

# Option_Selection= N/A

ifeq ($(filter __LCM_SVGA_320_320__ ,$(PP_OPT_COMMON)),__LCM_SVGA_320_320__) PP_OPT_COMMON += __LCM_SVGA_DRV__

endif

……

# Feature_Name=LCM Resolution - HVGA (DRV)

# Description=LCM Resolution

# Pre_Condition_On= __LCM_HVGA_320_480__

# Pre_Condition_Off= N/A

# Option_Selection= N/A

ifeq ($(filter __LCM_HVGA_320_480__ ,$(PP_OPT_COMMON)),__LCM_HVGA_320_480__)

PP_OPT_COMMON += __LCM_HVGA_DRV__

# Feature_Name=LCM Resolution - SVGA (MMI)

# Description=LCM Resolution

# Pre_Condition_On= __LCM_SVGA_320_320__

# Pre_Condition_Off= N/A

# Option_Selection= N/A

ifeq ($(filter __LCM_SVGA_320_320__ ,$(PP_OPT_COMMON)),__LCM_SVGA_320_320__) PP_OPT_COMMON += __LCM_SVGA_320_320_MMI__

endif

……

# Feature_Name=MAP

# Description=Option for supporting map engine

# Pre_Condition_On= N/A

# Pre_Condition_Off= N/A

# Option_Selection= N/A

PP_OPT_COMMON += no__MAP__ #电子地图修改起来比较复杂，我们可以先将其关掉

……

2.2 修改bld.mak

路径：SRC\proj\sc\customer\SZ\cinta_v2\mak

文件：bld.mak

Bld.mak主要用来控制Cygwin 编译哪个XRG工程，我们需要在这里加入新LCM的编译选项：

ifeq ($(filter __LCM_WQVGA_240_400_MMI__ ,$(PP_OPT_COMMON)),__LCM_WQVGA_240_400_MMI__) CUS_PROJECT = xmmi_wqvga_240_400

CUS_PATH = xmmi_wqvga_240_400

else

ifeq ($(filter __LCM_QCIF_PLUS_MMI__ ,$(PP_OPT_COMMON)),__LCM_QCIF_PLUS_MMI__)

CUS_PROJECT = xmmi_qcif_plus

CUS_PATH = xmmi_qcif_plus

else

ifeq ($(filter __LCM_HVGA_320_480_MMI__ ,$(PP_OPT_COMMON)),__LCM_HVGA_320_480_MMI__) CUS_PROJECT = xmmi_hvga_320_480

CUS_PATH = xmmi_hvga_320_480

else

ifeq ($(filter

__LCM_SVGA_320_320_MMI__ ,$(PP_OPT_COMMON)),__LCM_SVGA_320_320_MMI__) CUS_PROJECT = xmmi_svga_320_320

CUS_PATH = xmmi_svga_320_320

else

CUS_PROJECT = xmmi

CUS_PATH = xmmi_base

endif #这边的endif一定要加

endif

endif

2.3 修改product.mak

路径：SRC\proj\sc\customer\SZ\cinta_v2\mak

文件：product.mak

与bld.mak类似，我们也需要再product.mak中加入新LCM的编译选项

ifeq ($(filter __LCM_WQVGA_240_400_MMI__ ,$(PP_OPT_COMMON)),__LCM_WQVGA_240_400_MMI__) CUS_PROJECT = xmmi_wqvga_240_400

CUS_PATH = xmmi_wqvga_240_400

else

ifeq ($(filter __LCM_QCIF_PLUS_MMI__ ,$(PP_OPT_COMMON)),__LCM_QCIF_PLUS_MMI__)

CUS_PROJECT = xmmi_qcif_plus

CUS_PATH = xmmi_qcif_plus

else

ifeq ($(filter __LCM_HVGA_320_480_MMI__ ,$(PP_OPT_COMMON)),__LCM_HVGA_320_480_MMI__) CUS_PROJECT = xmmi_hvga_320_480

CUS_PATH = xmmi_hvga_320_480

else

ifeq ($(filter

__LCM_SVGA_320_320_MMI__ ,$(PP_OPT_COMMON)),__LCM_SVGA_320_320_MMI__) CUS_PROJECT = xmmi_svga_320_320

CUS_PATH = xmmi_svga_320_320

else

CUS_PROJECT = xmmi

CUS_PATH = xmmi_base

endif

endif

endif

endif

2.4 使用./tng/configure.pl命令同步option

所有这些文件修改完后，需要将上一小节中改动的complier option同步到options.ret.2005文件中

1.打开Cywin

2.cd到XMMI工程的proj目录下

3.输入./tng/configure.pl 然后按提示敲回车即可

运行结束后如果出现如下界面则表示执行成功了：

3.MMI

3.1. 增加Mmi_layout_XXX.h

Mmi_layout_xxx.h中包含的是XMMI 平台中AP(应用程序)的Layout，每种LCM resolution都会有其对应的文件，如mmi_layout_qvga.h, mmi_layout_wqvga_240_400.h, mmi_layout_qcif_plus.h。同理，我们需要在这里增加mmi_layout_svga_320_320.h。步骤如下：

1.在此目录下新增一个文件：mmi_layout_svga_320_320.h,此文件的作用是对AP UI layout进行描述

2.把mmi_layout_qvga.h的内容copy到mmi_layout_svga_320_320.h中。

这里将QVGA的layout definition拷贝到SVGA中是为了后面方便修改

3.2. 增加MMI_WDG_LAYOUT_XXXX_.h

路径：SRC\proj\sc\application\mmi\widgets\inc

Mmi_wdg_layout_xxx.h中包含的是XMMI 平台中Widget(XMMI控件)的Layout。同样，每种LCM resolution都会有其对应的文件，如mmi_wdg_layout_qvga.h, mmi_wdg_layout_wqvga_240_400.h,

mmi_wdg_layout_qcif_plus.h。同理，我们需要在这里增加mmi_wdg_layout_svga_320_320.h。步骤如下：

1.在此目录下新增一个头文件mmi_wdg_layout_svga_320_320.h

2.把mmi_wdg_layout_qvga.h的内容copy到mmi_wdg_layout_svga_320_320.h中，以便后面修改。

3.3. 修改MMI_LAYOUT.h

路径：SRC\\proj\sc\application\mmi\common\inc

文件：mmi_layout.h

Mmi_layout.h主要定义了LCD的一些信息，以及在不同LCM解决方法中要include的AP layout头文件

在Mmi_layout.h中做如下修改：

#ifndef __MMI_LAYOUT_H__

#define __MMI_LAYOUT_H__

#define MMI_UI_LAYOUT_QVGA_VERSION_1 0x000000001

#define MMI_UI_LAYOUT_QCIF_PLUS_VERSION_1 0x000000002

#define MMI_UI_LAYOUT_WQGVA_PLUS_VERSION_1 0x000000003

#define MMI_UI_LAYOUT_HGVA_PLUS_VERSION_1 0x000000004

#define MMI_UI_LAYOUT_SGVA_PLUS_VERSION_1 0x000000005

……

#elif defined __LCM_HVGA_320_480_MMI__

/* HVGA - 320x480 */

#define MAIN_LCD_WIDTH 320 ///< width of main lcd

main

lcd

of

MAIN_LCD_HEIGHT 480

height

#define

///<

#define MAIN_LCD_ONELINE_HEIGHT 48 ///< one line height of main lcd

#define MAIN_LCD_TWOLINE_HEIGHT 96 ///< two line height of main

……

#define MMI_UI_LAYOUT_VERSION MMI_UI_LAYOUT_HGVA_PLUS_VERSION_1

#elif defined __LCM_SVGA_320_320_MMI__ /*-----------------add SVGA----------------------*/ /* SVGA - 320x320 */

of

main

width

lcd

#define

///<

MAIN_LCD_WIDTH

320

#define MAIN_LCD_HEIGHT 320 ///< height of main lcd

#define MAIN_LCD_ONELINE_HEIGHT 32 ///< one line height of main lcd

__FEATURE_SUB_DISPLAY__

#ifdef

#define SUB_LCD_WIDTH 96//96

#define SUB_LCD_HEIGHT 64//96

#endif /* __FEATURE_SUB_DISPLAY__ */

#define MMI_UI_LAYOUT_VERSION MMI_UI_LAYOUT_SGVA_PLUS_VERSION_1

#else

/* QCIF - 176x220 */

width

of

lcd

main

///<

176

#define

MAIN_LCD_WIDTH

main

lcd

of

///<

#define

MAIN_LCD_HEIGHT 220

height

……

#elif defined __LCM_WQVGA_240_400_MMI__

#include "mmi_layout_wqvga_240_400.h"

#elif defined __LCM_HVGA_320_480_MMI__

#include "mmi_layout_hvga_320_480.h"

#elif defined __LCM_SVGA_320_320_MMI__ //add SVGA

#include "mmi_layout_svga_320_320.h"

#else

#include "mmi_layout_qcif_plus.h"

#endif /* __LCM_QVGA_MMI__ */

#endif /* __MMI_LAYOUT_H__ */

3.4. 修改MMI_WDG_LAYOUT.H

路径：SRC\proj\sc\application\mmi\widgets\inc

文件: mmi_wdg_layout.h

Mmi_wdg_layout.h主要定义了LCD的一些信息，以及在不同LCM解决方法中要include的AP layout头文件 在mmi_wdg_layout.h中添加如下代码:

……

#ifdef __LCM_HVGA_320_480_MMI__

#include "mmi_wdg_layout_hvga_320_480.h"

#else

#ifdef __LCM_SVGA_320_320_MMI__ //add SVGA

#include "mmi_wdg_layout_svga_320_320.h"

#else

#include "mmi_wdg_layout_qcif_plus.h"

#endif //......................SVGA_320_320_MMIi__

#endif // end of __LCM_HVGA_320_480_MMI__

……

3.5. 修改panelinfo.h

路径：SRC\proj\sc\driver\gss\inc

文件：panelinfo.h

#elif defined(__LCM_WQVGA_240_432_DRV__)

#define MAIN_PANEL_WIDTH 240

#define MAIN_PANEL_HEIGHT 432

#elif defined(__LCM_HVGA_DRV__)

#define MAIN_PANEL_WIDTH 320

#define MAIN_PANEL_HEIGHT 480

#elif defined (__LCM_SVGA_DRV__)

#define MAIN_PANEL_WIDTH 320 #define MAIN_PANEL_HEIGHT 320 #else

3.6. 修改panelinfohw.h

路径：SRC\proj\sc\driver\gss\inc

文件：panelinfohw.h

在panelinfohw.h中加入新LCM的屏幕宽高，代码如下：#elif defined (__LCM_QCIF_PLUS_DRV__)

#define MAIN_PANEL_WIDTH 176

#define MAIN_PANEL_HEIGHT 220

#elif defined (__LCM_SVGA_DRV__)

#define MAIN_PANEL_WIDTH 320 #define MAIN_PANEL_HEIGHT 320 #else

#define MAIN_PANEL_WIDTH 176

#define MAIN_PANEL_HEIGHT 220

3.7. 修改touchscreen.h

路径：SRC\proj\sc\driver\tscr\inc\

文件：touchscreen.h

#elif defined(__LCM_WQVGA_240_432_DRV__)

#define TOUCH_SCREEN_WIDTH 240

#define TOUCH_SCREEN_HEIGHT 432

#elif defined(__LCM_QCIF_PLUS_DRV__)

#define TOUCH_SCREEN_WIDTH 176

#define TOUCH_SCREEN_HEIGHT 220

#define TOUCH_SCREEN_WIDTH 320

#define TOUCH_SCREEN_HEIGHT 480

#elif defined(__LCM_SVGA_DRV__)

#define TOUCH_SCREEN_WIDTH 320

#define TOUCH_SCREEN_HEIGHT 320

#else

4.XRG Project

4.1 打开XRG Base project

路径：SRC\tools\XRG

文件：XRG.exe

双击打开XRG.exe，在菜单栏点击File->Open project

在弹出窗口中选择路径“SRC\proj\sc\customer\SZ\src\mmi\resource\xmmi_base”选择xmmi.xml文件

4.2 基于Base project创建delta工程：

Base project打开后在菜单栏中点击File ‐> New Project ‐> Delta Project

在弹出窗口中输入此delta工程的名字：xmmi_svga_320_320

点击OK会弹出一个dialog，然后点确定，

至此delta工程就创建好了。XRG工具会自动在路径SRC\proj\sc\customer\SZ\src\mmi\resource下生成文件夹xmmi_svga_320_320和xmmi_svga_320_320_Res，如下图所示：

4.3 编译XRG工程

Delta工程建好后我们就可以编译该工程了

点击菜单栏Build -> Build All或者按快捷键 F5编译XRG工程

编译过程截图：

编译成功后XRG的message框提示如下：

4.4 编译Visual studio

路径：SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI

文件：SZ_XMMI_BuildAll_cus.sln

1.用Visual studio 2005（以下简称VS2005）打开该工程文件

2.在菜单栏点击Build -> Build Solution

Build 成功后output栏显示如下：

3.Debug

VS2005编译成功后在菜单栏点击Debug -> Start Debugging

4.选择Debug工具

如果是第一次Debug会弹出如下界面，如果不是第一次执行此工程则不需执行此步骤。

在第一个下拉框中点Browse(浏览)

然后在弹出框输入路径”SRC\proj\MStarStudio_UP\MStarDeveloper\XMMI\debug”，选择MStarSimulator.exe

对于此问题有两种解决方法：

方法一、将别的用Cygwin编译过的代码包的proj\build\cinta_v2\out路径中的所有e2p文件，拷贝到当前代码包的这个路径中。也可以把下面附件“E2p.7z”压缩包中的e2p文件拷贝到此目录里。

E2p.7z

方法二、用Cygwin编译一下此工程。

5.选择profile，运行Simulator

在弹出Dialog的Phone Profile中选择SVGA Profile，再点0K键。

然后会弹出如下的两个窗口，在左侧窗口中点击绿色的Run按键