introduce NRF and BLE drivers

core/SConscript.firmware

@@ -38,7 +38,7 @@ FEATURE_FLAGS = {
     "AES_GCM": BENCHMARK or THP,
 }
 
-FEATURES_WANTED = ["input", "sd_card", "rgb_led", "dma2d", "consumption_mask", "usb" ,"optiga", "haptic"]
+FEATURES_WANTED = ["input", "sd_card", "rgb_led", "dma2d", "consumption_mask", "usb" ,"optiga", "haptic", "ble"]
 if DISABLE_OPTIGA:
     if PYOPT != '0':
         raise RuntimeError("DISABLE_OPTIGA requires PYOPT=0")

core/SConscript.kernel

@@ -30,7 +30,7 @@ FEATURE_FLAGS = {
     "AES_GCM": False,
 }
 
-FEATURES_WANTED = ["input", "sd_card", "rgb_led", "dma2d", "consumption_mask", "usb" ,"optiga", "haptic"]
+FEATURES_WANTED = ["input", "sd_card", "rgb_led", "dma2d", "consumption_mask", "usb" ,"optiga", "haptic", "ble"]
 if DISABLE_OPTIGA:
     # TODO use PYOPT instead of PRODUCTION, same as in firmware, blocked on #4253
     if PRODUCTION:

core/embed/io/ble/inc/io/ble.h

@@ -0,0 +1,128 @@
+/*
+ * This file is part of the Trezor project, https://trezor.io/
+ *
+ * Copyright (c) SatoshiLabs
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef TREZORHAL_BLE_H
+#define TREZORHAL_BLE_H
+
+// This module provides interface to BLE (Bluetooth Low Energy) functionality.
+// It allows the device to advertise itself, connect to other devices, and
+// exchange data over BLE.
+
+#include <trezor_types.h>
+
+#define BLE_RX_PACKET_SIZE 244
+#define BLE_TX_PACKET_SIZE 64
+
+typedef enum {
+  BLE_SWITCH_OFF = 0,      // Turn off BLE advertising, disconnect
+  BLE_SWITCH_ON = 1,       // Turn on BLE advertising
+  BLE_PAIRING_MODE = 2,    // Enter pairing mode
+  BLE_DISCONNECT = 3,      // Disconnect from the connected device
+  BLE_ERASE_BONDS = 4,     // Erase all bonding information
+  BLE_ALLOW_PAIRING = 5,   // Accept pairing request
+  BLE_REJECT_PAIRING = 6,  // Reject pairing request
+} ble_command_t;
+
+typedef enum {
+  BLE_NONE = 0,               // No event
+  BLE_CONNECTED = 1,          // Connected to a device
+  BLE_DISCONNECTED = 2,       // Disconnected from a device
+  BLE_PAIRING_REQUEST = 3,    // Pairing request received
+  BLE_PAIRING_CANCELLED = 4,  // Pairing was cancelled by host
+} ble_event_type_t;
+
+typedef struct {
+  ble_event_type_t type;
+  int connection_id;
+  uint8_t data_len;
+  uint8_t data[6];
+} ble_event_t;
+
+typedef struct {
+  bool connected;
+  bool connectable;
+  bool pairing;
+  bool pairing_requested;
+  uint8_t peer_count;
+} ble_state_t;
+
+// Initializes the BLE module
+//
+// Sets up the BLE hardware and software resources,
+// preparing the module for operation.
+// The function has no effect if the module was already initialized.
+bool ble_init(void);
+
+// Deinitializes the BLE module
+//
+// Releases resources allocated during initialization
+// and shuts down the BLE module.
+void ble_deinit(void);
+
+// Starts BLE operations
+//
+// Enables reception of messages over BLE
+void ble_start(void);
+
+// Stops BLE operations
+//
+// Disables reception of messages over BLE
+// Flushes any queued messages
+void ble_stop(void);
+
+// Issues a command to the BLE module
+//
+// Sends a specific command to the BLE module for execution.
+//
+// Returns `true` if the command was successfully issued.
+bool ble_issue_command(ble_command_t command);
+
+// Reads an event from the BLE module
+//
+// Retrieves the next event from the BLE module's event queue.
+//
+// Returns `true` if an event was successfully read, `false` if no event is
+// available.
+bool ble_get_event(ble_event_t *event);
+
+// Retrieves the current state of the BLE module
+//
+// Obtains the current operational state of the BLE module.
+void ble_get_state(ble_state_t *state);
+
+// Check if write is possible
+bool ble_can_write(void);
+
+// Writes data to a connected BLE device
+//
+// Sends data over an established BLE connection.
+bool ble_write(const uint8_t *data, uint16_t len);
+
+// Check if read is possible
+bool ble_can_read(void);
+
+// Reads data from a connected BLE device
+//
+// max_len indicates the maximum number of bytes to read. Rest of the data
+// will be discarded.
+//
+// Returns the number of bytes actually read.
+uint32_t ble_read(uint8_t *data, uint16_t max_len);
+
+#endif