search

rwth-afu / UniPager

Universal POCSAG transmitter controller written in Rust.
GNU General Public License v3.0
87 stars 26 forks source link
amateur-radio ham-radio pocsag rust

readme

UniPager

Build Status GitHub issues GitHub release

Universal POCSAG transmitter controller written in Rust.

Automatic Installation

This script installs UniPager fully automatically on Debian/Raspbian systems. It also uninstalls RustPager and migrates the old configuration file.

# Via HAMNET
curl http://db0sda.ampr.org/debian/install.sh -sSf | sh -s -- hamnet

# Via Internet
curl http://www.afu.rwth-aachen.de/debian/install.sh -sSf | sh -s -- internet

Configuration

The web interface for configuration is available on port 8073. Port 8055 must also be open to allow websocket communication between the browser and UniPager.

Raspberry Pi

Make sure that the serial port is activated. To do this add enable_uart=1 to /boot/config.txt, remove console=ttyAMA0,115200 from /boot/cmdline.txt and reboot.

This is not needed for the RASPAGERV1 and Audio transmitter type.

Update

Once the package is installed, you can install updates as for every other debian package with the following commands:

sudo apt-get update
sudo apt-get upgrade

Manual Installation from HAMNET

Create the file /etc/apt/sources.list.d/unipager.list with the following content:

deb http://db0sda.ampr.org/debian unipager main
deb-src http://db0sda.ampr.org/debian unipager main

Then execute the following commands:

wget -O - http://ci.db0sda.ampr.org/debian/rwth-afu.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install unipager

Manual Installation from Internet

Create the file /etc/apt/sources.list.d/unipager.list with the following content:

deb http://www.afu.rwth-aachen.de/debian unipager main
deb-src http://www.afu.rwth-aachen.de/debian unipager main

Then execute the following commands:

wget -O - http://www.afu.rwth-aachen.de/debian/rwth-afu.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install unipager

Local Compilation from source

Install rust:

curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly

Now reboot OR log out to make the rust toolchain available.

Log in again and clone the source:

git clone https://github.com/rwth-afu/UniPager.git

If this command fails, you may need to install git and try again:

sudo apt-get install git

Start the build:

cd UniPager
cargo build --release

The compiled binary will be created at ./target/release/unipager.

Be aware: Must be run with root privileges for GPIO access. Secondly it may be required to disable Bluetooth on newer Raspberry Pi models to make the GPIO UART usable.

Local Cross Compilation from source

Install rust:

curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly

Install the GCC cross compiler:

sudo apt-get install -qq gcc-arm-linux-gnueabi # for soft float
sudo apt-get install -qq gcc-arm-linux-gnueabihf # for hard float

Define the target:

# ARMv6 with soft float
export TARGET="arm-unknown-linux-gnueabi"

# ARMv6 with hard float (e.g. Raspberry Pi 1)
export TARGET="arm-unknown-linux-gnueabihf"

# ARMv7 with hard float (e.g. Raspberry Pi 2 and 3)
export TARGET="armv7-unknown-linux-gnueabihf"

Install the cross-compiled rust libraries:

rustup target add $TARGET

Create the file ~/.cargo/config with the following content:

[target.arm-unknown-linux-gnueabi]
linker = "arm-linux-gnueabi-gcc"

[target.arm-unknown-linux-gnueabihf]
linker = "arm-linux-gnueabihf-gcc"

[target.armv7-unknown-linux-gnueabihf]
linker = "arm-linux-gnueabihf-gcc"

Clone the source:

git clone https://github.com/rwth-afu/UniPager.git

Start the build:

cd UniPager
cargo build --target $TARGET --release

The cross-compiled binary will be created at ./target/$TARGET/release/unipager.

Manual Installation after compilation

Move the UniPager binary to /usr/local/bin/unipager. Create the directory /var/lib/unipager. Create the file /etc/systemd/system/unipager.service with the following content:

[Unit]
Description=UniPager POCSAG transmitter controller
After=network.target

[Service]
ExecStart=/usr/local/bin/unipager
WorkingDirectory=/var/lib/unipager

[Install]
WantedBy=multi-user.target

Reload systemctl configuration with sudo systemctl daemon-reload. To start UniPager enter sudo systemctl start unipager. To start UniPager automatically after booting enter sudo systemctl enable unipager.

Authors

Author and Maintainer

Contributors

License

UniPager
Copyright (C) 2017-2021  RWTH Amateurfunkgruppe

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.