Ero sivun ”Aprx” versioiden välillä

Radioamatööriwikistä
Siirry navigaatioon Siirry hakuun
>Oh2mqk
p (siirsi sivun ”APRX” uudelle nimelle ”Aprx”: ohjelmiston nimi on pienellä)
>Oh2mqk
(konfiguraatio suomennetuin kommentein)
Rivi 32: Rivi 32:
== Konfigurointi ==
== Konfigurointi ==
  #
  #
  # Sample configuration file for the APRX  -- an Rx-only APRS iGate
  # Esimerkkikonfiguraatio APRX ohjelmalle -- an Rx-only APRS iGate
# Tämä on tarkoitettu  /etc/aprx.conf  tiedostoksi.
  #
  #
#
# The  mycall  parameter:
# Station call-id used for relaying APRS frames into APRS-IS.
#
#mycall          N0CALL-1
# APRS-IS server name and portnumber.
# Every reconnect does re-resolve the name to IP address.
# There can be up to 4 system definitions without code modification,
# they are used in round-robin fashion.  Heartbeat and filter
# definitions must follow each server definition.
#
#aprsis-server    finland.aprs2.net 14580
#aprsis-server    rotate.aprs.net  14580
# Some APRS-IS servers tell every about 20 seconds to all contact
# ports that they are there and alive. Others are just silent.
# Enable only if the server you use does present heartbeat.
# Recommended value 3*"heartbeat" + some  -> 120 (seconds)
#
#aprsis-heartbeat-timeout  120
   
   
  # mycall parametri:
  # APRS-IS server may support some filter commands. Although this
  # Asemakutsumerkki jolla paketteja välitetään APRS-IS verkkoon.
  # program does not transmit out to RF, filter rules can be used to
  # Jokaisella ohjelman ajossa olevalla kappaleella pitää olla oma
# ensure that there is sufficient dataflow from APRS-IS server to
  # erillinen kutsumerkkinsä.
  # this program that it very likely will not timeout within network
  # monitoring timeout..
  #
  #
  #aprsis-filter "some filter specs in quotes"
  mycall          N0CALL-1
   
   
  # AX.25 filters block selected messages matching on selected regular
  # APRS-IS palvelimen nimi ja porttinumero
# expressions.  The expressions are case sensitive, and AX.25 address
# elements are in all uppercase text.  There can be unlimited number
# of patterns, type fields are four: "source", "destination", "via",
# and "data".  These patterns can be used in addition to built-in
# hard-coded reject rules listed in documentation.
  #
  #
  #ax25-filter source      "^NOCALL"
  aprsis-server    finland.aprs2.net 14580
#ax25-filter destination "^NOCALL"
#ax25-filter via        "^NOGATE"
#ax25-filter data        "^\\?"
   
   
  # ax25-rxport limits reception on listed AX.25 ports, if system
  # Jotkin APRS-IS palvelimet kertovat "sydämenlyöntiään" 20 sekunnin
  # happens to use AX.25 ports also for other purposes than APRS.
  # välein kaikkiin yhteyksiinsä. Toiset ohjelmistot ovat ihan hiljaa.
  # If this option is not used, all reception ports are accepted.
  # finland.aprs2.net kuuluu jutteleviin.
# Number of port definitions here is unlimited.
  #
  #
  #ax25-rxport ax0
  aprsis-heartbeat-timeout  120
#ax25-rxport ax1
   
   
  # rflog defines a rotatable file into which all RF-received packets
  # rflog defines a rotatable file into which all RF-received packets
Rivi 91: Rivi 58:
  #rflog /tmp/aprx-rf.log
  #rflog /tmp/aprx-rf.log
   
   
  # aprxlog defines a rotatable file into which most important
  # aprxlog määrittää kierrätettävissä olevan tiedoston, jonne
  # events on APRS-IS connection are logged, namely connects and
  # tärkeimmät APRS-IS serveriyhteyden tapahtumat kirjataan.
# disconnects.
  #
  #
  #aprxlog /tmp/aprx.log
  #aprxlog /tmp/aprx.log
   
   
  # erlangfile defines a mmap():able binary file, which stores
  # erlangfile  parametri määrittää binaaritiedoston, jonne kerätään
# running sums of interfaces upon which the channel erlang
  # käyttöastetilastoa ja josta aprx-stat apuohjelma käy sitä lukemassa.
  # estimator runs, and collects data.
  # Depending on the system, it may be running on a filesystem
