Repeater Reader

coming soon – under construction

 

Here a small „How To“

Support only Via Telegram Messenger
https://t.me/joinchat/AAAAAAxNhRTzHDCfKpMxLQ

You can Download Telegram Messenger here:
https://telegram.org/

Currently Repeater Reader is not official released but if you want you can download Repeater Reader here:
https://www.dropbox.com/s/3cra6cem2xnhntl/RepeaterReader.jar?dl=0

Repeater Reader,

here are some quick and dirty infos about Repeater Reader 😀

If you want to use this program you have to agree that you use it at your own risk 😉
And please keep in mind that Repeater Reader is not yet finished / released
Currently Clusters are not supported (TG8 or TG2 in some areas).

The program is written in JAVA so it should run on all supported systems like Windows, Linux or MAC
You need the newest JAVA version
https://java.com/download/
Currently this is Version 8 Update 121

Make sure during the installation of JAVA that you only install JAVA (expert mode if available)

If Repeater Reader is not starting or unable to connect deinstall Java and perform a new installation

What is the usage of Repeater Reader ?

The main reason to create this program was that I want to see if there is traffic on a repeater in times where I am not able to monitor
the repeater with my radio (e.g. working hours)

Does repeater reader really monitor the selected repeater ?
No, Repeater reader has no connection to the repeater or to the data stream to the selected repeater.

The program is calculation the transmission from the Brandmeister Last Heard Stream (also the GPS Stream)
So it is like the Last Heard Function on the Brandmeister webpage.

As I wrote it is a calculation so this also leads to some minor problems. Normally a repeater has a hang time and currently this hang time
is also simulated because there is no way to read it. Repeater Reader uses a fixed hang Time of 5 secounds.

The currently not supported feature is the Cluster so if a OM is transmitting on the local Cluster he will not show up on the display.
Currently I am working on this part of the program for a temporary solution. Keep in mind TG8 / TG2 Cluster is nor supported at the moment.

In theory the program is self explaining (hopefully ^^)
The menu / config is located on the top / left

How to setup
– Click on this Button (3 white stripes)
– In the Repeater part click on 1. Download Repeater DB
– insert the callsign of your repeater on step 2
2. type CallSign here
select the repeater on step 3
and click the button on step 4

go back to the program by closing the config screen
on the left select your repeater and click on the blue/white arrow

Above the 2 Displays (left TS1, right TS2) there are some labels for Static, Dynamic, Timed and Cluster
If you click on these labels you can disable the parts, click again on it and it is enabled again

Press the ESC Key to go to the minimized mode, press ESC again to go back to the normal mode.
If you hide the tile bar of the program you can still move the window, just click on the display and move the window

For the rest, just play around with the program, there will be a better documentation after the program is official released
but for the moment I am concentration on programming.

 

################################### Below I will create the final Info page, as long as you can read this text its not final ###################

You agree that you use this program at your own risk !

** Download RepeaterReader.jar **

last Version: 20170711T180100

What is Repeater Reader ?

Repeater Reader is a small JAVA program which „simulates“ the traffic on a selected repeater. Repeater Reader is not able to read the repeater itself or the data stream to the selected repeater.

The program is using the Brandmeister APIs for the Last Heard and GPS system like on the Brandmeister website:
https://brandmeister.network/

This means that RR reads the data stream of both streams and filter out all necessary data like the selected Talkgroups or the connected Reflector.

But why do I need RR ? You don’t need it 😉 I designed the program to see the traffic on the repeater even if the TRX is turned of like if you are at work.

RR has a sound notification (not the voice, only a sound) for all traffic or only for friends so you can let run it in the background. You can also minimize the program (ESC key) and let it stay on top (if configured) in a corner of your monitor.

For multimedia freaks: a KODI option is also included to send messages to KODI. So you can watch your movies and get the notification on the big screen . If you don’t know what KODI is just ignore this option 😉

Additionally a Web Api is available to see the traffic on your homepage:

or on your mobile phone
http://live.do0jg.de/

What are the system requirements ?

The program is written in JAVA so it should run on all supported systems like Windows, Linux or MAC

You need the newest JAVA version
https://java.com/download/
Currently this is Version 8 Update 121

Make sure (during the installation of JAVA) that you only install JAVA (expert mode if available) because sometimes they want to install other software. (as far as I know)

If Repeater Reader is not starting or unable to connect de-install Java and perform a new installation.

Don’t extract the JAR file.

Is there any support available ?

Support via Telegram Messenger (English)
https://t.me/joinchat/AAAAAAxNhRTzHDCfKpMxLQ

You can download Telegram Messenger here:
https://telegram.org/

Support via Facebook (English)
https://www.facebook.com/groups/RepeaterReader/

Is there a Yahoo Group ?
– No, I don’t like Yahoo Groups

Is there Email support ?
– Yes but only if you send me a free Motorola DP4801e 😀
– OK with other words, there is no email support available, please use Facebook or Telegram

Is there forum support available ?
– currently not, maybe later

What’s about telephone support ?
– Dude there is no telephone support 😉

