Echelon DM-21 Device Manager - Manual (Page 79)

Device Manager User’s Guide 6-5
DMREP_DEVICE_PROPS
The DMREP_DEVICE_PROPS report is issued by the Device Manager in
response to DMCMD_QUERY_DEVICE_PROPS command received on the
DM_Command input network variable. This report uses the DmDeviceProps
struct defined in
dmobj.h
.
DMREP_DEVICE_DISCOVERED
The DMREP_DEVICE_DISCOVERED report is issued by the Device
Manager each time a new device is found. If the auto-commission bit of the
corresponding entry in the Managed Device List is set to zero (FALSE),
commissioning does not occur. If the auto-commission bit is set to 1 (TRUE),
the Device Manager updates this output network variable when a device is
found and immediately commissions the newly discovered device.
A device is considered to have been discovered after the Device Manager
receives the device’s Neuron ID (either via the discovery process or via service
pin message) and successfully reads its Program ID, Location String, and
state variable. At this point, a DMREP_DEVICE_DISCOVERED report is
generated and a DMEVNT_FOUND_xxx event is recorded in the Device
Manager internal event log.
This report uses the DmDeviceDiscovered struct defined in
dmobj.h
.
DMREP_FATAL_ERROR
The DMREP_FATAL_ERROR report is issued by the Device Manager when
the Device Manager encounters a fatal error and can no longer function. The
internal event log may be examined to determine the cause of the failure.
This report uses the DmFatalErrorReport struct defined in
dmobj.h
.
DM_Event
Whenever an event occurs, the Device Manager firmware writes an event code
(
DmEventType
) to its internal event log, and optionally sends the event code on
this network variable (see Send Async under Event Log, later in this chapter).
Event codes are defined by the
DmEventType
enumeration (see Event List,
below). The event log contains entries of the type
DmEventLogEntry
. See
dmobj.h
in
\L ON W ORKS \DM\include
for more details.
Event Log (LM Object Index 15)
DL_Clear
DL_Enable DL_Level_Full
Event Log
Figure 6.3 – Event Log Functional Block
The Device Manager contains an Event Log functional block (see figure 6.3) that
captures network events which can be useful for network troubleshooting. The
network variables on this functional block are described in table 6.3.