K3 Windows Mobile安装配置指导说明书

本文由327651605贡献
doc文档可能在WAP端浏览体验不佳。建议您优先选择TXT，或下载源文件到本机查看。
产品名称Product name K3 产品版本Product version V100R001
密级Confidentiality level 内部公开 Total 34pages 共34页
K3 Windows Mobile安装配置指导说明书
Prepared by 拟制 Reviewed by 审核 Approved by 批准
李秋先 56651
Date 日期 Date 日期 Date 日期
2008-06-11
Huawei Technologies Co., Ltd. 华为技术有限公司
All rights reserved 版权所有 侵权必究 （REP01T01 V2.6 / for internal use only） （REP01T01 V2.6 / 仅供内部使用）
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
Revision record 修订记录
Date 日期 Revision Version 修订 版本 1.0 1.1 Change Description 修改描述 initial 初稿完成 加入虚拟网络适配器的搭建 加入 ActiveSync 和 CETK 部分 修改注意事项 Author 作者 李秋先 56651 李秋先 56651
2008-06-11 2008-06-30
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page2, Total 34 第 2 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
Table of Contents 目
录
K3 Windows Mobile安装配置指导说明书 …… 1 安装配置指导说明书 1 Introduction 简介 …… 6 1.1 1.2 2 Purpose 目的 …… 6 Scope 范围 …… 6
基于Device Emulator的PB调试 …… 6 基于 的 调试 2.1 2.1.1 2.1.2 2.1.3 2.2 2.3 2.3.1 2.3.2 2.3.3 2.3.4 2.3.5 2.3.6 2.4 2.4.1 2.4.2 Debug版Device Emulator的内核镜像文件的编译介绍 …… 6 Device Emulator 内核镜像的配置 …… 6 Device Emulator 内核镜像的编译 …… 11 Debug版本验证 …… 12
安装Microsoft Loopback Adapter虚拟网络适配器 …… 12
Device Emulator内核镜像和模拟器的连接 …… 18 加载内核镜像 …… 18 配置Connectivity options …… 19 连接设备(attach device) …… 22 设置断点 …… 28 设置调试信息输出到文件 …… 29 编译、动态加载Fakeril.dll模块 …… 29
使用Device Emulator …… 30
如何使模拟器连接到ActiveSync …… 30 如何使模拟器连接到CETK …… 32
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page3, Total 34 第 3 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
List of Figures 图目录
图1 HiJPEGConfigure OS Build Tree Location……………………………… ………..6 图1Imaging API软件架构…………………………………………………………………………..8
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page4, Total 34 第 4 页,

共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
K3 Windows Mobile安装配置指导说明书
Keywords 关键词： K3，Windows Mobile 关键词： Abstract 摘要： 摘要： Device Emulator是微软提供的Windows Mobile上运行的模拟器， Device Emulator 可以模拟真实的Windows Mobile设备的运行环境，是个很实用的工具。本文描述了K3 WM 的安装 和配置的操作指导。 List of abbreviations 缩略语清单： 缩略语清单： Abbreviations 缩略语 PB WM Platform Builder Windows Mobile Full spelling 英文全名 Chinese explanation 中文解释
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page5, Total 34 第 5 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
1
1.1
Introduction 简介
Purpose 目的
本文描述了使用Microsoft Platform Builder for Windows Mobile 5.0， 在PC上进行硬件平台无关的 调试，即编译、加载、运行、调试跟踪(断点、单步)、调试信息输出、模块动态加载等操作。本文 的对象为所有初次使用WM的人员。 1.2 Scope 范围
本文档描述K3中Windows Mobile的模拟器的安装配置调试， 对于实际单板的加载调试也有一定 的参考意义。
2
2.1
基于 Device Emulator 的 PB 调试
Debug 版 Device Emulator 的内核镜像文件的编译介绍
2.1.1 Device Emulator 内核镜像的配置 点击：开始-->所有程序--> Microsoft Platform Builder for Windows Mobile 5.0-->New Build Window Wizard，从PC机启动Platform Builder for Windows Mobile 5.0提供的New Build Window Wizard，并按以下步骤配置Device Emulator的内核镜像： 步骤一：Configure OS Build Tree Location 安装完WM50_PB后，下图中OS build tree的默认设置路径应该为“E:\WM500”，而图中为 “E:\WM607”，这是因为我们安装了新的AKU_0.7（18541）。而如果我们安装了AKU_0.7，则需 定位到AKU_0.7的安装文件初级路径上，即“E:\WM607”，后续的路径会随着AKU的不断更新而 改变，如：WM610、WM612、WM613等。AKU版本相互独立，不必删除旧版本的安装。本文以 WM607为例进行描述。 点击下图所示中的Browse，选择新AKU所安装的路径，从而完成配置_WINCEROOT环境变量。 路径定为后，点击“Next”按钮，进入步骤二。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page6, Total 34 第 6 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图1 Configure OS Build Tree Location 示意图
步骤二：Configure Build Window Parameters 选择配置参数，具体的Device Emulator 的内核镜像的配置参数如下图所示：
2011-2-23
Con

fidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page7, Total 34 第 7 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图2 Configure Build Window Parameters 示意图
如果编译的是Device Emulator的内核镜像， BSP参数选择Device Emulator， 由于为了不影响AKU 提供的Device Emulator工程，我们需要先选择Clone一个Device Emulator, 这里MyDevice就是Clone 的Device Emulator BSP。点击图2中蓝色标记的“Clone”按钮，按照如下的设置Clone一个Device Emulator。或者不点击如上图标，直接选择”Next”，将会出现对话框提示“You have select a BSP that has not been cloned.Do you want to clone this BSP? ” 选择 “是” 也弹出图三所示提示框， ， 从而Clone 一个BSP。 如果需要编译在单板上运行的内核镜像， （选择的BSP为P2Sample, 这是基于TI OMAP 730的参
2011-2-23 Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散 Page8, Total 34 第 8 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
考BSP）或者选择HiK3的……这是基于海思K3的参考BSP。
图3 Clone BSP 示意图
如果需要Device Emulator的内核镜像支持PB调试，那么Release type选项选择Debug。如果编译 PDA的Device Emulator, Project type选项选择Pocket PC, SKU选项选择Pocket PC Phone。 选择完毕后， 点击“Next”按钮，进入步骤三。 步骤三：Configure Output Options 配置内核镜像的路径，包括batch file location 和 release directory，前者为批处理文件的路径， 后者为编译完毕后，生成镜像文件的路径。一般选择创建快捷方式。如下图所示：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page9, Total 34 第 9 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图4 Configure Output Options 示意图
设置完成以上三步配置后， 可以选择finish生成编译的batch文件。 如果是第一次配置会连续出现 如下的三个提示，这三个都是创建路径的提示，直接点击Yes即可
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page10, Total 34 第 10 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图5 路径生成 示意图
之后，会退出New Build Window Wizard的创建界面，等待用户全编译过后再重新进入PB。 2.1.2 Device Emulator 内核镜像的编译 完成2.1.1中的配置步骤后，New Build Wizard 会为我们自动创建三个编译用的batch file： BaseOSEnv.bat、BuildAll.bat、UpdateLoaderEnv.bat，运行Buil

dAll.bat就可以开始编译内核镜像。也 可以运行桌面上生成的快捷方式，分别对应这三个批处理文件。 为了能够使用KITL进行调试，需要清除IMGNOKITL环境变量或者 set IMGNOKITL = 0，在命 令行方式下输入 set IMGNOKITL，如果显示结果为 如下图所示，则表明即将编译的IMG支持 KITL调试功能。
图6 测试 IMG 是否支持 KITL 调试 示意图 2011-2-23 Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散 Page11, Total 34 第 11 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
在配置好编译环境后，运行BuildAll.bat或指向该文件的快捷方式开始编译，编译成功完成后会 显示相应的信息。编译的时间比较长，请耐心等候，大约1.5～2.0 hour之后，能够编译完成。 注：每次更新AKU后，需要全编译一次，单独的模块编译不需要。 2.1.3 Debug 版本验证 成功完成编译后，我们可以通过如下方法验证编译的 IMG 是否具有 KITL 调试功能： 首先，查看 release 目录下 nk.exe 文件，该文件是 IMG 运行的内核文件。 然后，查看 release 目录下的 kern*.exe 文件，结果一共有三个文件：kern.exe, kernkitl.exe, kernkitlprof.exe。 （使用 Folder1 文件夹是因为需要重新编译，比较耗时，此处标记，后面更换）
图7 验证 IMG 是否支持 KITL 调试 示意图
如果 nk.exe 的的大小和 kernkitl.exe 的大小相同，则基本可以判断所编译的 IMG 是 Debug 版的。 2.2 安装 Microsoft Loopback Adapter 虚拟网络适配器
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散 Page12, Total 34 第 12 页, 共 34 页
2011-2-23
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
按照下列步骤进行安装（适用于Windows XP操作系统）：
（1） 点击开始->设置->控制面板->添加硬件，进入添加硬件向导，点击下一步；
（2） 选择“是，我已经连接了此硬件”，点下一步，如下图：
（3） 在已安装的硬件列表中，选择“添加新的硬件设备”，点下一步，如下图：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page13, Total 34 第 13 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（4） 选择“安装我手动从列表选择的硬件（高级）”，点下一步，如下图：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page14, Total 34 第 14 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（5） 在常见硬件类型列表中选择

