VxWorks Reference Manual : Libraries

cisLib

NAME

cisLib - PCMCIA CIS library

ROUTINES

cisGet( ) - get information from a PC card's CIS
cisFree( ) - free tuples from the linked list
cisConfigregGet( ) - get the PCMCIA configuration register
cisConfigregSet( ) - set the PCMCIA configuration register

DESCRIPTION

This library contains routines to manipulate the CIS (Configuration Information Structure) tuples and the card configuration registers. The library uses a memory window which is defined in pcmciaMemwin to access the CIS of a PC card. All CIS tuples in a PC card are read and stored in a linked list, cisTupleList. If there are configuration tuples, they are interpreted and stored in another link list, cisConifigList. After the CIS is read, the PC card's enabler routine allocates resources and initializes a device driver for the PC card.

If a PC card is inserted, the CSC (Card Status Change) interrupt handler gets a CSC event from the PCMCIA chip and adds a cisGet( ) job to the PCMCIA daemon. The PCMCIA daemon initiates the cisGet( ) work. The CIS library reads the CIS from the PC card and makes a linked list of CIS tuples. It then enables the card.

If the PC card is removed, the CSC interrupt handler gets a CSC event from the PCMCIA chip and adds a cisFree( ) job to the PCMCIA daemon. The PCMCIA daemon initiates the cisFree( ) work. The CIS library frees allocated memory for the linked list of CIS tuples.

SEE ALSO

cisLib


Libraries : Routines

cisGet( )

NAME

cisGet( ) - get information from a PC card's CIS

SYNOPSIS

STATUS cisGet
    (
    int sock /* socket no. */
    )

DESCRIPTION

This routine gets information from a PC card's CIS, configures the PC card, and allocates resources for the PC card.

RETURNS

OK, or ERROR if it cannot get the CIS information, configure the PC card, or allocate resources.

SEE ALSO

cisLib


Libraries : Routines

cisFree( )

NAME

cisFree( ) - free tuples from the linked list

SYNOPSIS

void cisFree
    (
    int sock /* socket no. */
    )

DESCRIPTION

This routine free tuples from the linked list.

RETURNS

N/A

SEE ALSO

cisLib


Libraries : Routines

cisConfigregGet( )

NAME

cisConfigregGet( ) - get the PCMCIA configuration register

SYNOPSIS

STATUS cisConfigregGet
    (
    int   sock,  /* socket no. */
    int   reg,   /* configuration register no. */
    int * pValue /* content of the register */
    )

DESCRIPTION

This routine gets that PCMCIA configuration register.

RETURNS

OK, or ERROR if it cannot set a value on the PCMCIA chip.

SEE ALSO

cisLib


Libraries : Routines

cisConfigregSet( )

NAME

cisConfigregSet( ) - set the PCMCIA configuration register

SYNOPSIS

STATUS cisConfigregSet
    (
    int sock, /* socket no. */
    int reg,  /* register no. */
    int value /* content of the register */
    )

DESCRIPTION

This routine sets the PCMCIA configuration register.

RETURNS

OK, or ERROR if it cannot set a value on the PCMCIA chip.

SEE ALSO

cisLib