Instrument Panel - boschmotorsport/WinDarab GitHub Wiki

Instrument Panel

The Instrument Panel is a window used to visualize data at the current cursor position.

Settings

Instrument Panel settings can be edited/loaded/saved using the F5/F6/F7 function keys (like many other windows)

Element Selection/Placement

  • Instrument panel allow to select multiple gauges by pressing the Ctrl + Left Click or using a rubberband.
  • The location and size of all selected gauges can be adjusted in a single step.
  • Copy and paste of the selected gauges is supported
  • The layout grid is removed. Now the borders of the gauges act as magnetic lines making it easy to align/adjust gauges.
  • If multiple gauges are selected, the arrow keys can be used to move the gauges by pixel (without snapping to the magnetic lines). Additionally the arrow keys can be used with Shift to align all gauges to the top, left, bottom or right border, together with Ctrl the size can be adjusted (Ctrl+Right Arrow, Ctrl+Down Arrow) or aligned and sized (Ctrl+Left Arrow, Ctrl+Up Arrow)

Elements

The elements that can be used on an Instrument Panel are:

Value Display

Value Display Example[]

Value Display Common Settings

The Value Display can be configured with the following settings:
Value Display Common Settings

  • Channel: Defines the channel data that the element will present
  • Caption: Allows an alternate 'channel name' to be displayed
    • This is useful in the event the measured channel name is not descriptive / long
  • Number Format: Defines the number of digits, number decimals, and scaling that will be used
  • Gauge/Caption: Control the base colors of the display element
  • Upper/Mid/Lower Range: Control the color of the display element based on the current cursor position value of the channel.

Value Display Alert Settings

The Value Display can be configured to visually alert the user based on the channel value. Value Display Alert Settings

  • Hysteresis: the value the channel must change in order to clear a triggered alert
    • Example Engine Water Temperature: Hysteresis value = 2 and Upper range = 100
      • The Alert will trigger when the channel value goes above 100
      • The Alert will clear when the channel value goes below (100 - 2) = 98
  • Upper/Mid/Lower Range: Toggle alerts based on the values on the Common Settings screen.
  • Time Controls: Define time based automatic clearing of alerts or retriggers

Advanced Value Display Usage - PBX Output

Value Displays can be configured to show an enumeration of the channel. This can be very useful for error channels where a text value is more descriptive than an error code.

Value Display Example

Tutorial:

  1. Enter the Tools → Channels Settings Window
  2. Select the channels of interest (in our case PBX Output State)
    Channel Settings Window
  3. Change the 'Format' cells to 'Other Formatters -> More'
  4. Create a channel formatter for PBX Output States
    Channel Formatter Setting
  5. Add the channel as a Value Display to your instrument panel

Pitfall: The formatter is a global setting, so if you go to an Oscilloscope and change the Channel Format back to display a number, your instrument panel will also change back to a number

Value Display Properties

Bar Display

Bar Display Example

Bar Display Common Settings

The Bar Display can be configured with the following settings:
Bar Display Common Settings

  • Channel: Defines the channel data that the element will present
  • Caption: Allows an alternate 'channel name' to be displayed
    • This is useful in the event the measured channel name is not descriptive / long
  • Number Format: Defines the number of digits, number decimals, and scaling that will be used
  • Gauge/Caption: Control the base colors of the display element
  • Upper/Mid/Lower Range: Control the color of the display element based on the current cursor position value of the channel.

Bar Display Settings

Bar Display Settings

  • Orientation: Select between Horizontal and Vertical layout
  • Shape of Color: Drawing controls for the Bar Display
  • Peaks: Controls for visual indication of min/max values

Bar Display Alert Settings

The Bar Display can be configured to visually alert the user based on the channel value.
Bar Display Alert Settings

  • Hysteresis: the value the channel must change in order to clear a triggered alert
    • Example Engine Water Temperature: Hysteresis value = 2 and Upper range = 100
      • The Alert will trigger when the channel value goes above 100
      • The Alert will clear when the channel value goes below (100 - 2) = 98
  • Upper/Mid/Lower Range: Toggle alerts based on the values on the Common Settings screen.
  • Time Controls: Define time based automatic clearing of alerts or retriggers

Round Scale

Round Scale Example

Round Scale Common Settings

The Round Scale can be configured with the following settings:
Round Scale Common Settings

  • Channel: Defines the channel data that the element will present
  • Caption: Allows an alternate 'channel name' to be displayed
    • This is useful in the event the measured channel name is not descriptive / long
  • Number Format: Defines the number of digits, number decimals, and scaling that will be used
  • Gauge/Caption: Control the base colors of the display element
  • Upper/Mid/Lower Range: Control the color of the display element based on the current cursor position value of the channel.

Round Scale Style Settings

Round Scale Settings

  • These are self explanatory

Round Scale Alert Settings

The Round Scale can be configured to visually alert the user based on the channel value.

Round Scale Alert Settings

  • Hysteresis: the value the channel must change in order to clear a triggered alert
    • Example Engine Water Temperature: Hysteresis value = 2 and Upper range = 100
      • The Alert will trigger when the channel value goes above 100
      • The Alert will clear when the channel value goes below (100 - 2) = 98
  • Upper/Mid/Lower Range: Toggle alerts based on the values on the Common Settings screen.
  • Time Controls: Define time based automatic clearing of alerts or retriggers

Bit Panel

Bit Panel Example

Bit Panel Common Settings

The Bit Panel can be configured with the following settings:
Bit Panel Common Settings

  • Channel: Defines the channel data that the element will present
  • Caption: Allows an alternate 'channel name' to be displayed
    • This is useful in the event the measured channel name is not descriptive / long
  • Bit Panel Layout: Control the shape/layout of the bit panel
  • Colors: control the Bit Panel level color settings (can be override on the Bit Settings tab)

Bit Panel Style Settings

Bit Panel Settings

  • Overrides for individual bits
    • Provide the displayed name / color settings for each bit.

Bit Panel Alert Settings

The Bit Panel can be configured to visually alert the user based on the channel value.

Bit Panel Alert Settings

  • Alert: Define which bits provide alerts
  • Time Controls: Define time based automatic clearing of alerts or retriggers.

Advanced Bit Panel Usage - PBX Output State

Using PBX Output State as an example, you can define the Bit Panel to present the Output State of a PBX output in a user friendly way:

Bit Panel PBX Example Bit Panel PBX Example

Tutorial:

Step 1:

  • Create a filter/default Math Function:
2 ^ ({Default} + 4)
  • Name it "pbx"

Step 2:

  • Add a Bit Panel to your Instrument Panel

Step 3:

  • Define the name of your channel

Bit Panel Example 1

Step 4:

  • Configure the panel layout and Bit Settings

Bit Panel Layout Bit Panel Layout

⚠️ **GitHub.com Fallback** ⚠️