RadiaCode-Spectrometer/ESP32-S3-Touch/_archive_previous_project/TESTING_STEPS.md

4.6 KiB

🚀 Testing Builder - Step by Step

Status: Enhanced debugging has been uploaded to your device ✓

Quick Start Test

Step 1: Open Browser Console

  1. Open builder in browser
  2. Press F12 to open Developer Tools
  3. Click "Console" tab
  4. You should see a blank console (or "Welcome to DevTools")

Step 2: Load HOME Page

  1. Select "Home" from Pages list
  2. You should see cyan boxes appear on canvas

Step 3: Click on Weather Panel

  1. Look for the large cyan box at the top of the canvas
  2. Click on it (click in the middle)
  3. Properties should appear on the RIGHT side

Step 4: Change the Color

  1. With Weather Panel selected, find the "Color" field
  2. Click the color picker (the colored square)
  3. Choose RED color
  4. The cyan box should immediately turn RED

Step 5: Click "Apply Changes"

  1. Click the blue "Apply Changes" button
  2. You should see a toast saying "Saving..."
  3. Then it should say "✓ Changes saved to device"

Step 6: Check the Console

  1. Look at the browser console (F12)
  2. You should see blue messages like:
[BUILDER] Applying properties to widget: {...}
[BUILDER] Widget after applying properties: {...}
[BUILDER] Saving overlay for page 0
[BUILDER] Overlay widgets: [...]
[BUILDER] Overlay saved successfully

Step 7: Check the LCD

  1. Look at your device LCD
  2. The Weather Panel should now be RED

What Each Console Message Means

✓ GOOD (You should see these):

[BUILDER] Applying properties to widget: {type: "panel", x: 45, y: 20, ...}

→ Widget was selected correctly

[BUILDER] Widget after applying properties: {type: "panel", x: 45, y: 20, color: "...", ...}

→ Color was changed in the widget object

[BUILDER] Saving overlay for page 0

→ System is sending save request to device

[BUILDER] Overlay widgets: [Array]

→ Array of modified widgets is being sent

[BUILDER] Overlay saved successfully

→ Device confirmed it received and saved the changes

❌ BAD (If you see these, something's wrong):

No [BUILDER] messages at all

→ Console logging isn't working, refresh the page

[BUILDER] Saving overlay for page undefined

→ Page selection is broken, try reloading

TypeError: Cannot read property 'overlayElements'

→ State object is corrupted, reload page


If RED Doesn't Appear on LCD

Check 1: Is the Toast Showing?

EXPECTED: ✓ Changes saved to device
ACTUAL: [what do you see?]

Check 2: Is the Console Error Free?

Look for any RED text in console (F12) Copy any error messages and send to me

Check 3: Does LCD Respond at All?

Try navigating to different pages on device If device is frozen: Power cycle it


Power Cycle Instructions

  1. Unplug device from power (USB)
  2. Wait 10 seconds
  3. Plug back in
  4. Wait 30 seconds for boot
  5. Try again

Exact Steps to Report Issues

When something doesn't work, tell me:

  1. Which step failed? (1-7 above)
  2. What did you expect? (describe)
  3. What actually happened? (describe)
  4. Console messages (copy from F12 console)
  5. Error text (if any, copy exact red text)

Example Report:

ISSUE: Color change not appearing on LCD

STEP THAT FAILED: Step 7

EXPECTED: Weather Panel should turn RED on LCD

ACTUAL: Panel stayed BLUE on LCD

CONSOLE MESSAGES:
[BUILDER] Applying properties to widget: {...}
[BUILDER] Widget after applying properties: {color: "#FF0000", ...}
[BUILDER] Saving overlay for page 0
✓ Changes saved to device
(no errors)

NEXT ACTION: I tried power cycling device, still blue

Debug Checklist

  • Can I see cyan boxes on HOME page?
  • Can I click on Weather Panel?
  • Can I change color to RED?
  • Does "Apply Changes" show success toast?
  • Do I see [BUILDER] messages in console?
  • Does LCD show RED weather panel?
  • Does RED persist after power cycle?

Once you complete these steps and see the RED color on LCD, the builder is working! 🎉


What to Do Next

  1. Try changing SIZE (not just color)

    • Select widget
    • Change Width to 200
    • Click Apply
    • Should see BIGGER widget on LCD
  2. Try changing POSITION (X, Y)

    • Select widget
    • Change X to 100
    • Click Apply
    • Should see MOVED widget on LCD
  3. Try creating CUSTOM PAGE

    • Click "Add Page" button
    • Name it "Test"
    • Add some widgets
    • Deploy
    • Should work!
  4. Report SUCCESS or FAILURE

    • Tell me which tests passed
    • Tell me which tests failed
    • Send console output if errors

Questions?

If anything is unclear, ask and I'll help debug!

The enhanced logging should help us see exactly where the problem is. 🔍