SVR5

cm_AT_putconf(D3)

cm_AT_putconf -- store standard parameters in resource manager database

Synopsis

   #include <sys/types.h>
   #include <sys/confmgr.h>
   #include <sys/cm_i386at.h>
   #include <sys/ddi.h>
   
   int cm_AT_putconf(rm_key_t rm_key, int vector, int itype, ulong_t sioa, ulong_t eioa,
   		 ulong_t scma, ulong_t ecma, int dmac, uint_t setmask, int claim);

Description

cm_AT_putconf( ) is used by device drivers that need to store values for various standard hardware parameters into the resource manager database. For MCA drivers, these hardware parameters are typically determined by interpreting the MCA POS registers. Drivers that can determine hardware parameters by reading configuration information directly from their device may also use this routine. For most drivers, though, this will be unnecessary, because the correct information is already in the resource manager database.

Arguments

rm_key: Resource manager key selecting a particular board instance.
vector: Board's interrupt vector (IRQ).
itype: Interrupt type: CM_ITYPE_EDGE for edge-triggered interrupts or CM_ITYPE_LEVEL for level-sensitive interrupts.
sioa: Start of board's I/O address range.
eioa: End of board's I/O address range.
scma: Start of board's memory address range.
ecma: End of board's memory address range.
dmac: Board's DMA channel.
setmask: Indicates which parameters are to be set.
claim: Non-zero if driver wishes to ``own'' the parameters specified by setmask.

Return values

cm_AT_putconf returns 0 for success. The following errnos are returned for failure:

EINVAL: if rm_key is invalid. value.

Usage

The setmask argument is a bitmask of flags indicating which resource parameters are to be set from the values given by the other arguments:

CM_SET_IRQ: set CM_IRQ from vector.
CM_SET_ITYPE: set CM_ITYPE from itype.
CM_SET_IOADDR: set CM_IOADDR from sioa and eioa.
CM_SET_MEMADDR: set CM_MEMADDR from scma and ecma.
CM_SET_DMAC: set CM_DMAC from dmac.

If the claim argument is non-zero, the driver will subsequently be completely responsible for the resource parameters specified by setmask for this board. The system will no longer attempt to update these parameters from values found in NVRAM. A new parameter, CM_CLAIM, will be added to the key with the value setmask.

Context and synchronization

User or blockable context.

Hardware applicability

PC-AT compatible platforms

Version applicability

ddi: 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

cm_addval(D3), cm_read_devconfig(D3), cm_read_devconfig8(D3), cm_read_devconfig16(D3), cm_read_devconfig32(D3), cm_write_devconfig(D3), cm_write_devconfig8(D3), cm_write_devconfig16(D3), cm_write_devconfig32(D3), cm_params(D5)

``Autoconfiguration'' in HDK Technical Reference