Network subsystems of the HERMES telecommunication system: https://rhizomatica.org/hermes .
To compile and install what every HERMES station needs (uucpd, uuxcomp, the helper scripts, the uucpd service and the modem's ALSA loopback routing), whichever radio controller drives the radio, run:
- make
- make install
On an sBitx, also install the name of its i2c bus, which either controller uses:
- make install_sbitx_hw
The radio controller is separate. hermes-radio-daemon has its own repository. For the old sBitx controller (sbitx_controller, sbitx_client, sbitx.service and /etc/sbitx), which cannot run alongside it, run:
- make trx_v2-userland
- make install_sbitx_controller
(make v2 and make install_v2 do all of the sBitx steps at once, as
before.)
If installing a station with Mercury, run:
- make install_mercury
Additionally, if installing in a gateway station, run:
- make install_gateway
Units go to /usr/lib/systemd/system and none is enabled. Change a station's uucpd options in /etc/default/uucpd, and anything else with a drop-in in /etc/systemd/system/.d/.
The Debian packaging builds two packages: uucpd, which has what every station needs, and sbitx-controller.
For building the HERMES version 1 (uBitx-based), run:
- make v1
To install v1, run:
- make install_v1
To compile the firmware for v1 radio, run:
- make trx_v1-firmware
To upload the firmware to the Arduino Nano based transceiver (v1), run:
- make ispload
The repository contains all sub-projects which compose the hermes network stack. Each entry in the list bellow contains a brief explanation of each directory in this repository.
Uuxcomp is a uucp uux wrapper to be used with postfix email transport. It compresses the email payload with xz and carries transcoding of specific formats, while also providing an rmail wrapper to decompress the content at destination host.
Rhizomatica's v1 µbitx-based radio transceiver Arduino Nano firmware.
Rhizomatica's v1 µbitx-based radio transceiver control utils.
Rhizomatica's v2 sbitx-based radio transceiver ATtiny85 firmware (experimental).
Rhizomatica's v2 sbitx-based radio transceiver control utils.
UUCPD is composed by a control daemon, uucpd, which transports uucp payload between uucico and the HF modem. It also contains uuport, a tool to be used in a uucico port in pipe mode to connect uucico to the uucpd daemon.
Core scripts which performance many different tasks in network orchestration, like email management and media transcoding.
System service files, like init files and udev rules.
Contains header common to more than one project.
Most of the code was written by Rafael Diniz rafael@rhizomatica.org with contributions by Carlos Paulino chgp@riseup.net.