From 2e84ecb2953e707a20b1ad65d7f08f0bf3d55ba5 Mon Sep 17 00:00:00 2001 From: Ethan Dalool Date: Sat, 1 Apr 2023 17:53:34 -0700 Subject: [PATCH] Add power management to readme. --- README.md | 18 +++++++++++++----- app/build.gradle | 4 ++-- 2 files changed, 15 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e544cdd..2b3f84c 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ +

+ trkpt ===== -

- This is a fork of [Trackbook](https://codeberg.org/y20k/trackbook) by y20k. Thank you y20k for this great project. -The goal of this fork is to make 24/7 recording easier. I want to be able to run trkpt nearly all of the time. The main differences between trkpt and Trackbook are: +The goal of this fork is to make 24/7 recording easier. I want to be able to run trkpt nearly all of the time. I have written more about this at [voussoir.net/writing/obsessed_with_gpx](https://voussoir.net/writing/obsessed_with_gpx). The main differences between trkpt and Trackbook are: 1. trkpt stores points in an SQLite database instead of json files. @@ -15,9 +15,17 @@ The goal of this fork is to make 24/7 recording easier. I want to be able to run 3. trkpt adds the feature of "homepoints". When you are near a homepoint, trackpoints are not recorded. You can put a homepoint at your house or other places where you spend lots of time, so that you don't get large clouds of useless trackpoints at those locations. - • Although Trackbook has a feature to omit points that are close together, natural GPS inaccuracy and drift is large enough to create points that are far apart, leading to clouds over time. + • Although Trackbook has a feature to omit points that are close together, natural GPS inaccuracy and drift is large enough to create points that are far apart, especially while indoors, leading to clouds over time. You can choose the radius of your homepoint to eliminate these clouds. -4. trkpt removes the feature of "starring" waypoints. I recommend using [OsmAnd](https://f-droid.org/en/packages/net.osmand.plus/) to store your favorite places. +## Power management + +When you are near a homepoint, trkpt will slow down the GPS polling frequency to reduce power consumption. When trkpt detects movement from the device's accelerometers, or when the GPS detects you are away from the homepoint, it will wake back up to full power. + +If the GPS is completely unable to receive a fix because you are indoors, underground, or trapped in a Faraday cage, trkpt will turn it off after a few minutes. Without any fix, we can't even tell if we're near a homepoint, and the GPS burns a lot of energy trying. Again, the motion sensor will wake it back up to full power. + +When you are away from a homepoint, and the GPS is not struggling, trkpt will always run the GPS at full power. + +If your device doesn't support the motion sensors used here, then trkpt will always run at full power. It will not sleep or kill the GPS. Maybe we can find another solution to improve battery performance for devices in this scenario. ## Mirrors diff --git a/app/build.gradle b/app/build.gradle index e7fbba5..47b92e7 100644 --- a/app/build.gradle +++ b/app/build.gradle @@ -10,8 +10,8 @@ android { applicationId 'net.voussoir.trkpt' minSdkVersion 25 targetSdk 32 - versionCode 52 - versionName '1.0.1' + versionCode 53 + versionName '1.0.2' resConfigs "en", "da", "de", "fr", "hr", "id", "it", "ja", "nb-rNO", "nl", "pl", "pt-rBR", "ru", "sv", "tr", "zh-rCN" }