Skip to main content

The Electric Imp IDE

The Legacy IDE is now no longer available. It has been replaced by impCentral™

About this Guide

This User Guide will show you all of the IDE components that you should be familiar with in order to create imp application and factory software efficiently. Writing code for imp-based projects is very straightforward, and the IDE puts your tools in easy reach.

Please read through this Guide before you begin developing your first agent and device software. However, if you want to leap right in and refer back to the Guide when you’re unsure how to achieve a certain task, that’s OK too. The Electric Imp Developer Forum puts you in touch with our friendly experts from the company and the broader imp community.
 

About the IDE

The Electric Imp IDE (Integrated Development Environment) provides all the tools you need to write, edit, debug and run the code you will deploy to power your imp-enabled connected products. These tools are presented in a single, easy-to-view workspace.


 

The IDE supports multiple applications — ‘models’ in the Electric Imp terminology — some of which will be the projects you are actively developing, some that have gone into production, and others that are archive projects retained for reference.

The IDE also contains production management tools. However, these are only made available to Electric Imp customers as a series of extra options and features presented within the IDE.

The IDE is an online resource. It runs in your web browser and requires an Internet connection to retrieve your models from the Electric Imp impCloud™ and to save the changes you make.

If you prefer to work with your own tools, the Build APIBeta provides a way to connect those tools directly to the impCloud.

Browser Support

The IDE should work on almost any desktop browser. However, only the following browser versions are formally supported and targeted for new features:

  • Chrome, Firefox, Safari, Edge: the two most recent vendor supported versions

To maintain compatibility with the IDE, you are advised to enable automatic browser updates. We will always support the two most recent *vendor supported* versions at any given time. As new versions of these browsers are released, support for the earlier of the two previously favored versions will end: we will not test new features and updates with older browsers.

IDE Structure

The IDE comprises three key areas:

  • The Top Bar provides access to general functionality, inclding help resources, impCloud™ status information, and account selection and settings.
  • The Tab Bar provides access to account-specific areas of IDE functionality — the options here change according to which account you select.
  • The Workspace is where you write and edit your application code, get production and debugging information, and set up your production process if you have permission to do so. What you see here depends on the tab you select.

The Workspace itself comprises four zones:

  • The Workspace Control Panel allows you to configure the Workspace to your taste, check your code for errors, access past versions of your software and deploy new code to your devices and agents.
  • The Device Code Pane, where you write and edit program code to run on imp-enabled devices.
  • The Agent Code Pane, where you write and edit program code to run on a server in the impCloud.
  • The log Pane, where you monitor the operation of your agent and device code as it runs.

The IDE provides two navigation tools to help you quickly locate IDE functionality: the Top Bar and the Tab Bar.

The Top Bar


 

The IDE’s Top Bar (shown below) provides quick access to account-level functionality, to the IDE’s help resources, and to useful information about the state of the impCloud and future scheduled maintenance operations. It comprises the following items:

Left-hand Side

  • ‘account’ Menu — The currently selected account, it takes the name of the selected account. This menu will not be shown if you have not been granted access to any accounts other than your own.

Right-hand Side

  • Devices — Access devices associated with your account — click the chip icon and any unassigned devices associated with your account are listed in the Workspace. The number of unassigned devices is highlighted.
  • Status Menu — Notice of service availability and future scheduled maintenance operations.
  • Help Menu — imp API and Squirrel language reference material in the Electric Imp Dev Center.
  • ‘What’s New?’ Menu — View IDE release notes.
  • ‘user’ Menu — Account information and related functionality. This menu takes your Electric Imp username.
     

The Tab Bar


 

The Tab Bar provides access to account-specific IDE functionality: the information and features presented by the Tab Bar’s entries will change depending on which account you have selected from the Top Bar’s ‘accounts’ menu. If you don’t have access to other accounts than your own, the Tab Bar entries will present information and features relating solely to your own account.

  • ‘Models’ — Access to your account’s models, and those which have been shared with you (see Working with Models and Devices)
  • ‘Collaborators’ — This presents the IDE’s Collaborator management interface (see Account Collaboration)
  • ‘Production Logs’ — This provides access to the IDE’s production logging facilities (see Production Logging)
  • ‘Debug’ — A place to look up information for a specific device, agent or imp (see Debugging)

In addition, the Tab Bar provides a search panel you can use to go directly to a specific device by entering its name, if one has been set, or its device ID.

If you are not an Electric Imp customer, you will not see the ‘Production Logs’ tab as you do not have the privileges required to access production-level functionality.


Back to the top