Add Debug Script to simulator menu with dynamic menu abstraction

- Debug Script loads main.py from GitHub raw URL
- Debug challenge always fetches fresh code (no localStorage cache)
- Abstract Challenge Simulator menu to single source in challenges.js
- Both simulator.html and docs.html use Challenges.populateMenu()
- Updated main.py to use hold_state instead of time.sleep
- Removed def main() wrapper for Skulpt compatibility
- Fixed ultrasonic warning system in aidriver.py

Author: benpaddlejones

_Firmware/AI_Driver_RP2040.uf2

@@ -1,4 +1,4 @@
-Build Date: Sat Jan 10 02:43:16 UTC 2026
+Build Date: Sat Jan 10 03:23:12 UTC 2026
 MicroPython Version: v1.28.0-preview-62-g0fd084363 (0fd084363, 2026-01-09)
 Custom Modules: 3 files
 Build Host: codespaces-35b014

_Firmware/build_info.txt

@@ -233,60 +233,18 @@
               <a
                 class="nav-link dropdown-toggle"
                 href="#"
-                id="simulatorDropdown"
+                id="challengeDropdown"
                 role="button"
                 data-bs-toggle="dropdown"
               >
                 <i class="bi bi-play-circle me-1"></i>Challenge Simulator
               </a>
-              <ul class="dropdown-menu" aria-labelledby="simulatorDropdown">
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=0">
-                    <i class="bi bi-wrench me-2"></i>Challenge 0: Fix the Code
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=1">
-                    <i class="bi bi-arrow-up me-2"></i>Challenge 1: Straight
-                    Line
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=2">
-                    <i class="bi bi-circle me-2"></i>Challenge 2: Drive a Circle
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=3">
-                    <i class="bi bi-rulers me-2"></i>Challenge 3: Distance
-                    Sensor
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=4">
-                    <i class="bi bi-square me-2"></i>Challenge 4: Drive a Square
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=5">
-                    <i class="bi bi-exclamation-triangle me-2"></i>Challenge 5:
-                    Obstacle Avoidance
-                  </a>
-                </li>
-                <li><hr class="dropdown-divider" /></li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=6">
-                    <i class="bi bi-signpost-split me-2"></i>Challenge 6: Maze
-                    Navigation
-                  </a>
-                </li>
-                <li>
-                  <a class="dropdown-item" href="simulator.html?challenge=7">
-                    <i class="bi bi-controller me-2"></i>Challenge 7: Gamepad
-                    Control
-                  </a>
-                </li>
-              </ul>
+              <!-- Menu populated dynamically from Challenges.populateMenu() -->
+              <ul
+                class="dropdown-menu"
+                id="challengeSimulatorMenu"
+                aria-labelledby="challengeDropdown"
+              ></ul>
             </li>
 
             <!-- Downloads Dropdown -->
@@ -499,5 +457,13 @@
         loadMarkdown(getDocFromUrl());
       });
     </script>
+    <!-- Challenges module for dynamic menu -->
+    <script src="js/challenges.js?v=14"></script>
+    <script>
+      // Populate the challenge simulator menu after challenges.js loads
+      if (typeof Challenges !== "undefined") {
+        Challenges.populateMenu("#challengeSimulatorMenu", "simulator");
+      }
+    </script>
   </body>
 </html>

app/docs.html

