From 450913d2452612a3e6e4456de99c9b3c589aa942 Mon Sep 17 00:00:00 2001 From: Geoffrey Merck Date: Thu, 1 Nov 2018 18:20:21 +0100 Subject: [PATCH 1/5] Create README.md --- ircDDBGateway/APRSTransmit/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 ircDDBGateway/APRSTransmit/README.md diff --git a/ircDDBGateway/APRSTransmit/README.md b/ircDDBGateway/APRSTransmit/README.md new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/ircDDBGateway/APRSTransmit/README.md @@ -0,0 +1 @@ + From 778480c643e08b7cc0a942dd4ffc86ab86d85a94 Mon Sep 17 00:00:00 2001 From: Geoffrey Merck Date: Thu, 1 Nov 2018 18:24:50 +0100 Subject: [PATCH 2/5] Add brief introduction Add brief introduction of what APRSTransmit and APRSTransmitD are --- ircDDBGateway/APRSTransmit/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/ircDDBGateway/APRSTransmit/README.md b/ircDDBGateway/APRSTransmit/README.md index 8b13789..8c8adad 100644 --- a/ircDDBGateway/APRSTransmit/README.md +++ b/ircDDBGateway/APRSTransmit/README.md @@ -1 +1,3 @@ +# APRSTransmit and APRSTransmitD +APRSTransmit and APRSTransmitD allow both to transmit APRS data over DStar i.e. turning it to DPRS. Newer radios like ID51+, ID5100 and ID4100 have extended DPRS capability andd are able to handle various data types such as weather and objects. From 155eb28d2583468bbae6bb174c7c787917152a92 Mon Sep 17 00:00:00 2001 From: Geoffrey Merck Date: Fri, 2 Nov 2018 06:57:59 +0100 Subject: [PATCH 3/5] Documented APRSTransmit Added detailed instruction on APRSTransmit and some examples and use cases --- ircDDBGateway/APRSTransmit/README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/ircDDBGateway/APRSTransmit/README.md b/ircDDBGateway/APRSTransmit/README.md index 8c8adad..26127e5 100644 --- a/ircDDBGateway/APRSTransmit/README.md +++ b/ircDDBGateway/APRSTransmit/README.md @@ -1,3 +1,13 @@ # APRSTransmit and APRSTransmitD -APRSTransmit and APRSTransmitD allow both to transmit APRS data over DStar i.e. turning it to DPRS. Newer radios like ID51+, ID5100 and ID4100 have extended DPRS capability andd are able to handle various data types such as weather and objects. +APRSTransmit and APRSTransmitD allow both to transmit APRS data over DStar i.e. turning it to DPRS. Newer radios like ID51+, ID5100 and ID4100 have extended DPRS capability and are able to handle various data types such as weather and objects. Yet not all APRS formats are supported by Icom : Mic-E, Compressed. When possible the APRS data is converted so that it can be parsed by Icom radios. + +# APRSTransmit +APRSTransmit sends one single APRS frame to the specified repeater. The frame can be sent directly on the command line, be sure to escape it into single quotes. +```sh +aprstransmit N1RPT__c -aprs 'N0CALL>APRS:!3842.78N/00759.76E>208/023/Hello' +``` +It can also read data from a single file. For example, this comes handy if you run a weather station with weewx and want to broadcast it over DPRS +```sh +aprstransmit N1RPT__C -file /path/to/your/file/containing/one/line/of/aprs/data +``` From 17a002f7ad8eb2dad498ecc7b58e14dc65bfc210 Mon Sep 17 00:00:00 2001 From: Geoffrey Merck Date: Fri, 2 Nov 2018 07:37:41 +0100 Subject: [PATCH 4/5] Add documentation about APRStransmitD --- ircDDBGateway/APRSTransmit/README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/ircDDBGateway/APRSTransmit/README.md b/ircDDBGateway/APRSTransmit/README.md index 26127e5..15b2632 100644 --- a/ircDDBGateway/APRSTransmit/README.md +++ b/ircDDBGateway/APRSTransmit/README.md @@ -5,9 +5,22 @@ APRSTransmit and APRSTransmitD allow both to transmit APRS data over DStar i.e. # APRSTransmit APRSTransmit sends one single APRS frame to the specified repeater. The frame can be sent directly on the command line, be sure to escape it into single quotes. ```sh -aprstransmit N1RPT__c -aprs 'N0CALL>APRS:!3842.78N/00759.76E>208/023/Hello' +aprstransmit N1RPT__C -aprs 'N0CALL>APRS:!3842.78N/00759.76E>208/023/Hello' ``` It can also read data from a single file. For example, this comes handy if you run a weather station with weewx and want to broadcast it over DPRS ```sh aprstransmit N1RPT__C -file /path/to/your/file/containing/one/line/of/aprs/data ``` + +# APRSTransmitD +APRSTransmitD is a daemon that runs in the background and takes data from APRSIS and broadcasts as DPRS to the specified DStar repeater. It can take any [server side APRS filter](http://www.aprs-is.net/javaprsfilter.aspx) and will pass the data received to the repeater. +## Running from command line +The line below will run aprstransmitd in the console, staying in front. This can be useful to see what is being taken from APRSIS over to your repeater. +The example below forwards aprs data within a radius of 100km to n1rpt__c. +```sh +sudo aprstransmitd n1rpt__c -host rotate.aprs2.net -port 14580 -filter 'm/100' +``` +To run it as a background daemon, add -daemon switch e.g.: +```sh +sudo aprstransmitd n1rpt__c -host rotate.aprs2.net -port 14580 -filter 'm/100' -daemon +``` From ffb740feb28ab26a0123473efdd50521483f8cc2 Mon Sep 17 00:00:00 2001 From: Geoffrey Merck Date: Fri, 2 Nov 2018 07:46:01 +0100 Subject: [PATCH 5/5] Added running APRStransmitD as a systemd service --- ircDDBGateway/APRSTransmit/README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/ircDDBGateway/APRSTransmit/README.md b/ircDDBGateway/APRSTransmit/README.md index 15b2632..d7822f4 100644 --- a/ircDDBGateway/APRSTransmit/README.md +++ b/ircDDBGateway/APRSTransmit/README.md @@ -24,3 +24,22 @@ To run it as a background daemon, add -daemon switch e.g.: ```sh sudo aprstransmitd n1rpt__c -host rotate.aprs2.net -port 14580 -filter 'm/100' -daemon ``` +# Runnning as a systemd service +To run as a systemd service you must have installed aprstransmitd through the debian packages. Once, this is done configuration works as follow. +Lets assume we want to send APRS data on the n1rpt__c repeater. +Copy file /etc/opendv/aprstransmitd.conf to /etc/opendv/aprstransmid_n1rpt__c.conf +```sh +sudo cp /etc/opendv/aprstransmid.conf /etc/opendv/aprstransmid_n1rpt__c.conf +``` +Edit the file /etc/opendv/aprstransmid_n1rpt__c.conf and change parameters to suite your needs. + +Now enable the service +```sh +sudo systemctl enable aprstransmitd@n1rtpt__c +``` +And start it +```sh +sudo service aprstransmitd@n1rpt__c start +```sh + +You can repeat above steps if you have a second repeater running.