From df430cc7f8248355aa668603615f67e25fa9e204 Mon Sep 17 00:00:00 2001 From: Paul Annekov Date: Sat, 7 May 2022 19:55:18 +0000 Subject: [PATCH 1/3] added doc --- source/_integrations/ukraine_alarm.markdown | 32 +++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 source/_integrations/ukraine_alarm.markdown diff --git a/source/_integrations/ukraine_alarm.markdown b/source/_integrations/ukraine_alarm.markdown new file mode 100644 index 000000000000..361f8f45b6c2 --- /dev/null +++ b/source/_integrations/ukraine_alarm.markdown @@ -0,0 +1,32 @@ +--- +title: Ukraine Alarm +description: Instructions on how to integrate Ukraine Alarm within Home Assistant. +ha_category: + - Other +ha_release: 2022.6 +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_codeowners: + - '@PaulAnnekov' +ha_domain: ukraine_alarm +ha_platforms: + - binary_sensor +ha_integration_type: integration +--- + +The Ukraine Alarm integration uses the [Ukraine Alarm](https://www.ukrainealarm.com/) web service as a source for air-raid sirens in Ukraine for your region. It's became very important since [Russian troops invasion](https://war.ukraine.ua/). + +For each region integration exposes 4 binary sensors: + +- Air +- Unknown +- Artillery +- Urban Fights + +Siren check interval is set to 10 seconds to don't overload API and be able to react quite fast. + +## Setup + +To generate an Ukraine Alarm API key, go to [Ukraine Alarm APIs](https://api.ukrainealarm.com/) page, fill in a form and wait for an email with an API key. + +{% include integrations/config_flow.md %} From 4736274a633432d863ead1014a9fb823645592a9 Mon Sep 17 00:00:00 2001 From: Paul Annekov Date: Sun, 8 May 2022 07:56:36 +0000 Subject: [PATCH 2/3] PR changes --- source/_integrations/ukraine_alarm.markdown | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/_integrations/ukraine_alarm.markdown b/source/_integrations/ukraine_alarm.markdown index 361f8f45b6c2..3073a9ed3745 100644 --- a/source/_integrations/ukraine_alarm.markdown +++ b/source/_integrations/ukraine_alarm.markdown @@ -14,14 +14,12 @@ ha_platforms: ha_integration_type: integration --- -The Ukraine Alarm integration uses the [Ukraine Alarm](https://www.ukrainealarm.com/) web service as a source for air-raid sirens in Ukraine for your region. It's became very important since [Russian troops invasion](https://war.ukraine.ua/). - -For each region integration exposes 4 binary sensors: +The Ukraine Alarm integration uses the [Ukraine Alarm](https://www.ukrainealarm.com/) web service to offer air-raid siren notifications. The integration will create 4 binary sensors for your selected region in Ukraine: - Air -- Unknown - Artillery - Urban Fights +- Unknown Siren check interval is set to 10 seconds to don't overload API and be able to react quite fast. From 111b12f4c11125c7a577c926ca0566bdc73f16c5 Mon Sep 17 00:00:00 2001 From: Paul Annekov Date: Sun, 8 May 2022 20:30:12 +0300 Subject: [PATCH 3/3] Update source/_integrations/ukraine_alarm.markdown Co-authored-by: Shay Levy --- source/_integrations/ukraine_alarm.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/ukraine_alarm.markdown b/source/_integrations/ukraine_alarm.markdown index 3073a9ed3745..462fdb16b9bd 100644 --- a/source/_integrations/ukraine_alarm.markdown +++ b/source/_integrations/ukraine_alarm.markdown @@ -21,7 +21,7 @@ The Ukraine Alarm integration uses the [Ukraine Alarm](https://www.ukrainealarm. - Urban Fights - Unknown -Siren check interval is set to 10 seconds to don't overload API and be able to react quite fast. +Siren check interval is set to 10 seconds to avoid overloading the API and still be able to react fast enough. ## Setup