The Compass Service combines information from Pebble's accelerometer and magnetometer to automatically calibrate the compass and transform the raw magnetic field information into a CompassHeading, that is an angle to north. It also provides magnetic north and information about its status and accuracy through the CompassHeadingData structure. The API is designed to also provide true north in a future release.
Note that not all platforms have compasses. To check for the presence of a compass at compile time for the current platform use the PBL_COMPASS define.
To learn more about the Compass Service and how to use it, read the Determining Direction guide.
For available code samples, see the feature-compass example.
Set the minimum angular change required to generate new compass heading events. The angular distance is measured relative to the last delivered heading event. Use 0 to be notified of all movements. Negative values and values > TRIG_MAX_ANGLE / 2 are not valid. The default value of this property is TRIG_MAX_ANGLE / 360.
0, success.
Non-Zero, if filter is invalid.
Subscribe to the compass heading event service. Once subscribed, the handler gets called every time the angular distance relative to the previous value exceeds the configured filter.
A callback to be executed on heading events
Unsubscribe from the compass heading event service. Once unsubscribed, the previously registered handler will no longer be called.
Peek at the last recorded reading.
a pointer to a pre-allocated CompassHeadingData
Always returns 0 to indicate success.
Structure containing a single heading towards magnetic and true north.
Measured angle that increases counter-clockwise from magnetic north (use int clockwise_heading = TRIG_MAX_ANGLE - heading_data.magnetic_heading; for example to find your heading clockwise from magnetic north).
Currently same value as magnetic_heading (reserved for future implementation).
Indicates the current state of the Compass Service calibration.
Currently always false (reserved for future implementation).
Enum describing the current state of the Compass Service calibration.
The Compass Service is unavailable.
Compass is calibrating: data is invalid and should not be used Data will become valid once calibration is complete.
Compass is calibrating: the data is valid but the calibration is still being refined.
Compass data is valid and the calibration has completed.
Enum describing the current state of the Compass Service.
The Compass Service is unavailable.
Compass is calibrating: data is invalid and should not be used Data will become valid once calibration is complete.
Compass is calibrating: the data is valid but the calibration is still being refined.
Compass data is valid and the calibration has completed.
Represents an angle relative to get to a reference direction, e.g. (magnetic) north. The angle value is scaled linearly, such that a value of TRIG_MAX_ANGLE corresponds to 360 degrees or 2 PI radians. Thus, if heading towards north, north is 0, west is TRIG_MAX_ANGLE/4, south is TRIG_MAX_ANGLE/2, and so on.
Callback type for compass heading events.
copy of last recorded heading
Do you have questions about the Pebble SDK?
Do you need some help understanding something on this page?
You can either take advantage of our awesome developer community and check out the SDK Help forums, or you can send us a message through the website!