ラズパイに「売れた」「ホームページが止まった」「バックアップに失敗した」などを知らせてもらうとき、知らせ方はいくつか選べます。家では、声とベルから始めて、LINE とメールも使えるようにしました。
この記事では、4 つの知らせ方をくらべて、どれがどんな場面に向いているかをまとめます。最後に、知らせ方を設定ファイルで選べる入口の作り方も紹介します。これを作っておくと、新しい機能を足したときも、「どれで知らせるか」を 1 行書くだけで済みます。
4 つの知らせ方のくらべ
| 知らせ方 | 向いている場面・気をつけること |
|---|---|
| 声(売れたメールの声・声の作り方) | 家にいるときに、手を止めずに何の知らせか分かる。スピーカーが要る。家にいないと聞こえない。夜は鳴らさない時間を決める |
| ベル(本物のベルの音) | 「人が待っている作業が終わった」など、音だけで十分な知らせ。何の知らせかは分からないので、種類の少ないものに。ベルとソレノイドなどの機材が要る |
| LINE(LINE で知らせる) | 外出先でもスマホですぐ気づける。無料のプランは月 200 通まで。LINE 公式アカウントとトークンの準備が要る |
| メール(メールで知らせる) | あとから見返す・転送する・記録として残す知らせ。すぐには気づきにくい。送るためのメールアカウントが要る |
場面ごとのおすすめの組み合わせ
- すぐ動きたい知らせ(ホームページが止まった・SiteBeacon のお知らせ など):家では声、外では LINE。
- うれしい知らせ(商品が売れた など):声とベル。数が多いなら LINE は使わない(月の上限があるため)。
- 記録に残したい知らせ(バックアップに失敗した など):声と LINE で気づき、メールで残す。
- 夜:声とベルは朝まで待たせ、急ぎのものだけ LINE で届ける(LINE の側で夜の通知を切ることもできる)。
知らせ方を設定ファイルで選べる入口を作る
機能ごとに「声を置く」「LINE に送る」と書いていくと、あとで「これは LINE にも送りたい」となったときに、機能のプログラムを直すことになります。そこで、機能は notify("種類", "文章") を呼ぶだけにして、どれで知らせるかは設定ファイルで選ぶ形にしました。
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
知らせ方を選べる入口:機能は notify() を呼ぶだけ。声・ベル・LINE・メールのどれで知らせるかは notify.ini で選ぶ
使い方(ほかの Python から):
import notify
notify.notify("siteb_down", "ホームページが止まりました")
使い方(コマンド):python3 notify.py siteb_down "ホームページが止まりました"
python3 notify.py --dry siteb_down "…" … 送らずに、どれで知らせるかだけ出す
"""
import configparser
import os
import subprocess
import sys
HERE = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, HERE)
def load():
cfg = configparser.ConfigParser(interpolation=None)
cfg.read(os.path.join(HERE, "notify.ini"), encoding="utf-8")
return cfg
def routes(cfg, event):
"""知らせの種類ごとの知らせ方(なければ [routes] の default)"""
raw = cfg.get("routes", event, fallback=cfg.get("routes", "default", fallback="voice"))
return [r.strip() for r in raw.split(",") if r.strip()]
def notify(event, text, dry=False):
cfg = load()
done = []
for way in routes(cfg, event):
if dry:
done.append((way, "(送らない)"))
continue
try:
if way == "voice":
# 声:知らせの種類に合う WAV を、鳴らす順番待ちに置く(夜は朝まで待つ・前の記事の enqueue)
wav = cfg.get("voice", event, fallback="")
if wav:
import mail_notify
mail_notify.enqueue(wav)
done.append((way, wav))
else:
done.append((way, "声のファイルが notify.ini の [voice] にない"))
elif way == "bell":
n = cfg.getint("bell", event, fallback=1)
subprocess.run(["python3", os.path.join(HERE, "bell.py"), str(n), "0.1"], timeout=60, check=False)
done.append((way, "%d 回" % n))
elif way == "line":
import line_notify
done.append((way, "送った" if line_notify.send(text) else "送れなかった"))
elif way == "mail":
import mail_send
done.append((way, "送った" if mail_send.send("[ラズパイ] " + text[:60], text) else "送れなかった"))
else:
done.append((way, "知らない知らせ方"))
except Exception as e: # 1 つの知らせ方が失敗しても、ほかは続ける
done.append((way, "失敗:%s" % e.__class__.__name__))
return done
if __name__ == "__main__":
args = sys.argv[1:]
dry = "--dry" in args
args = [a for a in args if a != "--dry"]
if len(args) < 2:
print(__doc__)
sys.exit(1)
for way, result in notify(args[0], args[1], dry=dry):
print("%-6s %s" % (way, result))
# 知らせの種類ごとに、どれで知らせるか(voice・bell・line・mail をカンマで並べる)
[routes]
default = voice
siteb_down = voice, line
siteb_back = voice
sold = voice, bell
backup_fail = voice, line, mail
# 声で知らせるときの WAV(~/notify/sounds の中)
[voice]
siteb_down = siteb_down.wav
siteb_back = siteb_back.wav
backup_fail = backup_fail.wav
# ベルを鳴らす回数
[bell]
sold = 2
書き方と役目
[routes]:知らせの種類ごとに、どれで知らせるかをカンマで並べる。書いていない種類はdefault[voice]・[bell]:声のファイルの名前と、ベルを鳴らす回数- 1 つが失敗しても、ほかは続ける:LINE の設定がまだなくても、声やメールは届く
--dry:送らずに、どれで知らせるかだけを出す
notify.py が使うファイル
notify.py は、同じ ~/notify にある次のファイルを使います。
mail_notify.py:売れたメールを声で知らせるの記事のスクリプトを、この名前で置いたもの。声は、その中のenqueue()(鳴らす音を順番待ちに置く・夜は朝まで待つ)を使うline_notify.py:LINE で知らせるの記事のものmail_send.py:メールで知らせるの記事のものbell.py:下の全文。本物のベルの音の記事のソレノイドのベルを鳴らす
#!/usr/bin/env python3
"""ソレノイドのベルを鳴らす(基板 マルチコントローラーA の #3=GPIO 4・#4=GPIO 17)。
使い方:
python3 bell.py # #3 を 0.1 秒 ON にして 1 回鳴らす
python3 bell.py 3 0.05 # 回数 3・ON の長さ 0.05 秒
python3 bell.py 1 0.1 17 # #4(GPIO 17)を鳴らす
ソレノイドが熱くならないように、ON の長さは 0.5 秒まで・回数は 10 回まで。
終わったら GPIO を入力に戻す(基板側の 10k で GND に落ちるので OFF のまま)。
"""
import sys
import time
import RPi.GPIO as GPIO
MAX_ON = 0.5
MAX_COUNT = 10
GAP = 0.4 # 鳴らす間の休み(秒)
ALLOWED_PINS = (4, 17)
def ring(count=1, on=0.1, pin=4):
count = max(1, min(int(count), MAX_COUNT))
on = max(0.01, min(float(on), MAX_ON))
if pin not in ALLOWED_PINS:
raise SystemExit(f"pin は {ALLOWED_PINS} のどれか")
GPIO.setwarnings(False)
GPIO.setmode(GPIO.BCM)
GPIO.setup(pin, GPIO.OUT, initial=GPIO.LOW)
try:
for i in range(count):
GPIO.output(pin, GPIO.HIGH)
time.sleep(on)
GPIO.output(pin, GPIO.LOW)
if i < count - 1:
time.sleep(GAP)
finally:
GPIO.output(pin, GPIO.LOW)
GPIO.cleanup(pin)
if __name__ == "__main__":
a = sys.argv[1:]
ring(
int(a[0]) if len(a) > 0 else 1,
float(a[1]) if len(a) > 1 else 0.1,
int(a[2]) if len(a) > 2 else 4,
)
print("ok")
書き方と役目
- 引数:
python3 bell.py 回数 ONの長さ(秒) ピン。notify.py は、notify.ini の回数と 0.1 秒を渡す - 熱くならないように:ON の長さは 0.5 秒まで・回数は 10 回まで・鳴らす間は 0.4 秒休む
- 終わったら OFF に戻す:止まったときも
finallyで OFF にして、GPIO を片付ける
cd ~/notify
python3 notify.py --dry backup_fail "バックアップに失敗しました"
voice (送らない)
line (送らない)
mail (送らない)
家のラズパイで試したとき、LINE とメールの設定ファイルをまだ置いていない状態でも、「送れませんでした:設定ファイル line.ini([line])がありません」と理由を出して、次の知らせ方に進みました。
新しい機能を作ったら、その中で notify.notify("新しい種類", "文章") を呼び、notify.ini に 1 行足すだけです。あとから「やっぱり LINE にも」となっても、notify.ini の 1 行を直すだけで済みます。
まとめ
声・ベル・LINE・メールには、それぞれ得意な場面があります。すぐ気づきたいもの、うれしいもの、記録に残したいもので使い分け、知らせ方は設定ファイルで選べるようにしておくと、あとから変えるのも簡単です。気になる知らせ方の記事から、試してみてください。
それぞれの作り方