Probe Point Configuration

The Probe Point functionality facilitates the streaming of data from any stage of the signal flow to GTT, enabling the analysis, recording, or reuse of the data within IVP. The primary purpose of this feature is to provide the capability to receive data from an audio object and perform real-time analysis of audio input using the Real-time Analyzer view.

Related Topics

Configure Probe Point

To enable probe points per core:

  1. Open the Device View and select the Virtual core layer of the device.
  2. Go to the Virtual core properties, select the Streaming checkbox, and set a number of probe points per core.

Only the configured number of probe points can be enabled in signal flow per core.

The configured probe points will be sent to the device using the “Send Device Config” feature. This configuration can be fetched from the device using the “Load Device Config” feature.

In order to utilize streaming for state variables, it is necessary to enable this feature. However, considering its resource-intensive nature, this high configuration feature can be skipped to ensure optimal utilization of MIPS and memory. The count of probe points specifically pertains to audio streams and a maximum of 16 probe points are supported for a core.

If Streaming is disabled for the core, the number of probe points input field will be disabled, and streamable state variables will be excluded for that core in the streaming window.

Add Probe Point

The Probe Point context menu for selected connections has the below options:

  • Add: The feature allows you to add a probe point on a selected connection source point. Additionally, the default state of the probe point is set to the enabled state.

To add a probe point on the virtual connection:

  • Right-click on the virtual connection > Probe Point > select Add.

    After adding probe points, the source point pin connection will be visually highlighted with a bright purple-colored icon.
    A screen shot of a computer Description automatically generated with low confidence

Remove Probe Point

  • Remove: You can remove a probe point from the selected connection.

To remove the probe point from the virtual connection:

  • Right-click on the virtual connection > Probe Point > select Remove.
    A screenshot of a computer Description automatically generated
  • State: You can alter the state of the probe point on a selected connection.
    A screenshot of a computer Description automatically generated
Enable Change the probe pin state to enable and the pin will be highlighted with a bright purple color icon. A purple circle with white circles Description automatically generated with low confidence
Disable Change the probe pin state to disable and the pin will be highlighted with grey dark purple color icon.

A picture containing text, screenshot, diagram, line Description automatically generated

Manage Probe points

Open the Probe point management window through the ‘Manage probe Points’ ribbon button.

The Manage Probe Points allows you to enable or disable probe points and edit probe point names in the Probe Point Management window.

In the Probe Point Management window, the probe points are organized in the following order.

  1. Device [Device address]
  2. Virtual Core name
  3. Instance [Sample Rate]
  4. Audio Object Name [Block- Id]

Additionally, the State, Pin Label, and Probe point names are displayed for each probe point.

This window will consistently stay synchronized with the probe point states in the Signal Flow Designer.

After making all the necessary modifications, click Save to persist edited probe point names.

Configure probe points in RTA/IVP

  1. Open the Advanced Settings window
  2. Select Probe Points as Analyzer / Recorder / Sound outsources.
  3. Click Done.

To record the probe point signal.

Start Probe Point Streaming

Pre-requisites:

  • Make sure to enable the Probe Point feature for the core.
  • Ensure that the number of active probe points is set correctly.
  • Ensure that the Probe Points used in the IVP configuration are correctly configured as a source (Analyzer, Recorder, etc).
  • Start Plugin Host and establish a connection with the device.

Use IVP Block Length <= 512 for probing to avoid frame dropping.

Once you have configured as per the above pre-requisites, click on the Probe Point to start.

Example of Streamed data.

Device Reboot

When you click on a “Reboot” button, the device will restart. During the reboot process, the plugin host will go through a shutdown sequence and then start up again.
After the reboot, the plugin host will return to its previous state.

RTA Shortcuts

The RTA shortcut keys allow you to perform quick action using keyboard keys. Various shortcuts are implemented in the RTA module to increase efficiency and facilitate easy navigation. These shortcuts provide quick access to frequently used functions within the GTT.

You cannot open multiple windows using a shortcut.

The table below provides you detail about available shortcuts in RTA module.

