pyPiCode

Python C extension module to wrap the PiCode library.

The PiCode library provides an easy way to handle the wireless protocols of weather stations and radio control switches using 315Mhz/433Mhz radio frequency in ASK/OOK modulation, which have been implemented by the "pilight" project

The PiCode library is a standard C/C++ library, both static and dynamic, that works on any libc/libc++ compatible system, such as macOS, FreeBSD, Linux, and even Windows.

Using SWIG, to generate the Python C extension source files that wraps PiCode's static C library:

picode_wrap.c: CMake compiles the C source file, as does the PiCode library, and they link together to build the Python C extension module.
picode_wrap.py: Python functions of the picode wrapper module are redefined to add basic docstrings and parameter checks in init.py package file.

Install

Package installation builds the C extension module, so some OS tools are required like these packages on Debian-based Linux systems:

Python3 development tools: python3-dev
Python3 package installer: python3-pip
C compiler suite: build-essential
CMake make system: cmake
Git version control system: git

Command to install from GitHub:

$ python3 -m pip install -v --user git+https://github.com/latchdevel/pyPiCode.git

Tests

PyPiCode provides a unit tests module to verify its correct operation:

$ python3 -m unittest discover -v pypicode

Usage

>>> import pypicode as picode
>>>
>>> picode.decodeString("c:011010100101011010100110101001100110010101100110101010101010101012;p:1400,600,6800@")
{'protocols': [{'conrad_rsl_switch': {'id': 1, 'unit': 2, 'state': 'on'}}]}
>>>

Functions:

decodePulseTrain(pulses_list: list)

Decodes a list of pulses to a results dict.

Returns a dict always, with a key "protocols" and a list of decoded protocols as its value, which will be empty if none are decoded, like as { 'protocols': [ ] }
decodeString(pilight_string: str)

Decodes a string in pilight format to a results dict.

Returns a dict with a key "protocols" and a list of decoded protocols as its value, or None on failure.
encodeJson(json: dict, repeats: int = 0)

Encodes a full json dict to a string in pilight format.

Returns a pilight string or None on failure.
encodeToPulseTrain(protocol, json_data: dict)

Encodes a Swig Object of type 'protocol_t *' and a json data dict to a pulses list.

Returns a pulses list or None on failure.
encodeToPulseTrainByName(protocol_name: str, json_data: dict)

Encodes a protocol name string and a json data dict to a pulses list.

Returns a pulses list or None on failure.
encodeToString(protocol_name: str, json_data: dict, repeats: int = 0)

Encodes a protocol name string and a json data dict to a string in pilight format.

Returns a pilight string or None on failure.
findProtocol(name: str)

Find a protocol among all those initialized by name.

Returns a Swig Object of type 'protocol_t *' or None on failure.
getPiCodeVersion()

Get version of PiCode library.

Returns the full version string of the PiCode library or None on failure.
pulseTrainToString(pulses_list: list, repeats: int = 0)

Converts a list of pulses to a string in pilight format.

Returns a pilight string or None on failure.
stringToPulseTrain(pilight_string: str)

Converts a string in pilight format to a pulses lists.

Returns a pulses list or None on failure.

License

License GNU Lesser General Public License v3.0.

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

This program 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

See the LICENSE file for license rights and limitations (lgpl-3.0).

latchdevel / pyPiCode