X-Git-Url: http://www.average.org/gitweb/?a=blobdiff_plain;f=loctrkd%2Fbeesure.py;h=b3afae149e619875f7ec089a97690de182ba0459;hb=ed78cfbeae56fa31e844f2858b409f39464c93a0;hp=2a81b6eb290927dd49d26dfed0d9af2e938a8576;hpb=c602ee4c0f76feb819010a17e426de55b3ad89bd;p=loctrkd.git diff --git a/loctrkd/beesure.py b/loctrkd/beesure.py index 2a81b6e..b3afae1 100755 --- a/loctrkd/beesure.py +++ b/loctrkd/beesure.py @@ -22,20 +22,28 @@ from typing import ( ) from types import SimpleNamespace +from .protomodule import ProtoClass +from .common import ( + CoordReport, + HintReport, + StatusReport, + Report, +) + __all__ = ( "Stream", "class_by_prefix", "enframe", + "exposed_protos", "inline_response", "proto_handled", "parse_message", "probe_buffer", - "proto_name", "DecodeError", "Respond", - "LK", ) +PMODNAME = __name__.split(".")[-1] PROTO_PREFIX = "BS:" ### Deframer ### @@ -109,7 +117,7 @@ class Stream: else: msgs.append( f"Packet does not end with ']'" - f" at {self.datalen+20}: {self.buffer=!r}" + f" at {self.datalen+20}: {self.buffer[:64]=!r}" ) self.buffer = self.buffer[self.datalen + 21 :] self.datalen = 0 @@ -133,6 +141,14 @@ def enframe(buffer: bytes, imei: Optional[str] = None) -> bytes: ### Parser/Constructor ### +class classproperty: + def __init__(self, f: Callable[[Any], str]) -> None: + self.f = f + + def __get__(self, obj: Any, owner: Any) -> str: + return self.f(owner) + + class DecodeError(Exception): def __init__(self, e: Exception, **kwargs: Any) -> None: super().__init__(e) @@ -170,54 +186,19 @@ def l3str(x: Union[str, List[str]]) -> List[str]: return lx -class MetaPkt(type): - """ - For each class corresponding to a message, automatically create - two nested classes `In` and `Out` that also inherit from their - "nest". Class attribute `IN_KWARGS` defined in the "nest" is - copied to the `In` nested class under the name `KWARGS`, and - likewise, `OUT_KWARGS` of the nest class is copied as `KWARGS` - to the nested class `Out`. In addition, method `encode` is - defined in both classes equal to `in_encode()` and `out_encode()` - respectively. - """ - - if TYPE_CHECKING: - - def __getattr__(self, name: str) -> Any: - pass +def pblist(x: Union[str, List[Tuple[str, str]]]) -> List[Tuple[str, str]]: + if isinstance(x, str): - def __setattr__(self, name: str, value: Any) -> None: - pass + def splitpair(s: str) -> Tuple[str, str]: + a, b = s.split(":") + return a, b - def __new__( - cls: Type["MetaPkt"], - name: str, - bases: Tuple[type, ...], - attrs: Dict[str, Any], - ) -> "MetaPkt": - newcls = super().__new__(cls, name, bases, attrs) - newcls.In = super().__new__( - cls, - name + ".In", - (newcls,) + bases, - { - "KWARGS": newcls.IN_KWARGS, - "decode": newcls.in_decode, - "encode": newcls.in_encode, - }, - ) - newcls.Out = super().__new__( - cls, - name + ".Out", - (newcls,) + bases, - { - "KWARGS": newcls.OUT_KWARGS, - "decode": newcls.out_decode, - "encode": newcls.out_encode, - }, - ) - return newcls + lx = [splitpair(el) for el in x.split(",")] + else: + lx = x + if len(lx) > 5: + raise ValueError(str(lx) + " has too many elements (max 5)") + return lx class Respond(Enum): @@ -226,9 +207,9 @@ class Respond(Enum): EXT = 2 # Birirectional, use external responder -class BeeSurePkt(metaclass=MetaPkt): +class BeeSurePkt(ProtoClass): + BINARY = False RESPOND = Respond.NON # Do not send anything back by default - PROTO: str IN_KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = () OUT_KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = () KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = () @@ -248,11 +229,15 @@ class BeeSurePkt(metaclass=MetaPkt): Construct the object _either_ from (length, payload), _or_ from the values of individual fields """ + self.payload: Union[List[str], bytes] assert not args or (len(args) == 4 and not kwargs) if args: # guaranteed to be two arguments at this point self.vendor, self.imei, self.datalength, self.payload = args try: - self.decode(*self.payload) + if isinstance(self.payload, list): + self.decode(*self.payload) + else: + self.decode(self.payload) except error as e: raise DecodeError(e, obj=self) else: @@ -278,7 +263,7 @@ class BeeSurePkt(metaclass=MetaPkt): ), ) - def decode(self, *args: str) -> None: + def decode(self, *args: Any) -> None: ... def in_decode(self, *args: str) -> None: @@ -302,6 +287,21 @@ class BeeSurePkt(metaclass=MetaPkt): # Overridden in subclasses, otherwise command verb only return "" + @classproperty + def PROTO(cls: "BeeSurePkt") -> str: + """Name of the class without possible .In / .Out suffix""" + proto: str + try: + proto, _ = cls.__name__.split(".") + except ValueError: + proto = cls.__name__ + return proto + + @classmethod + def proto_name(cls) -> str: + """Name of the command as used externally""" + return PROTO_PREFIX + cls.PROTO[:16] + @property def packed(self) -> bytes: data = self.encode() @@ -310,32 +310,15 @@ class BeeSurePkt(metaclass=MetaPkt): class UNKNOWN(BeeSurePkt): - PROTO = "UNKNOWN" - - -class LK(BeeSurePkt): - PROTO = "LK" - RESPOND = Respond.INL - - def in_decode(self, *args: str) -> None: - numargs = len(args) - if numargs > 1: - self.step = args[1] - if numargs > 2: - self.tumbling_number = args[2] - if numargs > 3: - self.battery_percentage = args[3] - - def in_encode(self) -> str: - return "LK" + pass -class CONFIG(BeeSurePkt): - PROTO = "CONFIG" - +class _SET_PHONE(BeeSurePkt): + OUT_KWARGS = (("phonenumber", str, ""),) -class ICCID(BeeSurePkt): - PROTO = "ICCID" + def out_encode(self) -> str: + self.phonenumber: str + return self.phonenumber class _LOC_DATA(BeeSurePkt): @@ -344,7 +327,6 @@ class _LOC_DATA(BeeSurePkt): _id = lambda x: x for (obj, attr, func), val in zip( ( - (p, "verb", _id), (p, "date", _id), (p, "time", _id), (self, "gps_valid", lambda x: x == "A"), @@ -361,21 +343,21 @@ class _LOC_DATA(BeeSurePkt): (self, "pedometer", int), (self, "tubmling_times", int), (self, "device_status", lambda x: int(x, 16)), - (self, "base_stations_number", int), + (self, "gsm_cells_number", int), (self, "connect_base_station_number", int), (self, "mcc", int), (self, "mnc", int), ), - args[:21], + args[:20], ): setattr(obj, attr, func(val)) # type: ignore - rest_args = args[21:] + rest_args = args[20:] # (area_id, cell_id, strength)* - self.base_stations = [ - tuple(int(el) for el in rest_args[i * 3 : 3 + i * 3]) - for i in range(self.base_stations_number) + self.gsm_cells: List[Tuple[int, int, int]] = [ + tuple(int(el) for el in rest_args[i * 3 : 3 + i * 3]) # type: ignore + for i in range(self.gsm_cells_number) ] - rest_args = rest_args[3 * self.base_stations_number :] + rest_args = rest_args[3 * self.gsm_cells_number :] self.wifi_aps_number = int(rest_args[0]) # (SSID, MAC, strength)* self.wifi_aps = [ @@ -399,36 +381,57 @@ class _LOC_DATA(BeeSurePkt): self.latitude = p.lat * p.nors self.longitude = p.lon * p.eorw + def rectified(self) -> Report: + # self.gps_valid is supposed to mean it, but it does not. Perfectly + # good looking coordinates, with ten satellites, still get 'V'. + # I suspect that in reality, 'A' means "hint data is absent". + if self.gps_valid or self.num_of_sats > 3: + return CoordReport( + devtime=str(self.devtime), + battery_percentage=self.battery_percentage, + accuracy=self.positioning_accuracy, + altitude=self.altitude, + speed=self.speed, + direction=self.direction, + latitude=self.latitude, + longitude=self.longitude, + ) + else: + return HintReport( + devtime=str(self.devtime), + battery_percentage=self.battery_percentage, + mcc=self.mcc, + mnc=self.mnc, + gsm_cells=self.gsm_cells, + wifi_aps=self.wifi_aps, + ) -class UD(_LOC_DATA): - PROTO = "UD" +class AL(_LOC_DATA): + RESPOND = Respond.INL -class UD2(_LOC_DATA): - PROTO = "UD2" +class CALL(_SET_PHONE): + pass -class TKQ(BeeSurePkt): - PROTO = "TKQ" - RESPOND = Respond.INL - -class TKQ2(BeeSurePkt): - PROTO = "TKQ2" - RESPOND = Respond.INL +class CENTER(_SET_PHONE): + pass -class AL(_LOC_DATA): - PROTO = "AL" - RESPOND = Respond.INL +class CONFIG(BeeSurePkt): + pass class CR(BeeSurePkt): - PROTO = "CR" + pass + + +class FIND(BeeSurePkt): + pass class FLOWER(BeeSurePkt): - PROTO = "FLOWER" OUT_KWARGS = (("number", int, 1),) def out_encode(self) -> str: @@ -436,16 +439,76 @@ class FLOWER(BeeSurePkt): return str(self.number) +class ICCID(BeeSurePkt): + pass + + +class LK(BeeSurePkt): + RESPOND = Respond.INL + + def in_decode(self, *args: str) -> None: + numargs = len(args) + if numargs > 0: + self.step = args[0] + if numargs > 1: + self.tumbling_number = args[1] + if numargs > 2: + self.battery_percentage = args[2] + + def in_encode(self) -> str: + return "LK" + + +class LZ(BeeSurePkt): + OUT_KWARGS = (("language", int, 1), ("timezone", int, 0)) + + def out_encode(self) -> str: + return f"{self.language},{self.timezone}" + + +class MESSAGE(BeeSurePkt): + OUT_KWARGS = (("message", str, ""),) + + def out_encode(self) -> str: + return str(self.message.encode("utf_16_be").hex()) + + +class MONITOR(BeeSurePkt): + pass + + +class _PHB(BeeSurePkt): + OUT_KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = ( + ("entries", pblist, []), + ) + + def out_encode(self) -> str: + self.entries: List[Tuple[str, str]] + return ",".join( + [ + ",".join((num, name.encode("utf_16_be").hex())) + for name, num in self.entries + ] + ) + + +class PHB(_PHB): + pass + + +class PHB2(_PHB): + pass + + class POWEROFF(BeeSurePkt): - PROTO = "POWEROFF" + pass class RESET(BeeSurePkt): - PROTO = "RESET" + pass class SOS(BeeSurePkt): - PROTO = "SOS" OUT_KWARGS = (("phonenumbers", l3str, ["", "", ""]),) def out_encode(self) -> str: @@ -453,29 +516,62 @@ class SOS(BeeSurePkt): return ",".join(self.phonenumbers) -class _SET_PHONE(BeeSurePkt): - OUT_KWARGS = (("phonenumber", str, ""),) +class SOS1(_SET_PHONE): + pass + + +class SOS2(_SET_PHONE): + pass + + +class SOS3(_SET_PHONE): + pass + + +class TK(BeeSurePkt): + BINARY = True + RESPOND = Respond.INL + + def in_decode(self, *args: Any) -> None: + assert len(args) == 1 and isinstance(args[0], bytes) + self.amr_data = ( + args[0] + .replace(b"}*", b"*") + .replace(b"},", b",") + .replace(b"}[", b"[") + .replace(b"}]", b"]") + .replace(b"}}", b"}") + ) def out_encode(self) -> str: - self.phonenumber: str - return self.phonenumber + return "1" # 0 - receive failure, 1 - receive success -class SOS1(_SET_PHONE): - PROTO = "SOS1" +class TKQ(BeeSurePkt): + RESPOND = Respond.INL -class SOS2(_SET_PHONE): - PROTO = "SOS2" +class TKQ2(BeeSurePkt): + RESPOND = Respond.INL -class SOS3(_SET_PHONE): - PROTO = "SOS3" +class UD(_LOC_DATA): + pass + + +class UD2(_LOC_DATA): + pass + + +class UPLOAD(BeeSurePkt): + OUT_KWARGS = (("interval", int, 600),) + + def out_encode(self) -> str: + return str(self.interval) # Build dicts protocol number -> class and class name -> protocol number CLASSES = {} -PROTOS = {} if True: # just to indent the code, sorry! for cls in [ cls @@ -484,24 +580,18 @@ if True: # just to indent the code, sorry! and issubclass(cls, BeeSurePkt) and not name.startswith("_") ]: - if hasattr(cls, "PROTO"): - CLASSES[cls.PROTO] = cls - PROTOS[cls.__name__] = cls.PROTO + CLASSES[cls.__name__] = cls def class_by_prefix( prefix: str, -) -> Union[Type[BeeSurePkt], List[Tuple[str, str]]]: +) -> Union[Type[BeeSurePkt], List[str]]: if prefix.startswith(PROTO_PREFIX): pname = prefix[len(PROTO_PREFIX) :].upper() else: raise KeyError(pname) - lst = [ - (name, proto) - for name, proto in PROTOS.items() - if name.upper().startswith(pname) - ] - for _, proto in lst: + lst = [name for name in CLASSES.keys() if name.upper().startswith(pname)] + for proto in lst: if len(lst) == 1: # unique prefix match return CLASSES[proto] if proto == pname: # exact match @@ -513,14 +603,15 @@ def proto_handled(proto: str) -> bool: return proto.startswith(PROTO_PREFIX) -def proto_name(obj: Union[MetaPkt, BeeSurePkt]) -> str: - return PROTO_PREFIX + ( - obj.__class__.__name__ if isinstance(obj, BeeSurePkt) else obj.__name__ - ) +def _local_proto(packet: bytes) -> str: + try: + return packet[20:-1].split(b",")[0].decode() + except UnicodeDecodeError: + return "UNKNOWN" def proto_of_message(packet: bytes) -> str: - return PROTO_PREFIX + packet[20:-1].split(b",")[0].decode() + return PROTO_PREFIX + _local_proto(packet) def imei_from_packet(packet: bytes) -> Optional[str]: @@ -535,7 +626,7 @@ def is_goodbye_packet(packet: bytes) -> bool: def inline_response(packet: bytes) -> Optional[bytes]: - proto = packet[20:-1].split(b",")[0].decode() + proto = _local_proto(packet) if proto in CLASSES: cls = CLASSES[proto] if cls.RESPOND is Respond.INL: @@ -550,24 +641,52 @@ def probe_buffer(buffer: bytes) -> bool: def parse_message(packet: bytes, is_incoming: bool = True) -> BeeSurePkt: """From a packet (without framing bytes) derive the XXX.In object""" toskip, vendor, imei, datalength = _framestart(packet) - payload = packet[20:-1].decode().split(",") - proto = payload[0] if len(payload) > 0 else "" - if proto not in CLASSES: - cause: Union[DecodeError, ValueError, IndexError] = ValueError( - f"Proto {proto} is unknown" - ) + bsplits = packet[20:-1].split(b",", 1) + try: + proto = bsplits[0].decode("ascii") + except UnicodeDecodeError: + proto = str(bsplits[0]) + if len(bsplits) == 2: + rest = bsplits[1] else: + rest = b"" + if proto in CLASSES: + cls = CLASSES[proto].In if is_incoming else CLASSES[proto].Out + payload = ( + # Some people encode their SSIDs in non-utf8 + rest + if cls.BINARY + else rest.decode("Windows-1252").split(",") + ) try: - if is_incoming: - return CLASSES[proto].In(vendor, imei, datalength, payload) - else: - return CLASSES[proto].Out(vendor, imei, datalength, payload) + return cls(vendor, imei, datalength, payload) except (DecodeError, ValueError, IndexError) as e: - cause = e + cause: Union[DecodeError, ValueError, IndexError] = e + else: + payload = rest + cause = ValueError(f"Proto {proto} is unknown") if is_incoming: retobj = UNKNOWN.In(vendor, imei, datalength, payload) else: retobj = UNKNOWN.Out(vendor, imei, datalength, payload) - retobj.PROTO = proto # Override class attr with object attr + retobj.proto = proto # Override class attr with object attr retobj.cause = cause return retobj + + +def exposed_protos() -> List[Tuple[str, bool]]: + return [ + (cls.proto_name(), False) + for cls in CLASSES.values() + if hasattr(cls, "rectified") + ] + + +def make_response(cmd: str, imei: str, **kwargs: Any) -> Optional[BeeSurePkt]: + if cmd == "poweroff": + return POWEROFF.Out() + elif cmd == "refresh": + return MONITOR.Out() + elif cmd == "message": + return MESSAGE.Out(message=kwargs.get("txt", "Hello")) + return None