Magnetometer

Description

The magnetometer is used to measure magnetic flux density. This is the total magnetic field passing through a given area, per metre squared, Tโ‹…m2m2\frac{T \cdot m^2}{m^2} . The sensor will returns values with units of microtesla ฮผT\mu T for each of the three coordinate axes; x, y and, z. The magnetic flux density is quite similar to magnetic field strength.

โ€Œ

Blocks

Events

When Magnetometer Changes

When the magnetometer detects a change in the ambient magnetic field the Changes event will fire. The event returns 4 parameters that we can work with.

Parameter

Type

Returns

xFluxDensity

Number

Flux density, in the x direction, expressed in ฮผT\mu T

yFluxDensity

Number

Flux density, in the y direction, expressed in ฮผT\mu T

zFluxDensity

Number

Flux density, in the z direction, expressed in ฮผT\mu T

error

String

Error message from the Sensor

Functions

Call X

Returns flux density, in the x direction, expressed in ฮผT\mu Tโ€‹

Call Y

Returns flux density, in the y direction, expressed in ฮผT\mu Tโ€‹

Call Z

Returns flux density, in the x direction, expressed in ฮผT\mu Tโ€‹

Call Heading

Returns a value between 0 and 360 which denotes the user's direction relative to the Earth's geographic North Pole

Properties

Enabled

The magnetometer is, by default, turned on, but the enabled property can be used to turn in on and off by setting it to true or false respectively.

Property

Type

Default

set Enabled

Bool

true

get Enabled

Bool

true