Pairing.h

Aller à la documentation de ce fichier.

/*
 * Pairing.c
 * Gestion de l'appairage Door / Bell
 * - Envoi automatique des trames P0 / P1 / A0 / A1 (non bloquant)
 * - Reset d'appairage par appui long (Door : swRing, Bell : trois boutons)
 * - Sauvegarde / lecture du numéro appairé en Flash (Harmony NVM)
 *
 * MCU      : PIC32MX130F064B
 * Outils   : XC32 v2.50, Harmony v2_06
 * Auteurs  : Projet PortierWireless LMS
 * ---------------------------------------------------------------------------
 
#ifndef PAIRING_H // Protection contre l'inclusion multiple du fichier d'en-tête
#define PAIRING_H
 
#include <stdint.h> // Inclusion des définitions de types entiers standard
#include <stdbool.h> // Inclusion du type booléen standard
/* === Constantes  === */
#define NVM_SERIAL_BLOCK     0 // Bloc mémoire NVM utilisé pour le numéro de série
#define LONG_PRESS_TICKS     300 // Nombre de ticks pour un appui long
 
/* === Déclarations externes === */
extern S_SwitchDescriptor swRing;         // Descripteur du bouton Ring
extern S_SwitchDescriptor swEnter;        // Descripteur du bouton Enter
extern S_SwitchDescriptor swWait;         // Descripteur du bouton Wait
extern S_SwitchDescriptor swBusy;         // Descripteur du bouton Busy
extern uint32_t appPairedSerial;          // Numéro de série appairé courant
 
/* === Fonctions publiques === */
 
/* Accès au numéro de série appairé */
void     LoadPairedSerialAndApply(void);   // Charge le numéro appairé depuis la Flash et l'applique en RAM
void     SavePairedSerialToFlash(void);    // Sauvegarde le numéro appairé courant en mémoire non-volatile
uint32_t GetActifSerialNbr(void);          // Retourne le numéro de série appairé actif
void     ResetSerialList(void);            // Réinitialise la liste des numéros appairés
 
/* Automate d'appairage complet */
uint32_t PairingManagement(void);          // Gère l'automate d'appairage, retourne le numéro appairé (0 si non appairé)
 
/* Reset d'appairage (appui long) */
void PairingReset_DoorTask(void);          // Gestion du reset d'appairage côté Door
void PairingReset_BellTask(void);          // Gestion du reset d'appairage côté Bell
 
/* Statut global du pairing */
bool Serial_IsPairingRunning(void);        // Retourne true si l'appairage est en cours
 
/* Filtrage & envoi de trames RF */
bool Serial_CheckIfFromPaired(uint8_t *msg); // Vérifie si la trame reçue provient du numéro appairé
void RF_SendWithSerial(uint8_t *payload);    // Envoie une trame RF avec le numéro de série appairé
 
/* Visuel / sonore */
void ShowPairingSuccess(void);             // Indique le succès de l'appairage (bip + LED verte)
 
/* Tests Flash (optionnel) */
void TestFlashWriteRead(void);             // Teste l'écriture/lecture du numéro appairé en Flash
 
/* === Fonctions internes (statics, à usage privé) === */
static void SaveSerialHarmony(uint32_t serial);      // Sauvegarde un numéro de série en Flash (interne)
static uint32_t LoadSerialHarmony(void);             // Charge un numéro de série depuis la Flash (interne)
static void PairingReset_DoReset(void);              // Effectue le reset d'appairage (interne)
static void RF_SendP0(void);                         // Envoie une trame P0 (interne)
static void RF_SendP1(void);                         // Envoie une trame P1 (interne)
static void RF_SendA0(uint32_t serial);              // Envoie une trame A0 avec numéro de série (interne)
static void RF_SendA1(uint32_t serial);              // Envoie une trame A1 avec numéro de série (interne)
static void HandlePairingMessage(uint8_t* msg);      // Traite un message d'appairage (interne)
 
#endif /* PAIRING_H */ // Fin de la protection contre l'inclusion multiple