Skip to main content

Python interface for the AlarmDecoder (AD2) family of alarm devices which includes the AD2USB, AD2SERIAL and AD2PI.

Project description


This Python library aims to provide a consistent interface for the AlarmDecoder product line. (AD2USB, AD2SERIAL and AD2PI). This also includes devices that have been exposed via ser2sock, which supports encryption via SSL/TLS.


AlarmDecoder can be installed through pip:

pip install alarmdecoder

or from source:

python install
  • Note: python-setuptools is required for installation.





API documentation can be found at readthedocs.


A basic example is included below. Please see the examples directory for more.:

import time
from alarmdecoder import AlarmDecoder
from alarmdecoder.devices import SerialDevice

def main():
    Example application that prints messages from the panel to the terminal.
        # Retrieve the first USB device
        device = AlarmDecoder(SerialDevice(interface='/dev/ttyUSB0'))

        # Set up an event handler and open the device
        device.on_message += handle_message
            while True:

    except Exception as ex:
        print ('Exception:', ex)

def handle_message(sender, message):
    Handles message events from the AlarmDecoder.
    print sender, message.raw

if __name__ == '__main__':

Project details

Download files

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

Files for alarmdecoder, version 1.13.10
Filename, size File type Python version Upload date Hashes
Filename, size alarmdecoder-1.13.10-py3-none-any.whl (48.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size alarmdecoder-1.13.10.tar.gz (314.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page