Manual (RTFM or Not RTFM)

The Display(s)

RR has 2 Displays, the left one is for TS1 and the right one is for TS2

On the top, there is the indicator for the Timeslot TS1 / TS2

This indicator changes the background color
grey background –> Standby or receiving
red background –> TX on the selected repeater
orange –> HangTime indicator (5 seconds)

On the image above (orange indicator) you can see that the (simulated) HangTime is active.

On the image above (red indicator) you can see that someone is transmitting on the connected repeater.

Right after the indicator there you can find 4 coloured labels for
Static Talkgroups
Dynamic Talkgroups
Timed Talkgroups
Cluster

You can click on each label to disable these Talkgroups in RR, click again on the label to enable it again.

On the image above you can see that Dynamic, Timed and Cluster are deactivated.

Of course it is only deactivated in RR, not on the repeater 😉

The rest of the display should be self explaining

1. Talkgroup (Reflector)
2. Signal Strength (calculated from the RSSI)
–> changes to „last heard @HH:MM:SS“ after PTT was released
3. Callsign (transmitting station)
4. Name (transmitting station)
5. DMRid (transmitting station)
6. Callsign + Type of Repeater / Hotspot
7. Transmission Timer (MM:SS)

Below the display you can find the currently to the repeater connected Talkgroups. The background colour indicates the kind of the TG like on the labels above the display.

For the Times TGs you can find also the activation time in UTC. For the cluster you can find the Mirror TG in brackets. (if available)

The next part of RR is the repeater info part located below the TGs

This should be self explaining.

The last Updated filed indicates the last time were the Brandmeister System updated this information !!! AND !!! Repeater Reader read this information from the Brandmeister Network.

The blue text on the right side indicates links. The first two links are links to Google Maps and the last two links are links to the Brandmeister website.

Below the info part you will find the GPS Logging

Set Max Range (km)
Here you can define the range (in km) for the GPS messages related to a reference point.

  • none –> Reference Mode (Max Range) is turned off, you will see the LAT LONG coorinates instead of range and azimuth
  • Repeater –> this will use the repeater coordinates (if available)
  • Own Position –> you have to configure your position in the settings

If you change this option after you received reports, these change has no affect to the received reports. If you want to see the changes you have to open the extended log.

Insert a valid integer (only a number without point) and click on the „Set Max Range“ button.

Checkbox „Show only Friends“ will hide all other GPS messages except position reports from your friends. (you have to create your friend list in the settings)

Checkbox „Play Sound (Friends)“ this will play a sound every time you receive a GPS report from a friend (you have to create your friend list in the settings)

Button „Clear List“ click on this button to clear the GPS Reports in the table below (will not clear the reports in the extended log)

The table with the reports should be self-explaining because the columns are named. The only thing to mention is that the „Distance“ column is used for the LAT value and the „Azimuth“ column is used for the LONG value in no reference point is selected.

Below the GPS part you can find the 3-line Log

here you can find all program related information and the „QSO Log“.
Click on the 3-line Log to open the „Extended Log“

On the left side on the top there you can find the controls for the Repeater Monitor.

In the Drop Down menu you can select the repeater you want to monitor. Before you can use this option you have to set up your repeater in the setting (will be explained later in this manual)

For testing purpose the repeater DO0JG is already in the list.
On the right side of the drop down menu there is a blue bullet with a white arrow, with this button you can refresh the repeater information manual. This can be useful if Repeater Reader did not recognized a change (e.g. a dynamic TG expired)

Below the drop down menu you can find the Start/Stop options and the message counter. If you start Repeater Reader (and the automatic start is disabled) the buttons locks at follows

The left button is the START button, the right button is the STOP button, the numbers on the right are the message counter for the „Last Heard Stream“.

With a click on the left button you start the repeater monitoring. If you click again on this button you can restart the repeater monitoring, in this case the message counter will be reseted.

As soon as you clicked on the start button both buttons will change the design.

To stop the repeater monitoring you have to click on the stop button. The design of the buttons will change back to the design before.

Below the Start/Stop buttons you can find the „Alert Sound Options“

click on the + to expand/show the menu.

here you can select if Repeater Reader shall play a sound every time a friend (or all user) start a QSO an the selected time slot.

In the screenshot above a sound will be played every time id a friend is transmitting on TS1 and TS2.
– green bullet = a sound will be played
– red bullet = NO sound will be played

The next options on the left side are the options to Start/Stop the GPS Monitoring.

This works on the same way than the options for the Repeater Monitoring. The options for the Reference Point were already explained above in this manual.

The next options are for the Telegram Server

To open the settings for the Telegram Support you have to click on the word „Telegram“. You will find the manual for these setting below in this manual.

Again you can find the standard Start/Stop/Counter.
In this case you can start the Telegram Server. This is not really a server, its the function to enable some remote control functions for repeater reader. If you don’t use Telegram don’t start the Telegram Server. Also if you don’t want to use the remote control function.

Below the Telegram Options you can find the „Traffic Counter“

