Cogent SST-DVN Driver for SST DeviceNet Cards : Version 5.4
	Command Reference

`cardStatus`

cardStatus — provides a summary of the card status.

Synopsis

(cardStatus [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

The current status of the card, formatted as:

(cardStatus card_id (CAN_status_code CAN_status_string)
              (server_status_code server_status_string)
              (client_status_code client_status_string))

where

CAN_status_code and CAN_status_string

Can be one or more of the following:

`CAN_status_code`	`CAN_status_string`	Meaning
`0x0001`	`CAN_ONLINE`	`CAN` interface ready to communicate
`0x0002`	`CAN_BUSWARN`	`CAN` bus warning
`0x0004`	`CAN_BUSOFF`	`CAN` offline due to excessive errors
`0x0008`	`CAN_ACTIVITY`	`CAN` activity detected
`0x0010`	`CAN_TACKERR`	`CAN` transmission not acknowledged
`0x0020`	`CAN_TIMEOUT`	`CAN` transmission incomplete
`0x0040`	`CAN_OVERRUN`	`CAN` receive buffer overrun
`0x0080`	`CAN_LOST`	`CAN` message lost
`0x0100`	`CAN_ERROR`	`CAN` bus error
`0x0200`	`CAN_BUSPOWER`	`CAN` bus power present
`0x1000`	`CAN_ONLINE125`	`CAN` Online at `125` Kbaud
`0x2000`	`CAN_ONLINE250`	`CAN` Online at `250` Kbaud
`0x4000`	`CAN_ONLINE500`	`CAN` Online at `500` Kbaud
`0x8000`	`CAN_SCANACTIVE`	`CAN` Scanner active

server_status_code and server_status_string

Can be one or more of the following:

`server_status_code`	`server_status_string`	Meaning
`0x00`	`SS_IDLE`	connection set not allocated
`0x01`	`SS_ACTIVE`	connection set allocated

client_status_code and client_status_string

Can be one or more of the following:

`client_status_code`	`client_status_string`	Meaning
`0x00`	`CS_IDLE`	scanner idle
`0x01`	`CS_ACTIVE`	scanner active

Otherwise, the following error message:

(error "cardStatus DR_ERR_CARD_INVALID (time) invalid card: card_id")

Description

This command provides information on the current status of the card with respect to three key functional areas:

The CAN bus.
The card acting as a DeviceNet server (i.e. field device or slave).
The card acting as a DeviceNet client (i.e. scanner or master).

Example

(cardStatus 1)

returns

(cardStatus 1 (0x4201 "CAN_ONLINE|CAN_BUSPOWER|CAN_ONLINE500")
(0 "SS_IDLE") (1 "CS_ACTIVE"))


cardSet		cardSwapByteOrder