ping-protocol
ping-protocol copied to clipboard
Expand `ping1d` message set to cover more single-transducer functions
It would be useful to have messages for functionalities like:
- Set frequency range (
float?BFLOAT16?) - Set the transmit pattern (
uint8array+length, 0 is off, 1 is min freq, 255 is max freq, transmit for proportions of transmit duration, max length specified by device -> single freq, sweep, custom) - Set transmit mode (frequency modulation, phase modulation, direct waveform, modulation scheme? (PSK?))
- Set pulse duration (can also function as hydrophone receive duration)
- Transmit pulse command (with
uint8number of repeats, 0 is infinite) - Set receive mode (echosounder, acoustic modem, frequency detector, hydrophone)
- Set receiver raw sample rate (as multiple of transmit frequency?)
- Set receiver raw sample precision?
- Set receiver aggregation amount
- Set detector mode (amplitude trigger, peak trigger, transmit pattern correlation)
- Set max scanning distance (for auto mode)
- NACK status code (unsupported vs invalid vs ...)
- optional field ID
- optional text reason
If a device firmware doesn't support a message type that should be fine - ideally the relevant control software will have fallbacks where applicable (e.g. like for ping360 manual vs auto transmitting).