Api js/rfid (#1987)

* Add technical overview for SRIX/ST25TB tags

This document provides a comprehensive technical overview of SRIX and ST25TB contactless RFID memory chips, detailing their features, operating conditions, memory organization, command set, and application patterns.

* SRIX Development Notes

* Ignore custom documentation directory

Add custom documentation directory to .gitignore

* Update status for T-Embed CC1101 to 'Not Tested'

* Create RFID API README with usage and details

Added a comprehensive README for the RFID JavaScript API, detailing features, usage, and implementation.

* Revise RFID API README for new features and usage

Updated RFID API documentation to reflect new features, including headless operation and enhanced JavaScript bindings.

* Enhance RFID API README with author and module status

Updated the README to include author information and credits, and modified the status of supported modules.

* Example scripts for RFID API

* Add RFID JavaScript interface functions

* Add RFID JavaScript header file

* Register RFID functions in the interpreter

* Add RFID module include to interpreter.h

* Add headless mode functionality to TagOMatic

* Add headless mode constructor and JS support methods

* Delete docs_custom directory

* Update rfid_js.h

Add new commands for JS interpreter

* Update rfid_js.cpp

New commands for RFID API JS

* Bugfix dialog_js.cpp

Bugfix for SD priority over LittleFS

* Update tag_o_matic.h for JS API

* Update tag_o_matic.cpp for RFID JS API

Added dome headless function for JS API.
Implemented in tag-o-matic to maintain standard logic

* Bugfix PN532.cpp

Bugfix to close loop while writing tag

* Bugfix RFID2.cpp

Bugfix for writing loop (same as PN532)

* Update .gitignore

* Update rfid_js.h

* Update rfid_js.cpp

added AddMifareKey function

* Update pn532_srix.cpp

* Update pn532_srix.h

* Update srix_tool.cpp

add SRIX headless, review code for PN532 i2C polling mode

* Update srix_tool.h

* Update rfid_js.h

* Update rfid_js.cpp

Author: Senape3000

lib/PN532_SRIX/pn532_srix.cpp

@@ -14,7 +14,7 @@
  *
  * @author Lilz
  * @license  GNU Lesser General Public License v3.0 (see license.txt)
- *  Refactored by Senape3000 to reuse Adafruit_PN532 constants only
+ *  Refactored by Senape3000 to reuse Adafruit_PN532 constants only (v1.2)
  *  This is a library for the communication with an I2C PN532 NFC/RFID breakout board.
  *  adapted from Adafruit's library.
  *  This library supports only I2C to communicate.
@@ -68,7 +68,7 @@ bool Arduino_PN532_SRIX::SAMConfig() {
 
 void Arduino_PN532_SRIX::readData(uint8_t *buffer, uint8_t n) {
     delay(2);
-    Wire.requestFrom((uint8_t)PN532_I2C_ADDRESS, (uint8_t)(n + 1));
+    Wire.requestFrom((uint8_t)PN532_I2C_ADDRESS, (uint8_t)(n + 2));
 
     // Discard RDY byte
     Wire.read();
@@ -83,12 +83,70 @@ void Arduino_PN532_SRIX::readData(uint8_t *buffer, uint8_t n) {
 bool Arduino_PN532_SRIX::readACK() {
     uint8_t ackBuffer[6];
     readData(ackBuffer, 6);
-    return (memcmp(ackBuffer, pn532ack, 6) == 0);
+
+#ifdef SRIX_LIB_DEBUG
+    Serial.print("[PN532] ACK Read: ");
+    for(int i=0; i<6; i++) {
+        if(ackBuffer[i] < 0x10) Serial.print("0");
+        Serial.print(ackBuffer[i], HEX);
+        Serial.print(" ");
+    }
+    Serial.println();
+#endif
+
+    bool result = (memcmp(ackBuffer, pn532ack, 6) == 0);
+    
+#ifdef SRIX_LIB_DEBUG
+    if(!result) Serial.println("[PN532] ❌ ACK Failed");
+#endif
+
+    return result;
 }
 
 bool Arduino_PN532_SRIX::isReady() {
-    if (_irq == 255) return true; // Polling mode
-    return (digitalRead(_irq) == LOW);
+    // --- POLLING MODE (No IRQ pin) ---
+    if (_irq == 255) {
+        // Request 1 byte from PN532 (Status Byte)
+        delayMicroseconds(500);
+        Wire.requestFrom((uint8_t)PN532_I2C_ADDRESS, (uint8_t)1);
+
+        // If no response or bus locked, assume not ready
+        if (!Wire.available()) {
+#ifdef SRIX_LIB_DEBUG
+            Serial.println("[PN532] isReady: No response from I2C (bus busy or chip offline)");
+#endif
+            return false;
+        }
+
+        // Read status byte
+        uint8_t status = Wire.read();
+
+#ifdef SRIX_LIB_DEBUG
+        Serial.print("[PN532] Status byte: 0x");
+        if(status < 0x10) Serial.print("0");
+        Serial.print(status, HEX);
+        Serial.print(" -> ");
+        Serial.println((status & 0x01) ? "READY" : "BUSY");
+#endif
+
+        // Check Bit 0 (LSB):
+        // 1 = Ready
+        // 0 = Busy
+        return (status & 0x01);
+    }
+
+    // --- IRQ MODE (Hardware pin) ---
+    // IRQ pin goes LOW when chip is ready
+    bool ready = (digitalRead(_irq) == LOW);
+
+#ifdef SRIX_LIB_DEBUG
+    Serial.print("[PN532] IRQ pin ");
+    Serial.print(_irq);
+    Serial.print(": ");
+    Serial.println(ready ? "LOW (Ready)" : "HIGH (Busy)");
+#endif
+
+    return ready;
 }
 
 bool Arduino_PN532_SRIX::waitReady(uint16_t timeout) {
@@ -101,7 +159,7 @@ bool Arduino_PN532_SRIX::waitReady(uint16_t timeout) {
         }
         delay(10);
     }
-
+    SRIX_LIB_LOG("Ready from waitReady");
     return true;
 }
 
@@ -113,7 +171,7 @@ void Arduino_PN532_SRIX::writeCommand(uint8_t *command, uint8_t commandLength) {
 
     Wire.beginTransmission(PN532_I2C_ADDRESS);
 
-    checksum = PN532_PREAMBLE + PN532_PREAMBLE + PN532_STARTCODE2;
+    checksum = PN532_PREAMBLE + PN532_STARTCODE1 + PN532_STARTCODE2;
     Wire.write(PN532_PREAMBLE);
     Wire.write(PN532_STARTCODE1);
     Wire.write(PN532_STARTCODE2);
@@ -135,12 +193,27 @@ void Arduino_PN532_SRIX::writeCommand(uint8_t *command, uint8_t commandLength) {
     Wire.endTransmission();
 }
 
-bool Arduino_PN532_SRIX::sendCommandCheckAck(uint8_t *command, uint8_t commandLength, uint16_t timeout) {
-    writeCommand(command, commandLength);
+bool Arduino_PN532_SRIX::sendCommandCheckAck(uint8_t *command, uint8_t commandLenght, uint16_t timeout) {
+    // default timeout of one second
+    // write the command
+    writeCommand(command, commandLenght);
+
+    // Wait for chip to say its ready!
+    if (!waitReady(timeout)) { return false; }
 
-    if (!waitReady(timeout)) return false;
+#ifdef SRIX_LIB_DEBUG
+    Serial.println(F("\nI2C IRQ received"));
+#endif
 
-    return readACK();
+    // Check acknowledgement
+    if (!readACK()) {
+#ifdef SRIX_LIB_DEBUG
+        Serial.println(F("\nNo ACK frame received!"));
+#endif
+        return false;
+    }
+
+    return true; // ACK is valid
 }
 
 // ========== PN532 GENERIC FUNCTIONS ==========
@@ -242,7 +315,11 @@ bool Arduino_PN532_SRIX::SRIX_write_block(uint8_t address, uint8_t *block) {
     _packetbuffer[5] = block[2];
     _packetbuffer[6] = block[3];
 
-    return sendCommandCheckAck(_packetbuffer, 7);
+    if (!sendCommandCheckAck(_packetbuffer, 7)) {
+        SRIX_LIB_LOG("[SRIX_LIB] Write FAIL");
+        return false; }
+    SRIX_LIB_LOG("[SRIX_LIB] Write OK");
+    return true;
 }
 
 bool Arduino_PN532_SRIX::SRIX_get_uid(uint8_t *buffer) {

lib/PN532_SRIX/pn532_srix.h

@@ -14,7 +14,7 @@
  *
  * @author Lilz
  * @license  GNU Lesser General Public License v3.0 (see license.txt)
- *  Refactored by Senape3000 to reuse Adafruit_PN532 constants only
+ *  Refactored by Senape3000 to reuse Adafruit_PN532 constants only (v1.2)
  *  This is a library for the communication with an I2C PN532 NFC/RFID breakout board.
  *  adapted from Adafruit's library.
  *  This library supports only I2C to communicate.
@@ -27,6 +27,18 @@
 #include <Arduino.h>
 #include <Wire.h>
 
+// Uncomment to enable verbose debug output on Serial
+// #define SRIX_LIB_DEBUG
+
+// Helper macro for debug
+#ifdef SRIX_LIB_DEBUG
+    #define SRIX_LIB_LOG(...) Serial.printf(__VA_ARGS__); Serial.println()
+    #define SRIX_LIB_PRINT(...) Serial.print(__VA_ARGS__)
+#else
+    #define SRIX_LIB_LOG(...) 
+    #define SRIX_LIB_PRINT(...) 
+#endif
+
 // SRIX4K-specific commands
 #define SRIX4K_INITIATE (0x06)
 #define SRIX4K_SELECT (0x0E)

src/modules/bjs_interpreter/dialog_js.cpp

@@ -106,7 +106,7 @@ JSValue native_dialogPickFile(JSContext *ctx, JSValue *this_val, int argc, JSVal
     }
     FS *fs = NULL;
     if (SD.exists(filepath)) fs = &SD;
-    if (LittleFS.exists(filepath)) fs = &LittleFS;
+    else if (LittleFS.exists(filepath)) fs = &LittleFS; // ← added 'else'
     if (fs) { r = loopSD(*fs, true, extension, filepath); }
     return JS_NewString(ctx, r.c_str());
 }
@@ -184,9 +184,9 @@ JSValue native_dialogViewFile(JSContext *ctx, JSValue *this_val, int argc, JSVal
     if (!filepath.startsWith("/")) filepath = "/" + filepath;
     FS *fs = NULL;
     if (SD.exists(filepath)) fs = &SD;
-    if (LittleFS.exists(filepath)) fs = &LittleFS;
-    if (fs) viewFile(*fs, filepath);
-    return JS_UNDEFINED;
+    else if (LittleFS.exists(filepath)) fs = &LittleFS; // ← add "else if" for SD Priority
+    if (fs) { viewFile(*fs, filepath); }
+    return 0;
 }
 
 JSValue native_dialogViewText(JSContext *ctx, JSValue *this_val, int argc, JSValue *argv) {

src/modules/bjs_interpreter/interpreter.cpp

@@ -28,6 +28,52 @@ void interpreterHandler(void *pvParameters) {
     tft.setTextSize(FM);
     tft.setTextColor(TFT_WHITE);
 
+    /// TODO: Add DUK_USE_NATIVE_STACK_CHECK check with
+    /// uxTaskGetStackHighWaterMark
+    duk_context *ctx =
+        duk_create_heap(alloc_function, realloc_function, free_function, NULL, js_fatal_error_handler);
+
+    // Init containers
+    clearDisplayModuleData();
+
+    registerConsole(ctx);
+
+    // Typescript emits: Object.defineProperty(exports, "__esModule", { value:
+    // true }); In every file, this is polyfill so typescript project can run on
+    // Bruce
+    duk_push_object(ctx);
+    duk_put_global_string(ctx, "exports");
+
+    bduk_register_c_lightfunc(ctx, "require", native_require, 1);
+    bduk_register_c_lightfunc(ctx, "assert", native_assert, 2);
+    // Deprecated
+    bduk_register_c_lightfunc(ctx, "load", native_load, 1);
+    registerGlobals(ctx);
+    registerMath(ctx);
+    registerRFID(ctx);
+    // registerAudio(ctx);
+    // registerBadUSB(ctx);
+    // TODO: BLE UART API js wrapper https://github.com/pr3y/Bruce/pull/1133
+    // registerDevice(ctx);
+    // registerDialog(ctx);
+    // registerDisplay(ctx);
+    // registerGPIO(ctx);
+    // registerI2C(ctx);
+    // registerIR(ctx);
+    // registerKeyboard(ctx);
+    // registerNotification(ctx);
+    // registerSerial(ctx);
+    // registerStorage(ctx);
+    // registerSubGHz(ctx);
+    // registerWiFi(ctx);
+
+    Serial.printf(
+        "global populated:\nPSRAM: [Free: %d, max alloc: %d],\nRAM: [Free: %d, "
+        "max alloc: %d]\n",
+        ESP.getFreePsram(),
+        ESP.getMaxAllocPsram(),
+        ESP.getFreeHeap(),
+        ESP.getMaxAllocHeap()
     bool psramAvailable = psramFound();
 
     size_t mem_size = psramAvailable ? 65536 : 32768;
@@ -148,6 +194,106 @@ bool run_bjs_script_headless(FS fs, String filename) {
     scriptName = strdup(filename.c_str() + slash + 1);
     scriptDirpath = strndup(filename.c_str(), slash);
 
+/* 2FIX: not working
+// terminate the script
+duk_ret_t native_exit(duk_context *ctx) {
+  duk_error(ctx, DUK_ERR_ERROR, "Script exited");
+  interpreter_start=false;
+  return 0;
+}
+*/
+
+duk_ret_t native_require(duk_context *ctx) {
+    duk_idx_t obj_idx = duk_push_object(ctx);
+
+    if (!duk_is_string(ctx, 0)) { return 1; }
+    String filepath = duk_to_string(ctx, 0);
+
+    if (filepath == "audio") {
+        putPropAudioFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "badusb") {
+        putPropBadUSBFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "blebeacon") {
+
+    } else if (filepath == "dialog" || filepath == "gui") {
+        putPropDialogFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "display") {
+        putPropDisplayFunctions(ctx, obj_idx, 0);
+
+    } else if (filepath == "device" || filepath == "flipper") {
+        putPropDeviceFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "gpio") {
+        putPropGPIOFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "i2c") {
+        putPropI2CFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "http") {
+        // TODO: Make the WebServer API compatible with the Node.js API
+        // The more compatible we are, the more Node.js scripts can run on Bruce
+        // MEMO: We need to implement an event loop so the WebServer can run:
+        // https://github.com/svaarala/duktape/tree/master/examples/eventloop
+
+    } else if (filepath == "ir") {
+        putPropIRFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "rfid") {
+        putPropRFIDFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "keyboard" || filepath == "input") {
+        putPropKeyboardFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "math") {
+        putPropMathFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "notification") {
+        putPropNotificationFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "serial") {
+        putPropSerialFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "storage") {
+        putPropStorageFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "subghz") {
+        putPropSubGHzFunctions(ctx, obj_idx, 0);
+    } else if (filepath == "wifi") {
+        putPropWiFiFunctions(ctx, obj_idx, 0);
+    } else {
+        FS *fs = NULL;
+        if (SD.exists(filepath)) fs = &SD;
+        else if (LittleFS.exists(filepath)) fs = &LittleFS;
+        if (fs == NULL) { return 1; }
+
+        const char *requiredScript = readBigFile(*fs, filepath);
+        if (requiredScript == NULL) { return 1; }
+
+        duk_push_string(ctx, "(function(){exports={};module={exports:exports};\n");
+        duk_push_string(ctx, requiredScript);
+        duk_push_string(ctx, "\n})");
+        duk_concat(ctx, 3);
+
+        duk_int_t pcall_rc = duk_pcompile(ctx, DUK_COMPILE_EVAL);
+        if (pcall_rc != DUK_EXEC_SUCCESS) { return 1; }
+
+        pcall_rc = duk_pcall(ctx, 1);
+        if (pcall_rc == DUK_EXEC_SUCCESS) {
+            duk_get_prop_string(ctx, -1, "exports");
+            duk_compact(ctx, -1);
+        }
+    }
+
+    return 1;
+}
+
+duk_ret_t native_assert(duk_context *ctx) {
+    if (duk_get_boolean_default(ctx, 0, false)) {
+        duk_push_boolean(ctx, true);
+        return 1;
+    }
+    return duk_error(ctx, DUK_ERR_ERROR, "Assertion failed: %s", duk_get_string_default(ctx, 1, "assert"));
+}
+
+// Deprecated
+duk_ret_t native_load(duk_context *ctx) {
+    free((char *)script);
+    free((char *)scriptDirpath);
+    free((char *)scriptName);
+    script = strdup(duk_to_string(ctx, 0));
+    scriptDirpath = NULL;
+    scriptName = NULL;
+    return 0;
     returnToMenu = true;
     interpreter_state = 1;
     startInterpreterTask();

src/modules/bjs_interpreter/interpreter.h

@@ -6,6 +6,24 @@
 
 #include <string.h>
 
+#include "audio_js.h"
+#include "badusb_js.h"
+#include "device_js.h"
+#include "dialog_js.h"
+#include "display_js.h"
+#include "globals_js.h"
+#include "gpio_js.h"
+#include "helpers_js.h"
+#include "i2c_js.h"
+#include "ir_js.h"
+#include "keyboard_js.h"
+#include "math_js.h"
+#include "notification_js.h"
+#include "rfid_js.h"
+#include "serial_js.h"
+#include "storage_js.h"
+#include "subghz_js.h"
+#include "wifi_js.h"
 extern TaskHandle_t interpreterTaskHandler;
 
 // Credits to https://github.com/justinknight93/Doolittle