tinytones 0.1.0

A no_std crate for playing musical tones in embedded environments
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

# tinytones

**tinytones** is a `#![no_std]` Rust crate for defining and playing musical tones and melodies in embedded systems. It provides:

- Enum-based musical pitches from C0 to B8
- Standard and dotted note durations
- Frequency access as `u32` or `f64`
- Iterator for (pitch, duration) tone playback

## Predefined tones in the crate

The crate includes a few predefined melodies for convenience:

```rust
use tinytones::{Tone, songs::happy_birthday};


let song = Tone::new(happy_birthday::TEMPO, happy_birthday::MELODY);
for (pitch, duration_ms) in song.iter() {
    // Send `pitch.freq_u32()` to a PWM
    // Wait for `duration_ms` using a delay
}
```


## Definiting your own Tone
You can define your own melody using the provided `Pitch` and `Duration` enums:

```rust
use tinytones::{
    note::{Duration::*, Pitch::*},
    Tone, Melody,
};

let melody = Melody(&[
    (C4, Quarter),
    (D4, Quarter),
    (E4, Half),
]);

let tempo = 120;

let tone = Tone::new(tempo, melody);

for (pitch, duration_ms) in tone.iter() {
    // Send `pitch.freq_u32()` to a PWM
    // Wait for `duration_ms` using a delay
}
```