Bureaucrats, dave_user, Administrators
4,650
edits
Changes
no edit summary
!Notes
|-
|4.0.0/21.0.0
|June 2019
|[[BELK/BXELK_software_components#BELK_4.0.0_.2F_BXELK_2.0.0|4.0.0 / 2.0.0]]
== Introduction ==
[https://code.visualstudio.com/ Visual Studio Code] (VSCode for short) is a powerful integrated development environment (IDE). In the last years, it has gotten growing grown in popularity among software developers of any kind, thanks to its excellent flexibility. [https://marketplace.visualstudio.com/VSCode Numerous extensions], native git support, availability for all of the most common platforms are some of the features that have made it so successful.
Even though it was not designed for embedded software development specifically, it is so versatile that it can be used for this purpose as well. This application note shows, for instance, how to configure it in order to remotely debug an application running on the Bora/BoraX platform. As host machine, the Virtual Machine released along with the BELK/BXELK kit was used.
****As stated before, this task invokes the <code>remote-debugging.sh</code> script.
==Starting a debug session==
In practice, once the target is up and running and the example project was is copied onto the host machine as stated previously, follow these steps to start a cross-debugging session.
*Open the VSCode workspace
*Go to the ''Terminal'' panel and open an ssh connection to the target machine
**Once logged, execute the <code>start-gdbserver-loop.sh</code> script as shown in the following image. '''This operation has to be carried out only once, at the beginning of the first debug session'''.
*Select the <code>(gdb) Cross launch</code> configuration
*Click on the green ''Start Debugging'' icon or select the ''Debug->Start Debugging'' menu item. Alternatively, press F5. You should see something like the following picture. It is worth remembering that the scripts take care of killing any <code>gdbserver</code> instance running on the target before starting a new debugging session. This allows starting it with just one click.
[[File:BELK-AN-009-cross-debug.png|thumb|center|600px800px|Cross -debugging session]]
