Difference between revisions of "Component: ADC Template 2D (Analog Input)"

Revision as of 10:00, 27 January 2023

Author	Matrix Ltd
Version	1.3
Category	Analog Input

ADC Template 2D component

Base ADC component with no graphical interface. Contains all of the embedded side component calls to provide an ADC interface suitable for wrapping with a new ADC style component.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_adc_Base_2dgdi.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_adc_Base_2dgdi.fcfx

Detailed description

No detailed description exists yet for this component

Examples

Macro reference

	RawSampleInt
Background call to read the ADC at full bit depth Call Enable() first
- UINT	Return

	RawAverageByte
Background call to read the ADC as a byte average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	GetSampleBits
Gets the number of bits per sample
- BYTE	Return

	GetString
Reads the ADC as a direct voltage and returns as a string
- STRING	Return

	GetAverageByte
Function call to read the ADC as a byte average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	RawAverageInt
Background call to read the ADC as a full width average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs

- INT	Return

	GetSpeedFilter
Gets the Conversion speed filter string Use in Component.Property.SetFilter()
- STRING	Return

	GetAverageInt
Function call to read the ADC as a full width average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- UINT	Return

	SetProperties
Set the VRef options and voltage, ConvSpeed and AcqTime for the ADC component.
- INT	VRef10Ms
Voltage Reference x10 mV - Default 500 = 5V
- BOOL	VRefOpt
External VRef 0=Disabled, 1=Enabled
- INT	ConvSpdOpt
Conversion Speed Setting - Refer to numbered list
- INT	Aquisitions
Aquisition time in micro seconds to precharge before sampling
- VOID	Return

	GetVoltage
Reads the ADC as a direct voltage
- FLOAT	Return

	RawEnable
Enables and configures the ADC channel to be an analogue input. Only one ADC channel can be enabled at a time. Any RAW functions will reference the last enabled channel only.
- VOID	Return

	SetChannel
Sets the channel ID for the component
- INT	ChannelId
Chaannel starting at 0, -1 is unconnected
- VOID	Return

	RawSampleByte
Background call to read the ADC as a byte Call Enable() before this
- BYTE	Return

	GetInt
Blocking call to read the ADC at full bit depth
- UINT	Return

	RawDisable
Disables the previously enabled ADC channel and converts back to digital mode.
- VOID	Return

	GetByte
Blocking call to read the ADC as a byte
- BYTE	Return

Property reference

	Properties
	Connections
	Channel
Analogue Input Channel - Which pin is the analogue input connected to?
	Settings
	VRef voltage
Used by the GetVoltage or GetString component macros to take an ADC reading and convert it into a Voltage. +VRef voltage x 10mV Default 500 = 5.0V
	VRef option
Defines what is used as the ADC maximum reference. ADC Range = GND to VRef Voltage VDD - Defines the microcontrollers power supply pin as the max reference, VREF+ Pin - Dedicated pin on the microcontroller to allow for a variable reference voltage.
	Conversion speed
Clock setting to select how fast the ADC peripheral will perform an ADC conversion. The FRC setting is based on a RC time base and so will vary with temperature and pressure. Other settings are generally based on divisions of the master clock.
	Acquisition cycles
Number of micro seconds to wait for the ADC input to charge before starting the analogue sample.
	Bit Depth
Maximum number of digital bits the ADC can sample. 8 bit = ADC range 0 - 255 10 bit = ADC range 0 - 1023 12 bit = ADC range 0 - 4095
	Simulation
	Scope Traces
Selects if the scope traces are automatically generated or not

==Macro reference==

	RawSampleInt
Background call to read the ADC at full bit depth Call Enable() first
- UINT	Return

	RawAverageByte
Background call to read the ADC as a byte average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	GetSampleBits
Gets the number of bits per sample
- BYTE	Return

	GetString
Reads the ADC as a direct voltage and returns as a string
- STRING	Return

	GetAverageByte
Function call to read the ADC as a byte average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	RawAverageInt
Background call to read the ADC as a full width average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs

- INT	Return

	GetSpeedFilter
Gets the Conversion speed filter string Use in Component.Property.SetFilter()
- STRING	Return

	GetAverageInt
Function call to read the ADC as a full width average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- UINT	Return

	SetProperties
Set the VRef options and voltage, ConvSpeed and AcqTime for the ADC component.
- INT	VRef10Ms
Voltage Reference x10 mV - Default 500 = 5V
- BOOL	VRefOpt
External VRef 0=Disabled, 1=Enabled
- INT	ConvSpdOpt
Conversion Speed Setting - Refer to numbered list
- INT	Aquisitions
Aquisition time in micro seconds to precharge before sampling
- VOID	Return

	GetVoltage
Reads the ADC as a direct voltage
- FLOAT	Return

	RawEnable
