bcmdhd_hdf/bcmdhd/bcmsdh.c

/*
 *  BCMSDH interface glue
 *  implement bcmsdh API for SDIOH driver
 *
 * Copyright (C) 1999-2019, Broadcom.
 *
 *      Unless you and Broadcom execute a separate written software license
 * agreement governing use of this software, this software is licensed to you
 * under the terms of the GNU General Public License version 2 (the "GPL"),
 * available at http://www.broadcom.com/licenses/GPLv2.php, with the
 * following added to such license:
 *
 *      As a special exception, the copyright holders of this software give you
 * permission to link this software with independent modules, and to copy and
 * distribute the resulting executable under terms of your choice, provided that
 * you also meet, for each linked independent module, the terms and conditions
 * of the license of that module.  An independent module is a module which is
 * not derived from this software.  The special exception does not apply to any
 * modifications of the software.
 *
 *      Notwithstanding the above, under no circumstances may you combine this
 * software in any way with any other Broadcom software provided under a license
 * other than the GPL, without Broadcom's express prior written consent.
 *
 *
 * <<Broadcom-WL-IPTag/Open:>>
 *
 * $Id: bcmsdh.c 727623 2017-10-21 01:00:32Z $
 */

/**
 * @file bcmsdh.c
 */

/* ****************** BCMSDH Interface Functions *************************** */

#include <typedefs.h>
#include <bcmdevs.h>
#include <bcmendian.h>
#include <bcmutils.h>
#include <hndsoc.h>
#include <siutils.h>
#include <osl.h>

#include <bcmsdh.h>   /* BRCM API for SDIO clients (such as wl, dhd) */
#include <bcmsdbus.h> /* common SDIO/controller interface */
#include <sbsdio.h>   /* SDIO device core hardware definitions. */
#include <sdio.h>     /* SDIO Device and Protocol Specs */

#if defined(BT_OVER_SDIO)
#include <dhd_bt_interface.h>
#endif /* defined (BT_OVER_SDIO) */

#define SDIOH_API_ACCESS_RETRY_LIMIT 2
const uint bcmsdh_msglevel = BCMSDH_ERROR_VAL;

/* local copy of bcm sd handler */
bcmsdh_info_t *l_bcmsdh = NULL;

#if defined(BT_OVER_SDIO)
struct sdio_func *func_f3 = NULL;
static f3intr_handler processf3intr = NULL;
static dhd_hang_notification process_dhd_hang_notification = NULL;
static dhd_hang_state_t g_dhd_hang_state = NO_HANG_STATE;
#endif /* defined (BT_OVER_SDIO) */

#if defined(OOB_INTR_ONLY) && defined(HW_OOB) || defined(FORCE_WOWLAN)
extern int sdioh_enable_hw_oob_intr(void *sdioh, bool enable);

void bcmsdh_enable_hw_oob_intr(bcmsdh_info_t *sdh, bool enable)
{
    sdioh_enable_hw_oob_intr(sdh->sdioh, enable);
}
#endif // endif

#if defined(BT_OVER_SDIO)
void bcmsdh_btsdio_process_hang_state(dhd_hang_state_t new_state)
{
    bool state_change = false;

    BCMSDH_ERROR(("%s: DHD hang state changed - [%d] -> [%d]\n", __FUNCTION__,
                  g_dhd_hang_state, new_state));

    if (g_dhd_hang_state == new_state) {
        return;
    }

    switch (g_dhd_hang_state) {
        case NO_HANG_STATE:
            if (HANG_START_STATE == new_state) {
                state_change = true;
            }
            break;

        case HANG_START_STATE:
            if (HANG_RECOVERY_STATE == new_state ||
                NO_HANG_STATE == new_state) {
                state_change = true;
            }

            break;

        case HANG_RECOVERY_STATE:
            if (NO_HANG_STATE == new_state) {
                state_change = true;
            }
            break;

        default:
            BCMSDH_ERROR(("%s: Unhandled Hang state\n", __FUNCTION__));
            break;
    }

    if (!state_change) {
        BCMSDH_ERROR(("%s: Hang state cannot be changed\n", __FUNCTION__));
        return;
    }

    g_dhd_hang_state = new_state;
}

void bcmsdh_btsdio_process_f3_intr(void)
{
    if (processf3intr && (g_dhd_hang_state == NO_HANG_STATE)) {
        processf3intr(func_f3);
    }
}

