Please :star: this repo if you find it useful
Component to integrate with Narodmon cloud and automatic search for the nearest sensors of the required type.
configuration.yaml
. Support for configuration via Home Assistant UI will be added in the future.Unavailable
state. As data is received from the server, all sensors will receive their values.apikey
is no longer required and is not recommended. Fill it out only if you already have your own API key with special limits. Otherwise, remove this field from your configuration.configuration.yaml
...\
follow instructions below, then restart Home Assistant.configuration.yaml
).custom_components
directory (folder) there, you need to create it.custom_components
directory (folder) create a new folder called narodmon
.narodmon.zip
from the latest release section in this repository.configuration.yaml
...\
follow instructions below, then restart Home Assistant.# Example configuration.yaml entry
narodmon:
devices:
- name: "Narodmon"
sensors:
- temperature
- humidity
- pressure
* * *
I put a lot of work into making this repo and component available and updated to inspire and help others! I will be glad to receive thanks from you — it will give me new strength and add enthusiasm:
or support via Bitcoin or Etherium:
16yfCfz9dZ8y8yuSwBFVfiAa3CNYdMh7Ts
apikey:\ (string) (Optional)\ The API key is a unique identifier that authenticates requests associated with your project.
Note:\ This field is no longer required and is not recommended. Fill it out only if you already have your own API key with special limits.
To obtain a key, you need to register on narodmon.com, then open the menu item
Profile
>My applications
>New key
and create an API key. You can give any name to the key at your discretion.
devices:\ (list) (Required)\ List of virtual devices with uniform settings. See details below.
verify_ssl:\ (boolean) (Optional) (Default value: True)\ Verify SSL/TLS certificate for HTTPS request.
timeout:\ (number) (Optional) (Default value: 10)\ Timeout for the connection in seconds.
Each virtual device in a list have the following settings:
name:\ (template) (Required)\ Name of the device.
latitude:\ (float) (Optional) (Default value: Your home zone latitude defined in your configuration)\ Latitude of the center point of the sensor search area. The sensor closest to this point is always selected.
longitude:\ (float) (Optional) (Default value: Your home zone longitude defined in your configuration)\ Longitude of the center point of the sensor search area. The sensor closest to this point is always selected.
show_on_map:\ (boolean) (Optional)\ Enables showing the location of the weather station on the map.\ Default value: false
search_area_radius:\ (float) (Optional) (Default value: 10 km)\ Maximum allowed distance from described location to sensor location.
scan_interval:\
(number) (Optional) (Default value: 3 minutes)\
Minimum time interval between updates. Supported formats: scan_interval: 'HH:MM:SS'
, scan_interval: 'HH:MM'
and Time period dictionary.
Note:\ Since the service has data update limits, if you configure several sensors, the actual data update period may be proportionally longer than the one specified in this field.
Updates more than once a minute are prohibited by Narodmon and can lead to permanent blocking of your account.
sensors:\
(list) (Optional) (Default value: all listed here sensor types)\
Types of sensors to be created. Available types:
temperature
, humidity
, pressure
, wind_speed
, wind_bearing
, precipitation
, illuminance
, radiation
, uv
, pm
You can automatically track new versions of this component and update it by HACS.
To enable debug logs use this configuration:
# Example configuration.yaml entry
logger:
default: info
logs:
custom_component.narodmon: debug
... then restart HA.
This is an active open-source project. We are always open to people who want to use the code or contribute to it.
We have set up a separate document containing our contribution guidelines.
Thank you for being involved! :heart_eyes:
The original setup of this component is by Andrey "Limych" Khrolenok.
For a full list of all authors and contributors, check the contributor's page.
This Home Assistant custom component was created and is updated using the HA-Blueprint template. You can use this template to maintain your own Home Assistant custom components.
creative commons Attribution-NonCommercial-ShareAlike 4.0 International License
See separate license file for full text.