2.3-InternetRadio/nutos/nut/arch/cm3/dev/stm/stm32_usart3.c

/*
 * Copyright (C) 2010 by Ulrich Prinz (uprinz2@netscape.net)
 * Copyright (C) 2010 by Rittal GmbH & Co. KG. All rights reserved.
 * Copyright (C) 2012 by Uwe Bonnes (bon@elektron.ikp.physik.tu-darmstadt.de)
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the copyright holders nor the names of
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * For additional information see http://www.ethernut.de/
 *
 */

/*!
 * \verbatim
 * $Id: stm32_usart3.c 5715 2014-05-23 14:55:37Z u_bonnes $
 * \endverbatim
 */

#include <cfg/os.h>
#include <cfg/clock.h>
#include <cfg/arch.h>
#include <cfg/uart.h>
#include <cfg/arch/gpio.h>

#include <string.h>

#include <sys/atom.h>
#include <sys/event.h>
#include <sys/timer.h>

#include <dev/irqreg.h>
#include <dev/gpio.h>
#include <dev/usart.h>

#include <arch/cm3/stm/stm32xxxx.h>
#include <arch/cm3/stm/stm32_gpio.h>
#include <arch/cm3/stm/stm32_usart.h>

/*!
 * \addtogroup xgNutArchCm3Stm32
 */
/*@{*/

/*!
 * \brief USART3 device control block structure.
 */
static USARTDCB dcb_usart3 = {
    0,                          /* dcb_modeflags */
    0,                          /* dcb_statusflags */
    0,                          /* dcb_rtimeout */
    0,                          /* dcb_wtimeout */
    { 0,0,0,0,0,0,0},           /* dcb_tx_rbf */
    { 0,0,0,0,0,0,0},           /* dcb_rx_rbf */
    0,                          /* dcb_last_eol */
    Stm32UsartInit,             /* dcb_init */
    Stm32UsartDeinit,           /* dcb_deinit */
    Stm32UsartTxStart,          /* dcb_tx_start */
    Stm32UsartRxStart,          /* dcb_rx_start */
    Stm32UsartSetFlowControl,   /* dcb_set_flow_control */
    Stm32UsartGetFlowControl,   /* dcb_get_flow_control */
    Stm32UsartSetSpeed,         /* dcb_set_speed */
    Stm32UsartGetSpeed,         /* dcb_get_speed */
    Stm32UsartSetDataBits,      /* dcb_set_data_bits */
    Stm32UsartGetDataBits,      /* dcb_get_data_bits */
    Stm32UsartSetParity,        /* dcb_set_parity */
    Stm32UsartGetParity,        /* dcb_get_parity */
    Stm32UsartSetStopBits,      /* dcb_set_stop_bits */
    Stm32UsartGetStopBits,      /* dcb_get_stop_bits */
    Stm32UsartSetStatus,        /* dcb_set_status */
    Stm32UsartGetStatus,        /* dcb_get_status */
    Stm32UsartSetClockMode,     /* dcb_set_clock_mode */
    Stm32UsartGetClockMode,     /* dcb_get_clock_mode */
};

/*!
 * \name STM32 USART3 Device
 */
/*@{*/
/*!
 * \brief USART3 device information structure.
 *
 * An application must pass a pointer to this structure to
 * NutRegisterDevice() before using the serial communication
 * driver of the STM32s on-chip USART3.
 *
 * The device is named \b uart3.
 *
 * \showinitializer
 */
NUTDEVICE devUsartStm32_3 = {
    0,                          /* Pointer to next device, dev_next. */
    {'u', 's', 'a', 'r', 't', '3', 0, 0, 0},    /* Unique device name, dev_name. */
    IFTYP_CHAR,                 /* Type of device, dev_type. */
    USART3_BASE,                /* Base address, dev_base. */
    USART3_IRQn,                /* First interrupt number, dev_irq. */
    NULL,                       /* Interface control block, dev_icb. */
    &dcb_usart3,                /* Driver control block, dev_dcb. */
    UsartInit,                  /* Driver initialization routine, dev_init. */
    UsartIOCtl,                 /* Driver specific control function, dev_ioctl. */
    UsartRead,                  /* Read from device, dev_read. */
    UsartWrite,                 /* Write to device, dev_write. */
    UsartOpen,                  /* Open a device or file, dev_open. */
    UsartClose,                 /* Close a device or file, dev_close. */
    UsartSize,                  /* Request file size, dev_size. */
    UsartSelect,                /* Select function, dev_select. */
};