void bcmsdh_btsdio_process_dhd_hang_notification(bool wifi_recovery_completed)
{
    bcmsdh_btsdio_process_hang_state(HANG_START_STATE);

    if (process_dhd_hang_notification) {
        process_dhd_hang_notification(func_f3, wifi_recovery_completed);
    }

    /* WiFi was off, so HANG_RECOVERY_STATE is not needed */
    if (wifi_recovery_completed) {
        bcmsdh_btsdio_process_hang_state(NO_HANG_STATE);
    } else {
        bcmsdh_btsdio_process_hang_state(HANG_RECOVERY_STATE);
    }
}

void bcmsdh_btsdio_interface_init(struct sdio_func *func,
                                  f3intr_handler f3intr_fun,
                                  dhd_hang_notification hang_notification)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)l_bcmsdh;
    BCMSDH_INFO(("%s: func %p \n", __FUNCTION__, func));
    func_f3 = func;
    processf3intr = f3intr_fun;
    sdioh_sdmmc_card_enable_func_f3(bcmsdh->sdioh, func);
    process_dhd_hang_notification = hang_notification;
}
EXPORT_SYMBOL(bcmsdh_btsdio_interface_init);
#endif /* defined (BT_OVER_SDIO) */

/* Attach BCMSDH layer to SDIO Host Controller Driver
 *
 * @param osh OSL Handle.
 * @param cfghdl Configuration Handle.
 * @param regsva Virtual address of controller registers.
 * @param irq Interrupt number of SDIO controller.
 *
 * @return bcmsdh_info_t Handle to BCMSDH context.
 */
bcmsdh_info_t *bcmsdh_attach(osl_t *osh, void *sdioh, ulong *regsva)
{
    bcmsdh_info_t *bcmsdh;

    if ((bcmsdh = (bcmsdh_info_t *)MALLOC(osh, sizeof(bcmsdh_info_t))) ==
        NULL) {
        BCMSDH_ERROR(("bcmsdh_attach: out of memory, malloced %d bytes\n",
                      MALLOCED(osh)));
        return NULL;
    }
    bzero((char *)bcmsdh, sizeof(bcmsdh_info_t));
    bcmsdh->sdioh = sdioh;
    bcmsdh->osh = osh;
    bcmsdh->init_success = TRUE;
    *regsva = si_enum_base(0);

    bcmsdh_force_sbwad_calc(bcmsdh, FALSE);

    /* Report the BAR, to fix if needed */
    bcmsdh->sbwad = si_enum_base(0);

    /* save the handler locally */
    l_bcmsdh = bcmsdh;

    return bcmsdh;
}

int bcmsdh_detach(osl_t *osh, void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    if (bcmsdh != NULL) {
        MFREE(osh, bcmsdh, sizeof(bcmsdh_info_t));
    }

    l_bcmsdh = NULL;

    return 0;
}

int bcmsdh_iovar_op(void *sdh, const char *name, void *params, uint plen,
                    void *arg, uint len, bool set)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    return sdioh_iovar_op(bcmsdh->sdioh, name, params, plen, arg, len, set);
}

bool bcmsdh_intr_query(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    bool on;

    ASSERT(bcmsdh);
    status = sdioh_interrupt_query(bcmsdh->sdioh, &on);
    if (SDIOH_API_SUCCESS(status)) {
        return FALSE;
    } else {
        return on;
    }
}

