Updated for Tornado

Author: zlite

donkeycar/utilities/TrackSpeedPlanner/.gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.DS_Store
+server/public
+vite.config.ts.*
+*.tar.gz

donkeycar/utilities/TrackSpeedPlanner/.replit

@@ -1,4 +1,4 @@
-modules = ["nodejs-20", "web", "postgresql-16"]
+modules = ["nodejs-20", "web", "postgresql-16", "python-3.11"]
 run = "npm run dev"
 hidden = [".config", ".git", "generated-icon.png", "node_modules", "dist"]
 
@@ -14,6 +14,10 @@ run = ["npm", "run", "start"]
 localPort = 5000
 externalPort = 80
 
+[[ports]]
+localPort = 5001
+externalPort = 3000
+
 [workflows]
 runButton = "Project"
 

donkeycar/utilities/TrackSpeedPlanner/README-Pi-Quick-Start.md

@@ -0,0 +1,49 @@
+# Quick Start Guide - Raspberry Pi Deployment
+
+## For Donkey Car Path Data Editor
+
+### 1. Copy to Pi
+```bash
+scp -r . pi@your-pi-ip:/home/pi/path-editor/
+```
+
+### 2. Deploy
+```bash
+ssh pi@your-pi-ip
+cd /home/pi/path-editor
+chmod +x deploy-pi-tornado.sh
+./deploy-pi-tornado.sh
+```
+
+### 3. Start Server
+```bash
+./trackeditor.sh
+```
+
+### 4. Access
+Open browser: `http://your-pi-ip:5000`
+
+### 5. Stop Server
+- Use Exit button in web interface
+- Or press Ctrl+C in terminal
+
+---
+
+## Features
+- Upload CSV path files (drag & drop)
+- Interactive path visualization
+- Edit speed values by clicking points
+- Export modified CSV files
+- Works on all Pi models (Zero to Pi 5)
+
+## Files Included
+- `server-tornado.py` - Main Python server
+- `trackeditor.sh` - Simple startup script  
+- `deploy-pi-tornado.sh` - Installation script
+- `static/index.html` - Complete web interface
+- `uninstall-pi.sh` - Cleanup script
+
+## Troubleshooting
+- **Server won't start**: Check `python3 --version` (need 3.6+)
+- **Can't access**: Use Pi's actual IP, not localhost
+- **Tornado missing**: Run `python3 -m pip install --user tornado`

donkeycar/utilities/TrackSpeedPlanner/README-RaspberryPi.md

@@ -24,16 +24,37 @@ This guide helps you deploy the Path Data Visualizer & Editor on a Raspberry Pi
    ./deploy-pi-simple.sh
    ```
 
-3. **Access your application:**
+   *Note: The deployment script automatically cleans up any previous installation.*
+
+## Reinstalling or Updating
+
+If you need to reinstall or had a previous version installed:
+
+1. **Clean uninstall (optional):**
+   ```bash
+   chmod +x uninstall-pi.sh
+   ./uninstall-pi.sh
+   ```
+
+2. **Then run the deployment script normally**
+
+The deployment script automatically handles cleanup, but you can manually uninstall first if needed.
+
+3. **Start the server manually:**
+   ```bash
+   python3 start-server.py
+   ```
+
+4. **Access your application:**
    Open a browser and go to: `http://your-pi-ip:5000`
 
 ## What the deployment script does:
 
 - Installs Node.js 20 if not present
 - Installs project dependencies
 - Builds the application with ESM compatibility fixes
-- Creates a systemd service for auto-start
-- Starts the service and enables it to run on boot
+- Creates manual start scripts (no auto-start on boot)
+- Provides both Python and shell script options
 
 ## Manual Setup (if script fails)
 
@@ -55,15 +76,16 @@ This guide helps you deploy the Path Data Visualizer & Editor on a Raspberry Pi
 
 4. **Start manually:**
    ```bash
+   python3 start-server.py
+   # OR
    NODE_ENV=production PORT=5000 node dist/start-production.js
    ```
 
-## Service Management
+## Starting the Server
 
-- **Check status:** `sudo systemctl status path-editor`
-- **View logs:** `sudo journalctl -u path-editor -f`
-- **Restart:** `sudo systemctl restart path-editor`
-- **Stop:** `sudo systemctl stop path-editor`
+- **Python launcher:** `python3 start-server.py` (recommended)
+- **Shell script:** `./start-server.sh` 
+- **Direct Node.js:** `NODE_ENV=production PORT=5000 node dist/start-production.js`
 
 ## Network Access
 

donkeycar/utilities/TrackSpeedPlanner/README-Tornado.md

@@ -0,0 +1,166 @@
+# Tornado Python Server Deployment for Raspberry Pi
+
+This is a Python-based alternative to the Node.js deployment, using the Tornado web server that's already available on most Raspberry Pi systems.
+
+## Why Use Tornado Version? (Recommended)
+
+- **No Node.js required**: Uses existing Python environment on Pi
+- **Lightweight**: Better performance on all Pi models including Pi Zero
+- **Minimal dependencies**: Only requires Python and Tornado (usually pre-installed)
+- **Faster setup**: No compilation or build steps needed
+- **Same functionality**: Full CSV upload, editing, and export features
+- **Identical UI**: Same web interface as Node.js version
+- **Better reliability**: Python's stability on embedded systems
+
+## Quick Deployment
+
+1. **Copy files to your Pi:**
+   ```bash
+   scp -r . pi@your-pi-ip:/home/pi/path-editor/
+   ```
+
+2. **SSH into your Pi and run Tornado deployment:**
+   ```bash
+   ssh pi@your-pi-ip
+   cd /home/pi/path-editor
+   chmod +x deploy-pi-tornado.sh
+   ./deploy-pi-tornado.sh
+   ```
+
+3. **Start the server:**
+   ```bash
+   ./trackeditor.sh
+   # OR
+   python3 server-tornado.py
+   ```
+
+4. **Access your application:**
+   Open browser: `http://your-pi-ip:5000`
+
+## Features
+
+- **CSV Upload**: Drag-and-drop or browse for path data files
+- **Interactive Visualization**: Canvas-based path display with speed colors
+- **Speed Editing**: Click points to adjust speed values (0.1-1.0)
+- **CSV Export**: Download modified path data
+- **Exit Button**: Clean server shutdown via web interface
+- **Mobile Responsive**: Works on phones and tablets
+
+## File Structure
+
+```
+path-editor/
+├── server-tornado.py      # Main Tornado web server
+├── start-tornado.py       # Startup script
+├── deploy-pi-tornado.sh   # Deployment script
+├── static/
+│   └── index.html        # Complete web interface
+└── uninstall-pi.sh       # Cleanup script
+```
+
+## Manual Setup
+
+If the deployment script fails:
+
+1. **Install dependencies:**
+   ```bash
+   python3 -m pip install --user tornado
+   ```
+
+2. **Run server directly:**
+   ```bash
+   python3 server-tornado.py --port=5000
+   ```
+
+## Server Options
+
+The Tornado server supports command-line options:
+
+```bash
+python3 server-tornado.py --port=5000 --debug
+```
+
+Options:
+- `--port=PORT`: Server port (default: 5000)
+- `--debug`: Enable debug mode with auto-reload
+
+## API Endpoints
+
+- `GET /`: Main application interface
+- `POST /api/upload`: CSV file upload
+- `POST /api/export`: CSV file export
+- `POST /api/shutdown`: Server shutdown
+- `GET /api/health`: Health check
+
+## Performance Notes
+
+- **Raspberry Pi Zero/1**: Works but may be slow with large files
+- **Raspberry Pi 2/3**: Good performance for typical donkey car paths
+- **Raspberry Pi 4+**: Excellent performance, handles large datasets
+
+## Troubleshooting
+
+### Server Won't Start
+```bash
+# Check Python version (3.6+ required)
+python3 --version
+
+# Install Tornado if missing
+python3 -m pip install --user tornado
+
+# Check if port is in use
+sudo netstat -tlnp | grep :5000
+```
+
+### Can't Access from Network
+```bash
+# Check Pi's IP address
+hostname -I
+
+# Test locally first
+curl http://localhost:5000/api/health
+
+# Check firewall (if enabled)
+sudo ufw status
+```
+
+### Memory Issues
+```bash
+# Check available memory
+free -h
+
+# For large CSV files, consider splitting them
+# Or use Pi 4 with more RAM
+```
+
+## Comparison with Node.js Version
+
+| Feature | Tornado | Node.js |
+|---------|---------|---------|
+| Setup Time | Faster | Slower |
+| Dependencies | Minimal | Many |
+| Memory Usage | Lower | Higher |
+| Performance | Good | Excellent |
+| Compatibility | All Pi models | Pi 3+ recommended |
+
+## Integration with Donkey Car
+
+The Tornado version is ideal for donkey car integration:
+
+1. **Lightweight**: Runs alongside other Pi services
+2. **Quick Start**: No compilation, instant startup
+3. **Reliable**: Python's stability on Pi systems
+4. **Portable**: Easy to backup and restore
+
+## Development
+
+To modify the server:
+
+1. Edit `server-tornado.py` for backend changes
+2. Edit `static/index.html` for frontend changes
+3. Restart server to see changes
+
+The server includes auto-reload in debug mode:
+```bash
+python3 server-tornado.py --debug
+```

