> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobway.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# EV

> Data related to the operation and charging of an electric vehicle

## hv\_battery\_voltage

High-Voltage (HV) Battery Voltage

* Description: high-voltage battery voltage
* Format: numeric
* Unit: V
* Decimal places: 2
  * Data processed by mobway will always have up to 2 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 2 decimal places when it ends in 0 due to automatic float formatting
* Availability: This data is available only for electric or hybrid vehicles
* Range: 0 to 1000 V
  * The HV battery voltage range was defined based on the maximum value that vehicles connected to mobway can reach, applying a safety margin
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "hv_battery_voltage": {
    "value": 1005.89,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "hv_battery_voltage": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "hv_battery_voltage": 625.89
}
```

## hv\_battery\_soc

HV Battery State of Charge

* Description: high-voltage battery state of charge
* Format: numeric
* Unit: %
* Decimal places: 2
  * Data processed by mobway will always have up to 2 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 2 decimal places when it ends in 0 due to automatic float formatting
* Availability: This data is available only for electric or hybrid vehicles
* Range: 0 to 100%
  * The HV battery state-of-charge range was defined based on the boundary values by definition
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "hv_battery_soc": {
    "value": 153.14,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "hv_battery_soc": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "hv_battery_soc": 73.42
}
```

## hv\_battery\_charging\_status

HV Battery Charging Status

* Description: high-voltage battery charging status

* Format: categorical

* Values:
  * charging (charging)
    * Description: indicates that the HV battery is charging
  * not charging (not charging)
    * Description: indicates that the HV battery is not charging
  * charged (charged)
    * Description: indicates that HV battery charging has finished
  * charging error (charging error)
    * Description: indicates that an HV battery charging error occurred
  * other (other)
    * Description: indicates that this HV battery charging status was not mapped by mobway

* Availability: This data is available only for electric or hybrid vehicles

* Example:

```json theme={null}
{
  "hv_battery_charging_status": "charging" 
}
```