bspserial.c

来自「iMX21 Serial driver under WinCE5.0」· C语言 代码 · 共 343 行

//-----------------------------------------------------------------------------
//
//  Copyright (C) 2004, Motorola Inc. All Rights Reserved
//
//------------------------------------------------------------------------------
//
// Copyright (C) 2004-2007, Freescale Semiconductor, Inc. All Rights Reserved.
// THIS SOURCE CODE, AND ITS USE AND DISTRIBUTION, IS SUBJECT TO THE TERMS
// AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENT
//
//------------------------------------------------------------------------------

//-----------------------------------------------------------------------------
//
//  File:  bspserial.c
//
//  Provides BSP-specific configuration routines for the UART peripheral.
//
//-----------------------------------------------------------------------------


//------------------------------------------------------------------------------
// INCLUDE FILES  
//------------------------------------------------------------------------------

#include <windows.h>
#include <bsp.h>


//------------------------------------------------------------------------------
// MACRO DEFINITIONS 
//------------------------------------------------------------------------------
#define UART_CLK                BSP_PERCLK1_FREQ
#define UART_MAX_DIV            7


//------------------------------------------------------------------------------
// Local Functions
//-----------------------------------------------------------------------------

//-----------------------------------------------------------------------------
//
// Function: BSPUartCalRFDIV
//
// This is a private function to calculate the data
// rate divider from input frequency.
//
// Parameters:
//      dwFrequency
//          [in] Frequency requested.
//
// Returns:
//      Data rate divisor for requested frequency.
//-----------------------------------------------------------------------------
UCHAR BSPUartCalRFDIV( ULONG* pRefFreq )
{
    UCHAR dwDivisor; // the data rate divisor

    dwDivisor =(UCHAR) (UART_CLK / *pRefFreq);

    if (dwDivisor == 0)
        dwDivisor = 1;
    else if (dwDivisor > UART_MAX_DIV)
        dwDivisor = UART_MAX_DIV;

    *pRefFreq = UART_CLK /dwDivisor;

    return dwDivisor;
}


//-----------------------------------------------------------------------------
//
// Function: BSPUartGetIrq
//
// This is a private function to get the UART irq No with specified Uart IO address.
//
// Parameters:
//      HWAddr
//          [in] Physical IO address.
//
// Returns:
//      corresponding uart type.
//-----------------------------------------------------------------------------
BOOL BSPUartGetIrq(ULONG HWAddr, PULONG pIrq)
{
    switch (HWAddr) {
        case CSP_BASE_REG_PA_UART1:
            *pIrq = IRQ_UART1;
            return TRUE;
        case CSP_BASE_REG_PA_UART2:
            *pIrq = IRQ_UART2;
            return TRUE;
        case CSP_BASE_REG_PA_UART3:
            *pIrq = IRQ_UART3;
            return TRUE;
        case CSP_BASE_REG_PA_UART4:
            *pIrq = IRQ_UART4;
            return TRUE;
        default:
            return FALSE;
    }
}


//-----------------------------------------------------------------------------
//
// Function: BSPUartGetType
//
// This is a private function to get the UART type with specified Uart IO address.
//
// Parameters:
//      HWAddr
//          [in] Physical IO address.
//
// Returns:
//      corresponding uart type.
//-----------------------------------------------------------------------------
BOOL BSPUartGetType(ULONG HWAddr, uartType_c * pType)
{
    switch (HWAddr) {
        case CSP_BASE_REG_PA_UART1:
            *pType=DCE;
            return TRUE;
        case CSP_BASE_REG_PA_UART2:
            *pType=DTE;
            return TRUE;
        case CSP_BASE_REG_PA_UART3:
            *pType=DTE;
            return TRUE;
        case CSP_BASE_REG_PA_UART4:
            *pType=DTE;
            return TRUE;
        default:
            return FALSE;
    }
}


//-----------------------------------------------------------------------------
//
// Function: BSPUartEnableClock
//
// This function is to enable/disable UART clock.
//
// Parameters:
//      HWAddr
//          [in] Physical IO address.
//      bEnable
//          [in] TRUE if Uart Clock is to be enabled. FALSE if Uart Clock is
//                to be disabled.
//
// Returns:
//      TRUE if successfully performed the required action.
//
//-----------------------------------------------------------------------------
BOOL BSPUartEnableClock(ULONG HWAddr, BOOL bEnable)
{
    BOOL result = FALSE;
    HWCLOCK_ID clockId;
    DWORD dwTransferred;

    switch (HWAddr) {
        case CSP_BASE_REG_PA_UART1:
            clockId = HWCLOCK_ID_UART1;
            break;
        case CSP_BASE_REG_PA_UART2:
            clockId = HWCLOCK_ID_UART2;
            break;
        case CSP_BASE_REG_PA_UART3:
            clockId = HWCLOCK_ID_UART3;
            break;
        case CSP_BASE_REG_PA_UART4:
            clockId = HWCLOCK_ID_UART4;
            break;
        default:
            return result;
    }

    if (bEnable) {
        if(KernelIoControl(IOCTL_HAL_POWER_HW_CLK, &clockId, sizeof(clockId), 
            NULL, 0, &dwTransferred) == FALSE) {
            ERRORMSG(1, (TEXT("UART clock enable failed!\r\n")));
            goto CleanUp;
        }
    }
    else {
        if(KernelIoControl(IOCTL_HAL_SHUTDOWN_HW_CLK, &clockId, sizeof(clockId), 
            NULL, 0, &dwTransferred) == FALSE) {
            ERRORMSG(1, (TEXT("UART clock disable failed!\r\n")));
            goto CleanUp;
        }
    }

    result = TRUE;

CleanUp:
    return result;
}

