Posted on by Debanka

File Controller

The File Controller allows you to send audio files from GTT to device. The file controller suports .wav and .pcm formats audio files.

Following are the options available in file controller.

  • Select Workspace
  • Add Files
  • Delete File
  • Replace File
  • Send to Device
  • Verify Checksum
  • Export Options

The file controller feature is available from W release onwards.

Select Workspace

The Select Workspace option allows you to browse and select workspace or root folder from the local directory. Once the folder is selected you can add the respective audio files.

Also, you can also copy & paste the path of your workspace folder in the “Workspace” field.

Add Files

Once workspace folder is selected, click on the “Add” to launch file browser. You can navigate to the respective folder and add audio files (.pcm/.wav) in file controller from the workspace folder.

The file browser will open the workspace folder by default.

After adding the files, following details of the files will be displayed in file controller.

  • File ID:  This ID is generated from GTT, it’s range from 1 to 254.
  • File Name: If the file name is exceeding length of 15 characters (including file extension), GTT will trim it to 15 characters.
  • Path: Relative path of file, based on workspace folder selected.
  • Size: Size of the file in KB. If the file size is less than 1KB, the size will be displayed in bytes.
  • Checksum: Checksum calculated using file content.

In case if you add any file from non-workspace folder, following prompt will appear.

  • Copy: To create a duplicate copy of the file within your workspace folder.
  • Move: To relocate the selected file to your workspace folder, removing it from their original location.
  • Cancel: To stop the ongoing operation.

This facilitates the sharing of project files and files added to the file controller by ensuring that all files added to the file controller are present in the workspace folder.

The number of files added will be displayed in File Controller.

Maximum 254 files can be added in file controller.

Once after adding files to file controller, on relaunching file controller if any file not found to load, the error is indicated by showing “0 Bytes” size and invalid checksum as below,

Delete Files

The file controller offers two ways to manage your files:

  • Click “Delete All” to remove all files at once.
  • Use the “Delete” button for each file to remove them individually.

The delete operation will delete file entry from file controller, not the file from file system.

Replace File

You can replace file in the file controller. Click on the “Replace” button, this will open the file browser, allowing you to select the new file you wish to use.
Also, allows you to reuse file id for different file easily.

Send to Device

The “Send to Device” allows to send the loaded files in file controller to the device.
While sending files to device, file map will be sent to device first. File map contains metadata about the files being sent.
If it fails to send file map, the audio files will not be transferred to device.

Verify Checksum

The “Verify Checksum” feature helps ensure you’re working with the correct files. The Verify Checksum option uses the file content checksum to confirm that a file with the same file ID is present on the device.

Use the “Verify All” button to check all files at once or the individual “Verify” button in each row for specific files.

Indication of default state “Not Verified”.
Indication, when the file is found in device with same file id.
Also, on successfully file send to device.
Indication, when the file is not found in device with same file id.

Export Options

To export files from file controller, following options are available.

  • Export File Map
  • Export Audio Files
  • Export All Files

These options will be displayed on clicking “Export Options” button.

Upon selecting any of these options, a folder browser will open allowing you to select the destination folder.

Export File Map: This option is to export filemap file and human readable filemap.

Export Audio Files: This option is to export audio files added in file controller.

Export All Files: This option is to export all files including filemap and human readable filemap.

Export & Import File Controller Data

The selected workspace and metadata of loaded files in file controller can be exported through project file (.gttd). This metadata includes file id, name and relative path of file. After importing the gttd file with file controller data, if the workspace folder is not found, files will be displayed with “0 bytes” Size and invalid checksum as shown below.

You can select workspace folder with same sub folder structure to automatically reload files loaded in file controller. The files should be present in same hierarchy and name.