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

> Dados relacionados ao funcionamento e recarga de um veículo elétrico

## hv\_battery\_voltage

Tensão da Bateria de alta tensão (HV)

* Descrição: tensão da bateria de alta tensão
* Formato: numérico
* Unidade: V
* Casas decimais: 2
  * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos
* Faixa: 0 a 1000 V
  * A faixa de tensão da bateria HV foi definida com base no valor máximo que os veículos conectados à mobway podem atingir, considerando uma margem de segurança
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes
  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## hv\_battery\_soc

Estado de Carga da Bateria HV

* Descrição: estado de carga da bateria de alta tensão
* Formato: numérico
* Unidade: %
* Casas decimais: 2
  * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos
* Faixa: 0 a 100%
  * A faixa do estado de carga da bateria hv foi definida com base nos valores limite por definição
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes
  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## hv\_battery\_charging\_status

Estado de Carregamento da Bateria HV

* Descrição: estado de carregamento da bateria de alta tensão

* Formato: categórico

* Valores:
  * charging (carregando)
    * Descrição: indica que a bateria hv está carregando
  * not charging (não carregando)
    * Descrição: indica que a bateria hv não está carregando
  * charged (carregado)
    * Descrição: indica que o carregamento da bateria hv terminou
  * charging error (erro de carregamento)
    * Descrição: indica que ocorreu um erro no carregamento da bateria hv
  * other (outro)
    * Descrição: indica que este estado de carregamento da bateria hv não foi mapeado pela mobway

* Disponibilidade: Este dado esta disponível apenas em veículos elétricos ou híbridos

* Exemplo:

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