嵌入式linux_qtopia平台开发说明

    LINUX系统中QT(qtopia)平台开发说明
    =================================
        黄德智(compiler_hdz@hotmail.com)
            V：1.0
        日期：20060305

        QT 版本 ：20060106V2

一、开发包的获取
================

    最新的qtopia开发包名称为：qtopia_dev20060106V2.tar.gz；
当前版本为20060106V2，大小大约为 246M。

    当前和后续版本也可在 东信 的FTP网站上下载得到.

二、开发环境的搭建
==================

    qtopia开发包运行于LINUX操作系统上，LINUX要求内核版本为2.4.18或以上。安装LINUX操作系统，
如果只是在PC机上进行模拟器上的开发和交叉编译，可将LINUX安装到虚拟机上。将LINUX安装到虚拟机上，
建议硬盘空间最少分配6G，因为开发环境的搭建需要很大空间。

1、qtopia开发包的安装步骤：
    (1)、将qtopia_dev.tar.gz放到/opt/目录下
        建议放在/opt/目录下，如果需要将开发包放到其他的目录，则解压后需要修改
qtopia-phone-2.1.1/src/下的config.pri文件。
    (2)、用命令tar解压
        在LINUX终端中CD到/opt/目录下，输入命令 tar -zxf qtopia_dev.tar.gz (回车)，
几分钟后解压结束，出现命令提示符，如果报找不到什么目录或找不到什么文件，输入命令“df -m”
查看硬盘使用情况，一般原因是硬盘空间不足，解压失败，删除硬盘上不需要的文件或重新安装LINUX操作
系统，把分配硬盘空间更大。
    (3)、解压后生成的目录为qtopia_dev

2、交叉编译工具的安装步骤：

    (1)、将cross2compiler.tar.gz放到/opt/目录下
    (2)、用命令tar -zxf cross2compiler.tar.gz 解压
    (3)、解压后生成的目录为debugdir
    交叉编译工具的安装是为了编译出在真机上运行的可执行文件，如果只是在模拟器上开发，可不
进行交叉工具的安装。

三、模拟器上开发
================

1、配置文件和全局变量的设置：
    (1)、将.../qtopia_dev/.../x86/Settings目录放到/root/目录下，如果已经有/root/Settings目录，
则进行覆盖。
    (2)、进入qtopia_dev/.../.../x86/目录。（中间目录省略）
    (3)、运行 ./setenv 设置环境变量，或source setenv命令。

2、编译例子工程：
     在目录.../qtopia_dev/20060106V1102/x86/qtopia-phone-2.1.1/examples/application/下有一个名为
application的示例工程，对该工程进行编译和安装，可在模拟器中看到运行效果。
    编译步骤：
    (1)、进入qtopia_dev/.../.../x86/qtopia-phone-2.1.1/examples/application目录；
    (2)、运行qmake生成Makefile 文件；
    (3)、运行make install 进行编译和安装。

3、模拟器上查看运行效果：
    (1)、进入.../qtopia_dev/20060106V1102/x86/目录
    (2)、运行./rn.dat 启动模拟器

4、各个文件安装路径：
    (1)、所有编译后的程序放在
qtopia_dev/.../.../x86/qtopia-phone-2.1.1/image/opt/Qtopia/bin/目录下;
    (2)、程序相应的desktop文件放在
qtopia_dev/.../.../x86/qtopia-phone-2.1.1/image/opt/Qtopia/apps/Application/目录下
    (3)、所有的程序图标放在qtopia_dev/.../.../x86/pia-phone-2.1.1/image/opt/Qtopia/pics/程序名/目录下

5、示例工程中的各个文件

    (1)、application.pro文件
    该文件中指定工程中用到的各个文件，文件包括：源代码文件（.c .cpp .h）、资源文件名、目标文件名、
desktop文件及路径、图标文件及路径、帮助文件及路径。
    qmake命令在执行过程中访问application.pro文件将生成Makefile文件。
   
    (2)、example.desktop文件
    该文件将安装到模拟器和真机上，为了在运行时找到工程的各个文件。

    (3)、example.control文件
    文件中指定了工程的可执行文件路径、desktop文件路径、帮助文件路径和图标文件路径。
    这个文件我现在还没有搞清楚:)

    (4)、examplebase.ui文件
    该文件中以XML的格式定义了可视窗口上的各个部件。

    (5)、其它文件
    example.html和Example.png分别是工程的帮助文件和图标文件。

