juliannojungle / pedal.guru Goto Github PK

View Code? Open in Web Editor NEW

9.0 2.0 1.0 432 KB

Pedal Guru is an open-source software for bicycle computers based on Raspberry Pi.

Home Page: http://pedal.guru

License: GNU Affero General Public License v3.0

C++ 100.00%

bike cyclecomputer altimetry bicycle computer gps map maps raspberry-pi raspberrypi

pedal.guru's Introduction

Pedal Guru

Pedal Guru (former OpenCC) is an open-source DIY project with the intention to bring useful resources that are appreciated by cyclists to easy-to-work platforms like Raspberry Pi and RP2040, in a more organized manner than usual apps offer us. The intention is to include integration with some popular services.

Note:

This project is under active develpment. The documentation is growing along the project as it's a work-in-progress. If interested, please check the development board and the reference diagram.

Hardware

This very first iteration of the project was based on the following devices:

1.28inch LCD Module, from WaveShare (using the GC9A01 overlay)

Raspberry Pi Zero W, from Raspberry Pi Foundation

Now, we're including the following embedded device:

RP2040-LCD-1.28, from WaveShare

Software

The RP2040-LCD-1.28 doesn't need an additional OS, since it can run C and C++ code natively (aka "bare metal").
In order to be able to use Raspberry Pi Zero W, we need an OS (operational system) to run our software on.

At this moment, we choose to use TinyCoreLinux, due the following reasons:

It's "frugal" install, the system loads itself into RAM from storage and executes from there. This way, we have a fresh start on each boot and the system is not susceptible to data loss from improper shutdown (we can actually just unplug the battery with no harm);
Straightforward: boots right to the prompt with the default user logged in with enought resources to load the interface, have internet access, use GPIO etc.;
Startup time gets quite low, with just a few seconds.

To use the GC9A01 based display on TinyCoreLinux, we need to follow this procedure.

^{@juliannojungle, 2022}

pedal.guru's People

Contributors

Stargazers

Watchers

Forkers

edilsoncorrea

pedal.guru's Issues

Integrate activities with Strava API

Requires two steps, to be able to upload the gpx file (otherwise the activity won't have a map on Strava):

Create project initial stucture

Create separate layers for:

GUI rendering
settings
pages
navigation
HID handling
devices handling
devices sensors handling
sensors protocols
data models
build targets
dependencies
integrations APIs

and so on.

Implement a generic device with GPS sensor and read it's data

Draw GPX route on map

Extract and serve bounding box from database, filtering by country, state and city

https://nominatim.openstreetmap.org/search?format=json&country=Brasil&state=RJ&city=Teresopolis

[
    {
        "place_id": 297625715,
        "licence": "Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright",
        "osm_type": "relation",
        "osm_id": 2219098,
        "boundingbox": [
            "-22.4701917",
            "-22.1223827",
            "-43.047406",
            "-42.7110277"
        ],
        "lat": "-22.4164578",
        "lon": "-42.975194",
        "display_name": "Teresópolis, Região Geográfica Imediata de Petrópolis, Região Geográfica Intermediária de Petrópolis, Rio de Janeiro, Região Sudeste, Brasil",
        "class": "boundary",
        "type": "administrative",
        "importance": 0.5822562765652282,
        "icon": "https://nominatim.openstreetmap.org/ui/mapicons/poi_boundary_administrative.p.20.png"
    }
]

Solve the backlight problem with TinyCoreLinux

The display overlay works great, but since TinyCoreLinux needs the respective drivers pre-loaded (and by default there's none), we need to figure out what drivers are needed to handle the backlight GPIO pin.

Workaround:

Just unplug the backlight pin, so the LCD backlight stays on max brightness.

References:

https://github.com/juliannojungle/gc9a01-tinycorelinux-tcz
http://forum.tinycorelinux.net/index.php/topic,25847.msg165774.html#msg165774

Converting tile x and y gives respectively the leftmost longitude and topmost latitude of the actual tile. Given x+1 and y+1 are the next tile topmost and leftmost coordinates, together they compose the actual tile's boundings. Calculate where is the actual latitude/longitude inside the tile based on that;
The actual latitude/longitude should be always at the center of the screen;
Tiles has 256x256 and the display has 240x240. Load next tile based on the displacement from the center (considering 8px negative padding);
There should be always 4 tiles loaded at a time, in a 2x2 grid arrangement;

Include an "update maps" button @ settings page

Include an "update maps" button @ settings page that opens the download page;
Create a download progress animation.

Elements:

Faded map on the background;
Progress ticks around the screen (like a ring);
QR code in the middle, pointing to the user settings webpage;
Warning to not leave the screen or shutdown the device, so the download is not interrupted.

Settings page shows a QR code to a full settings webpage

The user must be able to:

Add regions to offline maps;
Hide/show pages on device;
Login and link the device to a Strava account;

To be used by the tiles download system.
Must allow the user to include multiple areas to be offline (e.g. when crossing multiple cities).