$Id: releasenotes.txt,v 1.37 2006/04/30 16:57:28 cvs Exp $ Release notes for the GRFd and GRF tools software. --- Release 1.3.3 - 2006-04-30 Broken server code with fix in previous release. This has been repaired. Symptoms were client unable to connect with multiple disconnect messages. --- Release 1.3.2 - 2006-03-23 Fixed issue where socket read timeouts where being handled properly in grflog, grf2ew, grfconvert, grftrig, and grfhub. This issue manifested itself as failure of clients to reconnect to servers after loss connectivity. --- Release 1.3.1 - 2004-03-31 All servers now provide syslogd logging on Windows platforms. grfd_db2k - Investigated digitizer stall issue further. The server now attempts to stop and restart acquisition when a stall is detected. The stall appears to have been an IOTech driver/library issue that has been repaired. --- Release 1.3.0 - 2004-01-31 grfd_db2k - Stalled digitizer is now a fatal error causing the server to shutdown. grfd - Added priliminary support for the DAQ24USB-4CH digitizer. grfd_par - Deprecated version supporting Symmetric Research PAR24B and PAR4CH digitizers. This will be the final version supporting these boards. grfd_a64 - Deprecated version supporting Symmetric Research DSPA64 digitzer. This will be the final version supporting this board. --- Release 1.2.0 - 2003-05-01 The Internet Assigned Numbers Authority (IANA) has assigned both the TCP and the UDP registered port number 3757 to the GRF. As of version 1.2.0, all server and client applications now use this new registered port number as the default port in all socket endpoints. Affected server apps: GRFd, GRFd_A64, GRFd_DB2k, GRFHub, and GRFTrig. Affected client apps: GRFViewer, GRFConvert, GRF2EW, and GRFLog. This change means that when connecting with an older client to a version 1.2.0 server, you will need to specify the new registered port number (3757) as part of the socket endpoint. For example, to connect to GRFHub 1.2.0 running on the local host with GRFLog 1.1.3, you would need to specify the new port in the socket endpoint as follows: grflog -ns localhost:3757 Likewise, in order to connect to an older server, such as GRFHub version 1.1.3 running on the local host, with version 1.2.0 of GRFLog, you will need to specify the old default port number (49642) in the socket endpoint as follows: grflog -ns localhost:49642 Both of these examples assume, of course, that the port number in the server listen endpoint has not been changed from its default in GRFHub's configuration file. It is highly recommended that all users upgrade the entire GRF Tools Suite to version 1.2.0. If upgrading GRFd, GRFd_A64, and/or GRFd_DB2k to version 1.2.0 is not possible or is inconvenient, you should at least edit their configuration file(s) and change the port number in server listen endpoint from the old default port number (49642) to the new GRF registered port number (3757). Other changes for this release are minor and include help screen cleanup across all of the tools and servers and fixing GRFLog to not report the number of time tears unless the -p (analyze timing) option was specified to avoid confusion caused by reporting time tears as 0 when the timing was not actually analyzed. --- Release 1.1.3 - 2003-04-07 All GRF servers: grfd, grfd_a64, grf_db2k, grfhub, and grftrig - Fixed problem with client thread suspend/resume logic that cause all client threads to exit rather than suspend and resume gracefully when possible. --- Release 1.1.2 - 2003-04-03 grfconvert - Repaired flaw where GRF packet sequence numbers are checked and breaks are detected but output records were not getting broken over the sequence break. This causes waveform sample data to be missing from within output records which corrupts data. --- Release 1.1.1 - 2003-03-27 Changed all default configuration files to name channels using a SEED compatible naming convention. 'XX' is the network code, a 3 or 4 character station that describes the digitizer (e.g. 4CH for a PAR4CH), and a standard 3 character component identifer (e.g., EHZ). The 'XX' network code marks this data as private and/or temporary data that will not get distributed. grfd - Updated to current PAR4CH library code which allows use of new ECP/EPP and ECP/BPP parallel port modes. Set default counts/volt to 400000 accounting for PAR4CH Rev-D sensitivity change. grfconvert - Added -x option to cause the program to ignore (with a warning printed to the console) all data packets of 'unknown' or 'bad' time quality. Also added -L option to cause output filenames to be append to an ASCII list file immediately after the output file is closed. This option works with all output formats. grfviewer - Various J2SDK 1.4.1 cleanup issues. --- Release 1.1.0 - 2003-02-14 This release introduces the web browser based user interface for NetDAS and involved various small changes to grfd to support these new features. grfd - Added GPS status file functionallity along with the ability to enable/disable setting of the system clock on first lock and setting the GPS information message interval. New entries in the GPS section of the configuration file are: StatusFile, SetSystemClock, and InfoInterval. --- Release 1.0.9 - 2002-11-4 grftrig - Fixed message trigger bug that caused intermittent failure to trigger network. --- Release 1.0.8 - 2002-10-22 All libraries and applications now use ISO 8601 date and time representations. The 'calendar', or month/day representation and the 'ordinal', or day-of-year representation are supported. The 'week' representation is not supported at this time. The user specifies which representation will be used by setting the DATE_FORMAT environment variable, DATE_FORMAT=Calendar, or DATE_FORMAT=Ordinal. If this variable is set to some other value or is not set, the representation defaults to ordinal. Both formats use the 'extended' representation. Ordinal representations are of the form; yyyy-dddThh:mm:ss.ssssssZ, and calendar representations are of the form; yyyy-MM-DDThh:mm:ss.ssssssZ, where 'yyyy' is the four digit year, 'ddd' is the three digit ordinal day number (day-of-year), MM is the two digit month, DD is the two digit calendar day (day-of-month), the 'T' character is the time field designator, 'hh' is the two digit hour of day, 'mm' is the two digit minute of hour, 'ss.ssssss' is the two digit second of minute with up to six digits to the right of the decimal point show fractional seconds, and 'Z' indicates that times are UTC. grfd - Now supports only the PAR24b and PAR4CH digitizers. grfd_a64 - New grfd version supporting only the DSPA64 digitizer. grfd_db2k - New grfd version supporting the DaqBoard/200x digitizers. all grfd versions - Made digital output OnMessage event text not case-sensitive. grfconvert - SUDS format output now supports the new SUDS_LONGIDENT structure for SUDS version 1.51 (WinSUDS Utilities version 2.84). Also some general cleanup of program feedback and stats output. --- Release 1.0.7 - 2002-08-23 grfd - Fixed dspa64 Win32 library code screw up that caused Win32 build to fail on digitizer board initialization in Dspa64Thread. grflog - Modified statistics (-a) output, range now equals max-min+1 and mean and sigma now have two digits right of the decimal. grfconvert - Modified statistics (-f stats) output, range now equals max-min+1 and mean and sigma now have two digits right of the decimal. --- Release 1.0.6 - 2002-07-24 grfd - Disabled dspa64 median intercept PPS analysis. Time keeping on the dspa64 is now performed using a simple PPS edge detector as median intercept analysis and sampling rate steering is basically ineffective on PPS waveforms from this digitizer. grf2ew - Various clean up modifications so that Solaris builds are warning free. grflog - Add GRF packet image capture to file functionallity (-c option) and removed code that disable stdout output when the output file option (-o) was in use. grfconvert - Cleaned up stats output and added min and max. --- Release 1.0.5 - 2002-07-22 grf2ew - Modified handling of installation ID. Now the EW_INSTALLATION environment variable is checked. If it is set, its value becomes the default, otherwise the default is 'INST_WILD'. Then, if the InstallationID entry is found in the Earthworm section of the configuration file, its value overrides. Also, grf2ew now uses the Earthworm logging facility and the Logging group in the configuration file has been deprecated. --- Release 1.0.4 - 2002-07-01 grf2ew - Added configuration file and command line options to specify the Earthworm installation ID. grfd - Disabled dspa64 sampling rate correction logic. --- Release 1.0.3 - 2002-05-16 grfd - Fixed various dspa64 Linux library issues. Added logic to insure that the PPS channel, if defined, is always including in the scan list even if it is not being recorded. This ensure that PPS timing analysis will be performed. --- Release 1.0.2 - 2002-04-01 grfd - Fixed various par24b digital I/O issues. --- Release 1.0.1 - 2002-03-15 grfd - Added digital I/O support. grftrig - Added info message based trigger support to handle wired trigger via grfd digital I/O message events. grfconvert - Fixed several minor SUDS format issues. --- Release 1.0.0a - 2002-03-04 grftrig - Hot fix - Repaired invalid assertion in grfthread:getpacket(). --- Release 1.0.0 - 2002-02-01 grfd - Par4ch and Par24b Win2k issues resolved. grfd, grfhub, and grftrig - these servers can now run as Win32 services. Major cleanup of repository code and other minor cleanup as well. grftrig - fixed a fairly serious flaw in the network trigger logic that required voting channels to be in the triggered state in order to be counted against a network trigger. Now only the last trigger time is used. grfconvert - added simple ASCII (-S) output. --- Release 0.9.0 - 2001-10-29 grfd, grfhub, and grftrig now look for an environment variable 'GRF_ETC' and search the path specified in this variable for for their configuration files. This can overridden by specifying the configuration filespec on the command line. grfd and grfhub - Cleaned up the repository thread, added file naming format specifier and addressed GPS RMC message year field decode issue. --- Release 0.6.4a and b - 2001-10-15 grfconvert - Fixed Matlab format issues. Implemented Mini-SEED volumes. grfhub - Fixed invalid assertion in grfthread(). --- Release 0.6.4 - 2001-09-01 grfd - High sampling rate (>200sps) timing issues resolved. Several minor bugs and documentation fixes were included. --- Release 0.6.1 - 0.6.3 These were incremental releases fixing bugs and adding minor functionallity. Most changes here relate to FreeWave TDMA radio issues. --- Release 0.6.0 More changes to GRF causing compatibility break with previous versions. grfd - added FreeWave TDMA radio support. grhub - added FreeWave TDMA radio support. --- Release 0.5.0 Made major changes to GRF itself. This is a compatiblity break with all previous versions. grfd - support for the DSPA64 digitizer was added. --- Release 0.4.1 grfhub - support for DST streams was added. --- Release 0.4.0 First fully functional release.