Cascade Driver for Hilscher Fieldbus CIF Cards: Version 4.1
Prev |  | Next

# cardIoStatus

cardIoStatus -- provides process I/O data exchange status for cards.

## Synopsis

    (cardIoStatus)
    (cardIoStatus card_id)

## Parameters

`card_id`

  The target card ID (`0..3`). If no card ID is specified, the query is repeated for all initialized cards.

## Returns

In response to a query or successful setting of a card:

        (cardIoStatus card_id mode mode ReadyBit ready_flag RunBit run_flag ComBit com_flag count exchanges flags flags)

where

`mode`

  The mode of exchange between the fieldbus and process I/O data buffers on the card (see Driver Control API in the Cogent API manual).

`ready_flag`

  `1` if the card is running and initialization (of the card firmware) is complete.

`run_flag`

  `1` if the card is configured and communicating.

`com_flag`

  `1` if data exchange between the card and the fieldbus has been established.

`exchanges`

  An internal driver count of the number of buffer data accesses completed.

`flags`

  The current value of the 2-byte device flag register (in hex).

Otherwise, one of the following error messages:

        (error "cardIoStatus DR_ERR_DEV_INVALID (time) invalid device: card_id")

## Description

This command provides status information about the process I/O data exchange between a card and its fieldbus. Normally it is used only for interactive performance testing.

## Example

In the following example,

        (cardIoStatus 0)

returns

        (cardIoStatus 1 mode 2 ReadyBit 1 RunBit 1 ComBit 0 count 0 flags 0000)

Prev | Home | Next
cardInit | Up | cardPoll

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.