[Update pjsip/third_party/bdsound/include/bdimad.h Adrian Georgescu **20210216144021 Ignore-this: e664fa411307fbd6dcf857d2ea53a681 ] { hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 10 - * bdSound IMproved Audio Device is a multiplatform audio interface + * bdSound IMproved Audio Device is a multi-platform audio interface hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 40 - * -# Request for bdIMADpj library to - * bdSound: - * bdSound will provide instruction to integrate the library depending on - * the platform / O.S. / toolchain; - * -# Add the bdimad_dev.c file to - * pjmedia/src/pjmedia-audiodev folder; - * -# Enable the bdIMAD audio device defining the periferal in the - * pj/config_site.h and disabling all other devices: - * 
- *       #define PJMEDIA_AUDIO_DEV_HAS_BDIMAD 1
- *
+ * -# Download trial bdIMADpj library from + * bdSound; + * -# Follow the integration instructions at + * bdSound: hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 47 - * �when using bdIMAD library. + * when using bdIMAD library. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 50 - * \n Since the bdIMAD library provide itself the echo cancellation + * \n Since the bdIMAD library provides itself the echo cancellation hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 52 - * in the PJSIP librariy applications. + * in the PJSIP library applications. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 66 - * \n Setting michrophone volume. + * \n Setting microphone volume. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 69 + * - PJMEDIA_AUD_DEV_CAP_OUTPUT_ROUTE + * \n Support for audio output routing in mobile application(e.g. loudspeaker vs earpiece). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 77 - * @version 1.0.1 - * @copyright 2012 bdSound srl. All rights reserved. + * @version 2.0.0 rev.1618 + * @copyright 2015 bdSound srl. All rights reserved. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 97 - * @defgroup groupStructEnum Structs and Enums + * @defgroup groupStructEnum Structs and Enums hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 137 - * @param[in] *buffer pointer to the buffer with the audio - * samples to be played(short type). - * @param[in] nSamples number of samples required. - * @param[in] user_data pointer to the user data structure - * defined in the bdIMADpj_Setting_t - * structure. + * + * @param[in] *buffer pointer to the buffer with the audio + * samples to be played (short type). + * + * @param[in] nSamples number of samples required. + * + * @param[in] user_data pointer to the user data structure + * defined in the bdIMADpj_Setting_t structure. + * hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 153 - * @brief Callback used to retrive the caputre buffer of bdIMAD. The function - * is called by bdIMAD each time processed mic samples are available. - * @param[out] *buffer pointer to the buffer with the audio - * samples to download(short type). - * @param[in] nSamples number of samples processed to download. - * @param[in] user_data pointer to the user data structure - * defined in the MainSet structure. + * @brief Callback used to retrieve the capture buffer of bdIMAD. The function + * is called by bdIMAD each time processed microphone samples are available. + * + * @param[out] *buffer pointer to the buffer with the audio + * samples to be downloaded (short type). + * + * @param[in] nSamples number of samples processed to be downloaded. + * + * @param[in] user_data pointer to the user data structure + * defined in the bdIMADpj_Setting_t structure. + * hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 182 -typedef enum bdIMADpj_Status{ - /**< No error. */ +typedef enum bdIMADpj_Status { + /** No error. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 185 - /**< Watch bdIMADpj_Warnings_t structure to find the warnings. */ + /** The warnings can be find in the bdIMADpj_Warnings_t structure . */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 187 - /**< Error not identified. */ + /** Error not identified. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 189 - /**< The pointer passed is NULL. */ + /** The pointer passed is NULL. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 191 - /**< Allocation procedure failed. */ + /** Allocation procedure failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 193 - /**< The parameter is not existent or the set/get function is not active. */ + /** The parameter is not existent or the set/get function is not active. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 195 - /**< No capture device found. */ + /** No capture device found. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 197 - /**< No play device found. */ + /** No play device found. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 199 - /**< Frame size not allowed. */ + /** Frame size not allowed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 201 - /**< Sample frequency not allowed. */ + /** Sample frequency not allowed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 203 - /**< Samples missing. */ + /** Samples missing. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 205 - /**< Device list is empty. */ + /** Device list is empty. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 207 - /**< Library not authorized, entering demo mode. */ + /** Library not authorized, entering demo mode. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 209 - /**< The input channel memory has not been allocated. */ + /** The input channel memory has not been allocated. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 211 - /**< The library has expired, entering demo mode. */ + /** The library has expired, entering demo mode. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 213 - /**< Open of capture device failed. */ + /** Open of capture device failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 215 - /**< Open of play device failed. */ + /** Open of play device failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 217 - /**< Start of play device failed. */ + /** Start of play device failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 219 - /**< Start of capture device failed. */ + /** Start of capture device failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 221 - /**< Start of time process failed. */ + /** Start of time process failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 223 - /**< Start of thread process failed. */ + /** Start of thread process failed. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 225 - /**< No volume control available. */ + /** No volume control available. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 236 -typedef enum bdIMADpj_Parameter{ - /**< int* \n set/get \n 1 enable / 0 disable echo cancellation. */ - BD_PARAM_IMAD_PJ_AEC_ENABLE = 1, - /**< int* \n set/get \n 1 enable / 0 disable microphone control +typedef enum bdIMADpj_Parameter { + /** int* \n set/get \n 1 enable / 0 disable echo cancellation. */ + BD_PARAM_IMAD_PJ_AEC_ENABLE = 0, + /** int* \n set/get \n 0 -> 256 ms of echo tail. */ + BD_PARAM_IMAD_PJ_AEC_ECHO_TAIL_MS = 1, + /** int* \n set/get \n 0 -> 400 ms of delay offset. */ + BD_PARAM_IMAD_PJ_AEC_DELAY_OFFSET_MS = 2, + /** int* \n set/get \n 1 enable / 0 disable automatic delay estimation. */ + BD_PARAM_IMAD_PJ_AEC_AUTO_DELAY_ESTIMATION_ENABLE = 3, + /** int* \n get \n estimated delay in ms. */ + BD_PARAM_IMAD_PJ_AEC_AUTO_DELAY_ESTIMATION_VALUE = 4, + /** int* \n get \n 1 is stable / 0 not yet stable estimated delay. */ + BD_PARAM_IMAD_PJ_AEC_AUTO_DELAY_ESTIMATION_IS_STABLE = 5, + /** int* \n set/get \n 1 enable / 0 disable Noise Reduction. */ + BD_PARAM_IMAD_PJ_NR_ENABLE = 6, + /** int* \n set/get \n 0 low / 1 medium / 2 high / 3 very high / 4 adaptive level of Noise Reduction. */ + BD_PARAM_IMAD_PJ_NR_LEVEL = 7, + /** int* \n set/get \n 1 enable / 0 disable Comfort Noise Generator. */ + BD_PARAM_IMAD_PJ_CNG_ENABLE = 8, + /** int* \n set/get \n 1 adaptive / 0 not adaptive mode of Comfort Noise Generator. */ + BD_PARAM_IMAD_PJ_CNG_SET_ADAPTIVE = 9, + /** int* \n set/get \n -40 -> -100 dBFS fixed power level of Comfort Noise Generator, when adaptive mode is disabled. */ + BD_PARAM_IMAD_PJ_CNG_FIXED_LEVEL_DB = 10, + /** int* \n set/get \n 0 minimal / 1 low / 2 intermediate / 3 high / 4 aggressive effort level of Residual Echo Canceller. */ + BD_PARAM_IMAD_PJ_REC_EFFORT_LEVEL = 11, + /** int* \n set/get \n 1 enable / 0 disable Non Linear Processor. */ + BD_PARAM_IMAD_PJ_NLP_ENABLE = 12, + /** float* \n set/get \n 6.0f -> 24.0f dB Double Talk Detector sensitivity. */ + BD_PARAM_IMAD_PJ_NLP_DTD_SENSITIVITY = 13, + /** float* \n set/get \n -50.0f -> 0.0f dB maximum applicable gain by the Non Linear Processor. */ + BD_PARAM_IMAD_PJ_NLP_GAIN = 14, + /** int* \n set/get \n 1 enable / 0 disable microphone control hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 269 - BD_PARAM_IMAD_PJ_MIC_CONTROL_ENABLE = 2, - /**< int* \n set/get \n 1 ebable / 0 disable noise reduction. */ - BD_PARAM_IMAD_PJ_NOISE_REDUCTION_ENABLE = 3, - /**< int* \n set \n number of channel to reset. Used to reset - * the input channel statistics. To be used when the same channel - * is assigned to another partecipant. */ - BD_PARAM_IMAD_PJ_RESET_STATISTIC_IN_CH = 4, - /**< float* \n set/get \n 0.0f -> 1.0f volume of + BD_PARAM_IMAD_PJ_MIC_CONTROL_ENABLE = 15, + /** float* \n set/get \n 0.0f -> 1.0f volume of hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 272 - BD_PARAM_IMAD_PJ_MIC_VOLUME = 5, - /**< int* \n set/get \n 0 mute / 1 not mute on microphone + BD_PARAM_IMAD_PJ_MIC_VOLUME = 16, + /** int* \n set/get \n 0 mute / 1 not mute on microphone hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 275 - BD_PARAM_IMAD_PJ_MIC_MUTE = 6, - /**< float* \n set/get \n 0.0f -> 1.0f volume of the speaker. */ - BD_PARAM_IMAD_PJ_SPK_VOLUME = 7, - /**< int* \n set/get \n 0 mute / 1 not mute on speaker. */ - BD_PARAM_IMAD_PJ_SPK_MUTE = 8, + BD_PARAM_IMAD_PJ_MIC_MUTE = 17, + /** float* \n set/get \n 0.0f -> 1.0f volume of the speaker. */ + BD_PARAM_IMAD_PJ_SPK_VOLUME = 18, + /** int* \n set/get \n 0 mute / 1 not mute on speaker. */ + BD_PARAM_IMAD_PJ_SPK_MUTE = 19, hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 282 +/** + * @brief Direction path of the parameter to be used in set and get audio process parameter functions. + * + */ +typedef enum bdIMADpj_DirPath { + /** Indicates the send direction path (microphone). */ + BD_IMAD_PJ_DIR_PATH_SEND = 0, + /** Indicates the receive direction path (speaker). */ + BD_IMAD_PJ_DIR_PATH_RECV = 1, +} bdIMADpj_DirPath; hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 294 - * @brief Instance structure for the information regarding the aec engine. + * @brief Audio processing parameter to pass to set and get audio processing parameter functions. + * + * For each enumeration are defined the data type and the supported operations + * on that parameter (set and get). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 299 + +typedef enum bdIMADpj_AudioProcessParameter { + /** int* \n set/get \n 1 enable / 0 disable whole audio processing chain. */ + BD_AP_PARAM_IMAD_PJ_AUDIO_PROC_ENABLE = 200, + /** int* \n set/get \n 1 enable / 0 disable digital gain. */ + BD_AP_PARAM_IMAD_PJ_GAIN_ENABLE = 201, + /** float* \n set/get \n 0.0f -> 20.0f dB digital gain value. */ + BD_AP_PARAM_IMAD_PJ_GAIN_VALUE_DB = 202, + /** int* \n set/get \n 1 enable / 0 disable Automatic Gain Control. */ + BD_AP_PARAM_IMAD_PJ_AGC_ENABLE = 203, + /** float* \n set/get \n 0.0f -> -30.0f dBFS target RMS power of the Automatic Gain Control. */ + BD_AP_PARAM_IMAD_PJ_AGC_TARGET_RMS_DB = 204, + /** float* \n set/get \n 0.0f -> 15.0f dB maximum applicable gain by the Automatic Gain Control. */ + BD_AP_PARAM_IMAD_PJ_AGC_MAX_GAIN_DB = 205, + /** int* \n set/get \n 1 enable / 0 disable Graphic Equalizer (10 bands). */ + BD_AP_PARAM_IMAD_PJ_GEQ_ENABLE = 206, + /** float* \n set/get \n Graphic Equalizer (10 bands) frequencies and gains. \n + Float array of 30 elements, composed by 10 triplets (enable, frequency, gain_dB). \n + First field, enable: 1.0f enable / 0.0f disable the frequency filter. \n + Second field, frequency: 0.0f -> Fs/2 Hz centre frequency of the filter. \n + Third field, gain_dB: -18.0f -> 18.0f dB gain of the filter. + Frequency values in ascending order. \n */ + BD_AP_PARAM_IMAD_PJ_GEQ_FREQ_GAIN = 207, + /** int* \n set/get \n 1 enable / 0 disable Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_ENABLE = 208, + /** float* \n set/get \n 0.0f -> 5000.0f ms attack time of gain processor of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_ATTACK_TIME_GAIN_MS = 209, + /** float* \n set/get \n 0.0f -> 5000.0f ms release time of gain processor of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_RELEASE_TIME_GAIN_MS = 210, + /** float* \n set/get \n 0.0f -> 5000.0f ms attack time of level measurement of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_ATTACK_TIME_LEVEL_MS = 211, + /** float* \n set/get \n 0.0f -> 5000.0f ms release time of level measurement of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_RELEASE_TIME_LEVEL_MS = 212, + /** int* \n set/get \n 0 -> 10 ms lookahead time of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_LOOK_AHEAD_MS = 213, + /** int* \n set/get \n 1 RMS / 0 peak detector of the Compander selected. */ + BD_AP_PARAM_IMAD_PJ_CMP_RMS_DETECTOR = 214, + /** float* \n set/get \n 0.0f -> 12.0f dB compensation gain of the Compander. */ + BD_AP_PARAM_IMAD_PJ_CMP_COMPENSATION_GAIN_DB = 215, + /** float* \n set/get \n Float sorted array of static gain curve points in dB - up to 4 points: input0, output0, … , input3, output3. + Gain values: 0.0f -> -100.0f dB. */ + BD_AP_PARAM_IMAD_PJ_CMP_TABLE = 216, + /** int* \n set/get \n 1 enable / 0 disable Limiter. */ + BD_AP_PARAM_IMAD_PJ_LIM_ENABLE = 217, + /** float* \n set/get \n 0.0f -> -40.0f dBFS threshold value of the Limiter. */ + BD_AP_PARAM_IMAD_PJ_LIM_THRESHOLD = 218, +} bdIMADpj_AudioProcessParameter; hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 347 -typedef struct bdIMADpj_Setting_t{ - /**< Sample frequency (8kHz or 16kHz). */ + +/** + * @brief Test signal type to be used in set and get test parameter functions. + * + */ +typedef enum bdIMADpj_TestSignalType { + /** Indicates a sine wave. */ + BD_IMAD_PJ_TS_SINE = 0, + /** Indicates a White Gaussian Noise. */ + BD_IMAD_PJ_TS_WGN = 1, +} bdIMADpj_TestSignalType; + + +/** + * @brief Test parameter to pass to set and get test parameter functions. + * + * For each enumeration are defined the data type and the supported operations + * on that parameter (set and get). + */ +typedef enum bdIMADpj_TestParameter { + /** int* \n set/get \n 1 enable / 0 disable Test Signal. */ + BD_TEST_PARAM_IMAD_PJ_TEST_SIGNAL_ENABLE = 400, + /** bdIMADpj_TestSignalType* \n set/get \n Test Signal type: sine or Wgn. */ + BD_TEST_PARAM_IMAD_PJ_TEST_SIGNAL_TYPE = 401, + /** int* \n set/get \n 0 -> -100 dBFS amplitude of Test Signal. */ + BD_TEST_PARAM_IMAD_PJ_TEST_SIGNAL_AMPLITUDE = 402, + /** float* \n set/get \n 0 -> Fs/2 Hz frequency of sine Test Signal . */ + BD_TEST_PARAM_IMAD_PJ_TEST_SIGNAL_FREQUENCY = 403, +} bdIMADpj_TestParameter; + +/** + * @brief Side to be used in get VU meter level value function. + * + */ +typedef enum bdIMADpj_Side { + /** Indicates the input side of a direction path. */ + BD_IMAD_PJ_SIDE_INPUT = 0, + /** Indicates the output side of a direction path. */ + BD_IMAD_PJ_SIDE_OUTPUT = 1, +} bdIMADpj_Side; + + +/** + * @brief Instance structure for the information regarding the AEC engine. + */ + +typedef struct bdIMADpj_Setting_t { + /** Sample frequency (8kHz - 16kHz - 32kHz - 44.1kHz - 48kHz). */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 396 - /**< Audio buffer managed by the aec bdIMAD functions. + /** Audio buffer managed by the AEC bdIMAD functions. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 399 - /**< Points to the validation functions in the validation library. */ + /** Pointer to the validation functions in the validation library. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 401 - /**< Points to the the callback function used for filling + /** Pointer to the the callback function used for filling hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 404 - /**< Points to user data to pass to the callback. */ + /** Pointer to user data to pass to the callback (playback). */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 406 - /**< Points to the callback function used for retreive the processed + /** Pointer to the callback function used for retrieve the processed hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 409 - /**< Points to user data to pass to the callback. */ + /** Pointer to user data to pass to the callback (capture). */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 411 - /**< Is a wide char pointer to the capture device name. */ + /** Is a wide char pointer to the capture device name. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 413 - /**< Is a wide char pointer to the play device name. */ + /** Is a wide char pointer to the play device name. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 415 - /**< True to enable diagnostic, false to disable. */ + /** True to enable diagnostic, false to disable. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 417 - /**< Directory which will contains the files generated for diagnostic. */ + /** Directory which will contains the files generated for diagnostic. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 419 - /**< Is an auxiliary settings pointer used internally by bdIMAD. */ + /** Is an auxiliary settings pointer used internally by bdIMAD. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 428 -typedef struct bdIMADpj_Warnings_t{ - /**< The capture device indicated can't be opened, has been selected - * the default capture device. */ +typedef struct bdIMADpj_Warnings_t { + /** The capture device indicated can't be opened, then the default capture device + * has been selected. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 432 - /**< The capture device opened has not volume control. */ + /** The capture device opened has not volume control. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 434 - /**< The play device indicated can't be opened, has been selected - * the default play device. */ + /** The play device indicated can't be opened, then the default play device + * has been selected. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 437 - /**< The number of channel requested is out of range. The number of - * channel opened is equal to the maximum. */ + /** The number of channels requested is out of range. The number of + * channels opened is equal to the maximum. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 440 - /**< The diagnostic files could not be saved. */ + /** The diagnostic files could not be saved. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 442 - /**< The nlp level requested is not allowed, it has been automatically - * changed to the default value. */ + /** The nlp level requested is not allowed, it has been automatically + * changed to the default value. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 445 - /**< No capture device is present. Anyway the bdSES has been - * istantiated only for playback. */ + /** No capture device is present. Anyway the bdSES has been instantiated + * only for playback. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 448 - /**< The cpu is not adapt to run the aec engine, the aec has been disabled. - * This appens for very old cpu like pentium III. */ + /** The CPU is not adapt to run the AEC engine, the AEC has been disabled. + * This happens for very old CPU like pentium III. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 451 - /**< Windows Direct Sound error. */ + /** Windows Direct Sound error. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 453 - /**< Windows Direct Sound volume error. */ + /** Windows Direct Sound volume error. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 455 - /**< No play device is present. Anyway the bdSES has been istantiated - * only for capture. */ + /** No play device is present. Anyway the bdSES has been instantiated + * only for capture. */ hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 464 -typedef struct bdIMADpj_libVersion_t{ +typedef struct bdIMADpj_libVersion_t { hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 477 -typedef enum bdIMADpj_out_dev_route{ - /** Default route. */ - BD_AUD_DEV_ROUTE_DEFAULT = 0, +typedef enum bdIMADpj_out_dev_route { + /** Default route */ + BD_AUD_DEV_ROUTE_DEFAULT = 0, hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 482 - BD_AUD_DEV_ROUTE_LOUDSPEAKER = 1, + BD_AUD_DEV_ROUTE_LOUDSPEAKER = 1, hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 485 - BD_AUD_DEV_ROUTE_EARPIECE = 2 + BD_AUD_DEV_ROUTE_EARPIECE = 2 hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 508 - * The function generate a structure bdIMADpj_Setting_t filled with the + * The function generates a structure bdIMADpj_Setting_t filled with the hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 512 - * \n The function generate also a warning structure (::bdIMADpj_Warnings_t) + * \n The function generates also a warning structure (::bdIMADpj_Warnings_t) hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 514 - * @param[out] **ppSettings Points to the pointer of the - * allocated ::bdIMADpj_Setting_t. - * @param[out] **ppWarningMessages Points to the pointer of the - * allocated ::bdIMADpj_Warnings_t. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[out] **ppSettings Pointer to the pointer of the + * allocated ::bdIMADpj_Setting_t. + * + * @param[out] **ppWarningMessages Pointer to the pointer of the + * allocated ::bdIMADpj_Warnings_t. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 533 - * @param[in] **ppSettings Pointer to a memory location filled - * with the address of the - * ::bdIMADpj_Setting_t structure to free. - * This address will be set to NULL. - * @param[in] **ppWarningMessages Pointer to a memory location filled - * with the address of the allocated - * ::bdIMADpj_Warnings_t structure to free. - * This address will be set to NULL. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * @param[in] **ppSettings Pointer to a memory location filled + * with the address of the + * ::bdIMADpj_Setting_t structure to free. + * This address will be set to NULL. + * + * @param[in] **ppWarningMessages Pointer to a memory location filled + * with the address of the allocated + * ::bdIMADpj_Warnings_t structure to free. + * This address will be set to NULL. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 554 - * @param[out] *pBdIMADInstance Is the pointer to the bdIMAD object. - * @param[in] **ppSettings Pointer to pointer to a - * ::bdIMADpj_Setting_t structure, filled - * with initialization settings to be - * applied to the bdIMAD. - * \n Note, the pBdIMADInstance - * is modified with the applied settings. - * @param[out] **ppWarningMessages Pointer to pointer to a - * ::bdIMADpj_Warnings_t structure, - * which reports the warnings after the - * initialization. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). - * \n If the error is - * ::BD_PJ_WARN_BDIMAD_WARNING_ASSERTED - * the init has been performed with success, - * but with a different settings - * respect to the ones required. - * This mainly happens if the audio - * device opened is different to the - * one requested. + * + * @param[out] *pBdIMADInstance Is the pointer to the bdIMAD object. + * + * @param[in] **ppSettings Pointer to pointer to a + * ::bdIMADpj_Setting_t structure, filled + * with initialization settings to be + * applied to the bdIMAD. + * \n Note, the pBdIMADInstance + * is modified with the applied settings. + * + * @param[out] **ppWarningMessages Pointer to pointer to a + * ::bdIMADpj_Warnings_t structure, + * which reports the warnings after the + * initialization. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + * \n If the error is + * ::BD_PJ_WARN_BDIMAD_WARNING_ASSERTED + * the init function has been performed with success, + * but with a different settings + * respect to the ones required. + * This mainly happens if the audio + * device opened is different to the + * one requested. hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 588 - * @param[in] *pBdIMADInstance Pointer to the bdIMAD object to free. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[in] *pBdIMADInstance Pointer to the bdIMAD object to free. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 598 - * @brief Is used to make a list of capure and play devices available + * @brief Is used to make a list of capture and play devices available hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 600 - * @param[in] captureDevice Set to 1 to get the list of capture - * devices. Set to 0 to get the list of - * play devices. - * @param[in] **deviceName Pointer to pointer to a wide char - * containing the names of capture/play - * devices. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[in] captureDevice Set to 1 to get the list of capture + * devices. Set to 0 to get the list of + * play devices. + * + * @param[in] **deviceName Pointer to pointer to a wide char + * containing the names of capture/play + * devices. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 619 - * @param[in] bdIMADInstance bdIMAD object. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise - * return an error (refer to - * ::bdIMADpj_Status). + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 641 - * @param[in] *pWarningMessages Pointer to the warning structure - * to be printed. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise - * return an error - * (refer to ::bdIMADpj_Status). + * + * @param[in] *pWarningMessages Pointer to the warning structure + * to be printed. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 654 - * @param[out] **ppWarningMessages Pointer to pointer to the warning - * structure to be cleared. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise - * return an error (refer to - * ::bdIMADpj_Status). + * + * @param[out] **ppWarningMessages Pointer to pointer to the warning + * structure to be cleared. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 668 - * @param[in] bdIMADInstance bdIMAD object. - * @param[in] parameterName Indicate the parameter to set. - * @param[in] *pValue Is a pointer to the value to set - * cast to void. - * \n In the ::bdIMADpj_Parameter - * declaration is indicated the real type of - * the value, depending on the - * parameterName. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise - * return an error (refer to - * �::bdIMADpj_Status). + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be set. + * + * @param[in] *pValue Is a pointer to the value to be set. + * \n In the ::bdIMADpj_Parameter + * declaration is indicated the type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 689 - * @param[in] bdIMADInstance bdIMAD object. - * @param[in] parameterName Indicate the parameter to get. - * @param[out] *pValue Is a pointer to the value to get cast - * to void. \n In the - * ::bdIMADpj_Parameter declaration is - * indicated the real type of the value, - * depending on the - * parameterName. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be get. + * + * @param[out] *pValue Is a pointer to the value to be get. + * \n In the ::bdIMADpj_Parameter + * declaration is indicated the type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 707 + + /** + * @brief Is used to set an audio processing parameter of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be set. + * + * @param[in] directionPath Indicates the send/receive direction path. + * The parameter will be set to the audio process block + * located in the selected path. + * + * @param[in] *pValue Is a pointer to the value to be set. + * \n In the ::bdIMADpj_AudioProcessParameter + * declaration is indicated the real type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_setAudioProcessParameter(bdIMADpj bdIMADInstance, + bdIMADpj_AudioProcessParameter parameterName, bdIMADpj_DirPath directionPath, void *pValue); + hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 734 + * @brief Is used to get an audio processing parameter of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be get. + * + * @param[in] directionPath Indicates the send/receive direction path. + * The parameter will be get from the audio process block + * located in the selected path. + * + * @param[out] *pValue Is a pointer to the value to be get. + * \n In the ::bdIMADpj_AudioProcessParameter + * declaration is indicated the real type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_getAudioProcessParameter(bdIMADpj bdIMADInstance, + bdIMADpj_AudioProcessParameter parameterName, bdIMADpj_DirPath directionPath, void *pValue); + +/** + * @brief Is used to set a test parameter of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be set. + * + * @param[in] directionPath Indicates the send/receive direction path. + * The parameter will be set to the test generator block + * located in the selected path. + * + * @param[in] *pValue Is a pointer to the value to be set. + * \n In the ::bdIMADpj_TestParameter + * declaration is indicated the real type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_setTestParameter(bdIMADpj bdIMADInstance, bdIMADpj_TestParameter parameterName, bdIMADpj_DirPath directionPath, void* pValue); + +/** + * @brief Is used to get a test parameter of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] parameterName Indicates the parameter to be get. + * + * @param[in] directionPath Indicates the send/receive direction path. + * The parameter will be get from the test generator block + * located in the selected path. + * + * @param[out] *pValue Is a pointer to the value to be get. + * \n In the ::bdIMADpj_TestParameter + * declaration is indicated the real type of + * the value, depending on the + * parameterName. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_getTestParameter(bdIMADpj bdIMADInstance, bdIMADpj_TestParameter parameterName, bdIMADpj_DirPath directionPath, void* pValue); + +/** + * @brief Is used to get the VU meter level value located at the input/output + * of the send/receive path of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] directionPath Indicates the send/receive direction path. + * The level value will be get from + * the VU meter located in the selected path. + * + * @param[in] side Indicates the input/output side. + * The level value will be get from + * the VU meter located at the selected + * side of the selected path. + * + * @param[out] *pValue Is a pointer to the float level value to be get. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_getVuMeterLevelValue(bdIMADpj bdIMADInstance, bdIMADpj_DirPath directionPath, bdIMADpj_Side side, float* pValue); + +/** + * @brief Is used to enable/disable socket communication with GUI of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] port Receive port number to be used for socket communication (bdController). + * + * @param[in] enable Set 1 to enable, 0 to disable the socket communication [default=disabled]. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_enableGuiSocketCommunication(bdIMADpj bdIMADInstance, int port, int enable); + +/** hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 849 - * @param[in] bdIMADInstance bdIMAD object. - * @param[in] outputRoute Indicate the route of the output device to set. - * @param[out] **ppWarningMessages Pointer to pointer to a - * ::bdIMADpj_Warnings_t structure, - * which reports the warnings after the - * set function. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[in] outputRoute Indicates the route of the output device to be set. + * + * @param[out] **ppWarningMessages Pointer to pointer to a + * ::bdIMADpj_Warnings_t structure, + * which reports the warnings after the + * set function. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 868 - * @param[in] bdIMADInstance bdIMAD object. - * @param[out] *outputRoute Is a pointer to the route of the output device currently setted. - * @return ::BD_PJ_OK if the function has been - * performed successfully, otherwise return - * an error (refer to ::bdIMADpj_Status). + * + * @param[in] bdIMADInstance bdIMAD object. + * + * @param[out] *outputRoute Pointer to the route of the output device currently set. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 877 + hunk ./deps/pjsip/third_party/bdsound/include/bdimad.h 879 + +/** + * @brief Is used to get the device capabilities of capture/playback device of the bdIMAD object pointed by the + * pBdIMADInstance. + * + * @param[in] captureDevice Set to 1 to get the capabilities of capture + * devices. Set to 0 to get the capabilities of + * play devices. + * + * @caps[out] *caps Is a pointer to the device capabilities, + * as bitmask combination of #pjmedia_aud_dev_cap. + * + * @return ::BD_PJ_OK if the function has been + * performed successfully, otherwise return + * an error (refer to ::bdIMADpj_Status). + */ +BDIMADPJ_API bdIMADpj_Status bdIMADpj_getDeviceCapabilities(int captureDevice, unsigned *caps); }