Настройка и запуск Gammu SMS Daemon на Raspberry Pi/Orange Pi с использованием модема 3G/4G от Huawei
- 📝 Преамбула
- ⚙️ У нас было...
- 🚀 Установка Gammu вручную
- ⚙️ Автоматизация с Ansible
- 💡 Полезные советы и рекомендации
⚠️ Ошибки и устранение неполадок
Однажды передо мной возникла задача — получать СМС на SIM-карту, которую не хотелось бы носить с собой в мобильном устройстве. В моем случае это была SIM-карта Казахстана, а также потребность в получении пуш-уведомлений от банков. Проанализировав ситуацию и имея под рукой старый 3G-модем и недавно приобретенную Orange Pi, я решил настроить систему для получения СМС и пересылки их в Telegram. Ключом к решению этой задачи стал Gammu SMS Daemon, который позволяет отправлять и получать сообщения на вашем устройстве. В этом руководстве я шаг за шагом покажу, как я это реализовал, а также постараюсь автоматизировать процесс с помощью Ansible.
Итак, представьте себе: один одноплатный компьютер, что-то вроде старого друга, который лежал в углу, собирая пыль. Один старый операторский модем Мегафон Е173 — тот самый, который уже давно не использовался, но всё ещё тянет за собой какие-то воспоминания о старых временах связи. И, конечно же, великое и всепоглощающее желание автоматизировать процесс. Всё это вместе — готовая сцена для небольшого, но эпического приключения.
Если ваш модем операторский — как и в моем случае, его нужно научить тайному кунг-фу — читать SIM-карты других операторов. Этот процесс оказался тривиальным для моей модели, ведь под личиной Мегафон Е173 скрывается не кто иной, как HUAWEI E173 — древнейший 3G-свисток, который идеально подходил для моих задач. Как сменить его преданность Мегафону, можно найти на небезызвестном форуме.
- Вставьте модем Huawei в USB-порт вашего устройства.
- Убедитесь, что модем определяется системой, используя команду:
В ответ вы должны получить что-то наподобие:
lsusb
Прекрасно, модем определился — мы запомним из данного выводаBus 008 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Bus 007 Device 003: ID 12d1:1001 Huawei Technologies Co., Ltd. E161/E169/E620/E800 HSDPA Modem Bus 007 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
manufacturer idданного устройства —12d1:1001.12d1— это код поставщика для Huawei, а строка, идущая за этим кодом (в моём случае —1001) — это ID продукта. Если система, после подключения модема, создаст/dev/ttyUSB0, это значит, что всё сделано правильно. Проверить это можем с помощью команд:dmesg | grep tty [287645.840210] usb 7-1: GSM modem (1-port) converter now attached to ttyUSB1 [287645.876674] usb 7-1: GSM modem (1-port) converter now attached to ttyUSB2 [287645.913216] usb 7-1: GSM modem (1-port) converter now attached to ttyUSB3 ls -al /dev/ttyUSB* crw-rw---- 1 root dialout 188, 1 Feb 6 22:15 /dev/ttyUSB1 crw-rw---- 1 root dialout 188, 2 Feb 6 22:15 /dev/ttyUSB2 crw-rw---- 1 root dialout 188, 3 Feb 16 23:19 /dev/ttyUSB3
Note
После подключения модема стоит сразу настроить udev-правило, чтобы зафиксировать ttyID. Подробнее.
После этого аппаратная часть нашего проекта — Pi и модем — готова к дальнейшей работе.
- Чаще всего одноплатники поставляются на Debian/Ubuntu подобных дистрибутивах — поэтому ставим пакеты для Gammu и используя пакетный менеджер
apt. Хорошим тоном будет обновить репозитории и ОС:sudo apt update && sudo apt upgrade -y - И установка самих пакетов:
sudo apt install gammu gammu-smsd -y
- Gammu обладает широким спектром возможностей по взаимодействию с модемами и телефонами. Нам же нужен тривиальный функционал обработки SMS сообщений. Конфигурационный файл лежит по пути
/etc/gammu-smsdrc:# Configuration file for Gammu SMS Daemon - подробнее https://docs.gammu.org/config/ [gammu] port = /dev/sms # точка подключения к нашему модему, мы настроили ее после подключения модема. Можно использовать ttyUSB*, но могут быть коллизии — см. Полезные советы и рекомендации connection = at # тип подключения к модему (AT-команды) [smsd] service = files # режим работы — сохранять сообщения в локальные файлы logfile = syslog # путь для логирования — syslog (системный журнал) debuglevel = 1 # уровень детализации логов (1 — минимальный, 255 — максимальный) CheckSecurity = 0 # отключить проверку безопасности PIN-кода SIM-карты RunOnReceive = /opt/my-awesome-python-script.py # путь к скрипту, который запускается при получении SMS inboxpath = /var/spool/gammu/inbox/ # папка для входящих SMS outboxpath = /var/spool/gammu/outbox/ # папка для SMS, подготовленных к отправке sentsmspath = /var/spool/gammu/sent/ # папка для успешно отправленных SMS errorsmspath = /var/spool/gammu/error/ # папка для сообщений, которые не удалось отправить
- После заполнения конфигурационного файла можем проверить работу модема и связь утилиты и нашего модема. Если всё нормально — в ответ вы получите примерно следующее:
gammu -c /etc/gammu-smsdrc identify Device : /dev/sms Manufacturer : Huawei Model : E173 (E173) Firmware : 11.126.16.17.209 IMEI : 863448212120472 SIM IMSI : 401770091187972
- Ключевым тут является скрипт, который запускается при каждом полученном сообщении —
RunOnReceive = /opt/my-awesome-python-script.py. Его пример можно найти здесь. В нём необходимо заполнить лишь следующее — номер телефона и данные нашего TG-бота, который мы, конечно же, заблаговременно создали заранеенет.phone = "+79000000000" CHAT_ID = "-667408572" TOKEN = "334200:CoDeForMyAwEsOmEBoT"
- Осталось запустить
systemdдемон для работы Gammu:Если всё сделано правильно, вы увидите примерно следующее:systemctl start gammu-smsd.service systemctl enable gammu-smsd.service systemctl status gammu-smsd.service● gammu-smsd.service - SMS daemon for Gammu Loaded: loaded (/lib/systemd/system/gammu-smsd.service; enabled; vendor preset: enabled) Active: active (running) since Mon 2025-02-17 10:46:30 MSK; 54min ago Docs: man:gammu-smsd(1) Process: 522079 ExecStart=/usr/bin/gammu-smsd --pid=/run/gammu-smsd.pid --daemon (code=exited, status=0/SUCCESS) Main PID: 522080 (gammu-smsd) Tasks: 1 (limit: 9040) Memory: 2.1M CPU: 1.230s CGroup: /system.slice/gammu-smsd.service └─522080 /usr/bin/gammu-smsd --pid=/run/gammu-smsd.pid --daemon Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: mode: Send=1, Receive=1 Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: deliveryreport = no Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: phoneid = Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: Inbox is "/var/spool/gammu/inbox/" with format "standard" Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: Outbox is "/var/spool/gammu/outbox/" with format "detail" and transmission format "7bit" Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: Sent SMS moved to "/var/spool/gammu/sent/" Feb 17 10:46:30 orangepi5 gammu-smsd[522079]: SMS with errors moved to "/var/spool/gammu/error/" Feb 17 10:46:30 orangepi5 gammu-smsd[522080]: Created POSIX RW shared memory at 0x7fa2728000 Feb 17 10:46:30 orangepi5 gammu-smsd[522080]: Starting phone communication... Feb 17 10:46:30 orangepi5 systemd[1]: Started SMS daemon for Gammu.
- Проверкой результатов будет отправка любого сообщения на ваш номер и трепетное ожидание его в вашем ТГ канале.
Если вас не пугают слова — плейбук, ansible, инвентори — вы по адресу. После клонирования репозитория можно прогнать плейбук и получить вышеописанную инсталляцию, но уже посредством автоматики.
Важно — заполнить group_vars — в них укажем так же токен от нашего бота и номер телефона по желанию.
Подробнее - работа с ansible.
cd playbooks/
ansible-playbook gammu.ymlУ модемов есть свойство — менять свой ttyID в зависимости от фазы луны, солнцестояния и курса доллара. Хорошим решением будет зафиксировать этот самый ttyID с помощью правил udev. При подключении модема к одноплатнику мы выяснили manufacturer id нашего устройства.
Bus 008 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 007 Device 003: ID 12d1:1001 Huawei Technologies Co., Ltd. E161/E169/E620/E800 HSDPA Modem
Bus 007 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hubТеперь создадим файл по пути /etc/udev/rules.d/55-USB-modems.rules со следующим содержанием:
# idVendor 0x12d1 Huawei Technologies Co., Ltd.
# idProduct 0x1001 E169/E620/E800 HSDPA Modem
SUBSYSTEM=="tty", ATTRS{idVendor}=="12d1", ATTRS{idProduct}=="1001", SYMLINK+="sms"Следующим правилом мы говорим, что устройство вендора Huawei и пределённым id стоит вешать на симлинк /dev/sms. Теперь выполним релоад данных правил:
udevadm control --reload-rules
udevadm triggerПо пути /dev/sms мы должны наблюдать симлинк на tty от модема:
ls -hal /dev/sms
lrwxrwxrwx 1 root root 7 Feb 17 10:41 /dev/sms -> ttyUSB3Иногда происходит потеря связности модема — и нашего одноплатника. Порой это связано с потерей интернет соединения, порой с волшебными процессами внутри модема — отвалы наблюдаются как сообщения в логах systemd — gammu-smsd:
"Probably the phone is not connected. (TIMEOUT[14])"
"Error at init connection:"
"Error getting SMS status:"При этом рестарт сервиса systemd нам не поможет — могла произойти потеря связи с самим модемом, и потребуется физически переподключить модем, что чаще всего невозможно. Но мы не отчаиваемся — ведь у нас HAA-система, SLA 99.9999%! Решением стал немного костыльный, но зато надёжный, как автомат Калашникова, сервис — watcher. Его код можно найти здесь. Данный сервис сканирует лог с момента запуска демона gammu-smsd на предмет указанных выше ошибок. Если он их находит, то выполняет программное "переподключение" модема через USB-разъём и перезапускает сервис gammu-smsd в systemd.
Для запуска потребуются systemd-юнит и таймер для него:
/etc/systemd/system/watcher.service[Unit] Description=Watcher Service After=network.target gammu-smsd.service [Service] Type=simple ExecStart=/usr/bin/python3 /opt/watcher.py [Install] WantedBy=multi-user.target
/etc/systemd/system/watcher.timer[Unit] Description=Watcher Timer [Timer] OnCalendar=*:0/15 [Install] WantedBy=timers.target
Не забываем добавить новые юниты в демон systemd:
systemctl daemon-reload
systemctl enable watcher.timer
systemctl start watcher.timerБольшинство USB-модемов при подключении к компьютеру, по умолчанию, работают в режиме устройства хранения данных (storage mode), а нам нужен режим модема (modem mode). Для того чтобы понять, в каком именно режиме работает ваш модем — подключите его к настольному компьютеру. Если система монтирует его в виде USB-диска (обычно содержащего установщики разных программ и драйверов) — вам надо переключить его в режим модема. Переключение режима устройства в различных модемах выполняется немного по-разному. Обычно это решается командой:
usb_modeswitch -W -v 12d1 -p 1001 -K -P 14ac -M "55534243000000000000000000000011060000000000000000000000000000"И чуть подробнее:
-v: Vendor ID-p: Product ID-M: Специальная управляющая команда (Huawei Modeswitch Message)
Либо можем создать правило, чтобы делать это каждый раз при подключении:
/etc/usb_modeswitch.d/12d1:1446DefaultVendor=0x12d1 DefaultProduct=0x1446 TargetVendor=0x12d1 TargetProduct=0x1506 MessageContent="55534243000000000000000000000011060000000000000000000000000000"
И перезапустим сервис usb_modeswitch:
sudo systemctl restart usb_modeswitch