Component: Ambient Light (BH1750FVI) (Light): Difference between revisions

Latest revision as of 14:36, 13 July 2026

Author	Matrix TSL
Version	1.0
Category	Light

Ambient Light component

A small PCB surface mount ambient light sensor with a I2C bus interface. Spectral responsibility is approximately human eye response. Wide range and High resolution. ( 1 - 65535 lx )

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

ChangeMeasurementTime

	ChangeMeasurementTime
Adjusts the measurement result to counteract influence of the optical window.
- BYTE	Sensitvity
Range: 31-254 / Default: 69
- VOID	Return

ContinuousMeasurement

	ContinuousMeasurement
Powers up and starts the continous measurement mode. Delays in between measurements readings must be provided by the user,
- BYTE	Resolution
0=1lx (120ms) / 1=0.5lx (120ms) / 2 = 4lx (16ms)
- VOID	Return

Initialise

	Initialise
Stes up the I2C bus and initialises the termperature sensor ready for use.
- VOID	Return

OneTimeMeasurement

	OneTimeMeasurement
Powers up and starts a single measurement before returning to power down mode. Waits for the measurement to be ready and returns the value.
- BYTE	Resolution
0=1lx (120ms) / 1=0.5lx (120ms) / 2 = 4lx (16ms)
- UINT	Return

PowerDown

	PowerDown
Power Down the Device
- VOID	Return

ReadMeasurement

	ReadMeasurement
Reads data from the Light Sensor as a 16-bit value.
- UINT	Return

ResetMeasurement

	ResetMeasurement
Resets the device measurement register, Must be in the powered up state to do this.
- VOID	Return

Property reference

	Properties
	I2C Properties
	Slave Address

	Channel
Channel selection
	SDA
Pin used for SDA (data signal)
	SCL
Pin used for SCL (clock signal)
	DVI Pin
Pin used to reset the device.
	Baud Select
Baud rate option selector
	Baud Rate
Baud rate to be used
	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.
	Simulation
	Simulate Comms
Allows the simulation data to come from the panel GUI or relayed via an injector component.

@@ Line 92: / Line 92: @@
 {| 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;" | '''ChangeMeasurementTime'''
+| width="90%" class="mtx-class-macrohead" | '''ChangeMeasurementTime'''
 |-
 | colspan="2" | Adjusts the measurement result to counteract influence of the optical window.&nbsp;
@@ Line 111: / Line 111: @@
 {| 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;" | '''ContinuousMeasurement'''
+| width="90%" class="mtx-class-macrohead" | '''ContinuousMeasurement'''
 |-
 | colspan="2" | Powers up and starts the continous measurement mode. Delays in between measurements readings must be provided by the user,&nbsp;
@@ Line 130: / Line 130: @@
 {| 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" | Stes up the I2C bus and initialises the termperature sensor ready for use.&nbsp;
@@ Line 144: / Line 144: @@
 {| 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;" | '''OneTimeMeasurement'''
+| width="90%" class="mtx-class-macrohead" | '''OneTimeMeasurement'''
 |-
 | colspan="2" | Powers up and starts a single measurement before returning to power down mode. Waits for the measurement to be ready and returns the value.&nbsp;
@@ Line 163: / Line 163: @@
 {| 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;" | '''PowerDown'''
+| width="90%" class="mtx-class-macrohead" | '''PowerDown'''
 |-
 | colspan="2" | Power Down the Device&nbsp;
@@ Line 177: / Line 177: @@
 {| 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;" | '''ReadMeasurement'''
+| width="90%" class="mtx-class-macrohead" | '''ReadMeasurement'''
 |-
 | colspan="2" | Reads data from the Light Sensor as a 16-bit value.&nbsp;
@@ Line 191: / Line 191: @@
 {| 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;" | '''ResetMeasurement'''
+| width="90%" class="mtx-class-macrohead" | '''ResetMeasurement'''
 |-
 | colspan="2" | Resets the device measurement register, Must be in the powered up state to do this.&nbsp;
@@ Line 206: / Line 206: @@
 {| 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;" | I2C Properties
+| width="90%" class="mtx-class-propfolder" | I2C Properties
 |-
 |-
@@ Line 254: / Line 254: @@
 | colspan="2" | 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. &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)