Système de mise à jour OTA

Ce document décrit le système de mise à jour par liaison radio (OTA) utilisé par la télécommande sans fil Research And Desire Wireless Remote (RADR), y compris la chaîne de mise à jour, le flux de la machine à états et les composants mis à jour.

Aperçu

RADR utilise un système de mise à jour OTA en deux parties :

La mise à jour du système de fichiers est particulièrement importante pour la prise en charge des appareils : elle contient le registre Buttplug.io qui associe les UUID de service Bluetooth aux configurations des appareils. Cela permet d'ajouter la prise en charge de nouveaux appareils sans modifier le micrologiciel.

Architecture des mises à jour OTA

Serveur de mise à jour

Les mises à jour sont fournies par Supabase Storage. L'URL du serveur est définie dans platformio.ini :

UPDATE_SERVER_URL="https://acjajruwevyyatztbkdf.supabase.co/storage/v1/object/public/radr-firmware"

Les URL des binaires suivent le modèle :

• Micrologiciel : {UPDATE_SERVER_URL}/master/firmware.bin
• Système de fichiers : {UPDATE_SERVER_URL}/master/littlefs.bin

Flux de la machine à états

Les mises à jour sont gérées par la machine à états RADR. Le flux de mise à jour est déclenché depuis le menu Settings.

Transitions d'État

Ce qui est mis à jour

Mise à jour du micrologiciel

La mise à jour du micrologiciel remplace le binaire de l'application ESP32. Cela comprend :

• Logique d'application de base
• Interface utilisateur et code d'affichage
• Pile Bluetooth et communication avec les appareils
• Machine à états et navigation
• Gestion des entrées (encodeurs, boutons, bumpers)

Mise en œuvre : updateSoftwareTask() dans src/tasks/update.cpp

void updateSoftwareTask(void *pvParameters) {
    // Uses ESP32 HTTPUpdate library
    httpUpdate.setRebootOnUpdate(true);  // Auto-reboot on success

    String url = String(UPDATE_SERVER_URL) + "/master/firmware.bin";
    httpUpdate.update(client, url);
}

La mise à jour du micrologiciel redémarre automatiquement l'appareil en cas de succès.

Mise à jour du système de fichiers

La mise à jour du système de fichiers remplace la partition LittleFS, qui contient :

Mise en œuvre : updateFilesystemTask() dans src/tasks/update.cpp

void updateFilesystemTask(void *pvParameters) {
    LittleFS.end();  // Unmount before update

    httpUpdate.setRebootOnUpdate(false);  // Don't reboot yet

    String url = String(UPDATE_SERVER_URL) + "/master/littlefs.bin";
    httpUpdate.updateSpiffs(client, url);

    LittleFS.begin();  // Remount after update
}

Chaîne de mise à jour du registre

Lorsque le système de fichiers est mis à jour, le registre des appareils Buttplug.io est actualisé :

Le registre est chargé au démarrage par initRegistry() dans src/devices/registry.cpp :

1. Les appareils codés en dur sont enregistrés en premier (par exemple, OSSM)
2. /registry.json est lu depuis LittleFS
3. Chaque UUID de service est associé à un ButtplugIODeviceFactory
4. Les spécifications du protocole sont chargées à la demande lorsque les appareils sont découverts

Disponibilité des mises à jour

La disponibilité des mises à jour est déterminée par les fonctions de garde dans src/state/guards.hpp :

bool hasFilesystemUpdate(const State &state, const Event &event) {
    return isFilesystemUpdateAvailable;
}

bool hasSoftwareUpdate(const State &state, const Event &event) {
    return isSoftwareUpdateAvailable;
}

Ces drapeaux sont contrôlés par :

Fichiers sources clés

Notes de développement

Forcer les mises à jour

Pour le développement et les tests, utilisez l'indicateur de compilation FORCE_UPDATE :

build_flags =
    -D FORCE_UPDATE

Cela définit isSoftwareUpdateAvailable et isFilesystemUpdateAvailable sur true.

Mises à jour locales du système de fichiers

Lors du développement local, utilisez la fonctionnalité « Upload Filesystem » de PlatformIO :

pio run --target uploadfs

Cela téléverse le contenu du répertoire data/ sur la partition LittleFS.

Documentation connexe