# that actually retains data over reboots, or it may not.
# With this backing store, the system does not loose cumulating
# erlang data over the current period, if the restart is quick,
# and does not stradle any exact minute.
# (Do restarts at 15 seconds over an even minute..)
# This file is around 0.5 MB per each interface talking APRS.
# Things go BADLY WRONG if this file can not be created or
# it is corrupted!
  #
  #
  # Built-in default value is: /tmp/aprs-erlang.dat
  # Sisäänrakennettu oletusarvo: /tmp/aprs-erlang.dat
  #
  #
  erlangfile /tmp/aprx-erlang.dat
  erlangfile /tmp/aprx-erlang.dat
   
   
# erlang-loglevel is config file edition of the "-l" option
# pushing erlang data to syslog(3).
# Valid values are (possibly) following: NONE, LOG_DAEMON,
# LOG_FTP, LOG_LPR, LOG_MAIL, LOG_NEWS, LOG_USER, LOG_UUCP,
# LOG_LOCAL0, LOG_LOCAL1, LOG_LOCAL2, LOG_LOCAL3, LOG_LOCAL4,
# LOG_LOCAL5, LOG_LOCAL6, LOG_LOCAL7.  If the parameter value is
# not acceptable, list of accepted values are printed at startup.
#
#erlang-loglevel NONE
# erlang-log1min option logs to syslog/file also 1 minute
# interval data from the program. (In addition to 10m and 60m.)
#
#erlang-log1min
   
   
  # The  serialport  option.  Parameters are:
  # serialport  parametri.  Sen optiot ovat:
  #  - /dev/ttyUSB1    -- tty device
  #  - /dev/ttyUSB1    -- tty laite
  #  - 19200          -- baud rate, supported ones are:
  #  - 19200          -- portin nopeus
  #                        1200, 2400, 4800, 9600, 19200, 38400
  #                        1200, 2400, 4800, 9600, 19200, 38400
  #  - 8n1            -- 8-bits, no parity, one stop-bit,
  #  - 8n1            -- pakollinen vakio
#                        no other supported modes
  #  - KISS           -- pakollinen vakio
  #  - KISS/XORSUM/BPQCRC/SMACK/CRC16  -- KISS mode
  #
  #
  # There can be up to 16 serialport definitions in this file!
  # Sarjaporttimäärityksiä voi olla enintään 16 kpl.
  #
  #
#serialport  /dev/ttyS0    19200 8n1    KISS
  #serialport  /dev/ttyUSB1  19200 8n1    KISS
  #serialport  /dev/ttyUSB1  19200 8n1    KISS
   
   
  # Additional options for the "serialport" line.
  # netbeacon parametri.
  #
  # Lainausmerkeissä annetaan APRS sanomadata "sellaisenaan".
# "initstring" is of two parts, the keyword, and then a string.
  # Netbeacon:eiden enimmäismäärää ei ole rajoitettu.
  #   initstring "\xC0\xC0\xFF\xC0\r\nMO 0\rKISS $01\r"
#
#  "KISS"                  - plain basic KISS mode
#  "XORSUM" alias "BPQCRC" - KISS with BPQ "CRC" byte
#  "SMACK" alias "CRC16"  - KISS with better CRC
# The  netbeacon  option.
  # Parameter string (in quotes) is sent to network (without quotes)
# at varying intervals --  1200-1800 seconds in between restransmits.
# This interval is intentionally randomized.
# Multiple netbeacons are evenly distributed for each time period,
# or at least 3 seconds apart.  First netbeacon is sent to network
# 30 seconds after connection to APRS-IS.
#
# There can be multiple netbeacon options.
# Symbol  R&  is for "rx-only iGate"
  #
  #
  #netbeacon  "!6016.35NR02506.36E&aprx - an Rx-only 'iGate'"
  #netbeacon  "!6016.35NR02506.36E&aprx - an Rx-only 'iGate'"

Versio 3. tammikuuta 2008 kello 18.00

APRX on APRS-IS-Rx-iGate käyttöön tarkoitettu ohjelmisto jossa määräävänä suunnitteluperiaattena on ollut ns. "minimi-teknologia".

Ohjelmisto asennetaan sopivaan UNIX:in kaltaiseen systeemiin ja sen konfiguraatiotiedosto säädetään kohdalleen. Sitten se kykenee välittämään radiolta kuultuja APRS paketteja APRS-IS verkkoon.

Esimerkkejä sopivista laitteistoista mainitaan artikkelissa OH2RDY, vaikkakin kyseinen systeemi on kaksisuuntainen Rx/Tx-iGate.

Pelkkänä vastaanottimena toimivan Rx-iGate:n rakentaminen ei tarvitse automaattiaseman lupaa, vaan kuka tahansa voi sellaisen laittaa ajoon.


Ominaisuudet

