Ero sivun ”RViesti client” versioiden välillä
>Oh7lzb |
>Oh7lzb |
||
Rivi 32: | Rivi 32: | ||
[http://he.fi/pocsag/Ham-RViesti-Client-1.00.tar.gz Ham-RViesti-Client-1.00.tar.gz] | [http://he.fi/pocsag/Ham-RViesti-Client-1.00.tar.gz Ham-RViesti-Client-1.00.tar.gz] | ||
== Viestin lähettäminen == | |||
$ rviesti oh7lzb '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 | |||
Pudota testaukseen tarkoitettu -d (debug) vipu pois, niin ohjelma ei tuumaile niin paljoa. -f parametrilla voit kertoa ohjelmalle sen konfiguraatiotiedoston sijainnin. | |||
== Lisädokumentaatiota == | == Lisädokumentaatiota == |
Versio 2. helmikuuta 2011 kello 08.01
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 oh7lzb '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
Pudota testaukseen tarkoitettu -d (debug) vipu pois, niin ohjelma ei tuumaile niin paljoa. -f parametrilla voit kertoa ohjelmalle sen konfiguraatiotiedoston sijainnin.
Lisädokumentaatiota
Client-moduli on dokumentoitu perldoc-metodilla, eli 'perldoc Ham::RViesti::Client' tulostaa APIn dokumentin (modulin asentamisen jälkeen).