Merge pull request #40 from prife/sim-module
app module of simulator:update readme.txt, add rtthread.def for default ...
This commit is contained in:
Bernard Xiong
commit
0df78e4598
|
|
@ -1,23 +1,35 @@
|
|||
说明: 本BSP可以如下演示
|
||||
默认演示realtouch GUI效果，并提供了一个贪吃的demo用于演示
|
||||
|
||||
目前支持的功能有
|
||||
1). LWIP（可以打开LWIP选项，不过尚存在bug，不建议使用）
|
||||
2). 文件系统支持，支持ELM FatFS，UFFS，JFFS2
|
||||
3). RTGUI支持
|
||||
目前SVN中的RTGUI源码可以直接用于simulator。
|
||||
如果读者想快速在simulator上体验RTGUI，那么不需要修改任何文件，首先在命令行中使用
|
||||
scons --target=vs -s
|
||||
生成工程后，打开project.vsproj编译，即可看到realtouch的ui出现，然后执行
|
||||
在finsh中执行snake_main()，即可运行贪吃蛇demo
|
||||
|
||||
再补充说明一点，RTGUI的最新源码目前是托管在git上。
|
||||
github网页：https://github.com/RT-Thread/RTGUI
|
||||
如果要使用rtgui中的最新源码，共有两种方法。
|
||||
一 平台及组件支持
|
||||
目前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
|
||||
|
||||
二 组件配置
|
||||
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.2 使用scons编译，在当前目录中打开cmd，输入
|
||||
scons -j4
|
||||
编译完成后会在当前目录下生成 rtthrad-win32.exe，双击即可运行。
|
||||
三 编译
|
||||
1) 使用Visual Studio(2005以上版本)
|
||||
在当前目录中打开cmd，输入命令
|
||||
`scons --target=vs -s`
|
||||
可以生成project.vsproj，双击运行
|
||||
|
||||
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，它们是
|
||||
sd.bin--模拟SD卡，挂载fat，大小为16M
|
||||
nand.bin-模拟nand flash，挂载uffs，参数page=2048+64bytes，block=64pages，16M
|
||||
nor.bin--模拟nor flash，挂载jffs2，型号为sst25vf，2M
|
||||
|
||||
按下回车，出现finsh，然后输入如下命令格式化sd.bin
|
||||
2) 命令行编译
|
||||
修改rtconfig.py, 配置合适的编译器(msvc/mingw/gcc)，及其路径
|
||||
在当前目录中打开cmd，输入命令
|
||||
`scons -j4`
|
||||
编译完成后会在当前目录下生成 rtthrad-win32.exe，双击即可运行。
|
||||
|
||||
四 程序测试
|
||||
1) 测试文件系统
|
||||
此时当前目录下，新增了三个文件
|
||||
sd.bin--模拟SD卡，挂载fat，大小为16M
|
||||
nand.bin-模拟nand flash，挂载uffs，参数page=2048+64bytes，block=64pages，16M
|
||||
nor.bin--模拟nor flash，挂载jffs2，型号为sst25vf，2M
|
||||
第一次启动时，会看到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!
|
||||
|
||||
这是因为sd上还没有目录来用于挂载jffs2和uffs，在finsh中输入如下命令在sd上创建nand与nor文件夹，分别用于挂载uffs与jffs2文件系统。
|
||||
2) 测试RTGUI
|
||||
启动后就会看到GUI窗口，分辨率800x480，此时在finsh中输入snake_main()并回车，即可运行贪吃蛇程序
|
||||
|
||||
finsh>>mkdir("/nand")
|
||||
0, 0x00000000
|
||||
finsh>>mkdir("/nor")
|
||||
0, 0x00000000
|
||||
finsh>>
|
||||
然后再次关闭程序后重新运行，此时可以看到jffs2与uffs挂载成功。
|
||||
3) 测试APP module
|
||||
rtconfig.h中需要打开RT_USING_MODULE
|
||||
|
||||
最终输出如下所示：
|
||||
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。
|
||||
|
||||
\ | /
|
||||
- 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
|
||||
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
|
||||
|
||||
Ok，到现在，一个完整的文件系统测试环境就搭建完毕了，enjoy～～
|
||||
c. 生成app module
|
||||
进入testdll目录，再次修改 testdll/SConstruct， 同样需要配置RTT_RTGUI路径，同 1中3)
|
||||
在此目录下执行
|
||||
`scons --app=basicapp`
|
||||
就会在 basicapp/building目录下生成 basicapp.dll。
|
||||
|
||||
3 测试RTGUI
|
||||
启动后就会看到GUI窗口，分辨率800×480串口，并出现图形界面。
|
||||
此时在finsh中输入 snake_main()并回车，即可运行贪吃蛇程序。
|
||||
然后运行simulator目录下的 rtthread-win32.exe, 在finsh中运行
|
||||
`exec("/testdll/basicapp/building/basicapp.dll")`
|
||||
如果觉得这个路径太长，就把 basicapp.dll复制到 simualtor目录下，执行
|
||||
`exec("/basicapp.dll")`
|
||||
|
||||
如果想编译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
|
||||
|
|
|
|||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue