imp

Member Entities

The imp object has the following member methods:

• imp.cancelwakeup() — Cancels a timer previously established by imp.wakeup()
• imp.clearconfiguration() — Erases the network settings and credentials held by a device
• imp.deepsleepfor() — Puts the imp into deep sleep for the specified period
• imp.deepsleepuntil() — Puts the imp into deep sleep until the specified time
• imp.enableblinkup() — Enables or disables BlinkUp™ on a device
• imp.enablerescuepin() — Activates the imp006’s rescue pin and fast-boot mode
• imp.environment() — Returns information about the imp’s type
• imp.getbootromversion() — Returns the current version of the imp’s BootROM
• imp.getcountry() — Returns the imp’s specified WiFi regulatory territory
• imp.getmemoryfree() — Returns the amount of currently unused memory in the imp
• imp.getpoweren() — Returns the current state of certain imps’ POWER_EN pin
• imp.getpowersave() — Returns the imp’s current WiFi power-save setting
• imp.getsoftwareversion() — Returns the imp or agent’s firmware version as a string
• imp.getuserconfiguration() — Retrieves stored device-level persistent user data
• imp.info() — Returns information about the imp on which your code is running
• imp.onidle() — Registers a function to be executed when the imp next goes idle
• imp.onunhandledexception() — Registers a global error handler
• imp.reset() — Reset and reboot the imp
• imp.scanwifinetworks() — Returns a list of WiFi networks detectable by the imp
• imp.setcountry() — Specifies the imp’s WiFi regulatory territory at blessing
• imp.setenroltokens() — Stores Electric Imp impCloud enrollment tokens on the imp
• imp.setnvramimage() — Sets the NVRAM image of certain imps at blessing
• imp.setpoweren() — Attempts to change the state of certain imps’ POWER_EN pin
• imp.setpowersave() — Enables or disables the imp WiFi sub-system’s power-save mode
• imp.setproxy() — Configures the imp for Internet access through a proxy server
• imp.setrescuepin() — Configures a rescue pin
• imp.setsendbuffersize() — Attempts to set the size of the imp’s TCP send window for server communications
• imp.setstaticnetworkconfiguration() — Allows a static network configuration to be applied to the device
• imp.setuserconfiguration() — Sets device-level persistent user data
• imp.setwificonfiguration() — Sets an imp’s saved WiFi network access data
• imp.sleep() — Causes the imp to halt code execution for a specified period
• imp.wakeup() — Sets a timer and registers a function which will be called when the timer fires

The imp object has the following member property:

• imp.configparams — A table of information relevant to factory configurations

The imp object also has the following deprecated member methods, which should not be used in new code, but are documented here as an aid to understanding and migrating old code:

• imp.configure() — Sets pre-IDE application information
• imp.getbssid() — Gets the WiFi access point or router’s BSSID
• imp.getchannel() — Returns the WiFi channel in which the imp is currently operating
• imp.getethernetspeed() — Returns the rated link speed of an imp005’s Ethernet PHY
• imp.getmacaddress() — Returns the imp’s WiFi MAC address
• imp.getrssi() — Returns the current WiFi signal strength
• imp.getssid() — Returns the SSID of the WiFi network for which the imp is currently configured
• imp.rssi() — Returns the current WiFi signal strength