Calibrate compass (#392)

* adding 'calibrate-compass' function

* fixing simulator.

* updated docs

* fixing compat test suite with 'calibrate()' function

docs/reference/input/calibrate-compass.md

@@ -0,0 +1,29 @@
+# Calibrate Compass
+
+Runs the compass calibration sequence.
+
+```sig
+input.calibrateCompass();
+```
+
+### Calibration
+
+The calibration will ask you to draw a circle by tilting the
+@boardname@.
+
+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.
+
+```blocks
+input.onButtonPressed(Button.AB, () => {
+    input.calibrateCompass();
+})
+```
+
+### See also
+
+[compassHeading](/reference/input/compass-heading)