diff --git a/Makefile b/Makefile
index 6adf682..43d3992 100644
--- a/Makefile
+++ b/Makefile
@@ -393,6 +393,7 @@ define VS_LAUNCH
             "request": "launch",
             "servertype": "stutil",
             "cwd": "$${workspaceRoot}",
+            "gdbPath": "${ARM_GCC_PATH}/arm-none-eabi-gcc",
             "executable": "./$(BUILD_DIR)/$(BUILD_TARGET_BASE_NAME).elf",
             "name": "Cortex Debug (ST-Util)",
             "device": "$(DEVICE)",
@@ -403,6 +404,7 @@ define VS_LAUNCH
             "request": "launch",
             "servertype": "jlink",
             "cwd": "$${workspaceRoot}",
+            "gdbPath": "${ARM_GCC_PATH}/arm-none-eabi-gcc",
             "executable": "./$(BUILD_DIR)/$(BUILD_TARGET_BASE_NAME).elf",
             "name": "Cortex Debug (J-Link)",
             "device": "$(DEVICE)",
@@ -425,10 +427,10 @@ define VS_CPP_PROPERTIES
                 $(subst -D,$(NULL),$(subst $(SPACE),$(COMMA),$(strip $(foreach def,$(C_DEFS),"$(def)"))))
             ],
 
-            "compilerPath": "$${env:ARM_GCC_PATH}/arm-none-eabi-gcc",
+            "compilerPath": "${ARM_GCC_PATH}/arm-none-eabi-gcc",
             "cStandard": "c99",
             "cppStandard": "c++14",
-            "intelliSenseMode": "clang-x64"
+            "intelliSenseMode": "linux-gcc-arm"
         }
     ],
     "version": 4
diff --git a/README.md b/README.md
index 4f61c62..382d439 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ alguns arquivos de configuração.
 
 * [GNU Arm Embedded Toolchain](https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads)
   > É necessário que a pasta `bin` dessa instalação esteja no `PATH`
-  > e numa variável de ambiente `ARM_GCC_PATH`
+  > e numa variável de ambiente `ARM_GCC_PATH` (e.g: `export ARM_GCC_PATH="/home/user/gcc-arm-none-eabi-10-2020-q4-major/bin"`)
 
 * uncrustify
   > Linux: `sudo apt install uncrustify`
@@ -227,4 +227,23 @@ Note que o nome do teste não inclui a extensão do arquivo.
 
 ## Debug
 
-> Em breve
+É necessário o download da ferramenta [stlink-tools](https://github.com/stlink-org/stlink):
+
+```bash
+sudo apt install stlink-tools
+```
+
+Isso instalará no sistema a ferramenta "st-utils", que será usada pela extensão [Cortex-Debug](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug) para o debug no VScode.
+
+O arquivo _.vscode/launch.json_ gerado quando rodamos o comando 
+
+```bash
+make vs_files
+```
+Possui configurações que são utilizadas por essa extensão para debugar o código em questão na placa.
+
+Para inicializar o _debugger_, vá na aba "Run and Debug" na lateral esquerda do VSCode, e clique no simbolo de "Play" no topo da tela.
+
+O comando do Makefile  cria duas configurações de Debug. Uma para ser utilizada com o ST-Utils e outra com o J-link. Fica a critério de qual gravador está utilizando na placa.
+
+> Completar com mais detalhes