#  DPlus Log Formatter
#    Provides for remote screen display of various status items
#
#    Author:  Ken Adkisson, WB4FAY
#
#
#  CHANGE LOG:
#  --------------------------------------------------------------------
#  12/21/2011 - Version 1.0
#               Added code to handle the new dplus log format generated
#                 by D-Star Plus Version 2.2h.
#
#  10/27/2011 - Version 0.9
#               Added code to make better utilization of the display
#                 space for showing the repeaters and associated users.
#                 Now, if there are less than 4 users on a given repeater,
#                 a two-column format is used.
#               Corrected minor bugs found since the previous release.
#
#  04/06/2010 - Version 0.8d
#               Added code to handle new dplus log entries generated by the
#                 latest version of AA4RC's dplus.
#               Added code to check for the availability of a new version
#                 of the dplusreport program.  If a new version is found,
#                 it is NOT loaded but instead simply displays a message
#                 informing the user during program startup.
#
#  10/01/2010 - Version 0.8c
#               This was an internal development and testing version and was
#                 never actually released for general distribution.
#
#  02/17/2010 - Version 0.8b
#               Added code to properly handle the new DVAP device from
#                 AA4RC.
#
#  01/18/2010 - Version 0.8a
#               Added rquest for dplusreport user's call sign at startup
#                 Key-ups by this call are then handled differently to not
#                 clutter the log window.  Instead 'LCL' (for local) will be
#                 displayed in the TOP line while this call sign is tranmitting.
#     	    Added an additional display window option (window id = 8).
#                 This window will display a listing of the last unique calls
#                 that have keyed.  The number listed is based on teh number
#                 of rows available.  The most recent station to transmit is
#                 the bottom line of the display.  Thsi window is mutually
#                 exclusive of window id=4 due to available display real
#                 estate.
#
#  11/12/2009 - Version 0.7h
#               Added feature to recognize when a user as set the BK
#                 and/or EMR modes on their radio.  If either of these
#                 flags are found then a message is displayed in the
#                 dplusreport terminal window to indicate such to the
#                 NCS station.  The message is cleared from the window
#                 when the NCS uses the CNTL-Z function to clear the
#                 underlines from user calls OR the BK/EMR message is
#                 automatically cleared if the D-STAR user turns off
#                 the mode on their radio and then makes another
#                 transmission.
#
#  08/14/2009 - Version 0.7e
#               Corrected error caused when all repeater modules were
#                 linked at the same time.
#
#  08/07/2009 - Version 0.7d
#               Corrected minor errors
#   		    Discontinued the display of log entries for transmissons
#                 internally generated by the D-STAR system (e.g ID's)
#
#  06/24/2009 - Version 0.7c
#		    Corrected several miscellaneous errors in the logic that
#		      were causing incorrect displays when multiple repeater
#		      modules were active and the dplusreport user was only
#		      monitoring a single module.
#		    Modified the logic to take advantage of additional info
#		      Robin included in the dplus.log file for the 20 char
#		      user message entries.
#
#  10/17/2008 - Version 0.7
#               Added ability to select single local module (A,B,C) to monitor
#                 or all modules
#               Added more logic to report detectable doubling on a module
#                 (e.g. Remote user keys on top of local user, etc.)
#               Added warning message when extraneous header is detected in the
#                 log file (e.g. user does not have "G" set in RPT2 so keyup
#                 is not handled by dplus)
#               Added ability to specify start-up options on the command line
#	   	    Added the configuration save feature to store in
#		      $HOME/.dplusreport.conf.  This is then used as the
#		      default config for the next use of the program.
#
#  10/03/2008 - Version 0.6
#               Added routine to detect and report on gateway
#                 re-initialization
#               Added Control-Z function to clear callsign underlines.
#                 The underlines accumulate since the last Ctrl-Z.
#
#  09/18/2008 - Version 0.5
#               Fixed minor bug when displaying only the log (mode = 4)
#               Added display of 'user message' (on first xmit)
#               Added user & repeater aging.
#                (30 min = yellow, 60 min = red, 90 min = delete)
#		    Added warning messages for significant lost packets
#
#  09/02/2008 - Version 0.4
#               Added ability to select only portions of display (links,
#                 repeaters/users and/or log entries (default=show all)
#               Added ability to specify max repeaters to support
#                 (default = 20)
#
#  08/23/2008 - Version 0.3
#               Added ability to track modules of local repeater
#                 independently.
#
#  08/22/2008 - Version 0.2
#		    Add ability to specifiy starting and ending date/time
#		    Add tracking of repeaters and users since start time
#               Add use of 'perl-File-Tail' for reading dplus.log file
#
#  08/07/2008 - Version 0.1
#		    Initial version of the program