Changeset b71fb43 in rtems-docs


Ignore:
Timestamp:
Mar 9, 2020, 7:57:38 AM (4 months ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
5, master
Children:
a388de9
Parents:
088a1f8
git-author:
Sebastian Huber <sebastian.huber@…> (03/09/20 07:57:38)
git-committer:
Sebastian Huber <sebastian.huber@…> (03/12/20 09:22:16)
Message:

c-user: Move "PCI Library Configuration"

Update #3836.

Location:
c-user/config
Files:
1 added
1 edited

Legend:

Unmodified
Added
Removed
  • c-user/config/index.rst

    r088a1f8 rb71fb43  
    2727    device-driver
    2828    mpci
    29 
    30 PCI Library Configuration
    31 =========================
    32 
    33 This section defines the system configuration parameters supported by
    34 ``rtems/confdefs.h`` related to configuring the PCI Library for RTEMS.
    35 
    36 The PCI Library startup behaviour can be configured in four different ways
    37 depending on how ``CONFIGURE_PCI_CONFIG_LIB`` is defined:
    38 
    39 .. index:: PCI_LIB_AUTO
    40 
    41 ``PCI_LIB_AUTO``
    42   Used to enable the PCI auto configuration software. PCI will be automatically
    43   probed, PCI buses enumerated, all devices and bridges will be initialized
    44   using Plug & Play software routines. The PCI device tree will be populated
    45   based on the PCI devices found in the system, PCI devices will be configured
    46   by allocating address region resources automatically in PCI space according
    47   to the BSP or host bridge driver set up.
    48 
    49 .. index:: PCI_LIB_READ
    50 
    51 ``PCI_LIB_READ``
    52   Used to enable the PCI read configuration software. The current PCI
    53   configuration is read to create the RAM representation (the PCI device tree)
    54   of the PCI devices present. PCI devices are assumed to already have been
    55   initialized and PCI buses enumerated, it is therefore required that a BIOS or
    56   a boot loader has set up configuration space prior to booting into RTEMS.
    57 
    58 .. index:: PCI_LIB_STATIC
    59 
    60 ``PCI_LIB_STATIC``
    61   Used to enable the PCI static configuration software. The user provides a PCI
    62   tree with information how all PCI devices are to be configured at compile
    63   time by linking in a custom ``struct pci_bus pci_hb`` tree. The static PCI
    64   library will not probe PCI for devices, instead it will assume that all
    65   devices defined by the user are present, it will enumerate the PCI buses and
    66   configure all PCI devices in static configuration accordingly. Since probe
    67   and allocation software is not needed the startup is faster, has smaller
    68   footprint and does not require dynamic memory allocation.
    69 
    70 .. index:: PCI_LIB_PERIPHERAL
    71 
    72 ``PCI_LIB_PERIPHERAL``
    73   Used to enable the PCI peripheral configuration. It is similar to
    74   ``PCI_LIB_STATIC``, but it will never write the configuration to the PCI
    75   devices since PCI peripherals are not allowed to access PCI configuration
    76   space.
    77 
    78 Note that selecting ``PCI_LIB_STATIC`` or ``PCI_LIB_PERIPHERAL`` but not
    79 defining ``pci_hb`` will reuslt in link errors. Note also that in these modes
    80 Plug & Play is not performed.
     29    libpci
    8130
    8231Event Recording Configuration
Note: See TracChangeset for help on using the changeset viewer.