Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Warnings

Warnings are implemented as composites. The concept is that if a warning is generated whose id matches a composite with a defined warning id, then the composite will be shown. Warnings are generated internally by the software under certain circumstances but can also be generated by sending canbus messages specifically designed to trigger other warnings. For example, if you had a separate device monitoring fuel level, it might want to generate a low fuel level warning (SDC itself could receive a fuel level, but there is no internally generated “low fuel level” warning within it).

Context

<composites>
    <group id="0">
        <composite page="0" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="1" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="2" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="4" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="12" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="22" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375"></composite>
        <composite page="5" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1198"></composite>
        <composite page="6" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1197"></composite>
        <composite page="7" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1190"></composite>
        <composite page="8" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1195"></composite>
        <composite page="14" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1194"></composite>
        <composite page="16" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1193"></composite>
        <composite page="20" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1192"></composite>
        <composite page="21" x="810" y="182" xscale="1" 
            yscale="1" highlightx="50" highlighty="375" warningid="1191" 
                    maxwarnings="1"></composite>

    </group>
</composites>

The rows in this example with a “warningid” entry in them are composites that are activated when conditions are met that the warning is based on. Some of these warnings are generated internally; for example if your speed goes above the currently set speed limiter then SDC generates its own warning. Other warnings are not generated internally and are only generated when a canbus message indicating the warning should be triggered is received. Low fuel level is one such warning.

The following warning ids are present in the system:

Warning ID Description Internally Generated?
1190 Oil pressure out of bounds (too high or too low). Yes
1191 Tyre pressure warning (temperature or pressure related) Based on tyre data that must be externally sent
1192 Average speed exceeds current setting Yes
1193 Speed camera in the vicinity Yes
1194 Exceeded the selected speed limit Yes
1195 Handbrake is on while vss > 0 Yes (provided accessory bits are populated externally)
1197 headlights are on when ignition is off or rpm=0 Yes (provided accessory bits are populated externally)
1198 Low fuel level warning No

Operation of Warnings

Whenever a warning is generated, if the currently displayed page contains a composite definition that matches the warning ID, then the composite page representing that warning will be displayed. If multiple warnings are active at the same time then SDC will cycle through the warnings one at a time, leaving each one visible for 3 seconds.

Any visible warnings can be cleared by cycling the current composite, but they may reappear again unless you have also configured the warning with the “maxwarnings” attribute (see the last warning example in the XML above). When “maxwarnings=n” is set, where n is an integer, the system will count the number of times the warning has been cancelled. When it reaches n cancellations, the system will not show the warning anymore.

Note you can’t cancel an individual warning; only all active warnings.