]> git.sur5r.net Git - freertos/blob
f160b0a178a48fa54cdefd465272c3ef6b6dfda5
[freertos] /
1 /**************************************************************************//**\r
2  * @file em_opamp.h\r
3  * @brief Operational Amplifier (OPAMP) peripheral API\r
4  * @version 4.0.0\r
5  ******************************************************************************\r
6  * @section License\r
7  * <b>(C) Copyright 2014 Silicon Labs, http://www.silabs.com</b>\r
8  *******************************************************************************\r
9  *\r
10  * Permission is granted to anyone to use this software for any purpose,\r
11  * including commercial applications, and to alter it and redistribute it\r
12  * freely, subject to the following restrictions:\r
13  *\r
14  * 1. The origin of this software must not be misrepresented; you must not\r
15  *    claim that you wrote the original software.\r
16  * 2. Altered source versions must be plainly marked as such, and must not be\r
17  *    misrepresented as being the original software.\r
18  * 3. This notice may not be removed or altered from any source distribution.\r
19  *\r
20  * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no\r
21  * obligation to support this Software. Silicon Labs is providing the\r
22  * Software "AS IS", with no express or implied warranties of any kind,\r
23  * including, but not limited to, any implied warranties of merchantability\r
24  * or fitness for any particular purpose or warranties against infringement\r
25  * of any proprietary rights of a third party.\r
26  *\r
27  * Silicon Labs will not be liable for any consequential, incidental, or\r
28  * special damages, or any other relief, or for any claim by any third party,\r
29  * arising from your use of this Software.\r
30  *\r
31  ******************************************************************************/\r
32 \r
33 \r
34 #ifndef __SILICON_LABS_EM_OPAMP_H_\r
35 #define __SILICON_LABS_EM_OPAMP_H_\r
36 \r
37 #include "em_device.h"\r
38 #if defined(OPAMP_PRESENT) && (OPAMP_COUNT == 1)\r
39 \r
40 #ifdef __cplusplus\r
41 extern "C" {\r
42 #endif\r
43 \r
44 #include <stdint.h>\r
45 #include <stdbool.h>\r
46 #include "em_dac.h"\r
47 \r
48 /***************************************************************************//**\r
49  * @addtogroup EM_Library\r
50  * @{\r
51  ******************************************************************************/\r
52 \r
53 /***************************************************************************//**\r
54  * @addtogroup OPAMP\r
55  * @{\r
56  ******************************************************************************/\r
57 \r
58 /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */\r
59 \r
60 /** Validation of DAC OPA number for assert statements. */\r
61 #define DAC_OPA_VALID(opa)    ((opa) <= OPA2)\r
62 \r
63 /** @endcond */\r
64 \r
65 /*******************************************************************************\r
66  ********************************   ENUMS   ************************************\r
67  ******************************************************************************/\r
68 \r
69 /** OPAMP selector values. */\r
70 typedef enum\r
71 {\r
72   OPA0 = 0,                   /**< Select OPA0. */\r
73   OPA1 = 1,                   /**< Select OPA1. */\r
74   OPA2 = 2                    /**< Select OPA2. */\r
75 } OPAMP_TypeDef;\r
76 \r
77 /** OPAMP negative terminal input selection values. */\r
78 typedef enum\r
79 {\r
80   opaNegSelDisable   = DAC_OPA0MUX_NEGSEL_DISABLE,    /**< Input disabled.               */\r
81   opaNegSelUnityGain = DAC_OPA0MUX_NEGSEL_UG,         /**< Unity gain feedback path.     */\r
82   opaNegSelResTap    = DAC_OPA0MUX_NEGSEL_OPATAP,     /**< Feedback resistor ladder tap. */\r
83   opaNegSelNegPad    = DAC_OPA0MUX_NEGSEL_NEGPAD      /**< Negative pad as input.        */\r
84 } OPAMP_NegSel_TypeDef;\r
85 \r
86 /** OPAMP positive terminal input selection values. */\r
87 typedef enum\r
88 {\r
89   opaPosSelDisable    = DAC_OPA0MUX_POSSEL_DISABLE,   /**< Input disabled.          */\r
90   opaPosSelDac        = DAC_OPA0MUX_POSSEL_DAC,       /**< DAC as input (not OPA2). */\r
91   opaPosSelPosPad     = DAC_OPA0MUX_POSSEL_POSPAD,    /**< Positive pad as input.   */\r
92   opaPosSelOpaIn      = DAC_OPA0MUX_POSSEL_OPA0INP,   /**< Input from OPAx.         */\r
93   opaPosSelResTapOpa0 = DAC_OPA0MUX_POSSEL_OPATAP     /**< Feedback resistor ladder tap from OPA0. */\r
94 } OPAMP_PosSel_TypeDef;\r
95 \r
96 /** OPAMP output terminal selection values. */\r
97 typedef enum\r
98 {\r
99   opaOutModeDisable = DAC_OPA0MUX_OUTMODE_DISABLE,    /**< OPA output disabled.        */\r
100   opaOutModeMain    = DAC_OPA0MUX_OUTMODE_MAIN,       /**< Main output to pin enabled. */\r
101   opaOutModeAlt     = DAC_OPA0MUX_OUTMODE_ALT,        /**< Alternate output(s) enabled (not OPA2).     */\r
102   opaOutModeAll     = DAC_OPA0MUX_OUTMODE_ALL         /**< Both main and alternate enabled (not OPA2). */\r
103 } OPAMP_OutMode_TypeDef;\r
104 \r
105 /** OPAMP gain values. */\r
106 typedef enum\r
107 {\r
108   opaResSelDefault    = DAC_OPA0MUX_RESSEL_DEFAULT,  /**< Default value when resistor ladder is unused. */\r
109   opaResSelR2eq0_33R1 = DAC_OPA0MUX_RESSEL_RES0,     /**< R2 = 0.33 * R1 */\r
110   opaResSelR2eqR1     = DAC_OPA0MUX_RESSEL_RES1,     /**< R2 = R1        */\r
111   opaResSelR1eq1_67R1 = DAC_OPA0MUX_RESSEL_RES2,     /**< R2 = 1.67 R1   */\r
112   opaResSelR2eq2R1    = DAC_OPA0MUX_RESSEL_RES3,     /**< R2 = 2 * R1    */\r
113   opaResSelR2eq3R1    = DAC_OPA0MUX_RESSEL_RES4,     /**< R2 = 3 * R1    */\r
114   opaResSelR2eq4_33R1 = DAC_OPA0MUX_RESSEL_RES5,     /**< R2 = 4.33 * R1 */\r
115   opaResSelR2eq7R1    = DAC_OPA0MUX_RESSEL_RES6,     /**< R2 = 7 * R1    */\r
116   opaResSelR2eq15R1   = DAC_OPA0MUX_RESSEL_RES7      /**< R2 = 15 * R1   */\r
117 } OPAMP_ResSel_TypeDef;\r
118 \r
119 /** OPAMP resistor ladder input selector values. */\r
120 typedef enum\r
121 {\r
122   opaResInMuxDisable = DAC_OPA0MUX_RESINMUX_DISABLE,   /**< Resistor ladder disabled. */\r
123   opaResInMuxOpaIn   = DAC_OPA0MUX_RESINMUX_OPA0INP,   /**< Input from OPAx.          */\r
124   opaResInMuxNegPad  = DAC_OPA0MUX_RESINMUX_NEGPAD,    /**< Input from negative pad.  */\r
125   opaResInMuxPosPad  = DAC_OPA0MUX_RESINMUX_POSPAD,    /**< Input from positive pad.  */\r
126   opaResInMuxVss     = DAC_OPA0MUX_RESINMUX_VSS        /**< Input connected to Vss.   */\r
127 } OPAMP_ResInMux_TypeDef;\r
128 \r
129 /*******************************************************************************\r
130  *******************************   STRUCTS   ***********************************\r
131  ******************************************************************************/\r
132 \r
133 /** OPAMP init structure. */\r
134 typedef struct\r
135 {\r
136   OPAMP_NegSel_TypeDef   negSel;              /**< Select input source for negative terminal.    */\r
137   OPAMP_PosSel_TypeDef   posSel;              /**< Select input source for positive terminal.    */\r
138   OPAMP_OutMode_TypeDef  outMode;             /**< Output terminal connection.                   */\r
139   OPAMP_ResSel_TypeDef   resSel;              /**< Select R2/R1 resistor ratio.                  */\r
140   OPAMP_ResInMux_TypeDef resInMux;            /**< Select input source for resistor ladder.      */\r
141   uint32_t               outPen;              /**< Alternate output enable bit mask. This value\r
142                                                  should consist of one or more of the\r
143                                                  DAC_OPA[opa#]MUX_OUTPEN_OUT[output#] flags\r
144                                                  (defined in \<part_name\>_dac.h) OR'ed together.\r
145                                                  @n @n\r
146                                                  For OPA0:\r
147                                                  @li DAC_OPA0MUX_OUTPEN_OUT0\r
148                                                  @li DAC_OPA0MUX_OUTPEN_OUT1\r
149                                                  @li DAC_OPA0MUX_OUTPEN_OUT2\r
150                                                  @li DAC_OPA0MUX_OUTPEN_OUT3\r
151                                                  @li DAC_OPA0MUX_OUTPEN_OUT4\r
152 \r
153                                                  For OPA1:\r
154                                                  @li DAC_OPA1MUX_OUTPEN_OUT0\r
155                                                  @li DAC_OPA1MUX_OUTPEN_OUT1\r
156                                                  @li DAC_OPA1MUX_OUTPEN_OUT2\r
157                                                  @li DAC_OPA1MUX_OUTPEN_OUT3\r
158                                                  @li DAC_OPA1MUX_OUTPEN_OUT4\r
159 \r
160                                                  For OPA2:\r
161                                                  @li DAC_OPA2MUX_OUTPEN_OUT0\r
162                                                  @li DAC_OPA2MUX_OUTPEN_OUT1\r
163 \r
164                                                  E.g: @n\r
165                                                  init.outPen = DAC_OPA0MUX_OUTPEN_OUT0 |\r
166                                                  DAC_OPA0MUX_OUTPEN_OUT2 |\r
167                                                  DAC_OPA0MUX_OUTPEN_OUT4;                        */\r
168   uint32_t               bias;                /**< Set OPAMP bias current.                       */\r
169   bool                   halfBias;            /**< Divide OPAMP bias current by 2.               */\r
170   bool                   lpfPosPadDisable;    /**< Disable low pass filter on positive pad.      */\r
171   bool                   lpfNegPadDisable;    /**< Disable low pass filter on negative pad.      */\r
172   bool                   nextOut;             /**< Enable NEXTOUT signal source.                 */\r
173   bool                   npEn;                /**< Enable positive pad.                          */\r
174   bool                   ppEn;                /**< Enable negative pad.                          */\r
175   bool                   shortInputs;         /**< Short OPAMP input terminals.                  */\r
176   bool                   hcmDisable;          /**< Disable input rail-to-rail capability.        */\r
177   bool                   defaultOffset;       /**< Use factory calibrated opamp offset value.    */\r
178   uint32_t               offset;              /**< Opamp offset value when @ref defaultOffset is false.*/\r
179 } OPAMP_Init_TypeDef;\r
180 \r
181 /** Configuration of OPA0/1 in unity gain voltage follower mode.       */\r
182 #define OPA_INIT_UNITY_GAIN                                                       \\r
183   {                                                                               \\r
184     opaNegSelUnityGain,             /* Unity gain.                             */ \\r
185     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
186     opaOutModeMain,                 /* Main output enabled.                    */ \\r
187     opaResSelDefault,               /* Resistor ladder is not used.            */ \\r
188     opaResInMuxDisable,             /* Resistor ladder disabled.               */ \\r
189     0,                              /* No alternate outputs enabled.           */ \\r
190     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
191     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
192     false,                          /* No low pass filter on pos pad.          */ \\r
193     false,                          /* No low pass filter on neg pad.          */ \\r
194     false,                          /* No nextout output enabled.              */ \\r
195     false,                          /* Neg pad disabled.                       */ \\r
196     true,                           /* Pos pad enabled, used as signal input.  */ \\r
197     false,                          /* No shorting of inputs.                  */ \\r
198     false,                          /* Rail-to-rail input enabled.             */ \\r
199     true,                           /* Use factory calibrated opamp offset.    */ \\r
200     0                               /* Opamp offset value (not used).          */ \\r
201   }\r
202 \r
203 /** Configuration of OPA2 in unity gain voltage follower mode.         */\r
204 #define OPA_INIT_UNITY_GAIN_OPA2                                                  \\r
205   {                                                                               \\r
206     opaNegSelUnityGain,             /* Unity gain.                             */ \\r
207     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
208     opaOutModeMain,                 /* Main output enabled.                    */ \\r
209     opaResSelDefault,               /* Resistor ladder is not used.            */ \\r
210     opaResInMuxDisable,             /* Resistor ladder disabled.               */ \\r
211     DAC_OPA0MUX_OUTPEN_OUT0,        /* Alternate output 0 enabled.             */ \\r
212     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
213     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
214     false,                          /* No low pass filter on pos pad.          */ \\r
215     false,                          /* No low pass filter on neg pad.          */ \\r
216     false,                          /* No nextout output enabled.              */ \\r
217     false,                          /* Neg pad disabled.                       */ \\r
218     true,                           /* Pos pad enabled, used as signal input.  */ \\r
219     false,                          /* No shorting of inputs.                  */ \\r
220     false,                          /* Rail-to-rail input enabled.             */ \\r
221     true,                           /* Use factory calibrated opamp offset.    */ \\r
222     0                               /* Opamp offset value (not used).          */ \\r
223   }\r
224 \r
225 /** Configuration of OPA0/1 in non-inverting amplifier mode.           */\r
226 #define OPA_INIT_NON_INVERTING                                                    \\r
227   {                                                                               \\r
228     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
229     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
230     opaOutModeMain,                 /* Main output enabled.                    */ \\r
231     opaResSelR2eq0_33R1,            /* R2 = 1/3 R1                             */ \\r
232     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
233     0,                              /* No alternate outputs enabled.           */ \\r
234     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
235     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
236     false,                          /* No low pass filter on pos pad.          */ \\r
237     false,                          /* No low pass filter on neg pad.          */ \\r
238     false,                          /* No nextout output enabled.              */ \\r
239     true,                           /* Neg pad enabled, used as signal ground. */ \\r
240     true,                           /* Pos pad enabled, used as signal input.  */ \\r
241     false,                          /* No shorting of inputs.                  */ \\r
242     false,                          /* Rail-to-rail input enabled.             */ \\r
243     true,                           /* Use factory calibrated opamp offset.    */ \\r
244     0                               /* Opamp offset value (not used).          */ \\r
245   }\r
246 \r
247 /** Configuration of OPA2 in non-inverting amplifier mode.             */\r
248 #define OPA_INIT_NON_INVERTING_OPA2                                               \\r
249   {                                                                               \\r
250     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
251     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
252     opaOutModeMain,                 /* Main output enabled.                    */ \\r
253     opaResSelR2eq0_33R1,            /* R2 = 1/3 R1                             */ \\r
254     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
255     DAC_OPA0MUX_OUTPEN_OUT0,        /* Alternate output 0 enabled.             */ \\r
256     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
257     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
258     false,                          /* No low pass filter on pos pad.          */ \\r
259     false,                          /* No low pass filter on neg pad.          */ \\r
260     false,                          /* No nextout output enabled.              */ \\r
261     true,                           /* Neg pad enabled, used as signal ground. */ \\r
262     true,                           /* Pos pad enabled, used as signal input.  */ \\r
263     false,                          /* No shorting of inputs.                  */ \\r
264     false,                          /* Rail-to-rail input enabled.             */ \\r
265     true,                           /* Use factory calibrated opamp offset.    */ \\r
266     0                               /* Opamp offset value (not used).          */ \\r
267   }\r
268 \r
269 /** Configuration of OPA0/1 in inverting amplifier mode.               */\r
270 #define OPA_INIT_INVERTING                                                        \\r
271   {                                                                               \\r
272     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
273     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
274     opaOutModeMain,                 /* Main output enabled.                    */ \\r
275     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
276     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
277     0,                              /* No alternate outputs enabled.           */ \\r
278     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
279     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
280     false,                          /* No low pass filter on pos pad.          */ \\r
281     false,                          /* No low pass filter on neg pad.          */ \\r
282     false,                          /* No nextout output enabled.              */ \\r
283     true,                           /* Neg pad enabled, used as signal input.  */ \\r
284     true,                           /* Pos pad enabled, used as signal ground. */ \\r
285     false,                          /* No shorting of inputs.                  */ \\r
286     false,                          /* Rail-to-rail input enabled.             */ \\r
287     true,                           /* Use factory calibrated opamp offset.    */ \\r
288     0                               /* Opamp offset value (not used).          */ \\r
289   }\r
290 \r
291 /** Configuration of OPA2 in inverting amplifier mode.                 */\r
292 #define OPA_INIT_INVERTING_OPA2                                                   \\r
293   {                                                                               \\r
294     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
295     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
296     opaOutModeMain,                 /* Main output enabled.                    */ \\r
297     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
298     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
299     DAC_OPA0MUX_OUTPEN_OUT0,        /* Alternate output 0 enabled.             */ \\r
300     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
301     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
302     false,                          /* No low pass filter on pos pad.          */ \\r
303     false,                          /* No low pass filter on neg pad.          */ \\r
304     false,                          /* No nextout output enabled.              */ \\r
305     true,                           /* Neg pad enabled, used as signal input.  */ \\r
306     true,                           /* Pos pad enabled, used as signal ground. */ \\r
307     false,                          /* No shorting of inputs.                  */ \\r
308     false,                          /* Rail-to-rail input enabled.             */ \\r
309     true,                           /* Use factory calibrated opamp offset.    */ \\r
310     0                               /* Opamp offset value (not used).          */ \\r
311   }\r
312 \r
313 /** Configuration of OPA0 in cascaded non-inverting amplifier mode.    */\r
314 #define OPA_INIT_CASCADED_NON_INVERTING_OPA0                                      \\r
315   {                                                                               \\r
316     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
317     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
318     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
319     opaResSelR2eq0_33R1,            /* R2 = 1/3 R1                             */ \\r
320     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
321     0,                              /* No alternate outputs enabled.           */ \\r
322     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
323     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
324     false,                          /* No low pass filter on pos pad.          */ \\r
325     false,                          /* No low pass filter on neg pad.          */ \\r
326     true,                           /* Pass output to next stage (OPA1).       */ \\r
327     true,                           /* Neg pad enabled, used as signal ground. */ \\r
328     true,                           /* Pos pad enabled, used as signal input.  */ \\r
329     false,                          /* No shorting of inputs.                  */ \\r
330     false,                          /* Rail-to-rail input enabled.             */ \\r
331     true,                           /* Use factory calibrated opamp offset.    */ \\r
332     0                               /* Opamp offset value (not used).          */ \\r
333   }\r
334 \r
335 /** Configuration of OPA1 in cascaded non-inverting amplifier mode.    */\r
336 #define OPA_INIT_CASCADED_NON_INVERTING_OPA1                                      \\r
337   {                                                                               \\r
338     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
339     opaPosSelOpaIn,                 /* Pos input from OPA0 output.             */ \\r
340     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
341     opaResSelR2eq0_33R1,            /* R2 = 1/3 R1                             */ \\r
342     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
343     0,                              /* No alternate outputs enabled.           */ \\r
344     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
345     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
346     false,                          /* No low pass filter on pos pad.          */ \\r
347     false,                          /* No low pass filter on neg pad.          */ \\r
348     true,                           /* Pass output to next stage (OPA2).       */ \\r
349     true,                           /* Neg pad enabled, used as signal ground. */ \\r
350     false,                          /* Pos pad disabled.                       */ \\r
351     false,                          /* No shorting of inputs.                  */ \\r
352     false,                          /* Rail-to-rail input enabled.             */ \\r
353     true,                           /* Use factory calibrated opamp offset.    */ \\r
354     0                               /* Opamp offset value (not used).          */ \\r
355   }\r
356 \r
357 /** Configuration of OPA2 in cascaded non-inverting amplifier mode.    */\r
358 #define OPA_INIT_CASCADED_NON_INVERTING_OPA2                                      \\r
359   {                                                                               \\r
360     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
361     opaPosSelOpaIn,                 /* Pos input from OPA1 output.             */ \\r
362     opaOutModeMain,                 /* Main output enabled.                    */ \\r
363     opaResSelR2eq0_33R1,            /* R2 = 1/3 R1                             */ \\r
364     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
365     DAC_OPA0MUX_OUTPEN_OUT0,        /* Alternate output 0 enabled.             */ \\r
366     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
367     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
368     false,                          /* No low pass filter on pos pad.          */ \\r
369     false,                          /* No low pass filter on neg pad.          */ \\r
370     false,                          /* No nextout output enabled.              */ \\r
371     true,                           /* Neg pad enabled, used as signal ground. */ \\r
372     false,                          /* Pos pad disabled.                       */ \\r
373     false,                          /* No shorting of inputs.                  */ \\r
374     false,                          /* Rail-to-rail input enabled.             */ \\r
375     true,                           /* Use factory calibrated opamp offset.    */ \\r
376     0                               /* Opamp offset value (not used).          */ \\r
377   }\r
378 \r
379 /** Configuration of OPA0 in cascaded inverting amplifier mode.        */\r
380 #define OPA_INIT_CASCADED_INVERTING_OPA0                                          \\r
381   {                                                                               \\r
382     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
383     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
384     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
385     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
386     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
387     0,                              /* No alternate outputs enabled.           */ \\r
388     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
389     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
390     false,                          /* No low pass filter on pos pad.          */ \\r
391     false,                          /* No low pass filter on neg pad.          */ \\r
392     true,                           /* Pass output to next stage (OPA1).       */ \\r
393     true,                           /* Neg pad enabled, used as signal input.  */ \\r
394     true,                           /* Pos pad enabled, used as signal ground. */ \\r
395     false,                          /* No shorting of inputs.                  */ \\r
396     false,                          /* Rail-to-rail input enabled.             */ \\r
397     true,                           /* Use factory calibrated opamp offset.    */ \\r
398     0                               /* Opamp offset value (not used).          */ \\r
399   }\r
400 \r
401 /** Configuration of OPA1 in cascaded inverting amplifier mode.        */\r
402 #define OPA_INIT_CASCADED_INVERTING_OPA1                                          \\r
403   {                                                                               \\r
404     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
405     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
406     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
407     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
408     opaResInMuxOpaIn,               /* Resistor ladder input from OPA0.        */ \\r
409     0,                              /* No alternate outputs enabled.           */ \\r
410     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
411     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
412     false,                          /* No low pass filter on pos pad.          */ \\r
413     false,                          /* No low pass filter on neg pad.          */ \\r
414     true,                           /* Pass output to next stage (OPA2).       */ \\r
415     false,                          /* Neg pad disabled.                       */ \\r
416     true,                           /* Pos pad enabled, used as signal ground. */ \\r
417     false,                          /* No shorting of inputs.                  */ \\r
418     false,                          /* Rail-to-rail input enabled.             */ \\r
419     true,                           /* Use factory calibrated opamp offset.    */ \\r
420     0                               /* Opamp offset value (not used).          */ \\r
421   }\r
422 \r
423 /** Configuration of OPA2 in cascaded inverting amplifier mode.        */\r
424 #define OPA_INIT_CASCADED_INVERTING_OPA2                                          \\r
425   {                                                                               \\r
426     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
427     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
428     opaOutModeMain,                 /* Main output enabled.                    */ \\r
429     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
430     opaResInMuxOpaIn,               /* Resistor ladder input from OPA1.        */ \\r
431     DAC_OPA0MUX_OUTPEN_OUT0,        /* Alternate output 0 enabled.             */ \\r
432     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
433     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
434     false,                          /* No low pass filter on pos pad.          */ \\r
435     false,                          /* No low pass filter on neg pad.          */ \\r
436     false,                          /* No nextout output enabled.              */ \\r
437     false,                          /* Neg pad disabled.                       */ \\r
438     true,                           /* Pos pad enabled, used as signal ground. */ \\r
439     false,                          /* No shorting of inputs.                  */ \\r
440     false,                          /* Rail-to-rail input enabled.             */ \\r
441     true,                           /* Use factory calibrated opamp offset.    */ \\r
442     0                               /* Opamp offset value (not used).          */ \\r
443   }\r
444 \r
445 /** Configuration of OPA0 in two-opamp differential driver mode.       */\r
446 #define OPA_INIT_DIFF_DRIVER_OPA0                                                 \\r
447   {                                                                               \\r
448     opaNegSelUnityGain,             /* Unity gain.                             */ \\r
449     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
450     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
451     opaResSelDefault,               /* Resistor ladder is not used.            */ \\r
452     opaResInMuxDisable,             /* Resistor ladder disabled.               */ \\r
453     0,                              /* No alternate outputs enabled.           */ \\r
454     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
455     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
456     false,                          /* No low pass filter on pos pad.          */ \\r
457     false,                          /* No low pass filter on neg pad.          */ \\r
458     true,                           /* Pass output to next stage (OPA1).       */ \\r
459     false,                          /* Neg pad disabled.                       */ \\r
460     true,                           /* Pos pad enabled, used as signal input.  */ \\r
461     false,                          /* No shorting of inputs.                  */ \\r
462     false,                          /* Rail-to-rail input enabled.             */ \\r
463     true,                           /* Use factory calibrated opamp offset.    */ \\r
464     0                               /* Opamp offset value (not used).          */ \\r
465   }\r
466 \r
467 /** Configuration of OPA1 in two-opamp differential driver mode.       */\r
468 #define OPA_INIT_DIFF_DRIVER_OPA1                                                 \\r
469   {                                                                               \\r
470     opaNegSelResTap,                /* Neg input from resistor ladder tap.     */ \\r
471     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
472     opaOutModeMain,                 /* Main output enabled.                    */ \\r
473     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
474     opaResInMuxOpaIn,               /* Resistor ladder input from OPA0.        */ \\r
475     0,                              /* No alternate outputs enabled.           */ \\r
476     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
477     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
478     false,                          /* No low pass filter on pos pad.          */ \\r
479     false,                          /* No low pass filter on neg pad.          */ \\r
480     false,                          /* No nextout output enabled.              */ \\r
481     false,                          /* Neg pad disabled.                       */ \\r
482     true,                           /* Pos pad enabled, used as signal ground. */ \\r
483     false,                          /* No shorting of inputs.                  */ \\r
484     false,                          /* Rail-to-rail input enabled.             */ \\r
485     true,                           /* Use factory calibrated opamp offset.    */ \\r
486     0                               /* Opamp offset value (not used).          */ \\r
487   }\r
488 \r
489 /** Configuration of OPA0 in three-opamp differential receiver mode.   */\r
490 #define OPA_INIT_DIFF_RECEIVER_OPA0                                               \\r
491   {                                                                               \\r
492     opaNegSelUnityGain,             /* Unity gain.                             */ \\r
493     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
494     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
495     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
496     opaResInMuxNegPad,              /* Resistor ladder input from neg pad.     */ \\r
497     0,                              /* No alternate outputs enabled.           */ \\r
498     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
499     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
500     false,                          /* No low pass filter on pos pad.          */ \\r
501     false,                          /* No low pass filter on neg pad.          */ \\r
502     true,                           /* Pass output to next stage (OPA2).       */ \\r
503     true,                           /* Neg pad enabled, used as signal ground. */ \\r
504     true,                           /* Pos pad enabled, used as signal input.  */ \\r
505     false,                          /* No shorting of inputs.                  */ \\r
506     false,                          /* Rail-to-rail input enabled.             */ \\r
507     true,                           /* Use factory calibrated opamp offset.    */ \\r
508     0                               /* Opamp offset value (not used).          */ \\r
509   }\r
510 \r
511 /** Configuration of OPA1 in three-opamp differential receiver mode.   */\r
512 #define OPA_INIT_DIFF_RECEIVER_OPA1                                               \\r
513   {                                                                               \\r
514     opaNegSelUnityGain,             /* Unity gain.                             */ \\r
515     opaPosSelPosPad,                /* Pos input from pad.                     */ \\r
516     opaOutModeAll,                  /* Both main and alternate outputs.        */ \\r
517     opaResSelDefault,               /* Resistor ladder is not used.            */ \\r
518     opaResInMuxDisable,             /* Disable resistor ladder.                */ \\r
519     0,                              /* No alternate outputs enabled.           */ \\r
520     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
521     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
522     false,                          /* No low pass filter on pos pad.          */ \\r
523     false,                          /* No low pass filter on neg pad.          */ \\r
524     true,                           /* Pass output to next stage (OPA2).       */ \\r
525     false,                          /* Neg pad disabled.                       */ \\r
526     true,                           /* Pos pad enabled, used as signal input.  */ \\r
527     false,                          /* No shorting of inputs.                  */ \\r
528     false,                          /* Rail-to-rail input enabled.             */ \\r
529     true,                           /* Use factory calibrated opamp offset.    */ \\r
530     0                               /* Opamp offset value (not used).          */ \\r
531   }\r
532 \r
533 /** Configuration of OPA2 in three-opamp differential receiver mode.   */\r
534 #define OPA_INIT_DIFF_RECEIVER_OPA2                                               \\r
535   {                                                                               \\r
536     opaNegSelResTap,                /* Input from resistor ladder tap.         */ \\r
537     opaPosSelResTapOpa0,            /* Input from OPA0 resistor ladder tap.    */ \\r
538     opaOutModeMain,                 /* Main output enabled.                    */ \\r
539     opaResSelR2eqR1,                /* R2 = R1                                 */ \\r
540     opaResInMuxOpaIn,               /* Resistor ladder input from OPA1.        */ \\r
541     DAC_OPA0MUX_OUTPEN_OUT0,        /* Enable alternate output 0.              */ \\r
542     _DAC_BIASPROG_BIASPROG_DEFAULT, /* Default bias setting.             */       \\r
543     _DAC_BIASPROG_HALFBIAS_DEFAULT, /* Default half-bias setting.        */       \\r
544     false,                          /* No low pass filter on pos pad.          */ \\r
545     false,                          /* No low pass filter on neg pad.          */ \\r
546     false,                          /* No nextout output enabled.              */ \\r
547     false,                          /* Neg pad disabled.                       */ \\r
548     false,                          /* Pos pad disabled.                       */ \\r
549     false,                          /* No shorting of inputs.                  */ \\r
550     false,                          /* Rail-to-rail input enabled.             */ \\r
551     true,                           /* Use factory calibrated opamp offset.    */ \\r
552     0                               /* Opamp offset value (not used).          */ \\r
553   }\r
554 \r
555 /*******************************************************************************\r
556  *****************************   PROTOTYPES   **********************************\r
557  ******************************************************************************/\r
558 \r
559 void      OPAMP_Disable(DAC_TypeDef *dac, OPAMP_TypeDef opa);\r
560 void      OPAMP_Enable(DAC_TypeDef *dac, OPAMP_TypeDef opa, const OPAMP_Init_TypeDef *init);\r
561 \r
562 /** @} (end addtogroup OPAMP) */\r
563 /** @} (end addtogroup EM_Library) */\r
564 \r
565 #ifdef __cplusplus\r
566 }\r
567 #endif\r
568 \r
569 #endif /* defined( OPAMP_PRESENT ) && ( OPAMP_COUNT == 1 ) */\r
570 #endif /* __SILICON_LABS_EM_OPAMP_H_ */\r