Enables and configures the ADC channel to be an analogue input. Only one ADC channel can be enabled at a time. Any RAW functions will reference the last enabled channel only.
- VOID	Return

	SetChannel
Sets the channel ID for the component
- INT	ChannelId
Chaannel starting at 0, -1 is unconnected
- VOID	Return

	RawSampleByte
Background call to read the ADC as a byte Call Enable() before this
- BYTE	Return

	GetInt
Blocking call to read the ADC at full bit depth
- UINT	Return

	RawDisable
Disables the previously enabled ADC channel and converts back to digital mode.
- VOID	Return

	GetByte
Blocking call to read the ADC as a byte
- BYTE	Return

Property reference

	Properties
	Connections
	Channel
Analogue Input Channel - Which pin is the analogue input connected to?
	Settings
	VRef voltage
Used by the GetVoltage or GetString component macros to take an ADC reading and convert it into a Voltage. +VRef voltage x 10mV Default 500 = 5.0V
	VRef option
Defines what is used as the ADC maximum reference. ADC Range = GND to VRef Voltage VDD - Defines the microcontrollers power supply pin as the max reference, VREF+ Pin - Dedicated pin on the microcontroller to allow for a variable reference voltage.
	Conversion speed
Clock setting to select how fast the ADC peripheral will perform an ADC conversion. The FRC setting is based on a RC time base and so will vary with temperature and pressure. Other settings are generally based on divisions of the master clock.
	Acquisition cycles
Number of micro seconds to wait for the ADC input to charge before starting the analogue sample.
	Bit Depth
Maximum number of digital bits the ADC can sample. 8 bit = ADC range 0 - 255 10 bit = ADC range 0 - 1023 12 bit = ADC range 0 - 4095
	Simulation
	Scope Traces
Selects if the scope traces are automatically generated or not

==Macro reference==

	RawSampleInt
Background call to read the ADC at full bit depth Call Enable() first
- UINT	Return

	RawAverageByte
Background call to read the ADC as a byte average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	GetSampleBits
Gets the number of bits per sample
- BYTE	Return

	GetString
Reads the ADC as a direct voltage and returns as a string
- STRING	Return

	GetAverageByte
Function call to read the ADC as a byte average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	RawAverageInt
Background call to read the ADC as a full width average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs

- INT	Return

	GetSpeedFilter
Gets the Conversion speed filter string Use in Component.Property.SetFilter()
- STRING	Return

	GetAverageInt
Function call to read the ADC as a full width average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- UINT	Return

	SetProperties
Set the VRef options and voltage, ConvSpeed and AcqTime for the ADC component.
- INT	VRef10Ms
Voltage Reference x10 mV - Default 500 = 5V
- BOOL	VRefOpt
External VRef 0=Disabled, 1=Enabled
- INT	ConvSpdOpt
Conversion Speed Setting - Refer to numbered list
- INT	Aquisitions
Aquisition time in micro seconds to precharge before sampling
- VOID	Return

	GetVoltage
Reads the ADC as a direct voltage
- FLOAT	Return

	RawEnable
Enables and configures the ADC channel to be an analogue input. Only one ADC channel can be enabled at a time. Any RAW functions will reference the last enabled channel only.
- VOID	Return

	SetChannel
Sets the channel ID for the component
- INT	ChannelId
Chaannel starting at 0, -1 is unconnected
- VOID	Return

	RawSampleByte
Background call to read the ADC as a byte Call Enable() before this
- BYTE	Return

	GetInt
Blocking call to read the ADC at full bit depth
- UINT	Return

	RawDisable
Disables the previously enabled ADC channel and converts back to digital mode.
- VOID	Return

	GetByte
Blocking call to read the ADC as a byte
- BYTE	Return

Property reference

	Properties
	Connections
	Channel
Analogue Input Channel - Which pin is the analogue input connected to?
	Settings
	VRef voltage
Used by the GetVoltage or GetString component macros to take an ADC reading and convert it into a Voltage. +VRef voltage x 10mV Default 500 = 5.0V
	VRef option
Defines what is used as the ADC maximum reference. ADC Range = GND to VRef Voltage VDD - Defines the microcontrollers power supply pin as the max reference, VREF+ Pin - Dedicated pin on the microcontroller to allow for a variable reference voltage.
	Conversion speed
Clock setting to select how fast the ADC peripheral will perform an ADC conversion. The FRC setting is based on a RC time base and so will vary with temperature and pressure. Other settings are generally based on divisions of the master clock.
	Acquisition cycles
Number of micro seconds to wait for the ADC input to charge before starting the analogue sample.
	Bit Depth
Maximum number of digital bits the ADC can sample. 8 bit = ADC range 0 - 255 10 bit = ADC range 0 - 1023 12 bit = ADC range 0 - 4095
	Simulation
	Scope Traces
