packages/kernel/v2_0/cdl/interrupts.cdl

   1 # ====================================================================
   2 #
   3 #      interrupts.cdl
   4 #
   5 #      configuration data related to kernel interrupt handling
   6 #
   7 # ====================================================================
   8 #####ECOSGPLCOPYRIGHTBEGIN####
   9 ## -------------------------------------------
  10 ## This file is part of eCos, the Embedded Configurable Operating System.
  11 ## Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  12 ##
  13 ## eCos is free software; you can redistribute it and/or modify it under
  14 ## the terms of the GNU General Public License as published by the Free
  15 ## Software Foundation; either version 2 or (at your option) any later version.
  16 ##
  17 ## eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  18 ## WARRANTY; without even the implied warranty of MERCHANTABILITY or
  19 ## FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  20 ## for more details.
  21 ##
  22 ## You should have received a copy of the GNU General Public License along
  23 ## with eCos; if not, write to the Free Software Foundation, Inc.,
  24 ## 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  25 ##
  26 ## As a special exception, if other files instantiate templates or use macros
  27 ## or inline functions from this file, or you compile this file and link it
  28 ## with other works to produce a work based on this file, this file does not
  29 ## by itself cause the resulting work to be covered by the GNU General Public
  30 ## License. However the source code for this file must still be made available
  31 ## in accordance with section (3) of the GNU General Public License.
  32 ##
  33 ## This exception does not invalidate any other reasons why a work based on
  34 ## this file might be covered by the GNU General Public License.
  35 ##
  36 ## Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  37 ## at http://sources.redhat.com/ecos/ecos-license/
  38 ## -------------------------------------------
  39 #####ECOSGPLCOPYRIGHTEND####
  40 # ====================================================================
  41 ######DESCRIPTIONBEGIN####
  42 #
  43 # Author(s):      bartv
  44 # Original data:  nickg
  45 # Contributors:
  46 # Date:           1999-06-13
  47 #
  48 #####DESCRIPTIONEND####
  49 #
  50 # ====================================================================
  51
  52 # NOTE: the choice of list vs table should not be two separate
  53 # options. There is a single option which must have one of
  54 # two legal values.
  55 cdl_component CYGIMP_KERNEL_INTERRUPTS_DSRS {
  56     display       "Use delayed service routines (DSRs)"
  57     default_value 1
  58     description   "
  59         In eCos the recommended way to handle device interrupts is to
  60         do a minimum amount of work inside the low level interrupt
  61         handler itself, and instead do as much as possible in a
  62         Delayed Service Routine or DSR. If an application does not
  63         make use of DSRs directly or indirectly then it is possible
  64         to disable the DSR support completely, which reduces the
  65         overheads of context switches and interrupt handling. Note
  66         that the kernel real-time clock makes use of DSRs, as do many
  67         of the device drivers. "
  68
  69     cdl_interface CYGINT_KERNEL_INTERRUPTS_DSRS {
  70         requires 1 == CYGINT_KERNEL_INTERRUPTS_DSRS
  71         no_define
  72     }
  73
  74     # NOTE: the choice of list vs table should not be two separate
  75     # options. There is a single option which must have one of
  76     # two legal values.
  77     cdl_component CYGIMP_KERNEL_INTERRUPTS_DSRS_LIST {
  78         display       "Use linked lists for DSRs"
  79         default_value 1
  80         implements    CYGINT_KERNEL_INTERRUPTS_DSRS
  81         description   "
  82             When DSR support is enabled the kernel must keep track of all
  83             the DSRs that are pending. This information can be kept in a
  84             fixed-size table or in a linked list. The list implementation
  85             requires that the kernel disable interrupts for a very short
  86             period of time outside interrupt handlers, but there is no
  87             possibility of a table overflow occurring."
  88
  89         cdl_option CYGSEM_KERNEL_INTERRUPTS_DSRS_LIST_FIFO {
  90             display       "Schedule DSRs in FIFO order"
  91             flavor        bool
  92             default_value 1
  93             description   "When this option is set, DSRs are scheduled
  94                 in the natural FIFO (first in, first out) order,
  95                 otherwise they are scheduled in LIFO (last in, first
  96                 out) order. Applications should not rely on any
  97                 particular order of scheduling of DSRs. LIFO
  98                 scheduling is kept for backward compatibility only and
  99                 is not recommended as it may lead to high (up to 2
 100                 times higher then FIFO) IRQ-to-DSR latencies at some
 101                 (typically rare) conditions. If unsure, leave this set."
 102         }
 103
 104     }
 105
 106     cdl_component CYGIMP_KERNEL_INTERRUPTS_DSRS_TABLE {
 107         display       "Use fixed-size table for DSRs"
 108         default_value 0
 109         implements    CYGINT_KERNEL_INTERRUPTS_DSRS
 110         description   "
 111             When DSR support is enabled the kernel must keep track of all
 112             the DSRs that are pending. This information can be kept in a
 113             fixed-size table or in a linked list. The table
 114             implementation involves a very small risk of overflow at
 115             run-time if a given interrupt source is able to have more
 116             than one pending DSR. However it has the advantage that
 117             the kernel does not need to disable interrupts outside
 118             interrupt handlers."
 119
 120         cdl_option CYGNUM_KERNEL_INTERRUPTS_DSRS_TABLE_SIZE {
 121             display       "Number of entries in fixed-size DSR table"
 122             flavor        data
 123             legal_values  2 to 1024
 124             default_value 32
 125             description "
 126             When DSR support is enabled the kernel must keep track of all
 127             the DSRs that are pending. One approach involves a fixed-size
 128             table, which involves a very small risk of overflow at
 129             run-time. By increasing the table size it is possible to reduce
 130             this risk."
 131         }
 132     }
 133
 134     cdl_option CYGIMP_KERNEL_INTERRUPTS_CHAIN {
 135         display       "Chain all interrupts together"
 136         requires      CYGIMP_HAL_COMMON_INTERRUPTS_CHAIN
 137         default_value 0
 138         description "
 139             Interrupts can be attached to vectors either singly, or be
 140             chained together. The latter is necessary if there is no way
 141             of discovering which device has interrupted without
 142             inspecting the device itself. It can also reduce the amount
 143             of RAM needed for interrupt decoding tables and code."
 144     }
 145 }