donkeycar/utilities/TrackSpeedPlanner/client/src/pages/path-editor.tsx

@@ -1,21 +1,41 @@
 import { useState } from "react";
-import { Route } from "lucide-react";
+import { Route, Power } from "lucide-react";
 import { PathDataPoint } from "@shared/schema";
 import { FileUpload } from "@/components/file-upload";
 import { PathCanvas } from "@/components/path-canvas";
 import { SpeedControls } from "@/components/speed-controls";
+import { Button } from "@/components/ui/button";
+import { useToast } from "@/hooks/use-toast";
+import { apiRequest } from "@/lib/queryClient";
 
 export default function PathEditor() {
   const [pathData, setPathData] = useState<PathDataPoint[]>([]);
   const [selectedPointIndex, setSelectedPointIndex] = useState(-1);
   const [fileName, setFileName] = useState<string>("");
+  const { toast } = useToast();
 
   const handleDataLoaded = (data: PathDataPoint[], loadedFileName: string) => {
     setPathData(data);
     setFileName(loadedFileName);
     setSelectedPointIndex(-1);
   };
 
+  const handleShutdown = async () => {
+    try {
+      toast({
+        title: "Shutting down server...",
+        description: "The server will stop in a few seconds.",
+      });
+
+      await apiRequest('POST', '/api/shutdown');
+    } catch (error) {
+      // Expected error since server shuts down before response
+      setTimeout(() => {
+        window.location.href = 'about:blank';
+      }, 2000);
+    }
+  };
+
   const handleSpeedChange = (index: number, newSpeed: number) => {
     const updatedData = [...pathData];
     updatedData[index] = { ...updatedData[index], speed: newSpeed };
@@ -45,6 +65,15 @@ export default function PathEditor() {
               <Route className="text-primary text-2xl mr-3 w-8 h-8" />
               <h1 className="text-xl font-semibold text-gray-900">Path Data Visualizer & Editor</h1>
             </div>
+            <Button
+              variant="outline"
+              size="sm"
+              onClick={handleShutdown}
+              className="flex items-center gap-2 text-red-600 border-red-200 hover:bg-red-50 hover:border-red-300"
+            >
+              <Power className="w-4 h-4" />
+              Exit
+            </Button>
           </div>
         </div>
       </header>