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

# cifTelegramBin

cifTelegramBin -- provides access to the CIF message data interface.

## Synopsis

    (cifTelegramBin card_id rcv_task snd_task cmd ext ascii_hex_string)

## Parameters

`card_id`

  The target card ID (`0..3`).

`rcv_task`

  The ID of the target CIF firmware task that is to process the message. This value is protocol-dependent. Different message functions are available through the various target tasks.

`snd_task`

  The sending task id, normally `16` (the HOST user), but may be dependent on the protocol and specific function.

`cmd`

  The message command specifier, as defined for the particular protocol and function.

`ext`

  The message command specifier extension, if required by the command.

`ascii_hex_string`

  The content of the message as a string of ASCII-encoded hex digits.

  | This specifies the content of the message itself (header + data); the message interface header (the first 8 bytes) is automatically created from the other supplied parameters.

## Returns

        (cifTelegramBin card_id return_value)

where `return_value` depends on the message response>, or one of the following errors:

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

        (error "cifTelegramBin -1 (time) messageError message_error_code")

        (error "cifTelegramBin -1 (time) replyMailboxError device_error_code")

        (error "cifTelegramBin -1 (time) sendMailboxError device_error_code")

| The text string corresponding to the `message_error_code` and `device_error_code` can be obtained by issuing an errorDescription command, like this:
        (cifErrorDescription error_code)

## Description

This command provides access to the CIF message data interface. The message content must be specified as ASCII encoded hex digits, and the resulting binary message is likewise encoded as ASCII hex. See the cifTelegram command for more information about messages.

## Example

See protocol-specific configuration files.

Prev | Home | Next
cifTelegram | Up | cifTelegramFmt

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