120 lines
4.3 KiB
C
120 lines
4.3 KiB
C
/*
|
|
* Copyright 2015 Advanced Micro Devices, Inc.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
|
|
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
|
|
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|
* OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
*
|
|
*/
|
|
#ifndef _CGS_LINUX_H
|
|
#define _CGS_LINUX_H
|
|
|
|
#include "cgs_common.h"
|
|
|
|
/**
|
|
* cgs_irq_source_set_func() - Callback for enabling/disabling interrupt sources
|
|
* @private_data: private data provided to cgs_add_irq_source
|
|
* @src_id: interrupt source ID
|
|
* @type: interrupt type
|
|
* @enabled: 0 = disable source, non-0 = enable source
|
|
*
|
|
* Return: 0 on success, -errno otherwise
|
|
*/
|
|
typedef int (*cgs_irq_source_set_func_t)(void *private_data,
|
|
unsigned src_id, unsigned type,
|
|
int enabled);
|
|
|
|
/**
|
|
* cgs_irq_handler_func() - Interrupt handler callback
|
|
* @private_data: private data provided to cgs_add_irq_source
|
|
* @src_id: interrupt source ID
|
|
* @iv_entry: pointer to raw ih ring entry
|
|
*
|
|
* This callback runs in interrupt context.
|
|
*
|
|
* Return: 0 on success, -errno otherwise
|
|
*/
|
|
typedef int (*cgs_irq_handler_func_t)(void *private_data,
|
|
unsigned src_id, const uint32_t *iv_entry);
|
|
|
|
/**
|
|
* cgs_add_irq_source() - Add an IRQ source
|
|
* @cgs_device: opaque device handle
|
|
* @src_id: interrupt source ID
|
|
* @num_types: number of interrupt types that can be independently enabled
|
|
* @set: callback function to enable/disable an interrupt type
|
|
* @handler: interrupt handler callback
|
|
* @private_data: private data to pass to callback functions
|
|
*
|
|
* The same IRQ source can be added only once. Adding an IRQ source
|
|
* indicates ownership of that IRQ source and all its IRQ types.
|
|
*
|
|
* Return: 0 on success, -errno otherwise
|
|
*/
|
|
typedef int (*cgs_add_irq_source_t)(void *cgs_device, unsigned client_id,
|
|
unsigned src_id,
|
|
unsigned num_types,
|
|
cgs_irq_source_set_func_t set,
|
|
cgs_irq_handler_func_t handler,
|
|
void *private_data);
|
|
|
|
/**
|
|
* cgs_irq_get() - Request enabling an IRQ source and type
|
|
* @cgs_device: opaque device handle
|
|
* @src_id: interrupt source ID
|
|
* @type: interrupt type
|
|
*
|
|
* cgs_irq_get and cgs_irq_put calls must be balanced. They count
|
|
* "references" to IRQ sources.
|
|
*
|
|
* Return: 0 on success, -errno otherwise
|
|
*/
|
|
typedef int (*cgs_irq_get_t)(void *cgs_device, unsigned client_id, unsigned src_id, unsigned type);
|
|
|
|
/**
|
|
* cgs_irq_put() - Indicate IRQ source is no longer needed
|
|
* @cgs_device: opaque device handle
|
|
* @src_id: interrupt source ID
|
|
* @type: interrupt type
|
|
*
|
|
* cgs_irq_get and cgs_irq_put calls must be balanced. They count
|
|
* "references" to IRQ sources. Even after cgs_irq_put is called, the
|
|
* IRQ handler may still be called if there are more refecences to
|
|
* the IRQ source.
|
|
*
|
|
* Return: 0 on success, -errno otherwise
|
|
*/
|
|
typedef int (*cgs_irq_put_t)(void *cgs_device, unsigned client_id, unsigned src_id, unsigned type);
|
|
|
|
struct cgs_os_ops {
|
|
/* IRQ handling */
|
|
cgs_add_irq_source_t add_irq_source;
|
|
cgs_irq_get_t irq_get;
|
|
cgs_irq_put_t irq_put;
|
|
};
|
|
|
|
#define cgs_add_irq_source(dev,client_id,src_id,num_types,set,handler,private_data) \
|
|
CGS_OS_CALL(add_irq_source,dev,client_id,src_id,num_types,set,handler, \
|
|
private_data)
|
|
#define cgs_irq_get(dev,client_id,src_id,type) \
|
|
CGS_OS_CALL(irq_get,dev,client_id,src_id,type)
|
|
#define cgs_irq_put(dev,client_id,src_id,type) \
|
|
CGS_OS_CALL(irq_put,dev,client_id,src_id,type)
|
|
|
|
#endif /* _CGS_LINUX_H */
|