)
from types import SimpleNamespace
+from .protomodule import ProtoClass
+
__all__ = (
"Stream",
"class_by_prefix",
"proto_name",
"DecodeError",
"Respond",
- "LK",
)
PROTO_PREFIX = "BS:"
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 __setattr__(self, name: str, value: Any) -> None:
- pass
-
- 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
-
-
class Respond(Enum):
NON = 0 # Incoming, no response needed
INL = 1 # Birirectional, use `inline_response()`
EXT = 2 # Birirectional, use external responder
-class BeeSurePkt(metaclass=MetaPkt):
+class BeeSurePkt(ProtoClass):
RESPOND = Respond.NON # Do not send anything back by default
IN_KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = ()
OUT_KWARGS: Tuple[Tuple[str, Callable[[Any], Any], Any], ...] = ()
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:
),
)
- def decode(self, *args: str) -> None:
+ def decode(self, *args: Any) -> None:
...
def in_decode(self, *args: str) -> None:
pass
-class LK(BeeSurePkt):
- 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"
-
-
-class CONFIG(BeeSurePkt):
- pass
-
-
-class ICCID(BeeSurePkt):
- pass
-
-
class _LOC_DATA(BeeSurePkt):
def in_decode(self, *args: str) -> None:
p = SimpleNamespace()
_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"),
(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])
self.latitude = p.lat * p.nors
self.longitude = p.lon * p.eorw
+ def rectified(self) -> Dict[str, Any]: # JSON-able dict
+ if self.gps_valid:
+ return {
+ "type": "location",
+ "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 {
+ "type": "approximate_location",
+ "devtime": str(self.devtime),
+ "battery_percentage": self.battery_percentage,
+ "mcc": self.mcc,
+ "mnc": self.mnc,
+ "base_stations": self.base_stations,
+ "wifi_aps": self.wifi_aps,
+ }
-class UD(_LOC_DATA):
+
+class AL(_LOC_DATA):
+ RESPOND = Respond.INL
+
+
+class CONFIG(BeeSurePkt):
pass
-class UD2(_LOC_DATA):
+class CR(BeeSurePkt):
pass
-class TKQ(BeeSurePkt):
- RESPOND = Respond.INL
+class FLOWER(BeeSurePkt):
+ OUT_KWARGS = (("number", int, 1),)
+ def out_encode(self) -> str:
+ self.number: int
+ return str(self.number)
-class TKQ2(BeeSurePkt):
- RESPOND = Respond.INL
+
+class ICCID(BeeSurePkt):
+ pass
-class AL(_LOC_DATA):
+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]
-class CR(BeeSurePkt):
- pass
+ def in_encode(self) -> str:
+ return "LK"
-class FLOWER(BeeSurePkt):
- OUT_KWARGS = (("number", int, 1),)
+class MESSAGE(BeeSurePkt):
+ OUT_KWARGS = (("message", str, ""),)
def out_encode(self) -> str:
- self.number: int
- return str(self.number)
+ return str(self.message.encode("utf_16_be").hex())
class _PHB(BeeSurePkt):
pass
+class TK(BeeSurePkt):
+ 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:
+ return "1" # 0 - receive failure, 1 - receive success
+
+
+class TKQ(BeeSurePkt):
+ RESPOND = Respond.INL
+
+
+class TKQ2(BeeSurePkt):
+ RESPOND = Respond.INL
+
+
+class UD(_LOC_DATA):
+ pass
+
+
+class UD2(_LOC_DATA):
+ pass
+
+
# Build dicts protocol number -> class and class name -> protocol number
CLASSES = {}
if True: # just to indent the code, sorry!
return proto.startswith(PROTO_PREFIX)
-def proto_name(obj: Union[MetaPkt, BeeSurePkt]) -> str:
+def proto_name(obj: Union[Type[BeeSurePkt], BeeSurePkt]) -> str:
return PROTO_PREFIX + (
obj.__class__.__name__ if isinstance(obj, BeeSurePkt) else obj.__name__
)
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 ""
+ try:
+ splits = packet[20:-1].decode().split(",")
+ proto = splits[0] if len(splits) > 0 else ""
+ payload: Union[List[str], bytes] = splits[1:]
+ except UnicodeDecodeError:
+ bsplits = packet[20:-1].split(b",", 1)
+ if len(bsplits) == 2:
+ proto = bsplits[0].decode("ascii")
+ payload = bsplits[1]
if proto not in CLASSES:
cause: Union[DecodeError, ValueError, IndexError] = ValueError(
f"Proto {proto} is unknown"
def exposed_protos() -> List[Tuple[str, bool]]:
return [
- (proto_name(UD), True),
- (proto_name(UD2), False),
+ (proto_name(cls), False)
+ for cls in CLASSES.values()
+ if hasattr(cls, "rectified")
]