You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**<spanstyle="font-variant: small-caps;">Latch</span> (Large-scale Automated Testing on Constraint Hardware)** is a novel testing framework for running large scale unit and integration tests in constrained environments.
8
8
9
9
::: tip Open source
10
-
11
10
You can find the open source code on [github](https://github.com/TOPLLab/latch).
Open your local plugin repository (see [install step](./index.md)), and click on `Run Extension` under the _Run and Debug_ tab.
6
+
This will launch the plugin in a new VS Code window.
7
+
8
+
In this new window, open your project folder.
9
+
If you don't have a project yet, you can use the [AssemblyScript template](https://github.com/TOPLLab/as-warduino-template) for WARDuino to get started quickly.
10
+
11
+
## Project Configuration {#vscode-config}
12
+
13
+
::: tip Add `launch.json` file
14
+
If you use any of our templates, you can skip this configuration step.
15
+
The template contains the correct launch file.
16
+
:::
17
+
18
+
To use the WARDuino plugin to debug your project, you need to create a `launch.json` file in the `.vscode` subfolder of your project root directory [<sup>\[1\]</sup>](https://code.visualstudio.com/docs/editor/debugging).
19
+
The file should look like this:
20
+
21
+
```json
22
+
{
23
+
"version": "0.4.1",
24
+
"configurations": [
25
+
{
26
+
"type": "WARDuinoDBG",
27
+
"request": "launch",
28
+
"name": "Debug WARDuino",
29
+
"program": "${workspaceFolder}/src/main.ts",
30
+
"stopOnEntry": true,
31
+
"trace": false
32
+
}
33
+
]
34
+
}
35
+
```
36
+
37
+
The `program` key within the JSON file specifies the application's entry file that needs to be debugged.
38
+
39
+
Depending on the file extension pointed by the `program` entry, the plugin will load the required WebAssembly compiler and create source mappers accordingly.
40
+
41
+
## Start Debugging
42
+
43
+
By default, the plugin will debug using a local running instance of WARDuino (emulator).
44
+
This means you don't need any further configuration.
45
+
Navigate to the _Run and Debug_ tab, and click on `Debug WARDuino`.
46
+
47
+
The next tutorial goes through the steps needed to debug on real hardware.
This page describes the VS Code plugin [version 0.4.1](https://github.com/TOPLLab/WARDuino-VSCode/releases/tag/v0.4.1), which works with WARDuino [version 0.4.2](https://github.com/TOPLLab/WARDuino/releases/tag/v0.4.2).
6
+
7
+
:::
8
+
9
+
::: warning Unstable prerelease
10
+
11
+
The plugin is still in experimental phase.
12
+
The following describes the current state of the VS Code plugin, which is not yet fully stable.
13
+
Consequently, the plugin may crash unexpectedly or become unresponsive.
14
+
15
+
:::
16
+
17
+
The WARDuino plugin is a VS Code extension designed for debugging applications running on the WARDuino VM. The plugin offers two debugging techniques:
18
+
19
+
1.[remote debugging](/reference/architecture.md#classic) and
- On-demand switching from [remote debugging](/reference/architecture.md#classic) to [event-based out-of-place debugging](/reference/edward/index).
25
+
- Access to classic debug operations: add a breakpoint, remove a breakpoint, step, step-over, run, and more.
26
+
- Access to advanced debug operations: step back debug operations to view past state. (experimental)
27
+
- A view on the whole debugging history to easily jump back to a previous state. (experimental)
28
+
- Upload new source code on the device once a fault has been fixed.
29
+
- Debug on a board
30
+
- Debug on an emulator.
31
+
- Control over interrupts (e.g., button press, incoming MQTT message) and the handling of it.
32
+
33
+
## Manual Installation {#installation}
34
+
35
+
::: warning Soon to be released!
36
+
37
+
The VS Code plugin has not been published yet. Look out for it in the VS Code Marketplace!
38
+
:::
39
+
40
+
Before installing the plugin, make sure that you followed the [installation guide](/guide/get-started.md#installation) for the needed development software.
41
+
42
+
Once the installation is completed follow these steps:
43
+
44
+
- Install VS Code (version 1.63.2 or higher)
45
+
46
+
- (Optional) In case you plan to debug Textual WebAssembly source files make sure to install this [VS Code WebAssembly Syntax Highlight plugin](https://github.com/AlanCezarAraujo/vscode-webassembly-syntax-highlight).
47
+
48
+
- Change the VS Code settings to enable allow `Allow Breakpoints Everywhere`.
49
+
For this, navigate to the VS Code settings and search for `Allow Breakpoints Everywhere` in the search bar.
50
+
- Download the [WARDuino VS Code plugin](https://github.com/TOPLLab/WARDuino-VSCode) repo and execute the installation bash script named `install.sh`.
51
+
This script downloads and builds the essential libraries such as the WARDuino VM.
0 commit comments