comparison include/BeagleRT.h @ 171:e63563507edd

Added command-line options for the PGA

 
 /**
  * Default level of the audio ADC in decibels. See BeagleRT_setADCLevel().
  */
 #define DEFAULT_ADC_LEVEL	-6.0
+
+
+/**
+ * Default level of the Programmable Gain Amplifier in decibels.
+ */
+#define DEFAULT_PGA_GAIN 16
 
 /**
  * Default level of the headphone output in decibels. See BeagleRT_setHeadphoneLevel().
  */
 #define DEFAULT_HP_LEVEL	-6.0

 	int beginMuted;
 	/// Level for the audio DAC output
 	float dacLevel;
 	/// Level for the audio ADC input
 	float adcLevel;
+	/// Gains for the PGA, left and right channels
+	float pgaGain[2];
 	/// Level for the headphone output
 	float headphoneLevel;
 
 	/// The external .bin file to load. If empty will use PRU code from pru_rtaudio_bin.h
 	char pruFilename[MAX_PRU_FILENAME_LENGTH];

  *
  * \return 0 on success, or nonzero if an error occurred.
  */
 int BeagleRT_setADCLevel(float decibels);
 
+
+/**
+ * \brief Set the gain of the audio preamplifier.
+ *
+ * This function sets the level of the Programmable Gain Amplifier(PGA), which
+ * amplifies the signal before the ADC.
+ *
+ * \b Important: do not call this function from within render(), as it does not make
+ * any guarantees on real-time performance.
+ *
+ * \param decibels Level of the PGA Valid levels range from 0 (lowest) to
+ * 59.5 (highest) in steps of 0.5dB. Levels between increments of 0.5 will be rounded.
+ * \param channel Specifies which channel to apply the gain to. Channel 0 is left,
+ * channel 1 is right
+ *
+ * \return 0 on success, or nonzero if an error occurred.
+ */
+int BeagleRT_setPgaGain(float decibels, int channel);
+
 /**
  * \brief Set the level of the onboard headphone amplifier.
  *
  * This function sets the level of the headphone output only (3-pin connector on the BeagleRT
  * cape or the output jack on the BeagleBone Audio Cape). It does not affect the level of the