Component: Magnetometer (BMM150) (Environmental): Difference between revisions

Revision as of 14:15, 13 July 2026

Author	MatrixTSL
Version	1.0
Category	Environmental

Magnetometer (BMM150) component

A low-power, low-noise 3-axis digital geomagnetic sensor that perfectly matches the requirements of compass applications.

Component Source Code

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

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

Initialise

	Initialise
Startup communications to the sensor module. Puts the device into normal operating and preset modes. Returns 1 if module found and communicating.
- BYTE	Return

ReadRegister

	ReadRegister
A simple example showing a generic way to read a register using I2C.
- BYTE	Address

- BYTE	Return

ReadSample

	ReadSample
Collect a sample fromt he last SampleMag operation
- BYTE	Axis
0=X, 1=Y, 2=Z
- INT	Return

SampleMagData

	SampleMagData
Samples the magnetometer and processes the data ready to be read out using the read sample macro.
- BOOL	ApplyTrim
0=ReadRawValues, 1=ApplyCalibrationTrim
- VOID	Return

SetOperatingMode

	SetOperatingMode
Select the operating mode and power level used by the device
- BYTE	Mode
0=Normal, 1=Forced, 3=Sleep, 4=Suspend
- VOID	Return

SetPresetMode

	SetPresetMode
Controls the device sample rate and accuracy
- BYTE	Mode
0=LowPower, 1=Normal, 2=HighAccuracy, 3=Enhanced
- VOID	Return

WriteRegister

	WriteRegister
A simple example showing a generic way to write a register using I2C.
- BYTE	Address

- BYTE	Data

- VOID	Return

Property reference

	Properties
	Component Properties
	Device Address

	Preset
Sets the default preset for the module. Can be overridden by calling the SetPresetMode component macro.
	I2C Properties
	Connections
	Channel
Channel selection
	SDA
Pin used for SDA (data signal)
	SDA Remap Pin

	SCL
Pin used for SCL (clock signal)
	SCL Remap Pin

	Options
	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
	Simulate Comms

@@ Line 32: / Line 32: @@
 ===Initialise===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 46: / Line 46: @@
 ===ReadRegister===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 65: / Line 65: @@
 ===ReadSample===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 84: / Line 84: @@
 ===SampleMagData===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 103: / Line 103: @@
 ===SetOperatingMode===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 122: / Line 122: @@
 ===SetPresetMode===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 141: / Line 141: @@
 ===WriteRegister===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
@@ Line 166: / Line 166: @@
 ==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
 | width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]

SteveT (talk | contribs)