opev

Documentation

Index

• Constants
• type OPEV
  • func NewOPEV(localEntity spineapi.EntityLocalInterface, eventCB api.EntityEventCallback) *OPEV
  • func (e *OPEV) AddFeatures()
  • func (e *OPEV) CurrentLimits(entity spineapi.EntityRemoteInterface) ([]float64, []float64, []float64, error)
  • func (e *OPEV) HandleEvent(payload spineapi.EventPayload)
  • func (e *OPEV) LoadControlLimits(entity spineapi.EntityRemoteInterface) (limits []ucapi.LoadLimitsPhase, resultErr error)
  • func (e *OPEV) WriteLoadControlLimits(entity spineapi.EntityRemoteInterface, limits []ucapi.LoadLimitsPhase, ...) (*model.MsgCounterType, error)

Constants

const (
	// Update of the list of remote entities supporting the Use Case
	//
	// Use `RemoteEntities` to get the current data
	UseCaseSupportUpdate api.EventType = "cem-opev-UseCaseSupportUpdate"

	// EV current limits
	//
	// Use `CurrentLimits` to get the current data
	DataUpdateCurrentLimits api.EventType = "cem-opev-DataUpdateCurrentLimits"

	// EV load control obligation limit data updated
	//
	// Use `LoadControlLimits` to get the current data
	DataUpdateLimit api.EventType = "cem-opev-DataUpdateLimit"
)

Types

type OPEV

type OPEV struct {
	*usecase.UseCaseBase
}

func NewOPEV

func NewOPEV(localEntity spineapi.EntityLocalInterface, eventCB api.EntityEventCallback) *OPEV

func (*OPEV) AddFeatures

func (e *OPEV) AddFeatures()

func (*OPEV) CurrentLimits

func (e *OPEV) CurrentLimits(entity spineapi.EntityRemoteInterface) ([]float64, []float64, []float64, error)

return the min, max, default limits for each phase of the connected EV

possible errors:

• ErrDataNotAvailable if no such measurement is (yet) available
• and others

func (*OPEV) HandleEvent

func (e *OPEV) HandleEvent(payload spineapi.EventPayload)

handle SPINE events

func (*OPEV) LoadControlLimits

func (e *OPEV) LoadControlLimits(entity spineapi.EntityRemoteInterface) (
	limits []ucapi.LoadLimitsPhase, resultErr error)

return the current loadcontrol obligation limits

parameters:

• entity: the entity of the EV

return values:

• limits: per phase data

possible errors:

• ErrDataNotAvailable if no such limit is (yet) available
• and others

func (*OPEV) WriteLoadControlLimits

func (e *OPEV) WriteLoadControlLimits(
	entity spineapi.EntityRemoteInterface,
	limits []ucapi.LoadLimitsPhase,
	resultCB func(result model.ResultDataType),
) (*model.MsgCounterType, error)

send new LoadControlLimits to the remote EV

parameters:

• entity: the entity of the e.g. EVSE
• limits: a set of limits containing phase specific limit data
• resultCB: callback function for handling the result response

Sets a maximum A limit for each phase that the EV may not exceed. Mainly used for implementing overload protection of the site or limiting the maximum charge power of EVs when the EV and EVSE communicate via IEC61851 and with ISO15118 if the EV does not support the Optimization of Self Consumption usecase.

note: For obligations to work for optimizing solar excess power, the EV needs to have an energy demand. Recommendations work even if the EV does not have an active energy demand, given it communicated with the EVSE via ISO15118 and supports the usecase. In ISO15118-2 the usecase is only supported via VAS extensions which are vendor specific and needs to have specific EVSE support for the specific EV brand. In ISO15118-20 this is a standard feature which does not need special support on the EVSE.