BangleApps/apps/alpinenav/README.md

29 lines
2.7 KiB
Markdown
Raw Normal View History

2021-01-19 20:43:25 +00:00
Alpine Navigator
================
App that performs GPS monitoring to track and display position relative to a given origin in realtime.
2021-01-18 20:48:33 +00:00
2021-01-25 18:45:24 +00:00
![screenshot](./sample.PNG)
2021-01-18 20:48:33 +00:00
Functions
---------
2021-01-25 18:43:52 +00:00
Note if you've not used GPS yet I suggest using one of the GPS apps to get your first fix and confirm as I've found that helps initially.
2021-01-18 20:48:33 +00:00
2021-01-25 18:43:52 +00:00
The GPS and magnetometer will be turned on and after a few moments, when the watch buzzes and the dot turns from red to pink, that means the GPS is fixed. all your movements now will be displayed with a line drawn back to show your position relative to the start. New waypoints will be added based on checking every 10 seconds for at least 5 meters of movement. The map will scale to your distance travelled so the route will always remain within the window, the accelerometer/pedometer is not used - this is a purely GPS solution so can be used for driving/cycling etc. A log file will be recorded that tracks upto 1000 waypoints, this isn't a big file and you could remove the limit but I've kept it fairly conservative here as it's not intended as a main feature, there's already good GPS recorders for the Bangle. The following other items are displayed:
2021-01-18 20:48:33 +00:00
1. altitude at origin, this is displayed left of the centre.
2. current altitude, displayed centre right
3. distance from origin, bottom left (meters)
4. distance travelled, bottom right (meters)
2021-01-25 18:43:52 +00:00
5. compass heading, at the top
For the display, the route is kept at a set resolution, so there's no risk of running running into memory problems if you run this for long periods or any length of time because the waypoints will be reduced when it reaches a set threshold so you may see the path smooth out at intervals.
2021-01-18 20:48:33 +00:00
The buttons do the following:
2021-01-25 18:43:52 +00:00
BTN1: this will display an 'X' in the bottom of the screen and lock all the buttons, this is to prevent you accidentally pressing any of the below. Remember to press this again to unlock it! soft and hard reset will both still work.
2021-01-19 20:45:51 +00:00
BTN2: this removes all waypoints aside from the origin and your current location; sometimes during smaller journeys and walks, the GPS can give sporadic differences in locations because of the error margins of GPS and this can add noise to your route.
2021-01-19 20:43:25 +00:00
BTN3: this will pause the GPS and magnetometer, useful for saving power for situations where you don't necessarily need to track parts of your route e.g. you're going indoors/shelter for some time. You'll know it's paused because the compass won't update it's reading and all the metrics will be blacked out on the screen.
2021-01-25 18:43:52 +00:00
Things to do next
-----------------
There's a GPS widget that's been developed to leverage low-power mode capability on the sensor, will look to incorporate that.