Merge pull request #407 from MikroElektronika/mikrosdk-2.14.6

mikrosdk-2.14.6

Author: IvanRuzavin

changelog/v2.14.6/changelog.md

@@ -0,0 +1,54 @@
+<p align="center">
+  <img src="http://www.mikroe.com/img/designs/beta/logo_small.png?raw=true" alt="MikroElektronika"/>
+</p>
+
+---
+
+**[BACK TO MAIN FILE](../../changelog.md)**
+
+---
+
+# `v2.14.6`
+
++ released: 2025-07-17
+
+## Changes
+
+- [`v2.14.6`](#v2146)
+  - [Changes](#changes)
+    - [New Features](#new-features)
+      - [mikroSDK](#mikrosdk)
+    - [Fixes](#fixes)
+      - [FT800](#ft800)
+    - [NEW HARDWARE](#new-hardware)
+
+### New Features
+
+#### mikroSDK
+
++ Introduced SPI transfer API
+  + Full-duplex SPI support available across all architectures in mikroSDK
+  + This addition enables simultaneous data transmission and reception via a single call
+
+### Fixes
+
+#### FT800
+
++ Refactored code to eliminate redundancy by encapsulating repeated logic into reusable functions
++ Enhanced compatibility with compilers through conditional adjustments and code alignment:
+  + All MikroC compilers
+  + XC8 compiler
++ Disabled FT800 support for AVR architectures due to insufficient performance for reliable display operation
+
+### NEW HARDWARE
+
+> NOTE:
+>> If any new hardware was added to current version, it will be listed here.
+
+Support added for following hardware:
+
+---
+
+**[BACK TO MAIN FILE](../../changelog.md)**
+
+---

drv/lib/include/drv_spi_master.h

@@ -515,6 +515,38 @@ err_t spi_master_write_then_read( spi_master_t *obj, uint8_t *write_data_buffer,
                                                      uint8_t *read_data_buffer,
                                                      size_t length_read_data );
 
+/**
+ * @brief Full-duplex SPI transfer.
+ * @details Simultaneously transmits and receives a buffer of data over SPI.
+ * The data sent from the write buffer is echoed with received data into the read buffer.
+ * @param[in] obj SPI master driver object.
+ * @param[in] write_data_buffer Buffer containing bytes to transmit.
+ * @param[out] read_data_buffer Buffer to store received bytes.
+ * @param[in] data_length Number of bytes to transmit and receive.
+ * @return One of the values defined by #spi_master_err_t.
+ *
+ * @pre Call #spi_master_open before this function.
+ *
+ * @b Example
+ * @code
+ *   #define DATA_LENGTH 64
+ *
+ *   uint8_t tx_buf[DATA_LENGTH] = { 0xA5, 0x5A, ... };
+ *   uint8_t rx_buf[DATA_LENGTH];
+ *
+ *   spi_master_t spi;
+ *
+ *   if ( SPI_MASTER_SUCCESS == spi_master_transfer( &spi, tx_buf, rx_buf, DATA_LENGTH ) ) {
+ *       // Successful transfer
+ *   } else {
+ *       // Handle the error
+ *   }
+ * @endcode
+ */
+err_t spi_master_transfer( spi_master_t *obj, uint8_t *write_data_buffer,
+                                              uint8_t *read_data_buffer,
+                                              size_t data_length );
+
 /**
  * @brief  Close SPI Master Driver context object.
  * @details Closes SPI Master Driver context object,

drv/lib/src/lib_drv_spi_master/drv_spi_master.c

@@ -374,8 +374,8 @@ err_t spi_master_write_then_read( spi_master_t *obj, uint8_t *write_data_buffer,
                                                      uint8_t *read_data_buffer,
                                                       size_t length_read_data )
 {
-     if ( _acquire( obj, false ) != ACQUIRE_FAIL )
-     {
+    if ( _acquire( obj, false ) != ACQUIRE_FAIL )
+    {
         #if DRV_TO_HAL
         return hal_spi_master_write_then_read( &obj->handle, write_data_buffer,
                                                              length_write_data,
@@ -424,7 +424,62 @@ err_t spi_master_write_then_read( spi_master_t *obj, uint8_t *write_data_buffer,
             return HAL_SPI_MASTER_SUCCESS;
         }
         #endif
-     } else {
+    } else {
+        return SPI_MASTER_ERROR;
+    }
+}
+
+err_t spi_master_transfer( spi_master_t *obj, uint8_t *write_data_buffer,
+                                              uint8_t *read_data_buffer,
+                                              size_t data_length ) {
+    if ( _acquire( obj, false ) != ACQUIRE_FAIL ) {
+        #if DRV_TO_HAL
+        return hal_spi_master_transfer( &obj->handle, write_data_buffer,
+                                                        read_data_buffer,
+                                                        data_length );
+        #else
+        hal_spi_master_handle_register_t *hal_handle = ( hal_spi_master_handle_register_t* )hal_is_handle_null( (handle_t *)&obj->handle );
+        err_t hal_status = HAL_SPI_MASTER_SUCCESS;
+
+        if ( !hal_handle )
+        {
+            return HAL_SPI_MASTER_ERROR;
+        }
+
+        if ( !write_data_buffer || !read_data_buffer )
+        {
+            return HAL_SPI_MASTER_ERROR;
+        }
+
+        if ( data_length <= 0 )
+        {
+            return HAL_SPI_MASTER_ERROR;
+        }
+
+        if ( hal_handle->init_state == false )
+        {
+            hal_status = hal_ll_module_configure_spi( (handle_t *)&hal_handle );
+        }
+
+        if( hal_status != HAL_SPI_MASTER_SUCCESS )
+        {
+            return HAL_SPI_MASTER_ERROR;
+        } else {
+            hal_handle->init_state = true;
+        }
+
+        hal_status =  hal_spi_master_transfer( (handle_t *)&hal_handle, write_data_buffer,
+                                                                        read_data_buffer,
+                                                                        data_length );
+
+        if (hal_status == HAL_SPI_MASTER_MODULE_ERROR)
+        {
+            return HAL_SPI_MASTER_ERROR;
+        } else {
+            return HAL_SPI_MASTER_SUCCESS;
+        }
+        #endif
+    } else {
         return SPI_MASTER_ERROR;
     }
 }

hal/lib/include/hal_spi_master.h

@@ -486,6 +486,39 @@ err_t hal_spi_master_write_then_read( handle_t handle, uint8_t *write_data_buffe
                                                        uint8_t *read_data_buffer,
                                                         size_t length_read_data );
 
+/**
+ * @brief Perform full-duplex SPI transfer.
+ * @details Simultaneously writes and reads a sequence of bytes on the
+ * SPI bus in blocking mode. For each transmitted byte, a byte is received.
+ *
+ * @param[in] handle SPI master handle.
+ * See #hal_spi_master_t structure definition for detailed explanation.
+ * @param[in] write_data_buffer Buffer containing bytes to transmit.
+ * @param[out] read_data_buffer Buffer to store received bytes.
+ * @param[in] data_length Number of bytes to transmit and receive.
+ *
+ * @return The function can return one of the values defined by
+ * #hal_spi_master_err_t, which is size dependant on the architecture.
+ *
+ * @pre Before calling this function,
+ * the user is expected to call #hal_spi_master_open function.
+ *
+ * @note The transfer is performed in blocking mode.
+ *
+ * @b Example
+ * @code
+ *   #define DATA_LENGTH 128
+ *
+ *   uint8_t tx_data[ DATA_LENGTH ] = { 0xA5, 0x5A, ... };
+ *   uint8_t rx_data[ DATA_LENGTH ];
+ *
+ *   hal_spi_master_transfer( handle, tx_data, rx_data, DATA_LENGTH );
+ * @endcode
+ */
+err_t hal_spi_master_transfer( handle_t handle, uint8_t *write_data_buffer,
+                                                uint8_t *read_data_buffer,
+                                                size_t data_length );
+
 /**
  * @brief  Close SPI Master HAL context object.
  * @details Closes SPI Master HAL context object,

hal/lib/src/lib_hal_spi_master/hal_spi_master.c

@@ -388,6 +388,52 @@ err_t hal_spi_master_write_then_read( handle_t handle, uint8_t *write_data_buffe
     }
 }
 
+err_t hal_spi_master_transfer( handle_t handle, uint8_t *write_data_buffer,
+                                                uint8_t *read_data_buffer,
+                                                size_t data_length )
+{
+    hal_spi_master_handle_register_t *hal_handle = ( hal_spi_master_handle_register_t* )hal_is_handle_null( handle );
+    err_t hal_status = HAL_SPI_MASTER_SUCCESS;
+
+    if ( !hal_handle )
+    {
+        return HAL_SPI_MASTER_ERROR;
+    }
+
+    if ( !write_data_buffer || !read_data_buffer )
+    {
+        return HAL_SPI_MASTER_ERROR;
+    }
+
+    if ( data_length <= 0 )
+    {
+        return HAL_SPI_MASTER_ERROR;
+    }
+
+    if ( hal_handle->init_state == false )
+    {
+        hal_status = hal_ll_module_configure_spi( &hal_handle );
+    }
+
+    if( hal_status != HAL_SPI_MASTER_SUCCESS )
+    {
+        return HAL_SPI_MASTER_ERROR;
+    } else {
+        hal_handle->init_state = true;
+    }
+
+    hal_status =  hal_ll_spi_master_transfer( &hal_handle, write_data_buffer,
+                                                           read_data_buffer,
+                                                           data_length );
+
+    if (hal_status == HAL_SPI_MASTER_MODULE_ERROR)
+    {
+        return HAL_SPI_MASTER_ERROR;
+    } else {
+        return HAL_SPI_MASTER_SUCCESS;
+    }
+}
+
 err_t hal_spi_master_close( handle_t *handle )
 {
     hal_spi_master_handle_register_t *hal_handle = ( hal_spi_master_handle_register_t * )hal_is_handle_null( handle );

middleware/CMakeLists.txt

@@ -31,7 +31,9 @@ if(${MSDK_BUILD_TFT_MODULES})
         add_subdirectory(ft5xx6)
         add_subdirectory(stmpe811)
         add_subdirectory(tsc2003)
-        add_subdirectory(ft800)
+        if(NOT(${TOOLCHAIN_ID} STREQUAL "mikrocavr"))
+            add_subdirectory(ft800)
+        endif()
     endif()
     add_subdirectory(touch_controller)
 endif()