Skip to main content

A Python3 API to interface with Rainforest Automation's EMU-2

Project description


This library allows communication with a Rainforest Automation EMU-2 device. It is a rewrite of Rainforest's Emu-Serial-API in Python 3, and follows a similar architectural pattern where possible.


This library is distributed via pip and may be installed using pip install emu-power.


This API can be used in asynchronous mode or synchronous mode. Technically, communication always happens asynchronously with the Emu, but this library allows for a synchronous API to emulated.

As in Rainforest's library, we do not automatically start communication once the main object is instantiated. This is done because the EMU-2 constantly pushes data to us over the serial connection, so we want to give the consumer control over when this channel is opened. Before any commands are issued, the start_serial(<serial port>) method must be called to open the serial port and begin receiving data.

The serial port name is the platform-specific device that you wish to use. Note that unlike Rainforest's library, we do not attempt to detect the host platform or set any port prefixes - this means that the full name of the device (prefixed with COM for Windows or /dev for OSX and Linux, usually) must be used.

Example Usage


from emu_power import Emu

api = Emu(synchronous=True)

# This will return an instance of InstantaneousUsage, or None on timeout.
response = api.get_instantaneous_usage()


from emu_power import Emu
from emu_power.response_entities import InstantaneousUsage
import time

api = Emu()

# This will return immediately. The response data will become available
# when the device responds.
response = api.get_data(InstantaneousUsage)

Note: In real programs using asynchronous mode, it would probably make sense to make use of the schedule function of the EMU-2. This sets the frequency that certain events are sent, and allows for data to be received without constant polling. The schedule may be set using the set_schedule(...) method of the API. After the schedule is set up, the consuming program may periodically call the get_data method to access the most recent received data.


Contributions are welcome! Not all commands have been thoroughly tested yet, since I haven't have a reason to use some of them. This library was written both to provide a more convenient interface with the EMU-2, as well as to get some experience writing Python modules. Functionality and style improvements suggestions are welcome.

This library is based off of the XML spec for the Rainforest RAVEN, which may be found on Rainforest Automation's website. This spec is similar but not identical to the API that the EMU-2 uses. Some commands not listed in this document were implemented based off of the official Python 2 library, which may be found on Github.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

emu_power-1.51-py3-none-any.whl (8.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page