forked from KolibriOS/kolibrios
141 lines
3.7 KiB
C
141 lines
3.7 KiB
C
|
/**************************************************************************
|
||
|
|
*
|
||
|
|
* Copyright 2012 Francisco Jerez
|
||
|
|
* All Rights Reserved.
|
||
|
|
*
|
||
|
|
* 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, sub license, 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 (including the
|
||
|
|
* next paragraph) 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 NON-INFRINGEMENT.
|
||
|
|
* IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS 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.
|
||
|
|
*
|
||
|
|
**************************************************************************/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* \file Library that provides device enumeration and creation of
|
||
|
|
* winsys/pipe_screen instances.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef PIPE_LOADER_H
|
||
|
|
#define PIPE_LOADER_H
|
||
|
|
|
||
|
|
#include "pipe/p_compiler.h"
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
struct pipe_screen;
|
||
|
|
|
||
|
|
enum pipe_loader_device_type {
|
||
|
|
PIPE_LOADER_DEVICE_SOFTWARE,
|
||
|
|
PIPE_LOADER_DEVICE_PCI,
|
||
|
|
NUM_PIPE_LOADER_DEVICE_TYPES
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A device known to the pipe loader.
|
||
|
|
*/
|
||
|
|
struct pipe_loader_device {
|
||
|
|
enum pipe_loader_device_type type;
|
||
|
|
|
||
|
|
union {
|
||
|
|
struct {
|
||
|
|
int vendor_id;
|
||
|
|
int chip_id;
|
||
|
|
} pci;
|
||
|
|
} u; /**< Discriminated by \a type */
|
||
|
|
|
||
|
|
const char *driver_name;
|
||
|
|
const struct pipe_loader_ops *ops;
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get a list of known devices.
|
||
|
|
*
|
||
|
|
* \param devs Array that will be filled with pointers to the devices
|
||
|
|
* available in the system.
|
||
|
|
* \param ndev Maximum number of devices to return.
|
||
|
|
* \return Number of devices available in the system.
|
||
|
|
*/
|
||
|
|
int
|
||
|
|
pipe_loader_probe(struct pipe_loader_device **devs, int ndev);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Create a pipe_screen for the specified device.
|
||
|
|
*
|
||
|
|
* \param dev Device the screen will be created for.
|
||
|
|
* \param library_paths Colon-separated list of filesystem paths that
|
||
|
|
* will be used to look for the pipe driver
|
||
|
|
* module that handles this device.
|
||
|
|
*/
|
||
|
|
struct pipe_screen *
|
||
|
|
pipe_loader_create_screen(struct pipe_loader_device *dev,
|
||
|
|
const char *library_paths);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Release resources allocated for a list of devices.
|
||
|
|
*
|
||
|
|
* Should be called when the specified devices are no longer in use to
|
||
|
|
* release any resources allocated by pipe_loader_probe.
|
||
|
|
*
|
||
|
|
* \param devs Devices to release.
|
||
|
|
* \param ndev Number of devices to release.
|
||
|
|
*/
|
||
|
|
void
|
||
|
|
pipe_loader_release(struct pipe_loader_device **devs, int ndev);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get a list of known software devices.
|
||
|
|
*
|
||
|
|
* This function is platform-specific.
|
||
|
|
*
|
||
|
|
* \sa pipe_loader_probe
|
||
|
|
*/
|
||
|
|
int
|
||
|
|
pipe_loader_sw_probe(struct pipe_loader_device **devs, int ndev);
|
||
|
|
|
||
|
|
#ifdef HAVE_PIPE_LOADER_DRM
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get a list of known DRM devices.
|
||
|
|
*
|
||
|
|
* This function is platform-specific.
|
||
|
|
*
|
||
|
|
* \sa pipe_loader_probe
|
||
|
|
*/
|
||
|
|
int
|
||
|
|
pipe_loader_drm_probe(struct pipe_loader_device **devs, int ndev);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initialize a DRM device in an already opened fd.
|
||
|
|
*
|
||
|
|
* This function is platform-specific.
|
||
|
|
*
|
||
|
|
* \sa pipe_loader_probe
|
||
|
|
*/
|
||
|
|
boolean
|
||
|
|
pipe_loader_drm_probe_fd(struct pipe_loader_device **dev, int fd);
|
||
|
|
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* PIPE_LOADER_H */
|