updates the SPI Bus and also adds another user module

After I have been looking at the code in micropython I decided that it's SPI implementation was going to cause problems is used in conjunction with the SPIBus driver. This would make it impossible to use an SPI based touch driver IC.

MicroPythons implementation of SPI combined the bus and the device into a single class. It would error if the bus was already initialized and that would lead to no way od being able to attach a touch driver using the same bus. This design is simply not going to work at all so I wrote a new SPI driver for the ESP32. It supports dual, quad and octal modes, all the hardware pins and hosts and the biggest thing is it's not going to pitch a fit if the bus has already been initialized. the module is `spi` and I split the bus and device portions apart so you have `spi.SPI` for the SPI bus and you have `spi.Device` for a device. So you only need to create a single `spi.SPI` instance and then for each device you have attached you create an `spi.Device` instance.

Last big improvement of the SPI is it is no longer blocking. It utilizes DMA memory transfers and callbacks to let you know when it has finished transmitting and receiving. You use the device instance to do the sending and receiving and registering the callbacks.

I am going to add stub files for the new SPI module as soon as I know everything is compiling properly with this.

Author: kdschlosser

README.md

@@ -637,3 +637,9 @@ the calibration by either using a pin that you can check the state of or through
 a button in your UI that you provide to the user.
 
 Thank again and enjoy!!
+
+***NOTE***: On ESP32-S3, SPI host 0 and SPI host 1 share a common SPI bus. 
+The main Flash and PSRAM are connected to the host 0. It is recommended to use 
+SPI host 2 when connecting an SPI device like a display that is going to utilize
+the PSRAM for the frame buffer.
+

ext_mod/esp32_additions/micropython.cmake

