IS RST

Introduction

The Race STart packet contains information about the current session. It is sent automatically at the beginning of a session, and can be requested with a TINY_RST packet.

IS_RST packet properties

Type	Name	Description
byte	Size	28
byte	Type	ISP_RST
byte	ReqI	0 unless this is a reply to an TINY_RST request
byte	Zero
byte	RaceLaps	0 if qualifying
byte	QualMins	0 if race
byte	NumP	number of players in race
byte	Timing	lap timing (see below)
char	Track[6]	short track name
byte	Weather
byte	Wind
word	Flags	race flags (must pit, can reset, etc - HOSTF_x)
word	NumNodes	total number of nodes in the path
word	Finish	node index - finish line
word	Split1	node index - split 1
word	Split2	node index - split 2
word	Split3	node index - split 3

Packet Details

Size

The size of the packet is always 28 bytes.

Type

The packet type from the ISP_ enumeration, always ISP_RST.

ReqI

ReqI is equal to zero if the packet is sent automatically, or equal to the value sent in the TINY_RST packet.

RaceLaps

The number of laps for the race, or zero if qualifying or practice. The format is the same as in IS_STA#RaceLaps.

QualMins

The number of minutes for the qualifying session, or zero if the session is a race or practice.

Timing

Lap timing, defined as follows:

// bits 6 and 7 (Timing & 0xc0):

// 0x40: standard lap timing is being used
// 0x80: custom timing - user checkpoints have been placed
// 0xc0: no lap timing - e.g. open config with no user checkpoints

// bits 0 and 1 (Timing & 0x03): number of checkpoints if lap timing is enabled

Track

The track's short name, e.g. BL1R or KY3X.

Weather

The session's weather, same as IS_STA#Weather.

Wind

The session's wind, same as IS_STA#Wind.

Flags

Bit flags from the HOSTF_ enumeration.

NumNodes

The number of nodes in the PTH file corresponding to the track. Note that only official configurations are supported.

Finish

The finish line's node index.

Split1

The split 1 node index.

Split2

The split 2 node index.

Split3

The split 3 node index.