javAPRSSrvr User's Guide
Contents
1. VAN SSID 15 NUMBERED Van WATER station Flooding xAPRS Unix YAGI QTH Skywarn Shelter evacuation W Overlay Fog reserved Stream Switch reserved Stream Switch 112. NUMBERED NWS site NWS options HELO SSID 6 Pharmacy Rx Apothicary YACHT sail SSID 5 WinAPRS Jogger Wall Cloud TRIANGLE DF station MAIL PostOffice was PBBS LARGE AIRCRAFT NUMBERED Aircraft WEATHER Station blue NUMBERED WX site green digi Dish Antenna Rain AMBULANCE SSID 1 ARRL Overlays ARES A WinLINK W BIKE SSID 4 Blowing Dust Sand Incident Command Post NEW Civil Defense Overlays RERACES C CERTS Dual Garage Fire dept DX spot by callsign HORSE equestrian Sleet FIRE TRUCK SSID 3 Funnel Cloud Glider Gale Flags HOSPITAL HAM store IOTA islands on the air Indoor BOXn digipeater w overlay JEEP SSID 12 WorkZone Steam Shovel TRUCK SSID 14 SUV new 29 June 2004 Logged on laptop Jan 03 Area Locations box circles etc Mic E Repeater Value Signpost 3 digit display Node NUMBERED TRIANGLE EOC small circle ROVER puppy or dog Partly Cloudy GRID SQ shown above 128 m ANTENNA like Radio station Restrooms SHIP pwr boat SSID 8 NUMBERED SHIP boat top view TRUCK STOP Tornado TRUCK 18 wheeler NUMBERED TRUCK
3. This reduces the possibility of TNC overruns This should be set to 900 for D STAR radios SeriallnitFile This defines file that is sent as is to the TNC after the port is opened This may be a file in the javAPRSSrvr directory or a fully qualified path to a file elsewhere on the computer Serial Port Parameters PortClassName RAFIntf This is the name of the serial port class Use this parameter to specify the name of the serial port class It defaults to the Random Access File interface SerialPortName This is the name of the serial port This supersedes DSTARPortName and is used by the serial port class If not specified it is set to DSTARPortName Serial to TCP Port Parameters SerialToTCPPorts R List This is the list of TCP IP port s that will be listened to for a direct connection to the serial port This is a bidirectional unguarded no security port that allows a direct connection to the serial port This is to be used with care as there is no flow control DSTAR D STAR General Parameters DSTARPortName deprecated This is the file name of the serial port Most Linux Unix derivatives use dev ttySO for the first serial port Windows uses COM for the first serial port DSTAREchoToRF false R This sets whether to echo the DSTAR converted posit to RF This parameter is only effective if GateGateToRF true This parameter determines if posits created from remote DSTAR radios in GPS mode are t
4. Il Dot V Waypoint Destination D7 D700 0 circle obsolete Wi Overlayed CIRCLE E I IRLP Echolink A TBD these were all 1 2 TBD numbered circles 2 3 TBD looking like billiard 3 14 TBD balls until we came 4 Si TBD up with Overlays V 6 TBD Now they are all 6 7 TBD available for new 7 8 TBD definitions 8 9 TBD 9 Gas Station blue pump ie FIRE A Hall Campground Portable ops Ig Park Picnic area I lt Motorcycle SSID 10 lt ADVISORY RAILROAD ENGINE Je I gt CAR SSID 9 gt NUMBERED CAR 1 SERVER for Files INFO Kiosk Blue box with HC FUTURE predict dot HURICANE Trop Storm A Aid Station A NUMBERED BOX B BBS or PBBS B Blowing Snow IC Canoe C Coast Guard D D Drizzle E EYEBALL Eye catcher E Smoke F Farm Vehicle tractor NEW F Freezing rain IG Grid Square 6 digit G Snow Shower H HOTEL blue bed symbol H Haze H Tcplp on air network stn l Rain Shower IJ J Lightening K School K Kenwood HT W L Logged on PCuser Jan 03 L Lighthouse M MacAPRS M N NTS Station N Navigation Buoy JO BALLOON SSID 11 O Rocket new June 2004 P Police P Parking Q TBD Q QUAKE R REC VEHICLE SSID 13 R Restaurant IS SHUTTLE S Satellite Pacsat IT SSTV T Thunderstorm JL BUS SSID 2 U SUNNY 10 XYZ PRIMARY SYMBOL TABLE ATV SECONDARY SYMBOL TABLE VORTAC Nav Aid National WX Service Site
5. hubs where you want to connect to first aprs net and second aprs net port 1313 hubs first aprs net 1313 second aprs net 1313 Or you could have the following 2 lines in hubs Ist first aprs net 1313 second aprs net 1313 You would then put the following line in your configuration file hubs hubs Ist R at the beginning of the parameter description means that the parameter can be changed on the fly from the console with either the S or R commands javAPRSI Gate Parameters TNCModule This must be set to DSTARInterface Set to TNCModule DSTARInterface TNCIFieldMax 256 R This sets the maximum information field length for packets gated to RF Modify this only if there is an absolute requirement Some TNC s break if they send or receive packets with more than 256 octets in the information field TNC General Parameters TNCPortinit This defines a command line to be run before opening the TNC port This may be a single command or a batch script file In Linux be sure to prefix a script file with so the file is executed Also be sure to have execute rights for the desired script and programs TNCPortlnitWait true This determines whether the interface should wait for the TNCPortlnit command to complete before continuing Set this to false if you are running a program which will remain operational after TNC initialization TNCSpeed 1200 This sets pacing for the TNC interface Set this to the RF speed of the TNC
6. DSTARInterface User s Guide 2 3b08 DSTARInterface is Copyright 2009 Pete Loveall AE5PL pete ae5pl net Use of the software is acceptance of the agreement to not hold the author or anyone associated with the software liable for any damages that might occur from its use APRS is a trademark of Bob Bruninga Other trademarks included in the following text are recognized as belonging to the respective trademark holders Table of Contents SECHOM EH tee Tiet e DEENEN Section 2 Program Requirements and Description Section 3 Configuration EEN javAPRSIGate Parameters E TING MOOUIGScctsescttat ite a e deel E EE TNC General Param Cte rs iiiiccciscisssiscustevevewsvenniuwe EEN ONE ENNEN ON ENNEN ONT ENNER Counientdawevensieutabuddeusaeweinueaeus TNO 2 le EE TNCPorthnitWaitatrue oo ccc ccccccccccccceccssueceseeeseeueseeueuseueeeseceueeeueueueueueueueueesueeueuaueueuaueesuaeeesuaess WING SOCCG 1200 EE SOTA MMU EE Serial PO Parameters en aeee ee E EL EE EEE EEEE EEEL E EE E E a A E A A Fetter Nae PAINE a e eege EE el Ol LIN GMS EE Serial to TCP Port Parameters 00 ccccccccsescecsesceceeseeceeseeeeeeeeeeaeensuaueneueuenueeaneeeeeneasaeneasesnensesneeeas Sra POU e EEN DSTAR D STAR General Parametere DSTARPortName acces codteee inch ude vecasretencataed nes vaca race iui vince inti naurna cncs ined tea Cael bucaamtd recall umcuiatianccinelueds DS FAREGIIG TOR EE EE ET Eeer Aneesh teeing teased ba pets teeancht eeueitninsbasaip
7. andard trackers Only the GPRMC and GPGGA strings are supported other GPS strings are ignored DSTAR callsigns are trimmed leading and trailing spaces are eliminated and imbedded space s are converted to a hyphen the DSTAR radios do not support hyphens in the callsign This allows a standard SSID configuration The GPS message is also trimmed of all leading and trailing spaces The CRCxxxx packet format is compatible with the Icom GPS A mode This is the same format used by radios in that mode Packets received from an Icom radio in GPS A mode will be gated to APRS IS once per transmission Like GPS mode GPS A mode sends positions continuously while transmitting voice so only the first packet in a transmission is gated Section 3 Configuration Parameters The configuration parameters reside in a configuration file which by default is called javaprssrvr cfg You can use any text file if you pass the name into javAPRSSrvr as a command line parameter The parameters are CASE SENSITIVE Defaults are shown below NOTE UNLESS YOU REQUIRE A SETTING OTHER THAN THE DEFAULT DO NOT INCLUDE ANY PARAMETERS WITH DEFAULT SETTINGS List parameters may be defined on the line or may be defined in a text file If defined on the line each entry is separated by a semicolon If defined in a file each entry is put on a separate line Do not put blank lines in the file The file must have the extension Jet For instance this would be the definition for
8. ebi Een Eege Section 4 Recommended Configurations REENEN Section 5 Installation Instructions vice censasieassursnrn sin canisrinsn sini casinninitsasinnianiarwsipuntusinia senna niasininl aa nania vate aparsarianianin geg d Section 6 Status Page EE Section Symp EE 10 Section 1 Introduction DSTARInterface was written to provide a universal interface between javAPRSIGate and a D STAR enabled radio with a low speed data port The DSTARInterface source code is published for use by other developers to work with the javAPRSIGate TNClInterface 2 0 javAPRSIGate TOF rom TCP ap TNCinterface OST ARInteface Serial Port APRSIS Section 2 Program Requirements and Description DSTARInterface is designed to run on any OS with any recent Java Virtual Machine The interface requires the operating system and JVM to open the port in full duplex mode using a Java serial port interface DSTARInterface is comprised of a number of classes which Java looks at as objects The main class is DSTARInterface This class is called at startup sets parameters and begins execution of the different support threads DSTARInterface works in conjunction with the javAPRSIGate TNCInterface to provide full bidirectional communication with the serial port All Gate logic is handled at in javAPRSIGate which leaves the DSTARInterface to concentrate on formatting and sending packets to the TNC log ports DSTARInterface gates to and from the radio usin
9. g standard TNC2 format strings This allows remote APRS clients to operate as if they were connected toa TNC All APRS packets have a CRC sequence added to the beginning of the line to reduce packet corruption The same algorithm technique used in computing the D STAR RF header FCS is used for the TNC2 lines The CRC string is stripped from line before gating to APRS IS The line is of the format CRCxxxx AE5PL gt APRS rest of packet DSTARInterface also converts the ICOM GPS mode transmissions into an APRS posit The first four letters of the GPS message are interpreted as a symbol per Appendix 2 of the APRS specification A checksum xor ed from zero prefixed by an asterisk is required in the GPS message To simplify setting the GPS message use the D PRS Calculator at http www aprs is net dprscalc htm You must have JavaScript enabled in your browser to use that page The first three letters of the message are used if they are separated from the rest of the text by a space total of 4 characters or there are only two or three letters in the message The first three characters are interpreted as the xyz part of the APRS GPSxyz destination call system as outlined in the APRS specification For instance the GPS message without quotes LK PETE IN TEXAS 17 would be interpreted as a truck symbol Note that a space is in the z position as well as another space in the fourth character position This allows the DSTAR radios to be used as st
10. o be echoed back to RF for remote APRS client use DSTARDupeDelay 10 R This sets the timeout for resetting the posit flood prevention The DSTAR radios continuously transmit their positions while the radio is transmitting digital voice This parameter forces the IGate to pass a single posit at the beginning of the voice transmission and then wait for another station s position or for the indicated time to lapse between voice transmissions from the same station Section 4 Recommended Configurations The following is an example of using a Linux script to initialize the port and TNC if required Note that these processes require root permission unless the permissions for the serial port are changed The script file must also have execute permissions javAPRSSrvr cfg lt snip gt TNCModule DSTARInterface TNCSpeed 900 lt snip gt Section 5 Installation Instructions DSTARInterface is included in all of the combined jar and exe files Simply add TNCModule DSTARInterface to activate it Icom radios running as trackers GPS enabled should have their callsign set to be callsign space s SSID The SSID is in the 8 character position last character The SSID may be any letter or number Due to future repeater design do not use A B C D G S zero or space See Section 2 regarding symbol interpretation for GPS mode radios DSTAR radios running as trackers should be configured to only pass RMC and GGA strings The radios
11. should be set to send to CQCQCQ for broadcast mode Section 6 Status Page DSTAR Posits Converted 0 Number of DSTAR GPS positions converted to APRS Section 7 Symbols The following table shows the xyz values and their respective symbols This table is derived from the table found at Bob Bruninga s web site If Z an overlay of 0 9 or A Z is allowed overlays only allowed for secondary symbols XYZ PRIMARY SYMBOL TABLE SECONDARY SYMBOL TABLE Police Sheriff EMERGENCY Le reserved had been rain Ne reserved DIGI white center NUMBERED STAR green PHONE Bank or ATM green box 1 DX CLUSTER amp HF GATEway amp Overlayed GATEway k Small AIRCRAFT SSID 7 V Crash site JI Mobile Satellite Station CLOUDY Wheelchair handicapped Firenet MEO MODIS Earth Obs NEW ip SnowMobile E SNOW Red Cross Church R Boy Scouts Girl Scouts l House QTH VHF House HF lls X i Ambiguous Plot Big Question mark
Download Pdf Manuals
Related Search