UserManual - D-Rats
Contents
1. UserManual Revision 53 2009 05 14 12 46 07 VK3UR Table of Contents T OVE eW sotone iein ra es wa sheteestsenttes R E E E E pa oahetdatts A nite EGS 2 1 1 Abo t this d c ment sosise Te EE EEE E suns SEE SEEE SSE 2 1 2 About DRAPS ie a o ea E AE EEEE AE AEE AE EO aE IE Ee 2 2s Installations fyo3 As tosc adie hed oh EEE EE ke boedos Susp deeds ed Salat EERE TE RES EESE EE ERI EEA ES 2 3 COnM PUAN ONE sacs tess setheussstte ste petleds oats sant baddest aatta eck E oats sash E a E E E E TS atte S 2 3 1 Application Settings lt lt 2 5 5 0 c ist odes stew sos ve ges odes eeedas auecncset ison dees Ses godes sues S EET EEEE 2 3 1 1 User Settings iseis ieres ssr Ir EE OIO nosh TEORI E EE PEERS ISSE ETE OIEA NEES ESPERAS 2 3 1 2 Path Settings ooe oe easte oaks bites oi E EE E E REE Le a 4 3 1 3 GES SEttiNS S in p eae aia a a E E E Ossie antag 0 E AE E ea ESS 5 3 1 4 Appearance Settings os nerroneeres o A ee Ween stan E EE oes eee E TEE S 6 3 1 5 Ch t Settings reiissi rset Psa vgs r EE IESSE PRERE ESE PRETI EAS EIS EERE SO TEOSTE ESETET 7 3 1 6 Sounds Settings seriis s eed heen ges neon ENEE EE E EEE EEE eens 8 31 7 Radio Setting S sitieni a E E E E E RA panda E sey sees 9 3 1 8 Transfers Settings asosii Soest oe cesete A E E EE E EE EE E EE ESS 10 3 1 9 Tunmg Settings crier re e eeose EE chad EEE EEE EE seeds EE SAPOTE RDI EIERE ESETE rA 11 3 1 10 TCP Gateway Settings iosi c scdecccusboveds sisest ree Cioran EEEIEE NEIE EEE S2. e Callsign This should be your exact callsign nothing else This is prefixed to outgoing messages for identifi cation e Name This is your familiar name Not currently used e Sign on Message If enabled the message in the box will be transmitted upon starting D RATS UserManual e Sign off Message If enabled the message in the box will be transmitted upon exiting D RATS e Units Select between Imperial default and Metric e Show time in UTC If enabled displays time in UTC rather than local time Ping Reply This message will be sent to any D RATS station that pings your callsign e Language Select between English default Italian and Dutch Blink tray on e Incoming Messages If enabled this will cause the D RATS icon in the system tray to blink on receipt of an incoming message e New Chat Messages If enabled this will cause the D RATS icon in the system tray to blink on receipt of new chat messages e Incoming Files If enabled this will cause the D RATS icon in the system tray to blink during receipt of an incoming file e Received Events If enabled this will cause the D RATS icon in the system tray to blink when an event is received 3 1 2 Path Settings E Config E Preferences File Transfer Path G Software D Star D RATS File Transfe Map Storage Path C Documents and Settings datil1 4pplic GPS Appearance Chat Sounds Radio Transfers Tuning Network T
3. 4 3 The My Status WMAOW hosie usa aa aa a a0 ade aattassepeaventa E E ais 21 4 3 1 Changing your Station s Status 2 0 0 0 cece ceee cece ca eeca cece cena eens eeneeeeeeeeeeeeeeeeeaees 21 4AA The Messages Lamas einormo n nna EAEN SETAE EO A AAAS RE REENE AT 21 4 4 1 The Messages Toolbar and Window cccsceeeesccecceceeecnereeeueeeeeeeeeeenereseneresenereees 21 4 4 2 Receiving Email and Forms through D RATS 0 0 0 0 ccc ec cece ence eee ence eeeeeeeeeeaees 22 4 4 3 Sending Email and Forms through D RATS 0 000 cece cece cece cn ee ne ee ne eeneeeeneeeees 23 4 5 The Chat Tab annsna eds sccas tease eod naea ES EEEE seuss y otes as cd avugsgecte sites ead EEPE nA sees 24 4 5 1 Chatting in Real Time siroter sa ede cdots cooncav ng obs p E EEE EE EERE SVA EE EEE T 24 4 5 2 Sending a Quick Messes ie a ea E E EE E E i 24 4 5 3 Forcing QST beacons to be sent eee cee cee ce eeceeeee seca seca cena eens eens eeneeeeeeeeees 24 4 6 The Files Tabni sess sss enaena opa aeai A E E EEO OEE EEP sa dois epbexaeesdseaereess 25 4 6 1 Testing Connectivity with a Remote Station 0 eee cece ce eeceeeee teen teen sean eenes 25 4 6 2 Send a File toa Remote Station s cs33s ses0ie scsseghse ses es bes cesta sas E eects bene ataaee 26 4 6 3 Get a File from a Remote Station 20 0 0 eee ee ccee cece cee ca eeca cece eeae eens een eeneeeeeeeeees 27 4 7 The Event Log Tab eisoes nesae rta n E TEPEE Eea bases OaE EE odaa dss ed
4. received via D RATS is limited to text D RATS cannot process images attach ments or html coding 4 4 1 The Messages Toolbar and Window The Messages Toolbar advises what options are available A 5 2 Ba i New Send Email Reply Delete MarkRead Mark Unread e New Allows a new Email message or Form template to be opened e Send Allows a message in the Inbox to be sent to another Station in the Station s list e Reply Reply to the highlighted message e Delete Delete the highlighted message e Mark Read Mark the highlighted message as Read e Mark Unread Mark the highlighted message as Unread Folders depicting Inbox Outbox Sent and Trash are available to be clicked on If an item is displayed in the Outbox it indicates that the message has not yet been sent 21 UserManual 4 4 2 Receiving Email and Forms through D RATS File view Help Messages Chat Files Event Log c D amp od m pa New Send Email Reply Delete MarkRead Mark Unread E Inbox Sender 4 Subject 4 Type Date B Outbox my Daves Portal lt daves_portal hotmail com gt EMAIL Another test message email 00 02 13 ro Sent ej David Tilson lt dave daves portal com gt EMAIL Test message from the internet email 23 43 59 lt Trash Station OH3HWx is now Online Online D RATS 1 Double clicking on a received email form will open the item for display and provide several options on what to do with
5. 38 2009 05 11 23 10 32 IC 2820 RPC 38 2009 05 11 23 10 32 IC 2820 Chat 38 2009 05 11 23 10 32 IC 2820 Control 38 2009 05 11 23 10 32 Ratflector Sniff 38 2009 05 11 23 10 32 Ratflector RPC 38 2009 05 11 23 10 32 Ratflector Chat 3 amp 2009 05 11 23 10 32 Ratflector Control 2009 05 11 23 10 32 D RATS Started _ My Status Online v gt Online D RATS The Event Log tab opens the Event Log Window where a summary of recent events can be viewed 4 8 D RATS Mapping D RATS can display the location of other D STAR users as well as information from specialist services such as NBDC Buoys and NWIS Rivers 28 UserManual ES D RATS Map Window j Biv lt gt w lt 4 Station Latitude 4 Longitude 4 Distance 4 Direction 4 Zoom 13 Stations Min lt gt Max Me 37 5573 143 8105 0 00 0 00 C Track center YK3GY 38 0552 145 3182 143 76 113 14 WBSPIJB 39 3686 104 8039 14208 31 65 31 YK3NJP 38 1120 144 3212 76 37 144 13 lt 37 5634 143 7951 4 8 1 Viewing the Map 1 Go to the View menu and select Map 2 Information displayed will include the Station name and its associated latitude and longitude coordinates as well as the distance and direction to the station from your location for any positional information received across RF or an internet connection i e through a Ratflector 4 8 2 Additional information which can be displayed on the
6. AUTO TX OFF IC 2200 9600 ATX ATXON SPD SPD96 UserManual IC 2820 9600 DV DATA TX AUTO GPS TX DISABLED GPS AUTO TX OFF UT123 must be installed ID 800H 9600 DVT DVTAT SPD SPD96 ID 880H 9600 DATATX AUTO GPS TX OFF GPS ATX OFF ID 1 19200 Unknown Ratflector not used Not applicable Ratflector password Optional password to send if required to access a Ratflector default no password e Sniff packets If enabled log some information about packets seen that are destined for other stations e Receive raw text If enabled displays all text received in the chat window e Name A descriptive name for this entry It will be displayed in other parts of the program 3 1 8 Transfers Settings Mey Config E Preferences Block size 1024 Paths Pipeline blocks 4 GPS Pipeline transfers Enabled Remote form transfers _ Enabled Remote file transfers _ Enabled Appearance Chat Sounds Radio Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access Save Cancel The options are e Block size The largest amount of data that is covered by a single checksum The larger this is the more efficient the transfer is on a good connection On a bad connection setting this to be smaller reduces the amount of data that must be re sent in the event of a bit of corruption Revert resets value to default settings e Pipe
7. Click the Remove button 4 Confirm whether you really wish to delete the QST 3 3 Quick Message Settings Quick messages are pre canned messages that can be sent with almost a single click File View Help Messages Chat Files Event Log Stations D RATS v0 3 0b6 HS HX Copyright 2009 Dan Smith KK7DS KK7D5 2009 05 11 16 12 08 KK7DS Now Online Active 16 12 09 OH3BHWX Now Online Online D RATS Main _ Ratflector v Quick Messages Send _senove one Hello world z Remove lOnili G day From Dave in Ballarat Victoria Australia v Online he E QSTs Online D RATS Station OH3HWXx is now Online Online D RATS UserManual 3 3 1 Setting a Quick Message 1 Go to the Chat tab and select Quick Messages 2 Enter a message in the text box 3 Click OK 3 3 2 Deleting a Quick Message 1 Go to the Chat tab and select Quick Messages 2 Click on the Quick Message that you wish to delete so that it is highlighted 3 Click the Remove button 4 Confirm whether you really wish to delete the Quick Message 4 Using D RATS 4 1 The D RATS Main Window The D RATS main window has been broken up into several sections comprising 1 Toolbar at the top of the screen with options including File View and Help 2 Tab entries for Messages Chat Files and Event Log 3 Stations window that displays a list of callsigns seen by D RATS and 4 My Status window i
8. Map 4 8 2 1 Adding Static Overlays to the Map D RATS can import csv files containing static lists of positional information i e Hospitals Repeater Sites EOC s etc that can be displayed on the D RATS Map See the Map Display page for further details on creating a static list or the Map Overlays page for examples of some that have already been created 29 UserManual 4 8 2 2 Adding NBDC Buoys to the Map NBDC Buoys can be added to the D RATS Map If an internet connection is available D RATS will interrogate the NDBC web site and retrieve information pertaining to the specified buoys To add an NDBC Buoy to the D RATS Map 1 Go to the Map menu and select Edit Sources 2 Select NBDC Buoy from the drop down list 3 Enter the unique NBDC Buoy identifier in the Buoys field multiple buoys can be added separated by commas 4 Data pertaining to the NBDC Buoy can be seen by hovering the mouse over the Buoy icon on the map 4 8 2 3 Adding NWIS River Information to the Map NWIS Rivers can be added to the D RATS Map If an internet connection is available D RATS will interrogate the NWIS web site and retrieve information pertaining to the specified rivers To add an NWIS River to the D RATS Map 1 Go to the Map menu and select Edit Sources 2 Select NWIS River from the drop down list 3 Enter the unique NWIS River identifier in the Sites field multiple Rivers can be added separated by commas 4 Data pertaining to
9. S F111 jpg 39 0 K6 08 42 41 2008 05 15 Filename Size Date 47TSTl O1 Ext 4736 14 4 Ares sign png 129 0KB 16 5 bizcard png part 0B 16 4 d rats profile 106 6 14 3 home JPG 1 0 KB 16 3 IMG_0022 3PG 3467 0 KB 23 2 IMG_0022 JPG part OB 09 4 msg xml 807 B 19 3 README txt 76B 06 4 Test 3 txt 196 14 1 My Status WashCo SitRep txt 7 0 KB 10 4 Online v gt Online D RATS The Files tab opens the Files Window where files can be exchanged across D RATS It should be remembered that D RATS operates across the low speed data segment of a D STAR digital voice transmission and that the file speed is less than 1kbps Therefore it would be unwise to attempt the transfer of large files across D RATS 4 6 1 Testing Connectivity with a Remote Station Unlike the D STAR DV Voice Channel which has error correction built into the protocol the Data Sub channel has no error correction This makes the transfer of data across D STAR a lot more dependant on a good radio path being established between the two locations wishing to exchange data D RATS includes the ability to test connectivity between two locations 1 Click on the Files tab to display the Files window Note This process can be performed through any of the windows 2 Right click on the callsign of interest in the Stations window A sub menu will be displayed 3 Click on Test Connectivity Details of the desired station to test with
10. as appropriate Set the message type to Weather WU and then browse to the file Set the interval in the drop down box Select whether the WU source is from an airport or a personal weather station Enter the WU station identification Click OK 2 1 5 Adding Editing a QST beacon from a RSS feed Click on the Add or Edit button as appropriate Set the message type to RSS and then browse to the file Set the interval in the drop down box Enter the URL of an RSS feed in the botton box Click OK 2 1 6 Adding Editing a QST beacon from a CAP feed Click on the Add or Edit button as appropriate Set the message type to CAP and then browse to the file Set the interval in the drop down box Enter the URL of a CAP feed in the botton box Click OK 2 1 7 Adding Editing a QST beacon from a text file Click on the Add or Edit button as appropriate UserManual 2 Set the message type to File and then browse to the file 3 Set the interval in the drop down box 4 Click OK 3 2 1 8 Adding Editing a QST beacon from the output of an executable file 1 Click on the Add or Edit button as appropriate 2 Set the message type to Exec and then browse to the executable 3 Set the interval in the drop down box 4 Click OK 3 2 2 Deleting a QST beacon To delete a QST beacon 1 Go to the Chat tab and select QST 2 Click on the QST that you wish to delete so that it is highlighted 3
11. further action 9 Highlight the desired message that you wish to send and click on the Email button Note Content of messages forms transmitted across RF via D RATS are subject to the usual regulations and where appropriate 3rd party agreements Due care should be taken to ensure that messages forms do not breach these rules and agreements 4 5 The Chat Tab The Chat tab opens the Chat Window where information can be exchanged in real time with other D RATS users and where QST beacons can be managed 4 5 1 Chatting in Real Time 1 From the main window select the Chat tab near the top of the screen 2 If you have multiple ports configured select the appropriate port you wish to send the message through 3 Enter your message in the box and click Send 4 5 2 Sending a Quick Message 1 Go to the Chat tab and select Quick Messages 2 Choose which port you wish to send the message on 3 Double click on a message from the list to send it 4 5 3 Forcing QST beacons to be sent To immediately send a QST 1 Go to the Chat tab and select QST 2 Ensure that the On box is ticked for the desired QST 3 Double click on its entry This also resets the timer 24 UserManual 4 6 The Files Tab File View Help Messages Chat Files Event Log Stations ha gy KK7DS5 00 08 Local 5 Refresh Delete Upload asi Connect Disconnect Download OH3H Wx 01 54 Filename Size 4 Date 4 Station
12. interchange D RATS information It also allows gating of D RATS traffic to be interchanged between RF and internet users More detailed information and configuration information can be found in the Repeater guide 31 UserManual 7 Still need to work out the best place to put this 7 1 Regular Expressions The notice and ignore functions use regular expressions for matching strings Regular expressions are very pow erful and are beyond the scope of this document Here are a few examples to get you started Regular expression Explanation Will match Will not match Tt esting Match any string with the Testing testing tesTing besting word testing banannalapple Match any string with ba My bananna is yellow My My kiwi is green nanna or apple in it apple is red 0 9 11 Match any three digit num 411 911 421 976 ber ending in 11 0 9 3 0 9 3 0 9 Match a US phone number 800 555 1212 01 423 99456 apple 4 32
13. it E Form To Subject Email Message David Tilson lt dave daves portal c l EMAIL Test message From the interr Message rom nobody Tue May 12 23 43 59 2009 ontent Type text plain charset us ascii ontent Transfer Encoding quoted printable his is a test message sent from the internet to D RATS Path 22 UserManual 4 4 3 Sending Email and Forms through D RATS 1 Click on the New button and select the desired item from the drop down list Some examples of forms currently distributed with D RATS are 1 5213_OR_WashCoARES 1 5213_US_OS email hics260 ics213 memo radiogram oe Form Email Message From dave rubbish com To dan foo com Subject Welfare check Message day Dan ust checking to make sure you are ok for batteries as we believe the power ill be off For the next 24 hours 1 To send an email message select email from the drop down list 2 Enter the email address of who the message is from in the From field 3 Enter the destination email address in the To field 4 Enter the message subject in the Message field 5 Enter the message content 6 If sending this message through a D RATS Gateway station click on the Path button and enter the callsign of the Gateway station 23 UserManual 7 When creation of the message is completed click on Save 8 The message will be saved in the Outbox awaiting
14. mapping 2 Installation The latest release version of the D RATS program can be downloaded from http www d rats com wiki Down loadPage D RATS can be installed on MS Windows Linux or MacOS X computers using the following Installation Guide 3 Configuration 3 1 Application Settings 3 1 1 User Settings Prior to utilising D RATS there are a number of preferences that must be configured These can be accessed by selecting File gt Preferences UserManual View Help L Import Message nt Log Stations rey Export Message od io aj Reply Delete MarkRead Mark Unread Message Templates 4 Subject C Ping Station Ctrl P X Preferences h Alt P Connected to Internet Quit Ctrl Q i My Status Online v Online D RATS A list of configurable items will appear in the left hand column E Config Preferences Callsign Paths Name GPS Sign on Message Enabled Online D RATS Appearance Sign off Message Enabled Going offline D RATS Chat Units Metric Sounds Show time in UTC _ Enabled E Radio Ping reply G day from Ballarat Australia Transfers Language English Tuning Private default Enabled Network Blink tray on TCP Gateway Incoming Messages Enabled New Chat Messages Enabled Incoming Files Enabled Received Events C Enabled TCP Forwarding Outgoing Email Incoming Email Email Access Save Cancel The options are
15. station s altitude above sea level External GPS If utilised select the Com port and port speed of an externally connected GPS Use External GPS If enabled instructs D RATS to use coordinates provided by an external GPS Table Table sent as part of a GPS A message Symbol Symbol sent as part of a GPS A message Freshen Map After Determines how frequently D RATS should check the internet for updated maps default 720 hours Note The position shown in the User Manual is in Australia and has negative latitudes and positive longitudes Positions in the U S have positive latitudes and negative longitudes For example the center of the U S is 37 7500 latitude and 99 5000 longitude UserManual 3 1 4 Appearance Settings Mey Config E Preferences Notice RegEx Paths Ignore RegEx Radio Transfers Network Broken Color TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are Notice RegEx A regular expression describing strings to highlight see explanation below Ignore RegEx A regular expression describing strings to dim see explanation below e Incoming Color This controls the color of the text received from other stations Outgoing Color This controls the color of messages you send Notices Color This is the highlight color for strings matching the Notice RegEx e Ignore Color This is the dim color for strings matching th
16. CP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access Save Cancel The options are e File Transfer Path Set to the desired location as to where downloaded files and files available for upload are to be stored e Map Storage Path Set to the desired location as to where downloaded map files from the internet are to be stored This can be a shared directory if multiple computers running D RATS wish to share map files UserManual 3 1 3 GPS Settings E Config Preferences Latitude 37 557300 Paths Longitude 143 810500 GPS Lookup by address Appearance Altitude Chat External GPS Sounds Use External GPS _ Enabled Radio GPS A Symbol Table Symbol 0 Freshen map after 720 Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are Latitude This should be the latitude coordinates of your station It should be in decimal degrees or De grees Minutes Seconds format use the space bar to substitute for the degree minute and second symbols Use for latitudes south of the equator e Longitude This should be the longitude coordinates of your station It must be in decimal degrees or De grees Minutes Seconds Lookup by address This option allows you to determine your approximate coordinates from your street address if the computer is connected to the internet Altitude This should be your
17. EEE KEE EEE EEEE S 12 3 111 TCR Forwarding Settings siise ne e E E aa ETES 13 3 1 12 Outgoing Email Settings 2 0 0 oee EEE S cena cena EEEE ESE EES 14 3 1 13 Incoming Email Settings sissors srei erreso ssr aoi ss tonssessbua ses secseesss byeaadaseosaoses sons 15 3 1 14 Email Access Settings os 55 scsi cbs teeens eae ne EK EE ua oes eb EEE AEE ESEE yuea sea 16 32 OST Stun gS chisis a e a e aa A E Mana a A a E ES 16 3 2 1 Viewing existing QST beacons ssssesessserrrsesrrsrrsrrrrsrrerrsrrerrrresrereesrerrerreerereseere 17 3 2 2 Deleting 4 QST beato essre narrer onis oe eese Eaa e ISa TE PEII EO E IRAE ETES EE beans 19 3 3 Quick Message Settings orret res e aoe EEEE N EEEE EEEE EEEE RES 19 3 3 1 Setting a Quick Message sio ciris ae e E a a a E E E T aE 20 3 3 2 Deleting a Quick Message 0 0 00 cece ii EEEE E RE E EEE i 20 4 Using D RA TSi aer ears a aE A E ETE EET Ee E REE r TEETE LEN NEn ETE RTE OS TERESE h 20 4 1 The D RATS Main Window sises seeetstoos eee huer oot seise oeno SE EEEE EEEE E ERE ENESA ESE 20 4 2 The Stations Window sisenemise eee a ea cesses ss E Meese saa a E GE a Manas bead 20 4 2 1 Checking the Status of an specific station cece cece ee ce ee ceeeceeeeaeeea seca eens eeneeees 20 4 2 2 Finding out who else is on line and their status 0 cece cece eee e cee eceneeeeeeeeeeeees 20 4 2 3 Requesting positional information for a remote station cece cece eee nee ee eee een eens 21
18. ame of sound to play if any chat messages are received e Message activity If enabled the location and filename of sound to play if any messages are received e File activity If enabled the location and filename of sound to play if any files are received UserManual 3 1 7 Radio Settings Mey Config Preferences Enabled 4 Port 4 Settings 4 Sniff 4 Raw Text 4 Name Paths COM2 9600 o IC 2820 GPS netiref d rats com 9000 9600 d Ratflector Appearance Chat Sounds Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access D RATS can be configured to operate simultaneously across multiple communication links eg 2m 70cm 23cm and the internet The options are e Enabled If enabled this port is active and available for use with D RATS e Port The device to open Enter the desired port to operate across i e COM14 dev cuaO or net ref d rats com 9000 e Rate The data speed used to connect D RATS to your radio This must match your radio see table below but has no bearing on net type connections such as the Ratflector Radio Rate Radio settings required for D RATS to function IC 80AD 9600 DATATX AUTO GPS TX OFF GPS ATX OFF IC U82 9600 ATX ATXON SPD SPD96 IC V82 9600 ATX ATXON SPD SPD96 IC 91AD 38400 DV DATA TX AUTO GPS TX DISABLED GPS AUTO TX OFF IC 92AD 38400 DV DATA TX AUTO GPS TX DISABLED GPS
19. callsign their status and other information will be displayed 4 If a previously pinged station does not respond their last heard time will not revert to zero 4 2 3 Requesting positional information for a remote station 1 Right click on the callsign of interest in the Stations window A sub menu will be displayed 2 Click on Request Position A position request message will be sent to the desired callsign and if they are on line and have their coordinates configured in File gt Preferences gt GPS then their Latitude and Longitude details will be broadcast to all connected stations 4 3 The My Status Window The My Status window displays the current status of your station and the Sign On message that will be sent to other stations 4 3 1 Changing your Station s Status 1 When ever your station is pinged by another station or your station transmits information for any reason the Status information will be sent 2 Use the drop down list to select between Online and Unattended 4 4 The Messages Tab The Messages tab opens the Messages Window where internet email and forms can be exchanged across D RATS D RATS supports a number of different types of forms such as HICS260 ICS213 and email that are packaged and distributed with the D RATS program and these function in the same manner to that of an email message Some of these messages can auto populate appropriate fields simplifying data entry Currently email and forms sent
20. d have the On box ticked 3 The time remaining until the next QST is displayed for each message 3 2 1 1 Adding Editing a text QST beacon 1 Click on the Add or Edit button as appropriate 2 Make sure the message type is set to Text 3 Set the interval in the drop down box the default is 60 minutes Preset intervals include 1 5 10 20 30 or 60 minutes and 15 30 and 45 minutes past the hour Use a preset interval or manually type one in the box i e 15 for every 15 minutes or 25 for 25 minutes past the hour 4 Type your message in the bottom box 5 Click OK 3 2 1 2 Adding Editing a QST beacon containing GPS coordinates Note Your GPS coordinates must already be configured in D RATS See GPS Tracking UserManual 4 5 Click on the Add or Edit button as appropriate Set the message type to GPS Set the interval in the drop down box Type a short message in the bottom box Click OK 3 2 1 3 Adding Editing a QST beacon in GPS A format Note Your GPS coordinates must already be configured in D RATS See GPS Tracking 1 2 3 4 5 Click on the Add or Edit button as appropriate Set the message type to GPS A Set the interval in the drop down box Type a short message in the bottom box Click OK 3 2 1 4 Adding Editing a QST beacon from Weather Underground is 2 5 6 3 1 2 3 4 5 3 1 2 3 4 5 3 1 Click on the Add or Edit button
21. e Ignore RegEx e Broken Color This is the color used to highlight raw text received that can t be checked for validity if enabled UserManual 3 1 5 Chat Settings Mey Config E Preferences Log chat traffic Enabled Paths Load log tail Enabled GPS Chat font Sans Normal Appearance Scrollback Lines 1024 Show status updates in chat Enabled Sounds Radio Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are e Log chat traffic If enabled a drats log file will be generated in your download directory and will log all chat traffic e Load log tail If enabled loads the tail of the chat log from the last session e Chat font The font for the main window chat display e Scrollback lines Defines the number of lines available for scrollback in the chat display default 1024 Show status updates in chat If enabled displays any status updates in the chat display UserManual 3 1 6 Sounds Settings Mey Config E Preferences Chat activity C Program Files D RATS ringin way Ll Enabled Paths Message activity C Program Files D RATS notify wav l Enabled P5 File activity LJ C Enabled Appearance Chat Radio Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are e Chat activity If enabled the location and filen
22. eanards Sass TIAS 28 4 3 D RATS Mapping etetea ince cdi E EE iy cassia ee ckos le E E EE EAEE ots 28 43 1 Viewing the Map iesin e dacca ees dacte saubetiaas atten ee toad des tates aes E ao aedaten ES 29 UserManual 4 8 2 Additional information which can be displayed on the Map cece cee cece eeee ee ee ee ee 29 4 3 3 Printing Saving the Mapsin ton sanrio bos aes neaiesas E N E bated 30 4 9 FOS sient noe o e Lives ced es Seek E E AEE sieges ee ebb wo sf ee ees oases 31 4 9 1 Creating Form Templates 53 o 28c ce0s cas sveciste vss isser Sees PVE ESTEE PIESE Tska sE PSF 31 5 D RATS Map Downloader sistiese ere i ar bee ddests nucnekarsbecdses EER S E E EEEE 31 6 D RATS Repeate ic torere E E aE a E T E aE h 31 7 Still need to work out the best place to put this sssesnssserssessrssrsrrerrssrerrsrrsrrrresrrrrsrrerrsrrerreresre 32 7 1 sRegular EX pressions ns sses rnos aaao r EE E Sedsessreossidhectsangseessesdeessees 32 1 Overview 1 1 About this document This document is intended to be a comprehensive reference for all D RATS features and is based on D RATS version 0 3 0 An Adobe Acrobat version of this document can be downloaded from http www d rats com download doc D RATS_User_Manual pdf 1 2 About D RATS D RATS is a communications tool for D STAR low speed data DV mode It provides 1 multi user chat capabilities 2 structured data transport forms and 3 position tracking and
23. going email i e smtp gmail com e Port and Mode Port that the remote SMTP server expects to receive email on i e gmail uses port 587 and TLS enabled e Source address Default email address to use on outgoing email e SMTP Username Username to log into the remote SMTP server e SMTP Password Password to log into the remote SMTP server e Gateway If enabled allows email received from D RATS to be sent to the internet 14 UserManual 3 1 13 Incoming Email Settings E Config Preferences Server 4 Username 4 Password 4 PollInterval 4 Use SSL 4 Port 4 Action Paths pop gm vk3ur dsta foo 2 995 Form GPS Appearance Chat Sounds E Radio Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are e Server Address of the remote POP server to receive incoming email i e pop gmail com e Username Username to receive incoming email e Password Password to receive incoming email e Poll Interval Frequency in minutes to see if new email is waiting on the remote POP server e Port Set to the port that the remote POP server expects to receive email on i e 110 pop gmail com uses port 995 e Use SSL If enabled connect to the remote POP server with SSL e Action Treat the email as a Form or as a Chat message default Form 15 UserManual 3 1 14 Email Access Settings E Config E Preferences Callsign 4 Access 4 Email Fil
24. line blocks The number of blocks of Block size bytes that are sent each round Revert resets value to default settings Be aware that Block size times Pipeline blocks can cause a transmission time long enough to time out radios and or repeaters Larger is not always better UserManual e Remote form transfers If enabled allow remote users to retrieve forms from this station e Remote file transfers If enabled allow remote users to retrieve files from this station s File Transfer Path directory 3 1 9 Tuning Settings E Config E Preferences Warmup Length Paths GPS Warmup timeout Force transmission delay Appearance Chat Sounds Radio Transfers Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access Save Cancel The options are e Warmup Length The number of bytes to prefix to each packet after a period of idle This may help to warm up a handheld radio on the receiving end that is in power save mode Revert resets value to default settings e Warmup timeout The number of seconds between transmissions that is considered to be idle thus causing the next transmission to include the prefix pad as described above Revert resets value to default settings e Force transmission delay Always wait this many seconds before transmitting a packet Revert resets value to default settings 11 UserManual 3 1 10 TCP Gateway Settings Mey Co
25. ndicated whether you are online and available 4 2 The Stations Window The Stations window located on the right hand side of the D RATS program is used to display a list of stations that have been received by D RATS and their status When ever a D RATS station transmits any sort of message Going online positional information QST Beacon chat message file transfer etc their status is sent to all stations using the same port i e RF Ratflector etc Callsigns in the Stations List that are e Blue Currently online and responding e Black Not responding e Dimmed have been previously received but sent a Sign Off Message and are therefore no longer accessible 4 2 1 Checking the Status of an specific station 1 Right click on the callsign of interest in the Stations window A sub menu will be displayed 2 Click on Ping A Ping request will be sent to the desired callsign and if they are on line the last heard timer next to their callsign will revert to zero 3 By performing a mouse hover over their callsign their status and other information will be displayed 4 2 2 Finding out who else is on line and their status 1 Right click somewhere in the Stations window A sub menu will be displayed 20 UserManual 2 Click on Ping All Stations A Ping request will be sent to all enabled ports i e RF Ratflector etc and all stations that are on line will respond 3 By performing a mouse hover over their
26. nfig Preferences Port 4 Host Paths 25 MAIL FOO COM GPS Appearance Chat Sounds Radio Transfers Tuning Network TCP Forwarding Outgoing Email Incoming Email Email Access The options are e Port Receive traffic on this port from stations over the radio link i e port 25 Host Send traffic to the designated port at the host address i e mail foo com 12 UserManual 3 1 11 TCP Forwarding Settings Mey Config E Preferences Local 4 Remote 4 Station Paths 2525 25 KI4IFW GPS Appearance Chat Sounds E Radio Transfers Tuning Network TCP Gateway Outgoing Email Incoming Email Email Access The options are e Local Port Listen for connections to a designated port on the local machine i e port 2525 e Remote Port Send data received on that port i e port 2525 to the designated port on the remote machine i e port 25 e Station Address this data to the callsign entered across the radio link 13 UserManual 3 1 12 Outgoing Email Settings Mey Config Preferences SMTP Server smtp gmail com Paths Port and Mode 587 i Mts GPS Source Address vk3ur dstar gmail com Appearance SMTP Username vk3ur dstar gmail com Chat SMTP Password 4 Sounds Gateway Enabled E Radio Transfers Tuning Network TCP Gateway TCP Forwarding Incoming Email Email Access The options are e SMTP Server Address of the remote SMTP server to send out
27. shall be displayed 25 UserManual E Connectivity Test Test Type Remote station 1 Gradually increasing packet sizes 1 If correct Click on Forward 2 Confirm the test parameters Mey Connectivity Test Test Parameters a Packet size 256 umber of packets 10 gt 1 Click on Start 2 The test will conclude advising the quality of the path E Connectivity Test Run Test Status Attempt 3 of 10 Statistics Received Packets 2 Bytes 512 4 6 2 Send a File to a Remote Station 1 Click on the Files tab to display the Files window 26 UserManual 7 8 Select from the drop down list the Station you wish to send a file to If you have multiple ports configured for D RATS to operate across select the appropriate port Click on the Connect button If communications has been successfully established with the remote station a list of files in their File Transfer Path directory will be displayed Click on the filename you wish to send so that it is highlighted Click on the Upload button The status of the transfer will be displayed in the bottom status bar When the transfer is complete the filename should appear in their File Transfer Path directory Click on the Disconnect button to disconnect from the remote station 4 6 3 Get a File from a Remote Station The following procedure assumes that the remote D RATS sta
28. ter Paths YK3DYL Both vk3dyl foo com GPS VK3WI4 Incoming wia bar com au Appearance VKS4BC None abc spam com Chat Sounds E Radio Transfers Tuning Network TCP Gateway TCP Forwarding Outgoing Email Incoming Email Email Access The options are e Callsign Enter the callsign of a D RATS user that you wish to process email for e Access Determine how email will be handled for the nominated callsign eg None Both Incoming or Out going e Email filter Looks for a string matching this field in the message so that it can direct the message to the nominated callsign 3 2 QST Settings D RATS allows an automatic message to be broadcast at a specified interval The message can be text specified by the user the output of a program a text file or GPS coordinates 16 UserManual File View Help Messages Chat Files Event Log Stations D RATS v0 3 0b6 Copyright 2009 Dan Smith KK7DS Main Ratflector v Quick Messages QSTs Type Freg Remaining On Content GPS s0 J OND RATS R55 36 C http irss weather com au vic Ballarat Text 60 C Dave in Ballarat Victoria Australia RSS 40 a C http www nhe noaa gov nhe_atl xml Weather WU 31 O Personal IVICTORI94 GPS A 01 EN M tk 22 Edit __ My Status Online v Remove Online D RATS 3 2 1 Viewing existing QST beacons 1 Go to the Chat tab and select QST 2 QSTs that are currently being use
29. the NWIS River can be seen by hovering the mouse over the River icon on the map 4 8 3 Printing Saving the Map D RATS can print the current map screen or save it as a png image 30 UserManual ES D RATS Map Window Refresh Clear Cache Edit Sources Printable TT Printable visible area Ctrl Alt P 1 Save Image Ctrl 5 Save Image visible area Ctrl Alt 5 a a Bones el wos O a Station 4 Latitude 4 Longitude 4 Distance 4 Directior Ballarat_Icons Min DY_Repeaters_Icons C Track center Misc Stations Rivers E a SSS 37 5409 143 8375 1 Go to the Map menu and select Export followed by the desired option 4 9 Forms 4 9 1 Creating Form Templates Need information here 5 D RATS Map Downloader The D RATS Map Downloader is a separate application that is packaged with and installed as part of the normal D RATS installation process It allows a range of maps to be downloaded across the internet for later use by D RATS This is particularly useful if the computer is likely to be used away from internet connectivity More detailed information and configuration information can be found in the Map Display guide 6 D RATS Repeater The D RATS Repeater is a separate application that is packaged with and installed as part of the normal D RATS installation process It allows multiple D STAR radios even on different frequencies that are connected to the same computer to
30. tion has the Remote File Transfer box enabled in File gt Preferences gt Transfer 1 2 Click on the Files tab to display the Files window Select from the drop down list the Station you wish to receive a file from If you have multiple ports configured for D RATS to operate across select the appropriate port Click on the Connect button If communications has been successfully established with the remote station a list of files available from their defined File Transfer Path directory to be received will be displayed including file size and the date time of the file creation Click on the filename you wish to receive so that it is highlighted Click on the Download button The status of the transfer will be displayed in the bottom status bar When the transfer is complete the filename should appear in your File Transfer Path directory Click on the Disconnect button to disconnect from the remote station 27 UserManual 4 7 The Event Log Tab File View Help Messages Chat Files Event Log Stations Show event type All v Containing text KK7DS 00 09 Time Description 2009 05 11 23 10 50 Station KK7DS is now Online Active C3 2009 05 11 23 10 50 KK7DS replied to ping from YK3UR with Running D RATS 0 3 0b5 Linux fa 2009 05 11 23 10 43 VK3UR pinged CQCQCQ Ratflector Request Ga 2009 05 11 23 10 43 YK3UR pinged CQCQCQ IC 2820 Request 3S 2009 05 11 23 10 32 IC 2820 Sniff
Download Pdf Manuals
Related Search