ping-protocol icon indicating copy to clipboard operation
ping-protocol copied to clipboard

Expand `ping1d` message set to cover more single-transducer functions

Open ES-Alexander opened this issue 4 months ago • 0 comments

It would be useful to have messages for functionalities like:

  • Set frequency range (float? BFLOAT16?)
  • Set the transmit pattern (uint8 array+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 uint8 number 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).

ES-Alexander avatar Aug 06 '25 10:08 ES-Alexander