“网络适配器”，点下一步，如下图:
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page15, Total 34 第 15 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（6） 在厂商列表中选择“Microsoft”，在网卡列表中选择“Microsoft Loopback
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page16, Total 34 第 16 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（7） 点下一步，选择“完成”。
（8） 之后，在电脑右下角会出现“本地连接 X”的提示(X 随不同 PC 机有所不同)，见下图：
双击打开（或者通过网上邻居->属性打开），设置 ip 地址及子网掩码的地址，分别为：IP 地 址：192.168.0.20，子网掩码：255.255.255.0 如下图所示：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page17, Total 34 第 17 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
此时 PC 右下角的图标提示：“本地连接 X”已经可用。至此，虚拟网络适配器搭建完毕。 2.3 Device Emulator 内核镜像和模拟器的连接
2.3.1 加载内核镜像 通过开始-->所有程序--> Microsoft Platform Builder for Windows Mobile 5.0启动Platform Builder for Windows Mobile 5.0, 会出现要求选择有效环境变量的提示，点击“ok”即可 选择File->Open打开E:\WM607\release\WPC_MyDeviceFolder_Debug\WPC目录下的 diskimage.nb0文件。在PB的左侧会出现如下图所示的侧窗口
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page18, Total 34 第 18 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图8 diskimage.nb0 的侧窗口 示意图
注： 初次打开PB的时候， 会跳出一个提示框： 关于WINCEROOT的变量丢失， 由于安装时选择了Tool Only，故使用默认即可。 2.3.2 配置 Connectivity options 在连接设备前，需要先配置connectivity options。在PB界面下选择Target->Connectivity Options 打开如下对话框：
图9 Connectivity Options 的默认配置 示意图
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page19, Total 34 第 19 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
上图所示的是缺省配置，下面我们需要对各项进行配置，按照下图所示进行connectivity options 的配置。其中Kernel Service Map的配置如下： 由于我们编译的内核镜像

是针对Device Emulator的，因此在Download选项中选择Device Emulator。如果是连接真实的单板，在Download选项选择Ethernet或Serial。
图10 Kernel Service Map 示意图
在 Kernel Service Map 中选择了 Device Emulator 后，我们需要选择右边的 Settings 进行配置。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page20, Total 34 第 20 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图11 Device Emulator 设置一
图12 Device Emulator 设置二
Kernel Service Map 中选择了 Transport 后， 我们也需要选择右边的 Settings， “Use device name from 将 bootloader”选项选中
图13 Ethernet KITLSetting 设置 2011-2-23 Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散 Page21, Total 34 第 21 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
配置完 Kernel Service Map 的属性后， 检查 Core Service Setting 选项的设置： 与下图的设置保持一致。
图14 Core Service Setting 的设置 示意图
完成上述的 connectivity options 的配置后，选择 Apply 使配置生效。 2.3.3 连接设备(attach device) 打开 PB 界面，选择界面红色圆圈中的工具条按钮用于连接设备(attach device)
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page22, Total 34 第 22 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
图15 PB 连接设备
按钮点击后会同时弹出三个对话框，如下图所示：分别为模拟器的显示界面、镜像下载界面、模拟 器调试输出界面，系统等待用户进行连接，当用户完成相关设置后，连接目标版(此处为模拟器)。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page23, Total 34 第 23 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page24, Total 34 第 24 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
注意： 注意：
1、 在全编译过后，需要将 E:\WM607\release\WPC_MyDeviceFolder_Debug\WPC 目录下编译生成的 EBOOT.nb0 文 件 拷 贝 到 安 装 目 录 E:\Program Files\Platform Builder for Windows Mobile\5.00\CORECON\BIN\SMDK 下，取代之前存在的 EBOOT.nb0 文件。否则会出现无效镜 像的提示（或者错误）。 2、 在首次安装的 AKU607 中， 下载过程会出现找不到 gsm610.acm 的情况， 直接取

