EmStream Release Notes

EmStream is available via EmUpdater.

EmStream User Guide

EmStream is the PC application for receiving live telemetry data from Emtron displays. It subscribes to the telemetry stream published by an ED7 or ED10 display and presents real-time channel values, plots, and track position. EmStream also supports voice communications and text chat when licensed on the vehicle.

EmStream is available via EmUpdater.

Prerequisites

Before using EmStream, the vehicle display must be configured and activated for telemetry:

1. Activate telemetry on EmNet — see Telemetry Activation.
2. Configure telemetry credentials on the display in Display Studio — see Authentication.
3. Enable and configure the telemetry provider on the display — see Data Service.

EmStream uses the same vehicle name and password entered during activation.

Main Window

The title bar shows connection status for all three services:

Toolbar

Menu Reference

File

Logger

Local data recording — see Data Logger:

View

Hover the bottom-left of a pane to set it to Grid, Plots, Track, or Gauges. See View Layouts.

Help

Typical Workflow

1. Open EmStream and enter credentials in File → Connection Settings.
2. Connect to the telemetry server.
3. Optionally Connect Voice and Connect Text Chat.
4. Choose a layout from View → Layout, then set each pane to Grid, Plots, Track, or Gauges.
5. Configure channels in the view setup (pencil icon on Grid or Plots views).
6. Monitor values in the Live Data drawer on the right.
7. Pause logging and Save Log to File to archive a session, or Ctrl+B to bookmark a moment.
8. File → Save Config stores the layout and calculations for next time.

Getting Started

Install EmStream

Download and install EmStream via EmUpdater.

Activate Telemetry on the Display

Telemetry must be licensed and configured on the display before EmStream can connect. Complete these steps on the vehicle side first:

1. Activate on EmNet — enter the display serial number, activation code, vehicle name, and password.
2. In Display Studio, open File → Telemetry Credentials and enter the region, vehicle name, password, and SSL settings. Click Save Telemetry Settings.
3. In Display Studio, open Functions → Telemetry and configure the telemetry provider — enable it, set start conditions, and select channels to transmit.

Full details are in the Telemetry documentation.

Connect from EmStream

1. Launch EmStream.
2. Open File → Connection Settings.
3. Select the Server region closest to you (Australia, North America, or Europe). Choose Local when the telemetry server is running on this PC.
4. Enter the Vehicle Name and Password from activation.
5. Leave Use SSL enabled for official Emtron servers. Turn it off for a local server that does not use SSL.
6. Click Connect.

The toolbar shows Telemetry Connected with your username and the current data rate when the connection succeeds.

Save Credentials

To avoid re-entering credentials for frequently monitored vehicles:

1. Open File → Manage Saved Vehicles.
2. Enter the vehicle name and password.
3. Click Save.

Saved vehicles appear in the dropdown on the Connection Settings, Voice Settings, and Text Chat Settings pages.

Connect Voice and Chat

Voice and text require separate connections:

• File → Connect Voice — see Voice Comms
• File → Connect Text Chat — see Text Chat

Voice is supported on ED7M and ED10M. Text is supported on ED7, ED7M, and ED10M.

Connection Settings

File → Connection Settings

Connection settings control how EmStream connects to the telemetry data server to receive live channel values from the vehicle.

Server

Regional servers:

Select the region closest to the vehicle for lowest latency.

Local is for a telemetry server running on this PC. The Host field is filled in for you. Leave Use SSL off unless that local server requires it. Official Emtron regions need Use SSL enabled.

Credentials

These credentials must match those configured in Display Studio under File → Telemetry Credentials on the display.

Connect and Disconnect

Click Connect to authenticate and begin receiving data. The toolbar shows the connection status, username, and data rate in kbit/s.

Use File → Disconnect or the Disconnect button in the settings dialog to end the session.

Saved Vehicles

File → Manage Saved Vehicles stores vehicle name and password pairs locally on your PC. Credentials are saved in the Saved Vehicles list and appear in the dropdown on all connection dialogs.

Select a saved vehicle to populate the name and password fields. Click a list entry to edit, or use Delete Selected to remove it.

View Layouts

View → Layout and View → Window Count

Each EmStream window is a set of panes. Choose how many panes the window has, then choose what each pane shows.

Window layout

Drag a divider to resize panes. Divider positions are remembered.

Pane type

Hover the bottom-left corner of a pane and pick a type:

Each pane keeps its own type. A vertical split can show the track map beside a data grid, or plots above gauges, without a separate combined layout.

Several windows

View → Window Count opens 1 to 4 EmStream windows. Each window has its own layout and pane types. All windows share the same telemetry connection.

Broadcast mode

View → Broadcast Mode (or F11) fills the screen and hides the menu bar and the live-data drawer. Use it for a pit-wall display. Press Esc to leave broadcast mode. The window and drawer return to how they were.

Track files

Track outlines are set from the View menu and apply to Track panes:

Loading a GeoJSON file clears a GPX file, and loading a GPX file clears the GeoJSON. See Track Map.

Data Grid

The Grid view displays channel values in a layout of numerical gauges. Use it for at-a-glance monitoring of key parameters.

Grid Structure

Grids are organised in three levels:

Switch between group and grid tabs at the top of the view.

Configuring Gauges

Click the pencil icon on the grid view to open Data Grid Setup.

Groups

• Add Group — create a new group tab
• Import Group — load a .gridgroup file
• Drag groups to reorder
• Save Group / Delete Group

Grids

Within a selected group:

• Add Grid — create a new grid tab (defaults to 2×2)
• Import Grid — load a .datagrid file
• Set Rows and Columns (up to 9 rows, 6 columns)
• Save Grid / Delete Grid

Cell Configuration

Assign a channel to each grid cell by hovering over the gauge and clicking the settings icon. Configure:

Values update in real time as data arrives from the telemetry stream.

Import and Export

Grid configurations can be shared between PCs:

Gauges

Set a pane to Gauges from the type list at its bottom-left corner. See View Layouts.

The gauge pane is a free layout. Values follow the live telemetry stream, including maths channels and constants.

Gauge types

Add and edit

• Add gauge on the gauge-area toolbar, then pick a type.
• Drag a gauge to move it. Drag a corner to resize it.
• Double-click a gauge to set its channel, range, label, and colour bands.
• Lock all gauges / Unlock all gauges stops accidental moves.
• Align gauges to a grid snaps positions while you drag.
• Right-click a gauge and choose Remove. A locked gauge stays until you unlock it. When the pane is scaled to fit, right-click still offers Remove.

Colour bands

Each gauge can have colour bands. For a bar, radial, steering, or force gauge, the band colour follows the channel value. For a Value gauge, the band colour is applied to the digits.

The gauge pane is saved with the window layout in an EmStream configuration file.

Live Plots

The Plots view displays scrolling time-history plots of selected channels. Data is buffered locally by the Data Logger and plotted in real time.

Plot Structure

Plots are organised in three levels:

Configuring Plots

Click the pencil icon on the plots view to open Live Data Setup.

Groups

• Add Group — create a new group (creates a default page with 3 time plots)
• Import Group — load a .logginggroup file
• Drag groups to reorder
• Save Group / Delete Group

Pages

Within a selected group:

• Add Page — create a new page tab
• Import Page — load a .loggingpage file
• Set Plot Count (0–4 plots per page)
• Save Page / Delete Page

Time Plot Configuration

Each plot cell supports up to 8 channels. Configure channels directly on the plot:

• Click the plot to open channel selection
• Assign channels to plot traces
• Set Y-axis minimum and maximum, or enable auto-scale per channel
• Use quick add mode to rapidly add channels from the live data list

Plots scroll automatically as new data arrives. When logging is paused, use the toolbar controls to scroll back through buffered history.

Split Layouts

When using Plot + Plot or Plot + Grid view types, each side has independent group and page tabs. The secondary plot area uses a separate tab index, so you can show different channel sets side by side.

Import and Export

Track Map

The Track view shows the vehicle’s GPS position on a map in real time. It is useful for monitoring on-track position during a session.

Live Data

The track map reads GPS and vehicle channels from the telemetry stream:

• GPS latitude and longitude for vehicle position
• Drive speed, steering angle, accelerator, brake pressure
• Gear, engine power, and torque (when transmitted)

Vehicle position updates as GPS data arrives. The map auto-scales to fit the track or follows the vehicle depending on zoom mode.

Track Outline

Load a track background from View → Set Track File:

GPX and GeoJSON are mutually exclusive — loading one clears the other.

GPX Routes

Load a route or waypoint file from View → Set GPX File:

Toggle View → Connect Waypoints to draw lines between GPX waypoints.

Beside other panes

Put the track map in one pane and a grid, plots, or gauges in another. Choose View → Layout, then set each pane’s type from the bottom-left corner. See View Layouts.

Data Logger

EmStream buffers all incoming telemetry data in a local data logger. The logger runs continuously while connected and feeds the plot views. Use the logger menu to control recording and export data for later analysis.

Pause and Resume

When paused, incoming data stops being appended to the buffer. Plots stop scrolling and you can review historical data. When resumed, logging continues from the current point.

Default Window

Logger → Set Default Window (ms) sets the default time span visible on plots when paused. Enter the duration in milliseconds — for example, 30000 for a 30-second window.

Clear Data

Logger → Clear Logged Data erases the entire buffer. This cannot be undone. The logger must be paused first.

Save and Load

All save and load operations require the logger to be paused. The default save folder is remembered between sessions.

Saved .dlf files can be reviewed in EmStream without an active telemetry connection.

Bookmarks

Logger → Add Bookmark (Ctrl+B) marks the current moment. Logger → Bookmarks… lists those marks so you can save a short .dsl clip or open it in EmVision. See Session Bookmarks.

Session Bookmarks

Logger → Bookmarks… or Ctrl+B

Bookmarks mark a moment in the data logger buffer while telemetry is being recorded. Use them for an issue, a pit stop, a flag, or any other point you want to review.

Add a mark

Each row shows the time and a label you can edit. Clear All removes every mark. The logger needs to be running so the mark has data around it.

Clip length

Seconds before and Seconds after set how much of the buffer is included. Both start at 30 seconds. Change them before you save or open a clip.

Review

Select a bookmark, then:

.dsl clips open in EmVision with File → Open Log. See Opening Logs.

Live Data Panel

The Live Data drawer on the right side of the window shows all channel values and events from the telemetry stream.

Channel Values

The upper section lists every channel currently being received, with its live value and units. Values update continuously while connected. Maths results, table outputs, and constants appear in the same list.

Use this list to:

• Verify that expected channels are being transmitted
• Identify channels to add to grids or plots
• Monitor values that are not assigned to a visible gauge or plot

Events

The lower section shows recent system events as they arrive — engine start, lap beacons, alarm triggers, and similar discrete signals.

Channel Preferences

Channel display units and decimal places are configured in the Live Data setup. Open the channels configuration to adjust how values are formatted.

Preferences apply to EmStream only and do not affect the display or log files. This allows team members in different regions to view the same telemetry stream in their preferred units.

Drawer Size

Drag the drawer edge to resize. The drawer can be collapsed entirely — the width and open/closed state are saved between sessions.

Voice Comms

File → Voice Settings / File → Connect Voice

Voice communications let you talk with other users connected to the same vehicle session. Voice is supported on ED7M and ED10M displays with an active voice license.

Device-side setup is in Display Studio under Functions → Voice Comms — see Voice Service.

Connection Settings

Regional voice servers:

Click Connect to join the voice session. The toolbar microphone icon turns green when voice activity is detected.

Push-to-Talk

Push-to-Talk (PTT) mode requires holding a key to transmit:

Click Rebind and press a key to change the PTT binding. PTT settings can only be changed while disconnected.

When PTT is disabled, voice uses automatic voice activity detection — the microphone transmits when you speak.

Audio Settings

Priority System

Lower priority numbers win when multiple users speak simultaneously. A user with priority 0 can interrupt a user with priority 5. Set your priority to match your role — for example, the driver might use a lower number than a pit lane engineer.

The display-side Broadcast Priority setting in Display Studio should be configured to complement EmStream priorities.

Text Chat

File → Text Chat Settings / File → Connect Text Chat

Text chat provides real-time messaging with other users connected to the same vehicle. Text is supported on ED7, ED7M, and ED10M displays with an active text license.

Device-side setup is in Display Studio under Functions → Text Chat — see Text Service.

Connection Settings

Regional text servers:

Click Connect to join the chat session. Connection errors are shown in the settings dialog.

Chat Console

Open the chat console from:

• View → Show Chat Console
• The chat icon in the toolbar

The chat window floats above the main view and can be dragged to any position. It shows message history and a text input for sending messages.

Messages are delivered in real time to all connected users on the same vehicle — including users on the display, other EmStream instances, and the web interface.

Quick Messages

The display can be configured to send automatic quick messages triggered by events (for example, “Pit now” when a condition is met). These appear in the chat history like any other message. Quick message configuration is on the display in Display Studio.

Maths

File → Maths

Maths create extra channels from the live telemetry stream. EmStream uses the same emexpr language as Display Studio and EmVision. Expressions update while you are connected, including after a reconnect.

The expression syntax, operators, and function libraries are documented in Math Functions. On the display, evaluation is Continuous or On Event. In EmStream the same expressions run against the incoming samples.

What you can use

• Log and telemetry channels by name
• Other maths channels as inputs (up to 16)
• Constants such as weight or a spring rate
• Binary and hex integers (0b, 0x)
• A named state, inserted as its numeric value, when the channel has named states

A maths channel that writes to a user channel keeps that channel’s units, colour, and display range, and shows a live value in the Live Data drawer and on gauges.

Editor

Work is organised into groups and expressions, the same layout as Display Studio.

1. Open File → Maths.
2. Add a group, then an expression.
3. Name the expression and write the formula.
4. The editor compiles as you type. A warning marks a group or expression that does not compile.

Cut, copy, paste, and delete work on groups and expressions.

Sharing

• File → Export Setup Pack / Import Setup Pack stores maths together with user channels and tables in an .emmtc file. EmVision opens the same file. See Configuration.
• File → Save Config stores maths inside the full EmStream configuration (.emsc).

Tables

File → Tables

Tables turn one or two live channels into another live channel. EmStream looks up the table from the current inputs and interpolates between cells. The result is available in the live-data list, grids, plots, gauges, and maths.

The grid editor is the same one used in Display Studio and EmVision. Axis setup, fill, interpolate, and copy/paste are described in Tables (Display Studio).

Add a table

1. Open File → Tables.
2. Click Add Table.
3. Set Name and Output Channel.
4. Open Axis Setup and assign the X channel. Assign a Y channel as well for a 2D table. One axis is a 1D lookup.
5. Enter cell values. Generate an axis from a start, step, and maximum, or type breakpoints yourself.

Right-click a table in the list to Cut, Copy, Paste, or Delete it. Drag tables to reorder them. Load and Save on the table toolbar store one table’s configuration.

Sharing

Tables are included in an .emmtc setup pack and in a full .emsc configuration. See Configuration.

Constants

File → Constants

Constants are named numbers for this PC session: vehicle weight, spring rates, gear ratios, and similar setup values. They appear in the live-data list and on gauges, and maths can read them.

They use the same sections-and-values editor as Display Studio. See Constants (Display Studio) for sections, reordering, and per-channel values.

Import and export

The YAML file is the same format Display Studio and EmVision use. A pack exported from File → Export Setup Pack does not include constants — use this YAML export when you only want the setup values, or File → Save Config when you want them inside the full EmStream file.

Constants that the display itself is sending also show up in live data while you are connected. Values you set in EmStream are local to this PC.

User Channels

File → User Channels

User channels are names, units, and colours stored on this PC. Use them when a maths expression or a table needs an output that is not already in the telemetry stream.

They are not written back to the display. Channels created in Display Studio under Setup → User Channels are part of the vehicle configuration. See User Channels (Display Studio).

Create a channel

1. Open File → User Channels.
2. On the Channels tab, click Add Channel.
3. Set Name, Units, and Colour.

The Events tab adds named events for markers.

A maths expression that writes to a user channel keeps that channel’s units, colour, and display range, and the live value shows in the data drawer.

User channels travel with maths and tables in an .emmtc setup pack, and they are stored in an .emsc configuration. See Configuration.

Channel Alerts

File → Channel Alerts

Alerts watch live channels and maths channels. When the conditions trip, EmStream shows a notification. Sound is optional.

Create an alert

1. Open File → Channel Alerts.
2. Click Add Alert.
3. Set Name, leave Enabled checked, and turn Play sound on if you want a tone.
4. Add one or more trigger conditions.

Each condition compares a channel with a number or with another channel. The comparison editor is the same one used on the display — see Conditions.

Rows combine with AND, OR, or NOR. The join is between a row and the row before it, read from top to bottom.

While an alert is active

The list shows how many alerts are currently tripped. Clear Active dismisses the on-screen notices. The alert stays enabled and can trip again.

Alerts are stored in the EmStream configuration file. See Configuration.

Configuration and Setup Packs

EmStream has two save formats. Use a configuration file for this PC’s whole layout. Use a setup pack to move calculations between EmStream and EmVision.

EmStream configuration

File → Save Config / File → Load Config

An .emsc file stores the EmStream setup on this PC:

• Window count, layout, and the type of each pane
• Data grids and live plots
• Gauges
• Maths, tables, constants, and user channels
• Channel alerts

Load a configuration to restore that workspace. Opening a saved file shows its user channels straight away.

Connection passwords, voice settings, and session bookmarks are separate. Saved vehicles stay under File → Manage Saved Vehicles.

Setup pack

File → Export Setup Pack / File → Import Setup Pack

An .emmtc file contains maths, user channels, and tables. It does not contain the window layout, grids, plots, gauges, constants, or alerts.

EmVision imports and exports the same .emmtc file, so a calculation built on the pit wall can be reused when you analyse the log. Constants stay in their own YAML export — see Constants.