20
922-20007052/1.2
Enabling the M3 Sonar API
You can use the Windows command prompt to enable the M3 Sonar API.
Prerequisites
• Your computer must be on the same network as the Sonar Head.
• You must have discovered your Sonar Head using the M3 software.
• The M3 software should not be running.
Caution
Do not run the M3 software and the M3 Sonar API at the same time. Running both may
cause a conflict with unpredictable results.
Context
The following command-prompt switches can be used when enabling the M3 Sonar API.
•
/api
This switch runs the M3 Sonar API in the background. When enabled, the graphical
user interface for the M3 software will not be visible.
•
/no_dm
This switch disables the internal Display Manager for cases where low CPU usage is
needed. Use this switch if you don’t need Display Manager functions.
Note
Use the
/no_dm
switch for imaging applications only. Do not use the
/no_dm
switch
for profiling applications.
Procedure
1
In the bottom-left corner of your desktop, type “cmd” into the Windows search
box, then press
Enter
.
Observe that the
Command Prompt
window opens.
2
For imaging applications, type the following into the command prompt, then press
Enter
.
start c:\kml\m3_v0240\bin\m3.exe /api /no_dm
Alternatively, for profiling applications, type the following into the command
prompt, then press
Enter
.
start c:\kml\m3_v0240\bin\m3.exe /api
If you don’t see any error messages, the M3 Sonar API should be enabled.
M3 Sonar API Instruction Manual