Channel List

The Channel List provides a customisable list of available channels. This is useful to group similar channels or those which are used together. The Channel List works in the same way as the Option Selection List, just for channels not options.  For how to add objects see the Adding an Object section.

When the ECU is offline, the values in the Channel List are greyed out.

Adding Channels

When a Channel List is added you be shown a blank list with a single blank entry:

Blank Channels Blank Channels

To add an channel simply start typing the name of the channel and GWv4 will provide a list of likely options or click the ‘’ button and you will be shown a list of all available channels. Select the channel you want to display and click ‘OK’. This will add the selected channel to the list and provide a new blank entry from which to select another channel:

Single Channel Single Channel

Adding Multiple Channels

From the channel selection list you can add multiple channels. Click on the ‘’ button to bring up the available channels, then either click and drag over the channels, or use mouse click and either Shift or Ctrl keys to select separate items.

Once selected, click ‘OK’ and the items will be added to your selection list:

Selected Channels Selected Channels

Setting up Limits

For each channel displayed you can set up limits. This can either be to set the range of values (view range) displayed by the bar or to set warnings if the value goes above or below certain values (alarm range). Right click on the channel in the list you want to set a limit for and click on limits, alternatively simply use the keyboard shortcut Alt+L and the following window will be displayed:

Channels List Limits Channels List Limits

The view range, and alarm range can then be set for the channel. If set then they will automatically be enabled, though they can be disabled again by simply un-ticking the enable box.

If the channel then goes out of the alarm range, the channel will go red, as can be seen in the Bar section.

Locking the list

The list can be locked by clicking on the padlock icon Channel List Locked Icon in its title bar. This prevents items being added or removed from the list.

View Properties

Properties editable via the properties editor.

PropertyScript IDDescription
Title title The title of the window.
Script ID id The scripting ID of the window. Can be used as an alternative to the title for searching for windows from scripts.
Tool Tip tooltip Window tool tip.
Display Units display_units_text Show units after the number on the view.
Display Units (Label) display_units_label Show units after the label on the view.
Prefix Text prefix_text Text to display before the value.
Postfix Text postfix_text Text to display after the value.
Limits limits Set up alarm limits for this gauge.
Show Value show_value
Show Label show_label
Label Font label_font
Value Font value_font
Value Height % value_height_percent A value of zero disables auto font size fitting if Value Height Max is set
Value Height Max [dp] value_height_max_dp Maximum font height of the value text, in device pixels
Label Height % label_height_percent
Label Height Max [dp] label_height_max_dp Maximum font height of the label, in device pixels
Label Text label_text
Label Align label_align
Label Vertical Align label_valign
Value Align value_align
Value Vertical Align value_valign
Low Limit Text low_limit_text
High Limit Text high_limit_text
Value Override Text value_text
Max length Text max_length_text Leave blank for auto
Background bg_colour Background colour
Text text_colour Text colour
Alarm Low Background alarm_low_bg_colour Alarm Lower Limit Background colour
Alarm Low Text alarm_low_text_colour Alarm Lower Limit Text colour
Alarm High Background alarm_high_bg_colour Alarm Upper Limit Background colour
Alarm High Text alarm_high_text_colour Alarm Upper Limit Text colour
Input Value parameter The source of the value that will be displayed by the gauge.
Update Rate update_rate Rate at which the input value is requested from the ECU.
Decimal Places decimal_places Set to -1 for auto