initial commit

This commit is contained in:
WeeXnes 2025-06-08 20:11:18 +02:00
commit aa48c317a9
12 changed files with 1785 additions and 0 deletions

24
.gitignore vendored Normal file
View file

@ -0,0 +1,24 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
node_modules
dist
dist-ssr
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

13
index.html Normal file
View file

@ -0,0 +1,13 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Vite + Vue</title>
</head>
<body>
<div id="app"></div>
<script type="module" src="/src/main.js"></script>
</body>
</html>

1265
package-lock.json generated Normal file

File diff suppressed because it is too large Load diff

20
package.json Normal file
View file

@ -0,0 +1,20 @@
{
"name": "esp_tool",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"dependencies": {
"esptool-js": "^0.5.5",
"vue": "^3.5.13",
"crypto-js": "^4.2.0"
},
"devDependencies": {
"@vitejs/plugin-vue": "^5.2.3",
"vite": "^6.3.5"
}
}

1
public/vite.svg Normal file
View file

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

After

Width:  |  Height:  |  Size: 1.5 KiB

54
src/App.vue Normal file
View file

@ -0,0 +1,54 @@
<template>
<div :class="{ dark: darkMode }">
<button @click="clickConnect">{{ connected ? 'Disconnect' : 'Connect' }}</button>
<select v-model="selectedBaudRate" @change="onBaudRateChange(selectedBaudRate)">
<option v-for="rate in baudRates" :key="rate" :value="rate">{{ rate }} Baud</option>
</select>
<input type="checkbox" v-model="darkMode" @change="onDarkModeChange(darkMode)" /> Dark Mode
<input type="checkbox" v-model="autoscroll" @change="onAutoScrollChange(autoscroll)" /> Autoscroll
<input type="checkbox" v-model="noReset" @change="onNoResetChange(noReset)" /> No Reset
<div v-for="i in 4" :key="i" class="upload-slot">
<input type="file" @change="e => firmware[i-1] = e.target.files[0]" />
<input type="text" v-model="offsets[i-1]" />
<div v-if="progressVisible[i-1]" class="progress-bar">
<div :style="{ width: progress[i-1] + '%' }"></div>
</div>
</div>
<button @click="clickErase" :disabled="!connected">Erase Flash</button>
<button @click="clickProgram" :disabled="!connected">Program</button>
<div class="log" v-html="log" />
</div>
</template>
<script setup>
import { useEspFlasher } from './useEspFlasher.js'; // The logic above saved in this file
const {
log,
connected,
darkMode,
autoscroll,
noReset,
selectedBaudRate,
firmware,
offsets,
progress,
progressVisible,
clickConnect,
clickErase,
clickProgram,
onBaudRateChange,
onDarkModeChange,
onAutoScrollChange,
onNoResetChange,
} = useEspFlasher();
const baudRates = [921600, 115200, 230400, 460800];
</script>
<style scoped>
/* Add your styles, progress bar etc */
</style>

1
src/assets/vue.svg Normal file
View file

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="37.07" height="36" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 198"><path fill="#41B883" d="M204.8 0H256L128 220.8L0 0h97.92L128 51.2L157.44 0h47.36Z"></path><path fill="#41B883" d="m0 0l128 220.8L256 0h-51.2L128 132.48L50.56 0H0Z"></path><path fill="#35495E" d="M50.56 0L128 133.12L204.8 0h-47.36L128 51.2L97.92 0H50.56Z"></path></svg>

After

Width:  |  Height:  |  Size: 496 B

View file

@ -0,0 +1,43 @@
<script setup>
import { ref } from 'vue'
defineProps({
msg: String,
})
const count = ref(0)
</script>
<template>
<h1>{{ msg }}</h1>
<div class="card">
<button type="button" @click="count++">count is {{ count }}</button>
<p>
Edit
<code>components/HelloWorld.vue</code> to test HMR
</p>
</div>
<p>
Check out
<a href="https://vuejs.org/guide/quick-start.html#local" target="_blank"
>create-vue</a
>, the official Vue + Vite starter
</p>
<p>
Learn more about IDE Support for Vue in the
<a
href="https://vuejs.org/guide/scaling-up/tooling.html#ide-support"
target="_blank"
>Vue Docs Scaling up Guide</a
>.
</p>
<p class="read-the-docs">Click on the Vite and Vue logos to learn more</p>
</template>
<style scoped>
.read-the-docs {
color: #888;
}
</style>

5
src/main.js Normal file
View file

@ -0,0 +1,5 @@
import { createApp } from 'vue'
import './style.css'
import App from './App.vue'
createApp(App).mount('#app')

79
src/style.css Normal file
View file

@ -0,0 +1,79 @@
:root {
font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
line-height: 1.5;
font-weight: 400;
color-scheme: light dark;
color: rgba(255, 255, 255, 0.87);
background-color: #242424;
font-synthesis: none;
text-rendering: optimizeLegibility;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
a {
font-weight: 500;
color: #646cff;
text-decoration: inherit;
}
a:hover {
color: #535bf2;
}
body {
margin: 0;
display: flex;
place-items: center;
min-width: 320px;
min-height: 100vh;
}
h1 {
font-size: 3.2em;
line-height: 1.1;
}
button {
border-radius: 8px;
border: 1px solid transparent;
padding: 0.6em 1.2em;
font-size: 1em;
font-weight: 500;
font-family: inherit;
background-color: #1a1a1a;
cursor: pointer;
transition: border-color 0.25s;
}
button:hover {
border-color: #646cff;
}
button:focus,
button:focus-visible {
outline: 4px auto -webkit-focus-ring-color;
}
.card {
padding: 2em;
}
#app {
max-width: 1280px;
margin: 0 auto;
padding: 2rem;
text-align: center;
}
@media (prefers-color-scheme: light) {
:root {
color: #213547;
background-color: #ffffff;
}
a:hover {
color: #747bff;
}
button {
background-color: #f9f9f9;
}
}

273
src/useEspFlasher.js Normal file
View file