/*@}*/

/*!
 * \brief USART3 GPIO configuartion and assignment.
 *
 * Remap         NO     PART  FULL
 * F1:       TX  PB10   PC10  PD8
 *           RX  PB11   PC11  PD9
 *           CK  PB12   PC12  PD10
 *           CTS PB13   PB13  PD11
 *           RTS PB14   PB14  PD12
 * L1/F2/F4: TX  PB10   PC10  PD8
 *           RX  PB11   PC11  PD9
 *           CK  PB12   PC12  PD10
 *           CTS PB13   PD11
 *           RTS PB14   PD12
 * F3:       TX  PB10   PC10  PD8
 *           RX  PB11   PC11  PD9  PE15
 *           CK  PB12   PC12  PD10
 *           CTS PB13   PD11  PA13
 *           RTS PB14   PD12  PF6
  *
 */

#if defined(MCU_STM32F1)
 #define STM_USART_REMAP_MASK AFIO_MAPR_USART3_REMAP
 #if defined(USART3_PARTREMAP_USART)
  #define STM_USART_REMAP_VALUE AFIO_MAPR_USART3_REMAP_PARTIALREMAP
  #define TX_GPIO_PORT    NUTGPIO_PORTC
  #define TX_GPIO_PIN     10
  #define RX_GPIO_PORT    NUTGPIO_PORTC
  #define RX_GPIO_PIN     11
  #if defined(USART3_HARDWARE_HANDSHAKE)
   #define CTS_GPIO_PORT   NUTGPIO_PORTB
   #define CTS_GPIO_PIN    13
   #define RTS_GPIO_PORT   NUTGPIO_PORTB
   #define RTS_GPIO_PIN    14
  #endif
 #elif defined(USART3_FULLREMAP_USART)
  #define STM_USART_REMAP_VALUE AFIO_MAPR_USART3_REMAP_FULLREMAP
  #define TX_GPIO_PORT    NUTGPIO_PORTD
  #define TX_GPIO_PIN     8
  #define RX_GPIO_PORT    NUTGPIO_PORTD
  #define RX_GPIO_PIN     9
  #if defined(USART3_HARDWARE_HANDSHAKE)
   #define RTS_GPIO_PORT   NUTGPIO_PORTD
   #define RTS_GPIO_PIN    12
   #define CTS_GPIO_PORT   NUTGPIO_PORTD
   #define CTS_GPIO_PIN    11
  #endif
 #else /*USART3_NOREMAP_USART*/
  #define STM_USART_REMAP_VALUE AFIO_MAPR_USART3_REMAP_NOREMAP
  #define TX_GPIO_PORT    NUTGPIO_PORTB
  #define TX_GPIO_PIN     10
  #define RX_GPIO_PORT    NUTGPIO_PORTB
  #define RX_GPIO_PIN     11
  #if defined(USART3_HARDWARE_HANDSHAKE)
   #define RTS_GPIO_PORT   NUTGPIO_PORTB
   #define RTS_GPIO_PIN    14
   #define CTS_GPIO_PORT   NUTGPIO_PORTB
   #define CTS_GPIO_PIN    13
  #endif
 #endif /* USART3_NOREMAP_USART */
