Page Section

The [PAGE] section defines the content and behaviour of the dashboard pages. The first page defined is displayed on power up. Pressing the next-page button displays the second and subsequent pages, with the first page following the last.

Each page definition has the following form:

name {
settings
poll block
show block
}

The name is not very important, but it will appear on the preview page. It and the open brace must appear on the same line, with the rest of the definition on later lines. The closing brace must also be on a line by itself.

The settings set overall behaviour for the page. The poll block identifies what information to retrieve from the Megasquirt. The show block defines how the information will be displayed.

Everything within the braces is optional. An empty page definition gives a blank screen; the dashboard won't request anything from the Megasquirt, but waits for the next-page button to be pressed.

Settings

• POLLCYCLE num (32)
  num must be a power of 2 between 2 and 128. This is the number of polls between updates of min, mean or max values on the screen. Polling itself always happens 16 times per second, pollcycle / 16 is how many seconds there will be between display updates for these values. The default of 32 gives updates every 2 seconds.
• DLIST dlist1 dlist2 dlist3 (blackbg none none)
  Each value is either a defined display list or the word none. dlist1 will be run when this page is to be displayed before anything else is drawn. dlist2 will be run when this page is to be displayed, but after all the empty widgets have been drawn on the screen. dlist3 will be run when the next-page button has been detected, before starting to draw the next defined page.

  The default blackbg display list fills the display with black instead of the stippled black and white pixels the screen hardware provides when turned on.

• BLDUTY percent1 percent2 (100 30)
  percent1 is the LCD backlight duty cycle to be used when the vehicle lights are off. percent2 is the LCD backlight duty cycle to be used when the vehicle lights are on.

Poll block

The poll block declares what is to be retrieved from the Megasquirt. It is structured as follows:

poll { channels }

where channels is made up of zero or more entries of the form:

channel_name { options }

channel_name is the name of one of the channels from the [OutputChannels] section of the Megasquirt INI file. It is case sensitive and must match exactly.

options is a group of zero or more of the following:

• method=[mean|min|max|last] (mean)
  sets the method by which values are accumulated. In the last case, values aren't accumulated at all, but update every time they are sampled. The other methods accumulate samples until POLLCYCLE values (see above) have been gathered, then:
  • mean uses the mean of all samples
  • min uses the smallest sample
  • max uses the largest sample
• round=num|none (none)
  sets how the accumulated value is to be rounded. If set to none, no rounding is performed and the value is represented to the precision stated in the Megasquirt INI file. Otherwise num must be a power of 10 and lower-order digits will round that digit in the customary way. If num is 10 or greater, trailing zeros are appended until the decimal point. If num is 1 or greater there will be no decimal point in the result. The rounding digit cannot be to the right of the lowest digit specified in the INI file.
• name=string ( channel_name)
  sets a symbolic name for this polled value. Names are case sensitive and cannot be repeated in the one page definition. Widgets in the show block refer to polled values using this name.

If no options are specified the braces may be omitted too.

Show block

The show block defines how polled information is to be displayed. It is structured as follows:

show { widgets }

where widgets is made up of zero or more entries of the form:

slot wtype{woptions}

and:

• slot is a slot number between 0 and 15
• wtype is one of the defined widget types
• woptions is a set of valid options for that widget type.

Smaller slot values must come before larger ones, and using a slot that is already occupied by an earlier widget will lead to an error.

Any slots not explicitly assigned will be populated with BLANK widgets.