View source for Component: DAC Dual (MCP49x2) (Analog Output)



{| width="50%"
|-
| width="20%" style="color: gray;" | Author
| Matrix TSL
|-
| width="20%" style="color: gray;" | Version
| 1.0 (Release)
|-
| width="20%" style="color: gray;" | Category
| Analog Output
|}



==[[File:Component Icon b66f5769_5e9d_40e7_9159_c6a0552ff86e.png|Image]] DAC Dual (MCP49x2) component==
Component to drive a dual digital to analogue converter (DAC) IC from Microchip via an SPI interface.
Compatible with MCP4902 (8-Bit), MCP4912 (10-Bit) and MCP4922 (12-Bit) devices.

==Examples==
''<span style="color:red;">No additional examples</span>''


==Downloadable macro reference==

===<span style="font-weight: normal;"><u><tt>SetOutput</tt></u></span>===
Sets the output voltage of the DAC

8-Bit: Range 0-255

10-Bit: Range 0-1023

12-Bit: Range 0-4095

'''Parameters'''

:[[Variable Types|BYTE]] ''Channel''
::0=DAC Channel 0 , 1=DAC Channel 1

:[[Variable Types|UINT]] ''DAC_Value''
::The value to output to the DAC


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>ControlPins</tt></u></span>===
Allows Shutdown (SHDN) and Latch (LDAC) pins to be controlled directly if enabled.

'''Parameters'''

:[[Variable Types|BOOL]] ''Shutdown''
::0 = Shutdown Device, 1 = Device Active

:[[Variable Types|BOOL]] ''Latch''
::0 = Data output driven from DAC register, 1 = Data output locked


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>Disable</tt></u></span>===
Disables the DAC output.

'''Parameters'''

:[[Variable Types|BYTE]] ''Channel''
::0=DAC Channel 0 , 1=DAC Channel 1


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>Enable</tt></u></span>===
Enables the DAC Output.

'''Parameters'''

:[[Variable Types|BYTE]] ''Channel''
::0=DAC Channel 0 , 1=DAC Channel 1


'''Return value'''

:''This call does not return a value''


===<span style="font-weight: normal;"><u><tt>Initialise</tt></u></span>===
Configures the SPI peripheral ready for communications and initialises the internal variables. DAC needs to be enabled before any output voltage can be generated.

'''Parameters'''

:''This macro has no parameters''


'''Return value'''

:''This call does not return a value''



==Simulation macro reference==

''This component does not contain any simulation macros''


==Property reference==
<span style="font-weight: normal;"><u>DAC IC</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''DAC_IC''.

Selects which DAC IC is connected and therefore the bit depth available.

<span style="font-weight: normal;"><u>Gain Option</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''GainOP''.

Selects the maximum reference value for the DAC

<span style="font-weight: normal;"><u>Vref Voltage</u></span>

This property is of type ''Floating point'' and can be referenced with the variable name ''VrefVol''.

Reference Voltage, Used to calculate the Voltage resolution.

<span style="font-weight: normal;"><u>Steps</u></span>

This property is of type ''Unsigned integer'' and can be referenced with the variable name ''Steps''.

Number of discrete output states available from the DAC.

<span style="font-weight: normal;"><u>Control Bits</u></span>

This property is of type ''Signed integer'' and can be referenced with the variable name ''BITS''.

Number of digital control bits

<span style="font-weight: normal;"><u>Resolution</u></span>

This property is of type ''Line of text'' and can be referenced with the variable name ''Res''.

Maximum output resolution based on number of control bits.

<span style="font-weight: normal;"><u>Voltage Resolution</u></span>

This property is of type ''Floating point'' and can be referenced with the variable name ''VoltRes''.

Specifies the Resolution per digital bit in terms of Voltage.

<span style="font-weight: normal;"><u>Channel</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_spi1::CHANNEL''.

SPI Channel selector

<span style="font-weight: normal;"><u>Prescale</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_spi1::PR_SCALE''.

Prescale option selector

<span style="font-weight: normal;"><u>MOSI</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_spi1::MOSI''.

SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.

<span style="font-weight: normal;"><u>MISO</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_spi1::MISO''.

SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.

<span style="font-weight: normal;"><u>CLK</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_spi1::CLK''.

SPI Clock Pin CLK - The Clock signal is driven by the SPI master.

<span style="font-weight: normal;"><u>CS / SS</u></span>

This property is of type ''Single digital pin'' and can be referenced with the variable name ''cal_spi1::SS''.

Chip Select / Slave Select Pin 

Master Mode: General purpose output pin used to select the remote SPI device.

Slave Mode: Hardware chip select pin input used to select the SPI device.

<span style="font-weight: normal;"><u>Use SHDN Pin</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''UseSHDN''.

Allows the SHDN pin to be driven from an output pin on the microcontroller.

If not used then tie the SHDN pin to VCC to allow the DAC to function.

<span style="font-weight: normal;"><u>Use LDAC Pin</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''UseLDAC''.

Allows the LDAC pin to be driven from an output pin on the microcontroller.

If not used then tie the LDAC pin to GND to allow the DAC to function.

<span style="font-weight: normal;"><u>DAC Output Scope Traces</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''ScopeTraces''.

Selects if the scope traces are automatically generated or not

<span style="font-weight: normal;"><u>SPI Scope Traces</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''cal_spi1::ScopeTraces''.

Selects if the scope traces are automatically generated or not

<span style="font-weight: normal;"><u>SPI Console Data</u></span>

This property is of type ''True or false'' and can be referenced with the variable name ''cal_spi1::ConsoleData''.

Selects if the console data is automatically generated or not

<span style="font-weight: normal;"><u>Injector</u></span>

This property is of type ''Fixed list of ints'' and can be referenced with the variable name ''cal_spi1::Injector''.

''<span style="color:red;">No additional information</span>''