TelemetryReader

KO | EN

gitlite — search

#hacktoberfest #react #ai #go #android #machine-learning #rust #deep-learning #linux #awesome #cli #vue #pytorch #mcp

TelemetryReader

(★ 8)

Read, process, use, transmit Sim-Racing Telemetry

TelemetryReader 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Telemetry Reader
The all in one solution for reading, processing and transmitting telemetry for Sim-Racing.

## Current status
---
The library is usable, but still in an wip-state.
The UI demonstration shows a very basic usage of the library.
---

## Games
The games module includes necessary information about the games supported.
This includes some declared identifiers for every game and their known process-names.
Also included are structures for most games, which are used to convert raw byte data into
a easy-to-use format.

### Currently supported games
To keep focus on the proper implementation and making it easier to add new games,
the list of games supported from the beginning is rather short:

```
- Assetto Corsa (including Competezione | based on shared memory) 
- RaceRoom Racing Experience
- Project Cars 2
```

Many additional games are already prepared and will be added step by step.
If you are willing to help or want to have your game added feel free to contact me.

## Library
The library module is the main element of this project and includes everything to read,
process and send the telemetry data. It is possible to extend or modify the behaviour using this
module and exchange the different parts to adapt your personal project specifications.

### 1. Recognize games

### 2. Read data

### 3. Process data

### 4. Telemetry Protocol
The included protocol is aimed to ease the access to telemetry values without having
to implement the data conversion yourself. It uses the game specific reader implementations
and a data processor to convert the data into a game independent protocol structure.

The whole protocol consists of two main functions.
* Conversion of game specific structures into ID-based value datapool
* Package selected values for transmit

#### 4.1. Value IDs
Every defined value has a unique 16-bit (2-byte) unsigned integer als identifier.
As 16-bit enable 65536 different values, this should be more than enough to include 
all available information from many different racing simulations.

__Comment__: The decision fell to 16-bit to gain enough possible IDs, but still save some amount
of data, especially when transmitting it over network. The ID precedes every value, so if a single 
package includes 100 values, one package saves 200 byte of unused data. Because the protocol is aimed
for real-time telemetry this can make a difference, for example when using UDP as connection layer.

##### 4.1.1 ID Ranges
The IDs are divided into five different main categories:

```
- Connection (0 - 511)
- Car (512 - 10399)
- Driver (10400 - 13471)
- Session (13472 - 16383)
- Opponents (16384 - 65535)
```

The Connection category is the smallest (512 values), as it is mainly to add non-game values to the protocol, 
like packet number or similar control values.
The most important and second largest category (9887 values) is for anything 
related to the car of the actual driver/player.
Data about the driver himself, which includes timing and control input is almost the same size
than the session category (both inlcude around 3000 possible IDs).
The opponents category is based on the assumption that the maximum number of cars is 128.
Therefore for every single opponent there are 384 different IDs to use for values regarding a single opponent.

##### 4.1.2 Value classes
The categories car, driver and session are divided into some classes, which
might have additional sub-classes.
These are primarily aimed for better structuring and not essential.
The protocol-datapool uses interfaces based on this structure to reflect classes
and sub-classes for easy access without having to know specific value IDs.

##### 4.2. Protocol Header
Every assembled and sent package starts with a predefined header to be able to properly identify it
when receiving. This also enables to more easily distinguish between packages generated by this library and other
packages from different projects in one receiver system.

##### 4.2.1. Header definition
Current version 1.0:
```
TLMTRY
$ProtocolVersion$ (UInt8)
$PackageCounter$ (UInt32)
$ValueCount$ (UInt16)
END
```
Where $XXX$ values are dynamic and everything else is static.

## Application
TODO

## License 
Apache 2.0

TelemetryReader

TelemetryReader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

TelemetryReader

TelemetryReader 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README