Handle Event Flags

Use the Device Communications Toolkit functions to manipulate event flags.

A CIMPLICITY software event flag is a bit within a predefined data structure. Applications can reserve some event flags to indicate some condition has occurred. Routines are provided to SET and CLEAR the event flag.

The enabler calls predefined (user-defined) functions when an event flag is SET. Ten (10) event flags are available to the enabler.

The following functions manipulate these flags:

USER_DEVICE_INFO

USER_DEVICE_OKAY

USER_INIT

DCRP_CALL_ON_TIME

DCRP_CLEAR_EF

DCRP_GET_ANY_EF

DCRP_GET_EF

DCRP_RCV_UNSOLICITED_DATA

DCRP_RCV_UNSOLICITED_DATA_STAMP

 DCRP_RELEASE_EF

DCRP_SET_DEVICE_UP

DCRP_SET_EF

Note: Some operating systems provide primitives for defining and manipulating event flags. It is recommended that the CIMPLICITY software-provided routines be used instead to avoid conflict with CIMPLICITY software routines within the enabler.

The Device Communications Toolkit reserves 10 event flags for use with user-customized subroutines and provides functions for reserving and manipulating the event flags.

Event flags should be cleared within the user-defined function for processing the event flag.

More information

Programming restrictions.