
Ripple Qwerty Pager 'Ultra' firmware - for T-Deck 
=================================================

Flash ONE OF THE .bin file to your T-Deck: 
  * For first-time install
      Flash one of the " -merged.bin" files   (IMPORTANT: flash to OFFSET 0)
  * -OR-,  to update
      Flash one of the non-merged files    (IMPORTANT: flash to OFFSET 0x10000)

For each -merged, or non-merged, there are TWO variants:
   * the  ".. -SD" file is for storing all config/contacts on the SD card
   * the non-SD file is for storing config/contacts in internal flash

If you need help with how to flash the firmware, there is a guide here:
   https://buymeacoffee.com/ripplebiz/flashing-firmware-bin-esp32


How To Get Maps on your SD Card
===============================

The map renderer expects raster tiles in the "/tiles" root directory of the SD card.
These must be in the scheme used by the old Google Maps tile system, and the OpenStreetMap
raster tile system. The files/directories are expected in the scheme: 
    /tiles/{zoom}/{x}/{y}.png

Each tile PNG file must be a 256x256 image.

There are many ways to obtain these tiles, but a simple Arduino sketch is available here:
   https://github.com/spleenware/ripple/tree/master/TileDownloader

You just run this sketch on your T-Deck, with the SD-card inserted, and it downloads the tiles
over WiFi. You must edit the sketch, though, and supply your WiFi SSID/password, and the lat/lng
bounds and zoom levels to download. Open the Serial Monitor to see the progress.

Here is a handy site for obtaining the lat/lng bounds visually:
   https://tools.geofabrik.de/calc/

Alberto Cajiao has kindly donated a Python script you can run on your laptop for downloading tiles via the Thunderforest API: 
   https://github.com/fistulareffigy/MTD-Script

There are two tile sets available for purchase:
  Europe - https://buymeacoffee.com/ripplebiz/e/342543
  USA - https://buymeacoffee.com/ripplebiz/e/342542

Free, But Limited
=================

This software uses the 'freemium' model. Most of the features are free, but the more advanced 
features will require you to purchase an Unlock Code. The Unlock Code can be purchased by 
going to the link below and purchasing the Unlock Code:
   https://buymeacoffee.com/ripplebiz/e/249834

NOTE: you MUST enter your Serial Number (displayed on the T-Deck) when prompted during the purchase
of the digital item. You will receive a reply message with your Unlock Code, which you then 
enter into the Unlock screen on the T-Deck.
