greenctld/README.md

96 lines
2.6 KiB
Markdown

# greenctld
Controller software for Green Heron RT-21 Az/El.
![Green Heron RT-21 Az/EL Alfa SPID](img/greenheron-alfaspid.png)
*Green Heron RT-21 controller with Alfa SPID RAS*
# Install
Install thusly:
```
sudo apt install python3-virtualenv python3-pip
git clone https://spacecruft.org/spacecruft/greenctld
cd greenctld
virtualenv -p python3 env
source env/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
```
# SatNOGS-client
HOWTO connect to the Libre Space Foundation's
SatNOGS network? Not sure.
The Green Heron RT-21 driver that has been in Hamlib for a decade
only supports one USB port. Th Green Heron RT-21 Az/El has one
USB port for azimuth and one USB port for elevation. This makes
the Hamlib driver that has been in Hamlib for 10+ years unsuitable
for use with an Az/El antenna setup. In sum, the hardware isn't
plug & play with `satnogs-client`.
There is a driver under a libre license available upstream here:
* https://github.com/mct/greenctld
The `greenctld` in that repo was written for Python 2.
The present `spacecruft` repo ports it to Python 3.
This is mostly done.
The `greenctld` daemon listens on port 4533 similar
to `rotctld`. It is unclear to me how to get the
`satnogs-client` to use this port instead of wanting
to start it's own `rotctld`.
In July of 2021, a commit was made to the main Hamlib
repo that added dual USB control for the Green Heron
RT-21 Az/El. This commit is not in the Hamlib version
that is in the latest `satnogs-client` release, however.
The new version adds a second controller command line
option:
```
-r, --rot-file=DEVICE set device of the rotator to operate on
-R, --rot-file2=DEVICE set device of the 2nd rotator controller to operate on
```
One option would be to adapt `satnogs-client` to use this new version.
Another option would be to port these patches back to the version
`satnogs-client` is running.
## SatNOGS Connection Options
Which option to use to connect the Green Heron RT-21 to `satnogs-client`?
Possibilities:
* Configure `satnogs-client` to use `greenctld` instead of `rotctld`.
* Patch `satnogs-client` to use recent Hamlib (no changes to Hamlib).
* Patch Hamlib with backported dual USB patches (no changes to `satnogs-client`).
* Other.
# Upstream
Upstream Python 2 version.
* https://github.com/mct/greenctld
Copyright (c) 2017, Astro Digital, Inc.
# License / Copyright
Port from Python 2 to Python 3 of mct's greenctld.
Same as upstream, permissive license, see `LICENSE`.
Documentation License: CC By SA 4.0 International.
Source:
* https://spacecruft.org/spacecruft/greenctld
Copyright (C) 2022 Jeff Moe.