Improve BLE Spam module

.github/workflows/buil_parallel.yml

@@ -77,6 +77,7 @@ jobs:
           - { env: "lilygo-t-lora-pager",             family: "ESP32-S3",}
           - { env: "elecrow-24B",                     family: "ESP32",}
           - { env: "elecrow-28B",                     family: "ESP32",}
+          - { env: "elecrow-advance-35-s3",           family: "ESP32-S3",}
           - { env: "smoochiee-board",                 family: "ESP32-S3",}
           - { env: "reaper",                          family: "ESP32-S3",}
           - { env: "Phantom_S024R",                   family: "ESP32",}
@@ -147,6 +148,7 @@ jobs:
 
           if [[ "${{ github.ref_type }}" == "tag" ]]; then
             version=${{ github.ref_name }}
+            sed -i "s/-D ENABLE_RAM_LOGGING=1/;-D ENABLE_RAM_LOGGING=1'\"$version\"' ; /g" ./platformio.ini
           else
             version="${GITHUB_SHA::7}"
           fi

.gitignore

@@ -4,6 +4,8 @@
 .vscode/launch.json
 .vscode/extensions.json
 .vscode/ipch
+.codex_tmp
+.claude
 Bruce3_*.bin
 bruce.conf
 _*.sh
@@ -16,8 +18,9 @@ checksum.sha256
 .vscode/extensions.json
 mqjs_build
 docker-logs
+compile_commands.json
 lib/mquickjs_headers/mqjs_stdlib_generator
 lib/mquickjs_headers/mqjs_stdlib_generator.exe
 .github/agents/Bruce-AI.agent.md
 .idea
-.ai
+.ai

2.0_road_path.md

@@ -11,9 +11,9 @@ the objective of 2.0 is changing the Framework to Arduino-ESP32 v3.+, to be able
 - [x] Availability to program to ESP32-C5 (5ghz wifi chip)
 
 ## Things to change on 2.0
-- [] InputHadler common codes, defined within #defines structures, not programmin functions to each device
+- [] InputHadler common codes, defined within #defines structures, not programing functions to each device
 - [] PPM and FuelGauge common functions
-- [] Add a MiddleClass for TFT, where more libraries can be used (ArduinoGFX and Lovyan_GFX)
+- [x] Add a MiddleClass for TFT, where more libraries can be used (ArduinoGFX and Lovyan_GFX)
 
 
 ## Things to add on 2.0
@@ -25,19 +25,22 @@ the objective of 2.0 is changing the Framework to Arduino-ESP32 v3.+, to be able
  - [] Session hijacking
 
 ### RFID
- - [] Emulation on PN532
- - [] using Lora Pager RFID Chip (read/write/emulate)
+ - [x] Emulation on PN532
+ - [x] using Lora Pager RFID Chip (read/write/emulate)
 
 ### RF
  - [] Rolljam
- - Decode/Encode Protocols
+ - [x] Decode/Encode Protocols
 
 ### NRF24
- - [] mouse jacking
- - [] keyboard jacking
+ - [x] mouse jacking
+ - [x] keyboard jacking
 
 ### Interpreter
-- Possibility to access I2C, SPI, UART buses
+Possibility to access I2C, SPI, UART buses
+ - [x] I2C interface
+ - [] SPI Interface
+ - [] UART interface
 
 ### FM
  - Remove and move it into a JS code

THIRD_PARTY.md

