@mikrojs/firmware 0.0.7

package/index.js

@@ -0,0 +1,20 @@
+import {existsSync} from 'node:fs'
+import {dirname, join} from 'node:path'
+import {fileURLToPath} from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+export const componentDir = join(__dirname, 'components')
+export const configDir = __dirname
+export const defaultAppDir = join(__dirname, 'default-app')
+export const projectCmakePath = join(__dirname, 'project.cmake')
+
+const prebuildsRoot = join(__dirname, 'prebuilds')
+
+export function prebuiltFirmwareDir(chip) {
+  return join(prebuildsRoot, chip)
+}
+
+export function hasPrebuiltFirmware(chip) {
+  return existsSync(join(prebuildsRoot, chip, 'flasher_args.json'))
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@mikrojs/firmware",
+  "version": "0.0.7",
+  "description": "Mikro.js ESP32 firmware: ESP-IDF component, build tools, and project template",
+  "keywords": [
+    "esp-idf",
+    "esp32",
+    "firmware",
+    "mikrojs"
+  ],
+  "homepage": "https://github.com/mikrojs/mikrojs#readme",
+  "bugs": {
+    "url": "https://github.com/mikrojs/mikrojs/issues"
+  },
+  "license": "MIT",
+  "author": "Bjørge Næss <bjoerge@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikrojs/mikrojs.git"
+  },
+  "bin": {
+    "idf.py": "./bin/idf.py"
+  },
+  "files": [
+    "components",
+    "default-app",
+    "prebuilds",
+    "sdkconfig.defaults",
+    "sdkconfig.defaults.*",
+    "partitions.csv",
+    "bin",
+    "chips.json",
+    "cmake.js",
+    "discover.js",
+    "index.js",
+    "index.d.ts",
+    "project.cmake",
+    "resolve.js"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./cmake": "./cmake.js",
+    "./discover": "./discover.js",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "esbuild": "^0.28.0",
+    "@mikrojs/native": "0.0.7",
+    "@mikrojs/quickjs": "0.0.7"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {}
+}

package/partitions.csv

@@ -0,0 +1,5 @@
+# Name,   Type, SubType, Offset,  Size, Flags
+nvs,      data, nvs,     0x9000,  0x6000,
+phy_init, data, phy,     0xf000,  0x1000,
+factory,  app,  factory, 0x10000, 0x280000,
+user,     data, littlefs,      ,  0x100000,

package/prebuilds/esp32/flasher_args.json

@@ -0,0 +1,24 @@
+{
+    "write_flash_args" : [ "--flash-mode", "dio",
+                           "--flash-size", "4MB",
+                           "--flash-freq", "40m" ],
+    "flash_settings" : {
+        "flash_mode": "dio",
+        "flash_size": "4MB",
+        "flash_freq": "40m"
+    },
+    "flash_files" : {
+        "0x1000" : "bootloader/bootloader.bin",
+        "0x8000" : "partition_table/partition-table.bin",
+        "0x10000" : "mikrojs.bin"
+    },
+    "bootloader" : { "offset" : "0x1000", "file" : "bootloader/bootloader.bin", "encrypted" : "false" },
+    "partition-table" : { "offset" : "0x8000", "file" : "partition_table/partition-table.bin", "encrypted" : "false" },
+    "app" : { "offset" : "0x10000", "file" : "mikrojs.bin", "encrypted" : "false" },
+    "extra_esptool_args" : {
+        "after"  : "hard-reset",
+        "before" : "default-reset",
+        "stub"   : true,
+        "chip"   : "esp32"
+    }
+}

package/prebuilds/esp32c3/flasher_args.json

