Skip to content

eliinccustomerservice/COMPASS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

COMPASS

COMPASS is a circular motorcycle HUD built around a Raspberry Pi, a round 800×800 display, a physical LED ring, dual handlebar dials, and an iPhone companion app. It is meant to feel less like a phone strapped to a bike and more like a dedicated riding instrument.

What COMPASS Is

COMPASS combines:

  • a live circular map with route guidance
  • weather and radar awareness
  • compass and tilt-mode riding feedback
  • physical dial controls
  • a custom boot and lighting system designed for a real cockpit

The Pi-side runtime lives in this repo. The iPhone companion app, CompassLink, feeds navigation, GPS, and weather data into the Pi.

Why I Built It

I wanted a navigation and ride-information system that felt purpose-built for a motorcycle instead of inherited from a car or a phone. The goal was a UI that is legible at a glance, mechanically satisfying to use, and visually distinct enough to feel like its own product.

Current Status

The project is in active ride-tested prototype form.

Working well right now:

  • circular map UI
  • rerouting
  • weather presentation
  • compass mode
  • tilt mode
  • dial controls
  • custom boot sequence and LED handoff
  • hotspot switching and phone binding

Still in progress:

  • camera integration
  • long-term vibration hardening
  • enclosure and cable retention cleanup
  • sponsorship/demo packaging

Demo Media

Public reddit https://www.reddit.com/user/redknotsociety/

Riding Demo https://www.tiktok.com/@reformedeliinc/video/7619572877230214414

What Comes Next

  • finish the camera path
  • keep hardening the hardware for vibration and weather exposure
  • capture polished ride footage
  • package the project clearly enough for sponsorship outreach and pilot conversations

Repo Layout

  • docs/ Sponsor-facing GitHub Pages content.
  • media/ Demo clips, photos, and launch assets for public-facing sharing.
  • pi/ Pi runtime overview and deployment notes.
  • iphone/ Notes for the CompassLink companion app.
  • hardware/ Hardware stack, mechanical notes, and wiring references.

Pi Runtime

The current Pi application in this repo is still rooted in the existing runtime files:

Key runtime capabilities:

  • offline-friendly circular map rendering
  • phone-fed navigation and GPS
  • radar/weather overlays
  • LED ring animations and state feedback
  • IMU-backed compass and tilt mode
  • optional camera and crash-monitor paths

Run on macOS

cd /Users/eli173/Documents/Projects/compass_tk
python3 -m pip install -r requirements.txt
python3 compass_tk.py

Raspberry Pi Deploy

Canonical deploy path:

./scripts/deploy_pi.sh

That script syncs the repo to the Pi while preserving large runtime caches that are intentionally excluded.

Notes

  • This repo currently contains the working Pi runtime plus the new public-facing scaffolding.
  • The pi/, iphone/, hardware/, and media/ folders are the start of a cleaner sponsor-friendly structure, not a full source migration yet.

About

Compass Project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors