GTT allows you to tune the audio object memory by setting values using Parameters Set and measuring the audio experience.

The Parameter Sets show the tuning data of all the set of objects used in the signal flow design. These sets can be easily maintained, exported, and shared with others. Additionally, the Parameter Sets allow you to save the progress of the tuning of the audio objects at every milestone point. As a result, you can return to any level and start fine-tuning the device.

Relative Topics

• Parameter Set Overview
• Configuring Parameter Set Data
• Apply Delta in Parameter Sets
• Retrieve and Verify Parameter Sets
• Importing and Exporting Set File
• Preset Comparison
• Create a Parameter Set in GTT

Using the Compare Presets feature to compare preset values between two columns.

By default, the Compare Presets feature is inactive. When you select two preset columns, it becomes active.

Steps to compare preset values:

1. On the Parameter Sets tab, select first preset column, then press “Ctrl” and select the another preset column.
   This will make the Compare Presets feature active and other features such as the New, Duplicate, Default Values, Retrieve, Apply Delta, Apply, Verify, Save, Load, Delete, and Presets column Context menu will become inactive.
   Additionally, when two preset columns are selected, the Next, Previous, and Clear Comparison option will also be inactive; they will only become active if there is a mismatch values available in the selected preset columns.
   
2. Click on Compare Presets to compare the values in the selected preset columns. All the mismatched cell will be highlighted in the selected preset columns and the Previous, Next, Clear Comparison options will be in active state.
   Use Previous and Next option check the mismatch value for the particular row.
   

On comparing both the selected preset columns, if no mismatch found, GTT will display “Both Presets are identical” message.

Presets Comparison will not be persisted when switching to the ‘AO Visualization’ view, but it will be persisted in the ‘Checksum Visualization’ view.

If you attempt to select the third preset column, GTT will prompt a message that “2 presets have been selected already.”

• Next: Use this option to navigate to the next mismatch value. When you click on Next, GTT will take you to next mismatch row. If you reach to the last mismatch row and the you click Next; GTT will take you to the first mismatch row.
• Previous: Use this option to navigate to the previous mismatch value. If you are on the first mismatch row, and then you click Previous; GTT will take you to the last mismatch row.
• Clear Comparison: Use this option to clear all the highlights from mismatch cell background.

When you unselect the presets columns, all Preset Comparison options will be in inactive state.

Retrieve Parameter Sets

The Retrieve function updates the parameter set values, with respect to changes made in the state variable.

Retrieve will change the values in the state variable and transfer the changes to the parameter set

1. Open the native panel and move the slider to change the values.
2. On the Parameter set group workspace and click Retrieve.
3. Click Yes to confirm to complete the operation.

You will see the parameter set value will be updated with respect to the state variable, which are mapped in to the respective native panel.

Verify Parameter Sets

This functionality is designed to compare the presets loaded on a device with those available in the GTT  in order to ensure their accuracy.

This feature is available only in online mode. i.e. only when the device is connected.

To verify preset values, select a preset and then click the ‘Verify’ button. A read command is sent to the device for each state variable within the preset. Once the value has been read, it will be compared with the corresponding value in the preset. If all values match, the verification process is considered successful.
However, if any values do not match, an error message will be displayed, and an error report will be generated.

Sample error report is as attached here Set 1[2].

Verify functionality is available at the Master Preset Controller level as well. You can verify all the presets under a slot in online mode.

You can send the tuning values to the device using “Apply Delta” or “Apply” function.

• Apply Delta function: Only sends the tuning values which updated in the selected set.
• Apply function: Sends  all the tuning values of the selected set.

To Apply Delta in Parameter Sets:

1. Open the Signal Flow Designer and create a signal flow.
   
2. Double-click on the Gain audio object to open the native panel. The native panel displays gain values. Now keep the Parameter Sets window and Gain window side-by-side.

   Make sure to drag and drop the Gain AO from the Explorer tree to the Parameter set group workspace before you start comparing. You will see the gain values as set in Parameter Sets with respect to the Gain native panel.

3. On the Parameter set group workspace, change the values in the parameter set and click Apply Delta. You will see the native panel updated with respect to the parameter set value.
   

Similarly, if you click on Apply, all the tuning values of the selected set will be send.

Follow the below steps to create parameter sets.

1. Open the Parameter Sets tab.
2. Go to the Parameter Sets view and click on the (+) icon. This adds a new parameter group in the Parameter Sets view.
   
3. Drag and drop the required AOs from the Explorer tree to the set group workspace.
   
   The AO will be displayed in a table form.
   
4. Click New to add a new set to this set group. This adds a new set in the Set Group.
   

You can create multiple set groups and multiple sets for one set group.

The GTT allows you to import and export a set file, these set file is in human-readable set format. There are multiple ways to import the set file.

Importing Set File

Using import you can load a .set or .setr file.

1. On the Parameter Set tab, chosen the Set column, and click on the on the Import
   Or
   Right-click on the chosen Set column to open the context menu and select Import Set File option.
   This opens a dialog box to select the .setr file (human readable set file).
   

