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.