@@ -479,13 +479,18 @@ function loadChallenge(challengeId) {
   // Clear any existing error markers
   Editor.clearAllMarkers();
 
-  // Try to load saved code, otherwise load starter code
-  const savedCode = Editor.loadSavedCode(challengeId);
-  if (savedCode) {
-    Editor.setCode(savedCode);
-    logDebug(`Loaded saved code for Challenge ${challengeId}`);
-  } else {
+  // Debug challenge always loads fresh from main.py (no saved code)
+  // Other challenges try saved code first, then starter code
+  if (challengeId === "debug") {
     loadStarterCode(challengeId);
+  } else {
+    const savedCode = Editor.loadSavedCode(challengeId);
+    if (savedCode) {
+      Editor.setCode(savedCode);
+      logDebug(`Loaded saved code for Challenge ${challengeId}`);
+    } else {
+      loadStarterCode(challengeId);
+    }
   }
 
   // Store current challenge config
@@ -560,8 +565,31 @@ function loadChallenge(challengeId) {
 
 /**
  * Load starter code for a challenge
+ * For debug challenge, fetches from project/main.py
  */
-function loadStarterCode(challengeId) {
+async function loadStarterCode(challengeId) {
+  // Debug challenge loads from project/main.py via GitHub raw
+  if (challengeId === "debug") {
+    try {
+      const response = await fetch(
+        "https://raw.githubusercontent.com/TempeHS/AIDriver_MicroPython_Challanges/refs/heads/main/project/main.py"
+      );
+      if (response.ok) {
+        const code = await response.text();
+        Editor.setCode(code);
+        logDebug("[App] Loaded starter code from project/main.py");
+        return;
+      }
+    } catch (err) {
+      console.warn("[App] Could not fetch project/main.py:", err);
+    }
+    // Fallback if fetch fails
+    Editor.setCode(
+      "# Could not load project/main.py\n# Check your internet connection\n"
+    );
+    return;
+  }
+
   const starterCodes = getStarterCodes();
   const code = starterCodes[challengeId] || "# No starter code available\n";
   Editor.setCode(code);
@@ -571,9 +599,9 @@ function loadStarterCode(challengeId) {
 /**
  * Reset to starter code (discard changes)
  */
-function resetToStarterCode() {
+async function resetToStarterCode() {
   Editor.clearSavedCode(App.currentChallenge);
-  loadStarterCode(App.currentChallenge);
+  await loadStarterCode(App.currentChallenge);
   logDebug("[App] Code reset to starter code");
 }
 
@@ -1853,60 +1881,11 @@ function hideLoading() {
 
 /**
  * Get starter codes for all challenges
+ * Note: Debug challenge code is fetched from project/main.py in loadStarterCode()
  */
 function getStarterCodes() {
   return {
-    debug: `# Debug Script: Hardware Sanity Test
-# Runs a sequence of movements and distance readings
-# This mirrors project/main.py for testing on real hardware
-
-from aidriver import AIDriver, hold_state
-import aidriver
-
-aidriver.DEBUG_AIDRIVER = True
-
-print("Initialising AIDriver hardware test...")
-my_robot = AIDriver()
-
-print("Starting tests in 3 seconds. Ensure clear space around the robot.")
-hold_state(3)
-
-# Test 1: Drive Forward
-print("Test 1: drive_forward")
-my_robot.drive_forward(200, 200)
-hold_state(2)
-my_robot.brake()
-hold_state(1)
-
-# Test 2: Drive Backward
-print("Test 2: drive_backward")
-my_robot.drive_backward(200, 200)
-hold_state(2)
-my_robot.brake()
-hold_state(1)
-
-# Test 3: Rotate Right
-print("Test 3: rotate_right")
-my_robot.rotate_right(200)
-hold_state(2)
-my_robot.brake()
-hold_state(1)
-
-# Test 4: Rotate Left
-print("Test 4: rotate_left")
-my_robot.rotate_left(200)
-hold_state(2)
-my_robot.brake()
-hold_state(1)
-
-# Test 5: Ultrasonic Sensor
-print("Test 5: ultrasonic distance readings")
-for i in range(5):
-    distance = my_robot.read_distance()
-    hold_state(0.5)
-
-print("All hardware tests completed.")
-`,
+    // debug: loaded dynamically from project/main.py
     0: `# Challenge 0: Fix the Code
 # This code has errors - can you find and fix them?
 

app/js/app.js

@@ -60,11 +60,15 @@ const PythonRunner = {
     // Initialize builtin files
     Sk.builtinFiles = Sk.builtinFiles || { files: {} };
 
-    // Add aidriver module as pure Python with JS interop
-    Sk.builtinFiles["files"]["src/lib/aidriver.py"] =
-      this.getAIDriverPythonModule();
+    // Register aidriver as a JavaScript module (for proper suspension support)
+    // This uses AIDriverStub.getModule() which has promiseToSuspension for hold_state
+    Sk.externalLibraries = Sk.externalLibraries || {};
+    Sk.externalLibraries["aidriver"] = {
+      path: "virtual://aidriver",
+      dependencies: [],
+    };
 
-    console.log("[PythonRunner] Registered aidriver Python module");
+    console.log("[PythonRunner] Registered aidriver JS module");
   },
 
   /**
@@ -444,7 +448,7 @@ def ticks_diff(t1, t2):
   handleRead(filename) {
     console.log("[PythonRunner] handleRead called for:", filename);
 
-    // Handle aidriver module - check various possible paths
+    // Handle aidriver module - return the Python module
     if (
       filename === "src/lib/aidriver.py" ||
       filename === "./aidriver.py" ||

app/js/python-runner.js

@@ -631,8 +631,8 @@ <h5 class="modal-title">
     <script src="js/mazes.js?v=25"></script>
     <script src="js/gamepad.js?v=10"></script>
     <script src="js/aidriver-stub.js?v=10"></script>
-    <script src="js/python-runner.js?v=42"></script>
+    <script src="js/python-runner.js?v=43"></script>
     <script src="js/editor.js?v=13"></script>
-    <script src="js/app.js?v=45"></script>
+    <script src="js/app.js?v=48"></script>
   </body>
 </html>

app/simulator.html

@@ -76,52 +76,64 @@
 > To avoid damaging your computer or robot place it on the floor in an area with enough space for it to move safely before powering it on.
 
 ```python
-from time import sleep
+from aidriver import AIDriver, hold_state
 import aidriver
-from aidriver import AIDriver
-import sys
 
-"""Hardware test for the AIDriver robot.
-Relies on aidriver.DEBUG_AIDRIVER for detailed motor/sensor logs.
+"""Hardware sanity test for the AIDriver robot.
+
+Runs a short sequence of movements and distance readings.
+Most details are reported via the AIDriver debug logger.
 """
 
-aidriver.DEBUG_AIDRIVER = True
-
-try:
-    driver = AIDriver()
-except Exception as e:
-    # Minimal error reporting in case the library is missing or broken
-    print("AIDriver init failed:", e)
-    sys.exit()
-
-sleep(5)
-
-# Test 1: Drive Forward
-driver.drive_forward(200, 200)
-sleep(2)
-driver.brake()
-sleep(3)
-
-# Test 2: Drive Backward
-driver.drive_backward(200, 200)
-sleep(2)
-driver.brake()
-sleep(3)
-
-# Test 3: Rotate Right
-driver.rotate_right(200)
-sleep(2)
-driver.brake()
-sleep(3)
-
-# Test 4: Rotate Left
-driver.rotate_left(200)
-sleep(2)
-driver.brake()
-sleep(3)
-
-# Test 5: Ultrasonic Sensor
-for _ in range(5):
-    driver.read_distance()
-    sleep(1)
+
+def main():
+    aidriver.DEBUG_AIDRIVER = True
+
+    print("Initialising AIDriver hardware test...")
+
+    try:
+        robot = AIDriver()
+    except Exception as exc:
+        print("Failed to initialise AIDriver:", exc)
+        print("Check that 'aidriver.py' is in the 'lib' folder on the device.")
+        return
+
+    print("Starting tests in 3 seconds. Ensure clear space around the robot.")
+    hold_state(3)
+
+    # Test 1: Drive Forward
+    print("Test 1: drive_forward")
+    robot.drive_forward(200, 200)
+    hold_state(2)
+    robot.brake()
+    hold_state(1)
+
+    # Test 2: Drive Backward
+    print("Test 2: drive_backward")
+    robot.drive_backward(200, 200)
+    hold_state(2)
+    robot.brake()
+    hold_state(1)
+
+    # Test 3: Rotate Right
+    print("Test 3: rotate_right")
+    robot.rotate_right(200)
+    hold_state(2)
+    robot.brake()
+    hold_state(1)
+
+    # Test 4: Rotate Left
+    print("Test 4: rotate_left")
+    robot.rotate_left(200)
+    hold_state(2)
+    robot.brake()
+    hold_state(1)
+
+    # Test 5: Ultrasonic Sensor
+    print("Test 5: ultrasonic distance readings")
+    for i in range(5):
+        distance = robot.read_distance()
+        hold_state(0.5)
+
+    print("All hardware tests completed.")
 ```