-
the project is in
examples/typescript
we are preserving it there so we can better detect in future esptool updates what changed -
it's is just a fork of esptool.js by expressif, we may add some smart features on top of it but hosting of FW and other stuff in integration with our platform is closed (integration with Spectoda Studio).
Down here is kept official README info by Expressif
This repository contains a Javascript implementation of esptool, a serial flasher utility for Espressif chips. esptool-js
is based on Web Serial API and works in Google Chrome and Microsoft Edge version 89 or later browsers.
NOTE: Unlike the Python-based esptool, esptool-js
doesn't implement generation of binary images out of ELF files, and doesn't include companion tools similar to espefuse.py and espsecure.py.
CDN
https://unpkg.com/esptool-js/lib/index.js?module
NPM
npm install --save esptool-js
Yarn
yarn add --save esptool-js
Check an example project here.
const portFilters: { usbVendorId?: number | undefined, usbProductId?: number | undefined }[] = [];
const device = await navigator.serial.requestPort({ filters: portFilters });
// You can use any JavaScript compatible terminal by wrapping it in a helper object like this:
let espLoaderTerminal = {
clean() {
// Implement the clean function call for your terminal here.
},
writeLine(data) {
// Implement the writeLine function call for your terminal here.
},
write(data) {
// Implement the write function call for your terminal here.
},
};
You can pass this terminal object to ESPLoader
constructor as shown in the examples projects.
Visit https://espressif.github.io/esptool-js/ to see this tool in action.
npm install
npm run build
cd examples/typescript
npm install
npm run dev # Run local sever with example code
Then open https://localhost:1234
in a Chrome browser. The npm run build
step builds the lib
used in the example examples/typescript/index.html
. Update this reference as described in Usage section.
The code in this repository is Copyright (c) 2023 Espressif Systems (Shanghai) Co. Ltd. It is licensed under Apache 2.0 license, as described in LICENSE file.