Package org.lfenergy.compas.sct.commons

Class ControlBlockService

java.lang.Object

org.lfenergy.compas.sct.commons.ControlBlockService

All Implemented Interfaces:

ControlBlockEditor

public class ControlBlockService
extends Object
implements ControlBlockEditor

Constructor Summary

Constructors

Constructor	Description
ControlBlockService()

Method Summary

Modifier and Type	Method	Description
List<SclReportItem>	analyzeDataGroups(SCL scd)	Checks Control Blocks, DataSets and FCDA number limitation into Access Points
List<SclReportItem>	configureNetworkForAllControlBlocks(SCL scd, ControlBlockNetworkSettings controlBlockNetworkSettings, ControlBlockNetworkSettings.RangesPerCbType rangesPerCbType)	Configure the network for all the ControlBlocks.
List<SclReportItem>	createDataSetAndControlBlocks(SCL scd, String targetIedName, String targetLDeviceInst, Set<FcdaForDataSetsCreation> allowedFcdas)	Create All DataSet and ControlBlock for the ExtRef in given IED and LDevice
List<SclReportItem>	createDataSetAndControlBlocks(SCL scd, String targetIedName, Set<FcdaForDataSetsCreation> allowedFcdas)	Create All DataSet and ControlBlock for the ExtRef in given IED
List<SclReportItem>	createDataSetAndControlBlocks(SCL scd, Set<FcdaForDataSetsCreation> allowedFcdas)	Create All DataSet and ControlBlock in the SCL based on the ExtRef
void	removeAllControlBlocksAndDatasetsAndExtRefSrcBindings(SCL scl)	Removes all ControlBlocks and DataSets for all LNs in SCL

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ControlBlockService

public ControlBlockService()

Method Details

analyzeDataGroups

public List<SclReportItem> analyzeDataGroups(SCL scd)

Description copied from interface: ControlBlockEditor

Checks Control Blocks, DataSets and FCDA number limitation into Access Points

Specified by:

analyzeDataGroups in interface ControlBlockEditor

Parameters:

scd - SCL file for which LDevice should be activated or deactivated

Returns:

list of encountered errors

createDataSetAndControlBlocks

public List<SclReportItem> createDataSetAndControlBlocks(SCL scd,
 Set<FcdaForDataSetsCreation> allowedFcdas)

Description copied from interface: ControlBlockEditor

Create All DataSet and ControlBlock in the SCL based on the ExtRef

Specified by:

createDataSetAndControlBlocks in interface ControlBlockEditor

Parameters:

scd - input SCD object. It could be modified by adding new DataSet and ControlBlocks

allowedFcdas - List of allowed FCDA for DataSets and Control Blocks creation

Returns:

list of encountered errors

createDataSetAndControlBlocks

public List<SclReportItem> createDataSetAndControlBlocks(SCL scd,
 String targetIedName,
 Set<FcdaForDataSetsCreation> allowedFcdas)

Description copied from interface: ControlBlockEditor

Create All DataSet and ControlBlock for the ExtRef in given IED

Specified by:

createDataSetAndControlBlocks in interface ControlBlockEditor

Parameters:

scd - input SCD object. The object will be modified with the new DataSet and ControlBlocks

targetIedName - the name of the IED where the ExtRef are

allowedFcdas - List of allowed FCDA for DataSets and Control Blocks creation

Returns:

list of encountered errors

createDataSetAndControlBlocks

public List<SclReportItem> createDataSetAndControlBlocks(SCL scd,
 String targetIedName,
 String targetLDeviceInst,
 Set<FcdaForDataSetsCreation> allowedFcdas)

Description copied from interface: ControlBlockEditor

Create All DataSet and ControlBlock for the ExtRef in given IED and LDevice

Specified by:

createDataSetAndControlBlocks in interface ControlBlockEditor

Parameters:

scd - input SCD object. The object will be modified with the new DataSet and ControlBlocks

targetIedName - the name of the IED where the ExtRef are

targetLDeviceInst - the name of the LDevice where the ExtRef are

allowedFcdas - List of allowed FCDA for DataSets and Control Blocks creation

Returns:

list of encountered errors

configureNetworkForAllControlBlocks

public List<SclReportItem> configureNetworkForAllControlBlocks(SCL scd,
 ControlBlockNetworkSettings controlBlockNetworkSettings,
 ControlBlockNetworkSettings.RangesPerCbType rangesPerCbType)

Description copied from interface: ControlBlockEditor

Configure the network for all the ControlBlocks. Create (or update if already existing) these elements - the Communication/SubNetwork/ConnectedAP/GSE element, for the GSEControl blocks - the Communication/SubNetwork/ConnectedAP/SMV element, for the SampledValueControl blocks

Specified by:

configureNetworkForAllControlBlocks in interface ControlBlockEditor

Parameters:

scd - input SCD object. The object will be modified with the new DataGSESet and SMV elements

controlBlockNetworkSettings - a method tha gives the network configuration information for a given ControlBlock

rangesPerCbType - provide NetworkRanges for GSEControl and SampledValueControl. NetworkRanges contains : start-end app APPID range (long value), start-end MAC-Addresses (Mac-Addresses values: Ex: "01-0C-CD-01-01-FF")

Returns:

list of encountered errors

See Also:

• for the expected MAC address format
• ControlBlockNetworkSettings
• ControlBlockNetworkSettings.RangesPerCbType
• ControlBlockNetworkSettings.NetworkRanges

removeAllControlBlocksAndDatasetsAndExtRefSrcBindings

public void removeAllControlBlocksAndDatasetsAndExtRefSrcBindings(SCL scl)

Description copied from interface: ControlBlockEditor

Removes all ControlBlocks and DataSets for all LNs in SCL

Specified by:

removeAllControlBlocksAndDatasetsAndExtRefSrcBindings in interface ControlBlockEditor

Parameters:

scl - SCL file for which ControlBlocks and DataSets should be deleted