Shortcuts keys Operation Shortcuts keys Operation
F2 Channels Quick Settings window. Ctrl+Delete Delete selected (highlighted) trace of highlighted chart.
F3 Generator Quick Settings window. Ctrl+Shift+Delete Delete all traces of highlighted chart.
F4 Analyzer Quick Settings window. Alt+A  Switches between Averaging Mode.
F6 Microphone Calibration window . Alt+G Start/Stop Generator.
F7 Export Settings Window Dialog. Alt+M Multiplexer Mode (Average).
F8 Import Settings Window Dialog. Alt+O Switch between Banding Mode.
F9 RTA Advanced Settings window. Alt+R Refresh average values.
Ctrl+C Perform Capture Trace action into the traces panel of highlighted chart. Ctrl+A Hide all traces of traces panel of highlighted chart.
Ctrl+E Export selected (highlighted) trace of highlighted chart. Ctrl+Shift+E Export All Traces of highlighted chart.
Ctrl+I Import Trace into the traces panel of highlighted chart. Ctrl+H Hide selected (highlighted trace) of highlighted chart.
Ctrl+Shift+C Recapture action of selected (highlighted) trace of highlighted chart. Spacebar Start/Stop Analyzer.
Ctrl+Shift+I Import List Trace into the traces panel of highlighted chart. ESC Close Floatable window.

Zoom and Scroll Controls

The following controls can be used to perform zoom and scroll functions on the graph.

Alt + MW (Zoom on Y axis) Expand the Y axis to zoom in or out of the values on the graph.
Ctrl + MW (Zoom on X axis) Expand the Y axis to zoom in or out of the values on the graph.
Shift + MW (Scroll on X axis) Scroll the visible graph along the X axis up to the visible or configured limits, that is, if the graph shows the maximum visible value in the configured X, the scroll will not be available.
MW (Scroll on X axis) Scroll the visible graph along the Y axis up to the visible or configured limits, that is, if the graph shows the maximum visible value in the configured Y, the scroll will not be available.

MW=Mouse Wheel 

Trace Functionalities

Select/ Deselect All Traces

At the top of the Traces view, there is a checkbox that enables you to either select or deselect all traces. When you select the checkbox at the top, all traces within the trace window will be automatically selected. Similarly, when the top checkbox is deselected, it will unselect all the traces in the trace window.

When the top checkbox in the upper trace window is selected in linking mode, it automatically selects all the traces from both the upper and lower trace windows. Similarly, when the top checkbox in the upper trace window is unselected, it will unselect all the traces from both the upper and lower trace windows.

Lock / Unlock Traces

When the trace is locked, the recapture on that trace is disabled. Once unlocked the trace can be recaptured. This button toggles between locked and unlocked states.

Recapture Traces

The trace can be recaptured from the signal for the same channel using this option.

Select / Unselect Trace

The trace can be made visible and hidden on the graph using this option.

Show Measurement

The measurements can be shown on the graph for the trace using this option.

Trace Configuration

Enabling Peak Hold Trace

The Peak Hold Trace can be activated using a checkbox in the Advanced Analyzer menu. It’s time constants Forever, Slow, Fast can be selected in the normal Analyzer Settings Menu. The peak hold trace is reset by choosing Delete for the corresponding trace in the trace list.

To activate the Peak Hold Trace:

  1. Open the Advanced Settings, and enable Peak Trace feature on the Analyzer tab.

A screenshot of a computer Description automatically generated with medium confidence

You need to enable a checkbox located in the “Advanced Analyzer” setting.

Setting Time Constants

You can configure desired time constants for the Peak Hold Trace, such as “Forever,” “Slow,” or “Fast” in the Analyzer Settings window.

If you wish to reset the Peak Hold Trace, you can choose the “Delete” option for the corresponding trace in the trace list.

Weighting on Captured Traces

