Files
ESP-Nodes/node_modules/esptool-js/lib/targets/esp32.js
2025-07-26 14:04:40 -04:00

186 lines
6.0 KiB
JavaScript

import { ROM } from "./rom.js";
export class ESP32ROM extends ROM {
constructor() {
super(...arguments);
this.CHIP_NAME = "ESP32";
this.IMAGE_CHIP_ID = 0;
this.EFUSE_RD_REG_BASE = 0x3ff5a000;
this.DR_REG_SYSCON_BASE = 0x3ff66000;
this.UART_CLKDIV_REG = 0x3ff40014;
this.UART_CLKDIV_MASK = 0xfffff;
this.UART_DATE_REG_ADDR = 0x60000078;
this.XTAL_CLK_DIVIDER = 1;
this.FLASH_SIZES = {
"1MB": 0x00,
"2MB": 0x10,
"4MB": 0x20,
"8MB": 0x30,
"16MB": 0x40,
};
this.FLASH_WRITE_SIZE = 0x400;
this.BOOTLOADER_FLASH_OFFSET = 0x1000;
this.SPI_REG_BASE = 0x3ff42000;
this.SPI_USR_OFFS = 0x1c;
this.SPI_USR1_OFFS = 0x20;
this.SPI_USR2_OFFS = 0x24;
this.SPI_W0_OFFS = 0x80;
this.SPI_MOSI_DLEN_OFFS = 0x28;
this.SPI_MISO_DLEN_OFFS = 0x2c;
}
async readEfuse(loader, offset) {
const addr = this.EFUSE_RD_REG_BASE + 4 * offset;
loader.debug("Read efuse " + addr);
return await loader.readReg(addr);
}
async getPkgVersion(loader) {
const word3 = await this.readEfuse(loader, 3);
let pkgVersion = (word3 >> 9) & 0x07;
pkgVersion += ((word3 >> 2) & 0x1) << 3;
return pkgVersion;
}
async getChipRevision(loader) {
const word3 = await this.readEfuse(loader, 3);
const word5 = await this.readEfuse(loader, 5);
const apbCtlDate = await loader.readReg(this.DR_REG_SYSCON_BASE + 0x7c);
const revBit0 = (word3 >> 15) & 0x1;
const revBit1 = (word5 >> 20) & 0x1;
const revBit2 = (apbCtlDate >> 31) & 0x1;
if (revBit0 != 0) {
if (revBit1 != 0) {
if (revBit2 != 0) {
return 3;
}
else {
return 2;
}
}
else {
return 1;
}
}
return 0;
}
async getChipDescription(loader) {
const chipDesc = [
"ESP32-D0WDQ6",
"ESP32-D0WD",
"ESP32-D2WD",
"",
"ESP32-U4WDH",
"ESP32-PICO-D4",
"ESP32-PICO-V3-02",
];
let chipName = "";
const pkgVersion = await this.getPkgVersion(loader);
const chipRevision = await this.getChipRevision(loader);
const rev3 = chipRevision == 3;
const single_core = (await this.readEfuse(loader, 3)) & (1 << 0);
if (single_core != 0) {
chipDesc[0] = "ESP32-S0WDQ6";
chipDesc[1] = "ESP32-S0WD";
}
if (rev3) {
chipDesc[5] = "ESP32-PICO-V3";
}
if (pkgVersion >= 0 && pkgVersion <= 6) {
chipName = chipDesc[pkgVersion];
}
else {
chipName = "Unknown ESP32";
}
if (rev3 && (pkgVersion === 0 || pkgVersion === 1)) {
chipName += "-V3";
}
return chipName + " (revision " + chipRevision + ")";
}
async getChipFeatures(loader) {
const features = ["Wi-Fi"];
const word3 = await this.readEfuse(loader, 3);
const chipVerDisBt = word3 & (1 << 1);
if (chipVerDisBt === 0) {
features.push(" BT");
}
const chipVerDisAppCpu = word3 & (1 << 0);
if (chipVerDisAppCpu !== 0) {
features.push(" Single Core");
}
else {
features.push(" Dual Core");
}
const chipCpuFreqRated = word3 & (1 << 13);
if (chipCpuFreqRated !== 0) {
const chipCpuFreqLow = word3 & (1 << 12);
if (chipCpuFreqLow !== 0) {
features.push(" 160MHz");
}
else {
features.push(" 240MHz");
}
}
const pkgVersion = await this.getPkgVersion(loader);
if ([2, 4, 5, 6].indexOf(pkgVersion) !== -1) {
features.push(" Embedded Flash");
}
if (pkgVersion === 6) {
features.push(" Embedded PSRAM");
}
const word4 = await this.readEfuse(loader, 4);
const adcVref = (word4 >> 8) & 0x1f;
if (adcVref !== 0) {
features.push(" VRef calibration in efuse");
}
const blk3PartRes = (word3 >> 14) & 0x1;
if (blk3PartRes !== 0) {
features.push(" BLK3 partially reserved");
}
const word6 = await this.readEfuse(loader, 6);
const codingScheme = word6 & 0x3;
const codingSchemeArr = ["None", "3/4", "Repeat (UNSUPPORTED)", "Invalid"];
features.push(" Coding Scheme " + codingSchemeArr[codingScheme]);
return features;
}
async getCrystalFreq(loader) {
const uartDiv = (await loader.readReg(this.UART_CLKDIV_REG)) & this.UART_CLKDIV_MASK;
const etsXtal = (loader.transport.baudrate * uartDiv) / 1000000 / this.XTAL_CLK_DIVIDER;
let normXtal;
if (etsXtal > 33) {
normXtal = 40;
}
else {
normXtal = 26;
}
if (Math.abs(normXtal - etsXtal) > 1) {
loader.info("WARNING: Unsupported crystal in use");
}
return normXtal;
}
_d2h(d) {
const h = (+d).toString(16);
return h.length === 1 ? "0" + h : h;
}
async readMac(loader) {
let mac0 = await this.readEfuse(loader, 1);
mac0 = mac0 >>> 0;
let mac1 = await this.readEfuse(loader, 2);
mac1 = mac1 >>> 0;
const mac = new Uint8Array(6);
mac[0] = (mac1 >> 8) & 0xff;
mac[1] = mac1 & 0xff;
mac[2] = (mac0 >> 24) & 0xff;
mac[3] = (mac0 >> 16) & 0xff;
mac[4] = (mac0 >> 8) & 0xff;
mac[5] = mac0 & 0xff;
return (this._d2h(mac[0]) +
":" +
this._d2h(mac[1]) +
":" +
this._d2h(mac[2]) +
":" +
this._d2h(mac[3]) +
":" +
this._d2h(mac[4]) +
":" +
this._d2h(mac[5]));
}
}