wrapper-ble-esp32c3mini

À adapter : les badges crates.io / docs.rs / Downloads pointent vers le nom de crate wrapper-ble-esp32c3mini — ils n'afficheront des données réelles qu'une fois le crate publié sur crates.io. Le badge CI suppose un workflow GitHub Actions à .github/workflows/ci.yml et l'URL tonpseudo/wrapper-ble-esp32c3mini (à remplacer par ton vrai dépôt, comme pour repository dans Cargo.toml). Supprime les badges qui ne s'appliquent pas encore à ton projet.

Bibliothèque no_std qui encapsule l'initialisation d'un périphérique BLE (GATT peripheral) sur ESP32-C3, au-dessus de esp-radio, bt-hci et trouble-host.

Elle expose :

• BleController : alias vers le contrôleur HCI externe branché sur le BleConnector de esp-radio ;
• BleServer / DisplayService : un serveur GATT minimal avec deux caractéristiques (command en écriture, status en lecture/notification) ;
• BleSystem::init(...) : construit le contrôleur, la pile hôte trouble-host et le serveur GATT, et te rend runner, peripheral et server prêts à l'emploi ;
• run_ble_runner(...) : tâche à spawner qui fait tourner la boucle d'évènements de la pile hôte en continu.

Pourquoi ces versions précises de dépendances ?

Le Cargo.toml fige volontairement certaines versions plutôt que de prendre les toutes dernières de chaque crate, parce qu'elles ne sont pas toutes inter-compatibles au moment de la rédaction :

Si tu mets à jour une de ces dépendances, vérifie que les trois autres suivent : c'est le point qui casse le plus souvent une compilation dans cet écosystème.

Mémoire statique

trouble-host attend que ses ressources internes (HostResources) et la Stack elle-même vivent en 'static. BleSystem::init utilise donc static_cell::StaticCell pour les promouvoir, plutôt que de les garder en variables locales (qui ne compileraient pas avec les bornes de durée de vie attendues par Runner<'static, ...> / Peripheral<'static, ...>).

Durées de vie ('static)

Deux autres points de la signature sont volontairement fixés à 'static :

• BleServer<'static> — #[gatt_server] génère un type portant un paramètre de durée de vie (BleServer<'values>), hérité de la chaîne de caractères passée à PeripheralConfig::name. Comme on lui passe toujours un &'static str (le nom de l'appareil est un littéral), cette durée de vie vaut systématiquement 'static ici.
• bt_peripheral: esp_hal::peripherals::BT<'static> — esp_hal::peripherals::BT porte lui aussi un paramètre de durée de vie. Sans l'annoter explicitement dans la signature de BleSystem::init, le compilateur lui assigne une durée de vie anonyme propre à l'appel, incompatible avec BleController = ExternalController<BleConnector<'static>, 20>. Un Peripherals obtenu normalement via esp_hal::init(...) a des champs 'static par défaut, donc peripherals.BT s'y prête directement.

Exemple minimal

#![no_std]
#![no_main]

use wrapper_ble_esp32c3mini::{BleSystem, run_ble_runner};

#[esp_hal_embassy::main]
async fn main(spawner: embassy_executor::Spawner) {
    let peripherals = esp_hal::init(esp_hal::Config::default());

    let ble = BleSystem::init(peripherals.BT);
    spawner.spawn(ble_runner_task(ble.runner)).unwrap();

    // `ble.peripheral` : publicité BLE + acceptation de connexions
    // `ble.server`     : lecture/écriture des caractéristiques GATT
}

#[embassy_executor::task]
async fn ble_runner_task(
    runner: trouble_host::Runner<'static, wrapper_ble_esp32c3mini::BleController, trouble_host::DefaultPacketPool>,
) {
    run_ble_runner(runner).await;
}

La configuration de l'exécuteur Embassy (via esp-hal-embassy) reste à la charge du binaire final ; cette bibliothèque ne fait que fournir les futures et la structure GATT.

Licence

GPL-2.0-or-later — voir LICENSE.