BangleApps/apps/magnav/README.md

# Navigation Compass

This is a tilt and roll compensated compass with a linear display. The compass will  display the same direction that it shows when flat as when it is tilted (rotation around the W-S axis) or rolled (rotation around the N-S) axis. *Even with compensation, it would be beyond foolish to rely solely on this app for any serious navigational purpose.*

![](screenshot.jpg)

## Calibration

Correct operation of this app depends critically on calibration. When first run on a Bangle, the app will request calibration. This lasts for 20 seconds during which you should move the watch slowly through figures of 8. It is important that during calibration the watch is  fully rotated around each of it axes. If the app does give the correct direction heading or is not stable with respect to tilt and roll - redo the calibration by pressing *BTN2*. Calibration data is recorded in a storage file named `magnav.json`. 

Note: Charging your Bangle due to the magnetic connector clamp seems to require recalibration afterwards for accurate readings.

## Controls

*BTN1* - marks the current heading with a blue circle - see screen shot. This can be used to take a bearing and then follow it..
(Swipe UP on Bangle 2)

*BTN2* - invokes calibration ( can be cancelled if pressed accidentally).
(*BTN1* on Bangle 2)

*BTN3* - cancels the marker (blue circle not displayed)
(swipe DOWN on Bangle 2)


## Support

Please report bugs etc. by raising an issue [here](https://github.com/jeffmer/JeffsBangleAppsDev).
Add files via upload 2020-06-09 11:08:14 +00:00			`# Navigation Compass`

			`This is a tilt and roll compensated compass with a linear display. The compass will display the same direction that it shows when flat as when it is tilted (rotation around the W-S axis) or rolled (rotation around the N-S) axis. Even with compensation, it would be beyond foolish to rely solely on this app for any serious navigational purpose.`

			`![](screenshot.jpg)`

			`## Calibration`

update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			Correct operation of this app depends critically on calibration. When first run on a Bangle, the app will request calibration. This lasts for 20 seconds during which you should move the watch slowly through figures of 8. It is important that during calibration the watch is fully rotated around each of it axes. If the app does give the correct direction heading or is not stable with respect to tilt and roll - redo the calibration by pressing BTN2. Calibration data is recorded in a storage file named `magnav.json`.
Add files via upload 2020-06-09 11:08:14 +00:00
update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			`Note: Charging your Bangle due to the magnetic connector clamp seems to require recalibration afterwards for accurate readings.`
Add files via upload 2020-06-09 11:08:14 +00:00
update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			`## Controls`
Add files via upload 2020-06-09 11:08:14 +00:00
update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			`BTN1 - marks the current heading with a blue circle - see screen shot. This can be used to take a bearing and then follow it..`
add screenshot and update readme 2021-11-20 10:45:21 +00:00			`(Swipe UP on Bangle 2)`
Add files via upload 2020-06-09 11:08:14 +00:00
update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			`BTN2 - invokes calibration ( can be cancelled if pressed accidentally).`
add screenshot and update readme 2021-11-20 10:45:21 +00:00			`(BTN1 on Bangle 2)`
Add files via upload 2020-06-09 11:08:14 +00:00
update multiclock + initial B2 magnav 2021-11-19 15:08:45 +00:00			`BTN3 - cancels the marker (blue circle not displayed)`
add screenshot and update readme 2021-11-20 10:45:21 +00:00			`(swipe DOWN on Bangle 2)`
Add files via upload 2020-06-09 11:08:14 +00:00

			`## Support`

			`Please report bugs etc. by raising an issue [here](https://github.com/jeffmer/JeffsBangleAppsDev).`