No Description

Stephen Downward 1a04402c4c Replaced all instances of kiss with kiss2 8 months ago
examples 1a04402c4c Replaced all instances of kiss with kiss2 8 months ago
kiss 9793f1c761 Fixed recover_special_codes() sometimes returning the wrong thing 8 months ago
kiss2 cdcf091541 Replaced all instances of kiss with kiss2 8 months ago
tests 1b356b93d2 7.x Branch Python 3.x port WIP checkpoint. 1 year ago
.gitignore 3c9417f9e3 Added pypirc to gitignore 8 months ago
.travis.yml e5e9b52b91 pinning to python 3 1 year ago
CONTRIBUTORS 81ec616813 updates 1 year ago
COPYRIGHT.txt da54764cd1 checkpoint 1 year ago
LICENSE da54764cd1 checkpoint 1 year ago
MANIFEST.in 2d2455249c updates 2 years ago
Makefile cdb4c90bfb bugfixes 1 year ago
README.rst 1a04402c4c Replaced all instances of kiss with kiss2 8 months ago
requirements.txt cdb4c90bfb bugfixes 1 year ago
setup.cfg da54764cd1 checkpoint 1 year ago
setup.py 1a04402c4c Replaced all instances of kiss with kiss2 8 months ago

README.rst

kiss2 - Python KISS Module
*************************

kiss2 is a Python Module that implementations the `KISS Protocol `_ for
communicating with KISS-enabled devices (such as Serial or TCP TNCs). It is based on kiss(Another python module) which is no longer maintained.

Versions
========

- 6.5.x branch will be the last version of this Module that supports Python 2.7.x
- 7.x.x branch and-on will be Python 3.x ONLY.

Installation
============
Install from pypi using pip: ``pip install kiss2``


Usage Examples
==============
Read & print frames from a TNC connected to '/dev/ttyUSB0' at 1200 baud::

import kiss

def p(x): print(x) # prints whatever is passed in.

k = kiss.SerialKISS('/dev/ttyUSB0', 1200)
k.start() # inits the TNC, optionally passes KISS config flags.
k.read(callback=p) # reads frames and passes them to `p`.


See also: examples/ directory.


Testing
=======
Run nosetests from a Makefile target::

make test


Similar Projects
================

* `apex `_ by Jeffrey Phillips Freeman (WI2ARD). Next-Gen APRS Protocol. (based on this Module! :)
* `aprslib `_ by Rossen Georgiev. A Python APRS Library with build-in parsers for several Frame types.
* `aprx `_ by Matti & Kenneth. A C-based Digi/IGate Software for POSIX platforms.
* `dixprs `_ by HA5DI. A Python APRS project with KISS, digipeater, et al., support.
* `APRSDroid `_ by GE0RG. A Java/Scala Android APRS App.
* `YAAC `_ by KA2DDO. A Java APRS Client.
* `Ham-APRS-FAP `_ by aprs.fi: A Perl APRS Parser.
* `Dire Wolf `_ by WB2OSZ. A C-Based Soft-TNC for interfacing with sound cards. Can present as a KISS interface!

Source
======
Github: https://git.scd31.com/laptopdude90/kiss2

Author
======
Greg Albrecht W2GMD oss@undef.net (kiss)
Stephen Downward VA1QLE stephen@stephendownward.ca (kiss2)

https://blog.scd31.com

Copyright
=========
Copyright 2017 Greg Albrecht(kiss), Stephen Downward(kiss2) and Contributors

License
=======
Apache License, Version 2.0. See LICENSE for details.