@mikrojs/firmware 0.14.0 → 0.15.0-next.20260614120638

package/components/mikrojs/CMakeLists.txt

@@ -43,7 +43,7 @@ endif()
 
 idf_component_register(
     INCLUDE_DIRS "include" "${MIK_INCLUDE_DIR}"
-    REQUIRES bt littlefs esp_adc esp_app_format esp_driver_gpio esp_driver_i2c esp_driver_ledc esp_driver_rmt esp_driver_spi esp_psram esp_timer esp_http_client esp_http_server esp-tls esp_netif esp_event esp_wifi nvs_flash esp_driver_uart esp_driver_usb_serial_jtag spi_flash
+    REQUIRES bt littlefs esp_adc esp_app_format esp_driver_gpio esp_driver_i2c esp_driver_i2s esp_driver_ledc esp_driver_rmt esp_driver_spi esp_psram esp_timer esp_http_client esp_http_server esp-tls esp_netif esp_event esp_wifi nvs_flash esp_driver_uart esp_driver_usb_serial_jtag spi_flash
     SRCS
     # QuickJS engine
     ${QUICKJS_SOURCES}
@@ -84,6 +84,7 @@ idf_component_register(
     "mik_http.cpp"
     "mik_http_server.cpp"
     "mik_i2c.cpp"
+    "mik_i2s.cpp"
     "mik_logfile.cpp"
     "mik_neopixel.cpp"
     "mik_pin.cpp"
@@ -116,6 +117,10 @@ execute_process(
     OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 target_compile_definitions(${COMPONENT_LIB} PRIVATE "MIK_FW_VERSION=\"${_MIK_VERSION}\"")
+# Core runtime owns the bare `native:mikro/*` namespace. MIK_PACKAGE_NAME makes
+# MIK_REGISTER_MODULE enforce that every native module here is named
+# "native:mikro/<module>"; driver/board packages set their own package name.
+target_compile_definitions(${COMPONENT_LIB} PRIVATE "MIK_PACKAGE_NAME=\"mikro\"")
 # The version is read at configure time, so configure must re-run when the
 # firmware package version changes — otherwise an incremental idf.py build
 # flashes a binary that still reports the stale MIK_FW_VERSION.
@@ -138,8 +143,8 @@ endif()
 include("${MIK_BYTECODE_CMAKE}")
 
 # Force linker to include self-registering native modules
-set(_MIK_MODULES cbor pin i2c spi http http_server wifi rtc nvs_kv sntp sleep neopixel pwm uart)
-set(_MIK_BYTECODE_MODULES abort cbor env result schema fs http/helpers http/request http/server i2c kv/nvs kv/rtc kv/shared module neopixel observable observable/lazy observable/operators pin pwm reader sleep spi sntp stdio stream sys test uart udp wifi)
+set(_MIK_MODULES cbor pin i2c i2s spi http http_server wifi rtc nvs_kv sntp sleep neopixel pwm uart)
+set(_MIK_BYTECODE_MODULES abort cbor env result schema fs http/helpers http/request http/server i2c i2s kv/nvs kv/rtc kv/shared module neopixel observable observable/lazy observable/operators pin pwm reader sleep spi sntp stdio stream sys test uart udp wifi)
 if(CONFIG_BT_ENABLED)
     list(APPEND _MIK_MODULES ble)
     list(APPEND _MIK_BYTECODE_MODULES ble)

package/components/mikrojs/mik_ble.cpp

@@ -57,7 +57,7 @@ static inline MIKBleState*& mik__ble_st(MIKRuntime* rt) {
     return reinterpret_cast<MIKBleState*&>(rt->module_data[mik__ble_slot]);
 }
 
-#define MIK_BLE_TAG "native:ble"
+#define MIK_BLE_TAG "native:mikro/ble"
 
 /* Max advertising payload (31 bytes) minus mandatory flags overhead (3 bytes). */
 #define MIK_BLE_NAME_MAX_LEN 29
@@ -1492,7 +1492,7 @@ static JSModuleDef* mik__ble_init(JSContext* ctx) {
         CHECK_NOT_NULL(s_ble_event_queue);
     }
 
-    JSModuleDef* m = JS_NewCModule(ctx, "native:ble", mik__ble_module_init);
+    JSModuleDef* m = JS_NewCModule(ctx, "native:mikro/ble", mik__ble_module_init);
     if (!m) return nullptr;
     JS_AddModuleExport(ctx, m, "Ble");
     return m;
@@ -1585,4 +1585,4 @@ void mik__ble_destroy(JSContext* ctx) {
     mik__ble_st(mik_rt) = nullptr;
 }
 
-MIK_REGISTER_MODULE(ble, "native:ble", mik__ble_init, mik__ble_consume, mik__ble_destroy)
+MIK_REGISTER_MODULE(ble, "native:mikro/ble", mik__ble_init, mik__ble_consume, mik__ble_destroy)

package/components/mikrojs/mik_http.cpp

@@ -23,7 +23,7 @@ static inline MIKHttpState*& mik__http_st(MIKRuntime* rt) {
     return reinterpret_cast<MIKHttpState*&>(rt->module_data[mik__http_slot]);
 }
 
-#define MIK_HTTP_TAG "native:http"
+#define MIK_HTTP_TAG "native:mikro/http"
 /* 8 KB was tight for HTTPS — mbedTLS handshake + request header buffer can
  * spike the task stack; the ESP-HTTP-client header list was corrupted once
  * the stack overran. 12 KB matches the recommendation for esp-tls users. */
@@ -808,7 +808,7 @@ static JSModuleDef* mik__http_init(JSContext* ctx) {
     MIKRuntime* mik_rt = MIK_GetRuntime(ctx);
     mik__http_slot = MIK_AllocModuleSlot(mik_rt);
 
-    JSModuleDef* m = JS_NewCModule(ctx, "native:http", mik__http_module_init);
+    JSModuleDef* m = JS_NewCModule(ctx, "native:mikro/http", mik__http_module_init);
     if (!m) return nullptr;
     JS_AddModuleExport(ctx, m, "request");
     JS_AddModuleExport(ctx, m, "nextMessage");
@@ -976,4 +976,4 @@ void mik__http_destroy(JSContext* ctx) {
     mik__http_st(mik_rt) = nullptr;
 }
 
-MIK_REGISTER_MODULE(http, "native:http", mik__http_init, mik__http_consume, mik__http_destroy)
+MIK_REGISTER_MODULE(http, "native:mikro/http", mik__http_init, mik__http_consume, mik__http_destroy)

package/components/mikrojs/mik_http_server.cpp

@@ -9,7 +9,7 @@
 #include "private.h"
 #include "utils.h"
 
-/* native:http_server — an HTTP server backed by ESP-IDF's esp_http_server.
+/* native:mikro/http_server — an HTTP server backed by ESP-IDF's esp_http_server.
  *
  * esp_http_server runs request handlers on its own (single) task; QuickJS is
  * single-threaded, so the JS handler must run on the event-loop task. This is
@@ -32,7 +32,7 @@
  * lookups via getHeader(), reading the parked request directly. The httpd task
  * is blocked waiting for the response, so there is no concurrent writer. */
 
-#define MIK_HS_TAG "native:http_server"
+#define MIK_HS_TAG "native:mikro/http_server"
 #define MIK_HS_DEFAULT_MAX_BODY 16384
 /* How often the parked handler wakes to check for server shutdown. */
 #define MIK_HS_ABORT_POLL_MS 250
@@ -674,7 +674,7 @@ static JSModuleDef* mik__http_server_init(JSContext* ctx) {
     MIKRuntime* rt = MIK_GetRuntime(ctx);
     mik__http_server_slot = MIK_AllocModuleSlot(rt);
 
-    JSModuleDef* m = JS_NewCModule(ctx, "native:http_server", mik__hs_module_init);
+    JSModuleDef* m = JS_NewCModule(ctx, "native:mikro/http_server", mik__hs_module_init);
     if (!m) return nullptr;
     JS_AddModuleExport(ctx, m, "start");
     JS_AddModuleExport(ctx, m, "stop");
@@ -786,5 +786,5 @@ void mik__http_server_destroy(JSContext* ctx) {
     mik__hs_st(rt) = nullptr;
 }
 
-MIK_REGISTER_MODULE(http_server, "native:http_server", mik__http_server_init,
+MIK_REGISTER_MODULE(http_server, "native:mikro/http_server", mik__http_server_init,
                     mik__http_server_consume, mik__http_server_destroy)

package/components/mikrojs/mik_i2c.cpp

@@ -4,7 +4,7 @@
 #include "mikrojs/private.h"
 #include "mikrojs/utils.h"
 
-#define MIK_I2C_TAG "native:i2c"
+#define MIK_I2C_TAG "native:mikro/i2c"
 #define MIK_I2C_DEFAULT_FREQ 100000
 #define MIK_I2C_DEFAULT_TIMEOUT_MS 100
 #define MIK_I2C_SCAN_START 0x08
@@ -198,10 +198,12 @@ static JSValue js_i2c_write(JSContext* ctx, JSValue this_val, int argc, JSValue*
     uint8_t* data;
 
     /* Try typed array (Uint8Array) first, then raw ArrayBuffer */
-    size_t offset, elem_size;
+    size_t offset, elem_size, buf_len;
     JSValue ab = JS_GetTypedArrayBuffer(ctx, argv[1], &offset, &data_len, &elem_size);
     if (!JS_IsException(ab)) {
-        data = JS_GetArrayBuffer(ctx, &data_len, ab);
+        /* data_len keeps the view length; the full backing buffer goes to a
+         * throwaway so a subarray view isn't over-read. */
+        data = JS_GetArrayBuffer(ctx, &buf_len, ab);
         JS_FreeValue(ctx, ab);
         if (!data) return JS_ThrowTypeError(ctx, "expected Uint8Array as argument 2");
         data += offset;
@@ -355,10 +357,10 @@ static JSModuleDef* mik__i2c_init(JSContext* ctx) {
     JS_SetClassProto(ctx, mik_i2c_class_id, proto);  /* consumed */
 
     /* Register module */
-    JSModuleDef* m = JS_NewCModule(ctx, "native:i2c", mik__i2c_module_init);
+    JSModuleDef* m = JS_NewCModule(ctx, "native:mikro/i2c", mik__i2c_module_init);
     if (!m) return nullptr;
     JS_AddModuleExport(ctx, m, "I2c");
     return m;
 }
 
-MIK_REGISTER_MODULE(i2c, "native:i2c", mik__i2c_init, nullptr, nullptr)
+MIK_REGISTER_MODULE(i2c, "native:mikro/i2c", mik__i2c_init, nullptr, nullptr)