Mapping functions to LEDs for VDASH-EMU templates tips

[zappadoc]

Mapping functions to Marshal and External LEDs for VDASH-EMU templates

As you may know, VDASH-EMU is an emulator of the firmware of the great SIM Race F1 USB device from SIM Display. As such, it can manage up to:
15 RPM leds
 6 Marshal leds
 7 External leds

Consider those numbers as a SLOT. Marshal from 1 to 6 and External from 7 to 13. Later, you will learn how to map a function to these SLOTS using SLIMax Manager Pro.

But for now we continue with the creation of your template, so you can easily add any Marshal and External Leds you want by simply select the object in the MISC menu




Now you have an LED object on the page you can edit its properties



and map the object to one of the 6 Marshal SLOT or one of 7 External SLOT






you have now enough info to create VDASH-EMU template with Marshal or/and External led and you know how to map the led to their SLOT, next post will talk about mapping the function to each SLOT using SLIMax Manager Pro.

...
 

[zappadoc]

Mapping a function to LED SLOT using SLIMax Manager Pro

We assume here that you know how to create a custom car setup and know some basic info on Advanced Setup Options

In Advanced Setup Options, we are interested by LED functions which are mainly in MISCELLANEOUS > LED section of your car setup



My advise is to not overlap functions on one LED SLOT until you are comfortable with the LED mapping functions.

Here is a common assignment of functions to LED SLOT that you may use safely in your car setup:

(0 =  usually NOT mapped)

Code: c

OSP                => Marshal led slot 1 and 6
LED PIT LIMITER       => 0 or Marshal led slot 5
LOW FUEL          => Marshal led slot  2
TC                => 0 or any External led slot 
ABS                => 0 or any External led slot 
GREEN FLAG          =>  0 or any External led slot 
YELLOW FLAG          => Marshal led slot  3 and 4
RED FLAG          =>  0 or any External led slot 
OVER HEATING       => Marshal led slot  3 or 5 or 2
DAMAGE             => Marshal led slot  3 or 5 or 2
PIT REQUEST          => Marshal led slot  6
POWER             =>  0 or any External led slot like the External Led SLOT 9
REV LIMIT          =>  0 or any External led slot 
HEADLIGHTS          =>  0 or any External led slot 
BLUE FLAG          => Marshal led slot  1
DRS                => Marshal led slot  5 or 2
DRS LEGAL          => Marshal led slot  5 or any External led slot 
KERS             => Marshal led slot  5 or any External led slot 
OSP OVERDRIVE       =>  0 or any External led slot 
ENGINE MAP OVERDRIVE =>  0 or any External led slot 
START LIGHTS       =>  0 or any External led slot 
LOCK SETTINGS       =>  0 or any External led slot 

In the example below we assign LED SLOT 2 to LOWFUEL function:



DESCIPTION OF THE FUNCTIONS:

OSP
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the Optimal Shift Point is reached (see the SHIFTPOINTS section of the setup)

