ev3-dc 0.1.0

Low level EV3 direct command library
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# EV3-DC
[WIP] Low-level EV3 direct command library. Designed to be able to use safely

## Features
 - Allocate global and local memory
 - Packet generation from bytecodes
 - Direct reply basic parser
 - Utility library for Run-Length-Encoding, packets merging, bytecode builder
More documentation is available in docs
```bash
cargo doc
```

## Bytecode documentation
LEGO Mindstorms EV3 Firmware Developer Kit [[Link]](https://www.lego.com/cdn/cs/set/assets/blt77bd61c3ac436ea3/LEGO_MINDSTORMS_EV3_Firmware_Developer_Kit.pdf)

## Example
This example turn on motor on port A & B with 50% power clockwise
```rust
use ev3_dc::{ Command, encode, Encoding, PORT };
use ev3_dc::utils::ChainByte;
use ev3_dc::parser::Reply;

// Create new packet. Packet can contains many OpCodes
let mut cmd = Command::new();
// Chainable vector operations
let mut byte = ChainByte::new();
byte.push(0xA4) // opOutput_Power
    .add(encode(LC0(0)).unwrap()) // Layer
    .add(encode(LC0(PORT.A + PORT.B)).unwrap()) // Port
    .add(encode(LC1(50)).unwrap()) // Power
    .push(0xA6) // opOutput_Power
    .add(encode(LC0(0)).unwrap()) // Layer
    .add(encode(LC0(PORT.A + PORT.B)).unwrap()); // Port
let mut buf = [0_u8; 5 + cmd.reserved_bytes()]; // Create reply buffer (SIZE SHOULD BE ATLEAST 5 + reserved_bytes)
println!("SENT: {:?}", cmd.gen_bytes()); // Generate direct command packet
not_real_function::read(&mut buf);
let rep = Reply::parse(&buf); // Parse direct reply
println!("RECV: {:?} | SIZE: {}, ID: {}, ERROR: {}, MEMORY: {}", buf, rep.length(), rep.id(), rep.error(), rep.memory());
```

## Binary
All the example program is written for USB communication. Add hidapi to cargo
```bash
cargo add hidapi
```
 - `examples/image.rs` Display 178x128 [PBM](https://en.wikipedia.org/wiki/Netpbm#PBM_example) image on EV3 screen
    ```bash
    cargo run --example image example.pbm
    ```
 - `examples/info.rs` Show information about PBrick (w/ code comments)
    ```bash
    cargo run --example info 
    ```