为了方便用户学习 emWin, Segger 官方设计了很多 emWin 应用的例子。这些程序都可以直接在 windows 系统上仿真运行,这样伟大的功能极大方便了我们学习emWin,也方便我们进行界面布局设计,节省时间。
仿真工程获取及简介
emWin 的 Windows 仿真版本是免费的,大家可以直接在 Segger 官网下载,
下载链接:https://www.segger.com/downloads/emwin/。
这里通过 VS 2019 运行仿真工程,使用的emWin是5.48版本。我们解压之后,内容及其含义如下:
VS 2019运行工程
首先,要确保文件解压路径不存在中文,否则会出现编译错误的问题。
VS 2019安装完成之后,双击打开上图中的sln文件,在VS中会弹出关于Visual C++版本的对话框,选择“确定”后等待安装完成即可。
之后需要配置仿真工程属性,打开工程后右击SimulationTrial项目,选择属性。然后进入链接器下的输入,在附加依赖项中添加
legacy_stdio_definitions.lib;
这句话,在忽略特定默认库中添加: LIBC.lib;LIBCMTD.lib 。其余配置如下图所示:
接下来转到链接器选项中的高级设置, 修改映像具有安全异常处理程序的值为:否 。
修改完成后,点击“本地Windows调试器”编译并运行工程。编译完成后会弹出来一个仿真界面。和嵌入式平台相比,因为液晶屏和CPU运行速度的影响,一般仿真效果会比较好。
仿真项目和emWin库有很多相似之处,目前唯一需要注意的是Application文件夹,我们编译的文件就在这个目录下面。除了这个例程外,其他的演示例程都在\Sample\Application路径下。
Sample 文件夹是 emWin 的基础应用示例程序包。我们使用仿真的一个重要目的就是学习这个文件夹下的工程代码。目前的 Sample 文件夹包含 3 个子文件夹: Application, Tutorial 和WinMain。除了Application外, Tutorial 文件夹内提供的都是一个个很小的工程,简化了学习的难度,而且这个文件夹下提供的应用示例更加丰富,基本上涵盖了 emWin 库提供的所有功能。而WinMain文件夹则是一些模拟器相关的文件,不需要理会他们。
运行官方例程
我们可以从简单点的 Sample 范例程序学习。 这需要配置一下工程的编译选项,以 Sample 目录下的 HelloWorld 示例进行讲解,对于学习其它 Sample 程序,其过程是一样的。
把 Application 中的文件从生成中排除。因为 emWin 文件包中每个例程都是是独立的工程。首先全选Application中文件,右键,属性。在“从生成中排除”一栏中填“是”。效果如下:
之后新建 Sample 文件夹。操作步骤如下:右键单击 SimulationTrial 项目,在弹出的选项中选择添加->新建筛选器,然后将新建的文件夹命名为 Sample。添加将要学习的 Sample 例程。 我们选择用emWin 库函数显示“HelloWorld”,这个程序是由 BASIC_HelloWorld.c 文件实现的,文件路径:SeggerEval_WIN32_MSVC_MinGW_GUI_V548\Sample\Tutorial。操作步骤如下:右键点击新建好的 Sample 文件夹->添加->现有项, 然后根据路径找到 BASIC_HelloWorld.c 文件,把该文件添加到工程中。添加完成后编译运行,效果如下:
![](https://img-blog.csdnimg.cn/direct/e9aa12e069f04029b829a437c119074a.png)
代码解析
作为最简单的例程,其代码也是极为的简单。
引用头文件之后,定义一下例程的内存空间。接下来执行MainTask()函数。首先进行初始化,然后判断剩余内存够不够执行程序,不够则打印提示语句并返回;反之则输出执行语句并通过while让程序维持当前状态。
#include "GUI.h"
// 例程占用的内存空间
#define RECOMMENDED_MEMORY (1024L * 5)
void MainTask(void) {
GUI_Init();
if (GUI_ALLOC_GetNumFreeBytes() < RECOMMENDED_MEMORY) {
GUI_ErrorOut("Not enough memory available.");
return;
}
GUI_DispString("Hello world!");
while(1);
}