External Control of SoundCheck via TCP/IP

Hardware

• SCM-3 calibrated measurement microphone Part # 4002
• AudioConnect Audio Interface with microphone power supply (Listen part #4050) or equivalent
• SCAmp audio power amplifier (Listen part #4060) or equivalent
• Impedance box/impedance reference (optional)

Software

• SoundCheck 18
• Python 3.7

Hardware Setup and Calibration

• Configure the hardware per the system diagram below
• Calibrate the Amplifier and microphone per the instructions in the SoundCheck user manual

You are now ready to run the SoundCheck external control example Python scripts.

Python Setup

Important! Prior to running the Python external control example scripts, please do the following:

• Make sure that SoundCheck 18 and Python 3.7 (or higher) are installed on your SoundCheck PC
• In your SoundCheck 18External Control ExamplesPython folder, follow the Installation Notes contained in the readme.txt file

SoundCheck Python Example Scripts

There are three example scripts included with SoundCheck 18.

1. SimpleSoundCheckExample.py

This script will launch SoundCheck, open and run the Complete Test example sequence, close SoundCheck and display the Fundamental response of the DUT on an x-y graph.

To run this script from a command line, copy and paste the following: python SimpleSoundCheckExample.py

2. FrequencyResponse.py

This script will run a simple frequency response example sequence from a command line interface. The example sequence utilizes the new MemoryListSet command which allows the user to create placeholder curves, values, results and waveforms in the MemoryList and pass values into the placeholders via external control.  The placeholders are created in the Configure Sequence editor as shown below:

To run this script from a command line, copy and paste the following:

python FrequencyResponse.py –launch –fstart=100000 –fstop=1000

This will launch SoundCheck, open the Frequency Response Parameterized sequence, Pass Start (10kHz) and Stop (1kHz) values into the Memory List for Stimulus range, run the sequence, close SoundCheck and show the Frequency Response Limit Pass/Fail verdict and margin in the terminal window.

3. WAVspectrum.py

This script will read any WAV file and use it as a stimulus for performing an FFT Spectrum measurement in SoundCheck.

To run this script from a command line, copy and paste the following:

python WAVSpectrum.py “C:SoundCheck 18wav filesitu real speech.wav” –launch –channel=1

This will launch SoundCheck, open the Spectrum Arbitrary Stimulus sequence, scale the WAV file of interest and pass it into the Memory List placeholder “”Stimulus”, run the sequence, close SoundCheck.

Notes

• The sequences and Python scripts referenced in this note are all included in the SoundCheck 18 install.
• No sequences or scripts are included in this distribution folder.
• The accompanying PDF “SoundCheck TCPIP Python Library” is also available in the SoundCheck 18 installation under SoundCheck 18External Control ExamplesPython

Download Sequence (zip file)
Download Sequence documentation (PDF)