Contact location pins + on-demand Send GPS (#64 groundwork)

.gitignore

@@ -1,4 +1,6 @@
 .pio
+platformio_override.ini
+BUILD_NOTES.local.md
 .platformio-core/
 .vscode/.browse.c_cpp.db*
 .vscode/c_cpp_properties.json

README.md

@@ -98,6 +98,42 @@ AP mode exposes a local TCP endpoint for a nearby Reticulum host:
 The bridging UI and interface behavior may change as Ratspeak's client release
 stabilizes.
 
+## Battery
+
+The stock T-Deck Plus battery is read through a fixed ADC voltage-divider
+ratio. Third-party/extended battery packs are commonly wired through a
+different divider network on their sense line, which can make the reported
+voltage (and therefore percentage) wrong even though the battery itself is
+fine — e.g. reading ~69% when actually fully charged.
+
+Tested and confirmed working with a
+[makernova.io](https://makernova.io/) 8000mAh pack (JST 1.25 connector) in
+[AlleyCat's extended T-Deck Plus case](https://www.printables.com/model/1345336)
+(3D-printed, Printables #1345336).
+
+If your battery percentage looks wrong, calibrate the ADC divider ratio
+against a multimeter reading on the battery terminals (ideally with USB
+disconnected, to avoid charge-line voltage bias):
+
+```
+b            # print raw ADC, computed voltage, divider ratio, percent
+B<ratio>     # set + persist a new divider ratio, e.g. B1.8762
+```
+
+over the device's serial console (115200 baud). The firmware computes the
+correct ratio for you from a live raw ADC reading + your multimeter value —
+see the in-firmware `b` output for the exact formula. Settings persist across
+reboots and firmware updates (stored alongside your identity/config, not
+touched by a normal OTA/reflash).
+
+The `Charge Above` and `Full Threshold` settings (Settings → Battery, hold
+trackball click to reveal developer controls) are separate knobs:
+`Charge Above` is the voltage above which the device assumes it's actively on
+a charger (typically just under the LiPo absolute max of ~4.2V, not the
+resting-full voltage); `Full Threshold` compensates the discharge curve for
+your particular pack's typical resting-voltage sag under load. They're not
+meant to be compared to each other directly.
+
 ## Build From Source
 
 ```bash

lib/pngle/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 kikuchan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lib/pngle/library.json

@@ -0,0 +1,27 @@
+{
+  "name": "pngle",
+  "version": "1.1.0",
+  "description": "A stream based portable PNG Loader for Embedding",
+  "keywords": "png, png-loader, png-decoder, c, arduino, mbed, esp32, esp8266, stm32, m5stack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kikuchan/pngle.git"
+  },
+  "authors": [
+    {
+      "name": "kikuchan",
+      "email": "kikuchan98@gmail.com"
+    }
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/kikuchan/pngle",
+  "export": {
+    "include": [
+        "src",
+        "examples/**/*.ino",
+        "examples/**/*.c"
+    ]
+  },
+  "frameworks": "*",
+  "platforms": "*"
+}

lib/pngle/library.properties

@@ -0,0 +1,10 @@
+name=pngle
+version=1.1.0
+author=kikuchan
+maintainer=kikuchan
+sentence=A stream based portable PNG Loader for Embedding
+paragraph=A memory frugal stream based portable PNG image for decoder embedded systems. All standard types of PNG files are supported (as tested with PngSuite), including interlaced images.
+category=Display
+url=https://github.com/kikuchan/pngle
+architectures=*
+includes=pngle.h

lib/pngle/miniz.h

@@ -0,0 +1,2 @@
+#define MINIZ_HEADER_FILE_ONLY
+#include "./miniz.c"