README.md 1.04 KB
Newer Older
Andreas Schmidt's avatar
Andreas Schmidt committed
1
# X-Lap: A Systems Approach for Cross-Layer Profiling and Latency Analysis for Cyber-Physical Networks
2

3
4
5
6
7
## Conventions

`_T`: Timestamp (us precision)
`_C`: Clockstamp
`_D`: Duration (us precision)
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

## How to use X-lap?

### Step 0: Define your relevant timestamps across a packet trace.
Define time- and cyclestamps:

* Where data enters the sender app.
* Where data leaves the sender app.
* Where data enters the receiver app.
* Where data leaves the receiver app.
* Define additional cyclestamps wherever appropriate.
* Define interesting durations inside xlap.yml.

### Step 1: Instrument your code and generate traces
* Define a Sender and Receiver Application (send arbitrary data around).
* Initialize the xlap facility.
* Add stamping code where-ever appropriate.
* There are different mechanisms for adding timestamps.


### Step 2: Use the provided xlap analysis tools
* Write your xlap.yml file as follows:

```yaml
data_files: ads
stamps: ads
durations: asd
```

* Run one of the following analyses on the data set:
    * Jitter Analysis (`jitter`)