https://github.com/geontech/rh_tools
Library of Python scripts to record from ports of Redhawk waveforms running of a specified domain.
https://github.com/geontech/rh_tools
debug redhawk
Last synced: about 1 year ago
JSON representation
Library of Python scripts to record from ports of Redhawk waveforms running of a specified domain.
- Host: GitHub
- URL: https://github.com/geontech/rh_tools
- Owner: Geontech
- Created: 2020-08-24T22:15:38.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-07-19T16:25:09.000Z (almost 5 years ago)
- Last Synced: 2025-01-21T12:48:41.824Z (over 1 year ago)
- Topics: debug, redhawk
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# rh_tools
This project houses some convenience function to help analyze and debug scenarios being run in Redhawk SDR framework.
---
## rh_tools.bulkio
### record_waveform (bulkio)
This will connect output bulkio ports of waveforms to FileSinks. The file sinks are configured to bluefiles to record information regarding the signal.
---
## rh_tools.domain
### domain_tools
This module houses some helper functions for finding the following things on a specified domain by name:
* Waveforms
* Event Channels
---
## rh_tools.message
This folder houses some modules for either recording or sending message events
### event_channel_to_waveform_forwarding
This will listen for messages on a given event channel on a given domain.
It will then forward messages to a waveform.
One use case is in the application of waveform you don't own. Instead of putting the event channel into the waveform, this will allow you to dynamically forward messages observed on the event channel to a given port on the waveform.
### record_waveform (messages)
This module uses a JSON file to specify the domain and waveform/message output ports to record from. The recordings are saved through pickle serialization for further analysis.
### send_message
This module uses a JSON file to specify a message structure. The message is either sent to a waveform's input message port or to an event channel (or both). This will allow quickly configuring a message to feed into the system for testing.
## rh_tools.scene
### run_custom
This uses JSON specification to denote the scene in terms of components, waveforms and connections.
#### Debug
Debug options are available to identify common things of interest at a given port.
| Option | Description |
| --- | --- |
| Throughput | Measure the element per second out for a given port |
| Message Sink | Identify the messages out of a given port |
Message Sink can be in the following format. In addition to displaying at runtime, the messages will be saved to the "output_file.json" in the "json" format. "pickle" is also supported
~~~json
["SourceID", "port", "output_file.json", "json"]
~~~
~~~bash
# convert json to CSV for ease of reviewing in a spreadsheet software
$ python -m rh_tools.scene.message_helper output_file.json output_file.csv --format json
~~~