Component: Temp / Humidity (HTS221) (Environmental): Difference between revisions

Revision as of 14:23, 13 July 2026

Author	Matrix TSL
Version	1.0
Category	Environmental

Temp / Humidity (HTS221) component

A temperature and relative humidity sensor allowing the ambient temperature and relative humidity to be monitored digitally. Humidity Range = 0% - 100% +/- 3.5% Temperature Range = -40 - 120 Degrees C +/- 0.5 Degrees C

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

ControlHeater

	ControlHeater
Controls the in-built heater element to speed up sensor recovery time in case of condensation. Humidity and temperature cannot be read while Heater is active.
- BOOL	Active
0 = Off (Sensor Reading Available) / 1 = On (Sensor Reading Disabled)
- VOID	Return

DataAvailable

	DataAvailable
Checks to see if new sensor data is available. Returns 0 if no new data is available. Returns 1 if new Temperature data is available. Returns 2 if new Humidity data is available. Returns 3 if new Temp and Humidity data is available.
- BYTE	Return

Initialise

	Initialise
Configures the I2C peripheral ready for communications.
- BYTE	Return

ReadHumidityInt

	ReadHumidityInt
Samples the humidity from the sensor and returns the relative humidity reading as a integer byte from 0 to 100
- BYTE	Return

ReadHumidityReal

	ReadHumidityReal
Samples the humidity from the sensor and returns the relative humidity reading as a float from 0.0 to 100.0.
- FLOAT	Return

ReadRegister

	ReadRegister
Reads an 8-bit value from one of the registers onboard the sensor IC.
- BYTE	Address

- BYTE	Return

ReadTemperatureInt

	ReadTemperatureInt
Samples the temperature from the sensor and returns the reading in degrees C as an integer from -40 to 120.
- INT	Return

ReadTemperatureReal

	ReadTemperatureReal
Samples the temperature from the sensor and returns the reading in degrees C as a float from -40.0 to 120.0.
- FLOAT	Return

WriteRegister

	WriteRegister
Writes a value to a register on the sensor IC.
- BYTE	Address

- BYTE	Data

- VOID	Return

Property reference

	Properties
	Sensor Properties
	Data Rate

	I2C Properties
	Address

	Channel
Channel selection
	SDA
Pin used for SDA (data signal)
	SCL
Pin used for SCL (clock signal)
	Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.
	Baud Select
Baud rate option selector
	Baud Rate
Baud rate to be used
	Simulation
	Sim Type

@@ Line 91: / Line 91: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ControlHeater'''
+| width="90%" class="mtx-class-macrohead" | '''ControlHeater'''
 |-
 | colspan="2" | Controls the in-built heater element to speed up sensor recovery time in case of condensation. Humidity and temperature cannot be read while Heater is active.&nbsp;
@@ Line 110: / Line 110: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''DataAvailable'''
+| width="90%" class="mtx-class-macrohead" | '''DataAvailable'''
 |-
 | colspan="2" | Checks to see if new sensor data is available. Returns 0 if no new data is available. Returns 1 if new Temperature data is available. Returns 2 if new Humidity data is available. Returns 3 if new Temp and Humidity data is available.&nbsp;
@@ Line 124: / Line 124: @@
 |-
 | 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 I2C peripheral ready for communications.&nbsp;
@@ Line 138: / Line 138: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadHumidityInt'''
+| width="90%" class="mtx-class-macrohead" | '''ReadHumidityInt'''
 |-
 | colspan="2" | Samples the humidity from the sensor and returns the relative humidity reading as a integer byte from 0 to 100&nbsp;
@@ Line 152: / Line 152: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadHumidityReal'''
+| width="90%" class="mtx-class-macrohead" | '''ReadHumidityReal'''
 |-
 | colspan="2" | Samples the humidity from the sensor and returns the relative humidity reading as a float from 0.0 to 100.0.&nbsp;
@@ Line 166: / Line 166: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadRegister'''
+| width="90%" class="mtx-class-macrohead" | '''ReadRegister'''
 |-
 | colspan="2" | Reads an 8-bit value from one of the registers onboard the sensor IC.&nbsp;
@@ Line 185: / Line 185: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadTemperatureInt'''
+| width="90%" class="mtx-class-macrohead" | '''ReadTemperatureInt'''
 |-
 | colspan="2" | Samples the temperature from the sensor and returns the reading in degrees C as an integer from -40 to 120.&nbsp;
@@ Line 199: / Line 199: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadTemperatureReal'''
+| width="90%" class="mtx-class-macrohead" | '''ReadTemperatureReal'''
 |-
 | colspan="2" | Samples the temperature from the sensor and returns the reading in degrees C as a float from -40.0 to 120.0.&nbsp;
@@ Line 213: / Line 213: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteRegister'''
+| width="90%" class="mtx-class-macrohead" | '''WriteRegister'''
 |-
 | colspan="2" | Writes a value to a register on the sensor IC.&nbsp;
@@ Line 238: / Line 238: @@
 |-
 | 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'''
 |-
 |-

SteveT (talk | contribs)