| Author
 | 
Matrix Ltd
 | 
| Version
 | 
1.1
 | 
| Category
 | 
Magnetic
 | 
Hall Effect Analog component
Simple analogue hall effect triggered by the proximity of another object.
Component Source Code
Please click here to download the component source project: FC_Comp_Source_HallEffect_Analog.fcfx
Please click here to view the component source code (Beta): FC_Comp_Source_HallEffect_Analog.fcfx
Detailed description
No detailed description exists yet for this component
Examples
No additional examples
Macro reference
 
 | 
SetTarget
 | 
| Set the object that you want to test for collision with. If this is not called, or is called with handle = 0, collisions will be tested against every panel object that has 'Solid' status. NB) Specifying an object will save CPU power!! 
 | 
  - HANDLE
 | 
Target
 | 
| The object to test for collision with. 
 | 
  - VOID
 | 
Return
 | 
 
 | 
ReadProximityByte
 | 
| Get the current proximity reading as a digital value from 0 to 255. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - BYTE
 | 
Return
 | 
 
 | 
ReadProximityFloat
 | 
| Get the current proximity as an analogue value from 0.0 to 1.0. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - FLOAT
 | 
Return
 | 
 
 | 
ReadProximityInt
 | 
| Get the current proximity as a digital value, 10 bit or 12 bit based on your ADC capabilities. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - UINT
 | 
Return
 | 
Property reference
 
 | 
Properties
 | 
 
 | 
Connections
 | 
 
 | 
Analog Pin
 | 
|  
 | 
 
 | 
Polarity
 | 
| The 'Polarity' property will affect whether the signal increases of decreases as the proximity increases. Rising - Increases signal as proximity increases Falling - Decreases signal as proximity increases 
 | 
 
 | 
ADC Properties
 | 
 
 | 
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. 
 | 
 
 | 
Simulation
 | 
 
 | 
Magnet Object
 | 
| Select an object from the panel to act as the magnet that triggers the reed switch. 
 | 
 
 | 
Range
 | 
| Distance within which the sensor begins to be activated. NB)  This is measured between the centre of the proximity sensor and the centre of the target object. 
 | 
 
 | 
Timer Interval (ms)
 | 
| Time in milliseconds between testing for proximity. Small time = Greater CPU load Large time = More like to miss activation if it is very brief. 
 | 
 
 | 
Scope Traces
 | 
| Selects if the scope traces are automatically generated or not 
 | 
==Macro reference==
 
 | 
SetTarget
 | 
| Set the object that you want to test for collision with. If this is not called, or is called with handle = 0, collisions will be tested against every panel object that has 'Solid' status. NB) Specifying an object will save CPU power!! 
 | 
  - HANDLE
 | 
Target
 | 
| The object to test for collision with. 
 | 
  - VOID
 | 
Return
 | 
 
 | 
ReadProximityByte
 | 
| Get the current proximity reading as a digital value from 0 to 255. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - BYTE
 | 
Return
 | 
 
 | 
ReadProximityFloat
 | 
| Get the current proximity as an analogue value from 0.0 to 1.0. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - FLOAT
 | 
Return
 | 
 
 | 
ReadProximityInt
 | 
| Get the current proximity as a digital value, 10 bit or 12 bit based on your ADC capabilities. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - UINT
 | 
Return
 | 
Property reference
 
 | 
Properties
 | 
 
 | 
Connections
 | 
 
 | 
Analog Pin
 | 
|  
 | 
 
 | 
Polarity
 | 
| The 'Polarity' property will affect whether the signal increases of decreases as the proximity increases. Rising - Increases signal as proximity increases Falling - Decreases signal as proximity increases 
 | 
 
 | 
ADC Properties
 | 
 
 | 
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. 
 | 
 
 | 
Simulation
 | 
 
 | 
Magnet Object
 | 
| Select an object from the panel to act as the magnet that triggers the reed switch. 
 | 
 
 | 
Range
 | 
| Distance within which the sensor begins to be activated. NB)  This is measured between the centre of the proximity sensor and the centre of the target object. 
 | 
 
 | 
Timer Interval (ms)
 | 
| Time in milliseconds between testing for proximity. Small time = Greater CPU load Large time = More like to miss activation if it is very brief. 
 | 
 
 | 
Scope Traces
 | 
| Selects if the scope traces are automatically generated or not 
 | 
==Macro reference==
 
 | 
SetTarget
 | 
| Set the object that you want to test for collision with. If this is not called, or is called with handle = 0, collisions will be tested against every panel object that has 'Solid' status. NB) Specifying an object will save CPU power!! 
 | 
  - HANDLE
 | 
Target
 | 
| The object to test for collision with. 
 | 
  - VOID
 | 
Return
 | 
 
 | 
ReadProximityByte
 | 
| Get the current proximity reading as a digital value from 0 to 255. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - BYTE
 | 
Return
 | 
 
 | 
ReadProximityFloat
 | 
| Get the current proximity as an analogue value from 0.0 to 1.0. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - FLOAT
 | 
Return
 | 
 
 | 
ReadProximityInt
 | 
| Get the current proximity as a digital value, 10 bit or 12 bit based on your ADC capabilities. The 'Polarity' property will affect whether the signal increases or decreases as the proximity increases. 
 | 
  - UINT
 | 
Return
 | 
Property reference
 
 | 
Properties
 | 
 
 | 
Connections
 | 
 
 | 
Analog Pin
 | 
|  
 | 
 
 | 
Polarity
 | 
| The 'Polarity' property will affect whether the signal increases of decreases as the proximity increases. Rising - Increases signal as proximity increases Falling - Decreases signal as proximity increases 
 | 
 
 | 
ADC Properties
 | 
 
 | 
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. 
 | 
 
 | 
Simulation
 | 
 
 | 
Magnet Object
 | 
| Select an object from the panel to act as the magnet that triggers the reed switch. 
 | 
 
 | 
Range
 | 
| Distance within which the sensor begins to be activated. NB)  This is measured between the centre of the proximity sensor and the centre of the target object. 
 | 
 
 | 
Timer Interval (ms)
 | 
| Time in milliseconds between testing for proximity. Small time = Greater CPU load Large time = More like to miss activation if it is very brief. 
 | 
 
 | 
Scope Traces
 | 
| Selects if the scope traces are automatically generated or not 
 |