View source for Zynthian Webconf debug with Visual Studio Code (VSC)

'''Debugging Webconf with Visual Studio Code'''

This is presented as an example of how a Visual Studio Code can be used to examine a component of the zynthian sub system as it runs using the Visual studio Code extensions, python & remote-ssh.
These are loaded using the cog dialog at the bottom of the vsc code page.


[[File:Vsc_extentions_detail.png|thumb|center ]]

Once you have these components added you can attempt to log onto an existing Zynthian from your PC, MAC, or linux machine, just so long as it's capable of running Visual Studio Code. In my own case I have it running on a 64 bit Raspbian instance, and I had to build it from source to get it running which is a degree of proof of the overall flexibility of what is after all a Microsoft product!  

I also tend to add the git-graph extension. 

[[File:Vsc_git_graph.png|thumb|center|Zynthian git graph]]

'''The ssh connection''' 

The addition of the remote component adds the Remote Explorer element 
[[File:Vsc_remote_explorer_section.png|thumb|center]]

I already have a couple of remote zynthians in the machine and VSC is pretty tenacious at hanging onto remote instances it knows about. But we will try to add a new machine.

I have a zynthian called zynthian-orig.local. It's actually a genuine zynthian product running a Pi3 and no membrane switches and some fairly simplistic interface. Indeed it has to be disassembled to change the ssd. Such were the early days.!

[[File:Zynthian-orig.local.png|frame|center|Zynthian-orig.local]]

== Visual Studio Code Configure. ==

Firstly we need to add the extensions.
[[File:Vsc_extensions.png|thumb|center]]

activated by the cog in the bottom left hand corner of the Visual Studio Code interface

[[File:Vsc remote explorer dialog.png|thumb|center]]
we enter the command we will use to access the remote zynthian which is ssh....

And login using the machines root password.

[[File:Zynthian-sys-security.png|thumb |center]]



[[File:Vsc_remote_explorer_add_new.png|thumb|center]]

[[File:Vsc_remote_explorer_dialog.png|thumb|center]]

[[File:Vsc remote explorer zynthian-orig.png|thumb|center]]

[[File:Vsc remote explorer first login.png|thumb|center]]

[[File:Vsc-remote explorer password.png|thumb|center]]

[[File:Vsc setting up remote server.png|thumb|center]]

[[File:Vsc connected.png|thumb|center]]

[[File:Vsc remote explorer connect to host.png|thumb|center]]

== Selecting the home directory on the Remote server ==

[[File:Vsc open a folder.png|thumb|center]]

[[File:Vsc select folder default.png|thumb|center]]

[[File:Vsc select folder zynthian webconf.png|thumb|center]]

[[File:Vsc zynthian webconf head.png|thumb|center]]

== Running the Debugger ==

[[File:Vsc start debugging.png|thumb|center]]

[[File:Vsc remote installing.png|thumb|center]]

[[File:Vsc debug selection.png|thumb|center]]

[[File:Vsc already in use.png|thumb|center]]

== Turning off Running Webconf instance ==

[[File:Vsc address already in use with stop.png|thumb|center]]

[[File:Vsc stop webconf systemd.png|thumb|center]]

[[File:Zynthian dead webconf.png|thumb|center]]

== Now Start the debugger... ==

[[File:Zynthian-orig running midi.png|thumb|center]]

[[File:Vsc debug line 132.png|thumb|center]]

[[File:Vsc debug stepover.png|thumb|center]]