Changeset 2102179 in rtems-graphics-toolkit


Ignore:
Timestamp:
Jan 8, 2010, 7:48:52 PM (11 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
master
Children:
a2cea51
Parents:
35c1f65
Message:

2010-01-08 Joel Sherrill <joel.sherrill@…>

  • README, TODO, do_it: Serious update.
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • ChangeLog

    r35c1f65 r2102179  
     12010-01-08      Joel Sherrill <joel.sherrill@oarcorp.com>
     2
     3        * README, TODO, do_it: Serious update.
     4
    152010-01-08      Joel Sherrill <joel.sherrill@oarcorp.com>
    26
  • README

    r35c1f65 r2102179  
    33#
    44
    5 This is the RTEMS Graphics Toolkit. 
     5This is the RTEMS Graphics Toolkit. It is a collection of free software
     6packages that are suitable for use in building graphical interfaces for
     7RTEMS-based embedded systems.
    68
    7 The packages jpeg-7 and tiff-3.9.2 appear to build correctly if
    8 configured like this:
     9You should have RTEMS installed and configured for your BSP.  The
     10RTEMS configuration should meet the following requirements:
    911
    10 CFLAGS="-mcpu=cypress" ./configure --host=sparc-rtems4.10 --prefix=/tmp/jpg
    11 make
    12 make install
     12+ TCP/IP enabled
     13  - not required at run-time but has endian swapping routines
     14+ POSIX enabled
    1315
    14 The CFLAGS and target should be automatically gathered from the
    15 install Makefile information.
     16Additionally, your BSP should have a framebuffer and pointing device
     17(e.g. mouse, touch screen, etc).  This is an area where RTEMS and
     18this kit needs improvement on configuration but the basics are in place.
    1619
    17 Both packages install programs in addition to the libraries we really
    18 want.  We need to disable those.
     20The ./do_it script has the following parameters:
    1921
    20 NOTE: The install point (--prefix) is set so that the contents are
    21       installed with the BSP and the CFLAGS are set for the BSP.
     22    do_one [options]
     23      -A - build and install all libraries
     24      -j - build JPEG support (default=no)
     25      -p - build PNG support (default=no)
     26      -t - build TIFF support (default=no)
     27      -1 - build Adobe Type 1 font support (default=no)
     28      -T - build Truetype font support (default=no)
     29      -c - clean after building (default=no)
     30      -v - verbose
    2231
    23 RTEMS_MAKEFILE_PATH=XXX \
    24   ./doit configure build install distclean
     32    NOTES:
     33      + Use of each option toggles the setting.  For example, \"-v -v -A -1\"
     34        results in verbose=no and all steps done except Type 1 fonts.
     35      + RTEMS_MAKEFILE_PATH must be set
     36      + By default, nothing is built.
    2537
    26 NOTE: Build procedure subject to change. :)
     38Below is an invocation for the pc386 BSP which should build all of the
     39supported libraries and install them for the pc386 BSP which is installed
     40into your ${HOME}.  RTEMS was configured with --prefix set to:
     41${HOME}/rtems-4.10-work/bsp-install/
    2742
     43RTEMS_MAKEFILE_PATH=${HOME}/rtems-4.10-work/bsp-install/i386-rtems4.10/pc386/ \
     44    ./do_it -A -v
     45
     46The CFLAGS and target information are automatically gathered from the
     47install Makefile information.  This is used to properly configure
     48and install the desired graphics support libraries.
     49
     50After installing this, you can proceed to building Microwin/Nano-X.  It
     51is expected that this will be integrated into a future revision of the
     52Graphics Toolkit.  We hope to add other libraries like SVGAlib and
     53FLTK in the future.  This is definitely an area in which users can
     54contribute.
     55
     56--joel
     57
     58Usage Notes:
     59
     60Adobe Type 1 Library
     61====================
     62+ This needs .t1librc and an override on the location of t1 fonts.
     63  Then we need to put some T1 fonts in the rootfs filesystem.
     64  This works now by setting the environment variable.  See rtems_init.c
     65  in the microwin source.
     66
  • TODO

    r35c1f65 r2102179  
    33#
    44
    5 + Disable building programs (e.g. only build libraries)
     5+ Add microwin
    66
    7 + Add font libraries
     7BSPs
     8====
     9+ We need a generic constant like "POINTING DRIVER".
    810
    9 + Add microwin
     11+ BSPs need to have a #define that indicates they have a pointing driver.
     12
     13Nano-X
     14======
     15+ Fix message "Error opening /dev/fb0: m" on BSPs (e.g. sis) which
     16  do not have framebuffer device
     17
     18+ check if we want to use "non-default" swap routines (include/swap.h)
     19
     20+ Clean up rtems_init.c when the BSPs make known their graphics/pointing
     21  capabilities.
     22
     23+ Remove hack in microwin/src/drivers/vgaplan4.h and make outb/outw
     24  more generic -- like weak symbols or something with default implementations
     25  on non-x86 architectures.
  • do_it

    r35c1f65 r2102179  
    4141{
    4242cat <<EOF
    43 do_one [options] CPU BSP
     43do_one [options]
    4444  -A - build and install all libraries
    4545  -j - build JPEG support (default=no)
     
    5454  + Use of each option toggles the setting.  For example, \"-v -v -A -1\"
    5555    results in verbose=no and all steps done except Type 1 fonts.
    56   + RTEMS_MAKEFILE_PATH must be set
     56  + RTEMS_MAKEFILE_PATH must be set.
     57  + By default, nothing is built.
    5758EOF
    5859}
Note: See TracChangeset for help on using the changeset viewer.