Skip to main content





This is draft documentation which covers impOS™ functionality that, though currently in internal development, has been made available to a number of customers for testing purposes only. Both the functionality described here and the documentation itself are subject to change, including breaking changes, and may differ significantly from their final release versions.

The Interface class represents specific imp local network interfaces.

Instances of the class are not created manually, but solely by calling the imp API method This method prepares a specified interface for use (provided it is available for use) and returns an interface object which represents the selected interface.

These objects are typically used for local networking. At this time, only UDP connections are available; these are initiated by calling interface.openudp().

Connections can be made to local/private IPv4 addresses only; the only route to the Internet for application data remains the imp’s agent. Any interface opened for local communications will only have access to the local subnet: traffic will not be able to cross routers).

Note UDP communication is only available through WiFi and/or Ethernet interfaces, not cellular.

Member Entities

The interface object has the following member methods: