PEGGY SUE
Bike Control System
PI ONLINE
TRIP OFF
PI --°F
--:--:--
---
Trip Data Mode
REAL DATABASE ACTIVE
Stored test rides: 0. Test data is isolated from Peggy Sue’s real trip history.
Ride
GPS Speed
--
MPH
GPS NOT CONNECTED
Trip
0.0 MI
WAITING FOR GPS
Heading
--
GPS NOT CONNECTED
Outside Temp
-- °F
SENSOR NOT CONNECTED
Bike Voltage
--.- V
SENSOR NOT CONNECTED
Trip Recorder
STOPPED
NO ACTIVE TRIP
Trip --
Started --
Elapsed 00:00:00
Ready to record a trip.
GPS
J1850
TRIP
0 1 2 3 4 5 6
--
MPH
-- RPM
GEAR --
FUEL --%
VOLTS --.-
ENGINE --°
TRIP --
WAITING FOR SPEED DATA
--
MPH
0 20 40 60 80 100 120
GEAR --
WAITING FOR SPEED DATA
RPM
6 5 4 3 2 1 0
--
FUEL --%
VOLTAGE --.-V
ENGINE --°
TRIP --
OUTSIDE --°
PEGGY SUE
-- MPH
WAITING FOR SPEED DATA
▲ ---
TRIP-- MI
FUEL--%
VOLTS--.- V
OUTSIDE--°F
ENGINE--°F
ODOMETER-- MI
SPEED
--
MPH
WAITING FOR SPEED DATA
GPS -- MPH
BIKE -- MPH
RPM
--
GEAR --
FUEL
-- %
TRIP
-- MI
VOLTAGE
--.- V
ENGINE
-- °F
OUTSIDE
-- °F
ODOMETER
-- MI
Bike
Electrical
Bike Voltage
--.- V
SENSOR NOT CONNECTED
Auxbeam Current
--.- A
SENSOR NOT CONNECTED
LED Current
--.- A
SENSOR NOT CONNECTED
Temperatures
Pi Temperature
-- °F
Controller Box Temp
-- °F
SENSOR NOT CONNECTED
Outside Temp
-- °F
SENSOR NOT CONNECTED
System
System Uptime
--
Lights
Controller
WLED Live Status
Peggy Sue Lighting
CONNECTING TO WLED
Reading the current WLED state...
Quick Actions
Lighting Zones
Controls currently apply to all WLED segments.
Presets & Playlists
Loading presets from WLED...
Presets are created and edited in WLED.
Color
Applies a solid color to the currently selected zone.
Live Control
Brightness --%
Color #FFFFFF
Effect SOLID
Effect Speed 64
Effect Intensity 128
Live controls are ready.
Show
FPP Player
FPP Show Player
Peggy Sue Show Control
CHECKING FPP
Connecting to the local FPP player...
Audio
Show Volume
--%
Controls FPP audio output.
One-Touch Shows
One-Touch Show Scenes
Loading FPP playlists...
One tap starts a playlist. Blackout stops FPP and turns all WLED lighting off.
Audio Reactive
Live Audio Spectrum
63
100
160
250
400
630
1K
1.6K
2.5K
4K
6.3K
8K
10K
12K
16K
20K
AUDIO LIVE
Now Playing
Current Playlist
--
IDLE
Current Sequence
--
00:00 elapsed · 00:00 remaining
Show Progress
No show playing
Manual Show Control
Choose Playlist
Create a playlist in the FPP interface to enable Start Show.
Show Controls
Waiting for FPP status...
Bike Data
SIMULATION — NOT SAVED
Road-Test Simulator
Exercises the dashboard only. Nothing is saved as a ride.
AUTOMATIC DEMO
0 MPH TARGET
Condition: NORMAL
Connection
Harley Diagnostic Link
Harley J1850
INTERFACE NOT CONNECTED
Live motorcycle values will appear here when the J1850 interface is connected.
Live Overview
0
MPH
SPEED
0 — 120 MPH
900
RPM
TACH
0 — 6500 RPM
75
%
FUEL
E — F
Harley Diagnostic Data
J1850 Data Preview
SAMPLE DATA
These values are mocked for layout testing. They will be replaced with live motorcycle data when the diagnostic interface is connected.
Vehicle & Engine
Engine RPM
2,450 RPM
ENGINE RUNNING
Vehicle Speed
57 MPH
J1850
Bike Voltage
14.2 V
CHARGING
Estimated Gear
N
SIMULATED
Engine Temperature
155 °F
SIMULATED
Odometer
48,731 MI
Current Trip
Current Trip
86.4 MI
TRIP ACTIVE
Trip Max Speed
78 MPH
Engine Runtime
1h 42m
Trip Time
2h 08m
Ride Stats
LOADING RIDE HISTORY
Distance
Total Distance
-- MI
Recorded Distance
-- MI
Unrecorded Distance
-- MI
Longest Ride
-- MI
Ride Activity
Completed Rides
--
Total Ride Time
--
Longest Ride Time
--
Selected Period
TODAY
Speed
Average Speed
-- MPH
Top Speed
-- MPH
Mileage Trend
Mileage Trend — Today
Chart uses the automatic riding ledger. Recorded and unrecorded mileage both count. All Time displays the latest 12 riding months.
Reports
Ride History & Reports
Peggy Sue History
Ride history, mileage, trip statistics, trends, and records.
Current Trip
Trip Miles
-- MI
Ride Time
--
Average Speed
-- MPH
Maximum Speed
-- MPH
Mileage
Today
0.0 MI
This Week
0.0 MI
This Month
0.0 MI
Total Logged
0.0 MI
Performance
Engine Time Today
--
Engine Time Month
--
Highest Recorded Speed
0 MPH
Average Ride Speed
0.0 MPH
Electrical
Average Charging
-- V
Lowest Voltage
-- V
Highest Voltage
-- V
Peak Aux Current
-- A
Peak LED Current
-- A
Average LED Current
-- A
Temperatures
Outside Average
-- °F
Outside High
-- °F
Controller Max
-- °F
Pi Max Temp
-- °F
Ride Records
Longest Trip
0.0 MI
Longest Ride Time
0h 00m
Most Miles / Day
0.0 MI
Trips Logged
0
Mileage Reconciliation
Master Mileage
Loading mileage comparison...
Master Odometer
--
Since Baseline
--
Pi Recorded Miles
--
Coverage Gap
--
GPS Miles
--
GPS vs Odometer
--
Vehicle Feed Miles
--
Vehicle vs Odometer
--
Trip Recorded
--
Outside Trip Recorder
--
Recent Trips
No completed trips recorded yet.
Trip Details
Selected Trip
Select a trip above
Click a row in Recent Trips to view its statistics and route.
Maintenance
Service Status
Engine Oil
-- MI
No service recorded
NOT RECORDED
Primary Fluid
-- MI
No service recorded
NOT RECORDED
Transmission Fluid
-- MI
No service recorded
NOT RECORDED
Front Tire
-- MI
No tire recorded
NOT RECORDED
Rear Tire
-- MI
No tire recorded
NOT RECORDED
Odometer
Current Odometer
-- MI
Record Service
Record Fluid Change
Maintenance records are stored permanently on this Pi.
Record Tire
Record Tire Change
Tire History
Position Date Mileage Tire Notes Actions
No tire changes recorded yet.
Service History
Fluid Date Mileage Interval Actions
No maintenance records yet.
System
System Health
RUNNING SYSTEM CHECK
GPS STATUS
Checking GPS...
GPS USB
--
DATA
--
GPS SPEED
--
UPDATE AGE
--
LATITUDE
--
LONGITUDE
--
ALTITUDE
--
SOURCE
--
FIX TYPE
--
SATELLITES
--
HDOP
--
DEVICE
--
Fix type, satellites, and HDOP will populate when the GPS reader exposes those values.
Preparing checks...
LAST CHECK: --
Services
SERVICE CONTROLS
Restart a Peggy Sue service that is unresponsive. Each button controls one fixed, approved service.
No repair action is currently running.
CUSTOM / THIRD-PARTY SERVICES
Loading service inventory...
Backup & Recovery
CHECKING BACKUP STATUS...
BACKUP & RECOVERY
Project backups protect Peggy Sue configuration, databases, code, FPP setup and recovery information. Offline maps and MP3 music files are excluded.
QUICK: protects the frequently changing Peggy Sue project data. COMPLETE PROJECT: captures the broader Peggy Sue/FPP configuration needed to rebuild the dashboard. Offline maps and MP3 music files are intentionally excluded from both. AUTOMATIC: checks after ten minutes of uptime and every six hours, but only creates a Quick backup when the newest one is at least seven days old. Copies should still be downloaded to another device for protection against SD-card failure.
Loading backup status...
RECENT BACKUPS
VIEW ADMIN RUNBOOK
BACKUP DETAILS / RECOVERY INFO
WHAT IS BACKED UP
• Peggy Sue dashboard Python code and web interface
• Trip database and recorded ride samples
• Maintenance and tire history
• Dashboard settings and configuration
• FPP playlists, sequences and configuration files
• FPP configuration JSON backup
• Audio analyzer and EQ files
• GPS, GPIO, PipeWire and udev configuration
• Peggy Sue systemd services
• Chromium / Openbox kiosk configuration
• Network, hotspot and DNS configuration
• Debian and Python package inventories
• Root and FPP crontab information
• Restore instructions and SHA256 checksum

INTENTIONALLY NOT BACKED UP
• Offline map files
• MP3 music files
• Historical Peggy Sue backup archives
• Temporary files and SQLite WAL/SHM files
• Python caches and bytecode
• Old .before-* development safety copies
• Tailscale private machine identity / keys
• Raspberry Pi / FPP operating-system image

IMPORTANT DATABASES / DATA
Live trip database:
/home/fpp/media/config/peggy_trips.db

Test-mode trip database:
/home/fpp/media/config/peggy_test_trips.db

Maintenance and tire history:
/home/fpp/media/config/peggy_maintenance.json

IMPORTANT PEGGY SUE FILES
Dashboard backend:
/home/fpp/media/scripts/bike_dashboard.py

Dashboard web files:
/home/fpp/media/scripts/bike_dashboard_web/

Trip database support:
/home/fpp/trip_db.py

Trip logger:
/home/fpp/trip_logger.py

Audio service:
/home/fpp/audio_service.py

Backup engine:
/home/fpp/media/scripts/peggy_project_backup.py

Backup runner:
/home/fpp/media/scripts/peggy_backup_runner.py

BACKUP STORAGE
/home/fpp/media/backups/peggy/

RECOVERY NOTE
These backups are designed to rebuild the Peggy Sue project on a working Raspberry Pi/FPP installation. They are not full SD-card images. Offline maps and MP3 music should be downloaded or restored separately.
Pi Controls
PI CONTROLS
Restart or safely shut down the Raspberry Pi itself. These actions affect the entire Peggy Sue dashboard system.
No system power action is currently running.
Advanced
DIAGNOSTIC TOOLS
Create a timestamped troubleshooting report containing system health, service states, hardware detection, storage, network status, and recent Peggy Sue service logs.
DOWNLOAD DIAGNOSTIC REPORT
Passwords, authentication keys, and private configuration secrets are excluded.

