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

`deviceStatus`

deviceStatus — provides a summary of the DeviceNet device status.

Synopsis

(deviceStatus card_id [device_MAC_id])

Parameters

card_id: The target card ID (0..3).
device_MAC_id: The device MAC ID. If not specified, then all devices are queried.

Returns

If the card is defined:

(deviceStatus card_id [DeviceStatus_i] ...)

where DeviceStatus_i is the status of the specified device (or repeated for all configured devices if not specified) and is defined as follows:

(device_MAC_id status_code status_string)

The respective meanings of the status_code and status_string are as follows:

`status_code`	`status_string`	Meaning
`0x00`	`DS_DEV_NOT_IN_LIST`	Device not in device list.
`0x01`	`DS_DEV_IDLE`	Device idle (not scanned).
`0x02`	`DS_DEV_SCANNED`	Device being scanned.
`0x03`	`DS_DEV_TIMEOUT`	Device timed-out.
`0x04`	`DS_UCMM_CONN_ERROR`	UCMM connection error.
`0x05`	`DS_CONNECTION_BUSY`	Mstr/slv connection set busy.
`0x06`	`DS_CONN_ALLOC_ERR`	Error allocating mstr/slv connection.
`0x07`	`DS_VEND_ID_INVALID`	Invalid vendor ID.
`0x08`	`DS_VEND_ID_RD_ERR`	Error reading vendor ID.
`0x09`	`DS_DEV_TYPE_INVALID`	Invalid device type.
`0x0A`	`DS_DEV_TYPE_RD_ERR`	Error reading device type.
`0x0B`	`DS_PRODCODE_INVALID`	Invalid product code.
`0x0C`	`DS_PRODCODE_RD_ERR`	Error reading product code.
`0x0D`	`DS_CONN1ISIZE_INV`	Invalid IO connection 1 input size.
`0x0E`	`DS_CONN1ISIZE_RD_ERR`	Error reading IO connection 1 input.
`0x0F`	`DS_CONN1OSIZE_INV`	Invalid IO connection 1 output size.
`0x10`	`DS_CONN1OSIZE_RD_ERR`	Error reading IO connection 1 output.
`0x11`	`DS_CONN2ISIZE_INV`	Invalid IO connection 2 input size.
`0x12`	`DS_CONN2ISIZE_RD_ERR`	Error reading IO connection 2 input.
`0x13`	`DS_CONN2OSIZE_INV`	Invalid IO connection 2 output size.
`0x14`	`DS_CONN2OSIZE_RD_ERR`	Error reading IO connection 2 output.
`0x15`	`DS_CONN1_PCKRATE_ERR`	Error setting IO connection 1 packet.
`0x16`	`DS_CONN2_PCKRATE_ERR`	Error setting IO connection 2 packet.
`0x17`	`DS_CONN_SYNC_FAULT`	Mstr/slv connection set sync.
`0x18`	`DS_PIT_ERR`	Error setting Production inhibit time.

Otherwise, one of the following error messages:

(error "deviceStatus DR_ERR_CARD_INVALID (time) invalid card: card_id")
(error "deviceStatus DR_ERR_DEVICE_INVALID (time) Card card_id Device device_MAC_id not valid")

Description

This command provides the status of the client connection to configured devices. Devices must have been configured with the dnsDeviceAdd command.

Example

If card 1 is online and a single device has been successfully defined (MAC id 2), then

	(deviceStatus 1)

returns

	(deviceStatus 1 (2 2 "DS_SCANNED"))

if scanning is active, otherwise

	(deviceStatus 1 (2 1 "DS_IDLE"))


describePntAddr		digital