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

# Interfaces

> Descrição e unidades de medida das interfaces disponíveis na Agroop API.

As interfaces identificam o tipo de medição devolvido pela **Agroop API**. Cada interface tem um nome próprio, que deve ser utilizado nos pedidos de leituras.

Os equipamentos podem disponibilizar conjuntos de interfaces diferentes. Antes de pedir leituras, confirme quais as interfaces disponíveis no equipamento em causa e utilize apenas essas interfaces nos pedidos.

Nas interfaces relacionadas com o solo, o número no final do nome indica a profundidade da medição em centímetros. Nas tabelas, `XX` representa uma das profundidades suportadas. Por exemplo, `SMmm10` corresponde à humidade do solo calibrada aos 10 cm.

## Meteorologia

| Interface         | Descrição                                      | Unidade |
| ----------------- | ---------------------------------------------- | ------- |
| `AirTemp`         | Temperatura do ar                              | `°C`    |
| `AirHum`          | Humidade do ar                                 | `%`     |
| `WindDir`         | Direção do vento                               | `°`     |
| `WindSpeedRaw`    | Velocidade bruta do vento                      | `m/min` |
| `WindSpeed`       | Velocidade do vento convertida                 | `km/h`  |
| `GustSpeedRaw`    | Velocidade bruta das rajadas                   | `m/min` |
| `GustSpeed`       | Velocidade das rajadas convertida              | `km/h`  |
| `Sunlight`        | Luz solar                                      | `lux`   |
| `SolarIrradiance` | Radiação solar                                 | `W/m²`  |
| `Precipitation`   | Quantidade de precipitação entre duas leituras | `mm`    |
| `DewPoint`        | Ponto de orvalho                               | `°C`    |
| `Pressure`        | Pressão atmosférica                            | `kPa`   |
| `UltraViolet`     | Radiação ultravioleta                          | `UV`    |

## Humidade do solo

`SMraw` representa o valor bruto da humidade do solo antes da aplicação de uma calibração dependente do tipo de solo. `SMmm` representa o valor após essa calibração. Ambos os valores são expressos em milímetros.

| Interfaces | Descrição                                                   | Unidade |
| ---------- | ----------------------------------------------------------- | ------- |
| `SMrawXX`  | Valor bruto da humidade do solo à profundidade indicada     | `mm`    |
| `SMmmXX`   | Valor calibrado da humidade do solo à profundidade indicada | `mm`    |

## Temperatura e salinidade do solo

| Interfaces       | Descrição                                           | Unidade |
| ---------------- | --------------------------------------------------- | ------- |
| `SoilTempXX`     | Temperatura do solo à profundidade indicada         | `°C`    |
| `SoilSalinityXX` | Eletrocondutividade do solo à profundidade indicada | `dS/m`  |

## Caudalímetro

Os caudalímetros registam o consumo através de `ticks`. Cada `tick` corresponde a um volume definido pelo fator de conversão do equipamento, que pode ser, por exemplo, `1 L`, `10 L` ou `100 L`.

| Interface        | Descrição                                                                                             | Unidade     |
| ---------------- | ----------------------------------------------------------------------------------------------------- | ----------- |
| `Flowmeter`      | Volume de água registado entre duas leituras consecutivas                                             | `L`         |
| `FlowmeterTotal` | Volume total de água acumulado desde a instalação do caudalímetro                                     | `L`         |
| `FlowmeterAvg`   | Caudal médio entre leituras, calculado a partir dos ticks, do fator de conversão e do tempo decorrido | `L/min`     |
| `TicksCount`     | Número de ticks registados entre duas leituras consecutivas                                           | `ticks`     |
| `TicksTotal`     | Número total de ticks acumulados desde a instalação do caudalímetro                                   | `ticks`     |
| `TicksAvg`       | Média de ticks registados por minuto                                                                  | `ticks/min` |

## Entrada e perda de água no solo

`WaterEntrance` e `WaterLoss` são calculados a partir da diferença entre leituras consecutivas da humidade do solo. O número no final do nome indica a profundidade da medição.

| Interfaces        | Descrição                                                                         | Unidade |
| ----------------- | --------------------------------------------------------------------------------- | ------- |
| `WaterEntranceXX` | Diferença positiva entre a leitura atual e a leitura anterior da humidade do solo | `mm`    |
| `WaterLossXX`     | Diferença negativa entre a leitura atual e a leitura anterior da humidade do solo | `mm`    |

## Outros dados

| Interface | Descrição                           | Unidade |
| --------- | ----------------------------------- | ------- |
| `Bat`     | Tensão da bateria                   | `V`     |
| `Rssi`    | Intensidade do sinal de comunicação | `dBm`   |