This page summarizes all you need to compile and deploy Espurna on Windows 10 with Visual Studio Code (VSCode). VSCode is a free, open source, light IDE from Microsoft.

Download it from https://git-scm.com/download/win (choose appropriate version).

Ensure that it modifies the path variable.

Download it from https://code.visualstudio.com/docs/?dv=win

Ensure that it updates the PATH variable (default option).

Download it from https://nodejs.org/en/download/ (more convenient with the Windows Installer (.msi) version)

NPM gets installed with node.js

Restart your computer.

Launch Visual Studio Code. It should detect git (displaying a message in a git pane at the bottom of the window).

From VSC, open a terminal (CTRL+SHIFT+` OR CTRL+SHIFT+P and search for Terminal: Create New Integrated Terminal) and run

npm install --global gulp-cli

From the extensions pane of Visual Studio Code install the following extensions.

Mandatory :

• Platformio IDE

Optionally :

• Python
• GitLens (to show modifications history)

Clone https://github.com/xoseperez/espurna.git

For example into C:\Users\{user}\Documents\PlatformIO\Projects\xoseperez-espurna

With VSCode, open xoseperez-espurna\code folder. PlatformIO IDE will start and detect platformio project.

Now you can build espurna, including web files, directly from Visual Studio Code.

To build / upload firmware for a specific board, use "Tasks / Run Task..." (CTRL+ALT+T by default) and search for "Build (...)" / "Upload (...)" tasks.

PlatformIO: Build and button on the bottom bar builds 'default' environment specified in 'code/platformio.ini' (wemos-d1mini-relayshield at the time of writing this)

In recent versions of Espurna some required OTA parameters are now picked up from environment variables.

You need to set them up for every Upload (ota) task you want to use. Here's how to do it:

• Press F1 (on Mac it's usually Fn+F1)
• Type a part of the name and click Tasks: Configure Task
• Type a part of Upload (ota) task you need and click it when it appears
• An editor for a JSON config opens. You'll see a section added with your task name, ex.:

"type": "PlatformIO",
"task": "Upload (itead-sonoff-th-ota)",
"problemMatcher": [
    "$platformio"
]

• Add the options section before the problemMatcher, so you have this:

"type": "PlatformIO",
"task": "Upload (itead-sonoff-th-ota)",
"options": {
    "env": {
        "ESPURNA_IP": "192.168.4.1",
        "ESPURNA_AUTH": "fibonacci"
    }
},
"problemMatcher": [
    "$platformio"
]

• If you have custom IP or password, put them here. Otherwise, use 192.168.4.1 and fibonacci
• Save and close the file. Now you can OTA upload this target successfully

You need to add a section to the config for every OTA target you want to use. The pro is you can natively support several devices with different IPs and passwords right from the VSCode