/**************************************************************************** * drivers/wireless/ieee80211/bcm43xxx/bcmf_driver.h * * Copyright (C) 2017 Gregory Nutt. All rights reserved. * Author: Simon Piriou * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. 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. * 3. Neither the name NuttX 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. * ****************************************************************************/ #ifndef __DRIVERS_WIRELESS_IEEE80211_BCMF_DRIVER_H #define __DRIVERS_WIRELESS_IEEE80211_BCMF_DRIVER_H /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include "bcmf_ioctl.h" struct bcmf_dev_s; struct bcmf_frame_s; #include "bcmf_bdc.h" struct bcmf_bus_dev_s; /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* Chip interfaces */ #define CHIP_STA_INTERFACE 0 #define CHIP_AP_INTERFACE 1 #define CHIP_P2P_INTERFACE 2 /**************************************************************************** * Public Types ****************************************************************************/ /* This structure contains the unique state of the Broadcom FullMAC driver */ struct bcmf_dev_s { FAR struct bcmf_bus_dev_s *bus; /* Bus interface structure */ bool bc_bifup; /* true:ifup false:ifdown */ struct wdog_s bc_txpoll; /* TX poll timer */ struct work_s bc_irqwork; /* For deferring interrupt work to the work queue */ struct work_s bc_pollwork; /* For deferring poll work to the work queue */ /* This holds the information visible to the NuttX network */ struct net_driver_s bc_dev; /* Network interface structure */ struct bcmf_frame_s *cur_tx_frame; /* Frame used to interface network layer */ /* Event registration array */ event_handler_t event_handlers[BCMF_EVENT_COUNT]; sem_t control_mutex; /* Cannot handle multiple control requests */ sem_t control_timeout; /* Semaphore to wait for control frame rsp */ uint16_t control_reqid; /* Current control request id */ uint16_t control_rxdata_len; /* Received control frame out buffer length */ uint8_t *control_rxdata; /* Received control frame out buffer */ uint32_t control_status; /* Last received frame status */ /* AP Scan state machine. * During scan, control_mutex is locked to prevent control requests */ int scan_status; /* Current scan status */ struct wdog_s scan_timeout; /* Scan timeout timer */ FAR uint8_t *scan_result; /* Temp buffer that holds results */ unsigned int scan_result_size; /* Current size of temp buffer */ sem_t auth_signal; /* Authentication notification signal */ int auth_status; /* Authentication status */ }; /* Default bus interface structure */ struct bcmf_bus_dev_s { void (*stop)(FAR struct bcmf_dev_s *priv); int (*txframe)(FAR struct bcmf_dev_s *priv, struct bcmf_frame_s *frame, bool control); struct bcmf_frame_s *(*rxframe)(FAR struct bcmf_dev_s *priv); /* Frame buffer allocation primitives * len - requested payload length * control - true if control frame else false * block - true to block until free frame is available */ struct bcmf_frame_s *(*allocate_frame)(FAR struct bcmf_dev_s *priv, unsigned int len, bool block, bool control); void (*free_frame)(FAR struct bcmf_dev_s *priv, FAR struct bcmf_frame_s *frame); }; /* bcmf frame definition */ struct bcmf_frame_s { uint8_t *base; /* Frame base buffer used by low level layer (SDIO) */ uint8_t *data; /* Payload data (Control, data and event messages) */ uint16_t len; /* Frame buffer size */ }; /**************************************************************************** * Public Function Prototypes ****************************************************************************/ /* IOCTLs network interface implementation */ int bcmf_wl_set_mac_address(FAR struct bcmf_dev_s *priv, struct ifreq *req); int bcmf_wl_enable(FAR struct bcmf_dev_s *priv, bool enable); /* IOCTLs AP scan interface implementation */ int bcmf_wl_start_scan(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); int bcmf_wl_get_scan_results(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); /* IOCTLs authentication interface implementation */ int bcmf_wl_set_auth_param(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); int bcmf_wl_set_encode_ext(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); int bcmf_wl_set_mode(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); int bcmf_wl_set_ssid(FAR struct bcmf_dev_s *priv, struct iwreq *iwr); #endif /* __DRIVERS_WIRELESS_IEEE80211_BCMF_DRIVER_H */