feat: Add ESP32-S3 ILI9341/ST7789 board support with wiring guides

.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",}

.gitignore

@@ -4,6 +4,8 @@
 .vscode/launch.json
 .vscode/extensions.json
 .vscode/ipch
+.codex_tmp
+.claude
 Bruce3_*.bin
 bruce.conf
 _*.sh
@@ -20,4 +22,4 @@ 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

@@ -30,11 +30,11 @@ the objective of 2.0 is changing the Framework to Arduino-ESP32 v3.+, to be able
 
 ### 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

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/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/_boards_json/esp-wroom32-ili9341.json

@@ -0,0 +1,42 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32_out.ld"
+    },
+    "core": "esp32",
+    "extra_flags": [
+      "-DESP_WROOM32_ILI9341",
+      "-DARDUINO_ESP32_DEV",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "40000000L",
+    "flash_mode": "dio",
+    "mcu": "esp32",
+    "variant": "pinouts"
+  },
+  "connectivity": [
+    "wifi",
+    "bluetooth",
+    "ethernet",
+    "can"
+  ],
+  "debug": {
+    "openocd_board": "esp-wroom-32.cfg"
+  },
+  "frameworks": [
+    "arduino",
+    "espidf"
+  ],
+  "name": "ESP-WROOM-32 with ILI9341 2.4 TFT",
+  "upload": {
+    "flash_size": "4MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 4194304,
+    "require_upload_port": true,
+    "speed": 460800
+  },
+  "url": "https://en.wikipedia.org/wiki/ESP32",
+  "vendor": "Espressif"
+}

boards/_boards_json/esp-wroom32-st7789.json

@@ -0,0 +1,42 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32_out.ld"
+    },
+    "core": "esp32",
+    "extra_flags": [
+      "-DESP_WROOM32_ST7789",
+      "-DARDUINO_ESP32_DEV",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "40000000L",
+    "flash_mode": "dio",
+    "mcu": "esp32",
+    "variant": "pinouts"
+  },
+  "connectivity": [
+    "wifi",
+    "bluetooth",
+    "ethernet",
+    "can"
+  ],
+  "debug": {
+    "openocd_board": "esp-wroom-32.cfg"
+  },
+  "frameworks": [
+    "arduino",
+    "espidf"
+  ],
+  "name": "ESP-WROOM-32 with ST7789 2.8 TFT Touch",
+  "upload": {
+    "flash_size": "4MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 4194304,
+    "require_upload_port": true,
+    "speed": 460800
+  },
+  "url": "https://en.wikipedia.org/wiki/ESP32",
+  "vendor": "Espressif"
+}

boards/_boards_json/esp32s3-ili9341.json

@@ -0,0 +1,52 @@
+{
+    "build": {
+      "arduino": {
+        "ldscript": "esp32s3_out.ld",
+        "partitions": "default_8MB.csv"
+      },
+      "core": "esp32",
+      "extra_flags": [
+        "-DESP32S3_ILI9341",
+        "-DARDUINO_USB_MODE=1",
+        "-DARDUINO_RUNNING_CORE=1",
+        "-DARDUINO_EVENT_RUNNING_CORE=1",
+        "-DARDUINO_USB_CDC_ON_BOOT"
+      ],
+      "f_cpu": "240000000L",
+      "f_flash": "80000000L",
+      "flash_mode": "qio",
+      "hwids": [
+        [
+          "0x303A",
+          "0x1001"
+        ]
+      ],
+      "mcu": "esp32s3",
+      "variant": "pinouts"
+    },
+    "connectivity": [
+      "bluetooth",
+      "wifi"
+    ],
+    "debug": {
+      "default_tool": "esp-builtin",
+      "onboard_tools": [
+        "esp-builtin"
+      ],
+      "openocd_target": "esp32s3.cfg"
+    },
+    "frameworks": [
+      "arduino",
+      "espidf"
+    ],
+    "name": "ESP32-S3 ILI9341 Touchscreen (8MB Flash)",
+    "upload": {
+      "flash_size": "8MB",
+      "maximum_ram_size": 327680,
+      "maximum_size": 8388608,
+      "require_upload_port": true,
+      "speed": 460800
+    },
+    "url": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html",
+    "vendor": "Espressif"
+  }

boards/_boards_json/esp32s3-st7789.json

@@ -0,0 +1,52 @@
+{
+    "build": {
+      "arduino": {
+        "ldscript": "esp32s3_out.ld",
+        "partitions": "default_8MB.csv"
+      },
+      "core": "esp32",
+      "extra_flags": [
+        "-DESP32S3_ST7789",
+        "-DARDUINO_USB_MODE=1",
+        "-DARDUINO_RUNNING_CORE=1",
+        "-DARDUINO_EVENT_RUNNING_CORE=1",
+        "-DARDUINO_USB_CDC_ON_BOOT"
+      ],
+      "f_cpu": "240000000L",
+      "f_flash": "80000000L",
+      "flash_mode": "qio",
+      "hwids": [
+        [
+          "0x303A",
+          "0x1001"
+        ]
+      ],
+      "mcu": "esp32s3",
+      "variant": "pinouts"
+    },
+    "connectivity": [
+      "bluetooth",
+      "wifi"
+    ],
+    "debug": {
+      "default_tool": "esp-builtin",
+      "onboard_tools": [
+        "esp-builtin"
+      ],
+      "openocd_target": "esp32s3.cfg"
+    },
+    "frameworks": [
+      "arduino",
+      "espidf"
+    ],
+    "name": "ESP32-S3 ST7789 Touchscreen (8MB Flash)",
+    "upload": {
+      "flash_size": "8MB",
+      "maximum_ram_size": 327680,
+      "maximum_size": 8388608,
+      "require_upload_port": true,
+      "speed": 460800
+    },
+    "url": "https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html",
+    "vendor": "Espressif"
+  }