Available Touch Actions
| Action | Description |
|---|---|
| INDEX | Change current page to whatever the configured index page is. |
| GO | Used for rotary or standard hardware buttons to execute the action on the currently highlighted component. |
| NEXTCONTROL | Move the highlight to the next control in the selection list of the page. Typically used with a rotary encoder. |
| PREVCONTROL | Move the highlight to the previous control in the selection list of the page. Typically used with a rotary encoder. |
| NEXTPAGE | Move the currently displayed page to the next one in the list. Excludes any pages being used as composites. Typically used with a rotary encoder but could also be used with TouchGauge actions if the gauges were placed on the Always Page. |
| PREVPAGE | Same as previous but for previous page. Both of these wrap around to the beginning or end depending on direction. |
| SPEEDLIM=<limit mph> | Set the system speed limiter warning to the specified speed. |
| TRIP=A|B | Set the currently displayed trip to either trip A or B. This is typically to control the displayed trip on another screen such as a cluster screen. Trips require separate hardware to implement fully. |
| INVERTSETTING=<setting> | Toggles the named setting between values 0 and 1. |
| ADJUSTSETTING=<setting>,X|Y | Used to enable a touch point on a touch screen to directly control the value of a named setting, in order to implement a slider bar. The slider can be either horizontal or vertical. For horizontal gauges, use X, and for vertical use Y. See examples for further help. Only suitable for use with a touch screen. |
| INCSETTING=<setting name> | Increment the named setting by the setting’s delta value, which is found configured in the [setting] section of the SDC.INI file. |
| DECSETTING=<setting name> | Decrement the named setting by the setting’s delta value, which is found configured in the [setting] section of the SDC.INI file. |
| RESETCURRENTTRIP | Reset the value of the current trip to zero. Trip support requires separate hardware. |
| NIGHTMODE | Toggles the night mode between on and off. Applies to the local node only. In night mode, the night mode colour set will be used as specified on various gauges. |
| DEBUGMODE | Toggles debug mode on all devices on the network. When debug mode is enabled, all gauges flagged as a debug gauge will be shown. |
| LOGSTARTSTOP | Pauses or resumes data logging on the local device. If data logging is resumed after being paused, the log file name is not changed; the log file that was being used when logging was paused is added to. |
| LOGSTARTSTOP=<deviceid> | Does the same thing as LOGSTARTSTOP only the device specified in the deviceid is controlled. |
| CYCLECURRENTCOMPOSITE | Cycles the currently selected composite page group between each of the pages. Every time this action is executed the composite page is advance to the next one, and wrapped back around to the first one when the last one is reached. |
| NEXTCOMPOSITE | Changes the selected composite group to the next group on the page. After changing the selected composite, executing another CYCLECURRENTCOMPOSITE will change the displayed composite page on the new group. |
| REMOTEPAGE=<device id>,<page number> | Change to the selected page number on the specified device. Used typically to control a cluster display with a separate control screen. |
| PAGE=<page number> | Change the local page to the specified number. Typically used to implement some sort of icon based page selection system. |
| PAGE=<source>,<target>[:<\source>,<target>]… | Used to change the locally displayed page, but accepts a colon separated list of <source>,<target> pairs, where <source> is the current page being displayed and <target> is the page that should be switched to. This enables a single button on the Always Page to be context sensitive. An example use of this would be to have a single button that displays a sequence of selected pages out of a wider set. Another example is to have a “home” button that toggles between a menu page and a basic gauge page. See examples. If the source is specified as 255 then the target of the pair is the “default” target. This target will be used if you are on a page that is not present in the source list. |
| SHOW=<gauge name>;<timeout> | Makes a hidden Gauge visible for the specified number of seconds. After the timeout expires, the gauge will be hidden again. Enables some sort of confirmation message to appear on screen and then be automatically removed. e.g. I have used this to show a marker has been added to a log. |
| RTT=ON|OFF|TOGGLE | Turn on, off, or toggle the RTT function. |
| SAVERTTDATA | Saves the current RTT data to a file on the SD Card. The filename used will be the same as the current log file but with a ‘.rtt’ file extension instead of ‘.log’ |
| LOGMARKER | Places a marker inside the datalog file which can be read by MegaLogViewer when reviewing a log. The marker request will be broadcast onto the canbus network if one exists, so that all logging nodes will take the same action. |
| SHUTDOWN | Executes a clean system shutdown of the cluster. This closes all datalogs and saves all settings that may have changed while the system was running. This obviously does not disconnect the power from the device, and in fact the Application Console will still work if you are on WIFI. See the Controlled Shutdown section for more details. |
| ENCODERMODE1 | This touch action is Deprecated. Changes the rotary encoder mode to mode 1. See the rotary encoder section for further information |
| ENCODERMODE2 | This touch action is Deprecated. Changes the rotary encoder mode to mode 2. See the rotary encoder section for further information |
| ENCODERMODE3 | This touch action is Deprecated. Changes the rotary encoder mode to mode 2. See the rotary encoder section for further information |
| STOPWATCHSTOP= | Stops a running stopwatch with the given timer id (a number). Set the TimerID property of a StopwatchGauge to the specified ID to control it |
| STOPWATCHSTART= | Starts a stopwatch with the given timer id (a number). Set the TimerID property of a StopwatchGauge to the specified ID to control it. If the stopwatch is already running, it will be reset to zero and keep running. |
| RESETPERFTIMER= | Resets a performance timer with the given timerid (one which is triggered from a threshold of an attribute). Set the TimerID property of the PerformanceGauge to the specified ID to control it. The timer will be set to zero and will wait for the start thresold to be crossed again before it restarts. |
| ACTIVATECHART= | Activates the ChartGauge with the given timerid. All charts with this id will be activated across all pages, but only those being displayed will do anything. In addition, if the chartgauge is in a non-zero group, then all other charts with different timerids that are in the same group will be deactivated. Note that if you activate a chart and then switch to a page containing a chart with that timerid, it will already be active. |
| SAVECHARTDATA= | Saves the current chart data to a file in the \rawdata folder. The AttributeAxis values are saved with it. |
| STOREPAGE | Stores the current page. This action remembers the currently selected page so that it can be selected later with the RESTOREPAGE action. If more than one STOREPAGE action is executed, only the last current page is remembered i.e. the action is not recursive. Use this action in conjunction with RESTOREPAGE to jump to some other page and then be able to return back to the previous page without having to directly specify it (e.g. open a menu page and then close it again) |
| RESTOREPAGE | Sets the current page to the previously stored page. See STOREPAGE for further details. |
| ENCODERTARGETDEVICE= | If a rotary encoder is connected to the SDC instance, and a canbus is configured, then this touch action changes the target device of the encoder so that encoder actions are passed to the remote device. If a remote encoder device is specified via the encodertargetdevice ini file setting, then this touch action is ignored. |
| ENCODERMODE= | This touch action replaces the ENCODERMODE |
Touch actions can be combined so that a single touch (or hardware button input) can trigger multiple actions. To do this, join the actions together with a semicolon; for example:
PAGE=1;ENCODERMODE=2This changes the page to page 1 and changes the rotary encoder mode to mode 2. You might use this to jump to an index page with actionable icons (touch gauges) on it.