m5dial-bsp 0.7.3

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
61
62
63
64

# 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 Documentation](https://antoinezen.codeberg.page/m5dial-bsp)

Feature list/roadmap:

 - [X] Screen driver (GC9A01)
 - [X] Rotary encoder
 - [X] Button
 - [X] Power management (Shutdown)
 - [X] Touch-screen (FT3267)
 - [X] Buzzer
 - [X] Real-time clock (BM8563)
 - [X] Port A (I2C)
 - [X] Port B
 - [X] Upgrade to be compatible to esp-hal v1.0.0

## How to use

First generate a base project using [esp-generate](https://github.com/esp-rs/esp-generate)  as described in its documentation.
Then, run `cargo add m5dial-bsp`.

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

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

let mut display = m5dial_bsp::get_screen!(peripherals);
let mut encoder = m5dial_bsp::get_encoder!(peripherals);

let mut board = m5dial_bsp::board_init!(peripherals);

```

For more information, please refer to the [API Documentation](https://antoinezen.codeberg.page/m5dial-bsp). (Don't refers to the doc on docs.rs, as they fail to compile due to the lack of ESP specific toolchain.)

## Examples

Examples are located in the `examples` sub-project. Here is an index:

 - [screen_counter.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/screen_counter.rs): Demonstrate the rotary encoder usage.
 - [screen_counter_irq.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/screen_counter_irq.rs):  Demonstrate the rotary encoder usage, using interrupts.
 - [touch.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/touch.rs): Demonstrate the touchscreen.
 - [clock.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/clock.rs): A clock application that demonstrate the RTC usage.
 - [backlight.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/clock.rs): Demonstrate the back-light control
 - [logo.rs](https://codeberg.org/antoinezen/m5dial-bsp/src/branch/main/examples/src/bin/clock.rs): Display a rotating Rust logo.

## License

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

# Contributions

... 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)