Silver Spring Networks Command Flows
The table below lists the communication flows used with each Silver Spring Networks command, including:
• Command: The specific smart meter command
• Outbound Communication: The outbound communication business object created by the command. This sends the command request to the head end system.
◦ Get Status Outbound Communication: The outbound communication business object used to request the status of a command request
◦ Result Outbound Communication: The outbound communication business object used to request the result of a command request
• Outbound Messages: The outbound message business objects for one or more outbound messages created by the outbound communication. These should be configured on the Silver Spring Networks external system.
• Completion Event: The completion event(s) triggered by the command, if any. Completion events are used to update data in the system as a result of a smart meter command. For example, if a command changes the status of a device, the completion event is responsible for making that change.
Command
Outbound Communication
Outbound Messages
Completion Event
Device Commissioning
SSN - Replace Location (D7-ReplaceLocationDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Replace Location:
SSN - Replace Location (Comm) OB Message (D7-ReplaceLocationOBMsg)
Device Commissioning Completion Event
Device Decommissioning
SSN - Replace Device At Location (Decomm) (D7-ReplDeviceAtLocForDecommDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Replace Device at Location:
SSN - Replace Device At Loc O/B Message: (D7-ReplaceDeviceAtLocOBMsg)
Device Decommissioning Completion Event
Remote Connect
SSN - Connect or Disconnect (D7-ConnectDisconnectDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Connect Disconnect:
SSN - Connect Disconnect OB Message (D7-ConnectDisconnectOBMsg)
Connect Device Completion Event
Get Status: SSN - Get Status (D7-GetStatus)
SSN - Get Job Status Outbound Message (D7-GetJobStatusOutboundMsg)
Result: SSN - Connect Disconnect Results (D7-ConnectDisconnectResultDR)
SSN - GetConnectDisconnectResult OB Message (D7-GetCntDiscntResultOBMsg)
Remote Disconnect
SSN - Connect or Disconnect (D7-ConnectDisconnectDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Connect Disconnect:
SSN - Connect Disconnect OB Message (D7-ConnectDisconnectOBMsg)
Disconnect Device Completion Event
Get Status: SSN - Get Status (D7-GetStatus)
SSN - Get Job Status Outbound Message (D7-GetJobStatusOutboundMsg)
Result: SSN - Connect Disconnect Results (D7-ConnectDisconnectResultDR)
SSN - GetConnectDisconnectResult OB Message (D7-GetCntDiscntResultOBMsg)
On-Demand Read (Scalar)
SSN - Add Meter Read Job (Scalar)
(D7-AddMeterReadJobScalarDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Add Meter Read Job Scalar: SSN - Add Meter Read Job Scalar OB Msg Type
(D7-AddMeterReadJobScalarOBMsg)
Create IMD Completion Event
Get Status: SSN - Get Status (D7-GetStatus)
SSN - Get Job Status Outbound Message (D7-GetJobStatusOutboundMsg)
Result: SSN - Meter Read Results (Scalar)
(D7-MeterReadResultsScalar)
SSN - GetMeterReadResults(Scalar) By JobId
(D7-GetSclrMtrRdRstByJobIdOBMsg)
On-Demand Read (Interval)
SSN - Add Meter Read Job (Interval)
(D7-AddMeterReadJobIntervalDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Add Meter Read Job Interval: SSN - AddMeterReadJob Interval OB Msg Type
(D7-AddMeterReadJobIntervalOBMsg)
Create IMD Completion Event
Get Status: SSN - Get Status (D7-GetStatus)
SSN - Get Job Status Outbound Message (D7-GetJobStatusOutboundMsg)
Result: SSN - Meter Read Results (Interval)
(D7-MeterReadResultsInterval)
SSN - GetMeterReadResults(Interval) By JobId
(D7-GetIntMtrRdRsltByJobIdOBMsg)
Device Status Check
SSN - Add Ping Job (D7-AddPingJobDR)
Find Device:
SSN - Find Device Outbound Message (D7-FindDeviceOutboundMsg)
Add Ping Job:
SSN - Add Ping Job OB Message (D7-AddPingJobOBMsg)
Get Status: SSN - Get Status (D7-GetStatus)
SSN - Get Job Status Outbound Message (D7-GetJobStatusOutboundMsg)
Result: SSN - Ping Results (D7-PingResultsDR)
SSN - Get Ping Results O/B Message (D7-GetPingResultsOBMsg)
Unit of Measure Filtering for On-Demand Reads
Readings returned via On-Demand Read commands are filtered on the combination of Unit of Measure/Time of Use/Service Quantity Identifiers (UOM/TOU/SQI) configured for the device and measuring component. When filtering is enabled, only readings that match a configured UOM/TOU/SQI combination are processed. All others are filtered out.
Filtering is enabled by default via the “Opt Out Of Filtering” parameter (set to "false" by default) on the D7-CCOMPEVSR (SSN - Create Completion Event Scalar) algorithm on the Create Completion Events status of the D7-MeterReadResultsScalar (SSN - Meter Read Results (Scalar)) business object (for scalar on-demand read commands) and/or on the D7-CCEVTINDR (SSN - Create Completion Event Interval) algorithm on the Create Completion Events status of the D7-MeterReadResultsInterval (SSN - Meter Read Results (Interval)) business object (for interval on-demand read commands).
When filtering is enabled, the “Filter if invalid external MC identifier” parameter on the D7-CCOMPEVSR and D7-CCEVTINDR algorithms controls what should happen if a measuring component cannot be found using the MC Identifier Number sent from the head end system. When set to 'Yes' and no measuring component is found, the initial measurement will be filtered. When set to 'No' and no measuring component is found, the system will attempt to find the measuring component using the UOM and TOU. The value of the “Filter if invalid external MC identifier” on the D7-CCOMPEVSR and D7-CCEVTINDR algorithms must match the value of the “Error if invalid external MC identifier” parameter on the D1-DER-SPRMC algorithm on the IMD Seeder (D1-IMDSeeder) business object. The parameters should both be set to either "yes" or "no".