f522d88fc5
Update CMakeLists.txt to allow static libraries to be built |
||
---|---|---|
.. | ||
CMakeLists.txt | ||
navtexdemod.cpp | ||
navtexdemod.h | ||
navtexdemodbaseband.cpp | ||
navtexdemodbaseband.h | ||
navtexdemodgui.cpp | ||
navtexdemodgui.h | ||
navtexdemodgui.ui | ||
navtexdemodplugin.cpp | ||
navtexdemodplugin.h | ||
navtexdemodsettings.cpp | ||
navtexdemodsettings.h | ||
navtexdemodsink.cpp | ||
navtexdemodsink.h | ||
navtexdemodwebapiadapter.cpp | ||
navtexdemodwebapiadapter.h | ||
readme.md |
Navtex Demodulator Plugin
Introduction
This plugin can be used to demodulate Navtex (Navigational Telex) transmissions, which contain marine navigational and meteorological warnings and forecasts. These are broadcast worldwide on 518kHz (in English for international messages), 490kHz (often in the local language for national messages) and 4209.5kHz. Navtex messages are transmitted using FSK with 170Hz separation at 100 baud, using SITOR-B encoding. The Map feature can display the location of Navtex transmitters, along with their transmission times and frequencies.
The Navtex demodulator will only attempt to start demodulating data after it detects the phasing signal, that is broadcast before each message. Therefore, if you enable the demodulator part way through a message, it may take a while before you see any output, even if the signal appears strong, as the data rate is so low.
Interface
The top and bottom bars of the channel window are described here
1: Frequency shift from center frequency of reception
Use the wheels to adjust the frequency shift in Hz from the center frequency of reception. Left click on a digit sets the cursor position at this digit. Right click on a digit sets all digits on the right to zero. This effectively floors value at the digit position. Wheels are moved with the mousewheel while pointing at the wheel or by selecting the wheel with the left mouse click and using the keyboard arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2.
2: Channel power
Average total power in dB relative to a +/- 1.0 amplitude signal received in the pass band.
3: Level meter in dB
- top bar (green): average value
- bottom bar (blue green): instantaneous peak value
- tip vertical bar (bright green): peak hold value
4: Navarea
Specifies the geographical area in which the receiver is in. This enables the plugin to decode transmitter station identifiers, and display which transmitter the current transmission timeslot is assigned to (5). Note that with good propagation conditions, it is possible to receive messages from another area, so the station indicated in the message table (17) should be checked against the location given in the received message text.
5: TX
Displays which transmitter is assigned the current 10 minute timeslot.
6: Find TX On Map
If the Map feature is open, when clicked, the Map will be centered on the current transmitter (5).
7: RF Bandwidth
This specifies the bandwidth of a filter that is applied to the input signal to limit the RF bandwidth.
8: UDP
When checked, received messages are forwarded to the specified UDP address (9) and port (10).
9: UDP address
IP address of the host to forward received messages to via UDP.
10: UDP port
UDP port number to forward received messages to.
11: Station Filter
This drop down displays a list of all stations which messages have been received from. When a station other than "All" is selected, only messages from that station will be displayed in the table.
12: Message Type Filter
This drop down displays a list of all message types that have been received. When a type other than "All" is selected, only messages with that type will be displayed in the table.
13: Start/stop Logging Messages to .csv File
When checked, writes all received messages to a .csv file, specified by (14).
14: .csv Log Filename
Click to specify the name of the .csv file which received messages are logged to.
15: Read Data from .csv File
Click to specify a previously written .csv log file, which is read and used to update the table.
16: Received Text
The received text area shows text as it is received.
17: Received Messages Table
The received messages table displays the contents of the messages that have been received.
- Date - Date the message was received.
- Time - Time the message was received.
- SID - Station identifier of the transmitting station.
- Station - SID decoded according to the currently selected navarea (4).
- TID - Message type identifier.
- MID - Message identifier.
- Message - The message text.
- Errors - The number of characters that were received with detected errors.
- Error % - The percentage of characters that were received with errors.
- RSSI - Average channel power in dB, while receiving the message.
Right clicking on the header will open a menu allowing you to select which columns are visible, or locate the station in the selected row on the Map. To reorder the columns, left click and drag left or right a column header. Left click on a header to sort the table by the data in that column.