====== Scoreboard Devices ======
ZRound supports Scoreboard devices in order to show positions and times on a big display.

Next you will find details about the protocol used.

===== Protocol =====

The protocol includes the commands //RESET, TIME, POSITION// described below in their default values. The commands can be fully configured in the ZRound Scoreboard configuration page

 ** RESET: ** //ZRound// sends this command when the race starts to “clear” the display. The default value is "$*****9999****#"

** RACE TIME: ** //ZRound// sends the race time every second and you can define. You can define if you want to send race time, day time or both of them.

** CAR LAP/TIME: ** //ZRound// sends the racer’s lap/time. You can setup the message and you to send the racer’s number, position, laps, and race time. Last lap time is not sent but it will be easy to implement. On every pass, all racer's data is sent (not only for the detected car).

In order to configure the commands these “variables” can be used:
<code>
<HH>: Day time hours
<MM>: Day time minutes
<SS>: Day time seconds
<hh>: Race time hours
<mm>: Race time minutes
<ss>: Race time seconds
<P>: Position
<PP>: Position (2 fixed places with leading 0)
<LL>: Laps  (2 fixed digits with leading 0)
<L*>: Laps
<NN>:  Racer’s number (2 fixed digits with leading 0)
<N*>: Racer’s number
</code>
 
** New data fields since //release 1.12.19// **

<code>
Available on the CAR LAP command:
<NAME>        : Racer's name
<NICK>        : Racer's nick name
<LAP_TIME>    : Lap time
<TOTAL_TIME>  : Total time
<BEST_LAP>    : Best lap time
<MEAN_TIME>   : Mean time
<EST_LAPS>    : Estimated number of laps for the race
<EST_TIME>    : Estimated time to complete the race
<GAP>         : Time/Laps Gap from 1st position
<INTERVAL>    : Time/Laps difference with the driver ahead.

TIMES are written with the decimal point defined into the operating system regional settings.
</code>

** New data fields since //release 1.12.22// **
<code>
Available on the CAR LAP command:
<DATE>        : System date in yyyymmdd format
</code>

ZRound settings example:
<code>
a) Reset command: “$RESET#”
b) Race time info. “$TIME;<hh>:<mm>:<ss>#”
c) Lap info. “$LAP;<N*>;<P>;<LL>;<NICK>;<LAP_TIME>;<BEST_LAP>#”
</code>
 
During the race will be sent messages as these:
<code>
$RESET#
$TIME;00:00:01#
$TIME;00:00:02#
$LAP;1;1;1;ALO;9.977;9.977#
$LAP;2;2;1;WEB;10.811;10.811#
$LAP;1;1;2;ALO;11.761;9.977#
</code>

===== Tested devices =====

  *[RC-Callosa scoreboard device].
  *[[info@zround.com?subject=New Starting Lights system for ZRound|Add your own device]]**