modify: DI 输入监听

This commit is contained in:
2026-09-11 16:55:54 +08:00
parent c139b0c1d3
commit d7636c4c3b
9 changed files with 1654 additions and 0 deletions
+36
View File
@@ -0,0 +1,36 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""diwatch — 统一 DI 输入监听库,适配 SE5 / SE9。
对外主要 API:
from diwatch import DIChannel, EventBackend, SysfsBackend, make_in1_backend
# IN1(自动选后端)
ch = DIChannel("IN1", backend=make_in1_backend(), active_low=True)
ch.on_press = lambda ts: print("有电", ts)
ch.on_release = lambda ts: print("断电", ts)
ch.run()
# IN2(sysfs 轮询)
ch2 = DIChannel("IN2",
backend=SysfsBackend("/sys/bus/platform/devices/gpio-in-2/gpio_status"),
active_low=False)
ch2.on_change = lambda old, new, ts: print(f"{old}->{new}", ts)
ch2.run(duration=10)
"""
from .core import DIChannel, fmt_dur, now_str
from .backends import (
EventBackend, SysfsBackend, make_backend,
make_in1_backend, find_status_file,
)
from .devicetree import derive_gpio
__all__ = [
"DIChannel", "fmt_dur", "now_str",
"EventBackend", "SysfsBackend", "make_backend",
"make_in1_backend", "find_status_file", "derive_gpio",
]
__version__ = "1.1.0"
+6
View File
@@ -0,0 +1,6 @@
#!/usr/bin/env python3
import sys
from .cli import main
if __name__ == "__main__":
sys.exit(main())
+268
View File
@@ -0,0 +1,268 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""DI 通道的底层读取后端。
每个后端只负责:open / close / read。
电平语义(0=低,1=高)由上层 DIChannel 统一处理。
后端类型:
- EventBackend:/dev/input/eventN,事件驱动,可 poll。SE5 的 IN1。
- SysfsBackend:/sys/.../gpio_status 或 /dev/tv_gpioin_N,轮询 + 抗抖。
SE9 的 IN1、所有设备的 IN2。
"""
import errno
import glob
import os
import select # noqa: F401 (留给上层使用)
import struct
import time
from .config import (
EV_KEY, VALUE_RELEASE, VALUE_PRESS, VALUE_REPEAT,
DEFAULT_EVENT_DEVICE, GPIO_KEYS_NAME,
DEBOUNCE, DEFAULT_INTERVAL,
find_status_file,
)
EVENT_STRUCT = struct.Struct("llHHi") # aarch64 / x86_64 都是 24 字节
# ---------------------------------------------------------------------------
# 基类
# ---------------------------------------------------------------------------
class Backend:
"""后端接口。"""
can_poll = False
def open(self):
raise NotImplementedError
def close(self):
raise NotImplementedError
def read(self):
"""非阻塞读一次,返回 (level, ts) 或 None。
level 是原始电平 0/1,尚未做 active_low 翻转。
"""
raise NotImplementedError
@property
def name(self):
raise NotImplementedError
# ---------------------------------------------------------------------------
# /dev/input/eventN 后端(SE5 的 IN1)
# ---------------------------------------------------------------------------
class EventBackend(Backend):
"""基于 input 事件设备,事件驱动。
原始 value 语义:
VALUE_PRESS(1) -> 硬件“按下”
VALUE_RELEASE(0) -> 硬件“释放”
本后端返回原始 value,极性翻转留给 DIChannel。
"""
can_poll = True
def __init__(self, device=DEFAULT_EVENT_DEVICE, key=None,
find_by_name=GPIO_KEYS_NAME):
self.device = device
self.key = key
self.find_by_name = find_by_name
self.fd = None
self.buf = b""
# ---- 自动查找 ----
@staticmethod
def find_event_device(name=GPIO_KEYS_NAME):
"""按设备名找 eventN,找不到返回 None。"""
for path in sorted(glob.glob("/dev/input/event*")):
ev = path.rsplit("/", 1)[-1]
namefile = f"/sys/class/input/{ev}/device/name"
try:
with open(namefile) as f:
if f.read().strip() == name:
return path
except OSError:
continue
return None
def resolve_device(self):
if not self.device or self.device == "auto":
return self.find_event_device(self.find_by_name) or DEFAULT_EVENT_DEVICE
return self.device
@property
def name(self):
dev = self.device or "(auto)"
return f"event:{dev}"
# ---- 生命周期 ----
def open(self):
if self.fd is None:
dev = self.resolve_device()
if not dev or not os.path.exists(dev):
raise FileNotFoundError(
errno.ENOENT,
f"event 设备不存在:{dev}",
dev,
)
self.device = dev
self.fd = os.open(dev, os.O_RDONLY | os.O_NONBLOCK)
def close(self):
if self.fd is not None:
try:
os.close(self.fd)
finally:
self.fd = None
def fileno(self):
return self.fd
# ---- 读取 ----
def read(self):
"""返回 (level, ts) 或 None;只汇报关心的 key。"""
if self.fd is None:
return None
try:
data = os.read(self.fd, EVENT_STRUCT.size * 64)
except OSError:
return None
self.buf += data
result = None
while len(self.buf) >= EVENT_STRUCT.size:
chunk = self.buf[:EVENT_STRUCT.size]
self.buf = self.buf[EVENT_STRUCT.size:]
sec, usec, etype, code, value = EVENT_STRUCT.unpack(chunk)
if etype != EV_KEY:
continue
if self.key is not None and code != self.key:
continue
if value == VALUE_REPEAT:
continue
if value not in (VALUE_RELEASE, VALUE_PRESS):
continue
ts = sec + usec / 1e6
result = (value, ts)
return result
# ---------------------------------------------------------------------------
# sysfs 状态文件后端(SE9 的 IN1、所有 IN2)
# ---------------------------------------------------------------------------
class SysfsBackend(Backend):
"""基于 /sys/.../gpio_status 或 /dev/tv_gpioin_N,轮询采样 + 抗抖。"""
can_poll = False
def __init__(self, path, debounce=DEBOUNCE, interval=DEFAULT_INTERVAL):
self.path = path
self.debounce = max(1, int(debounce))
self.interval = interval
self._cand = None
self._cand_n = 0
@property
def name(self):
return f"sysfs:{self.path}"
def open(self):
if not os.access(self.path, os.R_OK):
raise FileNotFoundError(
errno.ENOENT,
f"状态文件不可读:{self.path}",
self.path,
)
def close(self):
pass
# ---- 原始电平 ----
def read_raw(self):
try:
with open(self.path, "r") as f:
v = f.read()
except OSError:
return None
v = v.strip().strip("\t\r\n ")
return v if v in ("0", "1") else None
# ---- 带抗抖的读取 ----
def read(self):
"""返回 (level, ts) 或 None。
level 为抗抖确认后的稳定值;None 表示还没确认跳变。
"""
v = self.read_raw()
if v is None:
return None
ts = time.time()
if self._cand is None or v == self._cand:
self._cand = v
self._cand_n += 1
else:
self._cand = v
self._cand_n = 1
if self._cand_n >= self.debounce:
self._cand_n = 0 # 复位,避免重复上报
return (int(v), ts)
return None
# ---------------------------------------------------------------------------
# 工厂
# ---------------------------------------------------------------------------
def make_backend(kind: str, **kwargs):
"""kind = 'event' | 'sysfs'。"""
if kind == "event":
return EventBackend(**kwargs)
if kind == "sysfs":
return SysfsBackend(**kwargs)
raise ValueError(f"未知后端类型:{kind}")
def make_in1_backend(device=None, key=None, in_index=1):
"""自动为 IN1 选择后端,适配 SE5 / SE9。
优先级:
1) 显式 device(非 auto) -> EventBackend
2) 自动查找 gpio-keys 的 event 设备 -> EventBackend
3) 查找 gpio-in-<in_index> 的状态文件 -> SysfsBackend
4) 都找不到 -> 返回 EventBackend(open 时抛出可诊断的错误)
"""
# 1) 显式指定
if device and device != "auto":
return EventBackend(device, key=key)
# 2) 自动查找 gpio-keys
ev = EventBackend.find_event_device(GPIO_KEYS_NAME)
if ev:
return EventBackend(ev, key=key)
# 3) 回退到 sysfs 状态文件
status = find_status_file(in_index)
if status:
return SysfsBackend(status)
# 4) 都找不到,返回一个 open 时会报错的 EventBackend
return EventBackend(DEFAULT_EVENT_DEVICE, key=key)
def find_event_device(name=GPIO_KEYS_NAME):
"""模块级别别名,等价于 EventBackend.find_event_device."""
return EventBackend.find_event_device(name)
__all__ = [
"Backend",
"EventBackend",
"SysfsBackend",
"make_backend",
"make_in1_backend",
"find_status_file",
"find_event_device",
]
+342
View File
@@ -0,0 +1,342 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""diwatch 统一命令行入口,适配 SE5 / SE9。
用法示例:
# IN1(自动选后端:SE5 走 event,SE9 走 sysfs)
python3 -m diwatch in1
python3 -m diwatch in1 -t 10
python3 -m diwatch in1 --press-command 'logger "IN1 on"' \
--release-command 'logger "IN1 off"'
python3 -m diwatch in1 -d /dev/input/event0 # 手动指定 event
python3 -m diwatch in1 --no-active-low # 不翻转极性
# IN2(sysfs 轮询)
python3 -m diwatch in2
python3 -m diwatch in2 0.005
python3 -m diwatch in2 --check
# 同时监听
python3 -m diwatch both
"""
import argparse
import datetime
import os
import signal
import sys
import time
from pathlib import Path
from .backends import (
EventBackend, SysfsBackend,
make_in1_backend, find_status_file, find_event_device,
)
from .core import DIChannel, fmt_dur
from .devicetree import derive_gpio
from .config import (
DEFAULT_EVENT_DEVICE, KEY_UP, DEFAULT_INTERVAL,
IN1_INDEX, IN2_INDEX, IN2_GPIO_NUM, IN2_GPIOCHIP,
STATUS_CANDIDATES,
)
# ---------------------------------------------------------------------------
# 构造通道
# ---------------------------------------------------------------------------
def build_in1(args, log):
backend = make_in1_backend(
device=args.device,
key=args.key,
in_index=IN1_INDEX,
)
ch = DIChannel(
"IN1", backend,
active_low=args.active_low,
log=log,
)
if args.press_command:
ch.on_press = lambda ts: run_cmd(args.press_command)
if args.release_command:
ch.on_release = lambda ts: run_cmd(args.release_command)
return ch
def build_in2(args, log):
dev = find_status_file(IN2_INDEX)
if not dev:
return None
backend = SysfsBackend(
dev,
interval=args.interval or DEFAULT_INTERVAL,
)
return DIChannel("IN2", backend, active_low=False, log=log)
# ---------------------------------------------------------------------------
# 子命令
# ---------------------------------------------------------------------------
def cmd_in1(args):
log = make_logger("IN1")
ch = build_in1(args, log)
install_signal(ch)
# 手动 open,便于给出友好错误
try:
ch.open()
except FileNotFoundError as e:
_print_open_error("IN1", e)
return 1
except OSError as e:
print(f"错误:打开 IN1 失败:{e}", file=sys.stderr)
return 1
try:
print(f"监听 {ch.backend.name} key={args.key} "
f"active_low={args.active_low},Ctrl-C 退出", flush=True)
ch.run(duration=args.duration or None)
except KeyboardInterrupt:
pass
finally:
ch.close()
print_summary([ch])
return 0
def cmd_in2(args):
log = make_logger("IN2")
ch = build_in2(args, log)
if ch is None:
print(f"错误:找不到 IN{IN2_INDEX} 状态文件。已尝试:", file=sys.stderr)
for c in STATUS_CANDIDATES[IN2_INDEX]:
print(f" {c}", file=sys.stderr)
print("排查:ls /sys/bus/platform/devices/ | grep gpio-in",
file=sys.stderr)
return 1
if args.check:
return do_check_in2(ch)
install_signal(ch)
try:
ch.open()
except FileNotFoundError as e:
_print_open_error("IN2", e)
return 1
except OSError as e:
print(f"错误:打开 IN2 失败:{e}", file=sys.stderr)
return 1
try:
print("=" * 60)
print(f"IN{IN2_INDEX} 监听开始 {datetime.datetime.now():%Y-%m-%d %H:%M:%S}")
print(f" IN{IN2_INDEX} = GPIO {IN2_GPIO_NUM} = "
f"gpiochip{IN2_GPIOCHIP} 第 {IN2_GPIO_NUM - IN2_GPIOCHIP} 线")
print(f" 状态文件:{ch.backend.path}")
print(f" 轮询间隔:{ch.backend.interval}s "
f"抗抖:连续 {ch.backend.debounce} 次采样一致")
print("=" * 60)
ch.run(duration=args.duration or None)
except KeyboardInterrupt:
pass
finally:
ch.close()
print_summary([ch])
return 0
def cmd_both(args):
log = make_logger("BOTH")
ch1 = build_in1(args, log)
ch2 = build_in2(args, log)
if ch2 is None:
print(f"错误:找不到 IN{IN2_INDEX} 状态文件。", file=sys.stderr)
return 1
install_signal(ch1, ch2)
# 逐个 open,便于报错
for name, ch in (("IN1", ch1), ("IN2", ch2)):
try:
ch.open()
except FileNotFoundError as e:
_print_open_error(name, e)
return 1
except OSError as e:
print(f"错误:打开 {name} 失败:{e}", file=sys.stderr)
return 1
try:
print("=" * 60)
print(f"同时监听 IN1 + IN2 {datetime.datetime.now():%Y-%m-%d %H:%M:%S}")
print(f" IN1 -> {ch1.backend.name}")
print(f" IN2 -> {ch2.backend.name}")
print("=" * 60)
import threading
duration = args.duration or None
t1 = threading.Thread(target=ch1.run, kwargs={"duration": duration})
t2 = threading.Thread(target=ch2.run, kwargs={"duration": duration})
t1.start(); t2.start()
while t1.is_alive() or t2.is_alive():
t1.join(0.5); t2.join(0.5)
except KeyboardInterrupt:
ch1.request_stop(); ch2.request_stop()
finally:
ch1.close(); ch2.close()
print_summary([ch1, ch2])
return 0
# ---------------------------------------------------------------------------
# 辅助
# ---------------------------------------------------------------------------
def make_logger(tag):
def _log(msg):
print(f"[{tag}] {msg}", flush=True)
return _log
def run_cmd(cmd):
import subprocess
subprocess.Popen(cmd, shell=True)
def install_signal(*channels):
def _handler(*_a):
for c in channels:
c.request_stop()
signal.signal(signal.SIGINT, _handler)
signal.signal(signal.SIGTERM, _handler)
def _print_open_error(name, exc):
print(f"错误:{name} 不可用:{getattr(exc, 'filename', exc)}",
file=sys.stderr)
print("", file=sys.stderr)
print("排查步骤:", file=sys.stderr)
print(" 1) 查看 event 设备及其名字:", file=sys.stderr)
print(" for f in /dev/input/event*; do \\", file=sys.stderr)
print(" echo \"$f -> $(cat /sys/class/input/$(basename $f)/device/name 2>/dev/null)\"; \\",
file=sys.stderr)
print(" done", file=sys.stderr)
print(" 2) 查看 sysfs 状态文件:", file=sys.stderr)
print(" ls /sys/bus/platform/devices/ | grep gpio-in", file=sys.stderr)
print(" 3) 手动指定 event 设备:", file=sys.stderr)
print(" python3 -m diwatch in1 -d /dev/input/eventN", file=sys.stderr)
print(" 4) 若 SE9 无 /dev/input/,本工具会自动回退到 "
"gpio-in-1/gpio_status", file=sys.stderr)
def print_summary(channels):
print()
print("=" * 60)
print(f"汇总 {datetime.datetime.now():%Y-%m-%d %H:%M:%S}")
for ch in channels:
s = ch.summary()
print(f" [{s['name']}] 跳变 {s['count']} 次 "
f"低 {fmt_dur(s['ms_low'])} 高 {fmt_dur(s['ms_high'])} "
f"结束电平 {s['level']}")
print("=" * 60)
# ---------------------------------------------------------------------------
# --check for IN2
# ---------------------------------------------------------------------------
def do_check_in2(ch):
print(f"=== IN{IN2_INDEX} 编号自检 ===")
print()
print(f"状态文件:{ch.backend.path}")
print()
print("--- 从设备树现场复算 ---")
ok = True
for n in (1, 2):
got = derive_gpio(n)
if got is None:
print(f" IN{n}:复算失败(设备树不可读或节点缺失)")
ok = False
continue
gpio_num, label, pin = got
expect = 481 + n
if gpio_num == expect:
print(f" IN{n} -> GPIO {gpio_num} ✓ 与预期一致")
else:
print(f" IN{n} -> GPIO {gpio_num} ✗ 预期 {expect}")
ok = False
print()
if ok:
print(f"结论:IN{IN2_INDEX} = GPIO {IN2_GPIO_NUM},推导成立。")
else:
print("结论:推导与实测不符,请人工核对。")
print()
print("--- 当前电平 ---")
raw = ch.backend.read_raw()
if raw is not None:
print(f" gpio_status = {raw} (全局 GPIO {IN2_GPIO_NUM})")
print(" 注:待机时读到 0 是正常的。")
else:
print(f" 读取失败:{ch.backend.path} 内容不是 0/1。")
return 0
# ---------------------------------------------------------------------------
# 入口
# ---------------------------------------------------------------------------
def build_parser():
p = argparse.ArgumentParser(
prog="diwatch",
description="统一 DI 输入监听(适配 SE5 / SE9)",
)
sub = p.add_subparsers(dest="cmd", required=True)
# ---- in1 ----
p1 = sub.add_parser("in1", help="监听 IN1(自动适配 event / sysfs)")
p1.add_argument("-d", "--device", default="auto",
help="事件设备路径;auto=自动查找(默认)。"
"SE5 用 /dev/input/eventN,SE9 自动回退到 sysfs。")
p1.add_argument("-k", "--key", type=lambda s: int(s, 0), default=KEY_UP,
help="键码,默认 103 (KEY_UP)")
p1.add_argument("-t", "--duration", type=float, default=0,
help="监听秒数,0=一直跑")
p1.add_argument("--press-command", help="有电时执行的 shell 命令")
p1.add_argument("--release-command", help="断电时执行的 shell 命令")
p1.add_argument("--active-low", dest="active_low", action="store_true",
default=True, help="12V 接通上报为“有电”(默认)")
p1.add_argument("--no-active-low", dest="active_low", action="store_false",
help="不翻转,按驱动/文件原始语义")
p1.set_defaults(func=cmd_in1, interval=None)
# ---- in2 ----
p2 = sub.add_parser("in2", help="监听 IN2(sysfs gpio_status)")
p2.add_argument("interval", nargs="?", type=float, default=DEFAULT_INTERVAL,
help=f"轮询间隔秒(默认 {DEFAULT_INTERVAL})")
p2.add_argument("--check", action="store_true",
help="只自检:复算编号 + 打印当前电平")
p2.add_argument("-t", "--duration", type=float, default=0,
help="监听秒数,0=一直跑")
p2.set_defaults(func=cmd_in2)
# ---- both ----
p3 = sub.add_parser("both", help="同时监听 IN1 + IN2")
p3.add_argument("-d", "--device", default="auto",
help="IN1 事件设备路径;auto=自动(默认)")
p3.add_argument("-k", "--key", type=lambda s: int(s, 0), default=KEY_UP)
p3.add_argument("--active-low", dest="active_low", action="store_true",
default=True)
p3.add_argument("--no-active-low", dest="active_low", action="store_false")
p3.add_argument("-t", "--duration", type=float, default=0)
p3.add_argument("--interval", type=float, default=DEFAULT_INTERVAL,
help="IN2 轮询间隔秒")
p3.set_defaults(func=cmd_both)
return p
def main(argv=None):
args = build_parser().parse_args(argv)
return args.func(args)
if __name__ == "__main__":
sys.exit(main())
+63
View File
@@ -0,0 +1,63 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""全局常量与默认值。"""
import os
# ---- input 事件协议(IN1/event 后端用)----
EV_KEY = 0x01
KEY_UP = 103
VALUE_RELEASE = 0
VALUE_PRESS = 1
VALUE_REPEAT = 2
DEFAULT_EVENT_DEVICE = "/dev/input/event1"
GPIO_KEYS_NAME = "gpio-keys"
# ---- IN 通道编号 ----
IN1_INDEX = 1
IN2_INDEX = 2
# IN2 硬件信息(用于 --check 复算)
IN2_GPIO_NUM = 483
IN2_GPIOCHIP = 480
# ---- sysfs 状态文件候选路径 ----
# 按 in_index 分组,每个通道可以有多个候选路径,按顺序尝试
STATUS_CANDIDATES = {
1: [
"/sys/bus/platform/devices/gpio-in-1/gpio_status",
"/dev/tv_gpioin_1",
# SE9 若有其它路径,加到这里
],
2: [
"/sys/bus/platform/devices/gpio-in-2/gpio_status",
"/dev/tv_gpioin_2",
],
}
STATUS_FILE_ENV = "DI_STATUS_FILE" # 测试用覆盖
LOG_DIR_ENV = "DI_LOG_DIR"
DEVICETREE_BASE = "/sys/firmware/devicetree/base"
DEBOUNCE = 2 # 连续多少次采样一致才确认跳变
DEFAULT_INTERVAL = 0.02 # 轮询间隔秒
def candidate_status_files(in_index: int):
"""返回某通道的所有候选状态文件路径(含环境变量覆盖)。"""
paths = []
env = os.environ.get(STATUS_FILE_ENV)
if env:
paths.append(env)
paths.extend(STATUS_CANDIDATES.get(in_index, []))
return paths
def find_status_file(in_index: int):
"""找到第一个可读的状态文件;找不到返回 None。"""
for p in candidate_status_files(in_index):
if os.access(p, os.R_OK):
return p
return None
+204
View File
@@ -0,0 +1,204 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""DIChannel:统一的数字输入通道。
把不同后端(event / sysfs)归一成同一套 API:
ch = DIChannel("IN1", backend=make_in1_backend(), active_low=True)
ch.on_change = lambda old, new, ts: ...
ch.run() # 阻塞
ch.run(duration=10) # 跑 10 秒
电平语义:
对外统一用 0/1,0 = 低/断电,1 = 高/有电。
active_low=True 时,把底层原始值取反(适配光耦反相)。
"""
import datetime
import select
import time
def now_str():
return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]
def fmt_dur(ms):
if ms < 1000:
return f"{ms}ms"
return f"{ms / 1000:.3f}s"
class DIChannel:
"""单个数字输入通道。"""
def __init__(self, name, backend, active_low=False,
on_change=None, on_press=None, on_release=None,
on_event=None, log=None):
"""
name : 通道名,如 "IN1"
backend : Backend 实例
active_low : True 时把原始值取反(0->1, 1->0)
on_change : (old, new, ts) -> None
on_press : (ts) -> None # new=1
on_release : (ts) -> None # new=0
on_event : (ts, raw) -> None # 原始事件
log : (msg) -> None
"""
self.name = name
self.backend = backend
self.active_low = active_low
self.on_change = on_change
self.on_press = on_press
self.on_release = on_release
self.on_event = on_event
self.log = log or (lambda m: print(m, flush=True))
self._level = None
self._level_since = None
self._stop = False
self._count = 0
self._ms_low = 0
self._ms_high = 0
# ---- 上下文管理 ----
def __enter__(self):
self.open()
return self
def __exit__(self, *exc):
self.close()
def open(self):
self.backend.open()
def close(self):
self.backend.close()
# ---- 电平换算 ----
def _to_level(self, raw):
if raw is None:
return None
v = 1 if raw else 0
if self.active_low:
v = 1 - v
return v
# ---- 回调分发 ----
def _emit(self, new, ts):
old = self._level
if old == new:
return
self._level = new
now_ms = int(time.time() * 1000)
if self._level_since is not None:
dur = now_ms - self._level_since
if old == 0:
self._ms_low += dur
elif old == 1:
self._ms_high += dur
self._level_since = now_ms
self._count += 1
self.log(f"{now_str()} {self.name} {'有电' if new else '断电'}")
if self.on_change:
self.on_change(old, new, ts)
if new == 1 and self.on_press:
self.on_press(ts)
elif new == 0 and self.on_release:
self.on_release(ts)
# ---- 单次读取(用于初始化)----
def read_now(self):
"""立即读一次并返回归一化后的电平;失败返回 None。
仅对支持 read_raw 的后端(sysfs)有效;event 后端返回 None。
"""
raw = None
if hasattr(self.backend, "read_raw"):
raw = self.backend.read_raw()
if raw is None:
return None
lvl = self._to_level(int(raw))
self._level = lvl
self._level_since = int(time.time() * 1000)
return lvl
# ---- 主循环 ----
def run(self, duration=None):
"""阻塞监听。duration 秒后返回;None = 一直跑到 Ctrl-C。"""
self.open()
# 初始化当前电平
if self._level is None:
lvl = self.read_now()
if lvl is not None:
self.log(f"{self.name} 初始电平:{lvl}")
else:
# event 后端:置为 0,等第一个事件再校正
self._level = 0
self._level_since = int(time.time() * 1000)
deadline = time.time() + duration if duration else None
try:
if self.backend.can_poll:
self._run_poll(deadline)
else:
self._run_sample(deadline)
finally:
self.close()
def _run_poll(self, deadline):
poller = select.poll()
poller.register(self.backend.fileno(), select.POLLIN)
while not self._stop:
timeout = 500
if deadline:
remain = deadline - time.time()
if remain <= 0:
break
timeout = int(min(remain, 0.5) * 1000)
poller.poll(timeout)
got = self.backend.read()
if got:
raw, ts = got
if self.on_event:
self.on_event(ts, raw)
self._emit(self._to_level(raw), ts)
def _run_sample(self, deadline):
interval = getattr(self.backend, "interval", 0.02)
while not self._stop:
if deadline and time.time() >= deadline:
break
got = self.backend.read()
if got:
raw, ts = got
lvl = self._to_level(raw)
if self.on_event:
self.on_event(ts, raw)
self._emit(lvl, ts)
time.sleep(interval)
def request_stop(self):
self._stop = True
# ---- 汇总 ----
def summary(self):
now_ms = int(time.time() * 1000)
if self._level_since is not None:
dur = now_ms - self._level_since
if self._level == 0:
self._ms_low += dur
elif self._level == 1:
self._ms_high += dur
self._level_since = now_ms
return {
"name": self.name,
"count": self._count,
"ms_low": self._ms_low,
"ms_high": self._ms_high,
"level": self._level,
}
@@ -0,0 +1,66 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""从设备树复算 gpio-in-N 对应的全局 GPIO 号。"""
from pathlib import Path
from .config import DEVICETREE_BASE
def _read_be32(path: Path, offset: int = 0):
try:
data = path.read_bytes()
except OSError:
return None
if len(data) < offset + 4:
return None
return int.from_bytes(data[offset:offset + 4], "big")
def derive_gpio(n: int, base_dir: str = DEVICETREE_BASE):
"""从设备树复算 IN<n> 的全局 GPIO 号。
返回 (gpio_num, label, pin) 或 None。
"""
base = Path(base_dir)
f = base / f"gpio-in-{n}" / "control-gpios"
if not f.exists():
return None
try:
data = f.read_bytes()
except OSError:
return None
if len(data) < 8:
return None
ph = int.from_bytes(data[0:4], "big")
pin = int.from_bytes(data[4:8], "big")
# phandle -> gpio-controller 节点
ctrl = None
for c in base.glob("gpio@*/gpio-controller@*"):
cph = _read_be32(c / "phandle")
if cph == ph:
ctrl = c
break
if ctrl is None:
return None
bank = ctrl.parent.name
if bank.startswith("gpio@"):
bank = bank[len("gpio@"):]
label = f"{bank}.gpio"
# label -> gpiochip base
gpio_class = Path("/sys/class/gpio")
if not gpio_class.exists():
return None
for g in gpio_class.glob("gpiochip*"):
try:
if (g / "label").read_text().strip() == label:
chip_base = int((g / "base").read_text().strip())
return chip_base + pin, label, pin
except (OSError, ValueError):
continue
return None