Variable ChargingPreferencesComponentConst

Type declaration

• Readonlyattributes: {
      approximateEvEfficiency: OptionalWritableAttribute<number | null, any>;
      nextChargeRequiredEnergy: Attribute<number | bigint | null, any>;
      nextChargeStartTime: Attribute<number | null, any>;
      nextChargeTargetSoC: Attribute<number | null, any>;
      nextChargeTargetTime: Attribute<number | null, any>;
  }

  • ReadonlyapproximateEvEfficiency: OptionalWritableAttribute<number | null, any>

    Indicates the vehicle efficiency rating for a connected vehicle.

    This can be used to help indicate to the user approximately how many miles or km of range will be added. It allows user interfaces to display to the user simpler terms that they can relate to compared to kWh.

    This is value is stored in km per kWh multiplied by a scaling factor of 1000.

    A null value indicates that the EV efficiency is unknown and the NextChargeRequiredEnergy attribute cannot be converted from Wh to miles or km.

    To convert from Wh into Range:

    AddedRange (km) = AddedEnergy (Wh) x ApproxEVEfficiency (km/kWh x 1000) AddedRange (Miles) = AddedEnergy (Wh) x ApproxEVEfficiency (km/kWh x 1000) x 0.6213

    Example:

    ApproxEVEfficiency (km/kWh x 1000): 4800 (i.e. 4.8km/kWh x 1000)

    AddedEnergy (Wh): 10,000

    AddedRange (km) = 10,000 x 4800 / 1,000,000 = 48 km

    AddedRange (Miles) = AddedEnergy (Wh) x ApproxEVEfficiency (km/kWh x 1000) x 0.6213

    = 29.82 Miles

    See

    MatterSpecification.v13.Cluster § 9.3.8.16

  • ReadonlynextChargeRequiredEnergy: Attribute<number | bigint | null, any>

    Indicates the amount of energy that the EVSE is going to attempt to add to the vehicle in the next charging target.

    If this is null it indicates that there is no scheduled charging, or that the EVSE is using the TargetSoC method to charge the vehicle.

    See

    MatterSpecification.v13.Cluster § 9.3.8.14

  • ReadonlynextChargeStartTime: Attribute<number | null, any>

    Indicates the time, in UTC, when the EVSE plans to start the next scheduled charge based on the charging preferences.

    If this is null it indicates that there is no scheduled charging, or that the vehicle is not plugged in.

    See

    MatterSpecification.v13.Cluster § 9.3.8.12

  • ReadonlynextChargeTargetSoC: Attribute<number | null, any>

    Indicates the target SoC the EVSE is going to attempt to reach when the vehicle is next charged.

    If this is null it indicates that there is no scheduled charging, or that the EVSE cannot obtain the current State of Charge from the vehicle.

    If the SOC feature is not supported, only the values null and 100% are supported.

    See

    MatterSpecification.v13.Cluster § 9.3.8.15

  • ReadonlynextChargeTargetTime: Attribute<number | null, any>

    Indicates the time, in UTC, when the EVSE SHOULD complete the next scheduled charge based on the charging preferences.

    If this is null it indicates that there is no scheduled charging, or that the vehicle is not plugged in.

    See

    MatterSpecification.v13.Cluster § 9.3.8.13

• Readonlycommands: {
      clearTargets: Command<void, void, any>;
      getTargets: Command<void, TypeFromFields, any>;
      setTargets: Command<TypeFromFields, void, any>;
  }

  • ReadonlyclearTargets: Command<void, void, any>

    Allows a client to clear all stored charging targets.

    See

    MatterSpecification.v13.Cluster § 9.3.9.8

  • ReadonlygetTargets: Command<void, TypeFromFields, any>

    Allows a client to retrieve the current set of charging targets.

    See

    MatterSpecification.v13.Cluster § 9.3.9.6

  • ReadonlysetTargets: Command<TypeFromFields, void, any>

    Allows a client to set the user specified charging targets.

    See

    MatterSpecification.v13.Cluster § 9.3.9.5