midi.h

Aller à la documentation de ce fichier.

 
#ifndef MIDI_H
#define MIDI_H
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
/* ====================================================================== */
/*                        CONFIGURATION GLOBALE                           */
/* ====================================================================== */
 
#ifndef MIDI_MB_DROP_OLDEST
#define MIDI_MB_DROP_OLDEST  0
#endif
 
#ifndef MIDI_RT_MICROWAIT_US
#define MIDI_RT_MICROWAIT_US 50
#endif
 
#ifndef MIDI_USB_CABLE
#define MIDI_USB_CABLE  0u
#endif
 
/* ====================================================================== */
/*                              TYPES ET STRUCTURES                       */
/* ====================================================================== */
 
typedef enum {
  MIDI_DEST_NONE = 0,  
  MIDI_DEST_UART,      
  MIDI_DEST_USB,       
  MIDI_DEST_BOTH       
} midi_dest_t;
 
typedef struct {
  volatile uint32_t tx_sent_immediate;      
  volatile uint32_t tx_sent_batched;        
  volatile uint32_t rt_f8_drops;            
  volatile uint32_t rt_f8_burst_sent;       
  volatile uint32_t rt_other_enq_fallback;  
  volatile uint32_t tx_mb_drops;            
  volatile uint32_t usb_not_ready_drops;    
} midi_tx_stats_t;
 
extern midi_tx_stats_t midi_tx_stats;
 
/* ====================================================================== */
/*                              INITIALISATION                            */
/* ====================================================================== */
 
void midi_init(void);
 
/* ====================================================================== */
/*                        COMMANDES “CHANNEL VOICE”                       */
/* ====================================================================== */
 
void midi_note_on(midi_dest_t dest, uint8_t ch, uint8_t note, uint8_t vel);
 
void midi_note_off(midi_dest_t dest, uint8_t ch, uint8_t note, uint8_t vel);
 
void midi_poly_aftertouch(midi_dest_t dest, uint8_t ch, uint8_t note, uint8_t pressure);
 
void midi_cc(midi_dest_t dest, uint8_t ch, uint8_t cc, uint8_t val);
 
void midi_program_change(midi_dest_t dest, uint8_t ch, uint8_t program);
 
void midi_channel_pressure(midi_dest_t dest, uint8_t ch, uint8_t pressure);
 
void midi_pitchbend(midi_dest_t dest, uint8_t ch, int16_t value14b);
 
/* ====================================================================== */
/*                      COMMANDES “SYSTEM COMMON”                         */
/* ====================================================================== */
 
void midi_mtc_quarter_frame(midi_dest_t dest, uint8_t qf);
void midi_song_position(midi_dest_t dest, uint16_t pos14);
void midi_song_select(midi_dest_t dest, uint8_t song);
void midi_tune_request(midi_dest_t dest);
 
/* ====================================================================== */
/*                      COMMANDES “SYSTEM REALTIME”                       */
/* ====================================================================== */
 
void midi_clock(midi_dest_t dest);
void midi_start(midi_dest_t dest);
void midi_continue(midi_dest_t dest);
void midi_stop(midi_dest_t dest);
void midi_active_sensing(midi_dest_t dest);
void midi_system_reset(midi_dest_t dest);
 
/* ====================================================================== */
/*                       MESSAGES DE MODE DE CANAL                        */
/* ====================================================================== */
 
void midi_all_sound_off(midi_dest_t dest, uint8_t ch);
void midi_reset_all_controllers(midi_dest_t dest, uint8_t ch);
void midi_local_control(midi_dest_t dest, uint8_t ch, bool on);
void midi_all_notes_off(midi_dest_t dest, uint8_t ch);
void midi_omni_mode_off(midi_dest_t dest, uint8_t ch);
void midi_omni_mode_on(midi_dest_t dest, uint8_t ch);
void midi_mono_mode_on(midi_dest_t dest, uint8_t ch, uint8_t num_channels);
void midi_poly_mode_on(midi_dest_t dest, uint8_t ch);
 
/* ====================================================================== */
/*                              OUTILS                                    */
/* ====================================================================== */
 
void midi_stats_reset(void);
 
uint16_t midi_usb_queue_high_watermark(void);
 
#endif /* MIDI_H */