This extension is in the Alpha state. Please report any issues that you find. Thanks for your patience and cooperation!
This Extension for the Microsoft Visual Studio Code text editor enhances Electric Imp application development by delivering access to the Electric Imp impCloud™ via the Electric Imp impCentral™ API. It allows you to rapidly build and maintain applications by providing:
For operation, the Extension requires a connection to the Internet. It also requires Node.js, impWorks Builder and Visual Studio Code.
The Extension requires Node.js 11.0 or above. Please follow these instructions to install Node on your machine.
The Extension uses the Builder Node.js module for source code pre-processing. To install Builder, please use Node Package Manager (NPM):
npm i -g Builder
Visual Studio Code can be downloaded for a variety of platforms here.
The Electric Imp Visual Studio Code Extension can be installed using any of a number of methods, listed below. Once the Extension has been published to the Visual Studio Marketplace, this will be the recommended way to install the Extension by building it from the source code.
The Visual Studio Marketplace can be accessed through Visual Studio Code itself. Please refer to the Marketplace documentation for more details. Search for the extension using "Electric Imp Squirrel" and, when the extension is listed, click the Install button next to it in the search results.
Follow these steps to install the Extension manually:
cd to the Visual Studio Code extension directory:
npm install .The Extension provides the following commands:
imp: Auth User Password — Create an authorization file with a new access token in the selected workspace directory.imp: New Project — Create a new configuration file and empty source code files in the selected workspace directory.imp: Deploy Project — Deploy the source code to the selected Device Group and restart the group’s devices.imp: Start Device Logs — Begin including a device’s logs to the console output.imp: Stop Device Logs — Stop showing a device’s logs in the console output.imp: Pause Logs — Pause the logs in the console output.imp: Clear Logs — Clear the logs in the console output.imp: Add Device to current DG — Add a device to the workspace Device Group.imp: Remove Device from current DG — Remove a device from the workspace Device Group.imp: Get agent URL — Display a device’s agent URL.imp: Show All Commands... — Show the list of Extension commands.Select a new project working directory using File > Open Folder..., if you have not done so. Select the View > Command Palette... > imp: New Project menu item.
When you create new project (or perform any other action that requires access to the impCloud), you will be asked to:
The project directory will be set up with the following files and structure:
<project working directory>
|----> settings - Settings directory
. |--> auth.info - SENSITIVE impCentral API tokens and
. | GitHub authentication information
. |--> imp.config - Generic Electric Imp settings
.
|----> src - Source code directory
. |--> device.nut - Device code file
. |--> agent.nut - Agent code file
.
|---->.gitignore - .gitignore file to exclude auth.info file
from git repository
IMPORTANT The file auth.info in the settings sub-directory should not be put under source control as it contains sensitive account information. A .gitignore file is included automatically to prevent this.
The imp.config file contains:
{ "cloudURL" : "<Electric Imp Cloud URL>",
"ownerID" : "<user id>",
"deviceGroupId" : "<device group id>",
"device_code" : "<path to device source file; src/device.nut by default>",
"agent_code" : "<path to agent source file; src/agent.nut by default>",
"builderSettings": "<different Builder variables>" }
When a project is created, empty device and agent code files (device.nut and agent.nut, respectively) are automatically created and stored in the project working directory’s src sub-directory.
If the project was created successfully, the imp.config file is opened.
To open an existing project, use File > Open Folder... to open the project working directory.
To build code and deploy it, use View > Command Palette... > imp: Deploy Project.
This action pre-processes and then uploads the agent and the device code to the impCloud™ server. Finally, it restarts all of the devices assigned to the target Device Group.
If you want to run your code on specific devices and view the logs from those devices, you need to select them using View > Command Palette... > imp: Add Device to current DG. The imp: Remove Device from current DG command removes a device from the project’s Device Group.
Note It isn’t necessary to assign a device to the Device Group to build and deploy your code to the group. If you don’t have any devices assigned to the Device Group, you can still work on the code and see any compilation errors reported by the server.
Live logs are streamed to the console, displayed by selecting the View > Output menu item. It is possible to add a specific device to the live logs by its ID using the View > Command Palette... > imp: Start Device Logs command. The console shows live logs streamed from the current Device Group if the group contains at least one device.
To assign devices to the project’s Device Group, select View > Command Palette... > imp: Add Device to current DG.
Devices can be removed from the project’s Device Group by selecting View > Command Palette... > imp: Remove Device from current DG.
The URL of a device’s agent can be retrieved by selecting View > Command Palette... > imp: Get agent URL. The URL is displayed in a dialog box and copied to the clipboard.
Note Electric Imp-specific menu items are only available if an Electric Imp project is open in the currently active window.
| Command | Shortcut |
|---|---|
| Show all Extension Commands | Ctrl + Shift + C |
| Create Project | Ctrl + Shift + Y |
| Build and Run | Ctrl + Shift + X |
Please refer to the Builder documentation for more information on the pre-processor syntax that you can use in your Squirrel code.
Please use the <project working directory>/settings/auth.info file to specify your Builder GitHub authentication information:
{ ...,
"builderSettings": { "github_user" : "GitHub user name",
"github_token": "Personal access token or password" }}
Please use the <project working directory>/settings/imp.config file to specify Builder variable definitions (as described here).
{ "builderSettings": { ...,
"variable_definitions": { "IntType": 34,
"FloatType": 34.456,
"ExponentType1": 3E4,
"ExponentType2": 3e-2,
"StringType1": "str1",
"StringType2": "\"str2\"",
"BoolTypeTrue": true,
"BoolTypeFalse": false,
"NullType": null },
... }}
It is possible to obtain these Builder variable definitions values from Squirrel code this way:
server.log(@{IntType}); // 34
server.log(@{FloatType}); // 34.456
server.log(@{ExponentType1}); // 30000
server.log(@{ExponentType2}); // 0.03
server.log(@{StringType1}); // str1
server.log(@{StringType2}); // "str2"
server.log(@{BoolTypeTrue}); // true
server.log(@{BoolTypeFalse}); // false
server.log(@{NullType}); // (null : 0x0)
server.log(@{NotDefined}); // (null : 0x0)