Skip to content

Commit

Permalink
Update trace_notes.md
Browse files Browse the repository at this point in the history
  • Loading branch information
iceman1001 authored May 19, 2020
1 parent 0112346 commit 7e213fc
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions doc/trace_notes.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# Notes about the tracelog
<a id="top"></a>

## Table of Contents
* [Command](#trace-command)
Expand All @@ -7,12 +8,14 @@


## Trace command
^[Top](#top)

The `trace` command lists the data exchange by the proxmark3 and a tag or a reader in human readable form.

With `trace list` a table is shown which gives timing information, the src of the data bytes, the transmitted/received bytes itself, a check if the CRC was correct and some decoding of the command.

### Timing
^[Top](#top)

The Start and the End coloumn lists timestamps when the transmission of the shown data started (time of first bit) and when it ended (end of last modulation).

Expand All @@ -29,22 +32,28 @@ The unit for this time information depends on the protocol in use:
By specifing the option ```f``` (e.g. ```trace list 14a f```) the frame delay times are shown. (So you don't have to do the math by your own).

### Sources
^[Top](#top)

If the data is marked as a response the source is shown as Tag. Otherwise it is marked as Reader (Rdr).

### Data
^[Top](#top)

This coloumn show the raw bytes trasmitted over the air. With option ```c``` CRC bytes are marked in square brackets.

### CRC
^[Top](#top)

Marks if the transmitted CRC matches with the calculated CRC.

### Annotation
^[Top](#top)

Annotations provide a rough decoding of the transmitted data. For ISO14443A a more detailed decoding is available with Wireshark (s. next chapter)

## Tracelog format
^[Top](#top)

The binary format for the dynamic tracelog is as following.

```
Expand Down Expand Up @@ -73,6 +82,7 @@ typedef struct {
```

## Trace and Wireshark
^[Top](#top)

To get a more detailed explanation of the transmitted data for ISO14443A traces the output can be converted to a pcapng file to read it with [Wireshark](https://www.wireshark.org/).

Expand Down

0 comments on commit 7e213fc

Please sign in to comment.