Ping Viewer Documentation

Ping Viewer is the graphical user interface for the Blue Robotics Ping Altimeter and Echosounder. The application allows you to connect, configure, view data, and record data from a Ping device.

Ping Viewer main display

Installing and Running the Application

Follow the setup instructions for your operating system:

Windows

Download this .zip file, open the download location in the File Explorer, and extract it. Open the application by double clicking the executable file (pingviewer.exe). Windows will ask you to trust the software; click More InfoRun Anyway.

Windows protected your PC screen

Mac

Download this .dmg file, and double click it to open. Drag the Ping Viewer application icon to your Applications folder. Open the application by double clicking the icon in your Applications folder.

Install from .dmg

If you get an 'unidentified developer' notification when you try to open the application, you may adjust your security preferences to allow the application to run. Visit System Preferences -> Security and Privacy, click the lock and enter your password to make changes, then click 'Open Anyway'.

Mac Unindentified Developer

Mac System Preferences

Mac Security and Privacy

Linux

Download this .AppImage file. Edit the permissions of the .AppImage to have executable permission with the command line: chmod +x ping-viewer-linux.AppImage. Open the AppImage by double clicking it, or execute it from the command line: ./ping-viewer-linux.AppImage.

Remember to run the commands in the same path where the Appimage file is.

Connection Setup

To begin using the device, connect it to a USB - UART converter that operates on 5V like this Blue Robotics adapter. Then connect the converter to your computer's USB port. The Ping Viewer application should automatically detect your device and begin displaying data. If it does not, check the FAQ and Troubleshooting guide.

Visit the Device Manager menu for more connection options.

Main Application Interface

The Ping Viewer window consists of four important components:

  1. Distance Readout
  2. Distance Axis
  3. Return Plot
  4. Waterfall

Interface Annotated

Distance Readout

Distance Readout

The Distance Readout displays the distance to the target in the most recent measurement. This is the distance to the seafloor in depth sounding applications.

The confidence measurement for the most recent sample is displayed below the distance in the Distance readout. The color of the Distance Readout reflects the current confidence measurement, where green = 100%, yellow = 50% and red = 0%:

The size of the distance readout can be moved and adjusted.

Distance Axis

Distance Axis

The Distance Axis is labeled with bold numbers on the right-hand edge of the Waterfall. This axis represents the distance from the Ping device transducer. The axis runs vertically down the screen, with the face of the transducer (zero distance) located at the top of the window. The deeper/farther an object is from the transducer, the closer its return will appear to the bottom of the window. The Distance Axis scale automatically adjusts to display the current scanning range of the Ping device.

There is an orange arrow on the Distance Axis indicating the distance to the target in the most recent measurement (this is the same as the Distance Readout).

Return Plot

Return Plot

The Return Plot displays the return strength vs distance of the most recent profile sample. The plot displays the measurement of only a single dependent variable (return strength), and is simply mirrored for ease of viewing. Stronger returns appear as wider traces.

Note You may observe a very strong return at the top of the screen (at zero distance, essentially touching the device); this return is from the Ping device itself. When the Ping device emits the acoustic pulse, the device is still vibrating or 'ringing' like a bell when it begins measuring the return signal. This residual energy in the vibrations of the Ping device body is picked up as a return signal until it decays away.

Waterfall

Waterfall

The Waterfall is a three dimensional plot that occupies the main portion of the application window. The Waterfall plots consecutive profile samples (distance running vertically and color indicating signal strength). The horizontal axis is time; new data is displayed on the right edge of the Waterfall as older data moves to the left.

The color scheme (gradient) of the Waterfall can be customized.

Application and Device Settings

See here for instructions to switch between meters and feet for the application display.

To adjust the update rate and other Ping device settings, visit the relevant page in the 'Device Settings' section.