--- /dev/null
+/*
+ * scrDbg.c
+ *
+ * Copyright(c) 1998 - 2009 Texas Instruments. All rights reserved.
+ * All rights reserved.
+ *
+ * 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 scrDbg.c
+ * \brief This file include the SCR debug module implementation
+ *
+ * \see scrDbg.h, scrApi.h
+ */
+
+
+#include "tidef.h"
+#include "scrDbg.h"
+#include "osApi.h"
+#include "report.h"
+
+#define MAX_DESC_LENGTH 50
+
+char clientDesc[ SCR_CID_NO_CLIENT + 1 ][ MAX_DESC_LENGTH ] =
+{
+ "SCR_CID_APP_SCAN",
+ "SCR_CID_DRIVER_FG_SCAN",
+ "SCR_CID_CONT_SCAN",
+ "SCR_CID_XCC_MEASURE",
+ "SCR_CID_BASIC_MEASURE",
+ "SCR_CID_CONNECT",
+ "SCR_CID_IMMED_SCAN",
+ "SCR_CID_SWITCH_CHAN",
+ "SCR_CID_NUM_OF_CLIENTS",
+ "SCR_CID_NO_CLIENT"
+};
+
+char requestStatusDesc[ 4 ][ MAX_DESC_LENGTH ] =
+{
+ "SCR_CRS_RUN",
+ "SCR_CRS_PEND",
+ "SCR_CRS_ABORT",
+ "SCR_CRS_FW_RESET"
+};
+
+char pendReasonDesc[ SCR_PR_NONE + 1 ][ MAX_DESC_LENGTH ] =
+{
+ "SCR_PR_OTHER_CLIENT_ABORTING",
+ "SCR_PR_OTHER_CLIENT_RUNNING",
+ "SCR_PR_DIFFERENT_GROUP_RUNNING",
+ "SCR_PR_NONE"
+};
+
+char groupDesc[ SCR_GID_NUM_OF_GROUPS ][ MAX_DESC_LENGTH ] =
+{
+ "SCR_GID_IDLE",
+ "SCR_GID_DRV_SCAN",
+ "SCR_GID_APP_SCAN",
+ "SCR_GID_CONNECT",
+ "SCR_GID_CONNECTED",
+ "SCR_GID_ROAMING"
+};
+
+char stateDesc[ SCR_CS_ABORTING + 1 ][ MAX_DESC_LENGTH ] =
+{
+ "SCR_CS_IDLE",
+ "SCR_CS_PENDING",
+ "SCR_CS_RUNNING",
+ "SCR_CS_ABORTING"
+};
+
+char modeDesc[ SCR_MID_NUM_OF_MODES][ MAX_DESC_LENGTH ] =
+{
+ "SCR_MID_NORMAL",
+ "SCR_MID_SG",
+};
+
+char resourceDesc[ SCR_RESOURCE_NUM_OF_RESOURCES ][ MAX_DESC_LENGTH ]=
+{
+ "SCR_RESOURCE_SERVING_CHANNEL",
+ "SCR_RESOURCE_PERIODIC_SCAN"
+};
+
+/**
+ * \\n
+ * \date 01-May-2005\n
+ * \brief Main SCR debug function
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ * \param funcType - the specific debug function.\n
+ * \param pParam - parameters for the debug function.\n
+ */
+void scrDebugFunction( TI_HANDLE hScr, TI_UINT32 funcType, void *pParam )
+{
+ switch (funcType)
+ {
+ case DBG_SCR_PRINT_HELP:
+ printScrDbgFunctions();
+ break;
+
+ case DBG_SCR_CLIENT_REQUEST_SERVING_CHANNEL:
+ requestAsClient( hScr, *((EScrClientId*)pParam), SCR_RESOURCE_SERVING_CHANNEL );
+ break;
+
+ case DBG_SCR_CLIENT_RELEASE_SERVING_CHANNEL:
+ releaseAsClient( hScr, *((EScrClientId*)pParam), SCR_RESOURCE_SERVING_CHANNEL );
+ break;
+
+ case DBG_SCR_CLIENT_REQUEST_PERIODIC_SCAN:
+ requestAsClient( hScr, *((EScrClientId*)pParam), SCR_RESOURCE_PERIODIC_SCAN );
+ break;
+
+ case DBG_SCR_CLIENT_RELEASE_PERIODIC_SCAN:
+ releaseAsClient( hScr, *((EScrClientId*)pParam), SCR_RESOURCE_PERIODIC_SCAN );
+ break;
+
+ case DBG_SCR_SET_GROUP:
+ changeGroup( hScr, *((EScrGroupId*)pParam) );
+ break;
+
+ case DBG_SCR_PRINT_OBJECT:
+ printSCRObject( hScr );
+ break;
+
+ case DBG_SCR_SET_MODE:
+ changeMode(hScr, *((EScrModeId*)pParam));
+ break;
+
+ default:
+ WLAN_OS_REPORT(("Invalid function type in SCR debug function: %d\n", funcType));
+ break;
+ }
+}
+
+/**
+ * \\n
+ * \date 01-May-2005\n
+ * \brief Prints SCR debug menu
+ *
+ * Function Scope \e Public.\n
+ */
+void printScrDbgFunctions(void)
+{
+ WLAN_OS_REPORT((" SCR Debug Functions \n"));
+ WLAN_OS_REPORT(("-------------------------\n"));
+ WLAN_OS_REPORT(("1700 - Print the SCR Debug Help\n"));
+ WLAN_OS_REPORT(("1701 <client> - Request SCR as one shot scan (set client 0-7).\n"));
+ WLAN_OS_REPORT(("1702 <client> - Release SCR as one shot scan (set client 0-7).\n"));
+ WLAN_OS_REPORT(("1703 <client> - Request SCR as periodic scan (set client 0-7).\n"));
+ WLAN_OS_REPORT(("1704 <client> - Release SCR as periodic scan (set client 0-7).\n"));
+ WLAN_OS_REPORT(("1705 - Change SCR group\n"));
+ WLAN_OS_REPORT(("1706 - Print SCR object\n"));
+ WLAN_OS_REPORT(("1707 - Change SCR mode\n"));
+}
+
+/**
+ * \\n
+ * \date 29-March-2005\n
+ * \brief Request the SCR with a given client ID.\n
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ * \param client - the client to request as.\n\
+ * \param eResource - the requested resource.\n
+ */
+void requestAsClient( TI_HANDLE hScr, EScrClientId client, EScrResourceId eResource )
+{
+ EScePendReason pendReason;
+ EScrClientRequestStatus requestStatus;
+
+ requestStatus = scr_clientRequest( hScr, client, eResource, &pendReason );
+ WLAN_OS_REPORT(("Resource %s was requested as client %s, result %s, pend reason %s\n",
+ resourceDesc[ eResource ], clientDesc[ client ], requestStatusDesc[ requestStatus ],
+ pendReasonDesc[ pendReason ]));
+}
+
+/**
+ * \\n
+ * \date 01-May-2005\n
+ * \brief Stops continuous scan process.\n
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ * \param client - the client to release as.\n
+ * \param eResource - the released resource.\n
+ */
+void releaseAsClient( TI_HANDLE hScr, EScrClientId client, EScrResourceId eResource )
+{
+ scr_clientComplete( hScr, client, eResource );
+ WLAN_OS_REPORT(("Resource %s was released as client %s\n",
+ resourceDesc[ eResource ], clientDesc[ client ]));
+}
+
+/**
+ * \\n
+ * \date 01-May-2005\n
+ * \brief Change the SCR group.\n
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ * \param group - the group to change to.\n
+ */
+void changeGroup( TI_HANDLE hScr, EScrGroupId group )
+{
+ scr_setGroup( hScr, group );
+ WLAN_OS_REPORT(("SCR group was changed to %s\n",
+ groupDesc[ group ]));
+}
+
+/**
+ * \\n
+ * \date 23-Nov-2005\n
+ * \brief Change the SCR mode.\n
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ * \param mode - the mode to change to.\n
+ */
+void changeMode( TI_HANDLE hScr, EScrModeId mode )
+{
+ scr_setMode( hScr, mode );
+ WLAN_OS_REPORT(("SCR mode was changed to %s\n",
+ modeDesc[ mode ]));
+}
+/**
+ * \\n
+ * \date 15-June-2005\n
+ * \brief Prints the SCR object.\n
+ *
+ * Function Scope \e Public.\n
+ * \param hScr - handle to the SCR object.\n
+ */
+void printSCRObject( TI_HANDLE hScr )
+{
+#ifdef REPORT_LOG
+ TScr* pScr = (TScr*)hScr;
+ int i;
+
+ WLAN_OS_REPORT( ("SCR current group:%s, mode: %s, serving channel owner:%s, periodic scan owner: %s "
+ "within request:%s\n",
+ groupDesc[ pScr->currentGroup ],modeDesc[ pScr->currentMode ],
+ clientDesc[ pScr->runningClient[ SCR_RESOURCE_SERVING_CHANNEL ] ],
+ clientDesc[ pScr->runningClient[ SCR_RESOURCE_PERIODIC_SCAN ] ],
+ (TI_TRUE == pScr->statusNotficationPending ? "Yes" : "No" )) );
+
+ WLAN_OS_REPORT( ("%-22s %-15s %-15s %-15s %-15s\n", "Client", "State (SC)", "State (PS)", "Pend Reason (SC)", "Pend Reason (PS)") );
+ WLAN_OS_REPORT( ("----------------------------------------------------------------------\n"));
+ for ( i = 0; i < SCR_CID_NUM_OF_CLIENTS; i++ )
+ {
+ WLAN_OS_REPORT( ("%-22s %-15s %-15s %-15s %-15s \n",
+ clientDesc[ i ], stateDesc[ pScr->clientArray[ i ].state[ SCR_RESOURCE_SERVING_CHANNEL ] ],
+ stateDesc[ pScr->clientArray[ i ].state[ SCR_RESOURCE_PERIODIC_SCAN ] ],
+ pendReasonDesc[ pScr->clientArray[ i ].currentPendingReason[ SCR_RESOURCE_SERVING_CHANNEL ] ],
+ pendReasonDesc[ pScr->clientArray[ i ].currentPendingReason[ SCR_RESOURCE_PERIODIC_SCAN ] ]) );
+ }
+#endif
+}