e34dc6475a
Adding pm_notify to allow the following: 1. Check if suspend is allowed in an earlier stage to prevent starting the suspend procedure in case it is not allowed 2. Notify the platform driver on the suspend request Signed-off-by: Maya Erez <qca_merez@qca.qualcomm.com> Signed-off-by: Kalle Valo <kvalo@qca.qualcomm.com>
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__ */
|