消即可， 不影响。 3、 在调试输出界面必须在倒计时数秒结束之前，按【空格键】进入配置状态，否则进入缺省选项 设置，Platform Builder 的 Debug 输出开始显示调试信息。 下面设置一些配置选项：
输入 0：将 IP 地址设置为。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page25, Total 34 第 25 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
输入 1：将子网掩码设置为 255.255.255.0
输入 2：把 DHCP 改为 Disable
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page26, Total 34 第 26 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
然后输入 d，进入下载画面：可以看到如下图所示，正在下载的动画图
同时 Debug 信息不断的输出 注：若在 download 过程中，出现找不到 gsm610.acm 的情况，直接取消即可，不影响后续的调试。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page27, Total 34 第 27 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
2.3.4 设置断点 在 PB 中，File->Open 在 D:\WM530\PUBLIC\OSSVCS\RIL\DRIVER\FAKERIL\路径下的 callctrl.cpp 文件中添加断点，使用 DeviceEmulator 进行拨号，如下图：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page28, Total 34 第 28 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
2.3.5 设置调试信息输出到文件 在PB中，Target->Debug Message Options
点击”OK”即可。 2.3.6 编译、动态加载 Fakeril.dll 模块 在桌面上， 双击 BaseOSEnv.bat， 然后切换路径 E:\WM607\PUBLIC\OSSVCS\RIL\DRIVER\FAKERIL 在此 dos 框中运行
Set WINCEDEBUG = debug
Set WINCEREL = 1
Build –c
sysgen -p ossvcs fakeril 在目录 E:\WM607\release\WPC_MyDevice_Debug\WPC 下，生成以下新文件 fakeril.dll、fakeril.map、 fakeril.pdb、fakeril.rel 注意： 在调试的时候需要将全编译生成的 diskimage.nb0、 fakeril.dll、 fakeril.map、 fakeril.pdb、 fakeril.rel 必须在同一目录下，否则调试的时候断点很可能停不住。
2011-2-23 Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散 Page29, Total 34 第 29 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
在 PB 中，Target->Release Directory Modules，选择添加 fakeril.dll，点击”OK”，至此完成动态加载 过程
呼叫模块如此，其他的

模块调试的方法亦是如此，只是需要输入的选项、命令有所不同。 2.4 使用 Device Emulator
2.4.1 如何使模拟器连接到 ActiveSync 注意：使用前查看ActiveSync的版本，目前需要ActiveSync的版本至少在4.5以上。 可按下面的步骤实现： （1） 右键点击状态栏中的 ActiveSync 图标，选择“连接设置”，在连接设置窗口中选中“允 许连接到以下其中一个端口”，在下拉表框中选择“DMA”，其它保持默认设置即可；
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page30, Total 34 第 30 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（2） 在模拟器上点开始->程序->ActiveSync，在 ActiveSync 程序界面中选择“菜单->连接”， 在弹出窗口中选择连接方式为“`DMA Default”；
（3） 运行 Device Emulator Manager 应用程序，在界面中选择上 Device Emulator for Windows CE，点右键选择 Cradle，就可以发起 ActiveSync 连接了。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page31, Total 34 第 31 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（4） Device Emulator Manager 应用程序的默认路径在 C:\Program Files\Microsoft Device Emulator\1.0，如果找不到，把附件保存到本地，解压缩后运行即可。
dvcemumanager.rar
i.
如何使模拟器连接到 CETK 模拟器如果不做任何配置，是不能够连接到CETK的，如果想使用CETK，可按下面的步骤实现： （1） 在 PC 侧打开 Windows CE Test Kit； （2） 把客户端程 序 clientside.exe 拷贝到模拟器侧， clientside.exe 的保存路径 是 在%_WINCEROOT%\Others\Wcetk\， 由于 Device Emulator 模拟器模拟的是 ARM 处理器，所以选择 ARMV4I。 （3） 获取 Microsoft Loopback Adapter 的 IP 地址：右键单击“网上邻居”，选择“属性”， 确定 Microsoft Loopback Adapter 的网络连接名称，比如是“本地连接 5”；点击开始-> 运行， “cmd” 输入 后回车， 打开命令行窗口， 运行命令 “ipconfig” 获取 Microsoft Loopback Adapter 的 IP 地址，如下图：
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page32, Total 34 第 32 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
（4） 新建一个文本文件，重命名为“Wcetk.txt”，然后输入下面这段文字并保存，然后把 “Wcetk.txt”也拷贝到模拟器侧。 SERVERIP= PORTNUMBER=5555 注意：实际使用时用步骤（3）获 >用步骤（ 地址代替， 取到的Microsoft Loopback Adapter的IP地址代

替，比如 到的 的 地址代替 比如269.254.25.129。 。 （5） 在模拟器侧运行 clientside.exe， 就可以发起连接 CETK 的操作， 等到 PC 侧的 Windows CE Test Kit 显示连接成功后，就可以使用 CETK 了。 （6） 附件 1：如果找不到 clientside.exe，可以把附件的文件拷贝到本地，解压缩后就可以用 了。
clientside.rar
（7） 附件 2：Wcetk.txt 示例文档，供参考。
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page33, Total 34 第 33 页, 共 34 页
K3 Windows Mobile 安装配置指导说明书
Confidential 内部公开
Wcetk.rar
2011-2-23
Confidential Information of Huawei. No Spreading without Permission 华为机密，未经许可不得扩散
Page34, Total 34 第 34 页, 共 34 页