RNET toistinasemalinkitys RNET-noden softa-asennusohjeet yms. v.0.4 2010-01-02 OH2LAK ja OH3BK Thelinkbox-softa """""""""""""""" Linkityksen paikallissolmuna toimii Thelinkbox-softa, johon voidaan liittää max 32kpl radioportteja joko sarjaportti/äänikortti, lpt-portti/äänikortti tai USB-audiodongle (C108) -liitäntärajapinnalla. Liitäntärajapinta sisältää audiotiet radiolle ja radiolta, sekä PTT-ohjaukset ja SQL-tunnistuksen. Tarvittaessa voidaan käyttää myös Thelinkboxin omaa VOXia, jolloin kohinasalpatietoa ei tarvitse välittää radiolta. Liikenne RNET-verkkoon ja palvelimiin hoituu openvpn-yhteyden kautta, joten koneessa on syytä olla openvpn asennettuna (löytyy eri distribuutioille eri asennustyökalujen kautta, apt-get install openvpn, yum install openvpn jne.) Erik OH2LAK (lakki@iki.fi) toimittaa openvpn-avaimet ja konfiguraatiotiedostot, ota yhteyttä mikäli sinulla ei niitä vielä ole! Asenna ensin openvpn ja avaimet ------------------------------- Debian: apt-get install openvpn cd /etc/openvpn siirrä Erikin toimittamat avaimet tähän hakemistoon tar -xzvf rnet_.tgz Fedora Core: yum install openvpn cd /etc/openvpn siirrä Erikin toimittamat avaimet tähän hakemistoon tar -xzvf rnet_.tgz Käynnistä openvpn ----------------- /etc/init.d/openvpn start Asenna alsa ----------- Debian: apt-get install alsa-base apt-get install alsa-utils apt-get install libesd-alsa0 Näistä voi olla apua äänten saamiseksi toimintaan: http://linuxhelp.blogspot.com/2006/10/steps-to-get-audio-to-work-in-debian.html Fedora Core: yum install alsa-base yum install alsa-utils yum install libesd-alsa0 Asenna thelinkbox ----------------- Debian: Hae uusin paketti täältä: http://pakettiradio.net/downloads/ Siirry hakemistoon, minne Ãlatasit paketin, ja anna komento: dpkg -i thelinkbox_0.xy-z_i386.deb Konfiguraatiotiedostojen esimerkeissä on yleensä oletettu softan sijaitsevan Fedoran käytännön mukaisessa hakemistossa /opt/thelinkbox. Debianin käytännön mukaan varsinainen softa asentuu /usr/sbin-hakemistoon (/usr/sbin/thelinkbox), konfiguraatiotiedostot taas /etc/thelinkbox-hakemistoon (/etc/thelinkbox/*.conf ja /etc/thelinkbox/*.cmds). Muista muuttaa konfigurointitiedostoja vastaavasti! Fedora Core: Fedoralle ei toistaiseksi löydy valmiita paketteja. Asennus pitää tehdä sorsista: Käännä thelinkbox; -Pura thelinkbox-n.nn.tgz sopivaan paikkaan -Konfiguroi paketti; ./configure --prefix=/opt/thelinkbox --enable-usb -/opt/thelinkbox -polku on ajateltu oletukseksi tuolle, muutakin voi käyttää mutta isommassa jakelussa olevat konfiguraatiotiedostot olettavat softan olevan tuolla -Käännä paketti; make -Asenna paketti; make install Samat ohjeet pätevät pääpirteittäin asennettaessa sorsista mihin hyvänsä jakeluun. Konfiguroi thelinkbox --------------------- RNET_configuration_files -hakemistossa on RNET-käyttöön toimivia esimerkkikonfiguraatioita, muokkaa omia tietoja vastaavaksi. Näissä tiedostoissa määritellään mikä on liitäntärajapinta radioon, kutsumerkit yms. RNET-noden kutsumerkki-ideologia on ajateltu olevan KUTSUMERKKI_Paikka_Taajuus, esim OH2RCH_Kauniainen_1297.125MHz Tällä tunnisteella node kirjautuu serverille, joten kaikkien olisi hyvä olla yhdenmukaisia. Konfiguraatiotiedostot ovat oletuksena /opt/thelinkbox/etc -hakemistossa (Debian-paketeista asennettaessa /etc/thelinkbox-hakemistossa). Oletuksena thelinkbox käyttää globaalia konfigurointitiedostoa tlb.conf, jossa on sitten porttikohtaiset määritykset ja osoitukset porttien konfigurointitiedostoihin. Ks. esimerkit! Testaa thelinkbox ----------------- Testaamiseen ilman yhteyttä RNEt-palvelimiin ei openvpn vielä tarvita, mutta hyvä se olisi jo olla tässä vaiheessa. RNET-palvelin sijaitsee osoitteessa 10.36.99.1, mikäli sinne ei pingi kulje, ei openvpn ole auki tai sitten sitä ei ole asennetukaan :) Ks. yllä mistä saat tarvittavat konfiguraatiot openvpn-käyttöön! Softan asennuttua paikalleen, sen testaus onnistuu käynnistämällä se debug-vivulla sekä osoituksella konfiguraatiotiedostoon (-f ./etc/tlb.conf); Debian: root@tracker:/etc/thelinkbox# /usr/sbin/tlb -d -f /etc/thelinkbox/tlb.conf Fedora Core: root@juhanila:/opt/thelinkbox# ./libexec/tlb -d -f ./etc/tlb.conf Debug kertoo ruudulle seuraavanlaisia juttuja: thelinkbox Version 0.26 compiled Mar 10 2008 20:45:53 13:11:06 thelinkbox V 0.26 compiled Mar 10 2008 20:45:53 initializing 13:11:06 EndPointInit: Initializing OH2RCH_Juhanila port 13:11:06 EndPointInit: called, TxKeyMethod: 5, RxCosMethod: 7 13:11:06 UsbInit: found USB device @ 1-1 13:11:06 UsbInit: USB audio device for OH2RCH_Juhanila is /dev/dsp2 13:11:06 Fragsize: 256, fragstotal: 5, bytes: 1280 13:11:06 EndPointInit: returning 0 Mikäli kohinasalpatunnistukset ovat oikein, radion kohinasalvan aukeaminen ja sulkeminen aiheuttaa ruudulle rivejä josta ilmenee että kohinasalpa aukeaa ja sulkeutuu Jos kaikki on ok, sulje ohjelma CTRL-C:llä tai ajamalla /etc/init.d/thelinkbox stop. Käynnistä thelinkbox uudelleen ilman debug-vipua ------------------------------------------------ Debian: /etc/init.d/thelinkbox start Fedora Core: root@juhanila:/opt/thelinkbox# ./libexec/tlb -f ./etc/tlb.conf Jos uudelleenkäynnistys ei onnistu, poista pid-tiedosto: rm /var/run/tlb.pid thelinkbox Version 0.26 compiled Mar 10 2008 20:45:53 Becoming a Daemon ... Softa käynnistyy daemonina ja menee tausta-ajoon. Tämän jälkeen voidaan tutkia thelinkboxin toimintaa sen oman komentokäyttöliittymän, tlbcmd, kautta; root@juhanila:/opt/thelinkbox# ./bin/tlbcmd <---- tlbcmd asuu /opt/thelinkbox/bin -hakemistossa (Debian: /usr/sbin/tlbcmd) tlbcmd Version 0.26 compiled Mar 10 2008 20:46:11 tlb> stats <---- stats -komento kertoo noden perustilan Uptime: 4 minutes and 29 seconds Tx packets: 0, 0.00 Mbytes Rx packets: 0, 0.00 Mbytes Connections: 0 Users: 0 of 2 Max Bandwidth Tx: 0 Kbps, Rx: 0 Kbps Peak users: 0, Peak Tx bandwidth: 0 Kbps @ Peak Rx bandwidth: 0 Kbps @ tlb> users <---- users -komento kertoo nodessa kytkeytyneenä olevat käyttäjät tlb> connect -a -r 10.36.99.1 <---- muodostetaan yhteys RNET-palvelimeen. -a sekä -r -vivut ovat tärkeitä, koska RNET-liikenne on ADPCM (-a) RTP-protokollalla (-r) Connecting to "10.36.99.1". tlb> users <---- yhteyden onnistuttua, users-komento kertoo kytkeytyneet käyttäjät; C=Conference P=Persistent connection 1=RTP protocol a=ADPCM protocol 1. *RNET_Primary* CP1a tlb> link <---- Oletuksena (konfiguraatiotiedostossa kyllä mahdollista -> TODO Port mapping: Ei RF-portti/portit ole kytketty voip-porttiin vaan kytkentä pitää tehdä *RNET_Primary*: none käsin; OH2RCH_Juhanila: none tlb> link *RNET_Primary* OH2RCH_Juhanila <---- Linkityksen kytkentä. linking OH2RCH_Juhanila to *RNET_Primary* tlb> link <---- Linkityksen toteaminen. Tähän pitää taikoa automatiikka jotta Port mapping: Linkityksiä ei tarvitse nostaa käsin pystyyn bootin jälkeen. *RNET_Primary*: OH2RCH_Juhanila OH2RCH_Juhanila: *RNET_Primary* tlb> id <---- Force CWID to RF ports, nyt siis pitäisi kuulua konfiguraatio- tiedostossa määritelty CWID radiosta mikäli audiotiet ja PTT-ohjaus ovat OK Mölinä radiosta pitäisi mennä nyt myös siis RNET Primary Net -kanavalle ja sitä kautta siihen kytkeytyneille nodeille, samoin liikenteen verkosta pitäisi tulla radiolle. Pura thelinkbox-pcm.tgz -paketti /opt/thelinkbox -hakemistoon(Debian: /etc/thelinkbox-hakemistoon) niin kytkennöistä ja muista komennoista tulee audio-indikaatiot. Äänet voisi tehdä uudelleen paremmin jossain kohtaa Virhekoodit ----------- 0 - Command executed without error 200001 - command not found or ambiguous 200002 - command requires disk and disk is disabled 200003 - Specified station not found 200004 - no info available for station (.info cmd) 200005 - invalid command argument count 200006 - Already connected (.connect cmd) 200007 - no one is talking (.mute cmd) 200008 - invalid command argument 200009 - error opening a file 200010 - Chat text 200011 - Timeout waiting for response from tbd. 200012 - Chat text sent TODO: ----- Audiotasojen vakiointi ja kalibrointi Uudet audiopromptit Automaattiskriptit yhteyden automaattiseen luontiin Konfiguraatiotiedostojen läpikahlaus DTMF-komentojen yms osalta. Thelinkbox sisältää toistinasemalogiikan ominaisuudet, joten sen voisi periaatteessa kytkeä suoraan fullduplex-radioon. -> Testattava!