int bcmsdh_intr_enable(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
#ifdef BCMSPI_ANDROID
    uint32 data;
#endif /* BCMSPI_ANDROID */
    ASSERT(bcmsdh);

    status = sdioh_interrupt_set(bcmsdh->sdioh, TRUE);
#ifdef BCMSPI_ANDROID
    data = bcmsdh_cfg_read_word(sdh, 0, 0x4, NULL);
    data |= 0xE0E70000;
    bcmsdh_cfg_write_word(sdh, 0, 0x4, data, NULL);
#endif /* BCMSPI_ANDROID */
    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_intr_disable(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
#ifdef BCMSPI_ANDROID
    uint32 data;
#endif /* BCMSPI_ANDROID */
    ASSERT(bcmsdh);

    status = sdioh_interrupt_set(bcmsdh->sdioh, FALSE);
#ifdef BCMSPI_ANDROID
    data = bcmsdh_cfg_read_word(sdh, 0, 0x4, NULL);
    data &= ~0xE0E70000;
    bcmsdh_cfg_write_word(sdh, 0, 0x4, data, NULL);
#endif /* BCMSPI_ANDROID */
    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_intr_reg(void *sdh, bcmsdh_cb_fn_t fn, void *argh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh);

    status = sdioh_interrupt_register(bcmsdh->sdioh, fn, argh);
    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_intr_dereg(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh);

    status = sdioh_interrupt_deregister(bcmsdh->sdioh);
    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

#if defined(DHD_DEBUG)
bool bcmsdh_intr_pending(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    ASSERT(sdh);
    return sdioh_interrupt_pending(bcmsdh->sdioh);
}
#endif // endif

int bcmsdh_devremove_reg(void *sdh, bcmsdh_cb_fn_t fn, void *argh)
{
    ASSERT(sdh);

    /* don't support yet */
    return BCME_UNSUPPORTED;
}

/**
 * Read from SDIO Configuration Space
 * @param sdh SDIO Host context.
 * @param func_num Function number to read from.
 * @param addr Address to read from.
 * @param err Error return.
 * @return value read from SDIO configuration space.
 */
uint8 bcmsdh_cfg_read(void *sdh, uint fnc_num, uint32 addr, int *err)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    int32 retry = 0;
#endif // endif
    uint8 data = 0;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    do {
        if (retry) { /* wait for 1 ms till bus get settled down */
            OSL_DELAY(0x3E8);
        }
#endif // endif
        status = sdioh_cfg_read(bcmsdh->sdioh, fnc_num, addr, (uint8 *)&data);
#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    } while (!SDIOH_API_SUCCESS(status) &&
             (retry++ < SDIOH_API_ACCESS_RETRY_LIMIT));
#endif // endif
    if (err) {
        *err = (SDIOH_API_SUCCESS(status) ? 0 : BCME_SDIO_ERROR);
    }

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, uint8data = 0x%x\n", __FUNCTION__,
                 fnc_num, addr, data));

    return data;
}
#ifdef BCMSDH_MODULE
EXPORT_SYMBOL(bcmsdh_cfg_read);
#endif

void bcmsdh_cfg_write(void *sdh, uint fnc_num, uint32 addr, uint8 data,
                      int *err)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    int32 retry = 0;
#endif // endif

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    do {
        if (retry) { /* wait for 1 ms till bus get settled down */
            OSL_DELAY(0x3E8);
        }
#endif // endif
        status = sdioh_cfg_write(bcmsdh->sdioh, fnc_num, addr, (uint8 *)&data);
#ifdef SDIOH_API_ACCESS_RETRY_LIMIT
    } while (!SDIOH_API_SUCCESS(status) &&
             (retry++ < SDIOH_API_ACCESS_RETRY_LIMIT));
#endif // endif
    if (err) {
        *err = SDIOH_API_SUCCESS(status) ? 0 : BCME_SDIO_ERROR;
    }

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, uint8data = 0x%x\n", __FUNCTION__,
                 fnc_num, addr, data));
}
#ifdef BCMSDH_MODULE
EXPORT_SYMBOL(bcmsdh_cfg_write);
#endif

uint32 bcmsdh_cfg_read_word(void *sdh, uint fnc_num, uint32 addr, int *err)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    uint32 data = 0;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

    status = sdioh_request_word(bcmsdh->sdioh, SDIOH_CMD_TYPE_NORMAL,
                                SDIOH_READ, fnc_num, addr, &data, 0x4);

    if (err) {
        *err = (SDIOH_API_SUCCESS(status) ? 0 : BCME_SDIO_ERROR);
    }

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, uint32data = 0x%x\n", __FUNCTION__,
                 fnc_num, addr, data));

    return data;
}

void bcmsdh_cfg_write_word(void *sdh, uint fnc_num, uint32 addr, uint32 data,
                           int *err)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

    status = sdioh_request_word(bcmsdh->sdioh, SDIOH_CMD_TYPE_NORMAL,
                                SDIOH_WRITE, fnc_num, addr, &data, 0x4);

    if (err) {
        *err = (SDIOH_API_SUCCESS(status) ? 0 : BCME_SDIO_ERROR);
    }

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, uint32data = 0x%x\n", __FUNCTION__,
                 fnc_num, addr, data));
}