Selects if the scope traces are automatically generated or not

==Macro reference==

	RawSampleInt
Background call to read the ADC at full bit depth Call Enable() first
- UINT	Return

	RawAverageByte
Background call to read the ADC as a byte average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	GetSampleBits
Gets the number of bits per sample
- BYTE	Return

	GetString
Reads the ADC as a direct voltage and returns as a string
- STRING	Return

	GetAverageByte
Function call to read the ADC as a byte average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- BYTE	Return

	RawAverageInt
Background call to read the ADC as a full width average sample over time Call Enable() before this
- BYTE	NumSamples

- BYTE	DelayUs

- INT	Return

	GetSpeedFilter
Gets the Conversion speed filter string Use in Component.Property.SetFilter()
- STRING	Return

	GetAverageInt
Function call to read the ADC as a full width average sample over time
- BYTE	NumSamples

- BYTE	DelayUs
Number of micro seconds in between taking each sample
- UINT	Return

	SetProperties
Set the VRef options and voltage, ConvSpeed and AcqTime for the ADC component.
- INT	VRef10Ms
Voltage Reference x10 mV - Default 500 = 5V
- BOOL	VRefOpt
External VRef 0=Disabled, 1=Enabled
- INT	ConvSpdOpt
Conversion Speed Setting - Refer to numbered list
- INT	Aquisitions
Aquisition time in micro seconds to precharge before sampling
- VOID	Return

	GetVoltage
Reads the ADC as a direct voltage
- FLOAT	Return

	RawEnable
Enables and configures the ADC channel to be an analogue input. Only one ADC channel can be enabled at a time. Any RAW functions will reference the last enabled channel only.
- VOID	Return

	SetChannel
Sets the channel ID for the component
- INT	ChannelId
Chaannel starting at 0, -1 is unconnected
- VOID	Return

	RawSampleByte
Background call to read the ADC as a byte Call Enable() before this
- BYTE	Return

	GetInt
Blocking call to read the ADC at full bit depth
- UINT	Return

	RawDisable
Disables the previously enabled ADC channel and converts back to digital mode.
- VOID	Return

	GetByte
Blocking call to read the ADC as a byte
- BYTE	Return

Property reference

	Properties
	Connections
	Channel
Analogue Input Channel - Which pin is the analogue input connected to?
	Settings
	VRef voltage
Used by the GetVoltage or GetString component macros to take an ADC reading and convert it into a Voltage. +VRef voltage x 10mV Default 500 = 5.0V
	VRef option
Defines what is used as the ADC maximum reference. ADC Range = GND to VRef Voltage VDD - Defines the microcontrollers power supply pin as the max reference, VREF+ Pin - Dedicated pin on the microcontroller to allow for a variable reference voltage.
	Conversion speed
Clock setting to select how fast the ADC peripheral will perform an ADC conversion. The FRC setting is based on a RC time base and so will vary with temperature and pressure. Other settings are generally based on divisions of the master clock.
	Acquisition cycles
Number of micro seconds to wait for the ADC input to charge before starting the analogue sample.
	Bit Depth
Maximum number of digital bits the ADC can sample. 8 bit = ADC range 0 - 255 10 bit = ADC range 0 - 1023 12 bit = ADC range 0 - 4095
	Simulation
	Scope Traces
Selects if the scope traces are automatically generated or not

Difference between revisions of "Component: ADC Template 2D (Analog Input)"

Revision as of 10:00, 27 January 2023

Contents

ADC Template 2D component

Component Source Code

Detailed description

Examples

Macro reference

Property reference

Property reference

Property reference

Property reference

Navigation menu

Page actions

Page actions

Personal tools

Navigation

Search

Tools

@@ Line 17: / Line 17: @@
 ==Component Source Code==
