drivers/net/wireless/bcmdhd_1363/bcmevent.c - linux-imx - Git at Google

 /*
  * bcmevent read-only data shared by kernel or app layers
  *
  * Copyright (C) 1999-2017, Broadcom Corporation
  *
  *      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: bcmevent.c 647135 2016-07-04 06:04:52Z $
  */

 #include <typedefs.h>
 #include <bcmutils.h>
 #include <bcmendian.h>
 #include <proto/ethernet.h>
 #include <proto/bcmeth.h>
 #include <proto/bcmevent.h>
 #include <proto/802.11.h>

 /* Table of event name strings for UIs and debugging dumps */
 typedef struct {
 	uint event;
 	const char *name;
 } bcmevent_name_str_t;

 /* Use the actual name for event tracing */
 #define BCMEVENT_NAME(_event) {(_event), #_event}

 static const bcmevent_name_str_t bcmevent_names[] = {
 	BCMEVENT_NAME(WLC_E_SET_SSID),
 	BCMEVENT_NAME(WLC_E_JOIN),
 	BCMEVENT_NAME(WLC_E_START),
 	BCMEVENT_NAME(WLC_E_AUTH),
 	BCMEVENT_NAME(WLC_E_AUTH_IND),
 	BCMEVENT_NAME(WLC_E_DEAUTH),
 	BCMEVENT_NAME(WLC_E_DEAUTH_IND),
 	BCMEVENT_NAME(WLC_E_ASSOC),
 	BCMEVENT_NAME(WLC_E_ASSOC_IND),
 	BCMEVENT_NAME(WLC_E_REASSOC),
 	BCMEVENT_NAME(WLC_E_REASSOC_IND),
 	BCMEVENT_NAME(WLC_E_DISASSOC),
 	BCMEVENT_NAME(WLC_E_DISASSOC_IND),
 	BCMEVENT_NAME(WLC_E_QUIET_START),
 	BCMEVENT_NAME(WLC_E_QUIET_END),
 	BCMEVENT_NAME(WLC_E_BEACON_RX),
 	BCMEVENT_NAME(WLC_E_LINK),
 	BCMEVENT_NAME(WLC_E_MIC_ERROR),
 	BCMEVENT_NAME(WLC_E_NDIS_LINK),
 	BCMEVENT_NAME(WLC_E_ROAM),
 	BCMEVENT_NAME(WLC_E_TXFAIL),
 	BCMEVENT_NAME(WLC_E_PMKID_CACHE),
 	BCMEVENT_NAME(WLC_E_RETROGRADE_TSF),
 	BCMEVENT_NAME(WLC_E_PRUNE),
 	BCMEVENT_NAME(WLC_E_AUTOAUTH),
 	BCMEVENT_NAME(WLC_E_EAPOL_MSG),
 	BCMEVENT_NAME(WLC_E_SCAN_COMPLETE),
 	BCMEVENT_NAME(WLC_E_ADDTS_IND),
 	BCMEVENT_NAME(WLC_E_DELTS_IND),
 	BCMEVENT_NAME(WLC_E_BCNSENT_IND),
 	BCMEVENT_NAME(WLC_E_BCNRX_MSG),
 	BCMEVENT_NAME(WLC_E_BCNLOST_MSG),
 	BCMEVENT_NAME(WLC_E_ROAM_PREP),
 	BCMEVENT_NAME(WLC_E_PFN_NET_FOUND),
 	BCMEVENT_NAME(WLC_E_PFN_SCAN_ALLGONE),
 	BCMEVENT_NAME(WLC_E_PFN_NET_LOST),
 #if defined(IBSS_PEER_DISCOVERY_EVENT)
 	BCMEVENT_NAME(WLC_E_IBSS_ASSOC),
 #endif /* defined(IBSS_PEER_DISCOVERY_EVENT) */
 	BCMEVENT_NAME(WLC_E_RADIO),
 	BCMEVENT_NAME(WLC_E_PSM_WATCHDOG),
 	BCMEVENT_NAME(WLC_E_PROBREQ_MSG),
 	BCMEVENT_NAME(WLC_E_SCAN_CONFIRM_IND),
 	BCMEVENT_NAME(WLC_E_PSK_SUP),
 	BCMEVENT_NAME(WLC_E_COUNTRY_CODE_CHANGED),
 	BCMEVENT_NAME(WLC_E_EXCEEDED_MEDIUM_TIME),
 	BCMEVENT_NAME(WLC_E_ICV_ERROR),
 	BCMEVENT_NAME(WLC_E_UNICAST_DECODE_ERROR),
 	BCMEVENT_NAME(WLC_E_MULTICAST_DECODE_ERROR),
 	BCMEVENT_NAME(WLC_E_TRACE),
 	BCMEVENT_NAME(WLC_E_IF),
 #ifdef WLP2P
 	BCMEVENT_NAME(WLC_E_P2P_DISC_LISTEN_COMPLETE),
 #endif
 	BCMEVENT_NAME(WLC_E_RSSI),
 	BCMEVENT_NAME(WLC_E_EXTLOG_MSG),
 	BCMEVENT_NAME(WLC_E_ACTION_FRAME),
 	BCMEVENT_NAME(WLC_E_ACTION_FRAME_RX),
 	BCMEVENT_NAME(WLC_E_ACTION_FRAME_COMPLETE),
 #ifdef BCMWAPI_WAI
 	BCMEVENT_NAME(WLC_E_WAI_STA_EVENT),
 	BCMEVENT_NAME(WLC_E_WAI_MSG),
 #endif /* BCMWAPI_WAI */
 	BCMEVENT_NAME(WLC_E_ESCAN_RESULT),
 	BCMEVENT_NAME(WLC_E_ACTION_FRAME_OFF_CHAN_COMPLETE),
 #ifdef WLP2P
 	BCMEVENT_NAME(WLC_E_PROBRESP_MSG),
 	BCMEVENT_NAME(WLC_E_P2P_PROBREQ_MSG),
 #endif
 #ifdef PROP_TXSTATUS
 	BCMEVENT_NAME(WLC_E_FIFO_CREDIT_MAP),
 #endif
 	BCMEVENT_NAME(WLC_E_WAKE_EVENT),
 	BCMEVENT_NAME(WLC_E_DCS_REQUEST),
 	BCMEVENT_NAME(WLC_E_RM_COMPLETE),
 #ifdef WLMEDIA_HTSF
 	BCMEVENT_NAME(WLC_E_HTSFSYNC),
 #endif
 	BCMEVENT_NAME(WLC_E_OVERLAY_REQ),
 	BCMEVENT_NAME(WLC_E_CSA_COMPLETE_IND),
 	BCMEVENT_NAME(WLC_E_EXCESS_PM_WAKE_EVENT),
 	BCMEVENT_NAME(WLC_E_PFN_SCAN_NONE),
 	BCMEVENT_NAME(WLC_E_PFN_SCAN_ALLGONE),
 #ifdef SOFTAP
 	BCMEVENT_NAME(WLC_E_GTK_PLUMBED),
 #endif
 	BCMEVENT_NAME(WLC_E_ASSOC_REQ_IE),
 	BCMEVENT_NAME(WLC_E_ASSOC_RESP_IE),
 	BCMEVENT_NAME(WLC_E_BEACON_FRAME_RX),
 #ifdef WLTDLS
 	BCMEVENT_NAME(WLC_E_TDLS_PEER_EVENT),
 #endif /* WLTDLS */
 	BCMEVENT_NAME(WLC_E_NATIVE),
 #ifdef WLPKTDLYSTAT
 	BCMEVENT_NAME(WLC_E_PKTDELAY_IND),
 #endif /* WLPKTDLYSTAT */
 	BCMEVENT_NAME(WLC_E_SERVICE_FOUND),
 	BCMEVENT_NAME(WLC_E_GAS_FRAGMENT_RX),
 	BCMEVENT_NAME(WLC_E_GAS_COMPLETE),
 	BCMEVENT_NAME(WLC_E_P2PO_ADD_DEVICE),
 	BCMEVENT_NAME(WLC_E_P2PO_DEL_DEVICE),
 #ifdef WLWNM
 	BCMEVENT_NAME(WLC_E_WNM_STA_SLEEP),
 #endif /* WLWNM */
 #if defined(WL_PROXDETECT)
 	BCMEVENT_NAME(WLC_E_PROXD),
 #endif
 	BCMEVENT_NAME(WLC_E_CCA_CHAN_QUAL),
 	BCMEVENT_NAME(WLC_E_BSSID),
 #ifdef PROP_TXSTATUS
 	BCMEVENT_NAME(WLC_E_BCMC_CREDIT_SUPPORT),
 #endif
 	BCMEVENT_NAME(WLC_E_PSTA_PRIMARY_INTF_IND),
 	BCMEVENT_NAME(WLC_E_TXFAIL_THRESH),
 #ifdef GSCAN_SUPPORT
 	BCMEVENT_NAME(WLC_E_PFN_GSCAN_FULL_RESULT),
 	BCMEVENT_NAME(WLC_E_PFN_SWC),
 #endif /* GSCAN_SUPPORT */
 #ifdef WLBSSLOAD_REPORT
 	BCMEVENT_NAME(WLC_E_BSS_LOAD),
 #endif
 #if defined(BT_WIFI_HANDOVER) || defined(WL_TBOW)
 	BCMEVENT_NAME(WLC_E_BT_WIFI_HANDOVER_REQ),
 #endif
 	BCMEVENT_NAME(WLC_E_AUTHORIZED),
 	BCMEVENT_NAME(WLC_E_PROBREQ_MSG_RX),
 	BCMEVENT_NAME(WLC_E_CSA_START_IND),
 	BCMEVENT_NAME(WLC_E_CSA_DONE_IND),
 	BCMEVENT_NAME(WLC_E_CSA_FAILURE_IND),
 	BCMEVENT_NAME(WLC_E_RMC_EVENT),
 	BCMEVENT_NAME(WLC_E_DPSTA_INTF_IND),
 	BCMEVENT_NAME(WLC_E_SDB_TRANSITION),
 };


 const char *bcmevent_get_name(uint event_type)
 {
 	/* note:  first coded this as a static const but some
 	 * ROMs already have something called event_name so
 	 * changed it so we don't have a variable for the
 	 * 'unknown string
 	 */
 	const char *event_name = NULL;

 	uint idx;
 	for (idx = 0; idx < (uint)ARRAYSIZE(bcmevent_names); idx++) {

 		if (bcmevent_names[idx].event == event_type) {
 			event_name = bcmevent_names[idx].name;
 			break;
 		}
 	}

 	/* if we find an event name in the array, return it.
 	 * otherwise return unknown string.
 	 */
 	return ((event_name) ? event_name : "Unknown Event");
 }

 void
 wl_event_to_host_order(wl_event_msg_t * evt)
 {
 	/* Event struct members passed from dongle to host are stored in network
 	* byte order. Convert all members to host-order.
 	*/
 	evt->event_type = ntoh32(evt->event_type);
 	evt->flags = ntoh16(evt->flags);
 	evt->status = ntoh32(evt->status);
 	evt->reason = ntoh32(evt->reason);
 	evt->auth_type = ntoh32(evt->auth_type);
 	evt->datalen = ntoh32(evt->datalen);
 	evt->version = ntoh16(evt->version);
 }

 void
 wl_event_to_network_order(wl_event_msg_t * evt)
 {
 	/* Event struct members passed from dongle to host are stored in network
 	* byte order. Convert all members to host-order.
 	*/
 	evt->event_type = hton32(evt->event_type);
 	evt->flags = hton16(evt->flags);
 	evt->status = hton32(evt->status);
 	evt->reason = hton32(evt->reason);
 	evt->auth_type = hton32(evt->auth_type);
 	evt->datalen = hton32(evt->datalen);
 	evt->version = hton16(evt->version);
 }

 /*
  * Validate if the event is proper and if valid copy event header to event.
  * If proper event pointer is passed, to just validate, pass NULL to event.
  *
  * Return values are
  *	BCME_OK - It is a BRCM event or BRCM dongle event
  *	BCME_NOTFOUND - Not BRCM, not an event, may be okay
  *	BCME_BADLEN - Bad length, should not process, just drop
  */
 int
 is_wlc_event_frame(void *pktdata, uint pktlen, uint16 exp_usr_subtype,
 	bcm_event_msg_u_t *out_event)
 {
 	uint16 len;
 	uint16 subtype;
 	uint16 usr_subtype;
 	bcm_event_t *bcm_event;
 	uint8 *pktend;
 	int err = BCME_OK;

 	pktend = (uint8 *)pktdata + pktlen;
 	bcm_event = (bcm_event_t *)pktdata;

 	/* only care about 16-bit subtype / length versions */
 	if ((uint8 *)&bcm_event->bcm_hdr < pktend) {
 		uint8 short_subtype = *(uint8 *)&bcm_event->bcm_hdr;
 		if (!(short_subtype & 0x80)) {
 			err = BCME_NOTFOUND;
 			goto done;
 		}
 	}

 	/* must have both ether_header and bcmeth_hdr */
 	if (pktlen < OFFSETOF(bcm_event_t, event)) {
 		err = BCME_BADLEN;
 		goto done;
 	}

 	/* check length in bcmeth_hdr */
 	len = ntoh16_ua((void *)&bcm_event->bcm_hdr.length);

 	/* match on subtype, oui and usr subtype for BRCM events */
 	subtype = ntoh16_ua((void *)&bcm_event->bcm_hdr.subtype);
 	if (subtype != BCMILCP_SUBTYPE_VENDOR_LONG) {
 		err = BCME_NOTFOUND;
 		goto done;
 	}

 	if (bcmp(BRCM_OUI, &bcm_event->bcm_hdr.oui[0], DOT11_OUI_LEN)) {
 		err = BCME_NOTFOUND;
 		goto done;
 	}

 	/* if it is a bcm_event or bcm_dngl_event_t, validate it */
 	usr_subtype = ntoh16_ua((void *)&bcm_event->bcm_hdr.usr_subtype);
 	switch (usr_subtype) {
 	case BCMILCP_BCM_SUBTYPE_EVENT:
 		if (pktlen < sizeof(bcm_event_t)) {
 			err = BCME_BADLEN;
 			goto done;
 		}

 		len = (uint16)sizeof(bcm_event_t) +
 			(uint16)ntoh32_ua((void *)&bcm_event->event.datalen);
 		if ((uint8 *)pktdata + len > pktend) {
 			err = BCME_BADLEN;
 			goto done;
 		}

 		if (exp_usr_subtype && (exp_usr_subtype != usr_subtype)) {
 			err = BCME_NOTFOUND;
 			goto done;
 		}

 		if (out_event) {
 			/* ensure BRCM event pkt aligned */
 			memcpy(&out_event->event, &bcm_event->event, sizeof(wl_event_msg_t));
 		}

 		break;

 	case BCMILCP_BCM_SUBTYPE_DNGLEVENT:
 #if defined(HEALTH_CHECK) || defined(DNGL_EVENT_SUPPORT)
 		if (pktlen < sizeof(bcm_dngl_event_t)) {
 			err = BCME_BADLEN;
 			goto done;
 		}

 		len = sizeof(bcm_dngl_event_t) +
 			ntoh16_ua((void *)&((bcm_dngl_event_t *)pktdata)->dngl_event.datalen);
 		if ((uint8 *)pktdata + len > pktend) {
 			err = BCME_BADLEN;
 			goto done;
 		}

 		if (exp_usr_subtype && (exp_usr_subtype != usr_subtype)) {
 			err = BCME_NOTFOUND;
 			goto done;
 		}

 		if (out_event) {
 			/* ensure BRCM dngl event pkt aligned */
 			memcpy(&out_event->dngl_event, &((bcm_dngl_event_t *)pktdata)->dngl_event,
 				sizeof(bcm_dngl_event_msg_t));
 		}

 		break;
 #else
 		err = BCME_UNSUPPORTED;
 		break;
 #endif /* HEALTH_CHECK || DNGL_EVENT_SUPPORT */

 	default:
 		err = BCME_NOTFOUND;
 		goto done;
 	}

 done:
 	return err;
 }
	/*
	* bcmevent read-only data shared by kernel or app layers
	*
	* Copyright (C) 1999-2017, Broadcom Corporation
	*
	* 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: bcmevent.c 647135 2016-07-04 06:04:52Z $
	*/

	#include <typedefs.h>
	#include <bcmutils.h>
	#include <bcmendian.h>
	#include <proto/ethernet.h>
	#include <proto/bcmeth.h>
	#include <proto/bcmevent.h>
	#include <proto/802.11.h>

	/* Table of event name strings for UIs and debugging dumps */
	typedef struct {
	uint event;
	const char *name;
	} bcmevent_name_str_t;

	/* Use the actual name for event tracing */
	#define BCMEVENT_NAME(_event) {(_event), #_event}

	static const bcmevent_name_str_t bcmevent_names[] = {
	BCMEVENT_NAME(WLC_E_SET_SSID),
	BCMEVENT_NAME(WLC_E_JOIN),
	BCMEVENT_NAME(WLC_E_START),
	BCMEVENT_NAME(WLC_E_AUTH),
	BCMEVENT_NAME(WLC_E_AUTH_IND),
	BCMEVENT_NAME(WLC_E_DEAUTH),
	BCMEVENT_NAME(WLC_E_DEAUTH_IND),
	BCMEVENT_NAME(WLC_E_ASSOC),
	BCMEVENT_NAME(WLC_E_ASSOC_IND),
	BCMEVENT_NAME(WLC_E_REASSOC),
	BCMEVENT_NAME(WLC_E_REASSOC_IND),
	BCMEVENT_NAME(WLC_E_DISASSOC),
	BCMEVENT_NAME(WLC_E_DISASSOC_IND),
	BCMEVENT_NAME(WLC_E_QUIET_START),
	BCMEVENT_NAME(WLC_E_QUIET_END),
	BCMEVENT_NAME(WLC_E_BEACON_RX),
	BCMEVENT_NAME(WLC_E_LINK),
	BCMEVENT_NAME(WLC_E_MIC_ERROR),
	BCMEVENT_NAME(WLC_E_NDIS_LINK),
	BCMEVENT_NAME(WLC_E_ROAM),
	BCMEVENT_NAME(WLC_E_TXFAIL),
	BCMEVENT_NAME(WLC_E_PMKID_CACHE),
	BCMEVENT_NAME(WLC_E_RETROGRADE_TSF),
	BCMEVENT_NAME(WLC_E_PRUNE),
	BCMEVENT_NAME(WLC_E_AUTOAUTH),
	BCMEVENT_NAME(WLC_E_EAPOL_MSG),
	BCMEVENT_NAME(WLC_E_SCAN_COMPLETE),
	BCMEVENT_NAME(WLC_E_ADDTS_IND),
	BCMEVENT_NAME(WLC_E_DELTS_IND),
	BCMEVENT_NAME(WLC_E_BCNSENT_IND),
	BCMEVENT_NAME(WLC_E_BCNRX_MSG),
	BCMEVENT_NAME(WLC_E_BCNLOST_MSG),
	BCMEVENT_NAME(WLC_E_ROAM_PREP),
	BCMEVENT_NAME(WLC_E_PFN_NET_FOUND),
	BCMEVENT_NAME(WLC_E_PFN_SCAN_ALLGONE),
	BCMEVENT_NAME(WLC_E_PFN_NET_LOST),
	#if defined(IBSS_PEER_DISCOVERY_EVENT)
	BCMEVENT_NAME(WLC_E_IBSS_ASSOC),
	#endif /* defined(IBSS_PEER_DISCOVERY_EVENT) */
	BCMEVENT_NAME(WLC_E_RADIO),
	BCMEVENT_NAME(WLC_E_PSM_WATCHDOG),
	BCMEVENT_NAME(WLC_E_PROBREQ_MSG),
	BCMEVENT_NAME(WLC_E_SCAN_CONFIRM_IND),
	BCMEVENT_NAME(WLC_E_PSK_SUP),
	BCMEVENT_NAME(WLC_E_COUNTRY_CODE_CHANGED),
	BCMEVENT_NAME(WLC_E_EXCEEDED_MEDIUM_TIME),
	BCMEVENT_NAME(WLC_E_ICV_ERROR),
	BCMEVENT_NAME(WLC_E_UNICAST_DECODE_ERROR),
	BCMEVENT_NAME(WLC_E_MULTICAST_DECODE_ERROR),
	BCMEVENT_NAME(WLC_E_TRACE),
	BCMEVENT_NAME(WLC_E_IF),
	#ifdef WLP2P
	BCMEVENT_NAME(WLC_E_P2P_DISC_LISTEN_COMPLETE),
	#endif
	BCMEVENT_NAME(WLC_E_RSSI),
	BCMEVENT_NAME(WLC_E_EXTLOG_MSG),
	BCMEVENT_NAME(WLC_E_ACTION_FRAME),
	BCMEVENT_NAME(WLC_E_ACTION_FRAME_RX),
	BCMEVENT_NAME(WLC_E_ACTION_FRAME_COMPLETE),
	#ifdef BCMWAPI_WAI
	BCMEVENT_NAME(WLC_E_WAI_STA_EVENT),
	BCMEVENT_NAME(WLC_E_WAI_MSG),
	#endif /* BCMWAPI_WAI */
	BCMEVENT_NAME(WLC_E_ESCAN_RESULT),
	BCMEVENT_NAME(WLC_E_ACTION_FRAME_OFF_CHAN_COMPLETE),
	#ifdef WLP2P
	BCMEVENT_NAME(WLC_E_PROBRESP_MSG),
	BCMEVENT_NAME(WLC_E_P2P_PROBREQ_MSG),
	#endif
	#ifdef PROP_TXSTATUS
	BCMEVENT_NAME(WLC_E_FIFO_CREDIT_MAP),
	#endif
	BCMEVENT_NAME(WLC_E_WAKE_EVENT),
	BCMEVENT_NAME(WLC_E_DCS_REQUEST),
	BCMEVENT_NAME(WLC_E_RM_COMPLETE),
	#ifdef WLMEDIA_HTSF
	BCMEVENT_NAME(WLC_E_HTSFSYNC),
	#endif
	BCMEVENT_NAME(WLC_E_OVERLAY_REQ),
	BCMEVENT_NAME(WLC_E_CSA_COMPLETE_IND),
	BCMEVENT_NAME(WLC_E_EXCESS_PM_WAKE_EVENT),
	BCMEVENT_NAME(WLC_E_PFN_SCAN_NONE),
	BCMEVENT_NAME(WLC_E_PFN_SCAN_ALLGONE),
	#ifdef SOFTAP
	BCMEVENT_NAME(WLC_E_GTK_PLUMBED),
	#endif
	BCMEVENT_NAME(WLC_E_ASSOC_REQ_IE),
	BCMEVENT_NAME(WLC_E_ASSOC_RESP_IE),
	BCMEVENT_NAME(WLC_E_BEACON_FRAME_RX),
	#ifdef WLTDLS
	BCMEVENT_NAME(WLC_E_TDLS_PEER_EVENT),
	#endif /* WLTDLS */
	BCMEVENT_NAME(WLC_E_NATIVE),
	#ifdef WLPKTDLYSTAT
	BCMEVENT_NAME(WLC_E_PKTDELAY_IND),
	#endif /* WLPKTDLYSTAT */
	BCMEVENT_NAME(WLC_E_SERVICE_FOUND),
	BCMEVENT_NAME(WLC_E_GAS_FRAGMENT_RX),
	BCMEVENT_NAME(WLC_E_GAS_COMPLETE),
	BCMEVENT_NAME(WLC_E_P2PO_ADD_DEVICE),
	BCMEVENT_NAME(WLC_E_P2PO_DEL_DEVICE),
	#ifdef WLWNM
	BCMEVENT_NAME(WLC_E_WNM_STA_SLEEP),
	#endif /* WLWNM */
	#if defined(WL_PROXDETECT)
	BCMEVENT_NAME(WLC_E_PROXD),
	#endif
	BCMEVENT_NAME(WLC_E_CCA_CHAN_QUAL),
	BCMEVENT_NAME(WLC_E_BSSID),
	#ifdef PROP_TXSTATUS
	BCMEVENT_NAME(WLC_E_BCMC_CREDIT_SUPPORT),
	#endif
	BCMEVENT_NAME(WLC_E_PSTA_PRIMARY_INTF_IND),
	BCMEVENT_NAME(WLC_E_TXFAIL_THRESH),
	#ifdef GSCAN_SUPPORT
	BCMEVENT_NAME(WLC_E_PFN_GSCAN_FULL_RESULT),
	BCMEVENT_NAME(WLC_E_PFN_SWC),
	#endif /* GSCAN_SUPPORT */
	#ifdef WLBSSLOAD_REPORT
	BCMEVENT_NAME(WLC_E_BSS_LOAD),
	#endif
	#if defined(BT_WIFI_HANDOVER) \|\| defined(WL_TBOW)
	BCMEVENT_NAME(WLC_E_BT_WIFI_HANDOVER_REQ),
	#endif
	BCMEVENT_NAME(WLC_E_AUTHORIZED),
	BCMEVENT_NAME(WLC_E_PROBREQ_MSG_RX),
	BCMEVENT_NAME(WLC_E_CSA_START_IND),
	BCMEVENT_NAME(WLC_E_CSA_DONE_IND),
	BCMEVENT_NAME(WLC_E_CSA_FAILURE_IND),
	BCMEVENT_NAME(WLC_E_RMC_EVENT),
	BCMEVENT_NAME(WLC_E_DPSTA_INTF_IND),
	BCMEVENT_NAME(WLC_E_SDB_TRANSITION),
	};


	const char *bcmevent_get_name(uint event_type)
	{
	/* note: first coded this as a static const but some
	* ROMs already have something called event_name so
	* changed it so we don't have a variable for the
	* 'unknown string
	*/
	const char *event_name = NULL;

	uint idx;
	for (idx = 0; idx < (uint)ARRAYSIZE(bcmevent_names); idx++) {

	if (bcmevent_names[idx].event == event_type) {
	event_name = bcmevent_names[idx].name;
	break;
	}
	}

	/* if we find an event name in the array, return it.
	* otherwise return unknown string.
	*/
	return ((event_name) ? event_name : "Unknown Event");
	}

	void
	wl_event_to_host_order(wl_event_msg_t * evt)
	{
	/* Event struct members passed from dongle to host are stored in network
	* byte order. Convert all members to host-order.
	*/
	evt->event_type = ntoh32(evt->event_type);
	evt->flags = ntoh16(evt->flags);
	evt->status = ntoh32(evt->status);
	evt->reason = ntoh32(evt->reason);
	evt->auth_type = ntoh32(evt->auth_type);
	evt->datalen = ntoh32(evt->datalen);
	evt->version = ntoh16(evt->version);
	}

	void
	wl_event_to_network_order(wl_event_msg_t * evt)
	{
	/* Event struct members passed from dongle to host are stored in network
	* byte order. Convert all members to host-order.
	*/
	evt->event_type = hton32(evt->event_type);
	evt->flags = hton16(evt->flags);
	evt->status = hton32(evt->status);
	evt->reason = hton32(evt->reason);
	evt->auth_type = hton32(evt->auth_type);
	evt->datalen = hton32(evt->datalen);
	evt->version = hton16(evt->version);
	}

	/*
	* Validate if the event is proper and if valid copy event header to event.
	* If proper event pointer is passed, to just validate, pass NULL to event.
	*
	* Return values are
	* BCME_OK - It is a BRCM event or BRCM dongle event
	* BCME_NOTFOUND - Not BRCM, not an event, may be okay
	* BCME_BADLEN - Bad length, should not process, just drop
	*/
	int
	is_wlc_event_frame(void *pktdata, uint pktlen, uint16 exp_usr_subtype,
	bcm_event_msg_u_t *out_event)
	{
	uint16 len;
	uint16 subtype;
	uint16 usr_subtype;
	bcm_event_t *bcm_event;
	uint8 *pktend;
	int err = BCME_OK;

	pktend = (uint8 *)pktdata + pktlen;
	bcm_event = (bcm_event_t *)pktdata;

	/* only care about 16-bit subtype / length versions */
	if ((uint8 *)&bcm_event->bcm_hdr < pktend) {
	uint8 short_subtype = (uint8 )&bcm_event->bcm_hdr;
	if (!(short_subtype & 0x80)) {
	err = BCME_NOTFOUND;
	goto done;
	}
	}

	/* must have both ether_header and bcmeth_hdr */
	if (pktlen < OFFSETOF(bcm_event_t, event)) {
	err = BCME_BADLEN;
	goto done;
	}

	/* check length in bcmeth_hdr */
	len = ntoh16_ua((void *)&bcm_event->bcm_hdr.length);

	/* match on subtype, oui and usr subtype for BRCM events */
	subtype = ntoh16_ua((void *)&bcm_event->bcm_hdr.subtype);
	if (subtype != BCMILCP_SUBTYPE_VENDOR_LONG) {
	err = BCME_NOTFOUND;
	goto done;
	}

	if (bcmp(BRCM_OUI, &bcm_event->bcm_hdr.oui[0], DOT11_OUI_LEN)) {
	err = BCME_NOTFOUND;
	goto done;
	}

	/* if it is a bcm_event or bcm_dngl_event_t, validate it */
	usr_subtype = ntoh16_ua((void *)&bcm_event->bcm_hdr.usr_subtype);
	switch (usr_subtype) {
	case BCMILCP_BCM_SUBTYPE_EVENT:
	if (pktlen < sizeof(bcm_event_t)) {
	err = BCME_BADLEN;
	goto done;
	}

	len = (uint16)sizeof(bcm_event_t) +
	(uint16)ntoh32_ua((void *)&bcm_event->event.datalen);
	if ((uint8 *)pktdata + len > pktend) {
	err = BCME_BADLEN;
	goto done;
	}

	if (exp_usr_subtype && (exp_usr_subtype != usr_subtype)) {
	err = BCME_NOTFOUND;
	goto done;
	}

	if (out_event) {
	/* ensure BRCM event pkt aligned */
	memcpy(&out_event->event, &bcm_event->event, sizeof(wl_event_msg_t));
	}

	break;

	case BCMILCP_BCM_SUBTYPE_DNGLEVENT:
	#if defined(HEALTH_CHECK) \|\| defined(DNGL_EVENT_SUPPORT)
	if (pktlen < sizeof(bcm_dngl_event_t)) {
	err = BCME_BADLEN;
	goto done;
	}

	len = sizeof(bcm_dngl_event_t) +
	ntoh16_ua((void )&((bcm_dngl_event_t )pktdata)->dngl_event.datalen);
	if ((uint8 *)pktdata + len > pktend) {
	err = BCME_BADLEN;
	goto done;
	}

	if (exp_usr_subtype && (exp_usr_subtype != usr_subtype)) {
	err = BCME_NOTFOUND;
	goto done;
	}

	if (out_event) {
	/* ensure BRCM dngl event pkt aligned */
	memcpy(&out_event->dngl_event, &((bcm_dngl_event_t *)pktdata)->dngl_event,
	sizeof(bcm_dngl_event_msg_t));
	}

	break;
	#else
	err = BCME_UNSUPPORTED;
	break;
	#endif /* HEALTH_CHECK \|\| DNGL_EVENT_SUPPORT */

	default:
	err = BCME_NOTFOUND;
	goto done;
	}

	done:
	return err;
	}