Ero sivun ”RViesti client” versioiden välillä
>Oh7lzb |
>Oh7lzb |
||
Rivi 48: | Rivi 48: | ||
Pudota testaukseen tarkoitettu -d (debug) vipu pois, niin ohjelma ei tuumaile niin paljoa. -f parametrilla voit kertoa ohjelmalle sen konfiguraatiotiedoston sijainnin. | Pudota testaukseen tarkoitettu -d (debug) vipu pois, niin ohjelma ei tuumaile niin paljoa. -f parametrilla voit kertoa ohjelmalle sen konfiguraatiotiedoston sijainnin. | ||
Viestin pitäisi lähteä ilmoille kaikilta järjestelmään kytketyiltä lähettimiltä normaalisti n. 5-15 sekunnin kuluessa. Pitempien viestien lähettäminen kestää kuitenkin aikansa, joten jonotustilanteessa voi viestin perillemeno kestää pitempäänkin. | |||
== Lisädokumentaatiota == | == Lisädokumentaatiota == |
Versio 4. helmikuuta 2011 kello 18.59
Tällä 'rviesti'-nimisellä ohjelmalla voit lähettää tekstiviestejä R.Viesti - kaukohakuverkkoon. Ohjelman lisäksi tarvitset käyttäjätunnuksen R.Viesti -palvelimelle, joka välittää viestit edelleen lähetinasemille. Koska viestejä saavat näille radioamatöörilähettimille lähettää vain radioamatöörit, käyttäjätunnuksia ei saa luovuttaa ei-amatööreille.
Ohjelma on toteutettu Perl-kielellä, ja sen pitäisi toimia kaikissa käyttöjärjestelmissä, joille on olemassa perl-ohjelmointikielen tulkki (Linuxit, Unixit, MacOS 10, Windows, VMS, jne). Joihinkin Perl-tulkki pitää asentaa jälkikäteen.
Paketti sisältää myös perl-modulina toteutetun client-kirjaston Ham::RViesti::Client, jota käyttäen voit kätevästi toteuttaa itse viestejä lähettäviä ohjelmia.
Asennus Debian / Ubuntu Linux -ympäristöissä
sudo apt-get install libyaml-tiny-perl libjson-perl libwww-perl libdigest-hmac-perl mkdir inst && cd inst wget http://he.fi/pocsag/Ham-RViesti-Client-JNE (ks. linkki alla) tar xvfz Ham-RViesti-Client-*.tar.gz cd Ham-RViesti-Client-* perl Makefile.PL make make test sudo make install
Viimeinen komento kysyy pääkäyttäjän salasanan, asentaa client-kirjaston, sekä itse rviesti-ohjelman todennäköisesti polkuun /usr/local/bin/rviesti. Lisäksi tulee sinun kopioida tiedosto tools/rviesti.conf johonkin seuraavista paikoista:
- ~/.rviesti.conf
- eli omaan kotihakemistoosi piilotetuksi tiedostoksi, mikäli et halua tietokoneen kaikille käyttäjille oikeutta lähettää näitä viestejä omissa nimissäsi
- /usr/local/etc/rviesti.conf
- kaikkien koneen käyttäjien käytettävissä oleva "globaali" tiedosto
- /etc/rviesti.conf
- kuten edellä, globaali konfigi
Tiedostoon laitetaan mieleisellä tekstieditorilla oma kutsumerkki sekä R.Viesti -ylläpidolta saadut avaimet.
Uusin versio
Ham-RViesti-Client-1.00.tar.gz
Viestin lähettäminen
$ rviesti N0CALL 'Hello world!' -d rviesti: Reading YAML configuration from /home/hessu/.rviesti.conf ... Ham::RViesti::Client DEBUG initializing Ham::RViesti::Client DEBUG switching to next server: rv-api-1.rats.fi:8042 Ham::RViesti::Client DEBUG performing HTTP API request Ham::RViesti::Client DEBUG API HTTP call successful Ham::RViesti::Client DEBUG API call response decoded successfully Ham::RViesti::Client DEBUG API call response contains result: ok rviesti: Sent id rviesti.OH7LZB.1296626362.51766041.5572212 to oh7lzb
Parametriksi tulee siis vastaanottajan kutsu ja viesti. Vastaanottajaksi voi laittaa myös jakelulistan joka sisältää useita vastaanottajia, esim. @RNETOPSIT tms. Tai suoraan piippariin koodatun RIC-numeron vaikkapa testaillessa, mutta oikeassa käytössä suositellaan kutsu-numero-mäppäyksen tekemistä palvelimella, jotta piipparin käyttäjä voi helposti vaihtaa piipparinsa numeron yhdessä paikassa.
Pudota testaukseen tarkoitettu -d (debug) vipu pois, niin ohjelma ei tuumaile niin paljoa. -f parametrilla voit kertoa ohjelmalle sen konfiguraatiotiedoston sijainnin.
Viestin pitäisi lähteä ilmoille kaikilta järjestelmään kytketyiltä lähettimiltä normaalisti n. 5-15 sekunnin kuluessa. Pitempien viestien lähettäminen kestää kuitenkin aikansa, joten jonotustilanteessa voi viestin perillemeno kestää pitempäänkin.
Lisädokumentaatiota
Client-moduli on dokumentoitu perldoc-metodilla, eli 'perldoc Ham::RViesti::Client' tulostaa APIn dokumentin (modulin asentamisen jälkeen).