/*  ============================================================================ *   Copyright (c) Texas Instruments Inc 2002, 2003, 2004, 2005 * *   Use of this software is controlled by the terms and conditions found in the *   license agreement under which this software has been supplied. *   =========================================================================== *//** @file csl_msHwSetup.c * *  @brief    File for functional layer of CSL API \a CSL_msHwSetup() * *  Path: \\(CSLPATH)\\ipmodules\\memstick\\src * *  Description *   - The \a CSL_msHwSetup() function definition & it's associated functions * *  Date 7th June, 2004 *  Author Santosh Narayanan * *//* ============================================================================= *  Revision History *  ================ *  14-Dec-2004 kpn Updated the file for the new CSL format. * ============================================================================= */#include <csl_ms.h>/** ============================================================================ *   @n@b CSL_msHwSetup * *   @b Description *   @n It configures the memory stick registers as per the values passed *      in the hardware setup structure. * *   @b Arguments *   @verbatim            hMs             Handle to the ms            hwSetup         Pointer to harware setup structure     @endverbatim * *   <b> Return Value </b>  CSL_Status *   @li                    CSL_SOK             - Hardware setup successful *   @li                    CSL_ESYS_BADHANDLE  - Invalid handle *   @li                    CSL_ESYS_INVPARAMS  - Hardware structure is not                                                  properly initialized * *   <b> Pre Condition </b> *   @n  None * *   <b> Post Condition </b> *   @n  MS registers are configured according to the hardware setup parameters * *   @b Modifies *   @n MS registers * *   @b Example *   @verbatim            CSL_MsHandle        hMs;            CSL_MsObj           msObj;            CSL_MsHwSetup       hwSetup;            CSL_status          status;            ...            hMs = CSL_msOpen(&msObj, CSL_MS, NULL, &status);            status = CSL_msHwSetup(hMs, &hwSetup);     @endverbatim * ============================================================================= */#pragma CODE_SECTION (CSL_msHwSetup, ".text:csl_section:ms");CSL_Status CSL_msHwSetup (    CSL_MsHandle            hMs,    CSL_MsHwSetup          *hwSetup){    if (hwSetup == NULL) {        return CSL_ESYS_INVPARAMS;    }    if (hMs == NULL) {        return CSL_ESYS_BADHANDLE;    }    hMs->regs->MSSYST  = ((hMs->regs->MSSYST & 0x0000FFFF)               |                         CSL_FMK ( MS_MSSYST_RST, hwSetup->reset)        |                         CSL_FMK ( MS_MSSYST_SRAC, hwSetup->mode)        |                         CSL_FMK ( MS_MSSYST_NOCRC, hwSetup->crc)        |                         CSL_FMK ( MS_MSSYST_INTCLR, hwSetup->intClear)  |                         CSL_FMK ( MS_MSSYST_INTEN, hwSetup->intHost)    |                         CSL_FMK ( MS_MSSYST_MSIEN, hwSetup->intDevice)  |                         CSL_FMK ( MS_MSSYST_FCLR, hwSetup->fifoClear)   |                         CSL_FMK ( MS_MSSYST_FDIR, hwSetup->fifoDir)     |                         CSL_FMK ( MS_MSSYST_DAM, hwSetup->dmaMode)      |                         CSL_FMK ( MS_MSSYST_DRM, hwSetup->drm)          |                         CSL_FMK ( MS_MSSYST_DRQSL, hwSetup->drqInt)     |                         CSL_FMK ( MS_MSSYST_REI, hwSetup->rei)          |                         CSL_FMK ( MS_MSSYST_REO, hwSetup->reo)          |                         CSL_FMK ( MS_MSSYST_BSY, hwSetup->bsyCount));    hMs->regs->MSMCR = (CSL_FMK (MS_MSMCR_BS, hwSetup->byteSwap) |                       CSL_FMK (MS_MSMCR_CD, hwSetup->clockDivider));    return CSL_SOK;}