Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sam210723/goesrecv-monitor

Status monitor for goesrecv demodulator and decoder.
https://github.com/sam210723/goesrecv-monitor

constellation goesrecv goestools xrit

Last synced: 3 months ago
JSON representation

Status monitor for goesrecv demodulator and decoder.

Awesome Lists containing this project

README

        

# goesrecv monitor

[![GitHub release](https://img.shields.io/github/release/sam210723/goesrecv-monitor.svg)](https://github.com/sam210723/goesrecv-monitor/releases/latest)
[![Github all releases](https://img.shields.io/github/downloads/sam210723/goesrecv-monitor/total.svg)](https://github.com/sam210723/goesrecv-monitor/releases/latest)
[![GitHub license](https://img.shields.io/github/license/sam210723/goesrecv-monitor.svg)](https://github.com/sam210723/goesrecv-monitor/master/LICENSE)

goesrecv monitor is a software utility for monitoring the status of [goesrecv](https://github.com/pietern/goestools) by [Pieter Noordhuis](https://twitter.com/pnoordhuis). goesrecv is a BPSK demodulator and CCSDS decoder for LRIT and HRIT downlinks transmitted by geostationary weather satellites like GOES-16/17 and GK-2A.

## Getting Started
Microsoft [.NET Framework Runtime v4.8](https://dotnet.microsoft.com/download/dotnet-framework/net48) ([direct download](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-web-installer)) is required to run **goesrecv monitor**. Once .NET is installed, download the [latest release](https://github.com/sam210723/goesrecv-monitor/releases/latest/download/goesrecv-monitor.zip) of **goesrecv monitor** and extract all files inside the ZIP to a new folder.

On the device running goesrecv, open ```goesrecv.conf``` and confirm the following lines are not commented (remove ```#```), then restart goesrecv.
```
[clock_recovery.sample_publisher]
bind = "tcp://0.0.0.0:5002"
send_buffer = 2097152

[demodulator.stats_publisher]
bind = "tcp://0.0.0.0:6001"

[decoder.stats_publisher]
bind = "tcp://0.0.0.0:6002"
```

Finally, open **goesrecv monitor** and enter the IP address of a device running goesrecv, then click ```Connect``` (or hit enter). The constellation plot and statistics list will start showing data.

If **goesrecv monitor** fails to connect, check for firewalls on the device running goesrecv. Inbound connections on ports ```5002```, ```6001``` and ```6002``` must be allowed.

## Statistics Plot
**goesrecv monitor** can plot the Viterbi and Reed-Solomon error counts in real-time using the Statistics Plot window. The plot has selectable time ranges from ``1 minute`` up to ``24 hours``. Plot data can be exported to a ``CSV`` file using the "Export CSV" button on the lower right of the window.

Launch the Statistics Plot by clicking on the "Open Statistics Plot" button in the main window.

## Large Statistics
The large statistics window is intended to improve visibility of the Viterbi error count and Signal Quality percentage from a distance. This is useful while while fine tuning the alignment of an antenna. The window background colour changes between red and green to indicate the Signal Lock state.

Launch the Large Statistics window by clicking on the "Open Large View" button in the main window.

## Debug Logs
**goesrecv monitor** can log certain information to a text file for the purposes of debugging crashes or configuration issues. Changing the ```logging``` setting in ```goesrecv-monitor.exe.config``` to either ```True``` or ```False``` will enable or disable the log file.
```

False

```

```

True

```