Add Transceiver support

Signed-off-by: Frederic.Pillon <frederic.pillon@st.com>

Author: fpistm

README.md

@@ -50,8 +50,16 @@ Some default definitions can be overridden using:
   * `SD_BUS_WIDE_4B` (default)
   * `SD_BUS_WIDE_8B`
 
+#### SD Transceiver
+
+* `SD_TRANSCEIVER_MODE`: specifies whether external Transceiver is enabled or disabled. Available only on some STM32
+  * `SDMMC_TRANSCEIVER_ENABLE`
+  * `SDMMC_TRANSCEIVER_DISABLE` (default)
+
+* `SD_TRANSCEIVER_EN` pin number to enable the level shifter
+* `SD_TRANSCEIVER_SEL` pin number for voltage selection
 
 #### SD detect and timeout
 * `SD_DETECT_PIN` pin number
 
-* `SD_DATATIMEOUT` constant for Read/Write block
+* `SD_DATATIMEOUT` constant for Read/Write block

src/Sd2Card.cpp

@@ -47,6 +47,14 @@ bool Sd2Card::init(uint32_t detectpin)
       return false;
     }
   }
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+  PinName sd_en = digitalPinToPinName(SD_TRANSCEIVER_EN);
+  PinName sd_sel = digitalPinToPinName(SD_TRANSCEIVER_SEL);
+  BSP_SD_TransceiverPin(set_GPIO_Port_Clock(STM_PORT(sd_en)),
+                        STM_LL_GPIO_PIN(sd_en),
+                        set_GPIO_Port_Clock(STM_PORT(sd_sel)),
+                        STM_LL_GPIO_PIN(sd_sel));
+#endif
   if (BSP_SD_Init() == MSD_OK) {
     BSP_SD_GetCardInfo(&_SdCardInfo);
     return true;

src/bsp_sd.c

@@ -67,6 +67,11 @@
 #define SD_CLK_DIV               SDMMC_TRANSFER_CLK_DIV
 #endif
 
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+#define SD_TRANSCEIVER_ENABLE    SDMMC_TRANSCEIVER_ENABLE
+#define SD_TRANSCEIVER_DISABLE   SDMMC_TRANSCEIVER_DISABLE
+#endif
+
 #elif defined(SDIO)
 #define SD_INSTANCE              SDIO
 #define SD_CLK_ENABLE            __HAL_RCC_SDIO_CLK_ENABLE
@@ -92,10 +97,20 @@
 #define SD_BUS_WIDE              SD_BUS_WIDE_4B
 #endif
 
+#if defined(SDMMC_TRANSCEIVER_ENABLE) && !defined(SD_TRANSCEIVER_MODE)
+#define SD_TRANSCEIVER_MODE      SD_TRANSCEIVER_DISABLE
+#endif
+
 /* BSP SD Private Variables */
 static SD_HandleTypeDef uSdHandle;
 static uint32_t SD_detect_ll_gpio_pin = LL_GPIO_PIN_ALL;
 static GPIO_TypeDef *SD_detect_gpio_port = GPIOA;
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+static uint32_t SD_trans_en_ll_gpio_pin = LL_GPIO_PIN_ALL;
+static GPIO_TypeDef *SD_trans_en_gpio_port = GPIOA;
+static uint32_t SD_trans_sel_ll_gpio_pin = LL_GPIO_PIN_ALL;
+static GPIO_TypeDef *SD_trans_sel_gpio_port = GPIOA;
+#endif
 #ifndef STM32L1xx
 #define SD_OK                         HAL_OK
 #define SD_TRANSFER_OK                ((uint8_t)0x00)
@@ -124,6 +139,13 @@ uint8_t BSP_SD_Init(void)
   uSdHandle.Init.BusWide             = SD_BUS_WIDE_1B;
   uSdHandle.Init.HardwareFlowControl = SD_HW_FLOW_CTRL;
   uSdHandle.Init.ClockDiv            = SD_CLK_DIV;
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+  uSdHandle.Init.Transceiver = SD_TRANSCEIVER_MODE;
+  if (SD_TRANSCEIVER_MODE == SD_TRANSCEIVER_ENABLE) {
+
+    BSP_SD_Transceiver_MspInit(&uSdHandle, NULL);
+  }
+#endif
 
   if (SD_detect_ll_gpio_pin != LL_GPIO_PIN_ALL) {
     /* Msp SD Detect pin initialization */
@@ -179,6 +201,26 @@ uint8_t BSP_SD_DeInit(void)
   return  sd_state;
 }
 
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+/**
+  * @brief  Set the SD card device detect pin and port.
+  * @param  port one of the gpio port
+  * @param  pin one of the gpio pin
+  * @retval SD status
+  */
+uint8_t BSP_SD_TransceiverPin(GPIO_TypeDef *enport, uint32_t enpin, GPIO_TypeDef *selport, uint32_t selpin)
+{
+  if ((enport != 0) && (selport != 0)) {
+    SD_trans_en_ll_gpio_pin = enpin;
+    SD_trans_en_gpio_port = enport;
+    SD_trans_sel_ll_gpio_pin = selpin;
+    SD_trans_sel_gpio_port = selport;
+    return MSD_OK;
+  }
+  return MSD_ERROR;
+}
+#endif
+
 /**
   * @brief  Set the SD card device detect pin and port.
   * @param  port one of the gpio port
@@ -437,6 +479,47 @@ __weak void BSP_SD_MspDeInit(SD_HandleTypeDef *hsd, void *Params)
 #endif
 }
 
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+/**
+  * @brief  Initializes the SD Transceiver pin MSP.
+  * @param  hsd: SD handle
+  * @param  Params : pointer on additional configuration parameters, can be NULL.
+  */
+__weak void BSP_SD_Transceiver_MspInit(SD_HandleTypeDef *hsd, void *Params)
+{
+  UNUSED(hsd);
+  UNUSED(Params);
+
+  LL_GPIO_SetPinSpeed(SD_trans_en_gpio_port, SD_trans_en_ll_gpio_pin, LL_GPIO_SPEED_FREQ_HIGH);
+  LL_GPIO_SetPinMode(SD_trans_en_gpio_port, SD_trans_en_ll_gpio_pin, LL_GPIO_MODE_OUTPUT);
+  LL_GPIO_SetPinPull(SD_trans_en_gpio_port, SD_trans_en_ll_gpio_pin, LL_GPIO_PULL_NO);
+
+  LL_GPIO_SetPinSpeed(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin, LL_GPIO_SPEED_FREQ_HIGH);
+  LL_GPIO_SetPinMode(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin, LL_GPIO_MODE_OUTPUT);
+  LL_GPIO_SetPinPull(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin, LL_GPIO_PULL_NO);
+
+  /* Enable the level shifter */
+  LL_GPIO_SetOutputPin(SD_trans_en_gpio_port, SD_trans_en_ll_gpio_pin);
+
+  /* By default start with the default voltage */
+  LL_GPIO_ResetOutputPin(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin);
+}
+
+/**
+  * @brief  Enable/Disable the SD Transceiver 1.8V Mode Callback.
+  * @param  status: Voltage Switch State
+  * @retval None
+  */
+void HAL_SDEx_DriveTransceiver_1_8V_Callback(FlagStatus status)
+{
+  if (status == SET) {
+    LL_GPIO_SetOutputPin(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin);
+  } else {
+    LL_GPIO_ResetOutputPin(SD_trans_sel_gpio_port, SD_trans_sel_ll_gpio_pin);
+  }
+}
+#endif /* SDMMC_TRANSCEIVER_ENABLE */
+
 #ifndef STM32L1xx
 /**
   * @brief  Gets the current SD card data status.

src/bsp_sd.h

@@ -52,10 +52,6 @@ extern "C" {
 #error "This library version required a STM32 core version > 1.6.1.\
 Please update the core or install previous libray version."
 #endif
-/* Could be redefined in variant.h or using build_opt.h */
-#ifndef SD_DATATIMEOUT
-#define SD_DATATIMEOUT         100000000U
-#endif
 
 /*SD Card information structure */
 #ifndef STM32L1xx
@@ -76,10 +72,31 @@ Please update the core or install previous libray version."
 #define SD_PRESENT               ((uint8_t)0x01)
 #define SD_NOT_PRESENT           ((uint8_t)0x00)
 #define SD_DETECT_NONE           NUM_DIGITAL_PINS
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+#define SD_TRANSCEIVER_NONE      NUM_DIGITAL_PINS
+#endif
+
+/* Could be redefined in variant.h or using build_opt.h */
+#ifndef SD_DATATIMEOUT
+#define SD_DATATIMEOUT         100000000U
+#endif
+
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+#ifndef SD_TRANSCEIVER_EN
+#define SD_TRANSCEIVER_EN      SD_TRANSCEIVER_NONE
+#endif
+
+#ifndef SD_TRANSCEIVER_SEL
+#define SD_TRANSCEIVER_SEL     SD_TRANSCEIVER_NONE
+#endif
+#endif
 
 /* SD Exported Functions */
 uint8_t BSP_SD_Init(void);
 uint8_t BSP_SD_DeInit(void);
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+uint8_t BSP_SD_TransceiverPin(GPIO_TypeDef *enport, uint32_t enpin, GPIO_TypeDef *selport, uint32_t selpin);
+#endif
 uint8_t BSP_SD_DetectPin(GPIO_TypeDef *port, uint32_t pin);
 uint8_t BSP_SD_DetectITConfig(void (*callback)(void));
 #ifndef STM32L1xx
@@ -103,6 +120,9 @@ uint8_t BSP_SD_IsDetected(void);
 void    BSP_SD_MspInit(SD_HandleTypeDef *hsd, void *Params);
 void    BSP_SD_Detect_MspInit(SD_HandleTypeDef *hsd, void *Params);
 void    BSP_SD_MspDeInit(SD_HandleTypeDef *hsd, void *Params);
+#ifdef SDMMC_TRANSCEIVER_ENABLE
+void    BSP_SD_Transceiver_MspInit(SD_HandleTypeDef *hsd, void *Params);
+#endif
 
 #ifdef __cplusplus
 }