Settings

PEGGY SUE SETTINGS
Peggy Sue Configuration
Settings are saved on the Pi and loaded by every dashboard device.
SETTINGS LOADED
General & Display
General & Startup
Clock and Date
Pi system timezone
Preview
--:--:--
---
Startup
The startup page appears whenever the dashboard opens or refreshes.
Display & Touch
Interface
Controls the pointer on Peggy Sue's local Chromium kiosk. Touch input and mouse clicks continue working when hidden.
Night Dimming
This dims the dashboard interface. Hardware backlight control can be added if the final screen supports it.
Vehicle & Hardware
Vehicle Profile
Bike Name
Use 1–40 characters. This changes display labels only; it does not rename the Pi, services, files, or backups.
Vehicle Details
Starting odometer records the mileage at initial setup. It does not overwrite live motorcycle or trip mileage.
Fuel Tank
Rated capacity is the manufacturer specification. Planning capacity is the conservative amount used for future range estimates. Adjust it from real fill-up history.
Lighting Hardware
WLED Controller
CHECKING CONTROLLER
Firmware—
Controller—
LEDs—
Outputs—
Frame rate—
Temperature—
Uptime—
Free memory—
Waiting for WLED status.
The controller address is what Peggy Sue uses to reach WLED. The WLED hostname creates a local address such as peggy-wled.local.
OPEN WLED BY IP ADDRESS OPEN WLED BY HOSTNAME
Test the connection to load both WLED links.
Enter an IP address or local hostname, then test it.
Setup Notes
Examples: 192.168.1.226, wled.local, or http://192.168.1.226. The address is stored in the dashboard configuration and can be changed without editing program files.
Installed Hardware & Modules
Optional Features
How Modules Work
A module marked Not installed is removed from navigation and its browser polling is stopped. Peggy Sue currently has all three modules installed.
Navigation
Visible Pages
CONFIG always remains available so you cannot lock yourself out.
Page Order
Use the arrows to arrange the navigation buttons. CONFIG remains last.
Dashboard & Navigation
Dashboard Gauges
Gauge Layout
Changes the gauge arrangement only. Your normal dashboard theme still controls the overall colors and appearance.
Speed
Engine RPM
Match these values to the ECU tune or dyno sheet. Dashboard warnings do not change the ECU rev limiter.
Preview Behavior
Touring — large numeric speed with RPM and information cards.
Classic — round speedometer and tachometer.
EQ / Bars — vertical segmented speed and RPM displays.
Minimal — speed, RPM, fuel, gear and trip only.
DASH SETTINGS READY
Ride & Data
Trips & Maps
Map Defaults
Trip Safety
Automatic GPS trip start/stop Waiting for the real GPS receiver to be connected and road-tested.
System & Safety
Backup Preferences
Backup Health
Color Key
GREEN — Fresh BLUE — Current ORANGE — Older than warning limit RED — Missing or failed
Safety & Controls
Confirmations
Touch Lock
Touch Lock will never remain locked after a dashboard reload or Pi restart.
Power Loss Shutdown
If GPIO18 returns HIGH before this timer expires, the pending shutdown is canceled automatically.
Units & Data Display
Units
Precision
Development & Testing
Development & Testing
GLOBAL TEST MODE
PRODUCTION MODE
When Test Mode is off, Peggy Sue uses real/live data only. Simulation, Road-Test, sample-data controls, and the isolated test trip database are hidden and inactive. Test data is preserved and can be enabled again later.