Locked Setups

Overview

Setups may be saved to files that are locked from editing and may only be programmed to displays. Locked setups include thumbnails of screens for preview purposes.

Locked setups have the file extension .gddp.

Exporting Locked Setups

To export a locked setup, use the File | Export Compiled / Locked Setup... command. The Locked Setup Options dialog is shown before the file is saved.

Locked setups may be loaded into Dash Design and programmed with File | Upload To Display F7. When programming a locked setup, Dash Design checks that the display firmware supports the features used by the setup.

Locked Setup Options

Option Description
Embed Setup File Name (visible to users) Includes the original setup file name in the locked setup. The file name may be edited to remove any user information or it could be changed to a URL.
Embed Source Setup File Embeds the original setup file in the locked setup. The original setup is LZMA compressed and AES-256 encrypted with a key cryptographically derived from the password and a ‘salt’ value.
Password / Confirm Password The password required to extract the embedded source setup. Check Show Password to show the password as it is typed.
Lock to Serial Number? Restricts the locked setup to one or more specific displays. Only available for displays that support serial number locked setups.

To lock the setup to specific displays, check Lock to Serial Number? and add the display serial numbers to the list. When adding serial numbers, several may be entered at once separated by commas.

When the export is complete, choose Open Setup to open the locked setup in Dash Design, Explore to show it in a new Explorer window or Close.

Automatically Saving Locked Setups

Dash Design can automatically save a locked version of the setup, for example for external simulators or scrutineering. This is configured in the Locked Setup Auto Save section of Configure | Preferences... Alt + F7:

Preference Description
Auto Save Never, On Save (whenever the setup is saved) or When Programming (whenever the setup is programmed into a display).
Auto Save Naming Match Setup Name uses the setup file name, MD5 names the file using the setup binary checksum (the Checksum shown on the File Info Tab) and Match Setup.<MD5> adds the checksum to the setup file name.
Overwrite Mode Always Ask, Always Overwrite or Never overwrite an existing locked setup file.

The locked setup is saved in the same folder as the setup file. When asked whether to overwrite an existing locked setup, check Don’t ask again this session or Don’t ask again ever to stop further prompts; the latter can be re-enabled in the preferences.

File Info Tab

The File Info tab provides information about the locked setup file. The File Info tab is only available when a locked setup file is loaded into Dash Design.

Setup Binary

The ‘compiled’ setup binary is the data that is programmed into the Display Module.

Field Description
Size The size of the setup binary.
Checksum The checksum of the setup binary (a seeded MD5 checksum), which should match the checksum calculated by the display module when the setup is loaded. Shown when Show additional hashes is checked.
SHA-1 SHA-1 hash of the setup binary. Shown when Show additional hashes is checked.

Check Show additional hashes to show the SHA-1 and MD5 hashes. This choice is saved in the application preferences.

Source Setup

The source setup is the setup that was used to create the locked setup.

Field Description
Setup Name The setup name set on the Setup Name page.
File Name The file name of the source setup, if it was embedded in the locked setup.
Size The size of the embedded source setup, or Source setup not embedded.
MD5 MD5 sum of the setup file that the locked setup was generated from. Shown when Show additional hashes is checked.
SHA-1 SHA-1 hash of the setup file that the locked setup was generated from. Shown when Show additional hashes is checked.

Click Explore to open the source setup File Name location in Windows® File Explorer.

If the original setup file is embedded in the locked setup, click Extract Setup to extract it. Enter the password that was used when the locked setup was exported, then choose where to save the extracted setup.

Notes

The Notes section shows the locked setup’s notes (read only).