Skip to main content





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: