gpib_ppconf(3)                      CLIX                      gpib_ppconf(3)



  NAME

    gpib_ppconf - Configures the parallel poll response of a General Purpose
    Interface Bus (GPIB) device

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int gpib_ppconf(
      int channel ,
      char *ldev ,
      char mask );

  PARAMETERS

    channel   Represents a GPIB channel.

    ldev      Points to the primary address of the device.

    mask      Points to the parallel poll response.

  DESCRIPTION

    The gpib_ppconf() function configures a device connected to the General
    Purpose Interface Bus (GPIB) channel with a specific parallel poll
    response.  The ldev parameter points to the primary address of the device,
    while mask contains the response.  The format of the response mask, as
    defined in the IEEE 488 standard, is given below.

    Bit Field   Description

    0-2         Binary coded GPIB data line on which the device is to respond

    3           Logic level of the response

    The gpib_ppconf() function configures a GPIB device's parallel poll
    response by putting the system controller in an active state and issuing
    the following sequence of messages.

    UNL   Unlisten

    LAG   Listen Address Group

    PPC   Parallel Poll Configure

    PPE   Parallel Poll Enable



  2/94 - Intergraph Corporation                                              1

  gpib_ppconf(3)                      CLIX                      gpib_ppconf(3)



    UNL   Unlisten

  EXAMPLES

    To configure GPIB device 7 with an active parallel poll response of 1 on
    GPIB bus line 6:

    ldev = 7;
    mask = (0x01 << 3) | 0x06;
    if(status = gpib_ppconf(channel, &ldev, mask)) {
         fprintf(stderr, "gpib_ppconf: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "gpib_ppconf: succeeded\n");


  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the failure codes listed in the ERRORS section is returned.

  ERRORS

    The gpib_ppconf() function fails if one of the following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request.

    [GPIB_OUT_OF_RANGE]
           The specified channel is beyond the maximum allowed.

    [GPIB_NOT_OPEN]
           The specified channel is not open.

    [GPIB_NOT_OWNER]
           The specified channel is currently open by another process.

    [GPIB_DEVICE_INVALID]
           The primary address of the specified device is incorrect.

    [BAD_DATA_BUFFER_ADDRESS]
           The primary address pointer ldev points to an invalid memory
           address.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_ppreq(3), gpib_ppuconf(3), gpib_cmd(3)

    Files:  xgpib(7)




  2                                              Intergraph Corporation - 2/94