Module to manipulate Orvibo devices, such as s20 wifi sockets and AllOne IR blasters to control whatever devices via emiting IR signal (TVs, AV receivers, air conditioners, etc)

• Lots of info was found in ninja-allone library
• S20 data analysis by anonymous is here
• python-orvibo similar module, but currently supports Orvibo S20 sockets only.

• Get rid of keeping connection to the Orvibo device, which breaks further discover
• Test under linux platform
• Consider python 2.7 support
• Add mac and type cmd line arguments in order decrease execution latency (ver 1.1)
• API for adding new Orvibo device to the network
• Python setup script
• Orvibo s20 event handler
• Learning and emiting RF 433MHz signal Issue#7

• Python (tested on Win7 with python 2.7 and python 3.4 and Ubuntu with python 3.2)

This package is not on PyPI but you can clone or download this package and run pip install /path/to/orvibo

please let me know about apps not listed here

• OpenHAB guide by community user @robinson
• Samsung Artic guide cloud setup
• Domoticz community guide

orvibo.py [-i <ip>] | [-m <mac> -x <socket/irda>] [-s on|off] | [-t <file_to_save_signal>] | [-e <file_with_signal_to_emit>]]

> python orvibo.py
Orvibo[type=socket, ip=192.168.1.45, mac='acdf238d1d2e']
Orvibo[type=irda, ip=192.168.1.37, mac='accf4378efdc']

> python orvibo.py -i 192.168.1.45
Orvibo[type=socket, ip=192.168.1.45, mac='acdf238d1d2e']
Is enabled: True

Faster than just discovering by ip, since discovering step is skipped here. Note: There is no any mac/type validation!

> python orvibo.py -m acdf238d1d2e -x socket
Orvibo[type=socket, ip=unknown, mac='acdf238d1d2e']
Is enabled: True

Same arguments can be used for all examples below.

> python orvibo.py -i 192.168.1.45 -s on
Orvibo[type=socket, ip=192.168.1.45, mac='acdf238d1d2e']
Already enabled.

> python orvibo.py -i 192.168.1.37 -t test.ir
Orvibo[type=irda, ip=192.168.1.37, mac='accf5378dfdc']
Done

> python orvibo.py -i 192.168.1.37 -e test.ir
Orvibo[type=irda, ip=192.168.1.37, mac='accf5378dfdc']
Done

from orvibo import Orvibo

for ip in Orvibo.discover():
    print('IP =', ip)

for args in Orvibo.discover().values():
    device = Orvibo(*args)
    print(device)

Result

IP = 192.168.1.45
IP = 192.168.1.37
Orvibo[type=socket, ip=192.168.1.45, mac='acdf238d1d2e']
Orvibo[type=irda, ip=192.168.1.37, mac='accf4378efdc']

device = Orvibo.discover('192.168.1.45')
print(device)

Result:

Orvibo[type=socket, ip=192.168.1.45, mac='acdf238d1d2e']

only for devices with type 'socket'

device = Orvibo('192.168.1.45')
print('Is socket enabled: {}'.format(device.on))
device.on = not device.on # Toggle socket
print('Is socket enabled: {}'.format(device.on))

Result:

Is socket enabled: True
Is socket enabled: False

only for devices with type 'irda'

device = Orvibo('192.168.1.37')
ir = device.learn('test.ir', timeout=15) # AllOne red light is present,
                                           # waiting for ir signal for 15 seconds and stores it to test.ir file
if ir is not None:
    # Emit IR code from "test.ir"
    device.emit('test.ir')
    # Or with the same result
    # device.emit(ir)

By default module doesn't keep connection to the Orvibo device to allow user not thinking about unplanned disconnections from device by whatever reasons (power outage, wifi router reboot, etc). Such behavior actually leads to valuable delay between sending request and applying command on the Orvibo device. Module allows to keep the connection and decrease the latency via setting keep_connection property to True. In this way closing connection and handling socket errors duties lie on orvibo python library user.

import socket

device = Orvibo('192.168.1.45')
device.keep_connection = True

def blink_socket(device):
    try:
        device.on = not device.on
    except socket.error:
        # Reset connection to device    
        device.keep_connection = True

try:
    # Note: now socket errors are handled by user!

    # Blink the socket ^_^
    for i in range(5):
        blink_socket(device)

    # You also may stop using connection anytime
    # device.keep_connection = False
finally:
    # Connection must be closed explicitly.
    # via
    device.close()
    # or via
    # device.keep_connection = False