cardProfile

cardProfile — produces a detailed profile of card attributes.

Synopsis

(cardProfile 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

(cardProfile card_id
    (Id "manuf_id" ) (Addr hardware_addr )
    (MemorySize size_Kbytes Kb)   (Interrupt intr ) | (Polled poll_ms ) 
    (TypeModel "card_name" ) (Desc "description" ) 
    (Protocol "protocol_name" )
    (Date production_date ) (GNR product_num )  (SNR serial_num )
    (OSName "os_name" ) (OEMid "oem_id" )
    (Firmware "firmware_name"  "firmware_version" )
    (DeviceAddress 0Xdevice_addr) (Mode io_mode_code "io_mode_name")
    (Task task_id "task_name"  task_version  task_state )
    ...

The Task attribute gets repeated for each available task (protocol dependent). If the driver is not familiar with the TypeModel, then the TypeModel, Desc and Protocol attributes are replaced by the following. Generally, this does not impact the function of the driver.

(error "WARNING! Type/Model code type_codemodel_code unknown")
(error "Please report this code to COGENT Real-Time Systems Inc.")

Otherwise, if the specified card has not been initialized:

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

Description

This command produces a detailed profile of the card attributes. Each attribute in the list is provided in the following syntax:

(attribute_name attribute_value [...])

This command is often inserted into an initial configuration file, after a cardInit command has auto-detected the card(s), to provide a detailed description of the cards available.

Example

In the following example:

(cardProfile 0)

returns

(cardProfile 0
    (Id "CIF") (Addr 0XD6000) (MemorySize 2 Kb)(Interrupt 7)
    (TypeModel "CIF 30-IBSM") (Desc "CIF 30 for InterBus-S")
    (Protocol "INTERBUS-S")
    (Date 01011999) (GNR 96070020) (SNR 00000340)
    (OSName "SMSI") (OEMid "")
    (Firmware "IBM     CIF30IBM" "V02.019 19.03.99")
    (DeviceAddress 0X00)(Mode 3 "HOST controlled, buffered")
    (Task 1 "ALPMLIPD" 1013 0)
    (Task 2 "PLC-TASK" 2104 0)
    (Task 3 "IBM     " 2220 2))