app module of simulator:update readme.txt, add rtthread.def for default buiding with msvc

This commit is contained in:
prife 2013-02-28 00:39:37 +08:00
parent 188dfea3a7
commit 8bff1f8397
2 changed files with 1551 additions and 110 deletions

View File

@ -1,23 +1,35 @@
说明: 本BSP可以如下演示
默认演示realtouch GUI效果并提供了一个贪吃的demo用于演示
目前支持的功能有
1). LWIP可以打开LWIP选项不过尚存在bug不建议使用
2). 文件系统支持支持ELM FatFSUFFSJFFS2
3). RTGUI支持
目前SVN中的RTGUI源码可以直接用于simulator。
如果读者想快速在simulator上体验RTGUI那么不需要修改任何文件首先在命令行中使用
scons --target=vs -s
生成工程后打开project.vsproj编译即可看到realtouch的ui出现然后执行
在finsh中执行snake_main()即可运行贪吃蛇demo
一 平台及组件支持
目前rtconfig.py中支持的编译器有
1). msvc 用于windows平台
此平台支持的组件
kernel
finsh
LWIP
DFS, ELM FatFS, UFFS, JFFS2, DFS_WIN32
RTGUI
APP MODULE
2). mingw 用于windows平台
kernel
finsh
DFS, ELM FatFS, UFFS, DFS_WIN32
RTGUI
APP MODULE
3). gcc 用于linux平台
kernel
finsh
DFS, ELM FatFS, UFFS
RTGUI
再补充说明一点RTGUI的最新源码目前是托管在git上。
github网页https://github.com/RT-Thread/RTGUI
如果要使用rtgui中的最新源码共有两种方法。
二 组件配置
1) RTGUI
当前代码中已经不含RTGUI源码因此读者需要配置一下才能在simulator中使用RTGUI
RTGUI的最新源码目前是托管在github上https://github.com/RT-Thread/RTGUI
共有两种方法。
方法1 添加环境变量
向系统环境变量中加入RTT_RTGUI其值为刚才github上下载的rtgui源码包的路径。
例如笔者的rtgui源码包解压至 F:\Project\git\rt-gui\下
则将此环境变量配置为 F:\Project\git\rt-gui\components\rtgui
向系统加入RTT_RTGUI环境变量其值为刚才github上下载的rtgui源码包的路径。
例如笔者的rtgui源码包解压至 F:\Project\git\rt-gui\下, 则将此环境变量配置为 F:\Project\git\rt-gui\components\rtgui
方法2 不添加环境变量
打开SConstruct文件
....
@ -37,106 +49,105 @@
1)#号表示注释类似于c语言中的//
2)其中15行的路径为你的RTGUI路径源码注意不是压缩包路径而是压缩包路径下的 components\rtgui目录的绝对路径。
1 编译:
1.1 使用Visual Studio(2005以上版本
在命令行中执行 scons --target=vs -s 可以生成vs2005的工程名为project.vsproj
三 编译
1) 使用Visual Studio(2005以上版本)
在当前目录中打开cmd输入命令
`scons --target=vs -s`
可以生成project.vsproj双击运行
编译后运行
2) 命令行编译
修改rtconfig.py, 配置合适的编译器(msvc/mingw/gcc),及其路径
在当前目录中打开cmd输入命令
`scons -j4`
编译完成后会在当前目录下生成 rtthrad-win32.exe双击即可运行。
1.2 使用scons编译在当前目录中打开cmd输入
scons -j4
编译完成后会在当前目录下生成 rtthrad-win32.exe双击即可运行。
2. 测试文件系统
运行:
编译后运行会弹出CMD命令行窗口可以看到控制台的输出信息如下所示
\ | /
- RT - Thread Operating System
/ | \ 1.1.0 build Oct 21 2012
2006 - 2012 Copyright by rt-thread team
init jffs2 lock mutex okay
hello, world
finsh>>fatfs initialzation failed!
uffs initialzation failed!
jffs2 initialzation failed!
thread 29e4 exit
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
thread 2898 exit
注意上面的信息显示fatfs/uffs/jffs2均挂载失败这是因为我们还没有为sd.bin创建fat分区并且sd上也没有目录用于挂载jffs2和uffs。
并且此时当前bsp目录下新增了三个文件用于模拟sd卡nand flash与nor flash它们是
四 程序测试
1) 测试文件系统
此时当前目录下,新增了三个文件
sd.bin--模拟SD卡挂载fat大小为16M
nand.bin-模拟nand flash挂载uffs参数page=2048+64bytesblock=64pages16M
nor.bin--模拟nor flash挂载jffs2型号为sst25vf2M
按下回车出现finsh然后输入如下命令格式化sd.bin
第一次启动时会看到fatfs挂在失败。
按下回车出现finsh然后输入`mkfs("elm", "sd0")`格式化SD卡如下所示
finsh>>mkfs("elm", "sd0")
0, 0x00000000
finsh>>
然后重启程序就可以看到fatfs挂载成功了
关闭程序重新运行此时可以看到fatfs挂载成功不过jffs2和uffs依然失败如下所示。
\ | /
- RT - Thread Operating System
/ | \ 1.1.0 build Oct 21 2012
2006 - 2012 Copyright by rt-thread team
init jffs2 lock mutex okay
hello, world
finsh>>fatfs initialized!
uffs initialzation failed!
jffs2 initialzation failed!
2) 测试RTGUI
启动后就会看到GUI窗口分辨率800x480此时在finsh中输入snake_main()并回车,即可运行贪吃蛇程序
这是因为sd上还没有目录来用于挂载jffs2和uffs在finsh中输入如下命令在sd上创建nand与nor文件夹分别用于挂载uffs与jffs2文件系统。
3) 测试APP module
rtconfig.h中需要打开RT_USING_MODULE
finsh>>mkdir("/nand")
0, 0x00000000
finsh>>mkdir("/nor")
0, 0x00000000
finsh>>
然后再次关闭程序后重新运行此时可以看到jffs2与uffs挂载成功。
a. 生成rtthread.def文件
使用msv编译主程序时需要此文件使用MingW编译主程序时不需要
msvc需要此文件才能生成正确导出符号的rtthread.dll和rtthread-win32.exe。
此目录下默认自带了一个rtthread.def文件当修改了rtconfig.h禁用了某些组件时则需要重新生成rtthread.def文件.
生成方法:
需要借助MingW工具修改rtconfig.py中CROSS_TOOL为'mingw'然后打开CMD执行`scons --def`就会自动更新rtthread.def。
最终输出如下所示:
b. 生成主程序
主程序可以使用msvc和mingw生成
如果rtconfig.h中的使能了RTGUI则需要参考第二节第1小节配置RTGUI
a.1 使用msvc
修改rtconfig.py中CROSS_TOOL为'msvc'
首先要保证当前目录下有合适的rtthread.def文件如果没有对默认的rtconfig.h作修改则使用默认的rtthread.def即可
CMD命令行执行`scons -j4`即可生成rtthread.dll和 rtthread-win32.exe
a.2 使用mingw
修改rtconfig.py中CROSS_TOOL为'mingw'
CMD命令行执行`scons -j4`,这就会生成 rtthread.dll和 rtthread-win32.exe
\ | /
- RT - Thread Operating System
/ | \ 1.1.0 build Oct 21 2012
2006 - 2012 Copyright by rt-thread team
init jffs2 lock mutex okay
hello, world
finsh>>fatfs initialized!
os : system memory alloc 320 bytes
flsh: ECC size 24
flsh: UFFS consume spare data size 34
os : system memory alloc 83520 bytes
os : system memory alloc 52400 bytes
os : system memory alloc 2048 bytes
tree: DIR 0, FILE 0, DATA 0
uffs initialized!
jffs2 initialized!
thread 2fb4 exit
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
hello, world
thread 312c exit
c. 生成app module
进入testdll目录再次修改 testdll/SConstruct 同样需要配置RTT_RTGUI路径同 1中3)
在此目录下执行
`scons --app=basicapp`
就会在 basicapp/building目录下生成 basicapp.dll。
Ok到现在一个完整的文件系统测试环境就搭建完毕了enjoy
然后运行simulator目录下的 rtthread-win32.exe, 在finsh中运行
`exec("/testdll/basicapp/building/basicapp.dll")`
如果觉得这个路径太长,就把 basicapp.dll复制到 simualtor目录下执行
`exec("/basicapp.dll")`
3 测试RTGUI
启动后就会看到GUI窗口分辨率800×480串口并出现图形界面。
此时在finsh中输入 snake_main()并回车,即可运行贪吃蛇程序。
如果想编译RTGUI应用如testdll目录下的snake则需要对RTGUI打一点补丁共有两个方法
1. 注释掉 //#define RTGUI_USING_CAST_CHECK`
找到rtgui_config.h源码注释掉如下语句
//#define RTGUI_USING_CAST_CHECK`
然后在testdll目录下打开CMD窗口执行`scons --app=snake`,才可以正确编译,如果不注释掉上面的宏,则会出现链接错误。
2. 不注释掉#define RTGUI_USING_CAST_CHECK`
那么需要如下两个补丁
1) 修改testdll/SConstruct文件
diff --git a/bsp/simulator/testdll/SConstruct b/bsp/simulator/testdll/SConstruct
index 3324f88..005289c 100644
--- a/bsp/simulator/testdll/SConstruct
+++ b/bsp/simulator/testdll/SConstruct
@@ -70,6 +70,7 @@ env.Append(CCFLAGS=rtconfig.CFLAGS)
env.Append(LINKFLAGS=rtconfig.LFLAGS)
env.Append(CPPPATH=CPPPATH)
env.Append(LIBS='rtthread', LIBPATH='../')
+env.Append(CPPDEFINES=['RTT_IN_MODULE'])
env.PrependENVPath('PATH', rtconfig.EXEC_PATH)
PrepareModuleBuilding(env, RTT_ROOT)
2) 修改RTGUI源码
diff --git a/components/rtgui/include/rtgui/rtgui_object.h b/components/rtgui/include/rtgui/rtgui_object.h
index 57fd47f..b32ee17 100644
--- a/components/rtgui/include/rtgui/rtgui_object.h
+++ b/components/rtgui/include/rtgui/rtgui_object.h
@@ -56,7 +56,12 @@ extern "C" {
typedef struct rtgui_type rtgui_type_t;
#define RTGUI_TYPE(type) (struct rtgui_type*)&(_rtgui_##type)
+#ifdef RTT_IN_MODULE
+#define DECLARE_CLASS_TYPE(type) _declspec(dllimport) const struct rtgui_type _rtgui_##type
+#else
#define DECLARE_CLASS_TYPE(type) extern const struct rtgui_type _rtgui_##type
+#endif
+
#define DEFINE_CLASS_TYPE(type, name, parent, constructor, destructor, size) \
const struct rtgui_type _rtgui_##type = { \
name, \
然后再编译snake可以正确生成。测试方法同basicapp

1430
bsp/simulator/rtthread.def Normal file

File diff suppressed because it is too large Load Diff