Doc: Add troubleshooting sections for emulator connectivity

Change-Id: I167aa827d594d143a5c86dcf31324ac4e64675ac
Reviewed-by: Laszlo Agocs <laszlo.agocs@digia.com>

1 files changed, 31 insertions, 0 deletions

diff --git a/src/doc/src/b2qt.qdoc b/src/doc/src/b2qt.qdoc
index 1822921..21187cf 100644
--- a/src/doc/src/b2qt.qdoc
+++ b/src/doc/src/b2qt.qdoc
@@ -846,6 +846,37 @@
         <INSTALL_DIR>/Tools/b2qt/adb devices
     \endcode
 
+    \section2 The emulator cannot connect to the internet
+
+    By default, the Virtualbox is configured to use host-only network, so external
+    connections do not work in the emulator.
+
+    You may be able to enable internet connectivity with another
+    virtual network adapter in NAT mode by adapting
+    \l{http://askubuntu.com/questions/293816/in-virtualbox-how-do-i-set-up-host-only-virtual-machines-that-can-access-the-in}{these}
+    instructions.
+
+    \section2 The emulator is stuck in 'Waiting for display data' or fails to start properly
+
+    Check the output of the following command:
+
+    \code
+        <INSTALL_DIR>/Tools/b2qt/adb devices
+    \endcode
+
+    If the emulator (192.168.56.101) is not listed there, try connecting to it:
+
+    \code
+        <INSTALL_DIR>/Tools/b2qt/adb connect 192.168.56.101
+    \endcode
+
+    If the emulator is already listed, try disconnecting it:
+    \code
+        <INSTALL_DIR>/Tools/b2qt/adb disconnect 192.168.56.101
+    \endcode
+
+    And then close the emulator and retry.
+
     \section2 What is the user and password to access my embedded Linux device
 
     Embedded Linux devices can be accessed using user \c{root} and an empty password.