Skip to content

GuyKh/ims-envista-custom-component

Repository files navigation

Israel Meteorological Service (IMS) Envista Custom Component

GitHub Release GitHub Activity License

Project Maintenance BuyMeCoffee

Integration to integrate with IMS Envista API.

This integration could set up the following conditions.

Example Image

Read more here at Observation Data API Documentation

IMS also has a map of stations

For deeper understanding in what every condition means, please read IMS Documentation

Condition Description
station_name Station Name
last_update Last Date/Time where the station data was updated
rh Relative Humidity (%)
rain Amount of rain (mm)
rain_1_min Rainfall (mm)
wd Wind Direction (deg)
wd_max Top Gust Wind Direction (deg)
std_wd Standard Deviation of Wind Direction (deg)
ws Wind Speed (m/sec)
ws_1mm Maximal 1min Wind Speed (m/sec)
ws_10mm Maximal 10min Wind Speed (m/sec)
ws_max Top Gust Wind Speed (m/sec)
td Dry Temperature (Celsius deg)
td_max Maximal Temperature (Celsius deg)
td_min Minimal Temperature (Celsius deg)
tg Grass Minimum Temperature (Celsius deg)
bp Barometric Pressure (hPa)
diff Diffused Radiation ($\frac{w}{m^2}$)
grad Global Radiation ($\frac{w}{m^2}$)
nip Direct Radiation ($\frac{w}{m^2}$)

Installation

Automatic (HACS):

  1. Add this path to HACS: https://github.com/GuyKh/ims-envista-custom-component
  2. Install through HACS

Manual:

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called ims_envista.
  4. Download all the files from the custom_components/ims_envista/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "IMS Envista"

Configuration is done in the UI

Logs

To view logs in debug add this to configuration.yaml:

logger:
  default: info
  logs:
    ...
    custom_components.ims_envista: debug
    ims_envista: debug

Frequently Asked Questions

How to get an IMS Envista API Token?

Contact IMS by sending a mail to this address

Can I use this custom component without an API key

No

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines