Toolbar & button reference

This page is the complete map of Serial Studio's buttons: the main toolbar at the top of the window, the dashboard Start menu and taskbar, the Setup panel, the Project Editor toolbar, and the small toolbar that sits on top of each dashboard widget. Hover any button in the application to see the same tooltip text quoted here.

Buttons marked (Pro) require a Serial Studio Pro license (or an active trial). In the free GPL build they are hidden, not just disabled.

The main window at a glance

When Serial Studio is running, the window is built from a few fixed surfaces:

Surface Where Covered in
Main toolbar Across the top Main toolbar
Setup panel Right side, collapsible Setup panel
Console / Dashboard Center Console toolbar, Widget toolbars
Taskbar Bottom of the dashboard Dashboard taskbar
Start menu Opens from the taskbar Dashboard Start menu

The center view starts on the Console and switches to the Dashboard automatically once the first valid frame is parsed. There is no manual Console/Dashboard toggle button; the view follows the data. See Operation Modes for how that transition is decided.

Main toolbar

The toolbar runs along the top of the window, left to right, grouped into sections that collapse into overflow menus when the window is narrow. The exact set of buttons depends on the build (Pro vs free) and on whether the app is running as a normal install or as an operator deployment (operator runtime mode hides the authoring buttons).

Project section

Button Icon What it does Notes
Project Editor Opens the Project Editor to create or modify your JSON layout. Authoring mode only.
Open Project Opens an existing .ssproj / .json project and switches to Project File mode. Authoring mode only.
Open CSV Plays a recorded CSV file back as if it were live sensor data. Disabled while a device is connected or while the CSV player is already open. See CSV Export & Playback.
Open MDF4 (Pro) Plays an MDF4 file back as if it were live data. Disabled while a device is connected or while the MDF4 player is already open. See MDF4.

Assistant / Extensions section

Button Icon What it does Notes
Assistant (Pro) Opens the AI Assistant to build and edit a project by chatting. In the free build this button is Extensions instead, opening the extension manager.
Deploy (Pro) Opens the shortcut generator to build a standalone operator app for the current project.
Sessions (Pro) Opens the Session Database explorer to browse, replay, and export recorded sessions.
Extensions (Pro) Browse and install extensions. In the free build, the section's first button is Extensions; in Pro it lives here alongside the AI tools.

Preferences and driver selection

Button Icon What it does Notes
Preferences Opens application settings and preferences. Authoring mode only.
UART Selects the Serial port (UART) driver.
Audio (Pro) Selects the audio input driver.
USB (Pro) Selects the raw USB driver.
Network Selects the TCP / UDP network driver.
Modbus (Pro) Selects the Modbus driver.
HID (Pro) Selects the HID driver.
Bluetooth Selects the Bluetooth LE driver.
CAN Bus (Pro) Selects the CAN Bus driver.
Process (Pro) Selects the Process I/O driver.

The driver buttons are a single-choice group: the active driver's label is shown in bold. They are disabled while a connection is live, while a file player is open, and for multi-source projects (where the source list is fixed by the project). See Data Sources.

Help and about

Button Icon What it does Notes
About Shows application info and license details. Authoring mode only.
Examples Browses the bundled example projects. Authoring mode only.
Help Center Opens this documentation, the FAQ, and the wiki. Available to operators too.
AI Wiki & Chat Opens the DeepWiki documentation site in your browser, where you can ask questions about Serial Studio. Authoring mode only.

Connection (right-pinned)

Button Icon What it does Notes
Activate (Pro) Opens license management to activate Serial Studio Pro. Shown only when a Pro trial has expired and no license is active.
Connect / Disconnect Opens or closes the connection to the configured device. This is a toggle: when connected the icon and label change to Disconnect. Disabled until the connection is fully configured, and while a CSV / MDF4 / session player is open.

Setup panel

The Setup panel docks on the right edge of the window and is where you choose how data is parsed and which I/O driver to use. Drag its left edge to resize it and give the Dashboard more space.

Frame parsing

Three radio buttons pick the operation mode:

Option What it does
Console Only (No Parsing) Raw bytes go straight to the terminal. No widgets, no parsing.
Quick Plot (Comma Separated Values) Auto-builds a dashboard from comma-separated numbers.
Parse via Project File Uses a .ssproj project to parse frames and build a custom dashboard. Disabled while connected or while a file player is open.

Device setup

  • I/O Interface selector: chooses the active driver (the same set as the toolbar driver buttons). Each choice swaps in a driver-specific settings panel below it (port and baud rate for UART, host and port for Network, and so on). See Communication Protocols and the per-driver pages under Drivers.
  • An API Server status indicator appears in the panel header when the TCP API is enabled, showing whether clients are connected.

Data export

Switches that arm recording for the session. Each writes to a separate file or store and can be toggled independently. CSV Spreadsheet, Session Recording, and MDF4 Recording are disabled in Console Only mode; the Console Log switch stays available:

Switch What it records Reference
CSV Spreadsheet A .csv of every parsed frame. CSV Export & Playback
Session Recording (Pro) A SQLite session in the database. Session Database
MDF4 Recording An ASAM MDF4 measurement file. MDF4
Console Log A transcript of the raw console stream.

For a project with two or more data sources, the panel replaces the single-driver controls with an Open Project Editor button, because the source list is defined in the project. See Data Sources.

Dashboard Start menu

The Start menu opens from the leftmost taskbar button. It is the dashboard's main menu: workspaces, actions, plugins, tools, and the session controls.

Entry Icon What it does Notes
Workspaces Picks the active workspace, creates a new one, shows hidden ones, or edits and deletes user workspaces. Submenu.
Actions Lists the project's actions; picking one runs it. Hidden when the project defines no actions.
Plugins Lists installed plugins, plus Manage Plugins.... Hidden when no plugins are installed.
Auto Layout Toggles automatic tiling of dashboard windows. Toggle.
Full Screen Toggles the main window between full-screen and windowed. Toggle.
Add External Window Opens a second dashboard window (for a multi-monitor layout).
Export Submenu of recording toggles: CSV File, MDF4 File, Console Transcript, and Session Database (Pro). Mirrors the Setup panel's export switches.
Tools Submenu: Console, Notifications (Pro), Clock, Stopwatch, Preferences, Sessions (Pro), File Transmission (Pro), AI Assistant (Pro). Toggles the utility widgets and opens the tool windows.
Help Center Opens this documentation.
Pause / Resume Pauses or resumes data reception for the whole session. Toggle.
Reset Clears the dashboard's plotted history and rotates every active recorder (CSV, MDF4, console, database) so the next frame starts a fresh file or session.
Disconnect / Quit Disconnects the device. In an operator deployment this entry is Quit and closes the app instead.

Dashboard taskbar

The taskbar runs along the bottom of the dashboard.

Control Icon What it does Notes
Menu Opens the Start menu. Always the leftmost button.
Search Filters open widgets and Start menu entries; results appear in a dropdown. Shown when taskbar search is enabled in settings.
Pinned shortcuts varies A configurable strip of quick-toggles: Settings, Console, Notifications, Clock, Stopwatch, File Transmission, AI Assistant, Pause / Resume. The set and order are user-configurable; Pro-only tools are hidden in the free build. Stateful shortcuts light up when active.
Window buttons per-widget One button per open dashboard widget; click to show, focus, or restore that widget. The center strip scrolls with the < / > arrows when it overflows. Mirrors the widgets currently on the canvas.
Workspace switcher (dropdown) Selects the active workspace; the current one is bold.
Auto Layout Toggles automatic window tiling (same as the Start menu entry). Lights up when enabled.
Edit workspace Renames or edits the active workspace. Enabled only for user-created workspaces.
New workspace Creates a new workspace. Hidden in operator runtime mode.
MQTT status (Pro) Shows the MQTT publisher connection state; click for a status popup with broker, mode, and message count. Shown only when the MQTT publisher is enabled.

A note on workspaces

A workspace is a saved arrangement of dashboard windows. Each project includes a default workspace; you can add your own to keep different views of the same data (an overview screen, a diagnostics screen) and switch between them from the taskbar or the Start menu. User workspaces have IDs at or above 1000 and only those can be renamed or deleted.

Project Editor toolbar

The Project Editor has its own toolbar for building the project tree: file actions on the left, then a series of "add" buttons grouped by what they create. The large buttons add the common item of each group; the small buttons next to them add the specific variants.

File

Button Icon What it does Notes
New Starts a new, empty project.
Open Opens an existing project.
Save Saves the project to disk. Enabled only when there are unsaved changes and saving is allowed.
Save As Saves under a new name.

Import and restore

Button Icon What it does Notes
Protobuf Generates a project from a Protocol Buffers .proto schema. See Auto-Generating Projects.
Restore Restores a recent automatic snapshot of the project. See Backups & Recovery.
Lock Sets a password and locks the editor. See Project Lock.
Add Device (Pro) Adds another data source to the project.

Add output controls

Button Icon Adds
Output An output control panel.
Action An action.
Slider An output slider.
Toggle An output toggle.
Knob An output knob.
Text Field An output text field.
Button An output button.

Add datasets

Button Icon Adds a dataset shown as
Dataset A plain dataset (no widget).
Plot A time-series plot.
FFT Plot An FFT spectrum.
Gauge A gauge.
Level Indicator A bar.
Compass A compass.
LED Indicator An LED.

Add groups

Button Icon Adds a group shown as
Group A generic dataset group.
Image An Image View (Pro).
Web View A web viewer.
Painter A Painter widget (Pro).
Table A Data Grid.
Multi-Plot A MultiPlot.
3D Plot A 3D Plot (Pro).
Accelerometer An accelerometer group.
Gyroscope A gyroscope group.
GPS Map A GPS map.

Assistant and help

Button Icon What it does Notes
Assistant (Pro) Opens the AI Assistant.
Help Center Opens the Project Editor documentation.

The full set of dataset and widget configuration fields is described in the Widget Reference and Project Editor pages.

Dashboard widget toolbars

Most visualization widgets carry a small toolbar of icon buttons along their top edge. The toolbar only appears when the widget is large enough to fit it; shrink a widget and the toolbar hides to leave room for the data. All toggle settings are saved per-widget in the project file, so each tile remembers its own state.

A few conventions are shared across widgets:

  • Pause / Resume freezes drawing without stopping data collection; the icon swaps between a pause and a play glyph.
  • Show Crosshair overlays a tracking crosshair that follows the cursor.
  • Reset View returns pan and zoom to the default; it is disabled until you have zoomed or panned.
  • Axis Range Settings (gear icon) opens a dialog to pin fixed minimum and maximum axis values.

Plot

Button Icon What it does
Interpolation Cycles line smoothing: none (raw points), linear, stepped (ZOH), or stem.
Show Area Under Plot Fills the region beneath the curve. Available only with line interpolation.
Show X Axis Label Shows or hides the X-axis label.
Show Y Axis Label Shows or hides the Y-axis label.
Show Crosshair Tracking crosshair that follows the cursor.
Pause / Resume Freezes drawing without stopping data collection.
Sweep / Trigger Mode (Pro) Turns oscilloscope-style Sweep / Trigger mode on or off. Time-axis plots only.
Trigger Settings (Pro) Opens the Trigger Settings dialog (mode, level, slope, holdoff, timebase). Enabled only while Sweep is on.
Reset View Returns pan and zoom to the default; disabled until you have zoomed or panned.
Axis Range Settings Pins fixed minimum and maximum axis values.

MultiPlot

The MultiPlot toolbar matches the Plot toolbar, minus Show Area Under Plot (which does not apply to overlaid curves). A per-curve legend with show / hide switches sits beside the chart.

Button Icon What it does
Interpolation Cycles line smoothing: none (raw points), linear, stepped (ZOH), or stem.
Show X Axis Label Shows or hides the X-axis label.
Show Y Axis Label Shows or hides the Y-axis label.
Show Crosshair Tracking crosshair that follows the cursor.
Pause / Resume Freezes drawing without stopping data collection.
Sweep / Trigger Mode (Pro) Turns oscilloscope-style Sweep / Trigger mode on or off. The Source setting picks which curve the trigger watches. Time-axis plots only.
Trigger Settings (Pro) Opens the Trigger Settings dialog (mode, source, level, slope, holdoff, timebase). Enabled only while Sweep is on.
Reset View Returns pan and zoom to the default; disabled until you have zoomed or panned.
Axis Range Settings Pins fixed minimum and maximum axis values.

These buttons and Sweep / Trigger mode are documented in full on the Plots page.

FFT Plot

Button Icon What it does
Interpolation Cycles the spectrum line between raw points and interpolated curves.
Show Area Under Plot Fills the area beneath the spectrum. Available only with line interpolation.
Show X Axis Label Shows or hides the frequency-axis label.
Show Y Axis Label Shows or hides the magnitude-axis label.
Show Crosshair Tracking crosshair.
Pause / Resume Freezes drawing.
Reset View Resets pan and zoom.
Axis Range Settings Fixed axis ranges.

See the FFT Plot entry for window size and sampling-rate configuration.

Waterfall (Pro)

Control Icon What it does
Color map (dropdown) Picks the color map (Viridis, Inferno, Magma, Plasma, Turbo, Jet, Hot, Grayscale).
Dynamic range (dual slider) Sets the dB floor and ceiling mapped onto the color map (-120 to +20 dB).
Show Colorbar Shows or hides the color scale.
Show Axes & Grid Shows or hides the axes and grid.
Show Crosshair Frequency / time readout under the cursor.
Pause / Resume Freezes drawing.

See the Waterfall entry for details.

GPS Map

Button Icon What it does
Auto Center Keeps the map centered on the latest position.
Plot Trajectory Draws the path traveled.
Zoom In / Zoom Out Changes the map zoom level.
Show Weather Overlays a live weather layer.
NASA Weather Overlay Overlays the NASA GIBS imagery layer.
Base Map A dropdown that selects the map style (street, satellite, terrain, and so on).

3D Plot (Pro)

Button Icon What it does
Interpolate Smooths the trajectory between points.
Orbit Navigation Drag rotates the camera around the data.
Pan Navigation Drag slides the camera (mutually exclusive with Orbit).
Orthogonal View Snaps the camera to an isometric angle.
Top / Left / Front View Snaps the camera to a standard orthographic view.
Auto Center Keeps the cloud centered as new points arrive.
Anaglyph 3D Renders a red / cyan stereo image for 3D glasses.
Invert Eye Positions Swaps the left / right eyes (enabled only with Anaglyph on).
Eye Separation (slider) Sets the stereo separation (enabled only with Anaglyph on).

Image View (Pro)

Button Icon What it does
Export Images Saves each incoming frame to disk.
Open Export Folder Reveals the export folder in the file manager.
Zoom In / Zoom Out Magnifies the image (1x to 5x), with drag to pan.
Show Crosshair Cursor crosshair with pixel coordinates.
Filter A dropdown of display filters (Normal, Grayscale, High Contrast, Vivid, Night Vision, Infrared, Deep Blue, Amber).

Data Grid

Button Icon What it does
Pause / Resume Freezes the table without stopping data collection.

Accelerometer

Button Icon What it does
Settings Opens the configuration dialog (max-G range).

Widgets without a toolbar

These widgets have no toolbar; their interaction is direct:

  • Bar, Gauge, Meter, Compass, Clock are two-page swipe views. Swipe horizontally, or click the page-indicator dots at the bottom, to flip between the analog face and the large digital readout. The active page is saved per widget.
  • Gyroscope and LED Panel are display-only.
  • Stopwatch has its own Start / Stop, Lap, and Reset buttons and a lap table; see Widget Reference.
  • Output controls (button, slider, toggle, knob, text field) are interactive inputs that send values to the device; see Output Controls.
  • Painter (Pro) renders entirely from its user script and has no toolbar; see Painter Widget.

Console toolbar

The console terminal has a send row and an options row rather than an icon toolbar.

Send row: an Attach button for file transmission, an input box that sends on Enter or the Send button, a HEX toggle to send hexadecimal, and dropdowns for line ending and checksum. On a multi-device project a device selector picks the target.

Options row: Show Timestamp, Echo, Emulate VT-100, and ANSI Colors checkboxes, a Display mode dropdown, and a Clear button. Right-click the terminal for Copy, Select all, and Clear.

Notification log

The notification log has a Filter by channel field, an unread-count badge, and a Clear all notifications button.

See also

Comments

Copied to clipboard!