NetSure
™
Control Unit (NCU)
User Manual, UM1M830BNA
Spec. No: 1M830BNA, 1M830DNA Code: UM1M830BNA
Model No: M830B, M830D Revision M, May 12, 2017
RETRIEVE EQUIPMENT
(RTRV-EQPT)
General Description: This command message retrieves the software version of the specified equipment. For this application it retrieves
the controller software version and the controller software configuration part number and revision.
NCU Access Level: any access level
Input Format:
RTRV-EQPT:[<tid>]:<aid>:<ctag>;
<aid>
The AID parameter specifies the equipment whose information is to be retrieved. Valid values for the AID in this
application are “SYSTEM” and “ALL”. Both values will retrieve only the software version information for the power system
controller.
Normal Response Format:
cr lf lf
^^^<source identifier>^<date>^<time> cr lf
M^^<ctag>^COMPLD cr lf
^^^”<aid>:[<eqpt_type>]:[<cur_eqpt>]:[SWVER=<swver>],
[CURSWVER=<curswver>],[DSPSWVER=<dspswver>]:<state>,[<sst>]” crlf ;
<aid>
This is the type of access identifier of the equipment whose information is being provided. This value is always “SYSTEM”
indicating that it is the system processor (i.e., controller).
<eqpt_type>
This is the type of equipment installed. Valid values for this application is the controller part number.
<cur_eqpt>
This is the type of equipment actually installed. Valid values for this application is <null>.
<swver>
Version of software that is configured. This is an ASCII string from one to thirty-two characters. The value of this parameter
is the controller’s software configuration part number and revision (e.g., “552365AB”). If no configuration part number is
available, the value is <null>.
<curswver>
Version of software that is actually installed. This is an ASCII string from one to thirty-two characters. The value of this
parameter is the controller’s software version (e.g., “1.30”). If no software version is available, the value is <null>.
<dspswver>
Version of DSP code on the device. This parameter does not apply to this application. A value of <null> is always outputted
for this parameter.
<state>
This is the operational state of the equipment. Valid values are: IS-NR (In Service – Normal), OOS-AUMA (Out Of Service –
Autonomous and Management). A value of IS-NR” should always be returned because a response to the command
indicates that the controller is operational.