On the left side of the „Traffic Counter“ there is a small icon labelled with a 192. If you click on this icon you can access the options for the „Web-Api“. To use this function you need to be familiar with PHP, HTML and MySQL and you need webspace with PHP and MySQL support. If your hoster blocks POST request from outside your webspace you can not use this feature. You will find the manual for these setting below in this manual.

General Settings

Color

Here you can define the design of the display. You have 4 different options (color schemes) Move your mouse over the coloured label to see a preview in the simulated display. I recommend to use the „TG-Mode

Friends

If you want to use the Friends Feature you have to put in the Callsigns of your friends in you friends list

To add a friend to the list just write the Callsign in the text field (delete the word CallSign before from the input field) and click on Add Button.

To remove a friend from the list select the Callsign in the drop down box and click on the Remove Button.

Repeater

To use Repeater Reader you have to add a repeater. After downloading Repeater Reader one repeater (DO0JG) is already in the list. If you remove all repeater this repeater will be added automatically again.

You can add as much repeater to your list as you want but you can monitor only one.

To add a repeater follow the numbered steps

  • click on the button „1. Download the Repeater DB
  • remove the text „2. type your CallSign here“ and insert the CallSign of your repeater, while typing the box below will be filled automatically
  • select your repeater from the search results below „3. Select a Repeater
  • click on the button „4. Add to My List„, the selected repeater will be added to the drop down below the mentioned button

To remove a repeater from the list

  • select the repeater in the drop down
  • click on the button „Remove from My List

Autostart

Here you can define what happened when Repeater Reader is starting.

Auto start Repeater Monitoring

select this checkbox if you want that Repeater Reader starts the monitoring of the selected repeater after the program starts. If you have more than one repeater in your list and the monitored repeater is not on the top you have to select a start repeater (see below)

Auto start GPS Monitoring

select this checkbox if you want that Repeater Reader starts the GPS monitoring after the program starts.

Auto start Telegram Server

select this checkbox if you want that Repeater Reader starts the Telegram „Server“ after the program starts. Don’t select this box if the Telegram Server is not configured correctly.

Start Repeater

If you want that Repeater Reader select a repeater from your list after the program starts you can select this repeater in the drop down and click afterwards an the button „select on start„, the CallSign of the selected repeater will be inserted in the field right of this button.

To remove the „Start Repeater“ click on the X right of this field.

Keep in mind that this option will overwrite the command line start  parameter (if used)

Start Mode – Drop Down

in this drop down you can select how Repeater Reader is starting, here you have 3 different options

  • Start in Normal Mode
  • Start in Hide GPS Mode
  • Start in Minimized Mode (ESC Key)

GPS

Here you can define you own / current position.
This position will be used for the GPS reference point.

If you don’t want to use this feature it is not necessary to insert your position, if you insert your LAT LONG position you have to use the decimal format like:
Latitude: 48.188560
Longitude: 11.051118

KODI

KODI is a free Media Center and you can download it here:
https://kodi.tv/

If you don’t use KODI or if you are not familiar with KODI don’t activate this feature.

If you are a KODI user you can configure the log in data here.
If you select the checkboxes for TS1  and/or TS2 Repeater Reader will send a message (for the selected time slot) to KODI every time an OM starts a QSO.

General

Here you can find miscellaneous options which are  not related to the other categories.

Stay on TOP in Minimized Mode (ESC Key)

If you select this option and changes with the ESC key (in the main window) in the Minimized Mode, Repeater Reader will stay on TOP. This means Repeater Reader will not be hidden by other (normal) programs.

Stay on TOP in Normal Mode

If you select this option (in the main window), Repeater Reader will stay on TOP. This means Repeater Reader will not be hidden by other (normal) programs.

Hide Title Bar in Minimized Mode

If you select this option no Title  Bar is visible if Repeater Reader is in Minimized Mode.

Alert Sound Friends / All

Here you can select an own wav file (only wav is supported) for the sound notifications.

Click on the folder icon to select a wav file or click on the X icon to reset the sound notification to the default sound.

Use https connections for the streams

If you are behind a proxy and the Last Heard and / or GPS packets are not coming in (counter is not increasing) activate this option

Use System Design (Look and Feel) instead of Java Design

If you don’t like the Java Design you can try to use user System Design if you select this checkbox.

Keep in mind that this can lead to some small (or in the worst case big/crazy) design problems.

Telegram Settings

Tab – Basic Setup

The Basic Setup should be self explaining because everything is explained on this tab. Just open this tab in Repeater Reader and follow the steps.

Tab – Message Settings

This tab has different parts: Personal, Friends, All from selected repeater and Group Settings

Some of the checkboxes are AND and some are OR conditions so you have to read the text carefully. 😉

The „Personal Box“ is only  for messages to your private Telegram Bot-Chat.

The „Friends Box“ is normally also for messages to your private chat but can be redirected to aGroup Chat“ (if configured on the first tab) if you select the checkboxes in the „Telegram Group Settings Box„.

 

Tab – Telegram Commands

This tab has no options, it contains only the instructions and everything is explained in the tab.

Web Api – Settings

under construction ######

Meine kleine HAM Radio Welt