gt06 0.1.0

Parser and stream decoder for the GT06 GPS tracker protocol
Documentation 
1
2
3
4
5
6
7
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
39
40

# gt06 (WIP)

This is a port of my JS-based gt06 parser to Rust, with significant AI use. It's more a
learning project in my Rust journey than it is a production-ready library — though the
original JS-based parser has been running in prod for a while now.

I'll be continuing work on this library as time allows, and will mark `1.0` when I feel
it's ready for general use.

## What it does

Parses the GT06 GPS tracker protocol: login, location (standard and extended), status,
and alarm messages, sent over a raw TCP connection.

- [`Decoder`] reassembles messages out of a raw byte stream, buffering partial reads.
- [`parse_packet`] parses a single, already-framed packet.
- [`build_ack`] builds the acknowledgement packet required for login/status messages.

## Example

```rust
use gt06::{build_ack, Decoder, Message};

let mut decoder = Decoder::new();

for result in decoder.push(&bytes_from_socket) {
    match result {
        Ok(Message::Login(login)) => {
            let ack = build_ack(0x01, login.serial_number);
            socket.write_all(&ack)?;
        }
        Ok(message) => println!("{message:?}"),
        Err(err) => eprintln!("bad packet: {err}"),
    }
}
```

## License

MIT