-Please click here to download the component source project: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_adc_Base_2dgdi.fcfx FC_Comp_Source_adc_Base_2dgdi.fcfx]
+Please click here to download the component source project: [https://www.flowcode.co.uk/wiki/componentsource/FC_Comp_Source_adc_Base_2dgdi.fcfx FC_Comp_Source_adc_Base_2dgdi.fcfx]
 Please click here to view the component source code (Beta): [https://www.flowcode.co.uk/FlowchartView/?wfile=componentsource/FC_Comp_Source_adc_Base_2dgdi.fcfx FC_Comp_Source_adc_Base_2dgdi.fcfx]
 ==Detailed description==
@@ Line 46: / Line 48: @@
 ==Examples==
@@ Line 54: / Line 58: @@
 ==Macro reference==
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawSampleInt'''
+|-
+| colspan="2" | Background call to read the ADC at full bit depth Call Enable() first&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawAverageByte'''
+|-
+| colspan="2" | Background call to read the ADC as a byte average sample over time Call Enable() before this&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | NumSamples
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | DelayUs
+|-
+| colspan="2" | Number of micro seconds in between taking each sample&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetSampleBits'''
+|-
+| colspan="2" | Gets the number of bits per sample&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetString'''
+|-
+| colspan="2" | Reads the ADC as a direct voltage and returns as a string&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-string-icon.png]] - STRING
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetAverageByte'''
+|-
+| colspan="2" | Function call to read the ADC as a byte average sample over time &nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | NumSamples
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | DelayUs
+|-
+| colspan="2" | Number of micro seconds in between taking each sample&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawAverageInt'''
+|-
+| colspan="2" | Background call to read the ADC as a full width average sample over time Call Enable() before this&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | NumSamples
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | DelayUs
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetSpeedFilter'''
+|-
+| colspan="2" | Gets the Conversion speed filter string Use in Component.Property.SetFilter()&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-string-icon.png]] - STRING
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetAverageInt'''
+|-
+| colspan="2" | Function call to read the ADC as a full width average sample over time &nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | NumSamples
+|-
+| colspan="2" | &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" | DelayUs
+|-
+| colspan="2" | Number of micro seconds in between taking each sample&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetProperties'''
+|-
+| colspan="2" | Set the VRef options and voltage, ConvSpeed and AcqTime for the ADC component.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" | VRef10Ms
+|-
+| colspan="2" | Voltage Reference x10 mV - Default 500 = 5V&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL
+| width="90%" | VRefOpt
+|-
+| colspan="2" | External VRef 0=Disabled, 1=Enabled&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" | ConvSpdOpt
+|-
+| colspan="2" | Conversion Speed Setting - Refer to numbered list&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" | Aquisitions
+|-
+| colspan="2" | Aquisition time in micro seconds to precharge before sampling&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetVoltage'''
+|-
+| colspan="2" | Reads the ADC as a direct voltage&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-f32-icon.png]] - FLOAT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawEnable'''
+|-
+| colspan="2" | Enables and configures the ADC channel to be an analogue input. Only one ADC channel can be enabled at a time. Any RAW functions will reference the last enabled channel only.&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetChannel'''
+|-
+| colspan="2" | Sets the channel ID for the component&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-s16-icon.png]] - INT
+| width="90%" | ChannelId
+|-
+| colspan="2" | Chaannel starting at 0, -1 is unconnected&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawSampleByte'''
+|-
+| colspan="2" | Background call to read the ADC as a byte Call Enable() before this&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetInt'''
+|-
+| colspan="2" | Blocking call to read the ADC at full bit depth &nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RawDisable'''
+|-
+| colspan="2" | Disables the previously enabled ADC channel and converts back to digital mode.&nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetByte'''
+|-
+| colspan="2" | Blocking call to read the ADC as a byte &nbsp;
+|-
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u8-icon.png]] - BYTE
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+==Property reference==
+{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+|-
+| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+|-
+|-
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-6-icon.png]]
+| width="90%" | Channel
+|-
+| colspan="2" | Analogue Input Channel - Which pin is the analogue input connected to?&nbsp;
+|-
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Settings
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | VRef voltage
+|-
+| colspan="2" | Used by the GetVoltage or GetString component macros to take an ADC reading and convert it into a Voltage. +VRef voltage x 10mV Default 500 = 5.0V &nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | VRef option
+|-
+| colspan="2" | Defines what is used as the ADC maximum reference. ADC Range = GND to VRef Voltage VDD - Defines the microcontrollers power supply pin as the max reference, VREF+ Pin - Dedicated pin on the microcontroller to allow for a variable reference voltage.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-16-icon.png]]
+| width="90%" | Conversion speed
+|-
+| colspan="2" | Clock setting to select how fast the ADC peripheral will perform an ADC conversion. The FRC setting is based on a RC time base and so will vary with temperature and pressure. Other settings are generally based on divisions of the master clock.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Acquisition cycles
+|-
+| colspan="2" | Number of micro seconds to wait for the ADC input to charge before starting the analogue sample.&nbsp;
+|-
+| width="10%" align="center" | [[File:Fc9-type-14-icon.png]]
+| width="90%" | Bit Depth
+|-
+| colspan="2" | Maximum number of digital bits the ADC can sample. 8 bit = ADC range 0 - 255 10 bit = ADC range 0 - 1023  12 bit = ADC range 0 - 4095&nbsp;
+|-
+| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-type-7-icon.png]]
+| width="90%" | Scope Traces
+|-
+| colspan="2" | Selects if the scope traces are automatically generated or not&nbsp;
+|}==Macro reference==
 {| class="wikitable" style="width:60%; background-color:#FFFFFF;"