OPAMPEMLIB
Detailed Description
Operational Amplifier (OPAMP) peripheral API.
This module contains functions to:
- OPAMP_Enable() Configure and enable an opamp.
- OPAMP_Disable() Disable an opamp.
All OPAMP functions assume that the DAC clock is running. If the DAC is not used, the clock can be turned off when the opamp's are configured.
If the available gain values dont suit the application at hand, the resistor ladders can be disabled and external gain programming resistors used.
A number of predefined opamp setup macros are available for configuration of the most common opamp topologies (see figures below).
- Note
- The terms POSPAD and NEGPAD in the figures are used to indicate that these pads should be connected to a suitable signal ground.
Unity gain voltage follower.
Use predefined macros
OPA_INIT_UNITY_GAIN
and
OPA_INIT_UNITY_GAIN_OPA2
.
|\ ___________|+\ | \_______ ___|_ / | | | / | | |/ | |___________|
Non-inverting amplifier.
Use predefined macros
OPA_INIT_NON_INVERTING
and
OPA_INIT_NON_INVERTING_OPA2
.
|\ ___________|+\ | \_______ ___|_ / | | | / | | |/ | |_____R2____| | R1 | NEGPAD
Inverting amplifier.
Use predefined macros
OPA_INIT_INVERTING
and
OPA_INIT_INVERTING_OPA2
.
_____R2____ | | | |\ | ____R1_|___|_\ | | \____|___ ___| / | |+/ | |/ | POSPAD
Cascaded non-inverting amplifiers.
Use predefined macros
OPA_INIT_CASCADED_NON_INVERTING_OPA0
,
OPA_INIT_CASCADED_NON_INVERTING_OPA1
and
OPA_INIT_CASCADED_NON_INVERTING_OPA2
.
|\ |\ |\ ___________|+\ OPA0 ___________|+\ OPA1 ___________|+\ OPA2 | \_________| | \_________| | \_______ ___|_ / | ___|_ / | ___|_ / | | | / | | | / | | | / | | |/ | | |/ | | |/ | |_____R2____| |_____R2____| |_____R2____| | | | R1 R1 R1 | | | NEGPAD NEGPAD NEGPAD
Cascaded inverting amplifiers.
Use predefined macros
OPA_INIT_CASCADED_INVERTING_OPA0
,
OPA_INIT_CASCADED_INVERTING_OPA1
and
OPA_INIT_CASCADED_INVERTING_OPA2
.
_____R2____ _____R2____ _____R2____ | | | | | | | |\ | | |\ | | |\ | ____R1_|___|_\ | ____R1_|___|_\ | ____R1_|___|_\ | | \____|____| | \____|___| | \____|__ ___| / ___| / ___| / | |+/ OPA0 | |+/ OPA1 | |+/ OPA2 | |/ | |/ | |/ | | | POSPAD POSPAD POSPAD
Differential driver with two opamp's.
Use predefined macros
OPA_INIT_DIFF_DRIVER_OPA0
and
OPA_INIT_DIFF_DRIVER_OPA1
.
__________________________ | + | _____R2____ |\ | | | ___________|+\ OPA0 | | |\ OPA1 | | \_________|____R1_|___|_\ | _ ___|_ / | | \____|______ | | / | ___| / | |/ | | |+/ |________________| | |/ | POSPAD
Differential receiver with three opamp's.
Use predefined macros
OPA_INIT_DIFF_RECEIVER_OPA0
,
OPA_INIT_DIFF_RECEIVER_OPA1
and
OPA_INIT_DIFF_RECEIVER_OPA2
.
|\ __________|+\ OPA1 _ | \_________ ___|_ / | | _____R2____ | | / | | | | | |/ | | | |\ | |___________| |____R1_|___|_\ | | \____|___ |\ ____R1_ ___| / +__________|+\ OPA0 | | |+/ OPA2 | \_________| | |/ ___|_ / | R2 | | / | | | |/ | NEGPAD OPA0 |___________|
Data Structures |
|
struct | OPAMP_Init_TypeDef |
Macros |
|
#define | OPA_INIT_CASCADED_INVERTING_OPA0 |
#define | OPA_INIT_CASCADED_INVERTING_OPA1 |
#define | OPA_INIT_CASCADED_INVERTING_OPA2 |
#define | OPA_INIT_CASCADED_NON_INVERTING_OPA0 |
#define | OPA_INIT_CASCADED_NON_INVERTING_OPA1 |
#define | OPA_INIT_CASCADED_NON_INVERTING_OPA2 |
#define | OPA_INIT_DIFF_DRIVER_OPA0 |
#define | OPA_INIT_DIFF_DRIVER_OPA1 |
#define | OPA_INIT_DIFF_RECEIVER_OPA0 |
#define | OPA_INIT_DIFF_RECEIVER_OPA1 |
#define | OPA_INIT_DIFF_RECEIVER_OPA2 |
#define | OPA_INIT_INVERTING |
#define | OPA_INIT_INVERTING_OPA2 |
#define | OPA_INIT_NON_INVERTING |
#define | OPA_INIT_NON_INVERTING_OPA2 |
#define | OPA_INIT_UNITY_GAIN |
#define | OPA_INIT_UNITY_GAIN_OPA2 |
Enumerations |
|
enum |
OPAMP_NegSel_TypeDef
{
opaNegSelDisable = DAC_OPA0MUX_NEGSEL_DISABLE, opaNegSelUnityGain = DAC_OPA0MUX_NEGSEL_UG, opaNegSelResTap = DAC_OPA0MUX_NEGSEL_OPATAP, opaNegSelNegPad = DAC_OPA0MUX_NEGSEL_NEGPAD } |
enum |
OPAMP_OutMode_TypeDef
{
opaOutModeDisable = DAC_OPA0MUX_OUTMODE_DISABLE, opaOutModeMain = DAC_OPA0MUX_OUTMODE_MAIN, opaOutModeAlt = DAC_OPA0MUX_OUTMODE_ALT, opaOutModeAll = DAC_OPA0MUX_OUTMODE_ALL } |
enum |
OPAMP_PosSel_TypeDef
{
opaPosSelDisable = DAC_OPA0MUX_POSSEL_DISABLE, opaPosSelDac = DAC_OPA0MUX_POSSEL_DAC, opaPosSelPosPad = DAC_OPA0MUX_POSSEL_POSPAD, opaPosSelOpaIn = DAC_OPA0MUX_POSSEL_OPA0INP, opaPosSelResTapOpa0 = DAC_OPA0MUX_POSSEL_OPATAP } |
enum |
OPAMP_ResInMux_TypeDef
{
opaResInMuxDisable = DAC_OPA0MUX_RESINMUX_DISABLE, opaResInMuxOpaIn = DAC_OPA0MUX_RESINMUX_OPA0INP, opaResInMuxNegPad = DAC_OPA0MUX_RESINMUX_NEGPAD, opaResInMuxPosPad = DAC_OPA0MUX_RESINMUX_POSPAD, opaResInMuxVss = DAC_OPA0MUX_RESINMUX_VSS } |
enum |
OPAMP_ResSel_TypeDef
{
opaResSelDefault = DAC_OPA0MUX_RESSEL_DEFAULT, opaResSelR2eq0_33R1 = DAC_OPA0MUX_RESSEL_RES0, opaResSelR2eqR1 = DAC_OPA0MUX_RESSEL_RES1, opaResSelR1eq1_67R1 = DAC_OPA0MUX_RESSEL_RES2, opaResSelR2eq2R1 = DAC_OPA0MUX_RESSEL_RES3, opaResSelR2eq3R1 = DAC_OPA0MUX_RESSEL_RES4, opaResSelR2eq4_33R1 = DAC_OPA0MUX_RESSEL_RES5, opaResSelR2eq7R1 = DAC_OPA0MUX_RESSEL_RES6, opaResSelR2eq15R1 = DAC_OPA0MUX_RESSEL_RES7 } |
enum |
OPAMP_TypeDef
{
OPA0 = 0, OPA1 = 1, OPA2 = 2 } |
Functions |
|
void | OPAMP_Disable ( DAC_TypeDef *dac, OPAMP_TypeDef opa) |
Disable an Operational Amplifier.
|
|
void | OPAMP_Enable ( DAC_TypeDef *dac, OPAMP_TypeDef opa, const OPAMP_Init_TypeDef *init) |
Configure and enable an Operational Amplifier.
|
|
Macro Definition Documentation
#define OPA_INIT_CASCADED_INVERTING_OPA0 |
Configuration of OPA0 in cascaded inverting amplifier mode.
Definition at line
725
of file
em_opamp.h
.
#define OPA_INIT_CASCADED_INVERTING_OPA1 |
Configuration of OPA1 in cascaded inverting amplifier mode.
Definition at line
747
of file
em_opamp.h
.
#define OPA_INIT_CASCADED_INVERTING_OPA2 |
Configuration of OPA2 in cascaded inverting amplifier mode.
Definition at line
769
of file
em_opamp.h
.
#define OPA_INIT_CASCADED_NON_INVERTING_OPA0 |
Configuration of OPA0 in cascaded non-inverting amplifier mode.
Definition at line
659
of file
em_opamp.h
.
#define OPA_INIT_CASCADED_NON_INVERTING_OPA1 |
Configuration of OPA1 in cascaded non-inverting amplifier mode.
Definition at line
681
of file
em_opamp.h
.
#define OPA_INIT_CASCADED_NON_INVERTING_OPA2 |
Configuration of OPA2 in cascaded non-inverting amplifier mode.
Definition at line
703
of file
em_opamp.h
.
#define OPA_INIT_DIFF_DRIVER_OPA0 |
Configuration of OPA0 in two-opamp differential driver mode.
Definition at line
791
of file
em_opamp.h
.
#define OPA_INIT_DIFF_DRIVER_OPA1 |
Configuration of OPA1 in two-opamp differential driver mode.
Definition at line
813
of file
em_opamp.h
.
#define OPA_INIT_DIFF_RECEIVER_OPA0 |
Configuration of OPA0 in three-opamp differential receiver mode.
Definition at line
835
of file
em_opamp.h
.
#define OPA_INIT_DIFF_RECEIVER_OPA1 |
Configuration of OPA1 in three-opamp differential receiver mode.
Definition at line
857
of file
em_opamp.h
.
#define OPA_INIT_DIFF_RECEIVER_OPA2 |
Configuration of OPA2 in three-opamp differential receiver mode.
Definition at line
879
of file
em_opamp.h
.
#define OPA_INIT_INVERTING |
Configuration of OPA0/1 in inverting amplifier mode.
Definition at line
615
of file
em_opamp.h
.
#define OPA_INIT_INVERTING_OPA2 |
Configuration of OPA2 in inverting amplifier mode.
Definition at line
637
of file
em_opamp.h
.
#define OPA_INIT_NON_INVERTING |
Configuration of OPA0/1 in non-inverting amplifier mode.
Definition at line
571
of file
em_opamp.h
.
#define OPA_INIT_NON_INVERTING_OPA2 |
Configuration of OPA2 in non-inverting amplifier mode.
Definition at line
593
of file
em_opamp.h
.
#define OPA_INIT_UNITY_GAIN |
Configuration of OPA0/1 in unity gain voltage follower mode.
Definition at line
527
of file
em_opamp.h
.
#define OPA_INIT_UNITY_GAIN_OPA2 |
Configuration of OPA2 in unity gain voltage follower mode.
Definition at line
549
of file
em_opamp.h
.
Enumeration Type Documentation
enum OPAMP_NegSel_TypeDef |
enum OPAMP_PosSel_TypeDef |
OPAMP positive terminal input selection values.
Definition at line
177
of file
em_opamp.h
.
OPAMP resistor ladder input selector values.
Definition at line
362
of file
em_opamp.h
.
enum OPAMP_ResSel_TypeDef |
OPAMP gain values.
Definition at line
337
of file
em_opamp.h
.
enum OPAMP_TypeDef |
Function Documentation
void OPAMP_Disable | ( | DAC_TypeDef * |
dac,
|
OPAMP_TypeDef |
opa
|
||
) |
Disable an Operational Amplifier.
- Parameters
-
[in] dac
Pointer to DAC peripheral register block. [in] opa
Selects an OPA, valid vaules are OPA0 , OPA1 and OPA2 .
Definition at line
260
of file
em_opamp.c
.
References DAC_CH0CTRL_EN , DAC_CH1CTRL_EN , DAC_OPACTRL_OPA0EN , DAC_OPACTRL_OPA1EN , DAC_OPACTRL_OPA2EN , OPA0 , and OPA1 .
Referenced by OPAMP_Enable() .
void OPAMP_Enable | ( | DAC_TypeDef * |
dac,
|
OPAMP_TypeDef |
opa,
|
||
const OPAMP_Init_TypeDef * |
init
|
||
) |
Configure and enable an Operational Amplifier.
- Note
-
The value of the alternate output enable bit mask in the
OPAMP_Init_TypeDef
structure should consist of one or more of the DAC_OPA[opa#]MUX_OUTPEN_OUT[output#] flags (defined in <part_name>_dac.h) OR'ed together.
For OPA0:- DAC_OPA0MUX_OUTPEN_OUT0
- DAC_OPA0MUX_OUTPEN_OUT1
- DAC_OPA0MUX_OUTPEN_OUT2
- DAC_OPA0MUX_OUTPEN_OUT3
- DAC_OPA0MUX_OUTPEN_OUT4
- DAC_OPA1MUX_OUTPEN_OUT0
- DAC_OPA1MUX_OUTPEN_OUT1
- DAC_OPA1MUX_OUTPEN_OUT2
- DAC_OPA1MUX_OUTPEN_OUT3
- DAC_OPA1MUX_OUTPEN_OUT4
- DAC_OPA2MUX_OUTPEN_OUT0
- DAC_OPA2MUX_OUTPEN_OUT1
init.outPen = DAC_OPA0MUX_OUTPEN_OUT0 | DAC_OPA0MUX_OUTPEN_OUT4;
- Parameters
-
[in] dac
Pointer to DAC peripheral register block. [in] opa
Selects an OPA, valid vaules are OPA0 , OPA1 and OPA2 . [in] init
Pointer to a structure containing OPAMP init information.
Definition at line
365
of file
em_opamp.c
.
References _DAC_BIASPROG_BIASPROG_MASK , _DAC_BIASPROG_BIASPROG_SHIFT , _DAC_BIASPROG_OPA2BIASPROG_MASK , _DAC_BIASPROG_OPA2BIASPROG_SHIFT , _DAC_CAL_CH0OFFSET_MASK , _DAC_CAL_CH0OFFSET_SHIFT , _DAC_CAL_CH1OFFSET_MASK , _DAC_CAL_CH1OFFSET_SHIFT , _DAC_CAL_GAIN_MASK , _DAC_OPA0MUX_OUTPEN_MASK , _DAC_OPA1MUX_OUTPEN_MASK , _DAC_OPA2MUX_OUTPEN_MASK , _DAC_OPACTRL_OPA0LPFDIS_MASK , _DAC_OPACTRL_OPA1LPFDIS_MASK , _DAC_OPACTRL_OPA2LPFDIS_MASK , _DAC_OPAOFFSET_OPA2OFFSET_MASK , _DAC_OPAOFFSET_OPA2OFFSET_SHIFT , OPAMP_Init_TypeDef::bias , DAC_BIASPROG_HALFBIAS , DAC_BIASPROG_OPA2HALFBIAS , DAC_CH0CTRL_EN , DAC_CH1CTRL_EN , DAC_OPA0MUX_NEXTOUT , DAC_OPA0MUX_NPEN , DAC_OPA0MUX_PPEN , DAC_OPA1MUX_NEXTOUT , DAC_OPA1MUX_NPEN , DAC_OPA1MUX_PPEN , DAC_OPA2MUX_NEXTOUT , DAC_OPA2MUX_NPEN , DAC_OPA2MUX_OUTMODE , DAC_OPA2MUX_POSSEL_DISABLE , DAC_OPA2MUX_POSSEL_OPA1INP , DAC_OPA2MUX_POSSEL_OPATAP , DAC_OPA2MUX_POSSEL_POSPAD , DAC_OPA2MUX_PPEN , DAC_OPACTRL_OPA0EN , DAC_OPACTRL_OPA0HCMDIS , DAC_OPACTRL_OPA0LPFDIS_NLPFDIS , DAC_OPACTRL_OPA0LPFDIS_PLPFDIS , DAC_OPACTRL_OPA0SHORT , DAC_OPACTRL_OPA1EN , DAC_OPACTRL_OPA1HCMDIS , DAC_OPACTRL_OPA1LPFDIS_NLPFDIS , DAC_OPACTRL_OPA1LPFDIS_PLPFDIS , DAC_OPACTRL_OPA1SHORT , DAC_OPACTRL_OPA2EN , DAC_OPACTRL_OPA2HCMDIS , DAC_OPACTRL_OPA2LPFDIS_NLPFDIS , DAC_OPACTRL_OPA2LPFDIS_PLPFDIS , DAC_OPACTRL_OPA2SHORT , OPAMP_Init_TypeDef::defaultOffset , DEVINFO , OPAMP_Init_TypeDef::halfBias , OPAMP_Init_TypeDef::hcmDisable , OPAMP_Init_TypeDef::lpfNegPadDisable , OPAMP_Init_TypeDef::lpfPosPadDisable , OPAMP_Init_TypeDef::negSel , OPAMP_Init_TypeDef::nextOut , OPAMP_Init_TypeDef::npEn , OPAMP_Init_TypeDef::offset , OPA0 , OPA1 , OPA2 , OPAMP_Disable() , opaNegSelResTap , OPAMP_Init_TypeDef::outMode , OPAMP_Init_TypeDef::outPen , OPAMP_Init_TypeDef::posSel , OPAMP_Init_TypeDef::ppEn , OPAMP_Init_TypeDef::resInMux , OPAMP_Init_TypeDef::resSel , OPAMP_Init_TypeDef::shortInputs , and SYSTEM_GetCalibrationValue() .