Changeset f6c6c8b in rtems-docs


Ignore:
Timestamp:
Mar 6, 2018, 6:38:52 AM (14 months ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
master
Children:
8010b6e
Parents:
d078405
git-author:
Sebastian Huber <sebastian.huber@…> (03/06/18 06:38:52)
git-committer:
Sebastian Huber <sebastian.huber@…> (03/06/18 07:07:53)
Message:

CONFIGURE_*_SIMPLE_TASK_CONSOLE_DRIVER

Update #3320.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • c-user/configuring_a_system.rst

    rd078405 rf6c6c8b  
    38553855
    38563856NOTES:
    3857     This device driver is responsible for providing standard input and output
    3858     using */dev/console*.
     3857    This device driver is responsible for providing the :file:`/dev/console`
     3858    device file.  This device is used to initialize the standard input, output,
     3859    and error file descriptors.
    38593860
    38603861    BSPs should be constructed in a manner that allows ``printk()`` to work
    38613862    properly without the need for the console driver to be configured.
    38623863
    3863     The ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER`` configuration option is
    3864     mutually exclusive with the
    3865     ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`` configuration option.
     3864    The
     3865
     3866    * ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER``,
     3867
     3868    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER``, and
     3869
     3870    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER``
     3871
     3872    configuration options are mutually exclusive.
    38663873
    38673874.. index:: CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER
     
    38893896
    38903897NOTES:
    3891     This device driver is responsible for providing standard input and output
    3892     using */dev/console*.
    3893 
    3894     This device driver writes via ``rtems_putc()`` and reads via
    3895     ``getchark()``.  The Termios framework is not used.  There is no support to
    3896     change device settings, e.g. baud, stop bits, parity, etc.
    3897 
    3898     The ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`` configuration
    3899     option is mutually exclusive with the
    3900     ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER`` configuration option.
     3898    This device driver is responsible for providing the :file:`/dev/console`
     3899    device file.  This device is used to initialize the standard input, output,
     3900    and error file descriptors.
     3901
     3902    This device driver reads via ``getchark()``.
     3903
     3904    This device driver writes via ``rtems_putc()``.
     3905
     3906    The Termios framework is not used.  There is no support to change device
     3907    settings, e.g. baud, stop bits, parity, etc.
     3908
     3909    The
     3910
     3911    * ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER``,
     3912
     3913    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER``, and
     3914
     3915    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER``
     3916
     3917    configuration options are mutually exclusive.
     3918
     3919.. index:: CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER
     3920
     3921.. _CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER:
     3922
     3923CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER
     3924------------------------------------------------------
     3925
     3926CONSTANT:
     3927    ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER``
     3928
     3929DATA TYPE:
     3930    Boolean feature macro.
     3931
     3932RANGE:
     3933    Defined or undefined.
     3934
     3935DEFAULT VALUE:
     3936    This is not defined by default.
     3937
     3938DESCRIPTION:
     3939    ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER`` is defined if
     3940    the application wishes to include the Simple Task Console Device Driver.
     3941
     3942NOTES:
     3943    This device driver is responsible for providing the :file:`/dev/console`
     3944    device file.  This device is used to initialize the standard input, output,
     3945    and error file descriptors.
     3946
     3947    This device driver reads via ``getchark()``.
     3948
     3949    This device driver writes into a write buffer.  The count of characters
     3950    written into the write buffer is returned.  It might be less than the
     3951    requested count, in case the write buffer is full.  The write is
     3952    non-blocking and may be called from interrupt context.  A dedicated task
     3953    reads from the write buffer and outputs the characters via
     3954    ``rtems_putc()``.  This task runs with the least important priority.  The
     3955    write buffer size is 2047 characters and it is not configurable.
     3956
     3957    Use ``fsync(STDOUT_FILENO)`` or ``fdatasync(STDOUT_FILENO)`` to drain the
     3958    write buffer.
     3959
     3960    The Termios framework is not used.  There is no support to change device
     3961    settings, e.g.  baud, stop bits, parity, etc.
     3962
     3963    The
     3964
     3965    * ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER``,
     3966
     3967    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER``, and
     3968
     3969    * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER``
     3970
     3971    configuration options are mutually exclusive.
    39013972
    39023973.. index:: CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
Note: See TracChangeset for help on using the changeset viewer.