@@ -0,0 +1,100 @@
+# Third-party code and attribution
+
+Bruce is licensed under the **GNU Affero General Public License v3.0 or later**
+(AGPL-3.0-or-later); see [`LICENSE`](LICENSE).
+
+Parts of Bruce's RF / sub-GHz module (`src/modules/rf/`) are **derived from**
+other free-software projects. Those portions were modified to fit Bruce's native
+RMT engine, data model and UI, but remain the work of their original authors and
+are used under their respective licenses. Each affected source file carries a
+header pointing back to this document.
+
+> This file documents attribution for copyleft compliance. It is not legal
+> advice; if you redistribute Bruce, review these obligations yourself.
+
+## Sub-GHz protocols / KeeLoq
+
+### Flipper Zero firmware — GPL-3.0-or-later
+- Upstream: <https://github.com/flipperdevices/flipperzero-firmware>
+- License: GNU General Public License v3.0
+- Copyright (C) Flipper Devices Inc. and the flipperzero-firmware contributors.
+- Used by: the KeeLoq block cipher, the manufacturer "learning" key-derivation
+  schemes, the KeeLoq frame decoder/encoder framing, the `.sub` keystore format
+  and protocol identities.
+  Files: `src/modules/rf/protocols/rf_keeloq.{h,cpp}`,
+  `src/modules/rf/protocols/rf_decoder.{h,cpp}`,
+  `src/modules/rf/protocols/rf_encoder.{h,cpp}`.
+
+### Momentum firmware — GPL-3.0-or-later
+- Upstream: <https://github.com/Next-Flip/Momentum-Firmware>
+- License: GNU General Public License v3.0
+- Copyright (C) the Momentum Firmware contributors.
+- Used by: the extended KeeLoq manufacturer list and the model for the
+  encrypted built-in keystore (`keeloq_mfcodes`), which Bruce mirrors by
+  shipping an AES-encrypted keystore decrypted at runtime as a fallback.
+  Files: `src/modules/rf/protocols/rf_keeloq.cpp`,
+  `src/modules/rf/protocols/rf_keeloq_mfcodes_data.h` (generated),
+  `tools/gen_mfcodes.py`.
+
+> Note: the KeeLoq manufacturer keys themselves originate from the respective
+> device manufacturers. They are proprietary key material; their redistribution
+> is a separate concern from the GPL attribution above and is the redistributor's
+> responsibility to evaluate.
+
+### rc-switch (RCSwitch) — LGPL-2.1-or-later
+- Upstream: <https://github.com/sui77/rc-switch>
+- License: GNU Lesser General Public License v2.1
+- Copyright (C) 2011 Suat Özgür and the rc-switch contributors.
+- Used by: the classic OOK protocol timing table (the numbered `RcSwitch_N`
+  protocols and the factor-based `{high,low}×te` model) and the
+  capture/decode and send state machines that Bruce re-implemented over its
+  native RMT engine.
+  Files: `src/modules/rf/protocols/rf_registry.{h,cpp}`,
+  `src/modules/rf/protocols/rf_decoder.{h,cpp}`,
+  `src/modules/rf/protocols/rf_encoder.{h,cpp}`.
+
+## NFC / RFID (ST25R3916)
+
+The ST25R3916 NFC front-end driver (`src/modules/rfid/ST25R3916.{h,cpp}`) is a
+native re-implementation over a fork of ST's RFAL stack, but several parts —
+particularly the card-emulation (listen / passive-target) path — were **derived
+from** the Momentum firmware, itself a fork of the Flipper Zero firmware. Those
+portions were rewritten to drive the ST25R3916 register interface directly
+(the RFAL fork's high-level `rfalListenStart` is a stub), but the register
+sequences and protocol state machines follow the upstream NFC HAL/stack.
+
+### Momentum firmware (Flipper Zero NFC stack) — GPL-3.0-or-later
+- Upstream: <https://github.com/Next-Flip/Momentum-Firmware>
+- Based on: <https://github.com/flipperdevices/flipperzero-firmware>
+- License: GNU General Public License v3.0
+- Copyright (C) the Momentum Firmware and flipperzero-firmware contributors.
+- Used by:
+  - The NFC-A listen / passive-target register configuration (MODE.targ +
+    `om_targ_nfca`, PT memory load of UID/ATQA/SAK, OP_CONTROL / PASSIVE_TARGET
+    / MASK_RX_TIMER setup and the target-mode IRQ mask), which follows the
+    Flipper `furi_hal_nfc` sequence on the same ST25R chip family.
+  - The MIFARE Classic listener-side Crypto1 emulation: authentication
+    handshake, manual-parity TX/RX handling and the encrypted READ/WRITE
+    service from the loaded dump.
+  - The MIFARE Ultralight / NTAG21x listener command handling — `GET_VERSION`,
+    `READ_SIG` (ECC signature), `READ_CNT`, `PWD_AUTH`/`PACK` and the amiibo
+    (NTAG215, UID-derived password, `80 80` PACK) behaviour.
+  - The FeliCa (NFC-F) and Type 4 Tag (ISO-DEP / NDEF) emulation responders.
+  Files: `src/modules/rfid/ST25R3916.cpp`.
+
+### Crypto1 cipher (Crapto1 / Proxmark lineage) — public reimplementation
+- References: "Dismantling MIFARE Classic" (Garcia et al., 2008) and the public
+  Crapto1 reference; the same algorithm is used by the Flipper / Momentum and
+  Proxmark NFC stacks.
+- Used by: the compact Crypto1 stream cipher that backs both reader-side
+  MIFARE Classic auth/read/write and the listener-side emulation, since the
+  RFAL fork has no native Crypto1 support.
+  Files: `src/modules/rfid/crypto1.{h,cpp}`.
+
+## Bundled libraries (linked dependencies)
+
+Fetched via PlatformIO `lib_deps` (see `platformio.ini`); each keeps its own
+license. Notably the CC1101 radio driver:
+
+- **SmartRC-CC1101-Driver-Lib** (ELECHOUSE driver fork) —
+  <https://github.com/bmorcelli/SmartRC-CC1101-Driver-Lib>

boards/CYD-2432S028/CYD-2432S028.ini

@@ -446,8 +446,8 @@ build_flags =
 	-DHAS_CAPACITIVE_TOUCH=1
 	-DTOUCH_GT911_I2C=1
 	-DGT911_SLAVE_ADDRESS_L=0x5D
-    -DGT911_I2C_CONFIG_SDA_IO_NUM=33
-    -DGT911_I2C_CONFIG_SCL_IO_NUM=32
+    -D SYS_I2C_SDA=33
+    -D SYS_I2C_SCL=32
     -DGT911_TOUCH_CONFIG_INT_GPIO_NUM=25
     -DGT911_TOUCH_CONFIG_RST_GPIO_NUM=21
 	-DBOARD_TOUCH_INT=25

boards/CYD-2432S028/interface.cpp

@@ -1,3 +1,4 @@
+#include "core/bus_HAL.h"
 #include "core/powerSave.h"
 #include "core/utils.h"
 #include <Arduino.h>
@@ -43,10 +44,21 @@ void _setup_gpio() {
     digitalWrite(XPT2046_CS, HIGH);
 #endif
 
+#if defined(HAS_CAPACITIVE_TOUCH)
+    setSysI2CBus(&Wire1);
+#if defined(TOUCH_GT911_I2C)
+    bruceConfigPins.sys_i2c.sda = (gpio_num_t)SYS_I2C_SDA;
+    bruceConfigPins.sys_i2c.scl = (gpio_num_t)SYS_I2C_SCL;
+#else
+    bruceConfigPins.sys_i2c.sda = (gpio_num_t)CYD28_TouchC_SDA;
+    bruceConfigPins.sys_i2c.scl = (gpio_num_t)CYD28_TouchC_SCL;
+#endif
+#endif
+
 #if defined(TOUCH_GT911_I2C)
     pinMode(BOARD_TOUCH_INT, INPUT);
     touch.setPins(-1, BOARD_TOUCH_INT);
-    if (!touch.begin(Wire, GT911_SLAVE_ADDRESS_L, GT911_I2C_CONFIG_SDA_IO_NUM, GT911_I2C_CONFIG_SCL_IO_NUM)) {
+    if (!touch.begin(Wire1, GT911_SLAVE_ADDRESS_L, SYS_I2C_SDA, SYS_I2C_SCL)) {
         Serial.println("Failed to find GT911 - check your wiring!");
     }
 #else

boards/ES3C28P/interface.cpp

@@ -13,6 +13,7 @@
  *   - BOOT button (GPIO0)
  */
 
+#include "core/bus_HAL.h"
 #include "core/powerSave.h"
 #include "core/utils.h"
 #include <Arduino.h>
@@ -103,6 +104,7 @@ void _setup_gpio() {
     pinMode(ES3C28P_TOUCH_INT, INPUT);
 
     // Initialize I2C bus (shared with audio codec ES8311)
+    setSysI2CBus(&Wire);
     Wire.begin(ES3C28P_TOUCH_SDA, ES3C28P_TOUCH_SCL);
     touchInitialized = true;
 

boards/ES3C28P/pins_arduino.h

@@ -26,6 +26,8 @@ static const uint8_t RX = 44;
 // =============================================
 #define GROVE_SDA 16
 #define GROVE_SCL 15
+#define SYS_I2C_SDA GROVE_SDA
+#define SYS_I2C_SCL GROVE_SCL
 static const uint8_t SDA = GROVE_SDA;
 static const uint8_t SCL = GROVE_SCL;
 

boards/ESP32-C5-tft/interface.cpp

@@ -167,8 +167,12 @@ void InputHandler(void) {
     if (anyPressed && wakeUpScreen()) return;
 
     AnyKeyPress = anyPressed;
+    if (upPressed && dwPressed) {
+        EscPress = true;
+        return;
+    }
     PrevPress = upPressed;
-    EscPress = upPressed && dwPressed;
+
     NextPress = dwPressed;
     SelPress = selPressed;
 #endif

boards/arduino-nesso-n1/interface.cpp

@@ -1,3 +1,4 @@
+#include "core/bus_HAL.h"
 #include "core/powerSave.h"
 #include "core/utils.h"
 #include <M5Unified.h>
@@ -13,6 +14,9 @@ constexpr uint32_t kBtnBLongPressMs = 500;
 ***************************************************************************************/
 void _setup_gpio() {
     M5.begin(); // Need to test if SDCard inits with the new setup
+    // ESP32-C6 only has one general-purpose I2C controller (SOC_HP_I2C_NUM == 1), so
+    // I2C_NUM_1 doesn't exist in i2c_port_t here and M5.In_I2C is always on Wire/I2C_NUM_0.
+    setSysI2CBus(&Wire);
     bruceConfig.colorInverted = 0;
     M5.BtnA.setDebounceThresh(8);
     M5.BtnB.setDebounceThresh(8);
@@ -47,7 +51,9 @@ void InputHandler(void) {
     static bool btnBWaitingSecondClick = false;
     static bool btnBLongPressFired = false;
     if (millis() - tm < 200 && !LongPress) return;
+    if (!trylockSysI2CBus()) return; // RFID driver mid-transaction - retry next tick
     M5.update();
+    unlockSysI2CBus();
 
     bool emitNext = false;
     bool emitPrev = false;

boards/arduino-nesso-n1/platformio.ini

@@ -44,6 +44,8 @@ build_flags =
 	;Default I2C port
 	-D GROVE_SDA=5
 	-D GROVE_SCL=4
+	-D SYS_I2C_SDA=10
+	-D SYS_I2C_SCL=8
 
 	;Features Enabled
 	;-DLITE_VERSION=1 ;limits some features to save space for M5Launcher Compatibility