The A-weighting, B-weighting, C-weighting and D-weighting are different frequency weightings that simulate how sensitive various frequencies are to the human ear.

  • A-weighting (dB(A)): A-weighting is used to approximate the sensitivity of the human ear to different frequencies at low sound pressure levels. It reduces the contribution of low and high frequencies to better represent the way humans perceive sound in relatively quiet environments. A-weighted measurements are often used in assessing environmental noise levels and evaluating noise exposure limits for occupational health and safety.
  • B-weighting (dB(B)): B-weighting is rarely used and has limited practical application. It was initially intended to approximate the ear’s sensitivity at moderate sound pressure levels, but it didn’t gain widespread acceptance due to certain limitations. A-weighting has largely taken the place of B-weighting in modern applications..
  • C-weighting (dB(C)): C-weighting is used to measure the overall sound pressure level without any frequency weighting. It includes the entire audible frequency range and does not attenuate any specific frequencies. C-weighted measurements are commonly employed in situations where a flat frequency response is desired or when assessing high-level noise sources, such as loudspeakers or industrial machinery.
  • D-weighting(dB(D)): D Weighting is used to measure sound pressure levels with a frequency weighting that is specifically designed to reflect the human ear’s sensitivity to loud noises, particularly in the presence of high-level aircraft noise. Unlike C-weighting, D-weighting emphasizes certain frequency ranges to better correlate with the subjective perception of aircraft noise.

Weighting feature is used to adjust measurements to better align with the perceived loudness by human listeners.

When you select the “Trace Settings” option in the Traces toolbar, a new window will open, allowing you to choose the desired Weighting (Flat/Unweighted, A, B, C, and D).

Based on desired selection weighting will be applied to all captured traces. Each trace RMS SPL value will be displayed in traces view as shown below.

Trace Properties

You can modify all the captured traces. Double-click on the trace to open Trace properties window.

On the Trace properties window you can modify the following property.

  • Name of the trace
  • Offset value
  • Color
  • Comment, the provided comment will be exported and imported along with trace.

Smoothing on Captured Traces

Smoothing is a technique that reduces variations in plotted curves to improve the visual perception of trends or patterns in frequency response or level measurements. It is commonly used in audio analysis and equalization tasks to enhance clarity while considering the trade-off between noise reduction and preservation of important details.

When you select the “Trace Settings” option in the Traces toolbar, a new window will open, where you can select desired octave banding for smoothing. Based on desired selection smoothing will be applied to all captured traces.

The smoothed curve with the chosen option looks like below figure.

Recorder Settings

In RTA, the Recorder is a sink type that allows recording in mono or stereo mode, with the option to configure the number of channels to be recorded. The Recorder supports both “Append” and “Overwrite” modes and can be synchronized with the generator signal.

To configure the Recorder settings, navigate to the Recorder tab in the RTA Settings window.

The below example shows Recorder is set to 5 channels with mono mode.

  • Mono mode: 1 channel will record per file.
  • Stereo mode: 2 channels will record per file. Recording can be appended to the same file or overwritten using Record mode.
  • Sync with Generator: The Recorder and Generator will be in sync with this option. When the Generator starts, the recording begins automatically, and vice versa.
    Choose the generator instance from the drop-down menu that is synchronized with the recorder.
  • Use Scale Offset: The scaling factor can be used to amplify or attenuate the recorded signal, as explained in the information tooltip. Scale offset can be set per recording channel.

When you click on the “Close” button, the selected file for the channel is removed from the tab settings, and the channel is closed for recording until the settings are applied with the “Done” button.

Max supported recording channels are 64 and supported recording file format is .Wav.

Once you have finished configuring the recorder, use Start or Stop the recorder and Pause or Resume it.

Sound Card Settings

Before you set the “Sound In” and “Sound Out” devices, make sure you have configured sound card settings like Host API (Driver Protocol), Device, Sample Rate, and Block length of the sound card. Refer to the Sound Card Configuration to know about configuration details.

After selecting a Host API, it is necessary to choose the Sound In and Sound Out devices. If no device is selected, RTA will operate in a silent mode, which can be useful for verifying generator modes or analyzing pre-recorded measurements from a .wav file.

The stream channel pairs, labeled as Sound In 1 to 16 and Sound Out 1 to 16, are accessible in the analyzer and routing settings. You can select these channels from the context menu to establish connections between sound card channels and RTA processing blocks.

In case the device block length is higher than your sound card block length. It will introduce an additional latency in the signal chain, which will cause a shift in the start position and missing blocks at the end of the recording.

For example, if the device block length is equal to 4096 and the sound card block length is equal to 1024, there will be a “drift” of 3-blocklengths or 3072 as you can see below.

Plugin Host Setting

