/* * bcmevent read-only data shared by kernel or app layers * * Portions of this code are copyright (c) 2017 Cypress Semiconductor Corporation * * 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. * * * <> * * $Id: bcmevent.c 647135 2016-07-04 06:04:52Z $ */ #include #include #include #include #include #include #include /* 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; }