Subversion Repositories openrisc

# ====================================================================

#

#      framebuf.cdl

#

#      Generic framebuffer package configuration data

#

# ====================================================================

# ####ECOSGPLCOPYRIGHTBEGIN####

# -------------------------------------------

# This file is part of eCos, the Embedded Configurable Operating System.

# Copyright (C) 2008, 2009 Free Software Foundation, Inc.

#

# eCos 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 or (at your option) any later

# version.

#

# eCos 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 eCos; if not, write to the Free Software Foundation, Inc.,

# 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

#

# As a special exception, if other files instantiate templates or use

# macros or inline functions from this file, or you compile this file

# and link it with other works to produce a work based on this file,

# this file does not by itself cause the resulting work to be covered by

# the GNU General Public License. However the source code for this file

# must still be made available in accordance with section (3) of the GNU

# General Public License v2.

#

# This exception does not invalidate any other reasons why a work based

# on this file might be covered by the GNU General Public License.

# -------------------------------------------

# ####ECOSGPLCOPYRIGHTEND####

# ====================================================================

######DESCRIPTIONBEGIN####

#

# Author(s):     bartv

# Date:          2005-03-29

#

#####DESCRIPTIONEND####

#========================================================================

cdl_package CYGPKG_IO_FRAMEBUF {

    display             "Framebuffer support"

    doc         ref/io-framebuf.html

    requires    CYGPKG_INFRA CYGPKG_HAL CYGPKG_ERROR

    include_dir cyg/io

    compile             framebuf.c linear.c palette.c

    # A custom build step to generate a single header with details of all

    # the framebuffers for this target. The dependency on 

    # copes with the case of a framebuffer device driver package being removed

    make -priority 2 {

        $(PREFIX)/include/cyg/io/framebufs/framebufs.h : $(REPOSITORY)/$(PACKAGE)/src/gen_framebufs.tcl \

            $(PREFIX)/include/pkgconf/system.h \

            $(subst $(PREFIX)/include/cyg/io/framebufs/framebufs.h,,$(wildcard $(PREFIX)/include/cyg/io/framebufs/*.h*))

        tclsh $< $(dir $@)

    }

    description "

        The generic framebuffer package provides an API for accessing

        one or more framebuffers, plus support for appropriate device

        drivers."

    cdl_interface CYGINT_IO_FRAMEBUF_DEVICES {

        display         "Number of available framebuffer devices"

        flavor          data

        description "

            This interface specifies the number of framebuffer devices

            supported by device driver(s) on this platform."

    }

    cdl_option CYGDAT_IO_FRAMEBUF_DEVICES {

        display         "Names of available framebuffer devices"

        default_value   { "" }

        flavor          data

        description "

            This option provides a list of the framebuffer devices available

            on the current platform. It is controlled by the appropriate

            device driver(s) and should not be edited by users."

    }

    cdl_option CYGDAT_IO_FRAMEBUF_TEST_DEVICE {

        display         "Framebuffer device to use for testing"

        active_if       CYGINT_IO_FRAMEBUF_DEVICES

        flavor          booldata

        default_value   0

        requires        { is_substr(CYGDAT_IO_FRAMEBUF_DEVICES, " " . CYGDAT_IO_FRAMEBUF_TEST_DEVICE . " ") }

        description "

            This option determines the framebuffer device to be used for running

          the testcases. By default the build system will automatically select

          the first entry in CYGDAT_IO_FRAMEBUF_DEVICES, which will be the

          only entry if there is only framebuffer device in the system."

    }

    cdl_component CYGPKG_IO_FRAMEBUF_FUNCTIONALITY {

        display         "Functionality supported by the platform's framebuffer(s)"

        flavor          none

        description "

            This component holds details of the functionality provided by the

            framebuffer device driver(s) for the current platform."

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_32BPP {

            display     "32bpp pixel support required"

            flavor      booldata

            description "

                This interface will be implemented if any of the framebuffer

                device drivers for the current platform provides a 32 bits

                per pixel display. This constrains the cyg_colour data type

                to be at least 32 bits."

        }

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_TRUE_COLOUR {

            display     "Framebuffer supports true colour mode"

            flavor      booldata

            define      CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_TRUE_COLOR

            description "

                This interface will be implemented if any of the framebuffer

                device drivers for the current platform support true colour

                operation. In other words the contents of the framebuffer

                defines the colours directly and there is no indirection via

                a palette."

        }

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_PALETTE {

            display     "Framebuffer uses a palette for colours"

            flavor      booldata

            description "

                This interface will be implemented if any of the framebuffer

                device drivers for the current platform use a palette. In

                other words the contents of the framebuffer's memory do not

                represent colours directly, but instead are treated as indices

                into a separate table known as the palette."

        }

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_WRITEABLE_PALETTE {

            display     "Framebuffer uses a writeable palette for colours"

            flavor      booldata

            description "

                This interface will be implemented if any of the framebuffer

                device drivers for the current platform use a palette, and this

                palette can be modified at run-time. In other words the contents

                of the framebuffer's memory do not represent colours directly,

                but instead are treated as indices into a separate table known

                as the palette."

        }

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_VIEWPORT {

            display     "Framebuffer provides viewport support"

            flavor      booldata

            description "

              This interface will be implemented if any of the framebuffer

              device drivers for the current platform provide viewport support.

              In other words only a subset of the framebuffer, the viewport,

              is actually visible on the display and application code can move

              this viewport."

        }

        cdl_interface CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_DOUBLE_BUFFER {

            display     "Framebuffer provides double buffering support"

            flavor      booldata

            description "

              This interface will be implemented if any of the framebuffer

              device drivers for the current platform provide support for

              double buffering. In other words the framebuffer memory that

              is updated by graphics operations is not what actually gets

              displayed. Instead there is a separate hidden area of memory

              used for the display, and when drawing is complete a flush

              operation is needed to move the framebuffer contents to that

              hidden area. This makes it possible to update the display more

              smoothly, at the cost of potentially expensive memory copy

              operations."

        }

    }

    cdl_option CYGFUN_IO_FRAMEBUF_INSTALL_DEFAULT_PALETTE {

        display         "Framebuffers should install a default palette"

        flavor          bool

        default_value   1

        active_if       CYGHWR_IO_FRAMEBUF_FUNCTIONALITY_WRITEABLE_PALETTE

        description "

          Framebuffer devices which involve a writeable palette may set this

          to a default palette when activated by cyg_fb_on() or equivalent

          functionality. This is useful when the application will access the

          framebuffer directly. It is less useful if a higher-level graphics

          library is in use because typically that will install its own

          palette, and typically there is a code/data overhead of approximately 1K."

    }

    cdl_component CYGPKG_IO_FRAMEBUF_OPTIONS {

        display "Framebuffer build options"

        flavor  none

        description   "

            Package specific build options including control over

            compiler flags used only in building the generic frame

            buffer package, and details of which tests are built."

        cdl_option CYGPKG_IO_FRAMEBUF_CFLAGS_ADD {

            display "Additional compiler flags"

            flavor  data

            no_define

            default_value { "" }

            description   "

                This option modifies the set of compiler flags for

                building the generic framebuffer package. These flags

                are used in addition to the set of global flags."

        }

        cdl_option CYGPKG_IO_FRAMEBUF_CFLAGS_REMOVE {

            display "Suppressed compiler flags"

            flavor  data

            no_define

            default_value { "" }

            description   "

                This option modifies the set of compiler flags for

                building the generic framebuffer package. These flags

                are removed from the set of global flags if present."

        }

        cdl_option CYGPKG_IO_FRAMEBUF_TESTS {

            display         "Framebuffer tests"

            active_if   CYGINT_IO_FRAMEBUF_DEVICES

            flavor          booldata

            calculated  { "tests/fb tests/fbmacro" }

            description "

                This option specifies the set of tests for the framebuffer package"

        }

    }

}