diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle index 91a85f9..d1af68f 100644 Binary files a/.doctrees/environment.pickle and b/.doctrees/environment.pickle differ diff --git a/.doctrees/guide/install.doctree b/.doctrees/guide/install.doctree index 6947d62..9d81a05 100644 Binary files a/.doctrees/guide/install.doctree and b/.doctrees/guide/install.doctree differ diff --git a/_sources/guide/install.rst.txt b/_sources/guide/install.rst.txt index 511697f..27fa0de 100644 --- a/_sources/guide/install.rst.txt +++ b/_sources/guide/install.rst.txt @@ -269,3 +269,87 @@ Bitstreams for *XC2C (coolrunner-II)* needs to be remapped using ``.map`` shippe -DISE_PATH=/somewhere/Xilinx/ISE_VERS/ default: ``/opt/Xilinx/14.7``. + +Disabling/Enabling Cable or Vendor Drivers +------------------------------------------ + +With the default ``cmake ..`` configuration, openFPGALoader enables +``ENABLE_CABLE_ALL=ON`` and ``ENABLE_VENDORS_ALL=ON``. This means all cable +and vendor drivers are enabled by default, then filtered only by OS +capabilities and available dependencies. + +To reduce binary size, speed up the build, or keep support limited to selected +cables/vendors, you can explicitly enable or disable options. + +These commands are equivalent: + +.. code-block:: bash + + cmake -DENABLE_CABLE_ALL=ON -DENABLE_VENDORS_ALL=ON .. + # and + cmake .. # Implicit default values + +To disable all cable and vendor support: + +.. code-block:: bash + + cmake -DENABLE_CABLE_ALL=OFF -DENABLE_VENDORS_ALL=OFF .. + +This produces an **openFPGALoader** binary with no cable/vendor support. +Then re-enable only what you need by adding one or more options below. + +Each item in the following lists is a CMake option name. Use them with +``-D