From dcbc00addd15988fe01dd8b3bb91a83ada9191d6 Mon Sep 17 00:00:00 2001 From: Marc Bonnici 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 ` 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']