Ping Viewer Documentation
Ping Viewer is the graphical user interface for the Blue Robotics Ping1D Altimeter and Echosounder and Ping360 Scanning Imaging Sonar. The application allows you to connect, configure, view data, and record data from a Ping device.
Installing and Running the Application
Follow the setup instructions for your operating system:
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 Info → Run Anyway.
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.
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'.
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:
Remember to run the commands in the same path where the Appimage file is.
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
When using the Ping1D, the Ping Viewer window consists of four important components:
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.
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).
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.
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.
For the Ping360, there is no distance readout, the waterfall is wrapped around into a circular (polar) plot showing the scan data at each angle, and the distance axis is along the right-hand edge of the sector scan. The return plot is the same as for the Ping1D, and shows the signal return strength over the full range of the latest ping.
The sector angle and range can be set to match your operating requirements, and there are options for heading integration and head down mode to adapt the display to your ROV and Ping360's orientation.
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.