| /* |
| * 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 |
| } |