#else /* L1/F2/F3/F4*/
 #if defined(MCU_STM32F3)
  #define STM_USART_REMAP  GPIO_AF_7
 #else
  #define STM_USART_REMAP  GPIO_AF_USART3
 #endif
 #if !defined(USART3_TX_PIN)
  #if defined(USART3_PARTREMAP_USART)
   #define TX_GPIO_PORT    NUTGPIO_PORTC
   #define TX_GPIO_PIN     10
  #elif defined(USART3_FULLREMAP_USART)
    #define TX_GPIO_PORT    NUTGPIO_PORTD
   #define TX_GPIO_PIN     8
  #else
   #define TX_GPIO_PORT    NUTGPIO_PORTB
   #define TX_GPIO_PIN     10
  #endif
 #elif USART3_TX_PIN == -1
 #elif USART3_TX_PIN == 10
  #define TX_GPIO_PORT    NUTGPIO_PORTB
  #define TX_GPIO_PIN     10
 #elif USART3_TX_PIN == 310
  #define TX_GPIO_PORT    NUTGPIO_PORTC
  #define TX_GPIO_PIN     10
 #elif USART3_TX_PIN == 8
  #define TX_GPIO_PORT    NUTGPIO_PORTD
  #define TX_GPIO_PIN     8
 #else
  #warning "Illegal USART3 TX pin assignement"
 #endif
 #if !defined(USART3_RX_PIN)
  #if defined(USART3_PARTREMAP_USART)
   #define RX_GPIO_PORT    NUTGPIO_PORTC
   #define RX_GPIO_PIN     11
  #elif defined(USART3_FULLREMAP_USART)
   #define RX_GPIO_PORT    NUTGPIO_PORTD
   #define RX_GPIO_PIN     9
  #else
   #define RX_GPIO_PORT    NUTGPIO_PORTB
   #define RX_GPIO_PIN     11
  #endif
 #elif USART3_RX_PIN == -1
 #elif USART3_RX_PIN == 11
  #define RX_GPIO_PORT    NUTGPIO_PORTB
  #define RX_GPIO_PIN     11
 #elif USART3_RX_PIN == 311
  #define RX_GPIO_PORT    NUTGPIO_PORTC
  #define RX_GPIO_PIN     11
 #elif USART3_RX_PIN == 9
  #define RX_GPIO_PORT    NUTGPIO_PORTD
  #define RX_GPIO_PIN     9
 #elif defined(MCU_STM32F3) && USART3_RX_PIN == 15
  #define RX_GPIO_PORT    NUTGPIO_PORTE
  #define RX_GPIO_PIN     15
 #else
  #warning "Illegal USART3 RX pin assignement"
 #endif
 #if !defined(USART3_CK_PIN)
  #if defined(USART3_PARTREMAP_USART)
   #define CK_GPIO_PORT    NUTGPIO_PORTC
   #define CK_GPIO_PIN     12
  #elif defined(USART3_FULLREMAP_USART)
   #define CK_GPIO_PORT    NUTGPIO_PORTD
   #define CK_GPIO_PIN     10
  #else
   #define CK_GPIO_PORT    NUTGPIO_PORTB
   #define CK_GPIO_PIN     12
  #endif
 #elif USART3_CK_PIN == 12
  #define CK_GPIO_PORT    NUTGPIO_PORTB
  #define CK_GPIO_PIN     12
 #elif USART3_CK_PIN == 312
  #define CK_GPIO_PORT    NUTGPIO_PORTC
  #define CK_GPIO_PIN     12
 #elif USART3_CK_PIN == 10
  #define CK_GPIO_PORT    NUTGPIO_PORTD
  #define CK_GPIO_PIN     10
 #else
  #warning "Illegal USART3 CK pin assignement"
 #endif
 #if defined(USART3_HARDWARE_HANDSHAKE)
  #if !defined(USART3_CTS_PIN)
   #if defined(USART3_FULLREMAP_USART)
    #define CTS_GPIO_PORT    NUTGPIO_PORTD
    #define CTS_GPIO_PIN     11
   #else
    #define CTS_GPIO_PORT    NUTGPIO_PORTB
    #define CTS_GPIO_PIN     13
   #endif
  #elif USART3_CTS_PIN == 13
   #define CTS_GPIO_PORT    NUTGPIO_PORTB
   #define CTS_GPIO_PIN     13
  #elif USART3_CTS_PIN == 11
   #define CTS_GPIO_PORT    NUTGPIO_PORTD
   #define CTS_GPIO_PIN     11
  #elif defined(MCU_STM32F3) && USART3_CTS_PIN == 013
   #define CTS_GPIO_PORT    NUTGPIO_PORTA
   #define CTS_GPIO_PIN     13
  #else
   #warning "Illegal USART3 CTS pin assignement"
  #endif
  #if !defined(USART3_RTS_PIN)
   #if defined(USART3_FULLREMAP_USART)
    #define RTS_GPIO_PORT    NUTGPIO_PORTD
    #define RTS_GPIO_PIN     12
   #else
    #define RTS_GPIO_PORT    NUTGPIO_PORTB
    #define RTS_GPIO_PIN     14
   #endif
  #elif USART3_RTS_PIN == 14
   #define RTS_GPIO_PORT    NUTGPIO_PORTB
   #define RTS_GPIO_PIN     14
  #elif USART3_RTS_PIN == 12
   #define RTS_GPIO_PORT    NUTGPIO_PORTD
   #define RTS_GPIO_PIN     12
  #elif defined(MCU_STM32F3) && USART3_CTS_PIN == 6
   #define CTS_GPIO_PORT    NUTGPIO_PORTF
   #define CTS_GPIO_PIN     6
  #else
   #warning "Illegal USART3 RTS pin assignement"
  #endif
 #endif
