automate 0.10.19

Highlights:

• Supported hardware:

  • Raspberry Pi GPIO input/output ports

  • Arduino support for analog and digital input/output ports and VirtualWire wireless networking with AutomateFirmata.

  • Easy to write extensions to support other hardware

• System state saving and restoring via serialization

• Intelligent design:

  • Comprehensively tested via py.test unit/integration tests

  • Takes advantage of Traits library, especially its notification system.

  • IPython console to monitor, modify and control system on-the-fly

  • Versatile function/callable library to write state program logic

• RPC and Websocket interfaces to connect between other applications or other Automate systems.

• Comprehensive and customizable Web User Interface

• UML graphs can be drawn automaticlaly of the system (as can be seen in the examples of this documentation)

Example

Let’s take a look at a small Automate program as an example:

from automate import *

class MySystem(System):
    # HW swtich connected Raspberry Pi GPIO port 1
    hardware_switch = RpioSensor(port=1)
    # Switch that is controllable, for example, from WEB interface
    web_switch = UserBoolSensor()
    # Lamp relay that switches lamp on/off, connected to GPIO port 2
    lamp = RpioActuator(port=2)
    # Program that controls the system behaviour
    program = Program(
        active_condition=Or('web_switch', 'hardware_switch'),
        on_activate=SetStatus('lamp', True)
    )


my_system = MySystem()

This simple example has two sensors hardware_switch, web_switch, actuator (lamp) and a program that contains logic what to do and when. Here, lamp is switched on if either web_switch or hardware_switch has status True.

Installing Automate

Automate can be installed like ordinary python package. I recommend installation in within virtual environment (see virtualenv).

1. (optional): Create and start using virtualenv:

   mkvirtualenv automate
   workon automate

2. Install from pypi:

   pip install automate

Optionally, you can specify some of the extras, i.e. web, rpc, raspberrypi, arduino:

pip install automate[web,rpc,raspberrypi,arduino]

or if you want them all:

pip install automate[all]

License

Automate is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Automate is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Automate. If not, see http://www.gnu.org/licenses/.