readme.zh

这是ARM嵌入式系统的实验教程中的MINIGUI的实验源代码！

        2) 改变到新目录, 然后运行 "./configure":

           $ ./configure

        3) 运行下面的命令编译并安装 MiniGUI:

           $ make; su -c 'make install';

        4) 默认情况下, MiniGUI 的函数库将安装在 `/usr/local/lib' 目录中. 
           您应该确保该目录已经列在 "/etc/ld.so.conf" 文件中. 并且在安装之后,
           要运行下面的命令更新共享函数库系统的缓存:

            $ su -c ldconfig

        5) 如果要控制您的 MiniGUI 提供那些功能, 则可以运行:

           $ ./configure --help

           查看完整的配置选项清单, 然后通过命令行开关打开或者关闭某些功能. 例如, 
           如果您不希望 MiniGUI 使用 LoadBitmap 函数装载 JPEG 图片, 则可以使用:

           $ ./configure --disable-jpgsupport

        6) 注意, 某些 MiniGUI 特色依赖于其它函数库, 请确保已安装了这些函数库.


  4.4 运行 MiniGUI 的演示程序

    "mde-1.3.x.tar.gz" 中包含了 MiniGUI 的综合演示程序. 

    运行之前, 应该解开并编译 mde-1.3.x.tar.gz 包:

        1) 使用 "tar" 命令将软件包解开到新的目录.

        2) 依次运行 "./configure" 和 "make" 编译演示程序.

        4) 如果配置并安装了 MiniGUI-Lite, 则应该首先运行服务器, 然后从服务器当中
           运行其它演示程序.  编译 MDE 将生成一个 "mginit" 程序, 该程序将提供一个
           运行于 MiniGUI-Lite 的虚拟控制台:

           $ cd mginit
           $ ./mginit

        5) 如果将 MiniGUI 配置为 MiniGUI-Threads, 则可以直接进入某个
          演示程序目录直接运行其中的程序, 比如:

           $ cd same
           $ ./same


5. Linux 上的安装及配置示例

   本示例假定用户使用的系统是 RedHat Linux 6.x 或以上发行版, 使用 Linux 内核
   2.2.xx 或者 2.4.xx, 用户的目标是运行 MiniGUI-Threads (使用 MiniGUI 
   Version 1.3.x). 步骤如下:

   1) 确保您的 PC 机显示卡是 VESA 兼容的. 大多数显示卡是 VESA 兼容的, 然而某些
      内嵌在主板上的显示卡可能不是 VESA 兼容的, 比如 Intel i810 系列. 如果显示
      卡是 VESA 兼容的, 就可以使用 Linux 内核中的 VESA FrameBuffer 驱动程序了.

   2) 确保您的 Linux 内核包含了 FrameBuffer 支持, 并包含了 VESA FrameBuffer 
      驱动程序. RedHat Linux 6.x 发行版自带的内核中已经包含了该驱动程序. 如果
      使用自己编译的内核, 请检查您的内核配置.

   3) 修改 /etc/lilo.conf 文件, 在您所使用的内核选项段中, 添加如下一行:

                vga=0x0317

      这样, Linux 内核在启动时将把显示模式设置为 1024x768x16bpp 模式. 如果您的
      显示器无法达到这种显示分辨率, 可考虑设置 vga=0x0314, 对应 800x600x16bpp 
      模式.
      
      修改后的 /etc/lilo.conf 文件类似:

                boot=/dev/hda
                map=/boot/map
                install=/boot/boot.b
                prompt
                timeout=50
                linear
                default=linux

                image=/boot/vmlinuz-2.4.2
                    vga=0x0317          ; 这一行设置显示模式.
                    label=linux
                    read-only
                    root=/dev/hda6

                other=/dev/hda1
                    label=dos

    4) 运行 lilo 命令, 使所作的修改生效, 并重新启动系统.

    5) 如果一切正常, 将在 Linux 内核的引导过程中看到屏幕左上角出现可爱的 Linux
       吉祥物 -- 企鹅, 并发现系统的显示模式发生变化.

    6) 按照第 4 节所讲, 下载 libminigui-1.3.x.tar.gz, minigui-res-1.0.02.tar.gz, 
       以及 mde-1.3.x.tar.gz 等软件包, 注意要安装正确的版本.

    7) 以 root 用户身份安装 minigui-res-1.3.x.tar.gz.

    8) 在某个目录下解开 libminigui-1.3.x.tar.gz, 并进入新建的 
       libminigui-1.3.x 目录.

       $ tar zxf libminigui-1.3.x.tar.gz
       $ cd libminigui-1.3.x

    9) 依次运行如下命令:

       $ ./configure
       $ make

    10) 以 root 身份运行 make install 命令:

       $ su -
       # make install

    11) 修改 /etc/ld.so.conf 文件, 将 /usr/local/lib 目录添加到该文件最后一行. 
        修改后类似:

                /usr/lib
                /usr/X11R6/lib
                /usr/i486-linux-libc5/lib
                /usr/local/lib

    12) 以 root 身份执行 ldconfig 命令:

       # ldconfig

    13) 在新目录中解开 mde-1.3.x.tar.gz, 并进入新建目录:

       $ tar zxf mde-1.3.x.tar.gz
       $ cd mde-1.3.x
       
    14) 依次运行如下命令:

       $ ./configure
       $ make

    15) 进入 same 目录, 并执行 same 程序:

       $ cd same
       $ ./same

    16) 如果一切正常, 这时可以看到一个虚拟控制台出现在屏幕上. 

    17) 如何关闭这个窗口, 不需要在这里赘述了吧. :)


6. 开发历史

    见 README.


7. 有关作者

    见 README.


9. 如果遇到问题

    我们已经在 lists.minigui.net 上建立了有关 MiniGUI 开发和编程的三个
    邮件列表。如果 你在使用 MiniGUI 的过程中遇到任何问题，或者有任何建议或
    评论，可以向这些邮件列表发送邮件。这样你将得到更多人的帮助。需要注意的是，
    只有订阅了邮件列表，才能向邮件列表发送消息。


    * minigui-devel: MiniGUI 应用软件开发人员的邮件列表
      访问如下 Web 页订阅:

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-devel

    * minigui-users: MiniGUI 用户的邮件列表
      访问如下 Web 页订阅:

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-users

    * minigui-ecos: eCos + MiniGUI 用户的邮件列表
      访问如下 Web 页订阅:

            http://lists.minigui.net/cgi-bin/mailman/listinfo/minigui-ecos

9. 版权信息

    Copyright (C) 2002~2004, Beijing Feynman Software Technology Co., Ltd.
    Copyright (C) 1998~2002, Wei Yongming
    Portion copyright (C) 2000~2001, Zheng Xiang and others.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


10. 在商业或专有系统中的使用 MiniGUI

    The edition you downloaded freely from our site may only be used to 
    develop GPL (non-proprietary) Software. The COPYING file explains 
    what you may or may not do with the free edition.

    If you are using MiniGUI for developing commercial, proprietary, or other
    software not covered by the terms listed in the COPYING file, you
    must have a commercial license for MiniGUI. Please see
    http://www.minigui.com/product/index.html for how to obtain this. 

    If you are interested in the commercial MiniGUI licensing, please write
    to [e-mail].  Other mail can be sent to [e-mail].