Skip to main content

ConversionError

Enum ConversionError 

Source
#[non_exhaustive]
pub enum ConversionError { TransactionIdNotInteger(String), PurposeNotInVersion { purpose: Purpose, version: Version, }, UnmodelledKind(&'static str), UnknownValue { field: &'static str, value: String, }, NoSchedule, SchedulesNotInVersion(usize), PeriodWithoutLimit { period: usize, }, UnmodelledField { field: &'static str, period: Option<usize>, }, OutOfRange { field: &'static str, }, }
Expand description

Why a profile could not cross the wire.

The domain Profile across the wire, in both directions, for every version.

A CSMS sends a Profile as a SetChargingProfileRequest; a station — or a Local Controller that wants to know what the CSMS asked for — turns a received ChargingProfile back into a Profile for the composite calculation. Each direction refuses, with a ConversionError, every field the other side cannot carry with its meaning: a default here would be a profile the station applies differently from the one that was sent.

What is refused, and why:

  • 1.6 numbers transactions; a domain transaction id that is not an integer cannot be a 1.6 TxProfile (it would bind to another transaction, or to none).
  • Purposes a version lacks — 1.6 has no ChargingStationExternalConstraints, neither 1.6 nor 2.0.1 has PriorityCharging or LocalGeneration.
  • 2.1 Dynamic profiles, periods without a limit, and everything that is not a plain ceiling: limit_L2/limit_L3 (which turn limit into a per-phase value), discharge limits, setpoints, V2X curves and baselines, an operationMode other than ChargingOnly, limitAtSoC, useLocalTime, randomizedDelay. Those are V2X control (block Q), not a limit schedule — build those with v2x, which produces the wire profile directly.
  • 1.6 phaseToUse, which 1.6 cannot say.

Carried by neither direction, on purpose, because none of them changes the limit: the ISO 15118 tariff and price schedules and their signatures, customData, 2.1 powerTolerance, evseSleep, preconditioningRequest, and the 2.1 offline fields (maxOfflineDuration, invalidAfterOfflineDuration) — the composite here is the one that applies while online.

use ocpp_kit::smart_charging::{Period, Profile, ProfileKind, Purpose, RateUnit, Schedule};
use ocpp_kit::types::Decimal;

let profile = Profile::new(
    1,
    0,
    Purpose::TxProfile,
    ProfileKind::Relative,
    Schedule::new(1, RateUnit::A, vec![Period::new(0, Decimal::from(16))]),
)
.on_evse(1)
.for_transaction("42");

let request = profile.set_request_v1_6()?;          // 1.6 numbers its transactions
assert_eq!(request.cs_charging_profiles.transaction_id, Some(42));
let back = Profile::from_v1_6(&request.cs_charging_profiles, 1)?;
assert_eq!(back, profile);

let not_a_number = profile.clone().for_transaction("abc");
assert!(not_a_number.to_v1_6().is_err());

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

TransactionIdNotInteger(String)

A 1.6 TxProfile needs an integer transaction id.

§

PurposeNotInVersion

The version has no such purpose.

Fields

§purpose: Purpose

The purpose.

§version: Version

The version.

§

UnmodelledKind(&'static str)

A profile kind the domain does not model (2.1 Dynamic).

§

UnknownValue

An enumeration value the station sent that no version defines, kept by lenient decoding.

Fields

§field: &'static str

The field.

§value: String

What arrived.

§

NoSchedule

A profile without a schedule.

§

SchedulesNotInVersion(usize)

1.6 carries exactly one schedule per profile.

§

PeriodWithoutLimit

A 2.1 period without a limit — a setpoint operation mode, not a ceiling.

Fields

§period: usize

The period’s index.

§

UnmodelledField

A field that would change what the profile means, which the target cannot carry.

Fields

§field: &'static str

The wire name of the field.

§period: Option<usize>

The period’s index, for a period field.

§

OutOfRange

A number that does not fit the target’s integer type.

Fields

§field: &'static str

The field.

Trait Implementations§

Source§

impl Clone for ConversionError

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ConversionError

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Display for ConversionError

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Eq for ConversionError

Source§

impl Error for ConversionError

Available on crate feature std only.
1.30.0 · Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Replaced by Error::source.
Source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type-based access to context intended for error reports. Read more
Source§

impl PartialEq for ConversionError

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ConversionError

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.