ui_backend.h

Aller à la documentation de ce fichier.

 
#ifndef BRICK_UI_UI_BACKEND_H
#define BRICK_UI_UI_BACKEND_H
 
#include <stdint.h>
#include <stdbool.h>
#include "ch.h"            /* systime_t */
#include "ui_input.h"      /* ui_input_event_t */
#include "ui_overlay.h"    /* ui_custom_mode_t, ui_overlay_id_t */
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================
 * Espaces de destination (bits hauts de l’identifiant)
 * ============================================================ */
 
#define UI_DEST_MASK   0xE000U  
#define UI_DEST_CART   0x0000U  
#define UI_DEST_UI     0x8000U  
#define UI_DEST_MIDI   0x4000U  
#define UI_DEST_ID(x)  ((x) & 0x1FFFU) 
/* ============================================================
 * Contexte mode UI (état centralisé partagé)
 * ============================================================ */
 
typedef enum {
    UI_MUTE_STATE_OFF = 0,   
    UI_MUTE_STATE_QUICK,     
    UI_MUTE_STATE_PMUTE      
} ui_mute_state_t;
 
typedef struct {
    bool playing;            
    bool recording;          
} ui_transport_state_t;
 
typedef struct {
    uint8_t  page_index;                     
    uint8_t  page_count;                     
    uint16_t held_mask;                      
    bool     held_flags[16];                 
    systime_t hold_start[16];                
    uint8_t  track_index;                    
    uint8_t  track_count;                    
} ui_seq_runtime_t;
 
typedef struct {
    bool active;            
    bool shift_latched;     
} ui_track_state_t;
 
typedef struct {
    bool  active;            
    bool  overlay_visible;   
    int8_t octave;           
    bool  arp_submenu_active; // --- ARP: persistance sous-menu ---
} ui_keyboard_state_t;
 
typedef struct {
    ui_custom_mode_t    custom_mode;      
    ui_overlay_id_t     overlay_id;       
    uint8_t             overlay_submode;  
    bool                overlay_active;   
    ui_mute_state_t     mute_state;       
    bool                mute_plus_down;   
    bool                mute_shift_latched; 
    ui_transport_state_t transport;       
    ui_seq_runtime_t     seq;             
    ui_keyboard_state_t  keyboard;        
    ui_track_state_t     track;           
} ui_mode_context_t;
 
typedef ui_mode_context_t ui_context_t;
 
typedef enum {
    SEQ_MODE_DEFAULT = 0,   
    SEQ_MODE_PMUTE,         
    SEQ_MODE_TRACK          
} seq_mode_t;
 
/* ============================================================
 * API publique
 * ============================================================ */
 
void ui_backend_init_runtime(void);
 
const ui_mode_context_t* ui_backend_get_mode_context(void);
 
const char* ui_backend_get_mode_label(void);
 
void ui_mode_reset_context(ui_context_t *ctx, seq_mode_t next_mode);
 
void ui_backend_process_input(const ui_input_event_t* evt);
 
void ui_backend_param_changed(uint16_t id, uint8_t val, bool bitwise, uint8_t mask);
 
uint8_t ui_backend_shadow_get(uint16_t id);
bool ui_backend_shadow_try_get(uint16_t id, uint8_t *out_val); // --- FIX: détecter shadow non initialisé ---
 
void ui_backend_shadow_set(uint16_t id, uint8_t val);
 
/* ========================================================================== */
/* API Track Select / synchronisation LED                                     */
/* ========================================================================== */
 
void ui_track_mode_enter(void);
 
void ui_track_mode_exit(void);
 
void ui_track_select_from_bs(uint8_t bs_index);
 
void ui_led_refresh_state_on_mode_change(seq_mode_t new_mode);
 
#ifdef __cplusplus
}
#endif
 
#endif /* BRICK_UI_UI_BACKEND_H */