jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update sms.markdown (#12053)

Browse Source 
* Update sms.markdown

* ✏️ Tweaks

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Oscar Calvo 2020-02-11 23:40:59 -08:00 committed by GitHub
parent 1e4701b120
commit ff9e04628f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 39 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
source/_integrations/sms.markdown
View File

@ -13,6 +13,7 @@ ha_codeowners:
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
## Configuration
@ -32,6 +33,7 @@ notify:
name: sms_person2
recipient: PHONE_NUMBER
```
{% configuration %}
device:
description: The gsm modem device.
@ -41,21 +43,21 @@ device:
To use notifications, please see the [getting started with automation page](/getting-started/automation/).
If the integration is used in HassOS then version [3.6](https://github.com/home-assistant/hassos/releases/tag/3.6) or higher is required.
If the integration is used with the Home Assistant Operating System, 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:
For installations not running on Home Assistant or Home Assistant Core using 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:
Before running for the first time, check that the system recognizes the modem by running:
```bash
ls -l /dev/*USB*
```
Note: In Hass.io you need to install the SSH add-on.
Note: When running Home Assistant, you need to install the SSH add-on.
## Required Hardware
@ -65,22 +67,50 @@ You will need a USB GSM stick modem.
- [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))
- [Huawei E3531](https://www.amazon.com/Modem-Huawei-Unlocked-Caribbean-Desbloqueado/dp/B011YZZ6Q2/ref=sr_1_1?keywords=Huawei+E3531&qid=1581447800&sr=8-1)
[List of modems that may work](https://www.asus.com/event/networks_3G4G_support/)
### Note about Raspberry PI 4
### Huawei modems on Raspberry Pi (and similar) devices
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.
For some unknown reason, the rule that converts these modems from storage devices into serial devices does not run automatically. To work around this problem, follow the procedure to create `udev` rule on a configuration USB stick for the device to switch to serial mode.
1. Run `lsusb`, its output looks like this:
```bash
bus 000 device 001: ID 1FFF:342a
bus 001 device 005: ID 12d1:15ca <-------- Huawei is usually 12d1
bus 000 device 002: ID 2354:5352
bus 000 device 002: ID 1232:15ca
```
Identify the brand for your GSM modem, copy the `brand_Id` and `product_id` (In this case `brand_id = 12d1` and `product_Id = 15ca`)
Set this content in file `udev\10-gsm-modem.rules` in the configuration USB:
(Replace `brand_Id` and `product_id` for the numbers reported by `lsusb`)
```txt
```bash
ACTION=="add" \
, ATTRS{idVendor}=="brand_Id" \
, ATTRS{idProduct}=="product_Id" \
, RUN+="/sbin/usb_modeswitch -X -v brand_Id -p product_Id"
```
Here is a sample configuration file:
```bash
ACTION=="add" \
, ATTRS{idVendor}=="12d1" \
, ATTRS{idProduct}=="14fe" \
, RUN+="/sbin/usb_modeswitch -X -v 12d1 -p 14fe"
, ATTRS{idProduct}=="15ca" \
, RUN+="/sbin/usb_modeswitch -X -v 12d1 -p 15ca"
```
Plug the USB stick, reboot the device, run `lsusb` again.
The resulting product id now should be different and the brand id should be the same.
And `ls -l /dev/*USB*` should now report your device.
If the device is still not recognized, remove the parameter -X from the usb_modesiwtch command and reboot again.
## More details:
- [Original thread discussion](https://community.home-assistant.io/t/send-sms-with-usb-gsm-modem-when-alarm-triggered/28942/38)