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

# license

license -- enables the driver license.

## Synopsis

    (license card_id license_key)

## Parameters

`card_id`

  The card ID.

`license_key`

  A card-specific key required to activate the license.

## Returns

`OK`, if card accessed successfully. In this case, the following messages may be printed to the standard output stream:

        Warning: zero key read from board device.

(This message may indicate that the board has been improperly configured at the factory. Contact the supplier for help.)

        License for board board Accepted.

        Demo license for board board Accepted.

        License for board board Rejected.

If the command failed (the card not is available or was not read), then the following error message is returned:

        (error "license DR_ERR_DEV_IO_FAILURE (time)
         I/O failure(card_status) on card card")

The driver will not generally start up without a successful license command execution.

## Description

This command enables the license for the driver. Most drivers require a license to be enabled, otherwise they will fail to start. The license key is unique to the particular hardware installed and the operating system used, and must be determined by Cogent for each installation of the software. This command is normally executed from the configuration file.

Multiple license commands can be put in the configuration file, to cover multiple or alternate cards, or different OS's. Although licenses that are invalid will be rejected, the driver will start provided at least one license was accepted. The licenseFile command provides a better mechanism to manage multiple licenses.

## Example

        (license 0 1234-5678-9abcde-f012-3567-89ab)

Prev | Home | Next
include | Up | licenseFile

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