@@ -0,0 +1,24 @@
+{
+    "write_flash_args" : [ "--flash-mode", "dio",
+                           "--flash-size", "4MB",
+                           "--flash-freq", "80m" ],
+    "flash_settings" : {
+        "flash_mode": "dio",
+        "flash_size": "4MB",
+        "flash_freq": "80m"
+    },
+    "flash_files" : {
+        "0x0" : "bootloader/bootloader.bin",
+        "0x8000" : "partition_table/partition-table.bin",
+        "0x10000" : "mikrojs.bin"
+    },
+    "bootloader" : { "offset" : "0x0", "file" : "bootloader/bootloader.bin", "encrypted" : "false" },
+    "partition-table" : { "offset" : "0x8000", "file" : "partition_table/partition-table.bin", "encrypted" : "false" },
+    "app" : { "offset" : "0x10000", "file" : "mikrojs.bin", "encrypted" : "false" },
+    "extra_esptool_args" : {
+        "after"  : "hard-reset",
+        "before" : "default-reset",
+        "stub"   : true,
+        "chip"   : "esp32c3"
+    }
+}

package/prebuilds/esp32c6/flasher_args.json

@@ -0,0 +1,24 @@
+{
+    "write_flash_args" : [ "--flash-mode", "dio",
+                           "--flash-size", "4MB",
+                           "--flash-freq", "80m" ],
+    "flash_settings" : {
+        "flash_mode": "dio",
+        "flash_size": "4MB",
+        "flash_freq": "80m"
+    },
+    "flash_files" : {
+        "0x0" : "bootloader/bootloader.bin",
+        "0x8000" : "partition_table/partition-table.bin",
+        "0x10000" : "mikrojs.bin"
+    },
+    "bootloader" : { "offset" : "0x0", "file" : "bootloader/bootloader.bin", "encrypted" : "false" },
+    "partition-table" : { "offset" : "0x8000", "file" : "partition_table/partition-table.bin", "encrypted" : "false" },
+    "app" : { "offset" : "0x10000", "file" : "mikrojs.bin", "encrypted" : "false" },
+    "extra_esptool_args" : {
+        "after"  : "hard-reset",
+        "before" : "default-reset",
+        "stub"   : true,
+        "chip"   : "esp32c6"
+    }
+}

package/prebuilds/esp32s3/flasher_args.json

@@ -0,0 +1,24 @@
+{
+    "write_flash_args" : [ "--flash-mode", "dio",
+                           "--flash-size", "4MB",
+                           "--flash-freq", "80m" ],
+    "flash_settings" : {
+        "flash_mode": "dio",
+        "flash_size": "4MB",
+        "flash_freq": "80m"
+    },
+    "flash_files" : {
+        "0x0" : "bootloader/bootloader.bin",
+        "0x8000" : "partition_table/partition-table.bin",
+        "0x10000" : "mikrojs.bin"
+    },
+    "bootloader" : { "offset" : "0x0", "file" : "bootloader/bootloader.bin", "encrypted" : "false" },
+    "partition-table" : { "offset" : "0x8000", "file" : "partition_table/partition-table.bin", "encrypted" : "false" },
+    "app" : { "offset" : "0x10000", "file" : "mikrojs.bin", "encrypted" : "false" },
+    "extra_esptool_args" : {
+        "after"  : "hard-reset",
+        "before" : "default-reset",
+        "stub"   : true,
+        "chip"   : "esp32s3"
+    }
+}

package/project.cmake

