daniestevez / gr-satellites

GNU Radio decoder for Amateur satellites
GNU General Public License v3.0
758 stars 156 forks source link

BME WebSocket telmetry submitter (maint-3.8 branch) #477

Closed daniestevez closed 1 year ago

daniestevez commented 1 year ago

This adds support for sending telemetry to the BME WebSocket server, which is used by MRC-100.

The implementation uses the Python websocket-client package (Debian /Ubuntu package python3-websocket), which has been added as a dependency in the installation instructions in the documentation and in the debian package control file. The build-ubuntu CI action has been updated to include python3-websocket in the Docker image.

The older BME HTTP telemetry server has been marked as deprecated, since it is no longer operational.

K4KDR commented 1 year ago

Thank you for adding this feature!

I see the following at https://gr-satellites.readthedocs.io/en/latest/command_line.html?highlight=bme#telemetry-submission

The BME server (WebSocket) does not require any registration or additional configuration.

... and I also see that ~/gr-satellites/python/satyaml/MRC-100.yml includes:

telemetry_servers:
  - BMEWS

My question is, does that entry in the .yml file cause the telemetry to be submitted automatically?

Or, do we also need to incorporate a BME Telemetry Forwarder (WebSocket) block in our flowgraphs?

Thanks!

daniestevez commented 1 year ago

Telemetry is submitted automatically when using the gr_satellites command line tool (as long as you have telemetry submission enabled in .gr_satellites/config.ini). If you're using your own flowgraph, you need to include either the BME Telemetry Forwarder (WebSocket) block or the Telemetry Submit (and set it to "BME Telemetry Server (WebSocket)") in the flowgraph.

K4KDR commented 1 year ago

Wonderful! I wasn't clear on that.

Thanks so much!