npm - esp32tool - Versions diffs - 1.1.8 → 1.2.0 - Mend

esp32tool 1.1.8 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (49) hide show

package/.nojekyll +0 -0
package/README.md +100 -6
package/apple-touch-icon.png +0 -0
package/build-electron-cli.cjs +177 -0
package/build-single-binary.cjs +295 -0
package/css/light.css +11 -0
package/css/style.css +225 -35
package/dist/cli.d.ts +17 -0
package/dist/cli.js +458 -0
package/dist/esp_loader.d.ts +129 -21
package/dist/esp_loader.js +1227 -222
package/dist/index.d.ts +2 -1
package/dist/index.js +37 -4
package/dist/node-usb-adapter.d.ts +47 -0
package/dist/node-usb-adapter.js +725 -0
package/dist/stubs/index.d.ts +1 -2
package/dist/stubs/index.js +4 -0
package/dist/web/index.js +1 -1
package/electron/cli-main.cjs +74 -0
package/electron/main.cjs +338 -0
package/electron/main.js +7 -2
package/favicon.ico +0 -0
package/fix-cli-imports.cjs +127 -0
package/generate-icons.sh +89 -0
package/icons/icon-128.png +0 -0
package/icons/icon-144.png +0 -0
package/icons/icon-152.png +0 -0
package/icons/icon-192.png +0 -0
package/icons/icon-384.png +0 -0
package/icons/icon-512.png +0 -0
package/icons/icon-72.png +0 -0
package/icons/icon-96.png +0 -0
package/index.html +94 -64
package/install-android.html +411 -0
package/js/modules/esptool.js +1 -1
package/js/script.js +165 -160
package/js/webusb-serial.js +1017 -0
package/license.md +1 -1
package/manifest.json +89 -0
package/package.cli.json +29 -0
package/package.json +31 -21
package/screenshots/desktop.png +0 -0
package/screenshots/mobile.png +0 -0
package/src/cli.ts +618 -0
package/src/esp_loader.ts +1438 -254
package/src/index.ts +69 -3
package/src/node-usb-adapter.ts +924 -0
package/src/stubs/index.ts +4 -1
package/sw.js +155 -0

package/index.html CHANGED Viewed

@@ -5,6 +5,14 @@
     <meta charset="utf-8" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Flash & Read ESP devices using WebSerial and WebUSB" />