@@ -0,0 +1,101 @@
+# project.cmake — reusable CMake module for mikrojs firmware projects
+#
+# Usage in user's CMakeLists.txt:
+#   cmake_minimum_required(VERSION 3.22)
+#   include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+#   execute_process(
+#       COMMAND node <path-to>/resolve.js projectCmakePath
+#       OUTPUT_VARIABLE _MIK_CMAKE OUTPUT_STRIP_TRAILING_WHITESPACE)
+#   include(${_MIK_CMAKE})
+#   project(my-firmware)
+
+# ── Validate ESP-IDF version ─────────────────────────────────────────
+if(IDF_VERSION_MAJOR LESS 6)
+    message(FATAL_ERROR
+        "mikrojs requires ESP-IDF >= 6.0.0, found ${IDF_VERSION_MAJOR}.${IDF_VERSION_MINOR}.${IDF_VERSION_PATCH}. "
+        "Install a supported version via EIM: https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/index.html"
+    )
+endif()
+
+add_compile_options($<$<COMPILE_LANGUAGE:C>:-Wno-incompatible-pointer-types>)
+add_compile_options(-Wno-format)
+
+# resolve.js is next to this file
+get_filename_component(_MIK_RESOLVE "${CMAKE_CURRENT_LIST_FILE}" DIRECTORY)
+set(_MIK_RESOLVE "${_MIK_RESOLVE}/resolve.js")
+
+# ── Resolve firmware package paths ───────────────────────────────────
+execute_process(
+    COMMAND node ${_MIK_RESOLVE} componentDir
+    OUTPUT_VARIABLE _MIK_COMPONENT_DIR
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+if(NOT _MIK_COMPONENT_DIR)
+    message(FATAL_ERROR "@mikrojs/firmware not found. Run 'pnpm install' or 'npm install' first.")
+endif()
+
+execute_process(
+    COMMAND node ${_MIK_RESOLVE} configDir
+    OUTPUT_VARIABLE _MIK_CONFIG_DIR
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+execute_process(
+    COMMAND node ${_MIK_RESOLVE} defaultAppDir
+    OUTPUT_VARIABLE _MIK_DEFAULT_APP_DIR
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+# ── Board and driver package discovery ───────────────────────────────
+execute_process(
+    COMMAND node ${_MIK_RESOLVE} discover ${CMAKE_CURRENT_LIST_DIR}
+    OUTPUT_VARIABLE _BOARD_JSON
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+# Start with the mikrojs component dir and default main
+set(EXTRA_COMPONENT_DIRS "${_MIK_COMPONENT_DIR}")
+
+# Use the firmware package's default main/ component unless the project has its own
+if(NOT EXISTS "${CMAKE_SOURCE_DIR}/main/CMakeLists.txt")
+    set(EXTRA_COMPONENT_DIRS "${EXTRA_COMPONENT_DIRS};${_MIK_DEFAULT_APP_DIR}")
+endif()
+
+# ── Default sdkconfig and partition table from firmware package ───────
+# CMAKE_CURRENT_LIST_DIR is the firmware package (where this file lives).
+# CMAKE_SOURCE_DIR is the consuming project (e.g. esp32/).
+set(_SDKCONFIG_LIST "")
+list(APPEND _SDKCONFIG_LIST "${_MIK_CONFIG_DIR}/sdkconfig.defaults")
+if(EXISTS "${_MIK_CONFIG_DIR}/sdkconfig.defaults.${IDF_TARGET}")
+    list(APPEND _SDKCONFIG_LIST "${_MIK_CONFIG_DIR}/sdkconfig.defaults.${IDF_TARGET}")
+endif()
+# Project-level overrides come after firmware defaults (later = higher priority).
+if(EXISTS "${CMAKE_SOURCE_DIR}/sdkconfig.defaults")
+    list(APPEND _SDKCONFIG_LIST "${CMAKE_SOURCE_DIR}/sdkconfig.defaults")
+endif()
+if(EXISTS "${CMAKE_SOURCE_DIR}/sdkconfig.defaults.${IDF_TARGET}")
+    list(APPEND _SDKCONFIG_LIST "${CMAKE_SOURCE_DIR}/sdkconfig.defaults.${IDF_TARGET}")
+endif()
+
+# Partition table: generate a sdkconfig fragment with the absolute path
+if(EXISTS "${CMAKE_SOURCE_DIR}/partitions.csv")
+    set(_PARTITION_CSV "${CMAKE_SOURCE_DIR}/partitions.csv")
+else()
+    set(_PARTITION_CSV "${_MIK_CONFIG_DIR}/partitions.csv")
+endif()
+set(_PARTITION_FRAGMENT "${CMAKE_SOURCE_DIR}/build/sdkconfig.partitions")
+file(WRITE "${_PARTITION_FRAGMENT}" "CONFIG_PARTITION_TABLE_CUSTOM_FILENAME=\"${_PARTITION_CSV}\"\n")
+list(APPEND _SDKCONFIG_LIST "${_PARTITION_FRAGMENT}")
+
+if(_BOARD_JSON)
+    string(JSON _BOARD_COMPONENT_DIRS GET "${_BOARD_JSON}" "components")
+    string(JSON _BOARD_SDKCONFIG_DEFAULTS GET "${_BOARD_JSON}" "sdkconfigs")
+    if(_BOARD_COMPONENT_DIRS)
+        set(EXTRA_COMPONENT_DIRS "${EXTRA_COMPONENT_DIRS};${_BOARD_COMPONENT_DIRS}")
+    endif()
+    if(_BOARD_SDKCONFIG_DEFAULTS)
+        list(APPEND _SDKCONFIG_LIST "${_BOARD_SDKCONFIG_DEFAULTS}")
+    endif()
+endif()
+
+set(SDKCONFIG_DEFAULTS "${_SDKCONFIG_LIST}")

package/resolve.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * Resolve package paths for CMake. Called by CMakeLists.txt files.
+ *
+ * Usage: node resolve.js <query> [args...]
+ *
+ * Queries:
+ *   componentDir     — EXTRA_COMPONENT_DIRS parent (contains mikrojs/)
+ *   configDir        — directory with sdkconfig.defaults + partitions.csv
+ *   defaultAppDir    — directory containing default main/ component
+ *   projectCmakePath — path to project.cmake
+ *   quickjs          — path to quickjs.cmake
+ *   native           — JSON with native package paths
+ *   version          — firmware package version
+ *   discover <dir>   — discover board/driver components from project dir
+ */
+import {componentDir, projectCmakePath} from './cmake.js'
+import {configDir, defaultAppDir} from './index.js'
+
+const query = process.argv[2]
+
+if (query === 'componentDir') {
+  process.stdout.write(componentDir)
+} else if (query === 'configDir') {
+  process.stdout.write(configDir)
+} else if (query === 'defaultAppDir') {
+  process.stdout.write(defaultAppDir)
+} else if (query === 'projectCmakePath') {
+  process.stdout.write(projectCmakePath)
+} else if (query === 'quickjs') {
+  const m = await import('@mikrojs/quickjs')
+  process.stdout.write(m.cmakePath)
+} else if (query === 'native') {
+  const n = await import('@mikrojs/native/cmake')
+  process.stdout.write(
+    JSON.stringify({
+      include: n.includePath,
+      src: n.srcPath,
+      runtime: n.runtimePath,
+      scripts: n.scriptsPath,
+      bytecodeCmake: n.bytecodeCmakePath,
+    }),
+  )
+} else if (query === 'version') {
+  const {default: pkg} = await import('./package.json', {with: {type: 'json'}})
+  process.stdout.write(pkg.version)
+} else if (query === 'discover') {
+  const projectDir = process.argv[3]
+  const {discover} = await import('./discover.js')
+  process.stdout.write(JSON.stringify(discover(projectDir)))
+} else {
+  process.stderr.write(`Unknown query: ${query}\n`)
+  process.exit(1)
+}

package/sdkconfig.defaults

@@ -0,0 +1,127 @@
+# --- Task & stack sizes ---
+# Main task runs the mikrojs runtime directly. Deep JS → native → JS chains
+# overflow 16 KB; 24 KB gives ~8 KB headroom with no observed waste on
+# simpler apps. See packages/@mikrojs/firmware/components/mikrojs/MEMORY_ANALYSIS.md.
+CONFIG_ESP_MAIN_TASK_STACK_SIZE=24576
+CONFIG_ESP_SYSTEM_EVENT_TASK_STACK_SIZE=4096
+CONFIG_ESP_MINIMAL_SHARED_STACK_SIZE=2048
+
+# --- Partition table ---
+CONFIG_PARTITION_TABLE_CUSTOM=y
+# CONFIG_PARTITION_TABLE_CUSTOM_FILENAME is set by project.cmake
+
+# --- Flash ---
+CONFIG_ESPTOOLPY_FLASHFREQ="80m"
+# ESP-IDF defaults C6 (and some others) to 2MB flash. Modern dev kits ship
+# with 4MB+, and the partition table grew past 2MB once BLE was enabled.
+CONFIG_ESPTOOLPY_FLASHSIZE="4MB"
+CONFIG_ESPTOOLPY_FLASHSIZE_4MB=y
+
+# --- RAM optimization ---
+# Use -Os to reduce code size (less IRAM pressure, smaller function frames)
+CONFIG_COMPILER_OPTIMIZATION_SIZE=y
+
+# Move system functions from IRAM to flash (IRAM and DRAM share the same
+# SRAM on single-core chips like C3/C6, so freeing IRAM also frees DRAM)
+CONFIG_HEAP_PLACE_FUNCTION_INTO_FLASH=y
+CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH=y
+CONFIG_RINGBUF_PLACE_FUNCTIONS_INTO_FLASH=y
+
+# Trade WiFi throughput for ~15-20KB IRAM savings. Fine for mikrojs
+# workloads (HTTP requests, small payloads — not high-throughput streaming).
+CONFIG_ESP_WIFI_IRAM_OPT=n
+CONFIG_ESP_WIFI_RX_IRAM_OPT=n
+
+# SPI master ISR doesn't need to run during flash writes
+CONFIG_SPI_MASTER_ISR_IN_IRAM=n
+
+# No ISRs post events while cache is disabled
+CONFIG_ESP_EVENT_POST_FROM_IRAM_ISR=n
+
+# Keep UART ISR in IRAM so it runs during flash writes (LittleFS).
+# Without this, the 128-byte RX FIFO overflows during deploy.
+CONFIG_UART_ISR_IN_IRAM=y
+
+# --- LittleFS ---
+# Track modification time so fs.stat() / fs.readDir() surface mtime
+# (exposed as ms-since-epoch on the StatResult object).
+CONFIG_LITTLEFS_USE_MTIME=y
+
+# --- Logging ---
+# Production default: NONE. No log output on serial console, keeps the
+# REPL protocol stream clean. The bootloader is also silenced.
+#
+# CONFIG_LOG_DYNAMIC_LEVEL_CONTROL=y enables esp_log_level_set() at
+# runtime, which we use in mik__apply_nvs_log_level() to flip specific
+# mikrojs tags to DEBUG based on the MIK_LOG_LEVEL NVS env var. This
+# costs a few hundred bytes of flash (the tag-level hash table) and
+# near-zero RAM.
+#
+# We intentionally do NOT raise CONFIG_LOG_MAXIMUM_LEVEL. libmikrojs's
+# log calls go through platform->log → esp_log_writev (a real function
+# call, not a macro), so they're always compiled in and only filtered
+# at runtime. Raising MAXIMUM_LEVEL would pull in debug format strings
+# from every ESP-IDF subsystem (BLE/WiFi/lwIP/drivers) — measured at
+# +121 KB flash + 3 KB RAM on ESP32-C6. Not worth it for dev
+# diagnostics we can already get via the runtime path.
+CONFIG_LOG_DEFAULT_LEVEL_NONE=y
+CONFIG_LOG_DEFAULT_LEVEL=0
+CONFIG_LOG_DYNAMIC_LEVEL_CONTROL=y
+CONFIG_BOOTLOADER_LOG_LEVEL_NONE=y
+CONFIG_BOOTLOADER_LOG_LEVEL=0
+
+# --- Bluetooth / BLE (NimBLE host, peripheral + broadcaster roles) ---
+CONFIG_BT_ENABLED=y
+CONFIG_BT_NIMBLE_ENABLED=y
+CONFIG_BT_BLUEDROID_ENABLED=n
+CONFIG_BT_NIMBLE_ROLE_PERIPHERAL=y
+CONFIG_BT_NIMBLE_ROLE_BROADCASTER=y
+CONFIG_BT_NIMBLE_ROLE_CENTRAL=n
+CONFIG_BT_NIMBLE_ROLE_OBSERVER=n
+CONFIG_BT_NIMBLE_HOST_TASK_STACK_SIZE=4096
+CONFIG_BT_NIMBLE_ATT_PREFERRED_MTU=256
+# Software coexistence for chips that share the 2.4 GHz radio between WiFi and BLE
+# (ESP32, ESP32-S3, ESP32-C3). Harmless on chips with separate radios (ESP32-C6).
+CONFIG_ESP_COEX_SW_COEXIST_ENABLE=y
+
+# Disable unused C++ features
+CONFIG_COMPILER_CXX_EXCEPTIONS=n
+CONFIG_COMPILER_CXX_RTTI=n
+
+# Disable unused VFS features (~6KB savings)
+CONFIG_VFS_SUPPORT_SELECT=n
+
+# --- Assertions & error strings ---
+CONFIG_COMPILER_OPTIMIZATION_CHECKS_SILENT=y
+CONFIG_ESP_ERR_TO_NAME_LOOKUP=n
+CONFIG_HAL_DEFAULT_ASSERTION_LEVEL=0
+
+# --- lwIP ---
+CONFIG_LWIP_IPV6=n
+
+# --- MbedTLS: TLS 1.2 + 1.3, AES-GCM/CCM, ECDHE ---
+CONFIG_MBEDTLS_SSL_PROTO_TLS1_3=y
+# Disable unused features
+CONFIG_MBEDTLS_SSL_RENEGOTIATION=n
+CONFIG_MBEDTLS_SSL_ALPN=y
+CONFIG_MBEDTLS_PKCS7_C=n
+CONFIG_MBEDTLS_PEM_WRITE_C=n
+
+CONFIG_MBEDTLS_X509_CRL_PARSE_C=n
+CONFIG_MBEDTLS_X509_CSR_PARSE_C=n
+
+CONFIG_MBEDTLS_ERROR_STRINGS=n
+CONFIG_MBEDTLS_FS_IO=n
+
+# Disable rarely used ECC curves (keep P-256, P-384, Curve25519)
+# Note: secp192r1, secp224r1, secp192k1, secp224k1 removed in MbedTLS 4.x
+CONFIG_MBEDTLS_ECP_DP_SECP521R1_ENABLED=n
+CONFIG_MBEDTLS_ECP_DP_SECP256K1_ENABLED=n
+CONFIG_MBEDTLS_ECP_DP_BP256R1_ENABLED=n
+CONFIG_MBEDTLS_ECP_DP_BP384R1_ENABLED=n
+CONFIG_MBEDTLS_ECP_DP_BP512R1_ENABLED=n
+
+# Use smaller cert bundle (common CAs only)
+CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_CMN=y
+CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY=y
+

package/sdkconfig.defaults.esp32

@@ -0,0 +1,8 @@
+# ESP32: uses UART for console I/O
+# No overrides needed — base sdkconfig.defaults handles UART targets.
+
+# Enable PSRAM if present (e.g. WROVER modules with 4-8 MB).
+# IGNORE_NOTFOUND: fall back to internal SRAM if not present.
+CONFIG_SPIRAM=y
+CONFIG_SPIRAM_USE_MALLOC=y
+CONFIG_SPIRAM_IGNORE_NOTFOUND=y

package/sdkconfig.defaults.esp32c3

@@ -0,0 +1,15 @@
+# ESP32-C3: route ESP-IDF stdio/ESP_LOG to UART0 rather than the
+# built-in USB Serial/JTAG. See sdkconfig.defaults.esp32c6 for the
+# reasoning (avoid ESP-IDF auto-registering the USB-JTAG VFS / stdio
+# stack at boot). mikrojs installs the USB-Serial/JTAG driver itself
+# via the public API in mik_serial_io.cpp for REPL/TLV transport.
+#
+# Secondary console on USB-Serial/JTAG so panic dumps + bootloader
+# messages still reach a dev monitor attached over USB (the primary
+# UART usually isn't wired up on dev boards). ESP-IDF writes panic
+# output directly to USB-JTAG hardware registers, which doesn't
+# conflict with mikrojs's driver-level registration for regular
+# REPL traffic.
+CONFIG_ESP_CONSOLE_UART_DEFAULT=y
+CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG=n
+CONFIG_ESP_CONSOLE_SECONDARY_USB_SERIAL_JTAG=y

package/sdkconfig.defaults.esp32c6

@@ -0,0 +1,26 @@
+# ESP32-C6: route ESP-IDF stdio/ESP_LOG to UART0 rather than the
+# built-in USB Serial/JTAG. This prevents ESP-IDF's startup code from
+# registering the USB-JTAG VFS and pulling it into newlib's stdio
+# before app_main() runs — an early-boot init sequence heavy enough
+# to tip marginal battery supplies past brown-out on some boards.
+#
+# mikrojs still exposes USB-Serial/JTAG as a REPL/TLV transport — see
+# mik_serial_io.cpp, which installs the USB-Serial/JTAG driver through
+# the public API and bypasses VFS entirely. Auto-detection picks
+# whichever interface receives the first byte, same UX as before.
+#
+# ESP_LOG going to UART is harmless in production (we ship with
+# CONFIG_LOG_DEFAULT_LEVEL_NONE=y); for dev, plug a USB-TTL onto
+# UART0 TX/RX to see logs — or re-enable the USB-JTAG console per
+# project if a given board isn't battery-boot-constrained.
+#
+# Secondary console on USB-Serial/JTAG: keeps panic dumps + bootloader
+# messages reachable via the USB monitor even though the primary
+# console is UART0. Without this, a panic is invisible to anyone
+# monitoring over USB (which is most dev boards), because the panic
+# handler writes to the primary console only. During a panic ESP-IDF
+# writes directly to the USB-JTAG hardware registers — it doesn't
+# conflict with mikrojs's driver-level USB-JTAG use for REPL traffic.
+CONFIG_ESP_CONSOLE_UART_DEFAULT=y
+CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG=n
+CONFIG_ESP_CONSOLE_SECONDARY_USB_SERIAL_JTAG=y

package/sdkconfig.defaults.esp32s3

@@ -0,0 +1,22 @@
+# ESP32-S3: route ESP-IDF stdio/ESP_LOG to UART0 rather than the
+# built-in USB Serial/JTAG. See sdkconfig.defaults.esp32c6 for the
+# reasoning (avoid ESP-IDF auto-registering the USB-JTAG VFS / stdio
+# stack at boot). mikrojs installs the USB-Serial/JTAG driver itself
+# via the public API in mik_serial_io.cpp for REPL/TLV transport.
+#
+# Secondary console on USB-Serial/JTAG so panic dumps + bootloader
+# messages still reach a dev monitor attached over USB (the primary
+# UART usually isn't wired up on dev boards). ESP-IDF writes panic
+# output directly to USB-JTAG hardware registers, which doesn't
+# conflict with mikrojs's driver-level registration for regular
+# REPL traffic.
+CONFIG_ESP_CONSOLE_UART_DEFAULT=y
+CONFIG_ESP_CONSOLE_USB_SERIAL_JTAG=n
+CONFIG_ESP_CONSOLE_SECONDARY_USB_SERIAL_JTAG=y
+
+# Enable PSRAM if present. Default mode is quad; boards with octal PSRAM
+# (e.g. XIAO ESP32-S3) must override with CONFIG_SPIRAM_MODE_OCT=y.
+# IGNORE_NOTFOUND: fall back to internal SRAM if PSRAM init fails.
+CONFIG_SPIRAM=y
+CONFIG_SPIRAM_USE_MALLOC=y
+CONFIG_SPIRAM_IGNORE_NOTFOUND=y