Main Page

From ago control wiki
(Difference between revisions)
Jump to: navigation, search
(Development Notes)
(Development Notes)
 
(52 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 +
<div style="float:right">__TOC__</div>
 +
[[File:ago-control-logo.png]]
 +
 
== What is ago control? ==
 
== What is ago control? ==
  
 
ago control is a framework for device control. The aim is to provide a complete home automation solution. It can also be used in other areas, like agriculture.  ago control uses an AMQP Enterprise Message Bus as communication backend, a lightweight protocol, readable by humans and machines, modern and modular architecture, cloud features and more!
 
ago control is a framework for device control. The aim is to provide a complete home automation solution. It can also be used in other areas, like agriculture.  ago control uses an AMQP Enterprise Message Bus as communication backend, a lightweight protocol, readable by humans and machines, modern and modular architecture, cloud features and more!
  
ago control boasts great performance and also runs on embedded devices like the [http://www.raspberrypi.org/ Raspberry Pi] and multiple plug computes like [http://www.globalscaletechnologies.com/t-sheevaplugs.aspx Sheevaplug], [http://www.globalscaletechnologies.com/t-guruplugdetails.aspx Guruplug] and Pogoplug. It has support for many devices and protocols like [http://www.z-wave.com/ Z-Wave], [http://en.wikipedia.org/wiki/KNX_(standard) KNX], [http://www.enocean.com/en/home/ EnOcean], [http://x10pro-usa.com/ X10], [http://www.maximintegrated.com/products/1-wire/ 1wire], [http://www.asterisk.org/ Asterisk PBX], [http://en.wikipedia.org/wiki/Dreambox Dreambox/Enigma2], Onkyo eISCP AVR, [http://wiki.linuxmce.org/index.php/Chromoflex_RGB_LED Chromoflex USP3 RGB LED dimmer], APC Power Distribution Unit (PDU), [http://www.opendmx.net/index.php/Open_Lighting_Architecture DMX Interfaces via the OpenLightingArchitecture (OLA)], [http://jointspace.sourceforge.net/ Phillips TV sets (Jointspace)], [http://arduino.cc/en/reference/firmata Arduino Firmata], [http://www.irtrans.de/de/index.php IRTrans Ethernet consumer infrared blaster], [http://www.kwikwai.com/ Kwikwai HDMI CEC Ethernet bridge], Rain8net irrigation controller, Webcam support, and [http://thingm.com/products/blinkm BlinkM LED] support.  ago control is easy to extend and has a growing list of user submitted device drivers.
+
ago control boasts great performance and also runs on embedded devices like the [http://www.raspberrypi.org/ Raspberry Pi] and multiple plug computes like [http://www.globalscaletechnologies.com/t-sheevaplugs.aspx Sheevaplug], [http://www.globalscaletechnologies.com/t-guruplugdetails.aspx Guruplug] and Pogoplug.<br/>
 +
It has support for many devices and protocols like [http://www.z-wave.com/ Z-Wave], [http://en.wikipedia.org/wiki/KNX_(standard) KNX], [[433Mhz|433 Mhz trancievers]], [http://www.enocean.com/en/home/ EnOcean], [http://x10pro-usa.com/ X10], [http://www.maximintegrated.com/products/1-wire/ 1wire], [http://www.asterisk.org/ Asterisk PBX], [http://en.wikipedia.org/wiki/Dreambox Dreambox/Enigma2], Onkyo eISCP AVR, [http://wiki.linuxmce.org/index.php/Chromoflex_RGB_LED Chromoflex USP3 RGB LED dimmer], APC Power Distribution Unit (PDU), [http://www.opendmx.net/index.php/Open_Lighting_Architecture DMX Interfaces via the OpenLightingArchitecture (OLA)], [http://jointspace.sourceforge.net/ Phillips TV sets (Jointspace)], [http://arduino.cc/en/reference/firmata Arduino Firmata], [http://www.irtrans.de/de/index.php IRTrans Ethernet consumer infrared blaster], [http://www.kwikwai.com/ Kwikwai HDMI CEC Ethernet bridge], Rain8net irrigation controller, Webcam support, and [http://thingm.com/products/blinkm BlinkM LED] support.  ago control is easy to extend and has a growing list of user submitted device drivers.
 +
 
 +
Additional help can be found on the [http://www.agocontrol.com/forum/index.php ago control forums] and/or on IRC via freenode.net in channel #agocontrol .
  
 
== Getting started ==
 
== Getting started ==
Line 11: Line 17:
  
 
'''Installation'''
 
'''Installation'''
 +
* [[ago_control_install_debian_jessie|Install ago control on Debian Jessie]]
 
* [[ago_control_install_debian_wheezy|Install ago control on Debian Wheezy]]
 
* [[ago_control_install_debian_wheezy|Install ago control on Debian Wheezy]]
 
* Install ago control on Fedora 17
 
* Install ago control on Fedora 17
 +
* [[Raspberry_Pi | Install ago control on Raspberry Pi (Headless) ]]
 
* [[CompilingSource|Compiling from source]]
 
* [[CompilingSource|Compiling from source]]
  
 
'''Usage'''
 
'''Usage'''
 
* [[agoAdmin | ago control Web Admin]] - Configure and monitor devices, events and scenarios using ago control Web Admin
 
* [[agoAdmin | ago control Web Admin]] - Configure and monitor devices, events and scenarios using ago control Web Admin
 
+
* [[Logging]] - Runtime & debug logging
 +
* [[SecuritySystem]] - Description of the security system in ago control
  
 
'''Device Specific'''
 
'''Device Specific'''
Line 23: Line 32:
 
* [[AsteriskPBXHowTo| Asterisk]] - Set up Asterisk PBX with ago control in 5 Minutes
 
* [[AsteriskPBXHowTo| Asterisk]] - Set up Asterisk PBX with ago control in 5 Minutes
 
* [[KNX]] - KNX set up
 
* [[KNX]] - KNX set up
 +
* [[Tellstick]] - Tellstick configuration
 
* [[X10]] - X10 configuration
 
* [[X10]] - X10 configuration
 
* [[zwave_basics | Z-Wave]] -  The basics about setup, inclusion, association and parameters of a Z-Wave device
 
* [[zwave_basics | Z-Wave]] -  The basics about setup, inclusion, association and parameters of a Z-Wave device
 +
* [[MySensors]] - MySensors configuration
  
 
== System overview ==
 
== System overview ==
Line 38: Line 49:
 
* [[agoAdmin|Web Admin]] - Configure and monitor devices, events and scenarios using ago control Web Admin
 
* [[agoAdmin|Web Admin]] - Configure and monitor devices, events and scenarios using ago control Web Admin
 
* [[DataLogger|Data Logger]] - The data logger logs all events which are sent by devices
 
* [[DataLogger|Data Logger]] - The data logger logs all events which are sent by devices
 +
* [[Blockly|Blockly]] - An easy way to create actions without any computer skills (or a little bit) using blocks construction
 +
* [[SecuritySystem]] - Alarm system functions
  
 
=== Device Interfaces ===
 
=== Device Interfaces ===
Line 45: Line 58:
 
'''Communications'''
 
'''Communications'''
 
* [[Asterisk PBX]]
 
* [[Asterisk PBX]]
 +
* [[AgoAlert]]: Send sms, email, tweet, push notifications
 +
 +
 +
'''Raspberry Pi (rpi) specific'''
 +
* [[RaspberryPi1Wire|Raspberry Pi 1Wire]]
 +
* [[RaspberryPiGPIO|Raspberry Pi GPIO]]
 +
* [[Raspberry Pi Camera|Raspberry Pi Camera]]
 +
* [[Raspithermocouple|Raspberry Pi K-Thermocouple with MAX31855]]
 +
  
 
'''Development'''
 
'''Development'''
Line 50: Line 72:
 
* [[GC100|Global Cache GC100]]
 
* [[GC100|Global Cache GC100]]
 
* [[I2C|I2C device support]]
 
* [[I2C|I2C device support]]
* [[RaspberryPi1Wire|Raspberry Pi 1Wire]]
 
* [[RaspberryPiGPIO|Raspberry Pi GPIO]]
 
 
* [[Simulator]]
 
* [[Simulator]]
 +
  
 
'''Device Specific'''
 
'''Device Specific'''
 
* [[1Wire]]
 
* [[1Wire]]
 
* [[AsteriskPBXHowTo| Asterisk]]
 
* [[AsteriskPBXHowTo| Asterisk]]
 +
* [[IPX800-v3 board]]
 
* [[KNX]]
 
* [[KNX]]
 
* [[X10]]
 
* [[X10]]
 
* [[zwave_basics | Z-Wave]]
 
* [[zwave_basics | Z-Wave]]
 +
  
 
'''Entertainment & Multimedia'''
 
'''Entertainment & Multimedia'''
 
* [[Dreambox/Engima2]]
 
* [[Dreambox/Engima2]]
 +
* [[IrtransEthernet|Irtrans Ethernet]]
 
* [[JointSpace]]
 
* [[JointSpace]]
 
* [[Kwikwai|Kwikwai HDMI CEC]]
 
* [[Kwikwai|Kwikwai HDMI CEC]]
* [[IrtransEthernet|Irtrans Ethernet]]
 
 
* [[Onkyo EISCP]]
 
* [[Onkyo EISCP]]
 +
* [[Squeezebox]]
 +
* [[Yamaha]]
  
  
Line 72: Line 97:
 
* [[Rain8Net|rain8net irrigation device]]
 
* [[Rain8Net|rain8net irrigation device]]
 
* [[Weather]]
 
* [[Weather]]
 +
* [[Weatherreporter]]
 +
* [[MQTT]]
 +
  
 
'''Lighting'''
 
'''Lighting'''
Line 77: Line 105:
 
* [[Chromoflex USP3]]
 
* [[Chromoflex USP3]]
 
* [[OLA|DMX - Open Lighting Architecture]]
 
* [[OLA|DMX - Open Lighting Architecture]]
 +
  
 
'''Power Management'''
 
'''Power Management'''
Line 82: Line 111:
 
* [[EnOcean]] - Energy monitoring
 
* [[EnOcean]] - Energy monitoring
  
'''Security & Monitioring'''
+
 
 +
'''Security & Monitoring'''
 
* [[Webcam|Webcam]]
 
* [[Webcam|Webcam]]
 
* [[WifiDeviceDetect|Wifi Device Detect]]
 
* [[WifiDeviceDetect|Wifi Device Detect]]
 +
* [[sonar|Distance with sonar sr-hc04]]
  
 
== Development Notes ==
 
== Development Notes ==
* [[Message Reference]]
+
* [[Git]] - Git and Account information for developers
* [[Example Device]] - easily create your own devices for use in ago control
+
* [[Message Reference]] - How we use qpid messages
 +
* [[MessageFormat]] - exact specification of message/response content
 +
* [[MessageFormat#commandHandler_response]] - Standardised responses for the command handler
 +
* [[Developing tutorial]] - Collection of information of interest to developers
 +
* [[Development_environment|Development environment]] - How to set up a developmnent/build environment
 +
* [[Example Device]] - easily create your own custom devices for use in ago control
 
* [[Autostart Devices]] - learn to set up your custom devices so they automatically start on boot
 
* [[Autostart Devices]] - learn to set up your custom devices so they automatically start on boot
 +
* [[LUA Scripting]] - add more control using LUA scripting
 +
* [[Adding a new device type]] - tutorial for adding a new device type
 +
* [[BasicSecurityforWebAccess|Basic Security for Web Access]] - Add username/password log in for web access
 +
* [[Python_code_style|Python code style]]
 +
* [[Agologging|Agologging]] - discussion on standalone ago control logging functionality
 +
* [[Translation]] -Translate agocontrol to a new language
 +
* [[File_locations| File locations]] - File locations for all files in a running system
 +
 +
== Roadmap ==
 +
* [[GoalsV1.0]]
 +
* [[GoalsV2.0]]
  
 
== Example Setups ==
 
== Example Setups ==
 
* [[User:CrawTech]]
 
* [[User:CrawTech]]
 +
* [[User:JoakimL]]

Latest revision as of 09:26, 1 February 2017

Ago-control-logo.png

[edit] What is ago control?

ago control is a framework for device control. The aim is to provide a complete home automation solution. It can also be used in other areas, like agriculture. ago control uses an AMQP Enterprise Message Bus as communication backend, a lightweight protocol, readable by humans and machines, modern and modular architecture, cloud features and more!

ago control boasts great performance and also runs on embedded devices like the Raspberry Pi and multiple plug computes like Sheevaplug, Guruplug and Pogoplug.
It has support for many devices and protocols like Z-Wave, KNX, 433 Mhz trancievers, EnOcean, X10, 1wire, Asterisk PBX, Dreambox/Enigma2, Onkyo eISCP AVR, Chromoflex USP3 RGB LED dimmer, APC Power Distribution Unit (PDU), DMX Interfaces via the OpenLightingArchitecture (OLA), Phillips TV sets (Jointspace), Arduino Firmata, IRTrans Ethernet consumer infrared blaster, Kwikwai HDMI CEC Ethernet bridge, Rain8net irrigation controller, Webcam support, and BlinkM LED support. ago control is easy to extend and has a growing list of user submitted device drivers.

Additional help can be found on the ago control forums and/or on IRC via freenode.net in channel #agocontrol .

[edit] Getting started

Introduction

Installation

Usage

Device Specific

  • 1Wire - 1Wire interface set up
  • Asterisk - Set up Asterisk PBX with ago control in 5 Minutes
  • KNX - KNX set up
  • Tellstick - Tellstick configuration
  • X10 - X10 configuration
  • Z-Wave - The basics about setup, inclusion, association and parameters of a Z-Wave device
  • MySensors - MySensors configuration

[edit] System overview

[edit] Core Components

Listed below are the various components that monitor and act upon system variables and various input devices configured within the ago control system:

  • Resolver - The central component that handles device "registrations" and does name resolving
  • Timer - The timer component of ago control used to trigger time based events
  • Eventconfiguration - The component that uses user defined triggers matching certain criteria and then acts upon them as defined by an action
  • Scenarioconfiguration - The component used to group ago control commands to create simple or complex actions that can be triggered by events, from the dashboard, or from floorplans
  • RPC Interface - The server side component of ago control web admin
  • Web Admin - Configure and monitor devices, events and scenarios using ago control Web Admin
  • Data Logger - The data logger logs all events which are sent by devices
  • Blockly - An easy way to create actions without any computer skills (or a little bit) using blocks construction
  • SecuritySystem - Alarm system functions

[edit] Device Interfaces

Listed below are various device interfaces for ago control:

Communications


Raspberry Pi (rpi) specific


Development


Device Specific


Entertainment & Multimedia


Enviromental


Lighting


Power Management


Security & Monitoring

[edit] Development Notes

[edit] Roadmap

[edit] Example Setups

Personal tools