Documentation on Actions and Triggers?

Dashboard Design Generic Design Discussion
1

Is there any documentation on the Actions that can be implemented and the Triggers that can be defined?

(sorry for the many messages but I feel an incredible potential and I’m frustrated not to be able to exploit it… thank you for your work)

1 Like
2

I haven’t found an official document yet, so I can only write down what I already know or found out. Please correct me if I’m wrong and feel free to add.

Triggers

A trigger is basically an if-else statement that will execute certain actions (it will ‘fire’) when the if statement is true, i.e. all trigger conditions are fulfilled.

Conditions

A condition lets you compare an input value to either a fixed value or another input value. Possible comparisons of values A and B are:

Verbal Equation (Pseudo)Code
A is equal to B A = B A==B
A is not equal to B A ≠ B A!=B
A is greater than B A > B A>B
A is not greater than B A ≤ B A<=B
A is less than B A < B A<B
A is not less than B A ≥ B A>=B
A’s value has chaned – –

You can chain multiple consitions using and and or operators by pressing “Add AND” or “Add OR” respectively.

Cooldown

In the “Trigger” menu, you can define a cooldown, measured in seconds. The trigger will be prevented from firing again until this much time has passed since its last fire. (PS: in iOS, it somehow will fire the trigger again immediately AND after the cooldown time has passed. Is this intended behavior?)

Actions

In the “Actions” pane of the Trigger menu, you can add actions which will be run when trigger conditions are met; this is analog to the code inside brackets after an if statement.

Actions

Actions are commands which can be run by triggers or by pressing a button. The following types are available:

  • Animate Value: s
  • Back to Previous Page: Go to the last page displayed in your Dashboard
  • Change Value:
  • Clear Error Codes: Delete all stored diagnostic trouble codes (DTCs) from ECU (OBD mode 04)
  • Fade Gauge:
  • Fullscreen Alert: Display a text message on red full screen
  • Hide Gauge: Make the selected gauge invisible and non-interactive
  • Hold Value:
  • Jump to Page: Go to dashboard page with corresponding number
  • Launch Web Browser: Open the defined URL in a web browser
  • Launch App: Open the selected app on your device
  • Map Center: Center view on your current position on the selected map gauge
  • Minimize Application: Minimize RealDash and go to home screen
  • Navigate to Destination: Open up a window to enter your destination and start navigation
  • Next Page: Go one page to the right
  • Next Recent Dashboard: Open the next recent dashboard in your Dashboards folder
  • Next Song: Play next song in current folder
  • Next Song Folder: Play first song in the next folder
  • Next Video: Play next video
  • Open Debug Data View: Does what it says on the tin
  • Open Virtual Keyboard: Open up a keyboard to enter text values
  • Pause Music: Pause currently playing song
  • Pause Stopwatches: Pause all stopwatches
  • Phone Call: s
  • Play Music: Start music playback. If playback is already started, do nothing
  • Play Sound Effect: Play the selected sound effect asset (file types: mp3, ogg, m4a, aac…)
  • Press Button: Simulate a press on the selected button gauge
  • Previous Page: Go one page to the left
  • Previous Recent Dashboard:
  • Previous Song: Play the song before the currently playing song
  • Previous Song Folder: Play the first song of the previous folder
  • Previous Video: Play the video before the currently playing one
  • Quit Application: Quit RealDash
  • Read Error Codes: Read stored diagnostic trouble codes (DTCs) from connected device (OBD mode 03)
  • Reroute Navigation: s
  • Reset Current Trip: Set values of ‘Current Trip: Session Distance’, ‘Current Trip: Average Speed’, ‘Current Trip: Maximum Speed’ etc to 0
  • Reset Gauge History Mode: Reset history mode values to 0 for the selected gauge
  • Reset History Mode, All gauges on page: Same as above, but for all gauges on the current page
  • Reset Service Notification:
  • Reset Trigger: Reset the current trigger
  • Reset Trip A: Set distance, average speed, max speed etc for Trip A to 0
  • Reset Trip B: Set distance, average speed, max speed etc for Trip B to 0
  • Reset app uptime: Set ‘App Uptime’ value to 0
  • Restore Application:
  • Rotate Dashboard Page:
  • Rotate Value Down: Subtract the value defined in ‘Step’ from the input value until minimum is reached. If ‘Stop’ is 1 while input value is at or below minimum, do nothing. If 'Stop is 0, set value to maximum and continue subtracting
  • Rotate Value Up: Add the value defined in ‘Step’ to the input value until maximum is reached. If ‘Stop’ is 1 while input value is at or above maximum, do nothing. If ‘Stop’ is 0, set value to minimum and continue adding
  • Run Intro: Run the defined intro video
  • Run Terminal Command: Run a defined terminal command
  • Run Dashboard Sweep: Let all gauges sweep to maximum, then to minimum, then to their current values
  • Send CAN frame: Send the defined frame to the connected ECU
  • Set Gauge Text: Have the selected text gauge display the text defined here
  • Set Language: Set the UI language to the language selected here
  • Set Value: Set the selected input value to a numerical value
  • Set Value (formula): Set the selected input value to the result of an equation
  • Set Value on Trigger Status:
  • Show Gauge: Make the selected gauge visible and possible to interact with
  • Show PopUp: Show a pop-up message
  • Show Toast:
  • Show System Notification: Show a push notification
  • Speak Text: Run Text-to-Speech for the selected text
  • Start Datalogging:
  • Start Navigation:
  • Start Screen Capture:
  • Start Stopwatches:
  • Start Voice Command Recognition:
  • Stop Datalogging:
  • Stop Navigation:
  • Stop Screen Capture:
  • Stop Stopwatches:
  • Toggle Datalogging:
  • Toggle Metric-US Units:
  • Toggle Music Playback Shuffle:
  • Toggle Navigation:
  • Toggle Pause Music:
  • Toggle Screen Capture:
  • Toggle Value On/Off:
  • Vibrate:
  • Video Gauge Pause:
  • Video Gauge Pause Record:
  • Video Gauge Play:
  • Video Gauge Reset:
  • Video Gauge Start Record:
  • Video Gauge Stop:
  • Video Gauge Stop Record:
  • Video Gauge Toggle Record:
  • Video Toggle Pause:

