From dcbc00addd15988fe01dd8b3bb91a83ada9191d6 Mon Sep 17 00:00:00 2001
From: Marc Bonnici <marc.bonnici@arm.com>
Date: Mon, 4 Nov 2019 16:33:59 +0000
Subject: [PATCH] docs/faq: Add workaround for module initialisation failure

---
 doc/source/faq.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/source/faq.rst b/doc/source/faq.rst
index c6109145..f627ca11 100644
--- a/doc/source/faq.rst
+++ b/doc/source/faq.rst
@@ -121,3 +121,20 @@ versions and delete your ``$USER_HOME/.workload_automation/cache/targets.json``
 please ensure that you configure your environment to use a locale which supports
 UTF-8. Otherwise this can cause issues when attempting to parse files containing
 none ascii characters.
+
+**Q:** I get the error ``Module "X" failed to install on target``
+------------------------------------------------------------------------------------------------------
+**A:** By default a set of devlib modules will be automatically loaded onto the
+target designed to add additional functionality. If the functionality provided
+by the module is not required then the module can be safely disabled by setting
+``load_default_modules`` to ``False`` in the ``device_config`` entry of the
+:ref:`agenda <config-agenda-entry>` and then re-enabling any specific modules
+that are still required. An example agenda snippet is shown below:
+
+.. code-block:: none
+
+    config:
+        device: generic_android
+        device_config:
+            load_default_modules: False
+            modules: ['list', 'of', 'modules', 'to', 'enable']