$Id: grf_assigned_numbers.txt,v 1.6 2003/05/05 16:55:56 cvs Exp $ Copyright (c) 2000-2003 - Robert Banfill - All rights reserved. ----------------------------------------------------------------------- Master GRF assigned numbers list ----------------------------------------------------------------------- GRF unit identifiers An unsigned 32-bit integer value ----------------------------------------------------------------------- Unit identifer(s) Assigned to: ----------------------------------------------------------------------- 0 Reserved, do not use 1 - 999 Private identifiers 1000 Default identifer 1001 - 9999 NetDAS, PC Systems Design 10000 - 19999 GRF hubs 20000 - 29999 USGS-DST style digital streams 30000 - 30999 INEEL 31000 - 31999 University of Puerto Rico (UPR) 32000 - 4294967296 Available ----------------------------------------------------------------------- GRF port number IANA has assigned TCP and UDP registered port number 3757 for use with GRF servers. Here is the pertainent except from http://www.iana.org/assignments/port-numbers: grf-port 3757/tcp GRF Server Port grf-port 3757/udp GRF Server Port # Robert Banfill April 2003 This port number should be used by default by all GRF server and client applications but the port number must also be user configurable. ----------------------------------------------------------------------- GRF packet types An unsigned 8-bit integer value at offset 12 in all GRF packets ----------------------------------------------------------------------- Type Name Description ----------------------------------------------------------------------- 0x00 No Packet Undefined, null, or void packet type. 0x01 Data Waveform data packet. 0x02 ConnectReq Client connection request. 0x03 ConnectAck Client connection positive acknowledgement. 0x04 ConnectNak Client connection negative acknowledgement. 0x05 Command Command packet. 0x06 CommandAck Command positive acknowledgement. 0x07 CommandNak Command negative acknowledgement. 0x08 Information General informational message packet. 0x09 Disconnect Client disconnect request. 0x0A–0xFF Reserved These type codes are reserved for future use. ----------------------------------------------------------------------- GRF time quality identifiers An unsigned 8-bit integer value. ----------------------------------------------------------------------- Quality Name Description ----------------------------------------------------------------------- 0x00 Unknown The quality of the time is completely unknown. 0x01 Bad The time is known to be invalid. 0x02 Poor The time quality has been good but the timing system is currently free running. This typically indicates that a GPS is currently unlocked. 0x03 Good The timing system is actively correcting time relative to its reference. This typically means that a GPS is locked and that time is actively being corrected to the best of the system’s ability. 0x04 Very Good The time is known to be within +/- 500 microseconds of UTC. 0x05-0xFF Reserved These codes are reserved. ----------------------------------------------------------------------- GRF data type identifiers An unsigned 8-bit integer value. ----------------------------------------------------------------------- Type Name Description ----------------------------------------------------------------------- 0x00 INT32 Each sample is stored as a signed 32-bit integer occupying four bytes of storage. This is the least efficient data type in terms of storage. 0x01 INT24 Each sample is stored as a signed 24-bit integer occupying three bytes of storage. This is a useful format as most digitizers generate samples 24 or less significant bits. This format is sometimes called ‘byte-packed’. 0x02 CM8 This is a standard data encoding technique used by the GSE2.0 4 format. Compression ratios as high as 3.5:1 can be achieved with quiet data, but on average, ratios run from 2.0:1 to 2.5:1. This is the most efficient data type in terms of storage and is the most commonly used. 0x03-0xFF Reserved These codes are reserved.