h

2 Likes
3

Many thanks for your work and the information provided !

Do you have more details on the formulas that can be defined in this action?
Is it possible to reference another input?

1 Like
4

They use the same syntax as ‘Gauge Math’. Other inputs can be referenced by their target ID. For example, if you want to reference ‘Vehicle speed’, you enter ID64. You can find a list of all target IDs here.

As another example, let’s assume your units are set to Metric, but you want only speed to be shown in MPH. The conversion formula is MPH = kmh / 1.609344. So, if you set an action that will set the value to ‘Vehicle Speed’ but in MPH, you enter =ID64/1.609344.

As far as I know, the following operators work with formulas and Gauge Math:

  • addition: A+B
  • subtraction: A-B
  • multiplication: A*B
  • division: A/B
  • rounding up: CEIL(A)
  • rounding down: FLOOR(A)
  • brackets: (A+B)*C vs A+B*C = A+(B*C)
  • powers: A^B
  • square root: SQRT(A)
  • natural exponential: EXP(A) (yields the same as E^A)
  • natural logarithm: LN(A)
  • decimal logarithm: LOG(A)
  • minimum (smaller of two values): MIN(A,B)
  • maximum (larger of two values): MAX(A,B)
  • constants: π = 3.14159… = PI, e = 2.718… = E

Formulas and Gauge Math equations must start with =. If you’re using the assigned input value itself in Gauge Math, you can use V to refer to the input value itself rather than dealing with target IDs.

Please let me know about more working operators if you know.

Edit: added a few more by testing

4 Likes
5

You’re great!
I’m going to try it all :slight_smile:

1 Like
6

Thank you for sharing this, hopefully it will be helpful for many.

1 Like