#endif

#ifdef USART3_RS485_CTRL
#define USART_485_CTRL
#ifdef USART3_485DE_INV
#define USART_485DE_INV
#endif
#ifdef USART3_485RE_INV
#define USART_485RE_INV
#endif
#if defined(USART3_485DE_PORT) && defined(USART3_485DE_PIN)
#define DE_GPIO_BASE  GPIO_ID2GPIO(USART3_485DE_PORT)
#define DE_GPIO_PORT  USART3_485DE_PORT
#define DE_GPIO_PIN   USART3_485DE_PIN
#endif
#if defined(USART3_485RE_PORT) && defined(USART3_485RE_PIN)
#define NRE_GPIO_BASE  GPIO_ID2GPIO(USART3_485RE_PORT)
#define NRE_GPIO_PORT  USART3_485RE_PORT
#define NRE_GPIO_PIN   USART3_485RE_PIN
#endif
#endif /* USART3_RS485_CTRL */

/*!
 * \brief USART3 base configuration.
 */
static void  StmUsartClkEnable(int enable)
{
    if (enable)
        RCC->APB1ENR |= RCC_APB1ENR_USART3EN;
    RCC->APB1RSTR |= RCC_APB1RSTR_USART3RST;
    RCC->APB1RSTR &= ~RCC_APB1RSTR_USART3RST;
    if (!enable)
        RCC->APB1ENR &= ~RCC_APB1ENR_USART3EN;
}

#ifdef USART3_INIT_BAUDRATE
#define USART_INIT_BAUTRATE USART3_INIT_BAUDRATE
#endif

#ifdef USART3_HARDWARE_HANDSHAKE
  #define USART_HWFLOWCTRL USART_HardwareFlowControl_RTS_CTS
  #define US_MODE_HWHANDSHAKE
#else
  #define USART_HWFLOWCTRL USART_HardwareFlowControl_None
  #undef  US_MODE_HWHANDSHAKE
#endif

#ifdef USART3_XONXOFF_CONTROL
#define USART_XONXOFF_CONTROL
#else
#undef  USART_XONXOFF_CONTROL
#endif

#ifdef USART3_MODE_IRDA
#define USART_MODE_IRDA
#else
#undef  USART_MODE_IRDA
#endif

#ifdef USART3_HARDWARE_HDX
#define USART_HARDWARE_HDX
#else
#undef USART_HARDWARE_HDX
#endif

#ifdef USART3_SUPPORT_DMA
 #if defined(MCU_STM32F1)||defined(MCU_STM32L1)
  #define UART_DMA_TXCHANNEL  DMA1_C2
  #define UART_DMA_RXCHANNEL  DMA1_C3
 #elif  defined(MCU_STM32F2)||defined(MCU_STM32F4)
  #define UART_DMA_TXCHANNEL  USART3_TX_DMA
  #define UART_DMA_RXCHANNEL  USART3_TRX_DMA
 #else
  #warning "STM32 family has no implemented DMA"
 #endif
#else
#undef UART_DMA_TXCHANNEL
#undef UART_DMA_RXCHANNEL
#endif

#if defined(USART3_TX_PIN_INV)
#define USART_TX_PIN_INV
#else
#undef USART_TX_PIN_INV
#endif
#if defined(USART3_RX_PIN_INV)
#define USART_RX_PIN_INV
#else
#undef USART_RX_PIN_INV
#endif

#if defined(USART3_SWAP)
#define USART_SWAP
#else
#undef USART_SWAP
#endif

#define USARTn      USART3
#define USARTnBase  USART3_BASE
#define USARTirqn   USART3_IRQn
#define USARTclk    NUT_HWCLK_PCLK1
#define UART_DR_PTR (uint32_t*)(USARTnBase+4)

#define SigUSART sig_USART3
#define DcbUSART dcb_usart3

/*@}*/
#include "stm32_usart.c"