ACUDPClient is a Python module that can be used to communicate with an Assetto Corsa dedicated server. Using its UDP protocol, real time telemetry, lap timings and session information is pushed to the client. A few actions, like sending/broadcasting messages are also available.
$ python setup.py installor
$ pip install acudpclient$ pytestThe client should be initialized like this:
from acudpclient.client import ACUDPClient
client = ACUDPClient(port=10000, remote_port=10001, host='127.0.0.1')
client.listen()remote_portandhostare used to send data to the AC serverlisten()will bind the server socket toport.
Server events can be handled directly or by event subscribers. In
both cases, get_next_event() method must be invoked in the
application's main loop.
When handling events directly, a call to get_next_event()
might return None, meaning there's no event available at that
point (the internal ACUDPClient socket is non-blocking).
When creating a subscriber class, specific events can be handled by creating
methods with the following naming scheme on_<event_type>(self, event)
where event_type is any of the types found in
acudpclient.protocol.ACUDPConst class (see Usage).
Events passed to on_<event_type>(self, event) are dictionaries containing
different keys depending on the event's type. Refer to acudpclient.client import ACUDPClient
to see which keys are available per event type.
Handle events directly: examples/print_events.py
Handle events with a subscriber: examples/print_events_pubsub.py
-
Start the ACServer with UDP active.
-
Capture the data using
tcpdump:
$ tcpdump -w /tmp/ac_out.pcap -s0 -i lo -n udp dst port 10000- Extract all udp payload from the pcap file:
$ tshark -r /tmp/ac_out.pcap -T fields -e data | tr -d '\n' | perl -pe 's/([0-9a-f]{2})/chr hex $1/gie' > /tmp/ac_out/tmp/ac_outcontains binary data sent by ACServer.