cats-igate

Reference CATS/FELINET I-gate/digipeater for the Raspberry Pi. Requires an I-Gate board: https://gitlab.scd31.com/cats/pi-hardware

Installing (Prebuilt Packages)

Download the .deb file for your Pi:

Pi Zero/1)

Pi 2/3/4/5

Once downloaded, the package can be installed with sudo dpkg -i FILENAME.deb, where FILENAME.deb is the file you downloaded.

Configuring

First of all, the SPI bus must be enabled on the Pi. It's disabled by default and is required to communicate with the hardware. This can be enabled in the raspi-config utility under "Interface Options". After enabling, restart the Pi.

The configuration for the I-gate lives in /etc/cats_igate/config.toml. Make sure to update this before using the utility - most importantly, the callsign must be configured.

Usage

For debugging, a single command line option exists. Running cats-igate -x <freq> in a terminal will send out constant test packets (properly identified, of course) which is useful for diagnostics. Please don't run this on the main CATS frequency or it will utilize 100% of the channel! Also, make sure whichever frequency you choose is unused.

The I-gate ships with a service file, which allows it to run autonomously. To start the service, run sudo systemctl start cats-igate. To have the service automatically start at bootup, run sudo systemctl enable cats-igate.

Building From Source

You probably don't need to do this unless you're planning to change the code, or if you're having problems with the prebuilt binaries.

To build the software, you will need to install Rustup. You'll also need to install some dependencies:

sudo apt install git protobuf-compiler
cargo install cargo-deb

After these are installed, restart your terminal, or open a new one. Then run these commands:

git clone https://gitlab.scd31.com/cats/igate
cd igate
git pull
cargo deb

The resulting deb package will placed in target/debian/cats-igate_VERSION.deb. The package can be installed with sudo dpkg -i target/debian/cats-igate_VERSION.deb, replacing VERSION with whatever version and architecture was built.