--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/TWD/FW_Transfer/eventMbox.c Tue Jun 29 12:34:26 2010 +0100
@@ -0,0 +1,787 @@
+/*
+ * eventMbox.c
+ *
+ * Copyright(c) 1998 - 2010 Texas Instruments. All rights reserved.
+ * All rights reserved.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v1.0 or BSD License which accompanies
+ * this distribution. The Eclipse Public License is available at
+ * http://www.eclipse.org/legal/epl-v10.html and the BSD License is as below.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * * 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.
+ * * Neither the name Texas Instruments nor the names of its
+ * 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.
+ */
+
+
+/** \file eventMbox.c
+ * \brief Handle any event interrupt from the FW
+ *
+ * \see
+ */
+
+#define __FILE_ID__ FILE_ID_102
+#include "eventMbox_api.h"
+#include "TwIf.h"
+#include "osApi.h"
+#include "report.h"
+#include "CmdBld.h"
+#include "FwEvent_api.h"
+#include "TWDriver.h"
+#include "BusDrv.h"
+
+
+
+#define EVENT_MBOX_BUFFERS 2
+
+
+typedef enum
+{
+ EVENT_MBOX_STATE_IDLE,
+ EVENT_MBOX_STATE_READING
+} EEventMboxState;
+
+typedef struct {
+ void* fCb; /* Event Callback function */
+ TI_HANDLE hCb; /* Evant handle */
+ TI_UINT8* pDataOffset; /* Event Data Offset */
+ #ifdef TI_DBG
+ TI_UINT32 uCount;
+ #endif
+
+}TRegisteredEventCb;
+
+typedef struct
+{
+ TI_UINT32 bitMask;/* Event bit mask */
+ char* str; /* Event trace string */
+ TI_UINT8 dataLen;/* Event data length */
+
+} TEventEntry;
+
+
+typedef struct
+{
+ TTxnStruct tTxnReg;
+ TI_UINT8 *pRegBuffer;
+
+} tTxnGenReg;
+
+
+typedef struct
+{
+ TTxnStruct tEventMbox;
+ TI_UINT8 *pEventMboxBuf;
+
+} tTxnEventMbox;
+
+
+
+typedef struct
+{
+ TI_UINT32 EventMboxAddr[EVENT_MBOX_BUFFERS]; /* the Event Mbox addresses in the device */
+ TI_UINT8 ActiveMbox; /* The current active Mbox */
+ EEventMboxState CurrentState;
+ TRegisteredEventCb CbTable[TWD_OWN_EVENT_MAX]; /* Callback table */
+
+ /* Handles */
+ TI_HANDLE hTwif;
+ TI_HANDLE hOs;
+ TI_HANDLE hReport;
+ TI_HANDLE hCmdBld;
+
+ /* HW params */
+ /* use a struct to read or write register (4 byte size) from the bus */
+ tTxnGenReg iTxnGenRegSize;
+
+ tTxnEventMbox iTxnEventMbox;
+
+ #ifdef TI_DBG
+ TI_UINT32 uCompounEvCount; /* Count the compound event */
+ TI_UINT32 uTotalEvCount; /* Count total number of event sending in the compound */
+ #endif /* TI_DBG */
+
+ fnotify_t fCb;
+ TI_HANDLE hCb;
+
+}TEventMbox;
+
+
+/********************************************************************************/
+/* Internal functions prototypes. */
+/********************************************************************************/
+
+static void eventMbox_ConfigCbTable(TI_HANDLE hEventMbox);
+static void eventMbox_ReadAddrCb(TI_HANDLE hEventMbox, TI_HANDLE hTxn);
+static void eventMbox_DummyCb(TI_HANDLE hEventMbox);
+static void eventMbox_ReadCompleteCB(TI_HANDLE hEventMbox, TTxnStruct *pTxnStruct);
+
+
+static const TEventEntry eventTable [TWD_OWN_EVENT_MAX] =
+{
+/*==================================================================================
+ *
+ * EVENT TABLE
+ *
+ * Note that changes here should be reflected also in ETwdOwnEventId in TWDriver.h !!!
+ *
+ ===================================================================================
+| Id | Event Mask Bit | Event String | Length |
+ ===================================================================================*/
+
+/* 0*/{ RSSI_SNR_TRIGGER_0_EVENT_ID, "RSSI SNR TRIGGER 0 " , 1},
+/* 1*/{ RSSI_SNR_TRIGGER_1_EVENT_ID, "RSSI SNR TRIGGER 1 " , 1},
+/* 2*/{ RSSI_SNR_TRIGGER_2_EVENT_ID, "RSSI SNR TRIGGER 2 " , 1},
+/* 3*/{ RSSI_SNR_TRIGGER_3_EVENT_ID, "RSSI SNR TRIGGER 3 " , 1},
+/* 4*/{ RSSI_SNR_TRIGGER_4_EVENT_ID, "RSSI SNR TRIGGER 4 " , 1},
+/* 5*/{ RSSI_SNR_TRIGGER_5_EVENT_ID, "RSSI SNR TRIGGER 5 " , 1},
+/* 6*/{ RSSI_SNR_TRIGGER_6_EVENT_ID, "RSSI SNR TRIGGER 6 " , 1},
+/* 7*/{ RSSI_SNR_TRIGGER_7_EVENT_ID, "RSSI SNR TRIGGER 7 " , 1},
+/* 8*/{ MEASUREMENT_START_EVENT_ID, "MEASUREMENT START " , 0},
+/* 9*/{ MEASUREMENT_COMPLETE_EVENT_ID, "BSS LOSE " , 0},
+/*10*/{ SCAN_COMPLETE_EVENT_ID , "SCAN CMPLT " , 8},
+/*11*/{ SCHEDULED_SCAN_COMPLETE_EVENT_ID, "SPS SCAN CMPLT " , 3},
+/*12*/{ AP_DISCOVERY_COMPLETE_EVENT_ID, "MAX TX RETRY " , 0},
+/*13*/{ PS_REPORT_EVENT_ID, "PS_REPORT " , 1},
+/*14*/{ PSPOLL_DELIVERY_FAILURE_EVENT_ID, "PS-POLL DELIVERY FAILURE" , 0},
+/*15*/{ DISCONNECT_EVENT_COMPLETE_ID, "DISCONNECT COMPLETE " , 0},
+/*16*/{ JOIN_EVENT_COMPLETE_ID, "JOIN CMPLT " , 0},
+/*17*/{ CHANNEL_SWITCH_COMPLETE_EVENT_ID, "SWITCH CHANNEL CMPLT " , 0},
+/*18*/{ BSS_LOSE_EVENT_ID, "BSS LOST " , 0},
+/*19*/{ REGAINED_BSS_EVENT_ID, "REGAINED BSS " , 0},
+/*20*/{ ROAMING_TRIGGER_MAX_TX_RETRY_EVENT_ID, "MAX TX RETRY " , 0},
+/*21*/{ BIT_21, "RESERVED" , 0},
+/*22*/{ SOFT_GEMINI_SENSE_EVENT_ID, "SOFT GEMINI SENSE " , 1},
+/*23*/{ SOFT_GEMINI_PREDICTION_EVENT_ID, "SOFT GEMINI PREDICTION " , 1},
+/*24*/{ SOFT_GEMINI_AVALANCHE_EVENT_ID, "SOFT GEMINI AVALANCHE " , 0},
+/*25*/{ PLT_RX_CALIBRATION_COMPLETE_EVENT_ID, "PLT RX CALIBR. COMPLETE " , 0},
+/*26*/{ DBG_EVENT_ID, "DBG_EVENT_ID " , 16},
+/*27*/{ HEALTH_CHECK_REPLY_EVENT_ID, "HEALTH_CHECK_REPLY_EVENT_ID" , 0},
+/*28*/{ PERIODIC_SCAN_COMPLETE_EVENT_ID, "PERIODIC SCAN COMPLETE " , 8},
+/*29*/{ PERIODIC_SCAN_REPORT_EVENT_ID, "PERIODIC SCAN REPORT " , 8},
+/*30*/{ BA_SESSION_TEAR_DOWN_EVENT_ID, "BA_SESSION_TEAR_DOWN_EVENT_ID" , 0},
+/*31*/{ EVENT_MBOX_ALL_EVENT_ID, "ALL EVENTS " , 0}
+};
+
+
+/*
+ * \brief Create the Bus Access mailbox object
+ *
+ * \param hOs - OS Handle
+ * \returnThe Created object
+ *
+ * \sa
+ */
+
+TI_HANDLE eventMbox_Create(TI_HANDLE hOs)
+{
+ TEventMbox *pEventMbox;
+ pEventMbox = (TEventMbox*)os_memoryAlloc(hOs,sizeof(TEventMbox),MemoryNormal);
+ if (pEventMbox == NULL)
+ {
+ WLAN_OS_REPORT (("eventMbox_Create: Error creating EventMbox object\n"));
+ return NULL;
+ }
+ os_memoryZero (hOs, pEventMbox, sizeof(TEventMbox));
+
+ /* Allocate the MBOX Buffer */
+ pEventMbox->iTxnEventMbox.pEventMboxBuf = os_memoryAlloc (hOs, sizeof (EventMailBox_t) + WSPI_PAD_LEN_READ,MemoryDMA);
+ if (pEventMbox->iTxnEventMbox.pEventMboxBuf == NULL)
+ {
+ return NULL;
+ }
+ os_memoryZero (hOs, pEventMbox->iTxnEventMbox.pEventMboxBuf, sizeof (EventMailBox_t) + WSPI_PAD_LEN_READ);
+ pEventMbox->iTxnEventMbox.pEventMboxBuf += WSPI_PAD_LEN_READ;
+
+ /* Allocate the Register buffer */
+ pEventMbox->iTxnGenRegSize.pRegBuffer = os_memoryAlloc (hOs, sizeof (TI_UINT32) + WSPI_PAD_LEN_READ,MemoryDMA);
+ if (pEventMbox->iTxnGenRegSize.pRegBuffer == NULL)
+ {
+ return NULL;
+ }
+ os_memoryZero (hOs, pEventMbox->iTxnGenRegSize.pRegBuffer, sizeof (TI_UINT32) + WSPI_PAD_LEN_READ);
+ pEventMbox->iTxnGenRegSize.pRegBuffer += WSPI_PAD_LEN_READ;
+
+ pEventMbox->hOs = hOs;
+ ((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask = EVENT_MBOX_ALL_EVENT_ID;
+ return (TI_HANDLE)pEventMbox;
+}
+
+
+/*
+ * \brief Release all memory resource of EventMbox
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \return none
+ *
+ * \par Description
+ * This function should called after all interrupts was disabled.
+ *
+ * \sa
+ */
+void eventMbox_Destroy(TI_HANDLE hEventMbox)
+{
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+
+ if (pEventMbox->iTxnEventMbox.pEventMboxBuf)
+ {
+ os_memoryFree (pEventMbox->hOs, pEventMbox->iTxnEventMbox.pEventMboxBuf - WSPI_PAD_LEN_READ, sizeof (EventMailBox_t) + WSPI_PAD_LEN_READ);
+ }
+
+ if (pEventMbox->iTxnGenRegSize.pRegBuffer)
+ {
+ os_memoryFree (pEventMbox->hOs, pEventMbox->iTxnGenRegSize.pRegBuffer - WSPI_PAD_LEN_READ, sizeof (TI_UINT32) + WSPI_PAD_LEN_READ);
+ }
+
+ if (pEventMbox)
+ {
+ os_memoryFree (pEventMbox->hOs, pEventMbox, sizeof(TEventMbox));
+ }
+}
+
+
+
+/*
+ * \brief Stop the EventMbox clear state and event vector
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \return none
+ *
+ * \par Description
+ * This function should called to stop the EventMb.
+ * Do Not clear the mask Event could use us again when restart/recovery!!!!
+ * \sa
+ */
+void eventMbox_Stop(TI_HANDLE hEventMbox)
+{
+ TEventMbox* pEventMbox = (TEventMbox*)hEventMbox;
+ pEventMbox->ActiveMbox = 0;
+ pEventMbox->CurrentState = EVENT_MBOX_STATE_IDLE;
+ ((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsVector = 0;
+}
+
+
+
+/*
+ * \brief Configure the object
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param hTwif - Handle to TWIF
+ * \param hReport - Handle to Report module
+ * \param hFwEvent - Handle to FW Event module
+ * \param hCmdBld - Handle to Command Build module
+ * \return none
+ *
+ * \par Description
+ * This function should called to configure the module.
+ * \sa
+ */
+
+void eventMbox_Config(TI_HANDLE hEventMbox,
+ TI_HANDLE hTwif,
+ TI_HANDLE hReport,
+ TI_HANDLE hFwEvent,
+ TI_HANDLE hCmdBld)
+{
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ pEventMbox->hTwif = hTwif;
+ pEventMbox->hReport = hReport;
+ pEventMbox->hCmdBld = hCmdBld;
+ pEventMbox->ActiveMbox = 0;
+ pEventMbox->CurrentState = EVENT_MBOX_STATE_IDLE;
+#ifdef TI_DBG
+ pEventMbox->uCompounEvCount = 0;
+ pEventMbox->uTotalEvCount = 0;
+#endif
+ eventMbox_ConfigCbTable(pEventMbox);
+}
+
+
+
+/*
+ * \brief Initialization of callback table
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \return none
+ *
+ * \par Description
+ * This function is called to configure the CB table initialize the
+ * CB functions and handle and set the Data offset.
+ *
+ * \sa
+ */
+static void eventMbox_ConfigCbTable(TI_HANDLE hEventMbox)
+{
+ TEventMbox* pEventMbox;
+ TI_UINT8 EvID;
+
+ pEventMbox = (TEventMbox*)hEventMbox;
+
+ /* for all events set a dummy func and data offset */
+ for (EvID = 0; EvID < TWD_OWN_EVENT_MAX;EvID++)
+ {
+ pEventMbox->CbTable[EvID].pDataOffset = pEventMbox->iTxnEventMbox.pEventMboxBuf;
+ pEventMbox->CbTable[EvID].fCb = (void*)eventMbox_DummyCb;
+ pEventMbox->CbTable[EvID].hCb = pEventMbox;
+ }
+ /* set the data offset for Events with data only */
+ for (EvID = 0;EvID < NUM_OF_RSSI_SNR_TRIGGERS;EvID++)
+ {
+ pEventMbox->CbTable[EvID].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t, RSSISNRTriggerMetric[EvID]);
+ }
+ pEventMbox->CbTable[TWD_DBG_EVENT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t, dbgEventRep);
+ pEventMbox->CbTable[TWD_OWN_EVENT_SCAN_CMPLT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,scanCompleteResults);
+ pEventMbox->CbTable[TWD_OWN_EVENT_SPS_SCAN_CMPLT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,scheduledScanAttendedChannels);
+ pEventMbox->CbTable[TWD_OWN_EVENT_PERIODIC_SCAN_COMPLETE].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t, scanCompleteResults);
+ pEventMbox->CbTable[TWD_OWN_EVENT_PERIODIC_SCAN_REPORT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t, scanCompleteResults);
+ pEventMbox->CbTable[TWD_OWN_EVENT_SOFT_GEMINI_SENSE ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,softGeminiSenseInfo);
+ pEventMbox->CbTable[TWD_OWN_EVENT_SOFT_GEMINI_PREDIC ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,softGeminiProtectiveInfo);
+ pEventMbox->CbTable[TWD_OWN_EVENT_SWITCH_CHANNEL_CMPLT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,channelSwitchStatus);
+ pEventMbox->CbTable[TWD_OWN_EVENT_PS_REPORT ].pDataOffset += TI_FIELD_OFFSET (EventMailBox_t,psStatus);
+}
+
+
+
+static void eventMbox_DummyCb(TI_HANDLE hEventMbox)
+{
+ TEventMbox* pEventMbox = (TEventMbox*)hEventMbox;
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_DummyCb : Called for unregistered event");
+}
+
+
+/*
+ * \brief Read mailbox address
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param fCb - CB function to return in Async mode
+ * \param hCb - CB Habdle
+ * \return TXN_STATUS_COMPLETE, TXN_STATUS_PENDING, TXN_STATUS_ERROR
+ *
+ * \par Description
+ * This function is called for initialize the Event MBOX addresses.
+ * It issues a read transaction from the Twif with a CB.
+ *
+ * \sa
+ */
+TI_STATUS eventMbox_InitMboxAddr(TI_HANDLE hEventMbox, fnotify_t fCb, TI_HANDLE hCb)
+{
+ TTxnStruct *pTxn;
+ TEventMbox* pEventMbox;
+ ETxnStatus rc;
+ pEventMbox = (TEventMbox*)hEventMbox;
+ pTxn = &pEventMbox->iTxnGenRegSize.tTxnReg;
+
+ /* Store the Callabck address of the modules that called us in case of Asynchronuous transaction that will complete later */
+ pEventMbox->fCb = fCb;
+ pEventMbox->hCb = hCb;
+
+ /* Build the command TxnStruct */
+ TXN_PARAM_SET(pTxn, TXN_LOW_PRIORITY, TXN_FUNC_ID_WLAN, TXN_DIRECTION_READ, TXN_INC_ADDR)
+ /* Applying a CB in case of an async read */
+ BUILD_TTxnStruct(pTxn, REG_EVENT_MAILBOX_PTR, pEventMbox->iTxnGenRegSize.pRegBuffer, REGISTER_SIZE, eventMbox_ReadAddrCb, hEventMbox)
+ rc = twIf_Transact(pEventMbox->hTwif,pTxn);
+ if (rc == TXN_STATUS_COMPLETE)
+ {
+ pEventMbox->EventMboxAddr[0] = *((TI_UINT32*)(pEventMbox->iTxnGenRegSize.pRegBuffer));
+ pEventMbox->EventMboxAddr[1] = pEventMbox->EventMboxAddr[0] + sizeof(EventMailBox_t);
+
+ TRACE3(pEventMbox->hReport, REPORT_SEVERITY_INIT , "eventMbox_ConfigHw: event A Address=0x%x, event B Address=0x%x, sizeof=%d\n", pEventMbox->EventMboxAddr[0], pEventMbox->EventMboxAddr[1], sizeof(EventMailBox_t));
+
+ }
+ return rc;
+}
+
+
+/*
+ * \brief Save the Event MBOX addresses
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param hTxn - Handle to TTxnStruct
+ * \return none
+ *
+ * \par Description
+ * This function is called upon completion of thr read Event MBOX address register.
+ * It save the addresses in EventMbox.
+ *
+ * \sa
+ */
+static void eventMbox_ReadAddrCb(TI_HANDLE hEventMbox, TI_HANDLE hTxn)
+{
+ TEventMbox* pEventMbox;
+
+ pEventMbox = (TEventMbox*)hEventMbox;
+
+ pEventMbox->EventMboxAddr[0] = *((TI_UINT32*)(pEventMbox->iTxnGenRegSize.pRegBuffer));
+ pEventMbox->EventMboxAddr[1] = pEventMbox->EventMboxAddr[0] + sizeof(EventMailBox_t);
+
+ TRACE3(pEventMbox->hReport, REPORT_SEVERITY_INIT , "eventMbox_ConfigHw: event A Address=0x%x, event B Address=0x%x, sizeof=%d\n", pEventMbox->EventMboxAddr[0], pEventMbox->EventMboxAddr[1], sizeof(EventMailBox_t));
+
+ /* call back the module that called us before to read our self-address */
+ pEventMbox->fCb(pEventMbox->hCb,TI_OK);
+}
+
+
+/*
+ * \brief confige the Mask vector in FW
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \return none
+ *
+ * \par Description
+ * This function is called upon exit from init it will set the mask vector.
+ * this function is mostly use for recovery
+ * Note that at Init stage the FW is already configured to have all events masked but at Recovery stage
+ * The driver whishes to just set back previous event mask configuration
+ *
+ * \sa
+ */
+void eventMbox_InitComplete(TI_HANDLE hEventMbox)
+{
+
+ TEventMbox* pEventMbox;
+ pEventMbox = (TEventMbox*)hEventMbox;
+
+ TRACE1(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, "eventMbox_InitComplete: mask = 0x%x\n", ((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask);
+
+ cmdBld_CfgEventMask(pEventMbox->hCmdBld,((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask,NULL,NULL);
+}
+
+
+
+/*
+ * \brief Register an event
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param EvID - the event ID to register
+ * \param fCb - CB function of the registered event
+ * \param hCb - CB handle of the registered event
+ * \return TI_OK,TI_NOK
+ *
+ * \par Description
+ * This function is called from the user upon request to register for event.
+ * an Event can only be register to one user.
+ * This function doesn't change the mask vector in FW!!!
+ *
+ * \sa
+ */
+TI_STATUS eventMbox_RegisterEvent(TI_HANDLE hEventMbox,TI_UINT32 EvID,void* fCb,TI_HANDLE hCb)
+{
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ if (fCb == NULL || hCb == NULL)
+ {
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_RegisterEvent : NULL parameters\n");
+ return TI_NOK;
+ }
+ if (EvID >= TWD_OWN_EVENT_ALL)
+ {
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_RegisterEvent : Event ID invalid\n");
+ return TI_NOK;
+ }
+ pEventMbox->CbTable[EvID].fCb = fCb;
+ pEventMbox->CbTable[EvID].hCb = hCb;
+ return TI_OK;
+}
+
+
+
+
+/*
+ * \brief Replace event callback
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param EvID - the event ID to register
+ * \param fNewCb - the new CB function of the registered event
+ * \param hNewCb - the new CB handle of the registered event
+ * \param pPrevCb - the old CB to save
+ * \param pPrevHndl - the old handle to save
+ * \return TI_OK,TI_NOK
+ *
+ * \par Description
+ * Replace event callback function by another one.
+ * Provide the previous CB to the caller.
+ *
+ * \sa
+ */
+TI_STATUS eventMbox_ReplaceEvent (TI_HANDLE hEventMbox,
+ TI_UINT32 EvID,
+ void *fNewCb,
+ TI_HANDLE hNewCb,
+ void **pPrevCb,
+ TI_HANDLE *pPrevHndl)
+{
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ if (fNewCb == NULL || hNewCb == NULL)
+ {
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR , "eventMbox_ReplaceEvent: NULL parameters\n");
+ return TI_NOK;
+ }
+ if (EvID >= TWD_OWN_EVENT_ALL)
+ {
+TRACE1(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_ReplaceEvent: invalid ID. ID is %d\n", EvID);
+ return TI_NOK;
+ }
+
+ /* Save the old CBs */
+ *pPrevCb = pEventMbox->CbTable[EvID].fCb;
+ *pPrevHndl = pEventMbox->CbTable[EvID].hCb;
+
+ /* store the new CBs */
+ pEventMbox->CbTable[EvID].fCb = fNewCb;
+ pEventMbox->CbTable[EvID].hCb = hNewCb;
+
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, "eventMbox_ReplaceEvent: EVENT has registered\n");
+ return TI_OK;
+}
+
+
+/*
+ * \brief Un mask an event
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param EvID - the event ID to un mask
+ * \param fCb - CB function
+ * \param hCb - CB handle
+ * \return TI_COMPLETE,TI_PENDING,TI_ERROR
+ *
+ * \par Description
+ * This function is called from the user upon request to un mask an event.
+ * This function change the mask vector in FW but doesn't register for it in the driver and
+ * doesn't set Cb function and Cb Handle in case of un mask event without registered for it an
+ * error will be handling!!!
+ *
+ * \sa
+ */
+TI_STATUS eventMbox_UnMaskEvent(TI_HANDLE hEventMbox,TI_UINT32 EvID,void* fCb,TI_HANDLE hCb)
+{
+ TI_UINT32* pEventMask;
+ TI_STATUS aStatus;
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ pEventMask = (TI_UINT32*)&((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask;
+
+ if (EvID >= TWD_OWN_EVENT_ALL)
+ {
+TRACE1(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_UnMaskEvent : Un mask an Invalid event = 0x%x\n",EvID);
+ return TXN_STATUS_ERROR;
+ }
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, "eventMbox_UnMaskEvent : EVENT is unmasked\n");
+
+ *pEventMask &= ~eventTable[EvID].bitMask;
+
+ aStatus = cmdBld_CfgEventMask (pEventMbox->hCmdBld, *pEventMask, fCb, hCb);
+ return aStatus;
+}
+
+
+/*
+ * \brief mask an event
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param EvID - the event ID to un mask
+ * \param fCb - CB function
+ * \param hCb - CB handle
+ * \return TI_COMPLETE,TI_PENDING,TI_ERROR
+ *
+ * \par Description
+ * This function is called from the user upon request to mask an event.
+ * This function change the mask vector in FW but doesn't unregister it in the driver.
+ * \sa
+ */
+TI_STATUS eventMbox_MaskEvent(TI_HANDLE hEventMbox,TI_UINT32 EvID,void* fCb,TI_HANDLE hCb)
+{
+ TI_UINT32* pEventMask;
+ TI_STATUS aStatus;
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ pEventMask = (TI_UINT32*)&((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask;
+
+ if (EvID >= TWD_OWN_EVENT_ALL)
+ {
+TRACE1(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_MaskEvent : Mask an Invalid event = 0x%x\n",EvID);
+ return TXN_STATUS_ERROR;
+ }
+
+ *pEventMask |= eventTable[EvID].bitMask;
+
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION , "eventMbox_MaskEvent : EVENT is masked\n");
+
+ aStatus = cmdBld_CfgEventMask(pEventMbox->hCmdBld,*pEventMask,fCb,hCb);
+ return aStatus;
+}
+
+
+
+/*
+ * \brief Handle the incoming event read the Mbox data
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param TFwStatus - FW status
+ * \return none
+ *
+ * \par Description
+ * This function is called from the FW Event upon receiving MBOX event.
+ * \sa
+ */
+void eventMbox_Handle(TI_HANDLE hEventMbox,FwStatus_t* pFwStatus)
+{
+ ETxnStatus rc;
+ TTxnStruct *pTxn;
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+
+ pTxn = &pEventMbox->iTxnEventMbox.tEventMbox;
+
+TRACE1(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, "eventMbox_Handle : Reading from MBOX -- %d",pEventMbox->ActiveMbox);
+
+#ifdef TI_DBG
+ /* Check if missmatch MBOX */
+ if (pEventMbox->ActiveMbox == 0)
+ {
+ if (pFwStatus->intrStatus & ACX_INTR_EVENT_B)
+ {
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_Handle : incorrect MBOX SW MBOX -- A FW MBOX -- B");
+ }
+ }
+ else if (pEventMbox->ActiveMbox == 1)
+ {
+ if (pFwStatus->intrStatus & ACX_INTR_EVENT_A)
+ {
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_Handle : incorrect MBOX SW MBOX -- B FW MBOX -- A");
+ }
+ }
+#endif /* TI_DBG */
+
+ if (pEventMbox->CurrentState != EVENT_MBOX_STATE_IDLE)
+ {
+TRACE0(pEventMbox->hReport, REPORT_SEVERITY_ERROR, "eventMbox_Handle : Receiving event not in Idle state");
+ }
+ pEventMbox->CurrentState = EVENT_MBOX_STATE_READING;
+
+ /* Build the command TxnStruct */
+ TXN_PARAM_SET(pTxn, TXN_LOW_PRIORITY, TXN_FUNC_ID_WLAN, TXN_DIRECTION_READ, TXN_INC_ADDR)
+ /* Applying a CB in case of an async read */
+ BUILD_TTxnStruct(pTxn, pEventMbox->EventMboxAddr[pEventMbox->ActiveMbox], pEventMbox->iTxnEventMbox.pEventMboxBuf, sizeof(EventMailBox_t),(TTxnDoneCb)eventMbox_ReadCompleteCB, pEventMbox)
+ rc = twIf_Transact(pEventMbox->hTwif,pTxn);
+
+ pEventMbox->ActiveMbox = 1 - pEventMbox->ActiveMbox;
+ if (rc == TXN_STATUS_COMPLETE)
+ {
+ eventMbox_ReadCompleteCB(pEventMbox,pTxn);
+ }
+}
+
+
+/*
+ * \brief Process the event
+ *
+ * \param hEventMbox - Handle to EventMbox
+ * \param pTxnStruct - the Txn data
+ * \return none
+ *
+ * \par Description
+ * This function is called from the upon reading completion of the event MBOX
+ * it will call all registered event according to the pending bits in event MBOX vector.
+ * \sa
+ */
+static void eventMbox_ReadCompleteCB(TI_HANDLE hEventMbox, TTxnStruct *pTxnStruct)
+{
+ TI_UINT32 EvID;
+ TTxnStruct* pTxn;
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ pTxn = &pEventMbox->iTxnGenRegSize.tTxnReg;
+
+TRACE1(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, "eventMbox_ReadCompleteCB : event vector -- 0x%x\n",((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsVector);
+
+ *((TI_UINT32*)(pEventMbox->iTxnGenRegSize.pRegBuffer)) = INTR_TRIG_EVENT_ACK;
+
+ for (EvID = 0; EvID < TWD_OWN_EVENT_ALL; EvID++)
+ {
+ if (((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsVector & eventTable[EvID].bitMask)
+ {
+ if (eventTable[EvID].dataLen)
+ {
+ ((TEventMboxDataCb)pEventMbox->CbTable[EvID].fCb)(pEventMbox->CbTable[EvID].hCb,(TI_CHAR*)pEventMbox->CbTable[EvID].pDataOffset,eventTable[EvID].dataLen);
+ }
+ else
+ {
+ ((TEventMboxEvCb)pEventMbox->CbTable[EvID].fCb)(pEventMbox->CbTable[EvID].hCb);
+ }
+ }
+ }
+
+ /* Check if the state is changed in the context of the event callbacks */
+ if (pEventMbox->CurrentState == EVENT_MBOX_STATE_IDLE)
+ {
+ /*
+ * When eventMbox_stop is called state is changed to IDLE
+ * This is done in the context of the above events callbacks
+ * Don't send the EVENT ACK transaction because the driver stop process includes power off
+ */
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_WARNING, "eventMbox_ReadCompleteCB : State is IDLE ! don't send the EVENT ACK");
+ return;
+ }
+
+ pEventMbox->CurrentState = EVENT_MBOX_STATE_IDLE;
+
+ /* Build the command TxnStruct */
+ TXN_PARAM_SET(pTxn, TXN_LOW_PRIORITY, TXN_FUNC_ID_WLAN, TXN_DIRECTION_WRITE, TXN_INC_ADDR)
+ /* Applying a CB in case of an async read */
+ BUILD_TTxnStruct(pTxn, ACX_REG_INTERRUPT_TRIG, pEventMbox->iTxnGenRegSize.pRegBuffer, sizeof(TI_UINT32), NULL, NULL)
+ twIf_Transact(pEventMbox->hTwif,pTxn);
+}
+
+
+#ifdef TI_DBG
+
+/*
+ * eventMbox_Print: print the Event Mailbox statistic :Number 890
+ */
+TI_STATUS eventMbox_Print (TI_HANDLE hEventMbox)
+{
+ TEventMbox *pEventMbox = (TEventMbox *)hEventMbox;
+ TI_UINT32 i;
+ TI_UINT32 EvMask = ((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsMask;
+ TI_UINT32 EvVector = ((EventMailBox_t*)(pEventMbox->iTxnEventMbox.pEventMboxBuf))->eventsVector;
+
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, "------------------------- EventMbox Print ----------------------------\n");
+
+ TRACE1(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, " eventMbox_HandleEvent: Event Vector = 0x%x\n", EvVector);
+ TRACE1(pEventMbox->hReport, REPORT_SEVERITY_INFORMATION, " eventMbox_HandleEvent: Event Mask = 0x%x\n", EvMask);
+ TRACE1(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, " Total Number Of Compound Event = %d: \n", pEventMbox->uCompounEvCount);
+ TRACE1(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, " Total Number Of Events = %d: \n", pEventMbox->uTotalEvCount);
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, "\t\t\t\t *** Event Counters *** :\n");
+ for (i = 0; i < TWD_OWN_EVENT_ALL; i++)
+ {
+ TRACE2(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, " %d) Event Name = EVENT , Number of Event = %d\n", i, pEventMbox->CbTable[i].uCount);
+ }
+
+ TRACE0(pEventMbox->hReport, REPORT_SEVERITY_CONSOLE, "------------------------- EventMbox Print End ----------------------------\n");
+
+ return TI_OK;
+}
+
+
+#endif /* TI_DBG */
+
+
+