78 lines
2.7 KiB
C
78 lines
2.7 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2014-2016 Qualcomm Atheros, Inc.
|
||
|
|
*
|
||
|
|
* Permission to use, copy, modify, and/or distribute this software for any
|
||
|
|
* purpose with or without fee is hereby granted, provided that the above
|
||
|
|
* copyright notice and this permission notice appear in all copies.
|
||
|
|
*
|
||
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
||
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
||
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef __WIL_PLATFORM_H__
|
||
|
|
#define __WIL_PLATFORM_H__
|
||
|
|
|
||
|
|
struct device;
|
||
|
|
|
||
|
|
enum wil_platform_event {
|
||
|
|
WIL_PLATFORM_EVT_FW_CRASH = 0,
|
||
|
|
WIL_PLATFORM_EVT_PRE_RESET = 1,
|
||
|
|
WIL_PLATFORM_EVT_FW_RDY = 2,
|
||
|
|
WIL_PLATFORM_EVT_PRE_SUSPEND = 3,
|
||
|
|
WIL_PLATFORM_EVT_POST_SUSPEND = 4,
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* struct wil_platform_ops - wil platform module calls from this
|
||
|
|
* driver to platform driver
|
||
|
|
*/
|
||
|
|
struct wil_platform_ops {
|
||
|
|
int (*bus_request)(void *handle, uint32_t kbps /* KBytes/Sec */);
|
||
|
|
int (*suspend)(void *handle);
|
||
|
|
int (*resume)(void *handle);
|
||
|
|
void (*uninit)(void *handle);
|
||
|
|
int (*notify)(void *handle, enum wil_platform_event evt);
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* struct wil_platform_rops - wil platform module callbacks from
|
||
|
|
* platform driver to this driver
|
||
|
|
* @ramdump: store a ramdump from the wil firmware. The platform
|
||
|
|
* driver may add additional data to the ramdump to
|
||
|
|
* generate the final crash dump.
|
||
|
|
* @fw_recovery: start a firmware recovery process. Called as
|
||
|
|
* part of a crash recovery process which may include other
|
||
|
|
* related platform subsystems.
|
||
|
|
*/
|
||
|
|
struct wil_platform_rops {
|
||
|
|
int (*ramdump)(void *wil_handle, void *buf, uint32_t size);
|
||
|
|
int (*fw_recovery)(void *wil_handle);
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* wil_platform_init - initialize the platform driver
|
||
|
|
*
|
||
|
|
* @dev - pointer to the wil6210 device
|
||
|
|
* @ops - structure with platform driver operations. Platform
|
||
|
|
* driver will fill this structure with function pointers.
|
||
|
|
* @rops - structure with callbacks from platform driver to
|
||
|
|
* this driver. The platform driver copies the structure to
|
||
|
|
* its own storage. Can be NULL if this driver does not
|
||
|
|
* support crash recovery.
|
||
|
|
* @wil_handle - context for this driver that will be passed
|
||
|
|
* when platform driver invokes one of the callbacks in
|
||
|
|
* rops. May be NULL if rops is NULL.
|
||
|
|
*/
|
||
|
|
void *wil_platform_init(struct device *dev, struct wil_platform_ops *ops,
|
||
|
|
const struct wil_platform_rops *rops, void *wil_handle);
|
||
|
|
|
||
|
|
int __init wil_platform_modinit(void);
|
||
|
|
void wil_platform_modexit(void);
|
||
|
|
|
||
|
|
#endif /* __WIL_PLATFORM_H__ */
|