m5dial-bsp 0.3.0

Board support package for the M5 Dial.
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

# M5 Dial Board Support Package (BSP)

This crates is a Board support package for the [M5 Dial](https://shop.m5stack.com/products/m5stack-dial-esp32-s3-smart-rotary-knob-w-1-28-round-touch-screen).

### [API Documenation](https://antoinezen.github.io/m5dial-bsp)

Feature list/roadmap:

 - [X] Screen driver (GC9A01)
 - [X] Rotary encoder
 - [X] Button
 - [X] Power management (Shutdown)
 - [X] Touch-screen (FT3267)
 - [ ] Buzzer
 - [ ] Real-time clock (BM8563)
 - [ ] Port A (I2C)
 - [ ] Port B

## How to use

First generate a base project using [esp-generate](https://github.com/esp-rs/esp-generate) or [esp-idf-template](https://github.com/esp-rs/esp-idf-template) as described in they respective documentations.
Then, add this crate to your `Cargo.toml`:

```toml
[dependencies]
....
rotary-encoder-hal = "0.6.0"
....
```

In your main function then initialize this hall and use it:

```rust
let config = esp_hal::Config::default().with_cpu_clock(CpuClock::max());
let peripherals = esp_hal::init(config);

let mut board = m5dial::init(peripherals);
....
```

For more information, please refer to the [API Documenation](https://antoinezen.github.io/m5dial-bsp).

## Examples

See [screen_counter.rs](examples/screen_counter.rs)

## License

MIT license ([LICENSE](LICENSE) or <http://opensource.org/licenses/MIT>)

# Contriutions

... are welcome !

# Credit

This crates rely on many crates of the [embedded Rust working group](https://github.com/rust-embedded/wg), [ESP support crates](https://github.com/esp-rs) from Expressif, [embedded-graphics](https://github.com/embedded-graphics) and device drivers such as :

 - [rotary-encoder-hal](https://crates.io/crates/rotary-encoder-hal)
 - [gc9c01 display driver](https://crates.io/crates/gc9a01-rs)