The Plugin Host is a host for virtual amp dll. The Plugin Host supports up to 3 instances of plugins (virtualAmp.dll in 64-bit), which are executed in series.

The block sizes and sample rate will be determined by the sound card settings and will be applied to all plugins. If the block size of the device/instance does not match the plugin’s block size, the plugin needs to internally handle the block size conversion.

The Virtual Amp does not support sample rate conversion in the current version. If a sample rate conversion is attempted, an error message will be displayed, and the processing will be stopped.

Steps to configure plugin host:

  1. Navigate to the IVP RTA tab and select Advanced from the ribbon bar. This opens the RTA Settings dialogue box.
  2. On the RTA Settings dialogue box, select the Plugins tab.
  3. Click on the folder icon to browse the xAF library path.
  4. Set the port number under the Port box.
  5. Enable the Bypass option (optional), if you prefer the input to be passed directly to the next plugin or output without undergoing any processing.
  6. Click on Apply. The number of inputs, number of outputs, and plugin type will be automatically updated based on the provided signal flow. Similarly, you can set the remaining plugins.
    Click on Reset (optional), to set back all the values in a specific row to their default values.
  7. Go to the Routing [in] tab.
  8. Set the inputs for “Plugin Host” (such as Generator1 and Generator2). These inputs will determine the channels from the Plugin Host that will be used.
  9. Set inputs for “SoundOut” in order to route the PluginHost output channels to the sound card outputs.A screenshot of a computer Description automatically generated
  10. If you want to display the output of PluginHost in RTA (optional), go to the Analyzer tab and select Plugin Host output as the channel source.
  11. Set the Channel source (such as Generator1, Generator2, PluginHost1, and PluginHost2) to display in the chart.
  12. Once the settings have been updated, click Done.

    By default (no flash file available next to the virtualAmp.dll), the number of in-/outputs in the plugin host is -1.

    The default Port Number starts from 25001.

    Connect to the device through Plugin Host

  13. Click Plugin Host.

    The Plugin host button is disabled until you select a valid plugin host.

  14. Switch to the Signal Flow Designer window, configure signal flow, and click on Send Signal Flow. A pop-up message will ask you to reboot the device.
  15. Switch to the IVP RTA tab and click Reboot.

  16. Switch to the Device Designer tab and click on Connect Device to connect to the device.
  17. A device synchronization dialogue box will appear, enable the desired synchronization option, and click Send.
    A screenshot of a computer error message Description automatically generated with low confidence

    If AmpSrv is unable to connect, close it and retry.

    Now you can perform tuning on the IVP RTA.

  18. Switch To the IVP RTA tab, and click on the Generator and Analyzer option. In the graph section, the generated signal will be displayed.

  19. Click on Channels to see the values of each channel. If you want to configure the graph, click on Advance Settings and go to the Graph setting.

Advance Analyzer Settings

Click on the “Analyzer Settings” to open the advanced RTA setting dialogue box. Here you can configure different analyzer settings.

The following modifications can be made in the Analyzer setting window using the channels list:

  • Source: This defines the input of a certain analyzer channel. By clicking on the control a context menu pops up from which the desired source can be chosen.

    If there is no input available, “None” will be shown as the source by default.

    Graphical user interface, application Description automatically generated

  • Name: Enter the name of an analyzer channel. This name appears in the channel viewer and will be set as a default name when storing measurements as traces.
  • Calib[db]: When a channel is being calibrated for a certain microphone the determined value appears here. It can also be overwritten by entering a desired value. The unit is “dBFS”; the analyzer input stream will be scaled by this value. Based on the microphone calibration unit, this unit will be set. The same unit will be suffixed to the Y-Axis unit for the Spectrum mode graph. Examples: dBFS(RMS), dBSPL(RMS) etc.
  • AvgCH: When the analyzer is in “Multiplexer” mode this control determines to which “Average” channel the analyzer source is added. When the channel is “0,” it is not included; when it is “1” or “2,” it is added to “Average-1” or “Average-2,” respectively.

    Channels 17 and 18 are reserved for the “Average” channels. Here only the name can be edited.

  • Delay: Add or subtract time delay in milliseconds. In Phase measurement, we can add/subtract time delay to compensate for HW and/or acoustic delay.
  • Peak Trace: Peak hold trace allows the analyzer to display a secondary live trace for each channel showing the highest amplitude values for each frequency. This feature helps to mark the highest amplitude reached at each frequency.

    By default, all the peak traces will be disabled. This can be enabled using the checkbox available in the analyzer settings tab for each channel.

