diff options
Diffstat (limited to 'c-user/config/device-driver.rst')
| -rw-r--r-- | c-user/config/device-driver.rst | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/c-user/config/device-driver.rst b/c-user/config/device-driver.rst index d84da0a..1e31575 100644 --- a/c-user/config/device-driver.rst +++ b/c-user/config/device-driver.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de) +.. Copyright (C) 2020, 2021 embedded brains GmbH & Co. KG .. Copyright (C) 1988, 2021 On-Line Applications Research Corporation (OAR) .. This file is part of the RTEMS quality process and was automatically @@ -114,7 +114,7 @@ placement of application device driver initializers. .. rubric:: CONSTRAINTS: The value of the configuration option shall be a list of initializers for -structures of type :c:type:`rtems_driver_address_table`. +structures of type :ref:`InterfaceRtemsDriverAddressTable`. .. Generated from spec:/acfg/if/appl-needs-ata-driver @@ -237,7 +237,7 @@ The Console Driver is responsible for providing the :file:`/dev/console` device file. This device is used to initialize the standard input, output, and error file descriptors. -BSPs should be constructed in a manner that allows :c:func:`printk` to work +BSPs should be constructed in a manner that allows :ref:`InterfacePrintk` to work properly without the need for the Console Driver to be configured. The @@ -439,9 +439,9 @@ This device driver is responsible for providing the :file:`/dev/console` device file. This device is used to initialize the standard input, output, and error file descriptors. -This device driver reads via :c:func:`getchark`. +This device driver reads via :ref:`InterfaceGetchark`. -This device driver writes via :c:func:`rtems_putc`. +This device driver writes via :ref:`InterfaceRtemsPutc`. The Termios framework is not used. There is no support to change device settings, e.g. baud, stop bits, parity, etc. @@ -493,14 +493,14 @@ This device driver is responsible for providing the :file:`/dev/console` device file. This device is used to initialize the standard input, output, and error file descriptors. -This device driver reads via :c:func:`getchark`. +This device driver reads via :ref:`InterfaceGetchark`. This device driver writes into a write buffer. The count of characters written into the write buffer is returned. It might be less than the requested count, in case the write buffer is full. The write is non-blocking and may be called from interrupt context. A dedicated task reads from the write buffer and outputs the characters via -:c:func:`rtems_putc`. This task runs with the least important priority. +:ref:`InterfaceRtemsPutc`. This task runs with the least important priority. The write buffer size is 2047 characters and it is not configurable. Use ``fsync( STDOUT_FILENO )`` or ``fdatasync( STDOUT_FILENO )`` to drain the @@ -709,7 +709,7 @@ Driver Table. .. rubric:: NOTES: The value of this configuration option is placed after the entries defined by -:ref:`CONFIGURE_BSP_PREREQUISITE_DRIVERS` and before all other device driver +:c:macro:`CONFIGURE_BSP_PREREQUISITE_DRIVERS` and before all other device driver configuration options. See :ref:`CONFIGURE_APPLICATION_EXTRA_DRIVERS` for an alternative placement @@ -718,7 +718,7 @@ of application device driver initializers. .. rubric:: CONSTRAINTS: The value of the configuration option shall be a list of initializers for -structures of type :c:type:`rtems_driver_address_table`. +structures of type :ref:`InterfaceRtemsDriverAddressTable`. .. Generated from spec:/acfg/if/ata-driver-task-priority @@ -858,7 +858,10 @@ options: * :ref:`CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS` -* :ref:`CONFIGURE_BSP_PREREQUISITE_DRIVERS` +If the :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` configuration option is not defined and +the :term:`BSP` provides +:c:macro:`CONFIGURE_BSP_PREREQUISITE_DRIVERS`, then the BSP-provided +prerequisite device drivers are also taken into account. .. rubric:: DESCRIPTION: |