424788cfe0
The Driver Synchronization Core (DSC) is a set of synchronization primitives for use by the driver's orchestration layer. It provides APIs for ensuring safe state transitions (including bring up and tear down) of major driver objects: a single driver, associated psocs, and their associated vdevs. APIs are divided into two categories: mutual exclusion of conflicting transitions, and operation tracking, blocking, and waiting capabilities. For part 1, add common infrastructure and headers. Change-Id: Id290e66d2dccd28b89fed5f285d3692ff3c814e7 CRs-Fixed: 2290260
146 lines
4.5 KiB
C
146 lines
4.5 KiB
C
/*
|
|
* Copyright (c) 2018 The Linux Foundation. All rights reserved.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
/**
|
|
* DOC: Driver Synchronization Core (DSC) psoc-level APIs
|
|
*/
|
|
|
|
#ifndef __WLAN_DSC_PSOC_H
|
|
#define __WLAN_DSC_PSOC_H
|
|
|
|
#include "qdf_status.h"
|
|
|
|
/**
|
|
* struct dsc_psoc - opaque dsc psoc context
|
|
*/
|
|
struct dsc_psoc;
|
|
|
|
/**
|
|
* dsc_psoc_create() - create a dsc psoc context
|
|
* @driver: parent dsc driver context
|
|
* @out_psoc: opaque double pointer to assign the new context to
|
|
*
|
|
* Note: this attaches @out_psoc to @driver
|
|
*
|
|
* Return: QDF_STATUS
|
|
*/
|
|
QDF_STATUS
|
|
dsc_psoc_create(struct dsc_driver *driver, struct dsc_psoc **out_psoc);
|
|
|
|
/**
|
|
* dsc_psoc_destroy() - destroy a dsc psoc context
|
|
* @out_psoc: opaque double pointer to context to destroy and NULL
|
|
*
|
|
* Note, this:
|
|
* - detaches @out_psoc from its parent driver context
|
|
* - aborts all queued transitions on @psoc
|
|
* - asserts @psoc has no attached vdev's
|
|
* - asserts @psoc has no operations in flight
|
|
*
|
|
* Return: None
|
|
*/
|
|
void dsc_psoc_destroy(struct dsc_psoc **out_psoc);
|
|
|
|
/**
|
|
* dsc_psoc_trans_start() - start a transition on @psoc
|
|
* @psoc: the psoc to start a transition on
|
|
* @desc: a unique description of the transition to start
|
|
*
|
|
* This API immediately aborts if a transition on @psoc is already in flight
|
|
*
|
|
* Call dsc_psoc_trans_stop() to complete the transition.
|
|
*
|
|
* Return:
|
|
* QDF_STATUS_SUCCESS - transition started succcessfully
|
|
* QDF_STATUS_E_INVAL - invalid request (causes debug panic)
|
|
* QDF_STATUS_E_AGAIN - transition cannot currently be started
|
|
* QDF_STATUS_E_ALREADY - transition with @desc already in flight
|
|
*/
|
|
QDF_STATUS dsc_psoc_trans_start(struct dsc_psoc *psoc, const char *desc);
|
|
|
|
/**
|
|
* dsc_psoc_trans_start_wait() - start a transition on @psoc, blocking if a
|
|
* transition is already in flight
|
|
* @psoc: the psoc to start a transition on
|
|
* @desc: a unique description of the transition to start
|
|
*
|
|
* Call dsc_psoc_trans_stop() to complete the transition.
|
|
*
|
|
* Return:
|
|
* QDF_STATUS_SUCCESS - transition started succcessfully
|
|
* QDF_STATUS_E_INVAL - invalid request (causes debug panic)
|
|
* QDF_STATUS_E_AGAIN - transition cannot currently be started
|
|
* QDF_STATUS_E_ALREADY - transition with @desc already queued or in flight
|
|
* QDF_STATUS_E_ABORTED - transition was aborted
|
|
*/
|
|
QDF_STATUS dsc_psoc_trans_start_wait(struct dsc_psoc *psoc, const char *desc);
|
|
|
|
/**
|
|
* dsc_psoc_trans_stop() - complete current transition in flight on @psoc
|
|
* @psoc: the psoc to complete the transition on
|
|
*
|
|
* Note: this asserts a transition is currently in flight on @psoc
|
|
*
|
|
* Return: None
|
|
*/
|
|
void dsc_psoc_trans_stop(struct dsc_psoc *psoc);
|
|
|
|
/**
|
|
* dsc_psoc_trans_assert() - assert transition in flight on @psoc
|
|
* @psoc: the psoc to assert transition in flight on
|
|
*
|
|
* Return: None
|
|
*/
|
|
void dsc_psoc_trans_assert(struct dsc_psoc *psoc);
|
|
|
|
/**
|
|
* dsc_psoc_op_start() - start an operation on @psoc
|
|
* @psoc: the psoc to start an operation on
|
|
*
|
|
* Return:
|
|
* QDF_STATUS_SUCCESS - operation started succcessfully
|
|
* QDF_STATUS_E_INVAL - invalid request (causes debug panic)
|
|
* QDF_STATUS_E_AGAIN - operation cannot currently be started
|
|
* QDF_STATUS_E_NOMEM - out of memory
|
|
*/
|
|
#define dsc_psoc_op_start(psoc) _dsc_psoc_op_start(psoc, __func__)
|
|
QDF_STATUS _dsc_psoc_op_start(struct dsc_psoc *psoc, const char *func);
|
|
|
|
/**
|
|
* dsc_psoc_op_stop() - complete operation with matching @func on @psoc
|
|
* @psoc: the psoc to stop an operation on
|
|
*
|
|
* Note: this asserts @func was previously started
|
|
*
|
|
* Return: None
|
|
*/
|
|
#define dsc_psoc_op_stop(psoc) _dsc_psoc_op_stop(psoc, __func__)
|
|
void _dsc_psoc_op_stop(struct dsc_psoc *psoc, const char *func);
|
|
|
|
/**
|
|
* dsc_psoc_wait_for_ops() - blocks until all operations on @psoc have stopped
|
|
* @psoc: the psoc to wait for operations on
|
|
*
|
|
* Note: this asserts that @psoc cannot currently transition
|
|
*
|
|
* Return: None
|
|
*/
|
|
void dsc_psoc_wait_for_ops(struct dsc_psoc *psoc);
|
|
|
|
#endif /* __WLAN_DSC_PSOC_H */
|