drs-0x01 0.2.1

Easily communicate with Dongbu Robot servomotors Herkulex DRS 0101 and DRS 0201
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

[![Latest version](https://img.shields.io/crates/v/drs-0x01.svg)](https://crates.io/crates/drs-0x01)
[![Documentation](https://docs.rs/drs-0x01/badge.svg)](https://docs.rs/drs-0x01)
[![dependency status](https://deps.rs/repo/github/gbip/drs_0x01_driver/status.svg)](https://deps.rs/repo/github/gbip/drs_0x01_driver)

 # [Documentation](https://docs.rs/drs-0x01/0.1.6/drs_0x01/)
 
 This crate provides basic functionnality to communicate with Herkulex DRS (both 0101 and 0201)
 servomotors.
 It is heavily based on the documentation published by Dongbu Robot which is available
 [`here`](http://www.sgbotic.com/products/datasheets/robotics/herkulexeng.pdf).

# Examples

## Sending data
The best way to use this library to send data to the servomotor is to use the Servo struct.
For example, this how you can set a servomotor (id : 0x40) into continuous rotation.

```rust
extern crate drs_0x01;
use drs_0x01::Servo;

fn main() {
    let servo = Servo::new(0x40);
    let message = servo.set_speed(512);
    // ... send the message
}
```

There is also some more advanced type for user experienced with the herkulex datasheet.

This is how to do the same task (set a servomotor into continuous rotation), but using those types. Moreover we 
changed the color from blue to red to show how those types give more control.

```rust
extern crate drs_0x01;
use drs_0x01::*;
use drs_0x01::builder::MessageBuilder;

fn main() {
    let message = MessageBuilder::new().id(0x40).s_jog(/* Playtime : datasheet value : */ 60, 
                                                       JogMode::continuous{speed : 512}, 
                                                       JogColor::red, 
                                                       0x40)
                                                 .build();
    // ... send the message.
}


```

 To reboot all the servomotors you can use this message :

 ```rust
 extern crate drs_0x01;
 use drs_0x01::builder::MessageBuilder;
 
 fn main () {
    let message = MessageBuilder::new().id(0xFE).reboot().build();  // 0xFE is the broadcast ID
 }
 ```

 Here is how to enable torque for the servomotor labelled 35 :

 ```rust
 extern crate drs_0x01;
 use drs_0x01::builder::MessageBuilder;
 use drs_0x01::WritableRamAddr::TorqueControl;
 fn main() {
    let message = MessageBuilder::new_with_id(35).write_ram(TorqueControl(1)).build();
 }
 ```
 
 ## Receiving Data
 
 You can easily parse incoming bytes and transform them into [ACKPacket](https://docs.rs/drs-0x01/latest/drs_0x01/reader/struct.ACKPacket.html) 
 by using an [ACKReader](https://docs.rs/drs-0x01/latest/drs_0x01/reader/struct.ACKReader.html).
 
 See the `examples` folder for a code snippet.