SUPPORT

The SUPPORT structure is defined in < inc_path/toolkit.h > as:

typedef struct support
{
     char read_req;
     char write_req;
     char upload_req;
     char dnload_req;
     char ondemand_req;
     char start_req;
     char stop_req;
     char model_req;
     char unsolic_req;
     char det_dev_status;
     char host_redundancy;
     char read_addr_req;
     char write_addr_req;
     char timestamp_unso_pt;
     char adhoc_req;
     char use_dp_fp;
     char network_redundancy;
     char set_array_element;
     char vlist_addressing;
     char use_long_addresses;
     char unsolicited_quality_data;
     char saved_device_req;
     char dyn_cfg_req;
     char extended_user_bits;
     char allow_64_bit_ints;
     char use_custom_cache_blocks;
     char use_long_point_id;
     char use_custom_domain_count;
     char state_unso_pt;
     char use_custom_persisted;
     char feature1;
     char feature2;
     char feature3;
     char feature4;
     char feature5;
     char feature6;
     char feature7;
} SUPPORT;

For all the above, valid values are:

TOOLKIT_YES The option is supported.
TOOLKIT_NO The option is not supported.

Where:

read_req

indicates whether or not it is possible to read from the device's memory using the implemented protocol.

Set to:

TOOLKIT_YES If the protocol can read from the device's memory.
TOOLKIT_NO If the protocol cannot read from the device's memory.

write_req

Indicates whether or not it is possible to write to the device's memory using the implemented protocol.

Set to:

TOOLKIT_YES If the protocol can write to the device's memory.
TOOLKIT_NO If the protocol cannot write to the device's memory.

upload_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

dnload_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

ondemand_req

Indicates whether or not user_device_ok is used to determine the device's status.

Set to:

TOOLKIT_YES If user_device_ok is used.
TOOLKIT_NO If the device status is determined from communication status.

start_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

stop_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

model_req

Indicates whether or not verification that communication with a device with the correct CPU model is occurring.

Set to:

TOOLKIT_YES If verification is occurring.
TOOLKIT_NO If verification is not occurring.

unsolic_req

Indicates whether or not unsolicited data is supported.

Set to:

TOOLKIT_YES If unsolicited data is supported.
TOOLKIT_NO If unsolicited data is not supported

det_dev_status

Indicates whether or not user_device_ok is used to determine device status.

Set to:

TOOLKIT_YES If user_device_ok is to be used.
TOOLKIT_NO If device status is determined from communication status.

host_redundancy indicates whether or not Host Redundancy is supported for this device.

TOOLKIT_YES If Host Redundancy is supported for this device.
TOOLKIT_NO If Host Redundancy is not supported for this device.

read_addr_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

write_addr_req

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

timestamp_unso_pt

Indicates whether or not a user-provided timestamp is sent with unsolicited data. This field is meaningful only if unsolic_req is set to TOOLKIT_YES.

Set to:

TOOLKIT_YES To invoke user_process_unsolicited_data_stamp .
TOOLKIT_NO To invoke user_process_unsolicited_data .

adhoc_req

Indicates whether or not the enabler supports Point by Address requests.

Set to:

TOOLKIT_YES If the enabler supports Point by Address requests.
TOOLKIT_NO If the enabler does not support Point by Address requests.

use_dp_fp

Indicates whether or not double-precision floating point numbers are supported.

Set to:

TOOLKIT_YES If 8 byte floating point data is supported.
TOOLKIT_NO If 4 byte floating point data is supported.

network_redundancy is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

set_array_element

Indicates whether a set array element request should be processed by the devcom.

Set to:

TOOLKIT_YES If set array elements is supported.
TOOKIT_NO If set array elements are not supported

vlist_addressing

Is reserved for for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

use_long_addresses

Indicates whether or not the device communications supports point addresses up to 256 characters.

Set to:

TOOLKIT_YES If long addresses are supported.
TOOLKIT_NO If long addresses are not supported.

unsolicited_quality_data

Indicates whether or not the receipt of unsolicited quality data is supported.

Set to:

TOOLKIT_YES If the devices will be sending unsolicited quality data.
TOOLKIT_NO If the devices will not be sending unsolicited quality data.

saved_dev_req  

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

dyn_cfg_req

Indicates whether or not the dynamic configuration is supported.

Set to:

TOOLKIT_YES If dynamic configuration is supported.
TOOLKIT_NO If dynamic configuration is not supported

extended_user_bits

Indicates whether or not extended user bits will be used to represent the quality data..

Set to:

TOOLKIT_YES If extended bits are supported. This means TOOLKIT_QUALDATA2 will be used to represent the quality data.
TOOLKIT_NO If extended bits are not supported. This means TOOLKIT_QUALDATA will be used to represent the quality data.

allow_64_bit_ints

Indicates whether or not the device communications supports 64 bit signed or unsigned integer point types..

Set to:

TOOLKIT_YES If signed and unsigned 64 bit integers are supported.
TOOLKIT_NO If signed and unsigned 64 bit integers are not supported.

use_custom_cache_blocks

Is reserved for for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

use_long_point_id

Indicates whether or not the device communications will receive point ids using their display format or internal representation.

Set to:

TOOLKIT_YES If point IDs are represented as they are displayed.
TOOLKIT_NO If point IDs are represented using their internal representation.

use_default_domain_count

Indicates whether or not the device communications will define the maximum number of domains per device based on user defined value or TOOLKIT_MAX_DEVICE_DOMAINS.

Set to:

TOOLKIT_YES If the maximum number of possible device domains on the device is user-defined
TOOLKIT_NO If the maximum number of possible device domains is TOOLKIT_MAX_DEVICE_DOMAINS.

state_unso_points

Indicates whether or not point state is supported.

Set to:

TOOLKIT_YES If point state is supported.
TOOLKIT_NO If point state is not supported.

use_custom_persisted

Is reserved for for GE Intelligent Platforms use.

Set to TOOLKIT_NO unless specifically told by GE Intelligent Platforms to set it to TOOLKIT_YES.

Feature1

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature2

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature3

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature4

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature5

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature6

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.

Feature7

Is reserved for GE Intelligent Platforms use.

Set to TOOLKIT_NO.