LED PIT LIMITER
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the PIT LIMITER is triggered (see the PITLIMITER section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the PIT LIMITER status

LOW FUEL
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the LOW FUEL is detected (see the MISCELLANEOUS section of the setup).
This function works start the detection AFTER the first lap, and will continue detection in LAST lap if the function is set to true
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send several data related to fuel capacity and consumption.

TC
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the Traction Control is triggered (see the GENERAL section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the TC status

ANTILOCK BRAKE (ABS)
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the Anti-lock Brake (ABS) is triggered (see the GENERAL section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the ABS status

GREEN FLAG 
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the GREEN FLAG is up (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the GREEN FLAG status

YELLOW FLAG
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the YELLOW FLAG is up (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the YELLOW FLAG status

RED FLAG   
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the RED FLAG is up (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the RED FLAG status

BLUE FLAG   
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the BLUE FLAG is up (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the BLUE FLAG status

OVER HEATING
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if engine over heating is reached (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the engine over heating status

DAMAGE      
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the car or engine of the car is damaged (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the car / engine damage or detached part status

PIT REQUEST
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the Pit Request is triggered (see the PITLIMITER section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the Pit Request status

POWER       
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the manager and simulation or game is running (see the MISCELLANEOUS section of the setup).

REV LIMIT
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the MAX ENGINE RPM is reached (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the Max Engine RPM value
Attention, THIS IS NOT THE OSP LIMIT but the maximum rpm value of the current engine at FULL THROTTLE.

HEADLIGHTS 
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the head lights are ON (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the head lights status

DRS        
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the DRS is triggered (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the DRS status

DRS LEGAL   
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the DRS is allowed (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the DRS LEGAL status

KERS       
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the KERS is triggered (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the KERS status

OSP OVERDRIVE
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the MAP OVERDRIVE button is set, this function is used to change MAP OSP to an aggressive engine setup and is usually used in qualify or on first laps of a race (see the SHIFTPOINTS section for the CONTROLS button and the LED).

ENGINE MAP OVERDRIVE
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the ENGINE MAP OVERDRIVE is set (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the  ENGINE MAP OVERDRIVE status

START LIGHTS       
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the START Lights are ON (see the MISCELLANEOUS section of the setup).
NOT AVAILABLE IN ALL API. To work the simulation or game API MUST send the START LIGHTS status

LOCK SETTINGS       
This is an internal function of SLIMax Mgr Pro to lit up the selected LED if the LOCK SETTINGS button is set, this function is used to lock settings and prevent any unwanted change  (see the GENERAL section for the CONTROLS button and the MISCELLANEOUS section for the LED).



For advanced user only:

Read more   ...:

The following list contains the functions in the EXACT ORDER they are executed from OSP to LOCK SETTINGS.

This is very IMPORTANT to keep this order in mind because if you assign MULTIPLE functions to ONE led SLOT, the STATE (ON or OFF) OF THE NEXT FUNCTION in current order WILL SUPERSEDE THE PREVIOUS SATE

Code: c

OSP (see SHIFTPOINTS section of setup )
LED PIT LIMITER (see PITLIMITER section of setup )
LOWFUEL
TC (see GENERAL section of setup )
ABS (see GENERAL section of setup )
GREEN FLAG
YELLOW FLAG
RED FLAG
OVER HEATING
DAMAGE
PIT REQUEST (see PITLIMITER section of setup )
LED POWER (see GENERAL section of setup )
REV LIMIT (attention, this is the MAX ENGINE RPM not the OSP Limit)
HEADLIGHTS
BLUE FLAG
DRS
DRS LEGAL
KERS
OSP OVERDRIVE (see SHIFTPOINTS section of setup )
ENGINE MAP OVERDRIVE
START LIGHTS
LOCK SETTINGS
IGNITION (Ignition function supersede ALL OTHER FUNCTIONS

This is the tricky part of the settings, the priority order in which functions state are updated is very important. Read again the comment relating to this part (see the settings file itself).
Let say you have only one function assigned to a led. Set RESETLEDTRACTIONCONTROL to true and the software will reset the state of the led (shut off) before updating its status (Pretty straightforward to figure out).
But now if you have two functions assigned to the same led, you can't reset both functions as the first one (in priority order) will not work if the second is OFF...

For example:
led 6 is assigned to TC and PitRequest function (TC is first in priority list):
RESETLEDTRACTIONCONTROL=True
LEDTRACTIONCONTROL = 6

RESETLEDPITREQUEST = false
LEDPITREQUEST = 6

1)
TC ingame is ON
PitRequest ingame is OFF
TC function is reseted (true in RESETLEDTRACTIONCONTROL)
PitRequest function is not reseted as RESETLEDPITREQUEST = false
led 6 is updated to ON <------ OK

2)
TC ingame is now OFF
PitRequest ingame is OFF
TC function is reseted (true in RESETLEDTRACTIONCONTROL)
PitRequest function is not reseted as RESETLEDPITREQUEST = false
led 6 is updated to OFF <------ OK

3)
TC ingame still OFF
PitRequest ingame is now requested and is ON
TC function is reseted (true in RESETLEDTRACTIONCONTROL)
PitRequest function is not reseted as RESETLEDPITREQUEST = false
led 6 is updated to ON <------ OK

4)
TC ingame is now ON again
PitRequest ingame still ON
TC function is reseted (true in RESETLEDTRACTIONCONTROL)
PitRequest function is not reseted as RESETLEDPITREQUEST = false
led 6 is updated to ON <------ OK

In short, the priority order of functions is IMPORTANT because if you map ONE LED SLOT to 2 or more functions, the function who have a higher priority will SUPERSEDE the previous functions and will change the state of the LED to OFF or ON.

OTHER SECTIONS WITH LED FUNCTIONS:

In additon to MISCELLANEOUS section, you will find other sections in setup to set the LED Functions.

GENERAL section:



PIT LIMITER section:



SHIFTPOINTS section: