pxt-calliope/docs/reference/input/calibrate-compass.md
2020-03-19 16:26:40 +01:00

853 B

Calibrate Compass

Runs the compass calibration sequence.

input.calibrateCompass();

Calibration

The calibration will ask you to draw a circle or fill the LED screen by tilting the @boardname@.

The compass calibration is stored in memory by the @boardname@, so next time you press the reset button or remove and replace the power the calibration will be remembered.

When you flash a new program to your @boardname@ via USB, this memory is cleared so you will have to re-calibrate it.

If you are calibrating or using the compass near metal, it might confuse the @boardname@.

Example

This example runs the calibration when the user presses A+B buttons.

input.onButtonEvent(Button.AB, ButtonEvent.Click, () => {
    input.calibrateCompass();
})

See also

compass heading