Component: Thermocouple (MAX31856) (Environmental): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix TSL
Version	1.0
Category	Environmental

Thermocouple (MAX31856) component

Component to interface the MAX31856 IC from MAXIM. Uses a standard 4-wire SPI interface to connect to the IC and collect the temperature. Compatible with different thermocouple types.

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

Initialise

	Initialise
Configures the SPI bus ready for communications.
- VOID	Return

ReadReference_Float

	ReadReference_Float
Returns the reference temperature from the last sample as a floating point value in Degrees C.
- FLOAT	Return

ReadReference_Int

	ReadReference_Int
Returns the reference temperature from the last sample as an integer value in Degrees C.
- INT	Return

ReadThermocouple_Float

	ReadThermocouple_Float
Returns the thermocouple temperature from the last sample as a floating point value in Degrees C.
- FLOAT	Return

ReadThermocouple_Int

	ReadThermocouple_Int
Returns the thermocouple temperature from the last sample as an integer value in Degrees C.
- INT	Return

Sample

	Sample
Reads the memory of the MAX31855 IC and checks for errors. Must be called before any of the Read functions. Returns: 0=OK, 1=Open Circuit, 2=Under/Over Voltage, 3=Out of range
- BYTE	Return

WriteColdJunctionOffset

	WriteColdJunctionOffset
When Cold Junction Compensation is enabled mode this macro allows you to define the offset temperature of the cold junction.
- FLOAT	OffsetTemperature
Range: +/- 7 Degrees
- VOID	Return

WriteColdJunctionTemperature

	WriteColdJunctionTemperature
When Cold Junction Compensation is disabled/external mode this macro allows you to define the temperature of the cold junction.
- FLOAT	Temperature
Range: +/- 127 Degrees
- VOID	Return

Property reference

	Properties
	Thermocouple Properties
	Thermocouple Type
Specified the thermocouple type used with the sensor IC
	Averaging
Select the number of samples used to provide stable readings.
	Conversion Mode

	Notch Filter
Choose the frequency of notch filter
	Cold Junction Compensation
Allows the chip to automatically perform cold junction compensation to try and get more accurate temperature conversions. Internal - Uses internal temperature sensor External / Disabled- Uses SetColdJunctionTemperature macro to allow for external temperature compensation.
	SPI Properties
	Channel
SPI Channel selector
	Prescale
Prescale option selector
	MOSI
SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode.
	MISO
SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode.
	CLK
SPI Clock Pin CLK - The Clock signal is driven by the SPI master.
	CS / 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.
	Simulation
	Simulate Comms

Component Source Code

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

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

@@ Line 66: / Line 66: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+| width="90%" class="mtx-class-macrohead" | '''Initialise'''
 |-
 | colspan="2" | Configures the SPI bus ready for communications.&nbsp;
@@ Line 80: / Line 80: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadReference_Float'''
+| width="90%" class="mtx-class-macrohead" | '''ReadReference_Float'''
 |-
 | colspan="2" | Returns the reference temperature from the last sample as a floating point value in Degrees C.&nbsp;
@@ Line 94: / Line 94: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadReference_Int'''
+| width="90%" class="mtx-class-macrohead" | '''ReadReference_Int'''
 |-
 | colspan="2" | Returns the reference temperature from the last sample as an integer value in Degrees C.&nbsp;
@@ Line 108: / Line 108: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadThermocouple_Float'''
+| width="90%" class="mtx-class-macrohead" | '''ReadThermocouple_Float'''
 |-
 | colspan="2" | Returns the thermocouple temperature from the last sample as a floating point value in Degrees C.&nbsp;
@@ Line 122: / Line 122: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadThermocouple_Int'''
+| width="90%" class="mtx-class-macrohead" | '''ReadThermocouple_Int'''
 |-
 | colspan="2" | Returns the thermocouple temperature from the last sample as an integer value in Degrees C.&nbsp;
@@ Line 136: / Line 136: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Sample'''
+| width="90%" class="mtx-class-macrohead" | '''Sample'''
 |-
 | colspan="2" | Reads the memory of the MAX31855 IC and checks for errors. Must be called before any of the Read functions. Returns: 0=OK, 1=Open Circuit, 2=Under/Over Voltage, 3=Out of range&nbsp;
@@ Line 150: / Line 150: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteColdJunctionOffset'''
+| width="90%" class="mtx-class-macrohead" | '''WriteColdJunctionOffset'''
 |-
 | colspan="2" | When Cold Junction Compensation is enabled mode this macro allows you  to define the offset temperature of the cold junction.&nbsp;
@@ Line 169: / Line 169: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteColdJunctionTemperature'''
+| width="90%" class="mtx-class-macrohead" | '''WriteColdJunctionTemperature'''
 |-
 | colspan="2" | When Cold Junction Compensation is disabled/external mode this macro allows you  to define the temperature of the cold junction.&nbsp;
@@ Line 189: / Line 189: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Thermocouple Properties
+| width="90%" class="mtx-class-propfolder" | Thermocouple Properties
 |-
 |-
@@ Line 222: / Line 222: @@
 | colspan="2" | Allows the chip to automatically perform cold junction compensation to try and get more accurate temperature conversions. Internal - Uses internal temperature sensor External / Disabled- Uses SetColdJunctionTemperature macro to allow for external temperature compensation.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | SPI Properties
+| width="90%" class="mtx-class-propfolder" | SPI Properties
 |-
 |-
@@ Line 256: / Line 256: @@
 | colspan="2" | 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. &nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
+| width="90%" class="mtx-class-propfolder" | Simulation
 |-
 |-

SteveT (talk | contribs)