218 lines
6.6 KiB
C
218 lines
6.6 KiB
C
/* -*- mode: c; c-basic-offset: 8 -*- */
|
|
|
|
/*
|
|
* MCA device support functions
|
|
*
|
|
* These functions support the ongoing device access API.
|
|
*
|
|
* (C) 2002 James Bottomley <James.Bottomley@HansenPartnership.com>
|
|
*
|
|
**-----------------------------------------------------------------------------
|
|
**
|
|
** This program is free software; you can redistribute it and/or modify
|
|
** it under the terms of the GNU General Public License as published by
|
|
** the Free Software Foundation; either version 2 of the License, or
|
|
** (at your option) any later version.
|
|
**
|
|
** This program is distributed in the hope that it will be useful,
|
|
** but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
** GNU General Public License for more details.
|
|
**
|
|
** You should have received a copy of the GNU General Public License
|
|
** along with this program; if not, write to the Free Software
|
|
** Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
**
|
|
**-----------------------------------------------------------------------------
|
|
*/
|
|
|
|
#include <linux/module.h>
|
|
#include <linux/device.h>
|
|
#include <linux/mca.h>
|
|
|
|
/**
|
|
* mca_device_read_stored_pos - read POS register from stored data
|
|
* @mca_dev: device to read from
|
|
* @reg: register to read from
|
|
*
|
|
* Fetch a POS value that was stored at boot time by the kernel
|
|
* when it scanned the MCA space. The register value is returned.
|
|
* Missing or invalid registers report 0.
|
|
*/
|
|
unsigned char mca_device_read_stored_pos(struct mca_device *mca_dev, int reg)
|
|
{
|
|
if(reg < 0 || reg >= 8)
|
|
return 0;
|
|
|
|
return mca_dev->pos[reg];
|
|
}
|
|
EXPORT_SYMBOL(mca_device_read_stored_pos);
|
|
|
|
/**
|
|
* mca_device_read_pos - read POS register from card
|
|
* @mca_dev: device to read from
|
|
* @reg: register to read from
|
|
*
|
|
* Fetch a POS value directly from the hardware to obtain the
|
|
* current value. This is much slower than
|
|
* mca_device_read_stored_pos and may not be invoked from
|
|
* interrupt context. It handles the deep magic required for
|
|
* onboard devices transparently.
|
|
*/
|
|
unsigned char mca_device_read_pos(struct mca_device *mca_dev, int reg)
|
|
{
|
|
struct mca_bus *mca_bus = to_mca_bus(mca_dev->dev.parent);
|
|
|
|
return mca_bus->f.mca_read_pos(mca_dev, reg);
|
|
|
|
return mca_dev->pos[reg];
|
|
}
|
|
EXPORT_SYMBOL(mca_device_read_pos);
|
|
|
|
|
|
/**
|
|
* mca_device_write_pos - read POS register from card
|
|
* @mca_dev: device to write pos register to
|
|
* @reg: register to write to
|
|
* @byte: byte to write to the POS registers
|
|
*
|
|
* Store a POS value directly to the hardware. You should not
|
|
* normally need to use this function and should have a very good
|
|
* knowledge of MCA bus before you do so. Doing this wrongly can
|
|
* damage the hardware.
|
|
*
|
|
* This function may not be used from interrupt context.
|
|
*
|
|
*/
|
|
void mca_device_write_pos(struct mca_device *mca_dev, int reg,
|
|
unsigned char byte)
|
|
{
|
|
struct mca_bus *mca_bus = to_mca_bus(mca_dev->dev.parent);
|
|
|
|
mca_bus->f.mca_write_pos(mca_dev, reg, byte);
|
|
}
|
|
EXPORT_SYMBOL(mca_device_write_pos);
|
|
|
|
/**
|
|
* mca_device_transform_irq - transform the ADF obtained IRQ
|
|
* @mca_device: device whose irq needs transforming
|
|
* @irq: input irq from ADF
|
|
*
|
|
* MCA Adapter Definition Files (ADF) contain irq, ioport, memory
|
|
* etc. definitions. In systems with more than one bus, these need
|
|
* to be transformed through bus mapping functions to get the real
|
|
* system global quantities.
|
|
*
|
|
* This function transforms the interrupt number and returns the
|
|
* transformed system global interrupt
|
|
*/
|
|
int mca_device_transform_irq(struct mca_device *mca_dev, int irq)
|
|
{
|
|
struct mca_bus *mca_bus = to_mca_bus(mca_dev->dev.parent);
|
|
|
|
return mca_bus->f.mca_transform_irq(mca_dev, irq);
|
|
}
|
|
EXPORT_SYMBOL(mca_device_transform_irq);
|
|
|
|
/**
|
|
* mca_device_transform_ioport - transform the ADF obtained I/O port
|
|
* @mca_device: device whose port needs transforming
|
|
* @ioport: input I/O port from ADF
|
|
*
|
|
* MCA Adapter Definition Files (ADF) contain irq, ioport, memory
|
|
* etc. definitions. In systems with more than one bus, these need
|
|
* to be transformed through bus mapping functions to get the real
|
|
* system global quantities.
|
|
*
|
|
* This function transforms the I/O port number and returns the
|
|
* transformed system global port number.
|
|
*
|
|
* This transformation can be assumed to be linear for port ranges.
|
|
*/
|
|
int mca_device_transform_ioport(struct mca_device *mca_dev, int port)
|
|
{
|
|
struct mca_bus *mca_bus = to_mca_bus(mca_dev->dev.parent);
|
|
|
|
return mca_bus->f.mca_transform_ioport(mca_dev, port);
|
|
}
|
|
EXPORT_SYMBOL(mca_device_transform_ioport);
|
|
|
|
/**
|
|
* mca_device_transform_memory - transform the ADF obtained memory
|
|
* @mca_device: device whose memory region needs transforming
|
|
* @mem: memory region start from ADF
|
|
*
|
|
* MCA Adapter Definition Files (ADF) contain irq, ioport, memory
|
|
* etc. definitions. In systems with more than one bus, these need
|
|
* to be transformed through bus mapping functions to get the real
|
|
* system global quantities.
|
|
*
|
|
* This function transforms the memory region start and returns the
|
|
* transformed system global memory region (physical).
|
|
*
|
|
* This transformation can be assumed to be linear for region ranges.
|
|
*/
|
|
void *mca_device_transform_memory(struct mca_device *mca_dev, void *mem)
|
|
{
|
|
struct mca_bus *mca_bus = to_mca_bus(mca_dev->dev.parent);
|
|
|
|
return mca_bus->f.mca_transform_memory(mca_dev, mem);
|
|
}
|
|
EXPORT_SYMBOL(mca_device_transform_memory);
|
|
|
|
|
|
/**
|
|
* mca_device_claimed - check if claimed by driver
|
|
* @mca_dev: device to check
|
|
*
|
|
* Returns 1 if the slot has been claimed by a driver
|
|
*/
|
|
|
|
int mca_device_claimed(struct mca_device *mca_dev)
|
|
{
|
|
return mca_dev->driver_loaded;
|
|
}
|
|
EXPORT_SYMBOL(mca_device_claimed);
|
|
|
|
/**
|
|
* mca_device_set_claim - set the claim value of the driver
|
|
* @mca_dev: device to set value for
|
|
* @val: claim value to set (1 claimed, 0 unclaimed)
|
|
*/
|
|
void mca_device_set_claim(struct mca_device *mca_dev, int val)
|
|
{
|
|
mca_dev->driver_loaded = val;
|
|
}
|
|
EXPORT_SYMBOL(mca_device_set_claim);
|
|
|
|
/**
|
|
* mca_device_status - get the status of the device
|
|
* @mca_device: device to get
|
|
*
|
|
* returns an enumeration of the device status:
|
|
*
|
|
* MCA_ADAPTER_NORMAL adapter is OK.
|
|
* MCA_ADAPTER_NONE no adapter at device (should never happen).
|
|
* MCA_ADAPTER_DISABLED adapter is disabled.
|
|
* MCA_ADAPTER_ERROR adapter cannot be initialised.
|
|
*/
|
|
enum MCA_AdapterStatus mca_device_status(struct mca_device *mca_dev)
|
|
{
|
|
return mca_dev->status;
|
|
}
|
|
EXPORT_SYMBOL(mca_device_status);
|
|
|
|
/**
|
|
* mca_device_set_name - set the name of the device
|
|
* @mca_device: device to set the name of
|
|
* @name: name to set
|
|
*/
|
|
void mca_device_set_name(struct mca_device *mca_dev, const char *name)
|
|
{
|
|
if(!mca_dev)
|
|
return;
|
|
|
|
strlcpy(mca_dev->name, name, sizeof(mca_dev->name));
|
|
}
|
|
EXPORT_SYMBOL(mca_device_set_name);
|