Changes from commaai#177 commaai#178 commaai#179

Update files (that don't need translation) from recent Pull Requests from @adeebshihadeh

Author: jpaoad31

README.md

@@ -16,3 +16,10 @@ bun dev
 Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
 
 You can start editing the page by modifying `src/app/index.jsx`. The page auto-updates as you edit the file.
+
+
+**Helpful for debugging**
+* [chrome://usb-internals/](chrome://usb-internals/)
+* [chrome://device-log/](chrome://device-log/)
+* Add `?fast=1` to the URL to skip flashing the system partition (the slowest). Useful for testing the full flow quickly.
+* Add `?windows=1` to the URL to force Windows mode (shows Zadig driver instructions). Useful for testing the Windows flow on other platforms.

deploy-preview.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -e
+
+BRANCH="${1:-$(git branch --show-current)}"
+
+bun run build
+bunx wrangler pages deploy dist --project-name=connect --branch="$BRANCH"
+
+echo ""
+echo "Preview URL: https://${BRANCH}.connect-d5y.pages.dev"

src/app.html

@@ -6,7 +6,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta
       name="description"
-      content="Update your comma device to the latest software"
+      content="Restore your comma device to a fresh factory state"
     />
     <title>flash.comma.ai</title>
     %sveltekit.head%

src/lib/config.js

@@ -3,7 +3,6 @@ const config = {
     release_mici: 'https://raw.githubusercontent.com/commaai/openpilot/ccf7361798a2b7ff36f5065dffb602eb40c22302/system/hardware/tici/all-partitions.json',
     release_tizi: 'https://raw.githubusercontent.com/commaai/openpilot/927548621be1be0c2c9063868b93d1f5020904de/system/hardware/tici/all-partitions.json',
     release_tici: 'https://raw.githubusercontent.com/commaai/openpilot/927548621be1be0c2c9063868b93d1f5020904de/system/hardware/tici/all-partitions.json',
-    master: 'https://raw.githubusercontent.com/commaai/openpilot/master/system/hardware/tici/all-partitions.json',
   },
   loader: {
     url: 'https://raw.githubusercontent.com/commaai/flash/master/src/QDL/programmer.bin',

src/lib/images/comma3X.webp

@@ -9,7 +9,7 @@ import { fetchStream } from "./stream";
  * @returns {void}
  */
 
-const MIN_QUOTA_MB = 5250;
+const MIN_QUOTA_GB = 5.25;
 
 export class ImageManager {
   /** @type {FileSystemDirectoryHandle} */
@@ -18,14 +18,22 @@ export class ImageManager {
   async init() {
     if (!this.root) {
       this.root = await globalThis.navigator.storage.getDirectory()
-      await this.root.remove({ recursive: true })
+      // Clean up any leftover files from previous sessions
+      try {
+        await this.root.remove({ recursive: true })
+      } catch (e) {
+        // Ignore errors - directory might not exist or be empty
+        console.debug('[ImageManager] Could not remove old directory:', e)
+      }
+      // Re-get the directory after removal
+      this.root = await navigator.storage.getDirectory()
       console.info('[ImageManager] Initialized')
     }
 
     const estimate = await globalThis.navigator.storage.estimate()
-    const quotaMB = (estimate.quota || 0) / (1024 ** 2)
-    if (quotaMB < MIN_QUOTA_MB) {
-      throw new Error(`Not enough storage: ${quotaMB.toFixed(0)}MB free, need ${MIN_QUOTA_MB.toFixed(0)}MB`)
+    const quotaGB = (estimate.quota || 0) / (1024 ** 3)
+    if (quotaGB < MIN_QUOTA_GB) {
+      throw new Error(`Not enough storage: ${quotaGB.toFixed(1)}GB free, need ${MIN_QUOTA_GB.toFixed(1)}GB`)
     }
   }
 

src/lib/images/four_screen_on.webp

@@ -5,15 +5,29 @@ import { getManifest } from './manifest'
 import config from '../config'
 import { createSteps, withProgress } from './progress'
 
+// Fast mode for development - skips flashing system partition (the slowest)
+// Enable with ?fast=1 in URL
+const FAST_MODE = new URLSearchParams(window.location.search).has('fast')
+if (FAST_MODE) {
+  console.warn('[Flash] FAST MODE ENABLED - skipping system partition')
+}
+
 export const StepCode = {
   INITIALIZING: 0,
   READY: 1,
-  CONNECTING: 2,
-  REPAIR_PARTITION_TABLES: 3,
-  ERASE_DEVICE: 4,
-  FLASH_SYSTEM: 5,
-  FINALIZING: 6,
-  DONE: 7,
+  DEVICE_PICKER: 2,
+  CONNECTING: 3,
+  REPAIR_PARTITION_TABLES: 4,
+  ERASE_DEVICE: 5,
+  FLASH_SYSTEM: 6,
+  FINALIZING: 7,
+  DONE: 8,
+}
+
+// Device types for the picker
+export const DeviceType = {
+  COMMA_3: 'comma3',  // comma 3 or 3X
+  COMMA_4: 'comma4',  // comma four
 }
 
 export const ErrorCode = {
@@ -181,9 +195,10 @@ export class FlashManager {
     } catch (err) {
       console.error('[Flash] Failed to initialize image worker')
       console.error(err)
-      if (err instanceof String && err.startsWith('Not enough storage')) {
+      const message = err?.message || String(err)
+      if (message.startsWith('Not enough storage')) {
         this.#setError(ErrorCode.STORAGE_SPACE)
-        this.#setMessage(err)
+        this.#setMessage(message)
       } else {
         this.#setError(ErrorCode.UNKNOWN)
       }
@@ -210,6 +225,12 @@ export class FlashManager {
     try {
       await this.device.connect(usb)
     } catch (err) {
+      // User cancelled the WebUSB dialog or no device was selected - not an error
+      if (err.name === 'NotFoundError') {
+        console.info('[Flash] No device selected')
+        this.#setStep(StepCode.READY)
+        return
+      }
       console.error('[Flash] Connection error', err)
       this.#setError(ErrorCode.LOST_CONNECTION)
       this.#setConnected(false)
@@ -353,10 +374,16 @@ export class FlashManager {
     this.#setProgress(0)
 
     // Exclude GPT images and persist image, and pick correct userdata image to flash
-    const systemImages = this.manifest
+    let systemImages = this.manifest
       .filter((image) => !image.gpt && image.name !== 'persist')
       .filter((image) => !image.name.startsWith('userdata_') || image.name === this.#userdataImage)
 
+    // In fast mode, skip the system partition (slowest to flash)
+    if (FAST_MODE) {
+      systemImages = systemImages.filter((image) => image.name !== 'system')
+      console.info('[Flash] Fast mode: skipping system partition')
+    }
+
     if (!systemImages.find((image) => image.name === this.#userdataImage)) {
       console.error(`[Flash] Did not find userdata image "${this.#userdataImage}"`)
       this.#setError(ErrorCode.UNKNOWN)
@@ -414,7 +441,8 @@ export class FlashManager {
   async start() {
     if (this.step !== StepCode.READY) return
     await this.#connect()
-    if (this.error !== ErrorCode.NONE) return
+    // Check if connection was cancelled (step went back to READY) or failed
+    if (this.step === StepCode.READY || this.error !== ErrorCode.NONE) return
     let start = performance.now()
     await this.#repairPartitionTables()
     console.info(`Repaired partition tables in ${((performance.now() - start) / 1000).toFixed(2)}s`)