vsf_usbh_wifi_rt2x00.h

Go to the documentation of this file.

/*****************************************************************************
 *   Copyright(C)2009-2022 by VSF Team                                       *
 *                                                                           *
 *  Licensed under the Apache License, Version 2.0 (the "License");          *
 *  you may not use this file except in compliance with the License.         *
 *  You may obtain a copy of the License at                                  *
 *                                                                           *
 *     http://www.apache.org/licenses/LICENSE-2.0                            *
 *                                                                           *
 *  Unless required by applicable law or agreed to in writing, software      *
 *  distributed under the License is distributed on an "AS IS" BASIS,        *
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 *  See the License for the specific language governing permissions and      *
 *  limitations under the License.                                           *
 *                                                                           *
 ****************************************************************************/
 
#ifndef __VSF_USBH_WIFI_RT2X00_H__
#define __VSF_USBH_WIFI_RT2X00_H__
 
/*============================ INCLUDES ======================================*/
#include "component/usb/vsf_usb_cfg.h"
 
#if VSF_USE_USB_HOST == ENABLED && VSF_USBH_USE_RT2X00 == ENABLED
 
#include "component/wifi/vsf_wifi.h"
 
#if VSF_USE_WIFI == ENABLED
 
/*============================ LOGGING HELPERS ===============================*/
 
#if VSF_WIFI_CFG_BUS_RT2X00_LOG_LEVEL >= 1
#   define vsf_wifi_bus_rt2x00_trace_error(...)    vsf_trace_error(__VA_ARGS__)
#else
#   define vsf_wifi_bus_rt2x00_trace_error(...)    ((void)0)
#endif
 
#if VSF_WIFI_CFG_BUS_RT2X00_LOG_LEVEL >= 2
#   define vsf_wifi_bus_rt2x00_trace_info(...)     vsf_trace_info(__VA_ARGS__)
#else
#   define vsf_wifi_bus_rt2x00_trace_info(...)     ((void)0)
#endif
 
#if VSF_WIFI_CFG_BUS_RT2X00_LOG_LEVEL >= 4
#   define vsf_wifi_bus_rt2x00_trace_debug(...)    vsf_trace_info(__VA_ARGS__)
#else
#   define vsf_wifi_bus_rt2x00_trace_debug(...)    ((void)0)
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*============================ MACROS ========================================*/
 
/* Backward-compatibility type aliases — old code using vk_usbh_wifi_*_t
 * names continues to compile without modification. */
typedef vsf_wifi_scan_result_t   vk_usbh_wifi_scan_result_t;
typedef vsf_wifi_link_info_t     vk_usbh_wifi_link_info_t;
typedef vsf_wifi_auth_cfg_t      vk_usbh_wifi_auth_cfg_t;
 
/*============================ TYPES =========================================*/
 
typedef struct vk_usbh_wifi_t    vk_usbh_wifi_t;
 
/*============================ GLOBAL VARIABLES ==============================*/
 
extern const vk_usbh_class_drv_t vk_usbh_wifi_drv;
 
/*============================ USB-SPECIFIC API ==============================*/
 
/* TX path — USB-specific because it ships frames via bulk OUT endpoints.
 * Other buses (SDIO) would have their own send API. */
vsf_err_t    vk_usbh_wifi_send(void *dev, uint8_t *frame, uint16_t len);
bool         vk_usbh_wifi_can_send(void *dev);
 
/* Retrieve the embedded generic wifi handle from the USB wifi device. */
vsf_wifi_t * vk_usbh_wifi_get_wifi(void *dev);
 
#ifdef __cplusplus
}
#endif
 
#endif      // VSF_USE_WIFI
#endif      // VSF_USE_USB_HOST && VSF_USBH_USE_RT2X00
#endif      // __VSF_USBH_WIFI_RT2X00_H__