Click “Delete” in the data context menu of the peak trace in the trace list to reset the peak trace. When a peak trace is deleted, the database will also delete the current peak trace and create a new one.

You should be able to select a time constant for peak trace. Depending on the time constant setting, the peak hold trace shall show the maximum value that occurred within the defined moving time window.

Peak Hold settings include:

  • Slow
  • Fast
  • Forever

Trace Toolbar

The Trace Toolbar consists of several functions.

Capture Traces

The Capture Traces function provides two options.

  • Click on the button to capture all traces.
  • Drop-down menu to capture individual traces.
  • The new captures are highlighted with a green square.

Add Math Operation

The Add Math Operation allows you to generate an unweighted average, a difference, or a sum trace from the selected traces using a drop-down menu, you can identify the new traces with the green square.

For the average math operation, if the involved traces have SPL values, the resulting average trace will also include a calculated SPL value.

  • For Text Traces, the resulting average trace will have only one type of SPL value.
  • For Captured Traces, the resulting average trace will include SPL values for all weightings (A, B, C, and D).

Trace Settings

The Trace Settings allows you to configure Weighting and Smoothing functionality.

Undo Capture Traces

Click on the Undo Capture Traces, to reverse the last captured traces upto 3 traces.

 

Redo Capture Traces

Click on the Redo Capture Traces, to redo the last captured traces upto 3 traces.

Add Target Curve

The Add Target Curve function allows you to add a target curve and edit a highlighted target curve using a drop-down menu.

To add a target curve, click on the “Add Target Curve” option. In the target curve properties window, enter the desired curve properties, such as its name, reference gain, and number of biquads, and select the frequency for the target curve from the drop-down. Then, click “Apply” to add the target curve.

Once the target curve is active, its offset will change by 3 dB for every jump on the octave banding configuration, to follow the behavior of the energetic sum of the octave banding.

To edit the target curve, click on the “Edit Highlighted Target Curve”. In the target curve properties window, change the target curve properties and click “Apply”. This opens the Design Target Cure window, opens the Biquads on Apply to update the filters, imports, and exports the filters.
To know more about all the components on this window refer to Biquad Panel.

Import Traces

The Import function allows you to import single traces (*.trace) or multiple traces (*.trclist) using a drop-down menu.

Export Traces

The Export function allows you to export the highlighted trace (*.trace, *.txt), selected traces, or all traces (*.trclist, *.trcTxtlist) using a drop-down menu. The TraceList file can be exported as a .zip file with a (*.trace, *.txt, *.trclist, *.trcTxtlist) file extension.

You can unzip the .zip file and access the individual traces from it. The exported file contains the details of the setting in the text file (sample rate, FFT size, Unit in column title, etc) used during the capture, along with the data captured.

The checked status is not retained for the tracelist exported in .txt format.

Delete Traces

The Delete function allows you to delete the highlighted trace, selected traces,  all traces, and unprotected traces using the drop-down menu.

Saving and Loading RTA File

Saving RTA Settings

Once you complete all the RTA settings, click on the “Save” option. A file save dialog box will appear, enter the file name, and click Save.

Upon clicking “Save” within the dialog box, all of the following settings will be exported to a file with the. rta extension in a human-readable JSON format.

  • Generator
  • Analyzer
  • Audio Driver
  • Display

Loading RTA File

Upon clicking the “Load” button, a file open dialog box will be displayed. Locate the desired .rta file and click “Open” to restore the RTA settings stored in that file. The loaded settings will take effect immediately.

If the sound card settings are invalid when you load the settings, a settings window will be launched. You will need to fix the sound card settings issue before being able to proceed further.

Graphical user interface, application Description automatically generated

Upon clicking the “Apply” button, the sound card settings will be applied. Subsequently, you can modify other settings according to your preferences.

After importing the settings, it is necessary to reconnect the device.