Tämä ohjelmisto osaa mm. seuraavat asiat:

  • Ei tarvitse koneen sisäistä AX.25 protokollatukea, vaan toimii myös fyysisten sarjaporttien kanssa.
  • Kuuntelee ns. KISS-protokollaa puhuvia radiomodeemeja tavallisessa sarjaportissa (perinteisessä ja USB mallisessa, kunhan se on UNIXissa tuettua mallia - lähes kaikki ovat)
    • Tukea tarjotaan 16 sarjaportille yhdessä koneessa, määrä riittää useimmissa tapauksissa..
  • Linux-koneessa jossa on sisäinen AX.25 protokollatuki, kykenee kuuntelemaan kaikkien AX.25:een kytkettyjen porttien kautta tulevaa liikennettä
  • Tarvitsee minimaalisen apuohjelmistomäärän koneessa jossa sitä ajetaan, ei mitään AX.25 kirjastoja, ei widgettikirjastoja, threadeja, tai edes C++ ajoaikaisia kirjastoja muistitilaa viemässä.
  • Kytkeytyy yhdellä kutsumerkkiSSID:llä APRS-IS runkoverkkoon kaikkien radioporttiensa datan välittämiseksi.
  • Tietää että seuraavat tokenit AX.25:n osoitteen VIA-kentissä ovat merkki että pakettia ei pidä välittää APRS-IS verkkoon:
    • RFONLY, NOGATE, TCPIP, TCPXX
  • Tietää että seuraavat lähdeosoitteet ovat vääriä, eikä niitä saa esiintyä paketeissa, joten pakettia ei välitetä verkkoon:
    • WIDE*, RELAY*, TRACE*, TCPIP, TCPXX, NOCALL, N0CALL
  • On välittämättä kaikki kyselyviestit ("?")
  • Prosessoi "3rd-party" sanomat katsoen paketin sisään ja analysoiden siellä olevan osoitetiedon ja datan
  • Sisältää "Erlang monitori" mekanismin, joka kerää tietoa radiokanavan käyttöasteesta.

aprx(8) manuaalisivu (englanniksi)

Konfigurointi

#
# Esimerkkikonfiguraatio APRX ohjelmalle  -- an Rx-only APRS iGate
# Tämä on tarkoitettu   /etc/aprx.conf  tiedostoksi.
#

# mycall  parametri: 
# Asemakutsumerkki jolla paketteja välitetään APRS-IS verkkoon.
# Jokaisella ohjelman ajossa olevalla kappaleella pitää olla oma
# erillinen kutsumerkkinsä.
#
mycall           N0CALL-1

# APRS-IS palvelimen nimi ja porttinumero
#
aprsis-server    finland.aprs2.net 14580

# Jotkin APRS-IS palvelimet kertovat "sydämenlyöntiään" 20 sekunnin
# välein kaikkiin yhteyksiinsä.  Toiset ohjelmistot ovat ihan hiljaa.
# finland.aprs2.net kuuluu jutteleviin.
#
aprsis-heartbeat-timeout   120

# rflog defines a rotatable file into which all RF-received packets
# are logged.
#
#rflog /tmp/aprx-rf.log

# aprxlog määrittää kierrätettävissä olevan tiedoston, jonne
# tärkeimmät APRS-IS serveriyhteyden tapahtumat kirjataan.
#
#aprxlog /tmp/aprx.log

# erlangfile  parametri määrittää binaaritiedoston, jonne kerätään
# käyttöastetilastoa ja josta aprx-stat apuohjelma käy sitä lukemassa.
#
# Sisäänrakennettu oletusarvo: /tmp/aprs-erlang.dat
#
erlangfile /tmp/aprx-erlang.dat


# serialport  parametri.  Sen optiot ovat:
#   - /dev/ttyUSB1    -- tty laite
#   - 19200           -- portin nopeus
#                        1200, 2400, 4800, 9600, 19200, 38400
#   - 8n1             -- pakollinen vakio
#   - KISS            -- pakollinen vakio
#
# Sarjaporttimäärityksiä voi olla enintään 16 kpl.
#
#serialport   /dev/ttyS0    19200 8n1    KISS
#serialport   /dev/ttyUSB1  19200 8n1    KISS

# netbeacon  parametri.
# Lainausmerkeissä annetaan APRS sanomadata "sellaisenaan".
# Netbeacon:eiden enimmäismäärää ei ole rajoitettu.
#
#netbeacon  "!6016.35NR02506.36E&aprx - an Rx-only 'iGate'"

Jakelu

Ohjelmisto on saatavilla:

Noudettu kohteesta ”https://wiki.sral.fi/w/index.php?title=Aprx&oldid=1533”