/* audio_driver.h */
/* Jon Watte 19971223 */
/* Interface to drivers found in /dev/audio */
/* Devices found in /dev/audio/old follow a different API! */

/*
        Copyright 1999, Be Incorporated.   All Rights Reserved.
        This file may be used under the terms of the Be Sample Code License.
*/

#if !defined(_AUDIO_DRIVER_H)
#define _AUDIO_DRIVER_H

#if !defined(_SUPPORT_DEFS_H)
#include <SupportDefs.h>
#endif /* _SUPPORT_DEFS_H */
#if !defined(_DRIVERS_H)
#include <Drivers.h>
#endif /* _DRIVERS_H */

enum {
        /* arg = ptr to struct audio_format */
        B_AUDIO_GET_AUDIO_FORMAT = B_AUDIO_DRIVER_BASE,
        B_AUDIO_SET_AUDIO_FORMAT,
        /* arg = ptr to float[4] */
        B_AUDIO_GET_PREFERRED_SAMPLE_RATES,
        /* arg = ptr to struct audio_routing_cmd */
        B_ROUTING_GET_VALUES,
        B_ROUTING_SET_VALUES,
        /* arg = ptr to struct audio_routing_cmd */
        B_MIXER_GET_VALUES,
        B_MIXER_SET_VALUES,
        /* arg = ptr to struct audio_timing */
        B_AUDIO_GET_TIMING              /* used to be SV_SECRET_HANDSHAKE (10100) */
};

/* this is the definition of what the audio driver can do for you */
typedef struct audio_format {
    float       sample_rate;    /* ~4000 - ~48000, maybe more */
    int32       channels;       /* 1 or 2 */
    int32       format;         /* 0x11 (uchar), 0x2 (short) or 0x24 (float) */
    int32       big_endian;    /* 0 for little endian, 1 for big endian */
    size_t      buf_header;     /* typically 0 or 16 */
        size_t      play_buf_size;      /* size of playback buffer (latency) */
        size_t          rec_buf_size;   /* size of record buffer (latency) */
} audio_format;

/* when buffer header is in effect, this is what gets read before data */
typedef struct audio_buf_header {
    bigtime_t   capture_time;
    uint32      capture_size;
    float       sample_rate;
} audio_buf_header;

/* the mux devices use these records */
typedef struct audio_routing {
        int32 selector; /* for GET, these need to be filled in! */
        int32 value;
} audio_routing;

/* this is the argument for ioctl() */
typedef struct audio_routing_cmd {
        int32 count;
        audio_routing* data;
} audio_routing_cmd;

typedef struct {
    bigtime_t   wr_time;
        bigtime_t   rd_time;
        uint32      wr_skipped;
        uint32      rd_skipped;
        uint64      wr_total;
        uint64      rd_total;
        uint32      _reserved_[6];
} audio_timing;


enum {  /* selectors for routing */
        B_AUDIO_INPUT_SELECT,
        B_AUDIO_MIC_BOOST,
        B_AUDIO_MIDI_OUTPUT_TO_SYNTH,
        B_AUDIO_MIDI_INPUT_TO_SYNTH,
        B_AUDIO_MIDI_OUTPUT_TO_PORT,
        B_AUDIO_PCM_OUT_POST_3D,
        B_AUDIO_STEREO_ENHANCEMENT,
        B_AUDIO_3D_STEREO_ENHANCEMENT,
        B_AUDIO_BASS_BOOST,
        B_AUDIO_LOCAL_LOOPBACK,
        B_AUDIO_REMOTE_LOOPBACK,
        B_AUDIO_MONO_OUTPUT_FROM_MIC,
        B_AUDIO_ALTERNATE_MIC,
        B_AUDIO_ADC_DAC_LOOPBACK
};

enum {  /* input MUX source values */
        B_AUDIO_INPUT_DAC = 1,  /* (not in AC97) */
        B_AUDIO_INPUT_LINE_IN,
        B_AUDIO_INPUT_CD,
        B_AUDIO_INPUT_VIDEO,
        B_AUDIO_INPUT_AUX1,             /* synth */
        B_AUDIO_INPUT_AUX2,             /* (not in AC97) */
        B_AUDIO_INPUT_PHONE,
        B_AUDIO_INPUT_MIC,
        B_AUDIO_INPUT_MIX_OUT,  /* sum of all outputs */
        B_AUDIO_INPUT_MONO_OUT
};

/* the mixer devices use these records */
typedef struct audio_level {
        int32 selector; /* for GET, this still needs to be filled in! */
        uint32 flags;
        float value;    /* in dB */
} audio_level;

/* this is the arg to ioctl() */
typedef struct audio_level_cmd {
        int32 count;
        audio_level* data;
} audio_level_cmd;

/* bitmask for the flags */
#define B_AUDIO_LEVEL_MUTED 1   

enum {  /* selectors for levels */
  B_AUDIO_MIX_ADC_LEFT,
  B_AUDIO_MIX_ADC_RIGHT,
  B_AUDIO_MIX_DAC_LEFT,
  B_AUDIO_MIX_DAC_RIGHT,
  B_AUDIO_MIX_LINE_IN_LEFT,
  B_AUDIO_MIX_LINE_IN_RIGHT,
  B_AUDIO_MIX_CD_LEFT,
  B_AUDIO_MIX_CD_RIGHT,
  B_AUDIO_MIX_VIDEO_LEFT,
  B_AUDIO_MIX_VIDEO_RIGHT,
  B_AUDIO_MIX_SYNTH_LEFT,
  B_AUDIO_MIX_SYNTH_RIGHT,
  B_AUDIO_MIX_AUX_LEFT,                 /* (not in AC97) */
  B_AUDIO_MIX_AUX_RIGHT,                /* (not in AC97) */
  B_AUDIO_MIX_PC_BEEP,
  B_AUDIO_MIX_PHONE,
  B_AUDIO_MIX_MIC,
  B_AUDIO_MIX_LINE_OUT_LEFT,
  B_AUDIO_MIX_LINE_OUT_RIGHT,
  B_AUDIO_MIX_HEADPHONE_OUT_LEFT,
  B_AUDIO_MIX_HEADPHONE_OUT_RIGHT,
  B_AUDIO_MIX_MONO_OUT,
  B_AUDIO_MIX_LOOPBACK_LEVEL    /* (not in AC97) */
};

#endif /* _AUDIO_DRIVER_H */