+    <meta name="theme-color" content="#1a1a1a" />
+    <link rel="manifest" href="manifest.json" />
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+    <meta name="apple-mobile-web-app-title" content="ESP32Tool" />
+    <link rel="apple-touch-icon" href="icons/icon-192.png" />
     <script>
       // Redirect to HTTPS if HTTP is requested.
       if (
@@ -33,92 +41,114 @@
     />
     <!-- import the webpage's javascript file -->
-    <script module>
+    <script type="module">
       window.esptoolPackage = import(
-        // In development we import locally.
-        window.location.hostname === "localhost"
-          ? "./js/modules/esptool.js"
-          : "./js/modules/esptool.js"
+        "./js/modules/esptool.js"
       );
     </script>
-    <script src="js/script.js" module defer></script>
+    <script src="js/script.js" type="module" defer></script>
+    <script>
+      // Service Worker for PWA functionality
+      // Derive base path from current document URL (more robust than repo-name regex)
+      const basePath = new URL(".", window.location.href).pathname;
+      if ('serviceWorker' in navigator) {
+        window.addEventListener('load', () => {
+          navigator.serviceWorker.register(basePath + 'sw.js', { scope: basePath })
+            .then((registration) => {
+              console.log('[PWA] Service Worker registered:', registration.scope);
+              // Check for updates
+              registration.addEventListener('updatefound', () => {
+                const newWorker = registration.installing;
+                newWorker.addEventListener('statechange', () => {
+                  if (newWorker.state === 'installed' && navigator.serviceWorker.controller) {
+                    console.log('[PWA] New version available! Reload to update.');
+                  }
+                });
+              });
+            })
+            .catch((error) => {
+              console.log('[PWA] Service Worker registration failed:', error);
+            });
+        });
+      }
+    </script>
   </head>
   <body>
     <header class="header">
-      <div class="left">
-        <div class="title">ESP32Tool</div>
-      </div>
-      <div class="right">
-        <div class="controls-row">
-          <label for="showlog">Show Log</label>
-          <div class="onoffswitch">
-            <input
-              type="checkbox"
-              name="showlog"
-              class="onoffswitch-checkbox"
-              id="showlog"
-            />
-            <label class="onoffswitch-label" for="showlog">
-              <span class="onoffswitch-inner"></span>
-              <span class="onoffswitch-switch"></span>
-            </label>
-          </div>
-          <span class="log-controls">
-            <label for="autoscroll">Autoscroll</label>
-            <div class="onoffswitch">
-              <input
-                type="checkbox"
-                name="autoscroll"
-                class="onoffswitch-checkbox"
-                id="autoscroll"
-              />
-              <label class="onoffswitch-label" for="autoscroll">
-                <span class="onoffswitch-inner"></span>
-                <span class="onoffswitch-switch"></span>
-              </label>
-            </div>
-            <button id="butClear" type="button" class="small-btn">
-              Clear
-            </button>
-          </span>
+      <div class="header-content">
+        <button id="butConnect" type="button">Connect</button>
+        <label for="baudRate">Baud</label>
+        <select id="baudRate"></select>
+        <label for="showlog">Show Log</label>
+        <div class="onoffswitch">
+          <input
+            type="checkbox"
+            name="showlog"
+            class="onoffswitch-checkbox"
+            id="showlog"
+          />
+          <label class="onoffswitch-label" for="showlog">
+            <span class="onoffswitch-inner"></span>
+            <span class="onoffswitch-switch"></span>
+          </label>
+        </div>
-          <label for="debugmode">Debug</label>
+        <span class="log-controls">
+          <label for="autoscroll">Autoscroll</label>
           <div class="onoffswitch">
             <input
               type="checkbox"
-              name="debugmode"
+              name="autoscroll"
               class="onoffswitch-checkbox"
-              id="debugmode"
+              id="autoscroll"
             />
-            <label class="onoffswitch-label" for="debugmode">
+            <label class="onoffswitch-label" for="autoscroll">
               <span class="onoffswitch-inner"></span>
               <span class="onoffswitch-switch"></span>
             </label>
           </div>
+          <button id="butClear" type="button" class="small-btn">
+            Clear
+          </button>
+        </span>
-          <label for="darkmode">Dark</label>
-          <div class="onoffswitch">
-            <input
-              type="checkbox"
-              name="darkmode"
-              class="onoffswitch-checkbox"
-              id="darkmode"
-            />
-            <label class="onoffswitch-label" for="darkmode">
-              <span class="onoffswitch-inner"></span>
-              <span class="onoffswitch-switch"></span>
-            </label>
-          </div>
+        <label for="debugmode">Debug</label>
+        <div class="onoffswitch">
+          <input
+            type="checkbox"
+            name="debugmode"
+            class="onoffswitch-checkbox"
+            id="debugmode"
+          />
+          <label class="onoffswitch-label" for="debugmode">
+            <span class="onoffswitch-inner"></span>
+            <span class="onoffswitch-switch"></span>
+          </label>
+        </div>
+        <label for="darkmode">Dark</label>
+        <div class="onoffswitch">
+          <input
+            type="checkbox"
+            name="darkmode"
+            class="onoffswitch-checkbox"
+            id="darkmode"
+          />
+          <label class="onoffswitch-label" for="darkmode">
+            <span class="onoffswitch-inner"></span>
+            <span class="onoffswitch-switch"></span>
+          </label>
         </div>
-        <select id="baudRate"></select>
-        <button id="butConnect" type="button">Connect</button>
       </div>
     </header>
     <main class="main">
       <div id="notSupported" class="notSupported">
-        Sorry, <b>Web Serial</b> is not supported on this device, make sure
-        you're running Chrome 89 or later.
+        Sorry, <b>Web Serial</b> or <b>WebUSB</b> is not supported on this device.
+        Make sure you're running Chrome 89 or later (Desktop) or Chrome 61+ (Android with USB OTG).
       </div>
       <div id="app">
         <div id="commands">

package/install-android.html ADDED Viewed

@@ -0,0 +1,411 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Install ESP32Tool on Android</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+            line-height: 1.6;
+            color: #333;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            padding: 20px;
+        }
+        .container {
+            max-width: 800px;
+            margin: 0 auto;
+            background: white;
+            border-radius: 20px;
+            padding: 40px;
+            box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+        }
+        h1 {
+            color: #667eea;
+            margin-bottom: 10px;
+            font-size: 2.5em;
+        }
+        .subtitle {
+            color: #666;
+            margin-bottom: 30px;
+            font-size: 1.2em;
+        }
+        .step {
+            background: #f8f9fa;
+            border-left: 4px solid #667eea;
+            padding: 20px;
+            margin: 20px 0;
+            border-radius: 8px;
+        }
+        .step-number {
+            display: inline-block;
+            background: #667eea;
+            color: white;
+            width: 30px;
+            height: 30px;
+            border-radius: 50%;
+            text-align: center;
+            line-height: 30px;
+            font-weight: bold;
+            margin-right: 10px;
+        }
+        .step h3 {
+            display: inline-block;
+            color: #333;
+            margin-bottom: 10px;
+        }
+        .step p {
+            margin-left: 40px;
+            color: #666;
+        }
+        .requirements {
+            background: #fff3cd;
+            border: 2px solid #ffc107;
+            border-radius: 8px;
+            padding: 20px;
+            margin: 30px 0;
+        }
+        .requirements h3 {
+            color: #856404;
+            margin-bottom: 10px;
+        }
+        .requirements ul {
+            margin-left: 20px;
+            color: #856404;
+        }
+        .requirements li {
+            margin: 5px 0;
+        }
+        .cta-button {
+            display: inline-block;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            padding: 15px 40px;
+            border-radius: 50px;
+            text-decoration: none;
+            font-weight: bold;
+            font-size: 1.2em;
+            margin: 20px 0;
+            transition: transform 0.2s;
+            box-shadow: 0 4px 15px rgba(102, 126, 234, 0.4);
+        }
+        .cta-button:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 6px 20px rgba(102, 126, 234, 0.6);
+        }
+        .features {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+            gap: 20px;
+            margin: 30px 0;
+        }
+        .feature {
+            text-align: center;
+            padding: 20px;
+        }
+        .feature-icon {
+            font-size: 3em;
+            margin-bottom: 10px;
+        }
+        .feature h4 {
+            color: #667eea;
+            margin-bottom: 5px;
+        }
+        .note {
+            background: #d1ecf1;
+            border-left: 4px solid #0c5460;
+            padding: 15px;
+            margin: 20px 0;
+            border-radius: 4px;
+            color: #0c5460;
+        }
+        @media (max-width: 600px) {
+            .container {
+                padding: 20px;
+            }
+            h1 {
+                font-size: 2em;
+            }
+            .features {
+                grid-template-columns: 1fr;
+            }
+        }
+    </style>
+    <script>
+        // Detect browser language and show appropriate content
+        document.addEventListener('DOMContentLoaded', function() {
+            const userLang = navigator.language || navigator.userLanguage;
+            const isGerman = userLang.toLowerCase().startsWith('de');
+            if (isGerman) {
+                document.getElementById('content-en').style.display = 'none';
+                document.getElementById('content-de').style.display = 'block';
+                document.documentElement.lang = 'de';
+                document.title = 'ESP32Tool auf Android installieren';
+            } else {
+                document.getElementById('content-en').style.display = 'block';
+                document.getElementById('content-de').style.display = 'none';
+                document.documentElement.lang = 'en';
+                document.title = 'Install ESP32Tool on Android';
+            }
+        });
+    </script>
+</head>
+<body>
+    <!-- English Version -->
+    <div id="content-en" class="container">
+        <h1>📱 ESP32Tool for Android</h1>
+        <p class="subtitle">Flash and manage ESP devices directly on your Android smartphone!</p>
+        <div class="features">
+            <div class="feature">
+                <div class="feature-icon">⚡</div>
+                <h4>Fast</h4>
+                <p>Up to 10x faster than esptool.py</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">📂</div>
+                <h4>Filesystem</h4>
+                <p>LittleFS, SPIFFS & FATFS support</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">🔌</div>
+                <h4>USB OTG</h4>
+                <p>Direct USB connection</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">🌐</div>
+                <h4>Offline</h4>
+                <p>Works without internet</p>
+            </div>
+        </div>
+        <div class="requirements">
+            <h3>⚙️ Requirements</h3>
+            <ul>
+                <li>Android 5.0+ (Lollipop or higher)</li>
+                <li>Chrome for Android (Version 61+, recommended: latest version)</li>
+                <li>USB OTG adapter or USB-C to USB-A cable</li>
+                <li>ESP32 or ESP8266 device</li>
+            </ul>
+        </div>
+        <h2 style="margin-top: 40px; color: #667eea;">📋 Installation Guide</h2>
+        <div class="step">
+            <span class="step-number">1</span>
+            <h3>Open Chrome</h3>
+            <p>Open this page in <strong>Chrome for Android</strong> (not Firefox or Samsung Internet)</p>
+        </div>
+        <div class="step">
+            <span class="step-number">2</span>
+            <h3>Navigate to main page</h3>
+            <p>Click the button below to go to the ESP32Tool app</p>
+        </div>
+        <div style="text-align: center;">
+            <a href="index.html" class="cta-button">🚀 Open ESP32Tool</a>
+        </div>
+        <div class="step">
+            <span class="step-number">3</span>
+            <h3>Install app</h3>
+            <p>Tap the <strong>menu (⋮)</strong> in the top right and select <strong>"Add to Home screen"</strong> or <strong>"Install app"</strong></p>
+        </div>
+        <div class="step">
+            <span class="step-number">4</span>
+            <h3>Confirm installation</h3>
+            <p>Confirm the installation. The app will appear on your home screen</p>
+        </div>
+        <div class="step">
+            <span class="step-number">5</span>
+            <h3>Connect ESP device</h3>
+            <p>Connect your ESP32/ESP8266 via USB OTG adapter to your Android device</p>
+        </div>
+        <div class="step">
+            <span class="step-number">6</span>
+            <h3>Grant USB permission</h3>
+            <p>Click "Connect" in the app and select your ESP device. Allow USB access when prompted</p>
+        </div>
+        <div class="note">
+            <strong>💡 Tip:</strong> The app works without installation directly in the browser. However, installation provides a better app experience and offline functionality.
+        </div>
+        <div class="note">
+            <strong>⚠️ Important:</strong> WebUSB only works with USB OTG (On-The-Go). Make sure your Android device supports USB Host Mode.
+        </div>
+        <h2 style="margin-top: 40px; color: #667eea;">🎯 Getting Started</h2>
+        <div class="step">
+            <h3>Flash firmware</h3>
+            <p>Select a .bin file, enter the offset (e.g. 0x0 for bootloader) and click "Program"</p>
+        </div>
+        <div class="step">
+            <h3>Manage filesystem</h3>
+            <p>Click "Read Partition Table" and then "Detect FS and Open Manager" to manage files</p>
+        </div>
+        <div class="step">
+            <h3>Read flash</h3>
+            <p>Enter address and size and click "Read Flash" to read the memory</p>
+        </div>
+        <div style="text-align: center; margin-top: 40px; padding-top: 40px; border-top: 2px solid #eee;">
+            <p style="color: #666;">
+                <strong>ESP32Tool</strong> – Made with ❤️ by Adafruit, Nabu Casa & Johann Obermeier<br>
+                <a href="https://github.com/Jason2866/esp32tool" style="color: #667eea;">GitHub</a> |
+                <a href="https://jason2866.github.io/esp32tool" style="color: #667eea;">Web Version</a>
+            </p>
+        </div>
+    </div>
+    <!-- German Version -->
+    <div id="content-de" class="container" style="display: none;">
+        <h1>📱 ESP32Tool für Android</h1>
+        <p class="subtitle">Flashe und verwalte ESP-Geräte direkt auf deinem Android-Smartphone!</p>
+        <div class="features">
+            <div class="feature">
+                <div class="feature-icon">⚡</div>
+                <h4>Schnell</h4>
+                <p>Bis zu 10x schneller als esptool.py</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">📂</div>
+                <h4>Filesystem</h4>
+                <p>LittleFS, SPIFFS & FATFS Support</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">🔌</div>
+                <h4>USB OTG</h4>
+                <p>Direkte USB-Verbindung</p>
+            </div>
+            <div class="feature">
+                <div class="feature-icon">🌐</div>
+                <h4>Offline</h4>
+                <p>Funktioniert ohne Internet</p>
+            </div>
+        </div>
+        <div class="requirements">
+            <h3>⚙️ Voraussetzungen</h3>
+            <ul>
+                <li>Android 5.0+ (Lollipop oder höher)</li>
+                <li>Chrome für Android (Version 61+, empfohlen: neueste Version)</li>
+                <li>USB OTG-Adapter oder USB-C zu USB-A Kabel</li>
+                <li>ESP32 oder ESP8266 Gerät</li>
+            </ul>
+        </div>
+        <h2 style="margin-top: 40px; color: #667eea;">📋 Installations-Anleitung</h2>
+        <div class="step">
+            <span class="step-number">1</span>
+            <h3>Chrome öffnen</h3>
+            <p>Öffne diese Seite in <strong>Chrome für Android</strong> (nicht Firefox oder Samsung Internet)</p>
+        </div>
+        <div class="step">
+            <span class="step-number">2</span>
+            <h3>Zur Hauptseite navigieren</h3>
+            <p>Klicke auf den Button unten, um zur ESP32Tool-App zu gelangen</p>
+        </div>
+        <div style="text-align: center;">
+            <a href="index.html" class="cta-button">🚀 ESP32Tool öffnen</a>
+        </div>
+        <div class="step">
+            <span class="step-number">3</span>
+            <h3>App installieren</h3>
+            <p>Tippe auf das <strong>Menü (⋮)</strong> oben rechts und wähle <strong>"Zum Startbildschirm hinzufügen"</strong> oder <strong>"App installieren"</strong></p>
+        </div>
+        <div class="step">
+            <span class="step-number">4</span>
+            <h3>Installation bestätigen</h3>
+            <p>Bestätige die Installation. Die App erscheint auf deinem Homescreen</p>
+        </div>
+        <div class="step">
+            <span class="step-number">5</span>
+            <h3>ESP-Gerät verbinden</h3>
+            <p>Verbinde dein ESP32/ESP8266 über den USB OTG-Adapter mit deinem Android-Gerät</p>
+        </div>
+        <div class="step">
+            <span class="step-number">6</span>
+            <h3>USB-Berechtigung erteilen</h3>
+            <p>Klicke auf "Connect" in der App und wähle dein ESP-Gerät aus. Erlaube den USB-Zugriff wenn gefragt</p>
+        </div>
+        <div class="note">
+            <strong>💡 Tipp:</strong> Die App funktioniert auch ohne Installation direkt im Browser. Die Installation bietet aber ein besseres App-Erlebnis und Offline-Funktionalität.
+        </div>
+        <div class="note">
+            <strong>⚠️ Wichtig:</strong> WebUSB funktioniert nur mit USB OTG (On-The-Go). Stelle sicher, dass dein Android-Gerät USB Host Mode unterstützt.
+        </div>
+        <h2 style="margin-top: 40px; color: #667eea;">🎯 Erste Schritte</h2>
+        <div class="step">
+            <h3>Firmware flashen</h3>
+            <p>Wähle eine .bin-Datei, gib den Offset ein (z.B. 0x0 für Bootloader) und klicke auf "Program"</p>
+        </div>
+        <div class="step">
+            <h3>Filesystem verwalten</h3>
+            <p>Klicke auf "Read Partition Table" und dann auf "Detect FS and Open Manager" um Dateien zu verwalten</p>
+        </div>
+        <div class="step">
+            <h3>Flash auslesen</h3>
+            <p>Gib Adresse und Größe ein und klicke auf "Read Flash" um den Speicher auszulesen</p>
+        </div>
+        <div style="text-align: center; margin-top: 40px; padding-top: 40px; border-top: 2px solid #eee;">
+            <p style="color: #666;">
+                <strong>ESP32Tool</strong> – Made with ❤️ by Adafruit, Nabu Casa & Johann Obermeier<br>
+                <a href="https://github.com/Jason2866/esp32tool" style="color: #667eea;">GitHub</a> |
+                <a href="https://jason2866.github.io/esp32tool" style="color: #667eea;">Web Version</a>
+            </p>
+        </div>
+    </div>
+</body>
+</html>