//-----------------------------------------------------------------------------
//
// Function: BSPUartConfigGPIO
//
// This function is to configures UART GPIO pins.
//
// Parameters:
//      HWAddr
//          [in] Physical IO address.
//      bIR
//          [in] TRUE if SIR. FALSE if not SIR.
//      bEnable
//          [in] TRUE if enable Uart GPIO pins. FALSE if disable Uart
//                GPIO pins.
//
// Returns:
//      TRUE if successfully performed the required action.
//
//-----------------------------------------------------------------------------
BOOL BSPUartConfigGPIO(ULONG HWAddr, BOOL bIR, BOOL bEnable)
{
    BOOL result = FALSE;
    GPIO_IOCTL_CFG  cfg;
    DWORD dwTransferred;

    if (bIR) {
        switch (HWAddr) {
            case CSP_BASE_REG_PA_UART1:
                GPIO_SET_IOCTL_STRUCT(cfg, UART1_IR);
                break;
            case CSP_BASE_REG_PA_UART2:
                GPIO_SET_IOCTL_STRUCT(cfg, UART2_IR);
                break;
            case CSP_BASE_REG_PA_UART3:
                GPIO_SET_IOCTL_STRUCT(cfg, UART3_IR);
                break;
            case CSP_BASE_REG_PA_UART4:
                GPIO_SET_IOCTL_STRUCT(cfg, UART4_IR);
                break;
            default:
                return result;
        }
    }
    else {
        switch (HWAddr) {
            case CSP_BASE_REG_PA_UART1:
                GPIO_SET_IOCTL_STRUCT(cfg, UART1);
                break;
            case CSP_BASE_REG_PA_UART2:
                GPIO_SET_IOCTL_STRUCT(cfg, UART2);
                break;
            case CSP_BASE_REG_PA_UART3:
                GPIO_SET_IOCTL_STRUCT(cfg, UART3);
                break;
            case CSP_BASE_REG_PA_UART4:
                GPIO_SET_IOCTL_STRUCT(cfg, UART4_REDIRECT);
                if (bEnable) {
                    if(KernelIoControl(IOCTL_HAL_ENABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG(1, (TEXT("Cannot enable UART gpio!\r\n")));
                        goto CleanUp;
                    }

                     if(KernelIoControl(IOCTL_HAL_ENABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG(1, (TEXT("Cannot enable UART gpio for power off!\r\n")));
                        goto CleanUp;
                    }
                }
                else
                {
                    if(KernelIoControl(IOCTL_HAL_DISABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG (1, (TEXT("Cannot Disable UART gpio!\r\n"))); 
                        goto CleanUp;
                    }

                    if(KernelIoControl(IOCTL_HAL_DISABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG (1, (TEXT("Cannot Disable UART gpio for power off!\r\n"))); 
                        goto CleanUp;
                    }
                }
                GPIO_SET_IOCTL_STRUCT(cfg, UART4_ALT);

                if (bEnable) {
                    if(KernelIoControl(IOCTL_HAL_ENABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG(1, (TEXT("Cannot enable UART gpio!\r\n")));
                        goto CleanUp;
                    }

                    if(KernelIoControl(IOCTL_HAL_ENABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG(1, (TEXT("Cannot enable UART gpio for power off!\r\n")));
                        goto CleanUp;
                    }
                }
                else {
                    if(KernelIoControl(IOCTL_HAL_DISABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG (1, (TEXT("Cannot Disable UART gpio!\r\n"))); 
                        goto CleanUp;
                    }

                    if(KernelIoControl(IOCTL_HAL_DISABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                        ERRORMSG (1, (TEXT("Cannot Disable UART gpio for power off!\r\n"))); 
                    goto CleanUp;
                    }
                }

                GPIO_SET_IOCTL_STRUCT(cfg, IO_UART4);
                break;
            default:
                return result;
        }
    }

    if (bEnable)
    {
        if(KernelIoControl(IOCTL_HAL_ENABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
            ERRORMSG(1, (TEXT("Cannot enable UART gpio!\r\n")));
            goto CleanUp;
        }

        if (!bIR)
            if(KernelIoControl(IOCTL_HAL_ENABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                ERRORMSG(1, (TEXT("Cannot enable UART gpio for power off!\r\n")));
                goto CleanUp;
            }
    }
    else {
        if(KernelIoControl(IOCTL_HAL_DISABLE_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
            ERRORMSG (1, (TEXT("Cannot Disable UART gpio!\r\n"))); 
            goto CleanUp;
        }

        if (!bIR)
            if(KernelIoControl(IOCTL_HAL_DISABLE_PWROFF_GPIO, &cfg, sizeof(cfg), NULL, 0, &dwTransferred) == FALSE) {
                ERRORMSG (1, (TEXT("Cannot Disable UART gpio for power off!\r\n"))); 
                goto CleanUp;
            }
    }

    result = TRUE;

CleanUp:
    return result;
}