embassy-ttp223b 0.1.0

Driver async no_std pour le capteur tactile TTP223B via GPIO, basé sur Embassy.
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

[![crates.io](https://img.shields.io/crates/v/embassy-ttp223b.svg)](https://crates.io/crates/embassy-ttp223b)
[![docs.rs](https://docs.rs/embassy-ttp223b/badge.svg)](https://docs.rs/embassy-ttp223b)
[![License: GPL v3](https://img.shields.io/badge/License-GPL_v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)

# embassy-ttp223b

Driver asynchrone `no_std` pour le capteur tactile **TTP223B** via GPIO, testé sur la Pico 2 et Pico 2040.

Élimine les faux positifs par un filtrage temporel logiciel (**debounce 50 ms**) sans jamais bloquer le CPU, garantissant une efficacité énergétique maximale. Optimisé pour l'exécuteur `embassy`.

---

## Câblage exemple Testé 

### Waveshare Pico 2350B

| TTP223B | Pico 2350B | Description |
|---------|-----------|-------------|
| GND     | GND       | Ground (masse commune) |
| VCC     | 3V3       | Alimentation 3.3V |
| OUT     | GPIO16    | Signal de sortie tactile |

**Schéma de connexion :**
```
TTP223B     Pico 2350B
  GND  -------> GND (pin 38 ou autre GND)
  VCC  -------> 3V3 (pin 36)
  OUT  -------> GPIO16 (pin 21)
```

---

## Utilisation

```toml
[dependencies]
embassy-ttp223b = "0.1.0"
```

```rust
use embassy_ttp223b::{Ttp223, TouchState};

let mut touch = Ttp223::new(pin);

loop {
    match touch.wait_for_change().await {
        Ok(TouchState::Pressed)  => { /* réaction au toucher */ }
        Ok(TouchState::Released) => { /* relâchement */ }
        Err(_) => { /* gestion d'erreur GPIO */ }
    }
}
```

---

## Exemple avec affichage SSD1306

```rust
use embassy_ttp223b::{Ttp223, TouchState};
use embassy_ssd1306::Ssd1306;

let mut oled  = Ssd1306::new(i2c, 0x3C);
let mut touch = Ttp223::new(pin);

oled.init().await.unwrap();

loop {
    match touch.wait_for_change().await {
        Ok(TouchState::Pressed) => {
            oled.clear();
            oled.draw_str(10, 3, b"TOUCHE!");
            oled.flush().await.unwrap();
        }
        Ok(TouchState::Released) => {
            oled.clear();
            oled.draw_str(10, 3, b"RELACHE");
            oled.flush().await.unwrap();
        }
        Err(_) => {}
    }
}
```

---

## Exemple Pico 2040

```rust
let mut touch = Ttp223::new(p.PIN_15.into());

loop {
    if let Ok(state) = touch.wait_for_change().await {
        match state {
            TouchState::Pressed  => led.set_high(),
            TouchState::Released => led.set_low(),
        }
    }
}
```

---

## Timing personnalisé

```rust
use embassy_ttp223b::Ttp223;

// debounce 80 ms, polling toutes les 5 ms
let mut touch = Ttp223::new_with_timing(pin, 80, 5);
```

---

## Fonctionnalités

- `wait_for_change` : attend un changement d'état confirmé (debounce asynchrone)
- `get_state` : retourne l'état mémorisé sans attendre
- `is_pressed`:  raccourci booléen pour l'état pressé
- `new_with_timing` durées de debounce et de polling configurables
- `release` : libère le pin GPIO et retourne la ressource matérielle
- Zéro allocation, zéro `unsafe`, zéro blocage CPU

---

# 📋 Historique et Évolutions (Changelog)

**Version : v0.1.0**

- Implémentation initiale du driver TTP223B asynchrone
- Debounce logiciel 50 ms par défaut
- API `wait_for_change`, `get_state`, `is_pressed`, `release`
- Timing configurable via `new_with_timing`

Pour consulter le détail de toutes les versions, veuillez vous référer au fichier :
👉 [CHANGELOG.md](CHANGELOG.md)

---

## Licence

GPL-3.0-or-later — Copyright (C) 2026 Jorge Andre Castro