Skip to content

A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol

add webflasher

Geoc36877cfd2bc
diff --git a/webflasher/firmwares/bus_pirate_08_xiaos3.bin b/webflasher/firmwares/bus_pirate_08_xiaos3.bin
new file mode 100644
index 00000000..2d4a5077
Binary files /dev/null and b/webflasher/firmwares/bus_pirate_08_xiaos3.bin differ
diff --git a/webflasher/index.html b/webflasher/index.html
new file mode 100644
index 00000000..14de733d
--- /dev/null
+++ b/webflasher/index.html
@@ -0,0 +1,58 @@
+<!doctype html>
+<html lang="fr">
+<head>
+ <meta charset="utf-8" />
+ <title>ESP32 Bus Pirate Flasher</title>
+ <meta name="viewport" content="width=device-width,initial-scale=1" />
+ <link rel="stylesheet" href="style.css" />
+ <!-- ESP Web Tools -->
+ <script type="module" src="https://unpkg.com/esp-web-tools@10/dist/web/install-button.js?module"></script>
+</head>
+<body>
+ <div class="wrap">
+ <!-- Title -->
+ <pre class="ascii-title" aria-hidden="true">
+ ____ ____ _ _ _____ _ _
+ | __ ) _ _ ___ | _ \(_)_ __ __ _| |_ ___ | ___| | __ _ ___| |__ ___ _ __
+ | _ \| | | / __| | |_) | | '__/ _` | __/ _ \ | |_ | |/ _` / __| '_ \ / _ \ '__|
+ | |_) | |_| \__ \ | __/| | | | (_| | || __/ | _| | | (_| \__ \ | | | __/ |
+ |____/ \__,_|___/ |_| |_|_| \__,_|\__\___| |_| |_|\__,_|___/_| |_|\___|_|
+
+ Online tool to flash the firmware to your ESP32-S3
+ </pre>
+
+ <!-- Boards -->
+ <h3>Boards</h3>
+ <div id="boards" class="boards-grid" role="listbox" aria-label="Choose a board">
+ <button class="card" data-key="cardputer">Cardputer</button>
+ <button class="card" data-key="stamps3">StampS3</button>
+ <button class="card" data-key="atoms3lite">AtomS3 Lite</button>
+ <button class="card" data-key="s3devkit">ESP32-S3 DevKit</button>
+ <button class="card" data-key="tembed">T-Embed</button>
+ <button class="card" data-key="tembedcc1101">T-Embed (CC1101)</button>
+ <button class="card" data-key="xiaoesp32s3">XIAO ESP32-S3</button>
+ </div>
+
+ <!-- Flash -->
+ <div class="flash-area">
+ <esp-web-install-button id="flashEl">
+ <button id="flashBtn" class="flash-btn" slot="activate" disabled>⚡ Flash</button>
+ <span slot="unsupported">Browser doesn't support Web Serial.</span>
+ <span slot="not-allowed">Needs HTTPS (or localhost).</span>
+ </esp-web-install-button>
+ <small id="flashHint" class="muted">Select a board above.</small>
+ </div>
+
+ <!-- Tips -->
+ <h3>Tips</h3>
+ <section class="tips-grid">
+ <div class="tip-card"><h4>Cardputer</h4><p>Power off and unplug USB. Hold <b>G0</b> (upper-right), then plug USB while still holding.</p></div>
+ <div class="tip-card"><h4>AtomS3Lite</h4><p>Power on and press the </b>RESET</b> button for 3 seconds or until the LED blinks green.</p></div>
+ <div class="tip-card"><h4>T-Embed</h4><p>Hold the encoder <b>center button</b>, then press <b>RESET</b>.<br>(CC1101 version: the button is next to the ESP32-S3.)</p></div>
+ <div class="tip-card"><h4>S3 Dev Kit</h4><p>Make sure to choose the right USB port, hold the <b>BOOT</b> button and power on.</p></div>
+ </section>
+ </div>
+
+ <script type="module" src="scripts.js"></script>
+</body>
+</html>
diff --git a/webflasher/manifests/atoms3lite.json b/webflasher/manifests/atoms3lite.json
new file mode 100644
index 00000000..070e8184
--- /dev/null
+++ b/webflasher/manifests/atoms3lite.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - AtomS3 Lite",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_atomlites3.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/cardputer.json b/webflasher/manifests/cardputer.json
new file mode 100644
index 00000000..8804fd0f
--- /dev/null
+++ b/webflasher/manifests/cardputer.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - Cardputer",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_cardputer.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/s3devkit.json b/webflasher/manifests/s3devkit.json
new file mode 100644
index 00000000..c2f67704
--- /dev/null
+++ b/webflasher/manifests/s3devkit.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - ESP32-S3 DevKit",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_s3devkit.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/stamps3.json b/webflasher/manifests/stamps3.json
new file mode 100644
index 00000000..7bd81791
--- /dev/null
+++ b/webflasher/manifests/stamps3.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - StampS3",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_stamps3.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/tembed.json b/webflasher/manifests/tembed.json
new file mode 100644
index 00000000..3dd6f2eb
--- /dev/null
+++ b/webflasher/manifests/tembed.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - T-Embed",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_tembeds3.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/tembedcc1101.json b/webflasher/manifests/tembedcc1101.json
new file mode 100644
index 00000000..2b952652
--- /dev/null
+++ b/webflasher/manifests/tembedcc1101.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - T-Embed CC1101",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_tembedcc1101.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/manifests/xiaoesp32s3.json b/webflasher/manifests/xiaoesp32s3.json
new file mode 100644
index 00000000..30f13729
--- /dev/null
+++ b/webflasher/manifests/xiaoesp32s3.json
@@ -0,0 +1,13 @@
+{
+ "name": "ESP32 Bus Pirate - XIAO ESP32-S3",
+ "version": "0.8",
+ "new_install_prompt_erase": false,
+ "builds": [
+ {
+ "chipFamily": "ESP32-S3",
+ "parts": [
+ { "path": "https://github.com/geo-tp/ESP32-Bus-Pirate/releases/download/v0.8/bus_pirate_08_xiaos3.bin", "offset": 0 }
+ ]
+ }
+ ]
+}
diff --git a/webflasher/scripts.js b/webflasher/scripts.js
new file mode 100644
index 00000000..bb9f8dba
--- /dev/null
+++ b/webflasher/scripts.js
@@ -0,0 +1,51 @@
+const flashEl = document.getElementById("flashEl"); // <esp-web-install-button>
+const flashBtn = document.getElementById("flashBtn"); // slotted button
+const flashHint = document.getElementById("flashHint");
+const grid = document.getElementById("boards");
+
+let selected = null;
+
+function setActiveCard(key) {
+ const cards = grid.querySelectorAll(".card");
+ for (const el of cards) {
+ const on = !!key && el.dataset.key === key;
+ el.classList.toggle("active", on);
+ el.setAttribute("aria-selected", on ? "true" : "false");
+ }
+}
+
+function setDisabled(state) {
+ if (state) {
+ flashBtn.disabled = true;
+ flashBtn.setAttribute("disabled", "");
+ } else {
+ flashBtn.disabled = false;
+ flashBtn.removeAttribute("disabled");
+ }
+}
+
+function updateUI() {
+ if (!selected) {
+ flashEl.removeAttribute("manifest");
+ setDisabled(true);
+ flashHint.textContent = "Select a board above.";
+ setActiveCard(null);
+ return;
+ }
+ const manifestUrl = `./manifests/${selected}.json`;
+ flashEl.setAttribute("manifest", manifestUrl);
+ setDisabled(false);
+ flashHint.textContent = `Ready: Click Flash.`;
+ setActiveCard(selected);
+}
+
+// Clic board
+grid.addEventListener("click", (e) => {
+ const el = e.target.closest(".card");
+ if (!el) return;
+ selected = el.dataset.key || null;
+ updateUI();
+});
+
+// Init
+updateUI();
\ No newline at end of file
diff --git a/webflasher/style.css b/webflasher/style.css
new file mode 100644
index 00000000..62fe1408
--- /dev/null
+++ b/webflasher/style.css
@@ -0,0 +1,100 @@
+/* Reset & base */
+* { margin:0; padding:0; box-sizing:border-box; overflow-wrap:break-word; }
+html, body {
+ height:100%; width:100%; max-width:100vw; max-height:100dvh;
+ font-family: Menlo, 'Courier New', Courier, 'Liberation Mono', monospace;
+ background:#121212; color:#e0e0e0;
+ overflow-x: hidden;
+}
+.wrap { max-width: 980px; margin: 0 auto; padding: 20px 16px; }
+
+/* Title */
+.ascii-title {
+ font-family: Menlo, 'Courier New', Courier, 'Liberation Mono', monospace;
+ display: block;
+ margin: 20px auto;
+ padding: 16px 20px;
+ text-align: center;
+ white-space: pre;
+ font-weight: bold;
+
+ /* Couleur texte*/
+ background: linear-gradient(90deg, #00ff00, #00e1ffc4);
+ -webkit-background-clip: text;
+ -webkit-text-fill-color: transparent;
+
+ /* Encadrement */
+ border: 1px solid #2f3a2fa0;
+ border-radius: 8px;
+
+ box-shadow: 0 0 15px #00ff9904, inset 0 0 10px #00ff9910;
+}
+.page-title {
+ text-align:center;
+ margin: 6px 0 12px;
+}
+.muted { color:#9aa0a6; }
+
+/* Boards grid */
+.boards-grid {
+ display:grid;
+ grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+ gap: 10px 12px;
+ margin: 10px 0 6px;
+}
+.card {
+ appearance:none; border:1px solid #333; border-radius:10px;
+ background:linear-gradient(145deg,#1a1a1a,#0f0f0f);
+ color:#d8ffd8;
+ padding:16px 14px; text-align:center; cursor:pointer;
+ transition: transform .08s ease, box-shadow .15s ease, border-color .2s;
+ box-shadow: inset 0 0 5px #000, 0 1px 0 #000;
+}
+.card:focus { outline: 2px solid #00ffcc88; outline-offset: 2px; }
+.card.active {
+ border-color:#0ea86b; box-shadow: 0 0 12px #00ff9944, inset 0 0 6px #000;
+ background:linear-gradient(145deg,#1f2a23,#0f1612);
+}
+
+/* Flash area */
+.flash-area { display:flex; align-items:center; gap:12px; margin: 14px 0 18px; }
+.flash-btn {
+ margin: 15px;
+ margin-left: 0px;
+ padding:12px 20px; border-radius:12px; border:1px solid #2b2b2b;
+ background: linear-gradient(135deg,#26332a,#151a17);
+ color:#b8ffb8; font-weight:700; font-size:1rem; letter-spacing:.3px;
+ cursor:pointer; transition: transform .06s ease, box-shadow .2s, filter .2s;
+ box-shadow: 0 6px 18px rgba(0,255,153,0.12), inset 0 0 8px rgba(0,0,0,.5);
+}
+.flash-btn:hover:not([disabled]) { transform: translateY(-1px); box-shadow:0 8px 22px rgba(0,255,153,0.18); }
+.flash-btn[disabled] { opacity:.45; cursor:not-allowed; filter:grayscale(30%); }
+
+/* Tips */
+.tips-grid {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+ gap: 12px;
+ margin: 12px 0 6px;
+}
+
+.tip-card {
+ background: #111;
+ border: 1px solid #2f3a2f;
+ border-radius: 10px;
+ padding: 12px 14px;
+ box-shadow: 0 0 15px #00ff9904, inset 0 0 10px #00ff9910;
+
+ color: #d8ffd8;
+}
+
+.tip-card h4 {
+ margin: 0 0 6px;
+ font-size: 1rem;
+ color: #0ea86b;
+}
+.tip-card p {
+ margin: 0;
+ line-height: 1.35;
+}
+.tip-card code { color: #b8e2ff; }