/**
 * @brief Конфигурирует IO Pad как General Purpose IO,
 *        так что его можно подключить к внутренней Matrix,
 *        когда происходит комбинация с одним или несколькими
 *        сигналами периферийных устройств.
 *
 * @param iopad_num Номер ножки порта (IO Pad number)
 */
void esp_rom_gpio_pad_select_gpio(uint32_t iopad_num);

/**
 * @brief Разрешит внутренный pull up и запретит внутренний pull down.
 *
 * @param iopad_num Номер ножки порта (IO Pad number)
 */
void esp_rom_gpio_pad_pullup_only(uint32_t iopad_num);

/**
 * @brief Отменит состояние удержания (hold) для IO Pad.
 * @note Когда Pad установлен на hold, его состояние защелкивается
 *       в этот момент, и не может быть впоследствии изменено.
 *       Функция esp_rom_gpio_pad_unhold снимает эту блокировку.
 *
 * @param iopad_num Номер ножки порта (IO Pad number)
 */
void esp_rom_gpio_pad_unhold(uint32_t gpio_num);

/**
 * @brief Установит нагрузочную способность IO Pad.
 *
 * @param iopad_num Номер ножки порта (IO Pad number).
 * @param drv Числовой код нагрузочной способности выхода.
 *      - 0: 5mA
 *      - 1: 10mA
 *      - 2: 20mA
 *      - 3: 40mA
 */
void esp_rom_gpio_pad_set_drv(uint32_t iopad_num, uint32_t drv);

/**
 * @brief Привязка входа GPIO к сигналу периферийного устройства, который
 *        помечен атрибутом входа.
 *
 * @note Нет ограничений на количество сигналов, которые могут быть
 *       скомбинированы (подключены к) на GPIO.
 *
 * @param gpio_num Номер ножки порта GPIO. В этом параметре могут использоваться
 *                 специальные значения для входных сигналов периферифного устройства:
 *   GPIO_MATRIX_CONST_ZERO_INPUT означает подачу лог. 0 в качестве входного сигнала
 *   GPIO_MATRIX_CONST_ONE_INPUT означает подачу лог. 1 в качестве входного сигнала.
 * @param signal_idx Индекс сигнала периферийного устройства (помеченного атрибутом
 *                   входа). В качестве этого параметра обычно используют макрос
 *                   имяперифустройства_PERIPH_SIGNAL(IDX, PIN), например для UART
 *                   это макрос UART_PERIPH_SIGNAL(IDX, PIN).
 * @param inv  Нужно ли инвертировать сигнал входа GPIO.
 */
void esp_rom_gpio_connect_in_signal(uint32_t gpio_num, uint32_t signal_idx, bool inv);

/**
 * @brief Привязка выхода GPIO к сигналу периферийного устройства, который
 *        помечен атрибутом выхода.
 *
 * @note Нет ограничений на количество сигналов, которые могут быть
 *       скомбинированы (подключены к) на GPIO.
 * @note Внутри микроконтроллера сначала будет подключен сигнал, и потом
 *       на выводе GPIO будет разрешен выход.
 *
 * @param gpio_num Номер ножки порта GPIO.
 * @param signal_idx Индекс сигнала периферийного устройства (помеченного атрибутом
 *                   выхода). В частности SIG_GPIO_OUT_IDX означает отключение GPIO
 *                   и других периферийных устройств. Только драйвер GPIO может
 *                   управлять выходным уровнем.
 * @param out_inv Должен ли быть инвертирован сигнал выхода.
 * @param oen_inv Должен ли быть инвертирован сигнал управления разрешения выхода.
 */
void esp_rom_gpio_connect_out_signal(uint32_t gpio_num, uint32_t signal_idx,
                                     bool out_inv, bool oen_inv);

#include "esp_rom_gpio.h"
#include "driver/spi_master.h"
#include "soc/gpio_sig_map.h" // Для получения signal_idx

// Допустим, мы хотим объединить MISO и MOSI на одном выводе (GPIO_NUM_13)
// для работы с устройством, поддерживающим 3-проводной режим.
void setup_spi_3wire_mode(spi_host_device_t host) {
    // 1. Настроим MOSI (GPIO_NUM_13) стандартным образом через драйвер SPI.
    // ... (обычная инициализация SPI)

    // 2. Определим индекс выходного сигнала для MOSI данного хоста SPI.
    //    Например, для SPI2_HOST сигнал может называться FSPID_OUT_IDX.
    //    Конкретное имя нужно искать в soc/gpio_sig_map.h.
    int mosi_signal_idx = FSPID_OUT_IDX; // Это пример!

    // 3. Подключим этот же сигнал MOSI к выводу порта MISO (например, GPIO_NUM_12).
    //    Теперь данные на передачу будут появляться и на выводе MISO.
    esp_rom_gpio_connect_out_signal(GPIO_NUM_12, mosi_signal_idx, false, false);

    // Важно: Пин GPIO_NUM_12 теперь управляется SPI. Не используйте для него gpio_set_level.
}

void disable_spi_3wire_mode(void) {
    // Чтобы "отключить" MISO вывод от SPI и вернуть его в управление GPIO:
    esp_rom_gpio_connect_out_signal(GPIO_NUM_12, SIG_GPIO_OUT_IDX, false, false);
    // Теперь уровнем на GPIO_NUM_12 можно снова управлять через gpio_set_level.
}