2. Browse the location, select the .set or .setr file, and click Open. Once the set or .setr file selected, the device processing blocks will be updated with the tuning information extracted from the imported file.
   

GTT will highlight values excluded from import, invalid values, and autocorrected values after import. You can use filter options to view these values.

Hover over the cells to see tooltips indicating whether the imported data is excluded.

Tuning data is imported to the chosen set upon selection of the .setr file. When you click “Undo”, the import action is reversed, and the screen displays the previous preset values.
Only matching (CoreId, InstanceId, BlockId, and SublockId) objects tuning data will be imported.

Tuning data will be imported only in the parameter set column. Not on to the state variables.

The following notifications are displayed in the cases mentioned below:

• If there are additional objects in .set or .setr file then set group a notification message will be displayed.
  
• If there are additional objects in the set group, then in .set and .setr file a notification message will be displayed.
  
• If there is a mismatch in the size of the AO a notification message will be displayed.
• If there is mismatch in state variable names, a notification message will be displayed.
  
• If there are mismatching objects in both .set and .setr file and set group, a notification message will be displayed.
  
• If an error occurs while importing to Device, below message will be displayed.
  

All the mismatched object details will be displayed in the event log.

Exporting Set File

Using export you can export a .set or .setr file.

1. On the Parameter Set tab, chosen the Set column, and click on the Export.
   Or
   Right-click on the chosen Set column to open the context menu and select Export Set File.
   

A dialog box will appear, where you can choose the folder to store the files (.set/.setr). Enter a file name and click on the Save button.

When you launch a project in GTT, the Device Designer screen appears, which includes the following elements:

1. Parameter Set Ribbon: The ribbon is composed of six groups, each of which represents a subset of program functionality. In addition to these programs, there are also additional contextual programs that automatically appear depending on what is currently selected.
2. Parameter Sets View: This section displays the list of projects. In addition, you can add and delete a parameter set group.
3. Venue Explorer: This section displays core objects. Core objects that are part of the Audio Core (virtual core) and operate at a higher level than audio objects.
4. Tuning Panel: The workspace is used to add audio object/ xAF instance and program the device core.

Parameter Set Ribbon

Clipboard	You can select either a single value or multiple values from a set to copy. To select a single value, click on the cell. If you want to select multiple values, hold down the Shift or Ctrl key while clicking on the cells to choose them for copying. Clear Selection: If you have selected multiple cells and want to clear them without copying, you can click on the “Clear Selection” option in the ribbon bar or click on any other set. Copy: You can use the Ribbon bar’s copy option or the keyboard shortcut CTRL+C to copy the values of selected cells. Paste: You can paste selected values into the same or a different set using the paste option in the ribbon bar or by using the keyboard shortcut CTRL+V. First, select the cell in the set where you want to paste the values. Then click on ‘Paste,’ and it will paste all the copied values in sequence into the set. When pasting, values are validated; invalid or autocorrected values will be highlighted in the cells, along with tooltips indicating whether the data is autocorrected or invalid. AutoCorrected values can be reviewed and corrected if needed. Invalid data must be corrected. Without correction, the system will not allow you to move from parameter sets.
Editing	Undo: Allows you to undo changes (Ctrl+Z). Redo: Allows you to redo several actions (Ctrl+Y). Delete: Deletes the current selection.
Set	New: Creates a new preset with default values. For more details, refer to Create a Parameter Set. Duplicate: Use the “Duplicate” option to create a copy of the set and set group. To duplicate a set: Select a set column and click Duplicate. A duplicate set column will be added next to the existing set. To duplicate a set group: Select a set group and click Duplicate. A duplicate set group will be added in the parameter set view. Default Values: Use the “Default Values” option to reset all the parameters of the selected set to their default values. Retrieve: Retrieve the current set of values from the state variables. For more details, refer to Retrieve Parameter Sets. Apply Delta: To send only the Preset parameter values that are updated in the selected set (i.e. the values of changed parameters). The tuning values of the presets are sent to the device via XTP messages. For more details, refer to Apply Delta in Parameter Sets. Apply:  To send all preset parameter values of the selected set to the device. Verify: To compare the presets loaded on a device with the presets available in the GTT in order to ensure their accuracy. For more details, refer to Verify Parameter Sets. Export: To export you can export a .set or .setr file, refer to Import and Export Set File. Import: GTT will highlight values excluded from import, invalid values, and autocorrected values after import. You can use filter options to view these values. The clear warning will remove the highlighted color from these excluded import values, refer to Import and Export Set File.
Venue	Sort By Name: Allows sorting the parameter sets explorer data in alphabetical order. It will sort all items by Name. Sort By HiQNetId: Allows to sort explorer data in HiQNetId order. By default, the parameter sets explorer shows data in HiQNetId order.
Preset Comparison	Compare Presets: Sequential comparison of 2 selected Presets. Next: Navigate to the next mismatch cell value. Previous: Navigate to the previous mismatch cell value. Clear Comparison: Discard and disable all the preset comparison functionality. By default, Presets Comparison ribbon buttons will be disabled. For more details about Preset Comparison, refer to Preset Comparison.
Views	Errors: To filter and view only invalid values. Warnings: To filter and view auto-correct values. Exclude import data: To filter and view excluded import values. Reset: To reset the view back to the original state. Clear Warnings: Remove highlighted color from autocorrected values and clear all warnings.
File	Save: To save changes made in the parameter sets window. The Save option will check that all required data is present before allowing the save. When a device is removed or GTT is closed, parameter sets are automatically saved. When you navigate from the “Parameter Sets” tab to another tab in GTT, a confirmation message will appear, asking if you would like to save any unsaved changes. If you choose “Yes,” your changes will be saved immediately, ensuring that your updates are applied. If you select “No,” your changes will not be discarded; instead, they will be retained in memory for later use. Additionally, GTT will automatically save any changes when you close the application.

