From be3f86f07b101433b3968797597667f6396f1e78 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Mon, 20 Jan 2020 16:23:58 -0800 Subject: [PATCH 01/23] Create SMS documentation --- source/_integrations/sms.markdown | 50 +++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 source/_integrations/sms.markdown diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown new file mode 100644 index 00000000000..98b522c9b4c --- /dev/null +++ b/source/_integrations/sms.markdown @@ -0,0 +1,50 @@ +# Local SMS notifications integration via GSM Modem +This integration allows to have a local execution SMS notification. This is ideal when the internet is offline or when the power goes out. + +# Required Hardware +You will need a USB GSM stick modem. +## List of modems known to work: +- [Huawei E3372-510](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)( +Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/convert-huawei-e3372h-153-from.html)) +## [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) + +# Configuration +It requires hassos version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. +Check that the modem is recognized by running: +``` +ls -l /dev/*USB* +``` + +## Home Assistant config +In home assistant you need to configure your yaml notification as: +``` +notify: + - platform: command_line + name: sms_person1 + command: !secret notify_sms_person1 + - platform: command_line + name: sms_person2 + command: !secret notify_sms_person2 +``` +And the screts yaml: +``` +notify_sms_person1: "/config/custom_components/sms/send_sms.sh +1NNNNNNNNNN /dev/ttyUSB2" +notify_sms_person2: "/config/custom_components/sms/send_sms.sh +1NNNNNNNNNN /dev/ttyUSB2" +``` +Replace the NNN for the actual phone numbers + +## Note about Raspberry +On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. +This config is: +``` +udev\10-gsm-modem.rules +``` +``` +ACTION=="add" \ +, ATTRS{idVendor}=="12d1" \ +, ATTRS{idProduct}=="14fe" \ +, RUN+="/sbin/usb_modeswitch -X -v 12d1 -p 14fe" +``` + +## More details: +- [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38) From d15726e3167aebfc81136041a6b92b35b360ebbe Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Mon, 20 Jan 2020 16:59:48 -0800 Subject: [PATCH 02/23] Update sms.markdown --- source/_integrations/sms.markdown | 74 ++++++++++++++++++++----------- 1 file changed, 48 insertions(+), 26 deletions(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 98b522c9b4c..92d4968b4d6 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -1,6 +1,49 @@ -# Local SMS notifications integration via GSM Modem -This integration allows to have a local execution SMS notification. This is ideal when the internet is offline or when the power goes out. +--- +title: "SMS" +description: "SMS notification via GSM modem." +ha_category: + - Notifications +ha_release: 0.104.5 +--- +The `sms` integration allows to have a local execution SMS notification. This is ideal when the internet is offline or when the power goes out. + +To enable those notifications in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sms: + device: /dev/ttyUSB2 + +notify: + - platform: sms + name: sms_person1 + phone_number: !secret notify_sms_person1 + - platform: sms + name: sms_person2 + phone_number: !secret notify_sms_person2 +``` +And the screts yaml: +``` +sms_person1: "+1NNNNNNNNNN" +sms_person2: "+1NNNNNNNNNN" +``` +Replace the NNN for the actual phone numbers + +{% configuration %} +device: + description: The gsm modem device. + required: true + type: string +{% endconfiguration %} + +To use notifications, please see the [getting started with automation page](/getting-started/automation/). + +It requires hassos version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. +Check that the modem is recognized by running: +``` +ls -l /dev/*USB* +``` # Required Hardware You will need a USB GSM stick modem. ## List of modems known to work: @@ -8,32 +51,9 @@ You will need a USB GSM stick modem. Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/convert-huawei-e3372h-153-from.html)) ## [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) -# Configuration -It requires hassos version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. -Check that the modem is recognized by running: -``` -ls -l /dev/*USB* -``` - ## Home Assistant config -In home assistant you need to configure your yaml notification as: -``` -notify: - - platform: command_line - name: sms_person1 - command: !secret notify_sms_person1 - - platform: command_line - name: sms_person2 - command: !secret notify_sms_person2 -``` -And the screts yaml: -``` -notify_sms_person1: "/config/custom_components/sms/send_sms.sh +1NNNNNNNNNN /dev/ttyUSB2" -notify_sms_person2: "/config/custom_components/sms/send_sms.sh +1NNNNNNNNNN /dev/ttyUSB2" -``` -Replace the NNN for the actual phone numbers -## Note about Raspberry +## Note about Raspberry PI 4 On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. This config is: ``` @@ -48,3 +68,5 @@ ACTION=="add" \ ## More details: - [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38) + +# From 7e9915cf6636d0136e5da63065b21bd50ed4ac8e Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Tue, 21 Jan 2020 18:40:33 -0800 Subject: [PATCH 03/23] Update sms.markdown --- source/_integrations/sms.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 92d4968b4d6..d2688695003 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -1,12 +1,13 @@ --- title: "SMS" description: "SMS notification via GSM modem." +icon: [https://wammu.eu/media/images/wammu-32x32.png] ha_category: - Notifications ha_release: 0.104.5 --- -The `sms` integration allows to have a local execution SMS notification. This is ideal when the internet is offline or when the power goes out. +The `sms` integration allows to have a local execution SMS notification via [Gammu](https://wammu.eu/gammu/). This is ideal when the internet is offline or when the power goes out. To enable those notifications in your installation, add the following to your `configuration.yaml` file: From 7b6c769e00e04a39a8248b1126029d4f93d0872f Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Tue, 21 Jan 2020 18:46:09 -0800 Subject: [PATCH 04/23] Add files via upload --- source/images/supported_brands/gammu.png | Bin 0 -> 1407 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 source/images/supported_brands/gammu.png diff --git a/source/images/supported_brands/gammu.png b/source/images/supported_brands/gammu.png new file mode 100644 index 0000000000000000000000000000000000000000..a975b68bc2dc1f8235deb855eea227e19e9859f8 GIT binary patch literal 1407 zcma)6i#OC+9RD&#GrxH=6DE%tQsHQ0s%grj@t#eSu~Iva`8(z4dd?xC_&oD?Y{WG`GhvVAX8k+f^hEoT;IuLL`!~+QrWCVz~|0tE9q$t)? zL5m6~MFT2Pi7$aB8Bm}bXe8y?FF@&5Hdt;1o{3TuRYvn)Ji4?+PZ=ZYVBbz~=79Si z@U(_wB8V2jNiT@^hD2XT@q^4j$O=>j8Q(*85aflx)i|h?0)ij}0zx7YNhA`5LZ*@t z4GNAf4w5sMByiyE;}Ko=P+hGw_6zt2tcY$_h)C$5 z@~K{Yf{#7H*IVT8govGqVxI#Ni8xU5U68~(D8M)PP{5Hx;t(Mc8WI>98X7LbN4Vo7 z!h$2h4j+$+j5`sPnDE0HF*a3#O-oBlPftfLCo>3pE*NtzJ1Zv`a)Tj11PYEqQMhU` zisIsua40D*DlIK7j|LeEne6gqnLJiSE|*uvLUo))}&9EZm0023TBN{Co$NP%JGe?!xl&^2*A}>gp=m*hO!!)o5o6 zj=KxL0ac6|mQ2y4vrV>J**HYTNRu+Na&q$ui!QdeKYZBH-Q6=hGB!3bIjyvr_wUh4 zvmZWwoSUEjw1C!FTv|evQQc+Bq#Nkt!3!Mt9=m!1B}o`3eT$Go*47MOl>a7m*S1YJ z>fS|r^knR+ZZ+DkId22Unz??^gO`(z>}?r@zK4RAOI+buf<(fT5i)GdrNQ}OgPCCyE$GGsv z3ZBeAMxGA~fN|uxT0`Lz^=>iwmiJl1wbcp}0_HwG{pU)>$B6^@(&v>JKO6Oc!_;w) z*@?dUMiwt$v(CHKkUJ78{=VfZb*`IzQ1D+HFBU_-)|t@xKwtmQ(r1;}0M_q!F z+lG5zQ)ITb!!f6SSxCLpG`}GE37ZqKEpG7XERB9$R##P3e(Ay|UFNe Date: Tue, 21 Jan 2020 18:46:30 -0800 Subject: [PATCH 05/23] Update sms.markdown --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index d2688695003..6f1d4b7c5dc 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -1,7 +1,7 @@ --- title: "SMS" description: "SMS notification via GSM modem." -icon: [https://wammu.eu/media/images/wammu-32x32.png] +icon: gammu.png ha_category: - Notifications ha_release: 0.104.5 From b3d171a310a38f0b0ae89f6f33ae852f662ea728 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Tue, 21 Jan 2020 18:52:59 -0800 Subject: [PATCH 06/23] Update sms.markdown --- source/_integrations/sms.markdown | 33 ++++++++++++++++++------------- 1 file changed, 19 insertions(+), 14 deletions(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 6f1d4b7c5dc..6a8669a4f23 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -9,6 +9,11 @@ ha_release: 0.104.5 The `sms` integration allows to have a local execution SMS notification via [Gammu](https://wammu.eu/gammu/). This is ideal when the internet is offline or when the power goes out. +This integration provides the following platforms: +- Notify + +## Configuration + To enable those notifications in your installation, add the following to your `configuration.yaml` file: ```yaml @@ -31,30 +36,25 @@ sms_person2: "+1NNNNNNNNNN" ``` Replace the NNN for the actual phone numbers -{% configuration %} -device: - description: The gsm modem device. - required: true - type: string -{% endconfiguration %} - To use notifications, please see the [getting started with automation page](/getting-started/automation/). It requires hassos version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. + Check that the modem is recognized by running: ``` ls -l /dev/*USB* ``` -# Required Hardware + +## Required Hardware + You will need a USB GSM stick modem. -## List of modems known to work: + +### List of modems known to work: - [Huawei E3372-510](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)( Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/convert-huawei-e3372h-153-from.html)) -## [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) +### [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) -## Home Assistant config - -## Note about Raspberry PI 4 +### Note about Raspberry PI 4 On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. This config is: ``` @@ -70,4 +70,9 @@ ACTION=="add" \ ## More details: - [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38) -# +{% configuration %} +device: + description: The gsm modem device. + required: true + type: string +{% endconfiguration %} From c35cfb668fe715b6028961f929983c191c6578ec Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Tue, 21 Jan 2020 19:00:43 -0800 Subject: [PATCH 07/23] Update sms.markdown --- source/_integrations/sms.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 6a8669a4f23..09988c343eb 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -4,7 +4,11 @@ description: "SMS notification via GSM modem." icon: gammu.png ha_category: - Notifications -ha_release: 0.104.5 +ha_release: 0.104.4 +ha_iot_class: Local Polling +ha_config_flow: false +ha_codeowners: + - '@ocalvo' --- The `sms` integration allows to have a local execution SMS notification via [Gammu](https://wammu.eu/gammu/). This is ideal when the internet is offline or when the power goes out. From e2ede4f154a7fd82fb97bfe41e4c897af9dda629 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:46:21 -0800 Subject: [PATCH 08/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 09988c343eb..c3416734b22 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -11,7 +11,7 @@ ha_codeowners: - '@ocalvo' --- -The `sms` integration allows to have a local execution SMS notification via [Gammu](https://wammu.eu/gammu/). This is ideal when the internet is offline or when the power goes out. +The `sms` integration allows having a local execution SMS notification via [Gammu](https://wammu.eu/gammu/). This is ideal when the internet is offline or when the power goes out. This integration provides the following platforms: - Notify From e171531285ea390de1e96ba8c760b1efcd3e2c3e Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:46:41 -0800 Subject: [PATCH 09/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index c3416734b22..64d9f07d6b5 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -28,7 +28,7 @@ sms: notify: - platform: sms name: sms_person1 - phone_number: !secret notify_sms_person1 + phone_number: PHONE_NUMBER - platform: sms name: sms_person2 phone_number: !secret notify_sms_person2 From 72631016c0b28e9b2d933a019a09433de7c593c0 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:46:49 -0800 Subject: [PATCH 10/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 64d9f07d6b5..054b39d9be8 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -31,7 +31,7 @@ notify: phone_number: PHONE_NUMBER - platform: sms name: sms_person2 - phone_number: !secret notify_sms_person2 + phone_number: PHONE_NUMBER ``` And the screts yaml: ``` From ec4c68b9939c531d7c1056c11009ad9d03d979dc Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:47:10 -0800 Subject: [PATCH 11/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 054b39d9be8..056e714e4f2 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -42,7 +42,7 @@ Replace the NNN for the actual phone numbers To use notifications, please see the [getting started with automation page](/getting-started/automation/). -It requires hassos version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. +It requires HassOS version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. Check that the modem is recognized by running: ``` From b1e6310f8d351291cd4396b668180e66ceaba5e3 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:47:23 -0800 Subject: [PATCH 12/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 056e714e4f2..5d9fe607d8e 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -4,7 +4,7 @@ description: "SMS notification via GSM modem." icon: gammu.png ha_category: - Notifications -ha_release: 0.104.4 +ha_release: 0.105 ha_iot_class: Local Polling ha_config_flow: false ha_codeowners: From bc35884abd778e6ce3eec78eb96d45f3d5d0d7ec Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:47:50 -0800 Subject: [PATCH 13/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 5d9fe607d8e..feb0d9241ae 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -64,7 +64,7 @@ This config is: ``` udev\10-gsm-modem.rules ``` -``` +```txt ACTION=="add" \ , ATTRS{idVendor}=="12d1" \ , ATTRS{idProduct}=="14fe" \ From 042ce82db25a03b8f0a4607780e88fa758b85eab Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:49:10 -0800 Subject: [PATCH 14/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index feb0d9241ae..d5e1f62e954 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -45,7 +45,7 @@ To use notifications, please see the [getting started with automation page](/get It requires HassOS version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. Check that the modem is recognized by running: -``` +```bash ls -l /dev/*USB* ``` From 3db39c805be91e47e9bb0adaa0020629d10e2c34 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:49:21 -0800 Subject: [PATCH 15/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index d5e1f62e954..a0020e95b8a 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -56,7 +56,8 @@ You will need a USB GSM stick modem. ### List of modems known to work: - [Huawei E3372-510](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)( Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/convert-huawei-e3372h-153-from.html)) -### [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) + +[List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) ### Note about Raspberry PI 4 On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. From 7aa2a68010afb5ed316b450e978e1fb4f5c33f0a Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:49:31 -0800 Subject: [PATCH 16/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index a0020e95b8a..441bf582563 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -62,7 +62,7 @@ Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/c ### Note about Raspberry PI 4 On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. This config is: -``` +```txt udev\10-gsm-modem.rules ``` ```txt From 43dd7a9033dfaf4a48437bf8b992c40718bf655e Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:53:30 -0800 Subject: [PATCH 17/23] Update sms.markdown --- source/_integrations/sms.markdown | 25 ++++++++----------------- 1 file changed, 8 insertions(+), 17 deletions(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 441bf582563..b2acd3c59b1 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -33,12 +33,12 @@ notify: name: sms_person2 phone_number: PHONE_NUMBER ``` -And the screts yaml: -``` -sms_person1: "+1NNNNNNNNNN" -sms_person2: "+1NNNNNNNNNN" -``` -Replace the NNN for the actual phone numbers +{% configuration %} +device: + description: The gsm modem device. + required: true + type: string +{% endconfiguration %} To use notifications, please see the [getting started with automation page](/getting-started/automation/). @@ -48,6 +48,7 @@ Check that the modem is recognized by running: ```bash ls -l /dev/*USB* ``` +Note: In hassio you need to install the SSH add on. ## Required Hardware @@ -61,10 +62,7 @@ Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/c ### Note about Raspberry PI 4 On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. -This config is: -```txt -udev\10-gsm-modem.rules -``` +Set this content in file udev\10-gsm-modem.rules in the configuration USB: ```txt ACTION=="add" \ , ATTRS{idVendor}=="12d1" \ @@ -74,10 +72,3 @@ ACTION=="add" \ ## More details: - [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38) - -{% configuration %} -device: - description: The gsm modem device. - required: true - type: string -{% endconfiguration %} From 197c05808af5b23ccb88bc19f69c6698627a4906 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Thu, 23 Jan 2020 12:57:53 -0800 Subject: [PATCH 18/23] Update sms.markdown --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index b2acd3c59b1..e82dd7f5fc6 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -48,7 +48,7 @@ Check that the modem is recognized by running: ```bash ls -l /dev/*USB* ``` -Note: In hassio you need to install the SSH add on. +Note: In Hass.io you need to install the SSH add on. ## Required Hardware From 951937c950b3c9570a9754274d99d9fa069789f0 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Fri, 24 Jan 2020 09:16:10 -0800 Subject: [PATCH 19/23] Update source/_integrations/sms.markdown Co-Authored-By: Franck Nijhof --- source/_integrations/sms.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index e82dd7f5fc6..72ef2179bb5 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -54,7 +54,8 @@ Note: In Hass.io you need to install the SSH add on. You will need a USB GSM stick modem. -### List of modems known to work: +### List of modems known to work + - [Huawei E3372-510](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)( Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/convert-huawei-e3372h-153-from.html)) From cac6469e4daa3b5dc68b49782036861f37b61351 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Fri, 24 Jan 2020 09:20:12 -0800 Subject: [PATCH 20/23] Update sms.markdown --- source/_integrations/sms.markdown | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 72ef2179bb5..b4fd04eb53b 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -28,10 +28,10 @@ sms: notify: - platform: sms name: sms_person1 - phone_number: PHONE_NUMBER + recipient: PHONE_NUMBER - platform: sms name: sms_person2 - phone_number: PHONE_NUMBER + recipient: PHONE_NUMBER ``` {% configuration %} device: @@ -42,9 +42,13 @@ device: To use notifications, please see the [getting started with automation page](/getting-started/automation/). -It requires HassOS version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher. +If the ingtegration is used in HassOS then version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher is required. +For non Hass.io installations you must install gammu-dev component: +```bash +sudo apt-get install libgammu-dev +``` -Check that the modem is recognized by running: +Before running for the first time, check that the modem is recognized by the system by running: ```bash ls -l /dev/*USB* ``` From fae4a012739e30cb9762232ffde2d951bd61d7a7 Mon Sep 17 00:00:00 2001 From: Oscar Calvo <2091582+ocalvo@users.noreply.github.com> Date: Fri, 24 Jan 2020 10:55:47 -0800 Subject: [PATCH 21/23] Update sms.markdown --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index b4fd04eb53b..6fa4bb7d298 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -1,5 +1,5 @@ --- -title: "SMS" +title: "SMS notifications via GSM modem" description: "SMS notification via GSM modem." icon: gammu.png ha_category: From 8ace9d62411f2444266662edcb7cc19676ffd465 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Tue, 28 Jan 2020 15:49:08 +0100 Subject: [PATCH 22/23] :pencil2: Tweaks --- source/_integrations/sms.markdown | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index 6fa4bb7d298..cb679b63e3d 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -42,17 +42,21 @@ device: To use notifications, please see the [getting started with automation page](/getting-started/automation/). -If the ingtegration is used in HassOS then version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher is required. -For non Hass.io installations you must install gammu-dev component: +If the ingegration is used in HassOS then version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher is required. + +For installations not running on Hass.io or Docker, you must install `gammu-dev` package: + ```bash sudo apt-get install libgammu-dev ``` Before running for the first time, check that the modem is recognized by the system by running: + ```bash ls -l /dev/*USB* ``` -Note: In Hass.io you need to install the SSH add on. + +Note: In Hass.io you need to install the SSH add-on. ## Required Hardware @@ -66,8 +70,11 @@ Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/c [List of modems that may work](https://www.asus.com/event/networks_3G4G_support/) ### Note about Raspberry PI 4 + On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. + Set this content in file udev\10-gsm-modem.rules in the configuration USB: + ```txt ACTION=="add" \ , ATTRS{idVendor}=="12d1" \ @@ -76,4 +83,5 @@ ACTION=="add" \ ``` ## More details: + - [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38) From b51092a1f2eeb676f530678f69cd262f8c4a213b Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Tue, 28 Jan 2020 15:49:24 +0100 Subject: [PATCH 23/23] Update sms.markdown --- source/_integrations/sms.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sms.markdown b/source/_integrations/sms.markdown index cb679b63e3d..4afa190a095 100644 --- a/source/_integrations/sms.markdown +++ b/source/_integrations/sms.markdown @@ -73,7 +73,7 @@ Need to unlock it using [this guide](http://blog.asiantuntijakaveri.fi/2015/07/c On Raspberry PI 4, you need a udev rule in the config USB stick, for the [Huawei E3372-510 stick](https://www.amazon.com/gp/product/B01N6P3HI2/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) for it to be recognized. -Set this content in file udev\10-gsm-modem.rules in the configuration USB: +Set this content in file `udev\10-gsm-modem.rules` in the configuration USB: ```txt ACTION=="add" \