int bcmsdh_cis_read(void *sdh, uint func, uint8 *cis, uint length)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    uint8 *tmp_buf, *tmp_ptr;
    uint8 *ptr;
    bool ascii = func & ~0xf;
    func &= 0x7;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);
    ASSERT(cis);
    ASSERT(length <= SBSDIO_CIS_SIZE_LIMIT);

    status = sdioh_cis_read(bcmsdh->sdioh, func, cis, length);

    if (ascii) {
        /* Move binary bits to tmp and format them into the provided buffer. */
        if ((tmp_buf = (uint8 *)MALLOC(bcmsdh->osh, length)) == NULL) {
            BCMSDH_ERROR(("%s: out of memory\n", __FUNCTION__));
            return BCME_NOMEM;
        }
        bcopy(cis, tmp_buf, length);
        for (tmp_ptr = tmp_buf, ptr = cis; ptr < (cis + length - 0x4);
             tmp_ptr++) {
            ptr += snprintf((char *)ptr, (cis + length - ptr - 0x4), "%.2x ",
                            *tmp_ptr & 0xff);
            if ((((tmp_ptr - tmp_buf) + 1) & 0xf) == 0) {
                ptr += snprintf((char *)ptr, (cis + length - ptr - 0x4), "\n");
            }
        }
        MFREE(bcmsdh->osh, tmp_buf, length);
    }

    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_cisaddr_read(void *sdh, uint func, uint8 *cisd, uint32 offset)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    func &= 0x7;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);
    ASSERT(cisd);

    status = sdioh_cisaddr_read(bcmsdh->sdioh, func, cisd, offset);

    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdhsdio_set_sbaddr_window(void *sdh, uint32 address, bool force_set)
{
    int err = 0;
    uint bar0 = address & ~SBSDIO_SB_OFT_ADDR_MASK;
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    if (bar0 != bcmsdh->sbwad || force_set) {
        bcmsdh_cfg_write(bcmsdh, SDIO_FUNC_1, SBSDIO_FUNC1_SBADDRLOW,
                         (address >> 0x8) & SBSDIO_SBADDRLOW_MASK, &err);
        if (!err) {
            bcmsdh_cfg_write(bcmsdh, SDIO_FUNC_1, SBSDIO_FUNC1_SBADDRMID,
                             (address >> 0x10) & SBSDIO_SBADDRMID_MASK, &err);
        }
        if (!err) {
            bcmsdh_cfg_write(bcmsdh, SDIO_FUNC_1, SBSDIO_FUNC1_SBADDRHIGH,
                             (address >> 0x18) & SBSDIO_SBADDRHIGH_MASK, &err);
        }

        if (!err) {
            bcmsdh->sbwad = bar0;
        } else {
            /* invalidate cached window var */
            bcmsdh->sbwad = 0;
        }
    }

    return err;
}

uint32 bcmsdh_reg_read(void *sdh, uintptr addr, uint size)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    uint32 word = 0;

    BCMSDH_INFO(
        ("%s:fun = 1, addr = 0x%x\n", __FUNCTION__, (unsigned int)addr));

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

    if (bcmsdhsdio_set_sbaddr_window(bcmsdh, addr, bcmsdh->force_sbwad_calc)) {
        bcmsdh->regfail =
            TRUE; // terence 20130621: prevent dhd_dpc in dead lock
        return 0xFFFFFFFF;
    }

    addr &= SBSDIO_SB_OFT_ADDR_MASK;
    if (size == 0x4) {
        addr |= SBSDIO_SB_ACCESS_2_4B_FLAG;
    }

    status = sdioh_request_word(bcmsdh->sdioh, SDIOH_CMD_TYPE_NORMAL,
                                SDIOH_READ, SDIO_FUNC_1, addr, &word, size);

    bcmsdh->regfail = !(SDIOH_API_SUCCESS(status));

    BCMSDH_INFO(("uint32data = 0x%x\n", word));

    /* if ok, return appropriately masked word */
    if (SDIOH_API_SUCCESS(status)) {
        switch (size) {
            case sizeof(uint8):
                return (word & 0xff);
            case sizeof(uint16):
                return (word & 0xffff);
            case sizeof(uint32):
                return word;
            default:
                bcmsdh->regfail = TRUE;
        }
    }

    /* otherwise, bad sdio access or invalid size */
    BCMSDH_ERROR(("%s: error reading addr 0x%x size %d\n", __FUNCTION__,
                  (unsigned int)addr, size));
    return 0xFFFFFFFF;
}