@ -0,0 +1,273 @@
// imports (use npm installed esptool-js, adjust path if needed)
import { ESPLoader, Transport } from "esptool-js";
import CryptoJS from "crypto-js";
import { ref, reactive, onMounted } from "vue";
const baudRates = [921600, 115200, 230400, 460800];
const maxLogLength = 100;
// Reactive state
export function useEspFlasher() {
const log = ref("");
const connected = ref(false);
const darkMode = ref(false);
const autoscroll = ref(true);
const noReset = ref(false);
const selectedBaudRate = ref(115200);
// Firmware files & offsets (4 slots)
const firmware = reactive([null, null, null, null]);
const offsets = reactive(["0x1000", "0x8000", "0xe000", "0x10000"]);
const progress = reactive([0, 0, 0, 0]);
const progressVisible = reactive([false, false, false, false]);
// Device & ESP loader handles
let device = null;
let transport = null;
let esploader = null;
let chip = null;
const serialLib = navigator.serial;
// Helper: Append log with pruning
function appendLog(text) {
log.value += text;
pruneLog();
}
function appendLogLine(text) {
appendLog(text + "<br>");
}
function pruneLog() {
const lines = log.value.split("<br>");
if (lines.length > maxLogLength) {
log.value = lines.slice(-maxLogLength).join("<br>");
}
}
function errorMsg(text) {
appendLogLine(`<span style="color:red;">Error:</span> ${text}`);
console.error(text);
}
const espLoaderTerminal = {
clean() {
log.value = "";
},
writeLine(data) {
appendLogLine(data);
},
write(data) {
appendLog(data);
},
};
function saveSetting(key, value) {
window.localStorage.setItem(key, JSON.stringify(value));
}
function loadSetting(key, defaultVal) {
const val = JSON.parse(window.localStorage.getItem(key));
return val === null ? defaultVal : val;
}
onMounted(() => {
autoscroll.value = loadSetting("autoscroll", true);
selectedBaudRate.value = loadSetting("baudrate", 115200);
darkMode.value = loadSetting("darkmode", false);
noReset.value = loadSetting("noReset", false);
appendLogLine("ESP Web Flasher loaded.");
});
// Connect or Disconnect logic
async function clickConnect() {
if (transport !== null) {
// Disconnect
await transport.disconnect();
await transport.waitForUnlock(1500);
toggleUIConnected(false);
transport = null;
if (device) {
await device.close();
device = null;
}
chip = null;
return;
}
try {
if (!device) device = await serialLib.requestPort({});
transport = new Transport(device, true);
const romBaudrate = parseInt(selectedBaudRate.value);
esploader = new ESPLoader({
transport,
baudrate: romBaudrate,
terminal: espLoaderTerminal,
debugLogging: false,
});
let resetMode = "default_reset";
if (noReset.value) {
resetMode = "no_reset";
try {
await transport.connect(romBaudrate);
await transport.disconnect();
await sleep(350);
} catch {}
}
chip = await esploader.main(resetMode);
toggleUIConnected(true);
toggleUIToolbar(true);
} catch (e) {
errorMsg(e.message || e);
toggleUIConnected(false);
}
}
function toggleUIConnected(isConnected) {
connected.value = isConnected;
if (!isConnected) toggleUIToolbar(false);
}
function toggleUIToolbar(show) {
for (let i = 0; i < 4; i++) {
progressVisible[i] = false;
progress[i] = 0;
}
}
async function clickErase() {
if (!confirm("This will erase the entire flash. Click OK to continue.")) return;
disableControls(true);
try {
appendLogLine("Erasing flash memory. Please wait...");
const start = Date.now();
await esploader.eraseFlash();
appendLogLine(`Finished erasing. Took ${Date.now() - start} ms.`);
} catch (e) {
errorMsg(e.message || e);
} finally {
disableControls(false);
}
}
function disableControls(disabled) {
// Use this to disable your UI controls in the Vue template
// e.g. you can expose refs or reactive booleans for that
}
// Helpers for file validity and reading
function getValidFiles() {
const valid = [];
const offsetsSet = new Set();
for (let i = 0; i < 4; i++) {
if (firmware[i] && !offsetsSet.has(offsets[i])) {
valid.push(i);
offsetsSet.add(offsets[i]);
}
}
return valid;
}
async function clickProgram() {
if (!esploader) {
errorMsg("Please connect first.");
return;
}
disableControls(true);
try {
const fileArray = [];
for (const i of getValidFiles()) {
progressVisible[i] = true;
const file = firmware[i];
const data = await readFileAsBinary(file);
const offset = parseInt(offsets[i], 16);
fileArray.push({ data, address: offset });
}
await esploader.writeFlash({
fileArray,
flashSize: "keep",
eraseAll: false,
compress: true,
reportProgress: (fileIndex, written, total) => {
progress[fileIndex] = Math.floor((written / total) * 100);
},
calculateMD5Hash: (image) =>
CryptoJS.MD5(CryptoJS.enc.Latin1.parse(image)),
});
appendLogLine("Flashing complete. Please reset your device.");
} catch (e) {
errorMsg(e.message || e);
} finally {
for (let i = 0; i < 4; i++) {
progressVisible[i] = false;
progress[i] = 0;
}
disableControls(false);
}
}
function readFileAsBinary(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onerror = () => {
reader.abort();
reject(new DOMException("Problem reading file."));
};
reader.onload = () => {
resolve(reader.result);
};
reader.readAsBinaryString(file);
});
}
// Watchers or handlers for UI inputs (not shown here, to be wired in your Vue component)
// Save/load settings on changes
function onBaudRateChange(val) {
saveSetting("baudrate", val);
}
function onDarkModeChange(val) {
saveSetting("darkmode", val);
}
function onAutoScrollChange(val) {
saveSetting("autoscroll", val);
}
function onNoResetChange(val) {
saveSetting("noReset", val);
}
// Utility sleep
function sleep(ms) {
return new Promise((resolve) => setTimeout(resolve, ms));
}
return {
// reactive state
log,
connected,
darkMode,
autoscroll,
noReset,
selectedBaudRate,
firmware,
offsets,
progress,
progressVisible,
// methods
clickConnect,
clickErase,
clickProgram,
onBaudRateChange,
onDarkModeChange,
onAutoScrollChange,
onNoResetChange,
};
}

7
vite.config.js Normal file
View file

@ -0,0 +1,7 @@
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
// https://vite.dev/config/
export default defineConfig({
plugins: [vue()],
})