Parameter Sets View

The Parameter Sets section allows you to perform the following actions:

• Add a new parameter set group.
• Provides options to remove the set group.
• Allows to secure a set group.

Securing a set group: Securing set group options prevents unauthorized editing of group data. You can lock individual set groups with a password.

For the locked set group following restrictions are added:

• Deleting a set group, set or any object from a locked set group.
• Renaming the set group or set
• New, duplicate, default values, retrieve, and import.
• Editing the set value
• Dragging a new object to the locked set group.
• Copy and paste the set values.

To lock a specific group, click on the lock icon. A prompt will appear asking for a password. Enter the password and click OK.

It will display a success message and lock the respective set group.

To unlock the group, click on the unlock icon. It will prompt you for a password; enter a valid password to unlock the set group.

Venue Explorer

In venue explorer allows you to navigate and explore various parameter set groups and audio objects. Drag and drop the desired objects you wish to have presets configured in onto the workspace.

Parameter Sets Explorer Color scheme: Parameter Set uses the following color scheme to represent the usage of nodes in the set group.

• Yellow: To represent partial use of the object state variables.
• Green: To represent complete use of the node.
• No color: To represent, the node is not used in the set group.
  

Colors are visible in Explorer only for Parameter sets. Colors are updated when something gets updated in the Set group.
You can easily determine which nodes from the Explorer are a part of Set Group and which ones are not by using the color coding. This will enable to modify the set group further.

Tuning Panel

The tuning panel shows the tuning data of the audio objects used in the SFD. You can perform the following actions on the tuning panel.

• Modify the tuning data of the audio objects.
• Manage or filter the columns and set groups.
• Search the audio objects.
• Stores the tuning data in set files. These files are in Intel Hex format.

Save the modification or progress of tuning of audio objects.

AO Visualization

To view audio objects added in parameter sets, the “AO Visualization” view can be used.

You can view the compact view of the device, cores, and audio objects by checking “AO Visualization” checkbox in the header.  On unchecking this checkbox, the default view of parameter sets will be shown. This compact view is specific to each set group, so you can enable this for one set group and view the default view for another.

Operations such as adding new parameters by drag and drop, deleting parameters, and creating new sets are allowed in the AO Visualization view, but the view will be reset back to default.

Search Parameter Sets

A search box is available on the top right of the window to search parameter sets by Audio-object name.

To enable the search, at least 3 characters must be entered. When an audio object’s name is searched, any matching audio objects that contain the key are highlighted in yellow, and a navigation to the first matching row is automatically carried out.
You can use “<< and >>” options to navigate between the highlighted audio objects.

If a row is added or removed from parameter sets, and if a set group is changed, the search results will be cleared.

Checksum Visualization

Checksum visualization allows you to view more sets of data by hiding the left side columns.

Parameter Sets Checksum

A checksum is an alphanumeric string that serves as a fingerprint for data. Later, this data can be used for comparisons to detect errors in the data. The checksum is significant because it helps to validate the data. This feature allows you to view the checksum of each set and export the checksum along with the set files.
You can use this set checksum to verify exported set files to validate whether the set files data and parameter sets set data is the same or not.

Refresh Checksum

The Refresh checksum option gets enabled when any changes are made in the set data and user data. You can click on the refresh icon to calculate the latest checksum.

Export Checksum in Set file

GTT allows you to export the set checksum in .set and .setr files.

Checksum will not be saved in .set and .setr files in below cases:
– While saving .set and .setr files in the State Variable explorer.
– While exporting .set and .setr files from Export Tuning Data.

GTT stores the tuning data in set files these files are in Intel Hex format. Due to the complexity to analyze the data stored in set files a human readable set file is generated. This type of file is generated when you check the check box in the parameter sets workspace.

A confirmation message appears when you save a set file using the device context menu or the state variable explorer. This file will have the same file name that set file but with extension “.setr”. The human readable set file is in XML format, this file contains three main nodes:

Data in GTT	Data in human readable set file
Header: Generic file information
User data: User data defined in preset settings.
Tuning data: Values associated to each state variable for each audio object.

Each processing block corresponds to each Audio Object in current configuration.