OutGauge
OutGauge is a protocol, similar to InSim, designed for use in car dashboards. The protocol allows you to receive UDP packets broadcast by LFS, which can be enabled in the LFS\cfg.txt file. The official documentation for these packets can be found the in the game's doc\InSim.txt file.
Although the packets can only be sent by LFS using UDP, each packet provides a timestamp in order for you to verify the order. It must be noted as well that OutGauge packets will only be sent if you are viewing the car from the cockpit view! Note the ID attribute of OutGauge packets is only present if set in the cfg.txt file.
Configuration
To instruct LFS to send OutGauge packets, update this section of your LFS\cfg.txt file:
// OutGauge Mode 0 :0-off 1-driving 2-driving+replay // OutGauge Delay 1 :minimum delay between packets (100ths of a sec) // OutGauge IP 0.0.0.0 :IP address to send the UDP packet // OutGauge Port 0 :IP port // OutGauge ID 0 :if not zero, adds an identifier to the packet
Code example
Here is an example of receiving OutGauge packets using Python.
import socket
import struct
# Create UDP socket.
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
# Bind to LFS.
sock.bind(('127.0.0.1', 30000))
while True:
# Receive data.
data = sock.recv(256)
if not data:
break # Lost connection
# Unpack the data.
outgauge_pack = struct.unpack('I3sxH2B7f2I3f15sx15sx', data)
time = outgauge_pack[0]
car = outgauge_pack[1]
flags = outgauge_pack[2]
gear = outgauge_pack[3]
speed = outgauge_pack[5]
rpm = outgauge_pack[6]
turbo = outgauge_pack[7]
engtemp = outgauge_pack[8]
fuel = outgauge_pack[9]
oilpressure = outgauge_pack[10]
oiltemp = outgauge_pack[11]
dashlights = outgauge_pack[12]
showlights = outgauge_pack[13]
throttle = outgauge_pack[14]
brake = outgauge_pack[15]
clutch = outgauge_pack[16]
display1 = outgauge_pack[17]
display2 = outgauge_pack[18]
# Release the socket.
sock.close()
