Metadata-Version: 2.1
Name: gensio-modems
Version: 0.4.0
Summary: python-based ham-radio modem utilities (ax25, kiss, vara) built using gensio
Author-email: Masen Furer KF7HVM <kf7hvm@0x26.net>
Project-URL: Homepage, https://github.com/masenf/gensio-modems
Keywords: Ham Radio,KISS,AX.25
Description-Content-Type: text/markdown

# gensio-modems

python-based ham-radio modem utilities (ax25, kiss, vara) built using
[gensio](https://github.com/cminyard/gensio).

Currently enough functionality is provided to host a Winlink RMS
gateway, and connect to it (and others) via `pat`
telnet sessions.

## Install `gensio-modems`

```
python3 -m venv ./.venv
. .venv/bin/activate
pip install gensio-modems
```

alternatively, if you don't want a virtualenv,

```
pip install --user gensio-modems
```

## `vara`

RMS/Winlink capable gateway for VARA and VARA FM

```
python gensio_modems.vara \
    -l KF7HVM-10 \
    --banner "gensio+vara experimental rms gateway" \
    --gateway "rms,tcp,cms.winlink.org,8772"
```

## `ax25`

a simple ax25 listener-to-gensio proxy, useful for passing off to BBS or
gateway software.

### Winlink RMS

```
python -m gensio_modems.ax25 \
    -l KF7HVM-10 \
    -k tcp,localhost,8011 \
    --banner "gensio+ax25 experimental rms gateway" \
    --gateway "rms,tcp,cms.winlink.org,8772"
```

#### _as a service_

```
Description="Service for gensio rmsgw"
After=direwolf@dw1.service
BindsTo=direwolf@dw1.service

[Service]
RestartSec=5
Restart=always
User=rmsgw
ExecStart=/home/rmsgw/.gensio/bin/python -m gensio_modems.ax25 \
    -l N7DEM-12 \
    --banner "gensio+ax25 experimental rms gateway" \
    --gateway "rms,tcp,cms.winlink.org,8772"

[Install]
WantedBy=direwolf@dw1.service multi-user.target
```

## `proxy.py`

Expose an ax25 client connection via a telnet listener.

```
python -m gensio_modems.proxy \
    --mycall KF7HVM-1 \
    -k tcp,localhost,8010 \
    --listen tcp,localhost,8772
```

In pat, connect via telnet to `pat:KF7HVM-10@localhost:8772`.

The "password" is taken as the gateway to connect to!