@@ -0,0 +1,7 @@
+
+FILE(GLOB SUBDIRS ABSOLUTE ${CMAKE_CURRENT_LIST_DIR} ${CMAKE_CURRENT_LIST_DIR}/*)
+FOREACH(SUBDIR ${SUBDIRS})
+    IF(IS_DIRECTORY ${SUBDIR})
+        include(${SUBDIR}/micropython.cmake)
+    ENDIF()
+ENDFOREACH()

ext_mod/expanded_nvs_esp32/include/nvs.h renamed to ext_mod/esp32_additions/nsv/include/nvs.h

@@ -0,0 +1,26 @@
+# Create an INTERFACE library for our C module.
+
+
+add_library(usermod_nvs INTERFACE)
+
+set(NVS_INCLUDES)
+set(NVS_SOURCES ${CMAKE_CURRENT_LIST_DIR}/src/nvs.c)
+
+# gets nvs_flash include paths
+idf_component_get_property(NVS_FLASH_INCLUDES nvs_flash INCLUDE_DIRS)
+idf_component_get_property(NVS_FLASH_DIR nvs_flash COMPONENT_DIR)
+
+# sets the include paths into INCLUDES variable
+if(NVS_FLASH_INCLUDES)
+    list(TRANSFORM NVS_FLASH_INCLUDES PREPEND ${NVS_FLASH_DIR}/)
+    list(APPEND NVS_INCLUDES ${NVS_FLASH_INCLUDES})
+endif()
+
+# Add our source files to the lib
+target_sources(usermod_nvs INTERFACE ${NVS_SOURCES})
+
+# Add include directories.
+target_include_directories(usermod_nvs INTERFACE ${NVS_INCLUDES})
+
+# Link our INTERFACE library to the usermod target.
+target_link_libraries(usermod INTERFACE usermod_nvs)

ext_mod/esp32_additions/nsv/micropython.cmake

@@ -0,0 +1,71 @@
+#include "py/runtime.h"
+#include "py/stream.h"
+#include "py/mphal.h"
+#include "mphalport.h"
+
+#include "driver/spi_master.h"
+#include "driver/spi_common.h"
+#include "soc/spi_pins.h"
+
+#ifndef __ESP32_SPI_H__
+    #define __ESP32_SPI_H__
+
+
+    typedef struct _esp32_hw_spi_dev_obj_t esp32_hw_spi_dev_obj_t;
+    typedef struct _esp32_hw_spi_bus_obj_t esp32_hw_spi_bus_obj_t;
+
+    typedef struct {
+        spi_transaction_t base;
+        bool trans_done;
+    } esp32_spi_trans_descriptor_t;
+
+
+    struct _esp32_hw_spi_dev_obj_t{
+        spi_device_interface_config_t devcfg;
+        esp32_hw_spi_bus_obj_t *spi_bus;
+        uint8_t bits;
+        size_t max_transfer_sz;
+        spi_device_handle_t spi_dev;
+
+        mp_obj_t trans_start_cb;            // User register's callback, invoked when data trans starts
+        mp_obj_t trans_start_user_data;     // User's private data, passed directly to callback trans_start_cb
+
+        mp_obj_t trans_end_cb;              // User register's callback, invoked when data trans end
+        mp_obj_t trans_end_user_data;       // User's private data, passed directly to callback trans_end_cb
+
+        size_t num_trans_inflight;          // Number of transactions that are undergoing (the descriptor not recycled yet)
+        size_t trans_pool_count;            // Size of transaction queue
+        esp32_spi_trans_descriptor_t trans_pool[]; // Transaction pool
+    };
+
+    struct _esp32_hw_spi_bus_obj_t{
+        mp_obj_base_t base;
+        spi_host_device_t host;
+        spi_bus_config_t buscfg;
+        bool octal_mode;                    // Indicates whether the transmitting is enabled with octal mode (8 data lines)
+
+        enum {
+            MACHINE_HW_SPI_STATE_NONE,
+            MACHINE_HW_SPI_STATE_INIT,
+            MACHINE_HW_SPI_STATE_DEINIT
+        } state;
+
+    };
+
+    typedef struct _esp32_hw_spi_default_pins_t{
+        int8_t mosi_io_num;    ///< GPIO pin for Master Out Slave In (=spi_d) signal, or -1 if not used.
+        int8_t miso_io_num;    ///< GPIO pin for Master In Slave Out (=spi_q) signal, or -1 if not used.
+        int8_t sclk_io_num;      ///< GPIO pin for SPI Clock signal, or -1 if not used.
+        int8_t quadwp_io_num;  ///< GPIO pin for WP (Write Protect) signal, or -1 if not used.
+        int8_t quadhd_io_num;  ///< GPIO pin for HD (Hold) signal, or -1 if not used.
+        int8_t data4_io_num;     ///< GPIO pin for spi data4 signal in octal mode, or -1 if not used.
+        int8_t data5_io_num;     ///< GPIO pin for spi data5 signal in octal mode, or -1 if not used.
+        int8_t data6_io_num;     ///< GPIO pin for spi data6 signal in octal mode, or -1 if not used.
+        int8_t data7_io_num;     ///< GPIO pin for spi data7 signal in octal mode, or -1 if not used.
+        int8_t cs_io_num
+    } esp32_hw_spi_default_pins_t;
+
+    extern const mp_obj_type_t esp32_hw_spi_bus_type;
+    extern const mp_obj_type_t esp32_hw_spi_dev_type;
+
+#endif

ext_mod/expanded_nvs_esp32/src/nvs.c renamed to ext_mod/esp32_additions/nsv/src/nvs.c

@@ -0,0 +1,24 @@
+# Create an INTERFACE library for our C module.
+add_library(usermod_spi INTERFACE)
+
+set(SPI_INCLUDES)
+set(SPI_SOURCES ${CMAKE_CURRENT_LIST_DIR}/src/spi.c)
+
+# gets driver include paths
+idf_component_get_property(DRIVER_INCLUDES driver INCLUDE_DIRS)
+idf_component_get_property(DRIVER_DIR driver COMPONENT_DIR)
+
+# sets the include paths into INCLUDES variable
+if(DRIVER_INCLUDES)
+    list(TRANSFORM DRIVER_INCLUDES PREPEND ${DRIVER_DIR}/)
+    list(APPEND SPI_INCLUDES ${DRIVER_INCLUDES})
+endif()
+
+# Add our source files to the lib
+target_sources(usermod_spi INTERFACE ${SPI_SOURCES})
+
+# Add include directories.
+target_include_directories(usermod_spi INTERFACE ${SPI_INCLUDES})
+
+# Link our INTERFACE library to the usermod target.
+target_link_libraries(usermod INTERFACE usermod_spi)