6、建立自己的工程

(1)、在示例工程的基础上建立自己的工程：
    新建一个自己工程的目录，将示例工程中的相关文件复制到该目录，在示例工程的基础上进行修改。
需要复制的文件有：main.cpp、application.pro、example.control、example.cpp、example.h、example.desktop、
examplebase.ui、Example.png、example.html。

(2)、修改事项：
    application.pro文件：
    A、“application.pro”文件以.pro为扩展名，文件名要和它所在的目录名相同；
    B、11行，写上所有工程中用到头文件，文件名之间用空格隔开；
    C、12行，写上所有工程中用到.c或.cpp文件，文件名之间用空格隔开；
    D、13行，可视窗口文件名；
    E、14行，生成可执行文件名（目标文件名）；
    F、18行，.desktop文件名；
    G、22行，图标文件名；
    H、23行，图标路径名，以目标文件名为目录名；
    I、26行，说明文件名；

    .desktop文件
    A、7行，可执行文件名；
    B、8行，图标文件名；

    .ui文件，该文件可用QT开发环境修改，也可用文本编辑器修改，
    A、第2行，<class>ExampleBase</class>，“ExampleBase”可修改，但一定要与example.h文件的25行父类名称一致；

    main.cpp文件
    A、该文件名不修改；
    B、21行，修改包含的头文件名；
    C、24行，修改类名；

(3)、编译自己的工程
    A、生成Makefile文件，在工程的目录下，运行qmake命令；
    B、编译，在工程的目录下，运行make命令；
    C、安装，在工程的目录下，运行make install命令；

四、为真机上运行进行编译
========================
    将代码用arm编译器进行编译，目标文件就可在真机上运行。
    1、必须进行交叉编译工具的安装；
    2、将工程目录复制到.../qtopia_dev/20060106V1102/arm/qtopia-phone-2.1.1/目录下；
    3、编译；

五、将文件安装到真机上
======================
1、设备间的软件连接：
连接步骤：
    (1)、连接好个连线
    (2)、启动PC到LINUX系统中
    (3)、关闭防火墙（service iptables stop）
    (4)、挂载进QT的开发包（mount /dev/hda4 /mnt/win）
    (5)、手动加载usbdnet.o（进入/mnt/win目录下，执行install），并在终端确认模块已经加载
    (6)、启动（重起）nfs（service nfs restart）
    (7)、启动minicom（#minicom）
    (8)、到/home/目录下，执行脚本pc_linux
    (9)、在终端启动USB设备（ifconfig usb0 192.168.254.1 up）
    (10)、在minicom窗口中执行/home/目录下的linuxrc_run脚本
    (11)、在minicom窗口中执行/home/目录下的脚本pc_linux
    (12)、检查目录/mnt/，是否和目录/opt/p2fs下的内容一致，若一致，则成功

这里提供几个诊断连接成功的方法：

pc启动候，通过lsmod|grep usbdnet看看模块是否存在，如果不存在，请手动通过./install加载

如果以上都正确，连接手机，如果ifconfig -a 能看到设备而ifconfig 看不到，请按照文档设置ip并激活。

2、文件安装目录：
    将编译好的程序、desktop文件和图标放在手机上/opt/Qtopia/各自对应的目录下。

    (1)、所有编译后的程序放在
qtopia_dev/.../arm/qtopia-phone-2.1.1/image/opt/Qtopia/bin/目录下

    (2)、程序相应的desktop文件放在
qtopia_dev/.../arm/qtopia-phone-2.1.1/image/opt/Qtopia/apps/Application/目录下

    (3)、所有的程序图标放在
qtopia_dev/.../arm/qtopia-phone-2.1.1/image/opt/Qtopia/pics/程序名/ 目录下

3、重起手机。

六、手机目录：
    /            (根目录)
    |----bin
    |----lib
    |----home
    |----mnt        (对应于PC机的/opt/p2fs目录，该目录结构可随意)
    |
    |----opt
    |    |----Qtopia
    |        |----bin    (放编译后的程序)
    |        |----etc   
    |        |----pics    (放图标文件)
    |        |----apps   
    |                |--Applications    (放desktop文件)
    |               
    |----Applications    (该目录结构任意，可存放工程自己的文件)

结束
====