From b0897dcf93b95da0d6f55c7848db1dc85a01e9c8 Mon Sep 17 00:00:00 2001 From: f4exb Date: Sat, 14 Jan 2017 06:09:29 +0100 Subject: [PATCH] Added details of the status messages file --- Readme.md | 2 + messagefile.md | 157 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 159 insertions(+) create mode 100644 messagefile.md diff --git a/Readme.md b/Readme.md index 72413b9..8d16a36 100644 --- a/Readme.md +++ b/Readme.md @@ -71,6 +71,8 @@ You can also run the example files in the `samples` directory. Please refer to t For more details refer to the online help with the `-h` option: `dsdccx -h` +Since version 1.6 dsdccx has the capability of sending regularly the traffic status messages to a file using the `-M` option. See [messagefile.md](messagefile.md) for details. +

Developpers notes

Structure overview

diff --git a/messagefile.md b/messagefile.md new file mode 100644 index 0000000..01366ff --- /dev/null +++ b/messagefile.md @@ -0,0 +1,157 @@ +

Message file details

+ +

Introduction

+ +Since version 1.6 dsdccx has the capability of sending regularly the traffic status messages to a file using the `-M` option. The `-m` option specifies the rate at which the information is polled and written to file. It is expressed in seconds at a 48 kS/s rate and has a minimum value of 0.1s. At 0.1s it will poll everu 48000*0.1 = 4800 samples. + +The polling period will match an actual time interval only during live operation when samples are fed from a real device although buffering might alter this. + +

File format

+ +There is one line per polling occurence with a fixed format depending on the protocol. For all protocols the line starts with a timestamp and a protocol identifier. Details by protocol are given next. + +

DMR

+ +``` + 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 + 0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5.... + 1484364328.297:DMR>Sta: BS S1: /04 IDL S2: *04 VLC 02222223>G00019535 + -------------- --- -- -- .-- --- -------- .-------- -- .-- --- -------- .-------- + 1 2 3 4 56 7 8 9A 4 56 7 8 9A + +``` + - **1**: Timestamp in seconds since epoch with millisecond precision + - **2**: Protocol indicator: `DMR` + - **3**: Station type: + - MS: Mobile station + - BS: Base station + - **4**: Slot #1 (S1) or slot #2 (S2) follows with the same information for each slot + - **5**: Channel status derived from CACH information: + - *: Busy. That is the AT bit on the opposite channel is on. + - .: Clear. That is the AT bit on the opposite channel is off. + - /: The CACH could not be decoded and information is missing + - **6**: Color code from 0 to 15 or `--` if color code could no be decoded + - **7**: Slot type: + - VOX: Voice block + - IDL: Data idle block + - VLC: Voice link control block + - TLC: Terminator with Link Control information data block + - CSB: CSBK (Control Signalling BlocK) data block + - MBH: Multi Block Control block header data block + - MBC: Multi Block Control block continuation data block + - DAH: Data header block + - D12: 1/2 rate data block + - D34: 3/4 rate data block + - DB1: Full rate data block + - RES: Reserved data block + - UNK: unknown data type or could not be decoded + - **8**: Source address (24 bits) as defined in the DMR ETSI standard + - **9**: Address type indicator: + - G: Ggroup address + - U: Unit (individual) address + - **A**: Target address (24 bits) as defined in the DMR ETSI standard + +

dPMR

+ +``` + 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 + 0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5.... + 1484364141.663:DPM>VO CC: 1757 OI: 00000302 CI: 00014653 + -------------- --- -- ---- -------- -------- + 1 2 3 4 5 6 + +``` + - **1**: Timestamp in seconds since epoch with millisecond precision + - **2**: Protocol indicator: `DMR` + - **3**: dPMR frame type: + - --: Undefined + - HD: Header of FS1 type + - PY: Payload frame of a sitll undetermined type + - VO: Voice frame + - VD: Voice and data frame + - D1: Data without FEC frame + - D2: Data with FEC frame + - XS: Extended search: looking for a new payload frame when out of sequence + - EN: End frame + - **4**: Colour code in decimal (12 bits) + - **5**: Own ID. Sender's identification code in decimal (24 bits). + - **6**: Called ID. Called party's identification code in decimal (24 bits). + +

D-Star

+ +``` + 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 9 9 + 0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5.... + 1484364098.148:DST>F1NSR /ID51>CQCQCQ |F1ZIL B>F1ZIL B|YANNICK ST RAPHAEL | :000/00000.0 + -------------- --- -------- ---- -------- -------- -------- -------------------- ------ --- ------- + 1 2 3 4 5 6 7 8 9 A B + +``` + - **1**: Timestamp in seconds since epoch with millisecond precision + - **2**: Protocol indicator: `DST` + - **3**: Origin callsign (MY) + - **4**: Origin informative suffix + - **5**: Destination callsign (YOUR or UR) + - **6**: Origin repeater callsign (RPT1) + - **7**: Destination repeater callsign (RPT2) + - **8**: Informative text + - **9**: 6 character locator a.k.a. Maidenhead locator + - **A**: Bearing to the station when own position is specified (option TBD) + - **B**: Distance to the station when own position is specified (option TBD) + +

YSF (Yaesu System Fusion)

+ +``` + 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 + 0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5.... + 1484365141.179:YSF>C V2 GC 0:7 WL000|F6FCE >**********|F5ZOO-R1 >F5ZOO-R1 |E55vv + -------------- --- . -- -- . . ..--- ---------- ---------- ---------- ---------- ----- + 1 2 3 4 5 6 7 89A B C D E F + +``` + - **1**: Timestamp in seconds since epoch with millisecond precision + - **2**: Protocol indicator: `YSF` + - **3**: Frame type: + - H: header + - C: channel + - T: terminator + - S: test + - **4**: Channel type: + - V1: voice/data mode 1 + - V2: voice/data mode 2 (as in the example) + - VF: voice full rate + - DF: data full rate + - **5**: Call mode: + - GC: group call + - RI: radio ID + - RE: reserved + - IN: individual call + - **6**: Total number of blocks + - **7**: Total number of frames + - **8**: Bandwidth mode: + - N: narrow band mode + - W: wide band mode + - **9**: Path type: + - I: Internet path + - L: local path + - **A**: Squelch code (0..127) or dashes `---` if the YSF squelch is not active + - **B**: Origin callsign + - **C**: Destination callsign. It is filled with stars `*` when call is made to all stations (similar to the CQCQCQ in D-Star) + - **D**: Origin repeater callsign + - **E**: Destination repeater callsign + - **F**: Originator radio ID. This is the unique character string assigned to the device by the manufacturer. + +

Undefined

+ +When the system has not acquired synchronization a dummy line with `XXX` as protocol indicator is recorded: + +``` + 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 + 0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5....0....5.... + 1484365141.179:XXX> + -------------- --- + 1 2 + +``` + - **1**: Timestamp in seconds since epoch with millisecond precision + - **2**: Protocol indicator: `XXX`