Benutzer-Werkzeuge

Webseiten-Werkzeuge


unipagerenglish

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

unipagerenglish [2019/10/30 00:28] (aktuell)
oe7bsh angelegt
Zeile 1: Zeile 1:
 + ​====== UniPager ======
  
 +===== Intro =====
 +
 +
 +Thomas Gatzweiler, DL2IC, wrote in [[https://​www.rust-lang.org|rust]] a software, which allows to use unipager on all hardware variants and also provides a webinterface.
 +
 +===== Installation =====
 +
 +You can choose between two methods: The first one uses a script provided by the DAPNET-crew ("rund and forget), the second one uses a dapnet repository.
 +==== method one - script ====
 +=== via HAMNET ===
 +<​code>​curl http://​db0sda.ampr.org/​debian/​install.sh -sSf | sh -s -- hamnet</​code>​
 +=== via internet ===
 +<​code>​curl http://​www.afu.rwth-aachen.de/​debian/​install.sh -sSf | sh -s -- internet</​code>​
 + 
 +==== method two - repository ====
 +=== via HAMNET ===
 +Create ///​etc/​apt/​sources.list.d/​unipager.list//​ with this content:
 +<​file>​
 +deb http://​db0sda.ampr.org/​debian unipager main
 +deb-src http://​db0sda.ampr.org/​debian unipager main
 +</​file>​
 +
 +Then execute the following commands:
 +<​code>​
 +wget -O - http://​db0sda.ampr.org/​debian/​rwth-afu.key | sudo apt-key add -
 +sudo apt-get update
 +sudo apt-get install unipager
 +</​code>​
 +=== via internet ===
 +
 +Create ///​etc/​apt/​sources.list.d/​unipager.list//​ with this content:
 +<​file>​
 +deb http://​www.afu.rwth-aachen.de/​debian unipager main
 +deb-src http://​www.afu.rwth-aachen.de/​debian unipager main
 +</​file>​
 +Then execute the following commands:
 +<​code>​
 +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
 +</​code>​
 +
 +==== compiling the source code on your own ====
 +
 +The software is hosted at [[https://​github.com/​rwth-afu/​unipager|https://​github.com/​rwth-afu/​unipager]].
 +
 +You can use github to install the software (please also refer to the README):
 +<​code>​
 +git clone https://​github.com/​rwth-afu/​unipager.git
 +cd unipager
 +curl https://​sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly (installs the rust compiler)
 +cargo build --release (compiles UniPager)
 +sudo ./​install.sh (installs UniPager)
 +</​code>​
 +
 +**Please be aware that usage of UART is only possible with deactivated bluetooth interface in the raspberry pi**
 +
 +See: https://​www.raspberrypi.org/​documentation/​configuration/​uart.md
 +
 +
 +===== configuration and webinterface =====
 +
 +UniPager provides a HTTP_server on port 8073. The website shows the log, the type of transmitter and its settings. It also enables the user to config it.
 +
 +{{ :​unipager:​uni_webinterface.png?​direct |}}
 +
 +===== addresses for connecting to a dapnet-server =====
 +
 +Um Sender anzubinden, you can use as default db0sda. Please be aware, that the transmitter had to be added there before by an admin (please open a support ticket
 +
 +type     ​hostname ​    ​IP ​     Port
 +
 +Internet ​    ​dapnet.afu.rwth-aachen.de ​    ​137.226.79.100 ​    43434
 +
 +Hamnet ​    ​dapnet.db0sda.ampr.org ​    ​44.225.164.27 ​    43434
 +
 +===== Update =====
 +
 +If UniPager was installed via repository (method 2), you can use the package manager to update it as usual:
 +<​code>​
 +sudo apt-get update
 +sudo apt-get upgrade
 +</​code>​
 +
 +If the software was complied on your own, you can do a "git pull" for the latest version and compile it again. To update software and rust compiler, you can use  <​code>​./​update.sh</​code>​ in the UniPager directory. ​ The script updates the rust compiler and also the UniPager itself.
 +
 +===== testing version=====
 +
 +
 +There is also a testing version in the github repository, which can contain new features (but also bugs ;-) ).
 +Please use this version only if you know, that you are doing.
 +
 +
 +Change ///​etc/​apt/​sources.list.d/​unipager.list//​ :
 +
 +<​code>​
 +deb http://​www.afu.rwth-aachen.de/​debian unipager-testing main
 +deb-src http://​www.afu.rwth-aachen.de/​debian unipager-testing main
 +</​code>​
 +
 +Then do an update via package manager:
 +<​code>​
 +sudo apt-get update
 +sudo apt-get upgrade
 +</​code>​
 +
 +
 +===== access control =====
 +
 +access control is already implemented but will be improved: [[https://​github.com/​rwth-afu/​UniPager/​issues/​12|https://​github.com/​rwth-afu/​UniPager/​issues/​12]]
 +
 +===== sending a message direct via UniPager =====
 +Via Websocket-protocol and a script it is possible to send directly. See the code at [[https://​github.com/​dk4pa/​UniPager-SendWebsocket|https://​github.com/​dk4pa/​UniPager-SendWebsocket]].
 +
 +===== statistics=====
 +
 +With commit [[https://​github.com/​rwth-afu/​UniPager/​commit/​5120af3c2c2e2f6413f9cd9149b0985a0ff10b78|5120af3c]] were statistics added to UniPager. They provide information about status, time slots, message queue and number of sent messages.
 +{{::​unipager:​unipager_stats.png?​direct|}}
 +
 +Address for this JSON-object:​ http://​unipager_ip:​8073/​status
 +
 +
 +===== Port forwarding =====
 +
 +For external access you have to open ports 8073 and 8055 in your firewall/​forward it in your router. Please configure an access control before (see below)
 +
 +===== password for webinterface =====
 +
 +To protect the webinterface,​ create the file ''/​var/​lib/​unipager/​password''​ an and add the password there.
 +
 +===== logfile UniPager on a Raspi =====
 +
 +Can be accessed with "sudo journalctl -u unipager"​.
 +
 +===== configuration of USB-sound devices =====
 +
 +At the beginning lookup the ID of the sound device: <​code>​cat /​proc/​asound/​cards</​code>:​
 +
 +<​code>​
 +0 [ALSA ]: bcm2835 - bcm2835 ALSA
 +bcm2835 ALSA
 +1 [Device ]: USB-Audio - USB Audio Device
 +C-Media Electronics Inc. USB Audio Device at usb-3f980000.usb-1.4,​ full speed
 +</​code>​
 +
 +In the example above the usb-sound device has the ID 1, so you enter in the UniPager configuration ​ <​code>​plughw:​1</​code>​.
 +
 +===== troubles with internal raspberry sound card =====
 +
 +In rare cases troubles (sometimes with pi1 and pi2) with the output level can occur. Then please use an external sound device (see above).
unipagerenglish.txt · Zuletzt geändert: 2019/10/30 00:28 von oe7bsh