uint32 bcmsdh_reg_write(void *sdh, uintptr addr, uint size, uint32 data)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    int err = 0;

    BCMSDH_INFO(("%s:fun = 1, addr = 0x%x, uint%ddata = 0x%x\n", __FUNCTION__,
                 (unsigned int)addr, size * 0x8, data));

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    ASSERT(bcmsdh->init_success);

    if ((err = bcmsdhsdio_set_sbaddr_window(bcmsdh, addr,
                                            bcmsdh->force_sbwad_calc))) {
        bcmsdh->regfail = TRUE; // terence 20130621:
        return err;
    }

    addr &= SBSDIO_SB_OFT_ADDR_MASK;
    if (size == 0x4) {
        addr |= SBSDIO_SB_ACCESS_2_4B_FLAG;
    }
    status = sdioh_request_word(bcmsdh->sdioh, SDIOH_CMD_TYPE_NORMAL,
                                SDIOH_WRITE, SDIO_FUNC_1, addr, &data, size);
    bcmsdh->regfail = !(SDIOH_API_SUCCESS(status));

    if (SDIOH_API_SUCCESS(status)) {
        return 0;
    }

    BCMSDH_ERROR(("%s: error writing 0x%08x to addr 0x%04x size %d\n",
                  __FUNCTION__, data, (unsigned int)addr, size));
    return 0xFFFFFFFF;
}

bool bcmsdh_regfail(void *sdh)
{
    return ((bcmsdh_info_t *)sdh)->regfail;
}

int bcmsdh_recv_buf(void *sdh, uint32 addr, uint fn, uint flags, uint8 *buf,
                    uint nbytes, void *pkt, bcmsdh_cmplt_fn_t complete_fn,
                    void *handle)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    uint incr_fix;
    uint width;
    int err = 0;

    ASSERT(bcmsdh);
    ASSERT(bcmsdh->init_success);

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, size = %d\n", __FUNCTION__, fn,
                 addr, nbytes));

    /* Async not implemented yet */
    ASSERT(!(flags & SDIO_REQ_ASYNC));
    if (flags & SDIO_REQ_ASYNC) {
        return BCME_UNSUPPORTED;
    }

    if ((err = bcmsdhsdio_set_sbaddr_window(bcmsdh, addr, FALSE))) {
        return err;
    }

    addr &= SBSDIO_SB_OFT_ADDR_MASK;

    incr_fix = (flags & SDIO_REQ_FIXED) ? SDIOH_DATA_FIX : SDIOH_DATA_INC;
    width = (flags & SDIO_REQ_4BYTE) ? 0x4 : 0x2;
    if (width == 0x4) {
        addr |= SBSDIO_SB_ACCESS_2_4B_FLAG;
    }

    status =
        sdioh_request_buffer(bcmsdh->sdioh, SDIOH_DATA_PIO, incr_fix,
                             SDIOH_READ, fn, addr, width, nbytes, buf, pkt);

    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_SDIO_ERROR);
}

int bcmsdh_send_buf(void *sdh, uint32 addr, uint fn, uint flags, uint8 *buf,
                    uint nbytes, void *pkt, bcmsdh_cmplt_fn_t complete_fn,
                    void *handle)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;
    uint incr_fix;
    uint width;
    int err = 0;

    ASSERT(bcmsdh);
    ASSERT(bcmsdh->init_success);

    BCMSDH_INFO(("%s:fun = %d, addr = 0x%x, size = %d\n", __FUNCTION__, fn,
                 addr, nbytes));

    /* Async not implemented yet */
    ASSERT(!(flags & SDIO_REQ_ASYNC));
    if (flags & SDIO_REQ_ASYNC) {
        return BCME_UNSUPPORTED;
    }

    if ((err = bcmsdhsdio_set_sbaddr_window(bcmsdh, addr, FALSE))) {
        return err;
    }

    addr &= SBSDIO_SB_OFT_ADDR_MASK;

    incr_fix = (flags & SDIO_REQ_FIXED) ? SDIOH_DATA_FIX : SDIOH_DATA_INC;
    width = (flags & SDIO_REQ_4BYTE) ? 0x4 : 0x2;
    if (width == 0x4) {
        addr |= SBSDIO_SB_ACCESS_2_4B_FLAG;
    }

    status =
        sdioh_request_buffer(bcmsdh->sdioh, SDIOH_DATA_PIO, incr_fix,
                             SDIOH_WRITE, fn, addr, width, nbytes, buf, pkt);

    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_rwdata(void *sdh, uint rw, uint32 addr, uint8 *buf, uint nbytes)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    SDIOH_API_RC status;

    ASSERT(bcmsdh);
    ASSERT(bcmsdh->init_success);
    ASSERT((addr & SBSDIO_SBWINDOW_MASK) == 0);

    addr &= SBSDIO_SB_OFT_ADDR_MASK;
    addr |= SBSDIO_SB_ACCESS_2_4B_FLAG;

    status = sdioh_request_buffer(bcmsdh->sdioh, SDIOH_DATA_PIO, SDIOH_DATA_INC,
                                  (rw ? SDIOH_WRITE : SDIOH_READ), SDIO_FUNC_1,
                                  addr, 0x4, nbytes, buf, NULL);

    return (SDIOH_API_SUCCESS(status) ? 0 : BCME_ERROR);
}

int bcmsdh_abort(void *sdh, uint fn)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    return sdioh_abort(bcmsdh->sdioh, fn);
}

int bcmsdh_start(void *sdh, int stage)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    return sdioh_start(bcmsdh->sdioh, stage);
}

int bcmsdh_stop(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    return sdioh_stop(bcmsdh->sdioh);
}

int bcmsdh_waitlockfree(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    return sdioh_waitlockfree(bcmsdh->sdioh);
}

int bcmsdh_query_device(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    bcmsdh->vendevid = (VENDOR_BROADCOM << 0x10) | 0;
    return (bcmsdh->vendevid);
}

uint bcmsdh_query_iofnum(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    return (sdioh_query_iofnum(bcmsdh->sdioh));
}

int bcmsdh_reset(bcmsdh_info_t *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    return sdioh_sdio_reset(bcmsdh->sdioh);
}

void *bcmsdh_get_sdioh(bcmsdh_info_t *sdh)
{
    ASSERT(sdh);
    return sdh->sdioh;
}

/* Function to pass device-status bits to DHD. */
uint32 bcmsdh_get_dstatus(void *sdh)
{
#ifdef BCMSPI
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);
    return sdioh_get_dstatus(sd);
#else
    return 0;
#endif /* BCMSPI */
}
uint32 bcmsdh_cur_sbwad(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }

    return (bcmsdh->sbwad);
}

/* example usage: if force is TRUE, forces the bcmsdhsdio_set_sbaddr_window to
 * calculate sbwad always instead of caching.
 */
void bcmsdh_force_sbwad_calc(void *sdh, bool force)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;

    if (!bcmsdh) {
        bcmsdh = l_bcmsdh;
    }
    bcmsdh->force_sbwad_calc = force;
}

void bcmsdh_chipinfo(void *sdh, uint32 chip, uint32 chiprev)
{
#ifdef BCMSPI
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);
    sdioh_chipinfo(sd, chip, chiprev);
#else
    return;
#endif /* BCMSPI */
}

#ifdef BCMSPI
void bcmsdh_dwordmode(void *sdh, bool set)
{
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);
    sdioh_dwordmode(sd, set);
    return;
}
#endif /* BCMSPI */

int bcmsdh_sleep(void *sdh, bool enab)
{
#ifdef SDIOH_SLEEP_ENABLED
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);

    return sdioh_sleep(sd, enab);
#else
    return BCME_UNSUPPORTED;
#endif // endif
}

int bcmsdh_gpio_init(void *sdh)
{
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);

    return sdioh_gpio_init(sd);
}

bool bcmsdh_gpioin(void *sdh, uint32 gpio)
{
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);

    return sdioh_gpioin(sd, gpio);
}

int bcmsdh_gpioouten(void *sdh, uint32 gpio)
{
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);

    return sdioh_gpioouten(sd, gpio);
}

int bcmsdh_gpioout(void *sdh, uint32 gpio, bool enab)
{
    bcmsdh_info_t *p = (bcmsdh_info_t *)sdh;
    sdioh_info_t *sd = (sdioh_info_t *)(p->sdioh);

    return sdioh_gpioout(sd, gpio, enab);
}

uint bcmsdh_set_mode(void *sdh, uint mode)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    return (sdioh_set_mode(bcmsdh->sdioh, mode));
}

#ifdef PKT_STATICS
uint32 bcmsdh_get_spend_time(void *sdh)
{
    bcmsdh_info_t *bcmsdh = (bcmsdh_info_t *)sdh;
    return (sdioh_get_spend_time(bcmsdh->sdioh));
}
#endif