# Magnétomètre

## **Vue d'ensemble**

* [**Description**](#description)
* [**Évènements**](#evenements)
* [**Propriétés**](#proprietes)

## **Description**

Le magnétomètre est utilisé pour mesurer la densité du flux magnétique. Il s'agit du champ magnétique total traversant une zone donnée, par mètre carré, $$(T\*m²)/m²$$  . Le capteur renvoie des valeurs avec des unités de microtesla $$yT$$ pour chacun des trois axes de coordonnées ; x, y et, z. La densité de flux magnétique est assez similaire à l'intensité du champ magnétique.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT683CGGNV2k45tB7Pr%2F1.png?generation=1612880037560964\&alt=media)

## **Événements**

Lorsque le magnétomètre détecte un changement dans le champ magnétique ambiant, l'événement `Changes` se déclenche. L'événement renvoie 4 paramètres avec lesquels nous pouvons travailler.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT683CHrU8h4PtcZc4d%2F2.png?generation=1612880037551890\&alt=media)

| Paramètre      | Tapez  | Retours                                                  |
| -------------- | ------ | -------------------------------------------------------- |
| `xFluxDensity` | Numéro | Densité de flux, dans la direction x, exprimée en $$µT$$ |
| `yFluxDensity` | Numéro | Densité de flux, dans la direction y, exprimée en $$μT$$ |
| `zFluxDensity` | Numéro | Densité de flux, dans la direction z, exprimée en $$μT$$ |
| `error`        | Chaîne | Message d'erreur du capteur                              |

## **Propriétés**

Le magnétomètre est, par défaut, activé, mais la propriété `enabled` peut être utilisée pour l'activer et le désactiver en le réglant respectivement sur `true` ou `false`.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT683CIKPiU16Gk8L-2%2F3.png?generation=1612880037560602\&alt=media)

| Propriété      | Tapez | Par défaut |
| -------------- | ----- | ---------- |
| `set  Enabled` | Bool  | `true`     |
| `get Enabled`  | Bool  | `true`     |