File: messagefile.md

package info (click to toggle)
dsdcc 1.9.6-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 13,448 kB
  • sloc: cpp: 15,245; makefile: 46
file content (158 lines) | stat: -rw-r--r-- 6,962 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
<h1>Message file details</h1>

<h2>Introduction</h2>

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. 

<h2>File format</h2>

There is one line per polling occurrence 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.

<h3>DMR</h3>

```
           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
    - USB: Unified Single Block Data
    - 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  
  
<h3>dPMR</h3>

```
           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 still 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).

<h3>D-Star</h3>

```
           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 origin station when locator is defined and own position is specified (options -P and -Q)
  - **B**: Distance to the origin station when locator is defined and own position is specified (options -P and -Q)
  
<h3>YSF (Yaesu System Fusion)</h3>

```
           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.
  
<h3>Undefined</h3>

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`