====== Introducción ======

La presente guía tiene por objeto brindar el procedimiento necesario para la instalación y configuración de la herramienta de depuración GNU DeBugger en modo gráfico, GDBGUI de aquí en mas.
El procedimiento detallado en los subsiguientes apartados se encuentra basado en [[https://www.gdbgui.com/installation/|pipx un entorno virtual de python]], para Linux (Debian/Ubuntu), a fin de no alterar los módulos nativos del sistema operativo.

====== Procedimiento ======

===== CrossToolChain y Emulador ======

  * Ítem de lista desordenadaÍtem de lista desordenadaInstalar el "crosstoolchain" **gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf**, según se indica en [[bbx|Instalacion del cross compiler & Instalación de dependencias]]. Si se sigue la guía mencionada **///home/<su usuario>///**
  * Instalación de emulador **QEMU estandar**, según se indica en [[bbx|Instalación de emulador]].

===== Entorno virtual Python ======
  * Creación de un entorno virtual de python
<code bash>
cd <path_absoluto_de_trabajo>
mkdir <gdbgui_env>
python3 -m venv gdbgui_env
</code> 
  * Activar el entorno virtual
<code bash>
cd <path_absoluto_de_trabajo>
source gdbgui_env/bin/activate
</code>
  * Instalación de dependencias
<code bash>
pip install --upgrade pip
python3 -m pip install pipx
</code>

Para desactivar el entorno virtual (no hacerlo en este momento para continuar con la configuración)
<code bash>
deactivate
</code>

===== GDBGUI ======
  * Instalación el GDBGUI como ejecutable en entorno aislado.
<code bash>
pipx install gdbgui
</code>
  * Verificación
    * Se debe disponer de un fichero //**.gdbinit**// en el //< path_absoluto_de_trabajo >//. El mismo puede sólo contener las siguientes líneas
<code bash>
target remote 127.0.0.1:1234

# Required for gdb-multiarch
set architecture arm
</code>

    * Al ejecutar el siguiente comando, se debe observar en el navegador predeterminado del sistema, una nueva ventana equivalente a la mostrada {{ :gdbgui.jpg?400|}}
<code bash>
pipx run gdbgui -g '<path_absoluto_de_trabajo>/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gdb -x .gdbinit'
</code>