ipsc2hbpc/INSTALL.md

Installation

ipsc2hbpc is a single C binary with no external dependencies — it links only against the C standard library. Tested on Debian/Ubuntu; adapt paths for other distros.

Requirements

• A C11 compiler (gcc or clang) and make
• git

That's it. There is no Python, no venv, no pip, and no third-party libraries. The TOML parser, SHA-1/SHA-256/HMAC, the event loop, and the DMR DSP/FEC code are all included in the repository and compiled into the binary.

1 — Clone and build

git clone https://github.com/n0mjs710/ipsc2hbpc.git
cd ipsc2hbpc
make

This produces the ipsc2hbpc binary in the repo root.

2 — Run the self-tests (optional but recommended)

make test

This validates the DMR DSP/FEC core against golden vectors, checks the translator output byte-for-byte against the reference implementation, and replays traffic captured from a MOTOTRBO repeater and HBlink3.

3 — Install (as root)

sudo make install

This follows the usual system conventions:

Item	Destination
binary	/usr/local/bin/ipsc2hbpc
config	/etc/ipsc2hbp/ipsc2hbp.toml
sample	/etc/ipsc2hbp/ipsc2hbp.toml.sample
service	/lib/systemd/system/ipsc2hbpc.service

The service runs as root. Install paths are overridable (make install PREFIX=/usr SYSCONFDIR=/etc UNITDIR=/etc/systemd/system).

Your live config is never clobbered. make install writes /etc/ipsc2hbp/ipsc2hbp.toml only if it does not already exist; on every run it refreshes ipsc2hbp.toml.sample next to it. Re-running sudo make install after a git pull updates the binary and unit while leaving your config untouched.

4 — Configure

Edit /etc/ipsc2hbp/ipsc2hbp.toml for your IPSC and HBP settings. The file format is identical to the original Python ipsc2hbp — an existing ipsc2hbp.toml can be copied in unchanged.

You can test against the config manually before enabling the service:

/usr/local/bin/ipsc2hbpc -c /etc/ipsc2hbp/ipsc2hbp.toml --log-level DEBUG

Hit Ctrl-C to stop.

IMPORTANT — if the original Python ipsc2hbp is running on this host: The two cannot share the IPSC UDP port or the upstream HBP connection. Stop and disable the Python service before starting ipsc2hbpc:

sudo systemctl stop ipsc2hbp
sudo systemctl disable ipsc2hbp

The C unit declares Conflicts=ipsc2hbp.service, so systemd will also refuse to run both bridges at once.

5 — Enable the service

sudo systemctl enable --now ipsc2hbpc

6 — Check the logs

journalctl -u ipsc2hbpc -f

Updating

git pull
make
sudo make install          # updates binary + unit, preserves your config
sudo systemctl restart ipsc2hbpc

Uninstalling

sudo make uninstall        # removes binary + unit; leaves /etc/ipsc2hbp intact

Development runs

When working in the cloned repo, run the freshly built binary against a local config without installing:

make
./ipsc2hbpc -c ipsc2hbp.toml --log-level DEBUG