> ## 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.

# Engine

> Data related to engine operation and status

## rpm

Revolutions per Minute

* Description: engine revolutions per minute
* Format: numeric
* Unit: rpm
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 10000 rpm
  * The RPM range was defined based on the maximum value that vehicles connected to mobway can reach, including a safety margin
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "rpm": {
    "value": -1014.38,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "rpm": 3567.89
}
```

## oil\_level

Oil Level

* Description: amount of engine lubricating oil
* Format: numeric
* Unit: %
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 100%
  * The oil level range was defined based on the default limit values
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "oil_level": {
    "value": 125.60,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "oil_level": 82.37
}
```

## oil\_remaining\_life

Oil Remaining Life

* Description: percentage of remaining engine oil life
* Format: numeric
* Unit: %
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 100%
  * The oil remaining life range was defined based on the default limit values
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "oil_remaining_life": {
    "value": 107.12,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "oil_remaining_life": 37.92
}
```

## oil\_remaining\_life\_status

Oil Remaining Life Status

* Description: status of the remaining engine oil life
* Format: categorical
* Values:
  * extremely low
    * Description: indicates that the remaining engine oil life status is extremely low
  * low
    * Description: indicates that the remaining engine oil life status is low
  * normal
    * Description: indicates that the remaining engine oil life status is normal
  * unknown
    * Description: indicates that the remaining engine oil life status is unknown
* Example:

```json theme={null}
{
  "oil_remaining_life_status": "normal"
}
```

## engine\_coolant\_temperature

Engine Coolant Temperature

* Description: engine coolant temperature
* Format: numeric
* Unit: °C
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: -15°C to 150°C
  * The minimum engine coolant temperature value was defined based on the lowest ambient temperature reached in Brazil, including a safety margin. The maximum engine coolant temperature value was defined based on commonly reached maximum values, including a safety margin
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "engine_coolant_temperature": {
    "value": -25.34,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "engine_coolant_temperature": 98.75
}
```

## total\_engine\_idle\_time

Total Engine Idle Time

* Description: total time the engine is on while the vehicle is stopped
* Format: numeric
* Unit: s
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 100000000 s
  * The limit for total engine idle time was defined based on the equivalent of 8 hours per day over 10 years
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "total_engine_idle_time": {
    "value": -1023.12,
    "flag": "out of range"
  }
}
```

* Minimum and maximum variation: 0 and (1.1x + 2)s per second
  * The minimum and maximum variations for total engine idle time were defined to disregard minor inaccuracies
  * Data with variation outside the allowed limit compared to the previous data point is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "total_engine_idle_time": {
    "value": 43368.81,
    "flag": "variation out of limit"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "total_engine_idle_time": 9728308.75
}
```

## total\_engine\_run\_time

Total Engine Run Time

* Description: total time the engine is on while the vehicle is moving
* Format: numeric
* Unit: s
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 300000000 s
  * The limit for total engine run time was defined based on the equivalent of 24 hours per day over 10 years
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "total_engine_run_time": {
    "value": -1352.86,
    "flag": "out of range"
  }
}
```

* Minimum and maximum variation: 0 and (1.1x + 2)s per second
  * The minimum and maximum variations for total engine run time were defined to disregard minor inaccuracies
  * Data with variation outside the allowed limit compared to the previous data point is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "total_engine_run_time": {
    "value": 37268.11,
    "flag": "variation out of limit"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "total_engine_run_time": 73920308.35
}
```

## engine\_air\_filter\_diagnostic

Engine Air Filter Diagnostic

* Description: indicates the fault affecting the engine air filter
* Format: categorical
* Values:
  * blocked
    * Description: indicates that the engine air filter is blocked
  * inactive
    * Description: indicates that the engine air filter is inactive. All data related to the engine air filter should be ignored
  * indeterminate issue
    * Description: indicates that an indeterminate issue was found in the engine air filter
  * missing
    * Description: indicates that the engine air filter was not detected
  * ok
    * Description: indicates that the engine air filter is ok
  * other
    * Description: indicates that the vehicle sent a signal from a category not mapped by mobway

```json theme={null}
{
  "engine_air_filter_diagnostic": "blocked"
}
```

## engine\_air\_filter\_status

Engine Air Filter Status

* Description: indicates the engine air filter status
* Format: categorical
* Values:
  * disabled feature
    * Description: indicates that data related to the engine air filter is disabled
  * invalid feature
    * Description: indicates that data related to the engine air filter is invalid
  * ok
    * Description: indicates that the engine air filter is ok
  * change now
    * Description: indicates that the engine air filter should be changed now
  * change soon
    * Description: indicates that the engine air filter should be changed soon
  * other
    * Description: indicates that the vehicle sent a signal from a category not mapped by mobway

```json theme={null}
{
  "engine_air_filter_status": "change now"
}
```

## engine\_air\_filter\_remaining\_life

Engine Air Filter Remaining Life

* Description: estimate of how worn the engine air filter is
* Format: numeric
* Unit: %
* Decimal places: 2
  * The data processed by mobway will always have at most 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
* Range: 0 to 100%
  * The engine air filter remaining life range was defined based on the default limit values
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated to indicate the error and the original value, using the following format:

```json theme={null}
{
  "engine_air_filter_remaining_life": {
    "value": 132.12,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated to indicate that the original data was missing, using the following format:

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

* Example:

```json theme={null}
{
  "engine_air_filter_remaining_life": 91.98
}
```