Constants

Setup → Constants

Constants are fixed values published as channels on the display. Use them for car- or session-specific numbers that functions, gauges, and maths need — for example tyre circumference, gear ratios, or driver preferences — without hard-coding those values into each feature.

Constants are part of the configuration file. They are also written into every onboard log so analysis tools can use the same values that were active during the run.

Sections

Constants are organised into sections (for example Car, Driver, or Event).

1. Open Setup → Constants.
2. Use New section to add a section, and rename it as needed.
3. Select a section, then add channels and set each value.
4. Drag sections or entries to reorder them.

Each entry picks a channel and an explicit value for that channel. Only one constant should write a given channel.

Import and export

Tips

• Prefer clear section names so imports from multiple files stay organised.
• Use constants for values that change between cars or events, and leave function-specific calibration on the feature page itself.
• After changing constants, write the configuration to the display so the device and logs match Studio.

User Channels

Setup → User Channels

User channels let you define custom named channels for data that is not covered by the built-in channel list. They behave like any other channel — functions can read and write them, gauges can display them, and they can be logged.

Creating a Channel

1. Open Setup → User Channels.
2. Click Add to create a new channel.
3. Set the Name and select a Unit type.
4. Optionally assign an Enum to display human-readable text instead of numeric values.

Import and Export

User channel definitions can be exported and imported between configurations using the toolbar buttons. This is useful when sharing a common set of custom channels across multiple vehicle configs.

TIP: Prefer built-in channels where they exist. Built-in channels ensure compatibility when importing sub-configurations from other projects. Contact Emtron support to request addition of commonly needed channels.

See Channels and Events for guidance on when to use custom channels.

User Events

Setup → User Events

User events are discrete triggers — they fire at a point in time rather than holding a continuous value. Other functions listen for events to perform actions such as resetting a counter, switching a screen, or starting a log.

Creating an Event

1. Open Setup → User Events.
2. Click Add to create a new event.
3. Set the Name for the event.

User events can be triggered by conditional logic, switch logic, CAN receive mappings, keypad inputs, and other functions that support event outputs.

Import and Export

Like user channels, event definitions can be exported and imported between configurations.

See Channels and Events for more on how events differ from channels.

User Enums

Setup → User Enums

Enums map numeric values to display text. For example, a gear position channel might map 0 to “N”, 1 to “1st”, and so on. Gauges and live data views use enum labels when a channel is associated with an enum.

Creating an Enum

1. Open Setup → User Enums.
2. Click Add to create a new enum definition.
3. Set the enum Name.
4. Add Values — each entry pairs a numeric value with display text.

Enums are referenced from user channels, built-in channels (via enum associations), and status gauges on the display.

Enum Associations

Setup → Enum Associations

Enum associations connect built-in channels to enum definitions so that numeric values display as text. This is separate from user enums — it applies to the predefined channel list that ships with the display firmware.

Usage

1. Open Setup → Enum Associations.
2. Select a Channel from the built-in channel list.
3. Assign an Enum definition.

When the channel value is displayed in live data, logged data, or on a status gauge, the associated enum text is shown instead of the raw number.

For channels you create yourself, assign the enum directly on the User Channels page instead.

Vehicle Details

Vehicle Details has been replaced by Constants.

Use Setup → Constants to organise fixed channel values into named sections, import or export YAML, and publish those values on the device and into onboard logs.