1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
"""
Module for Serialization and Deserialization of KNX Description Response.
The DESCRIPTION_RESPONSE frame shall be sent by the KNXnet/IP Server as an answer to
a received DESCRIPTION_REQUEST frame. It shall be addressed to the KNXnet/IP Clients
control endpoint using the HPAI included in the received DESCRIPTION_REQUEST frame.
The size of the KNXnet/IP body varies depending on the number of DIB structures sent
by the KNXnet/IP Server in response to the KNXnet/IP Clients DESCRIPTION_REQUEST.
"""
from __future__ import annotations
from .body import KNXIPBody
from .dib import DIB, DIBDeviceInformation
from .knxip_enum import KNXIPServiceType
class DescriptionResponse(KNXIPBody):
"""Representation of a KNX Description Response."""
SERVICE_TYPE = KNXIPServiceType.DESCRIPTION_RESPONSE
def __init__(self) -> None:
"""Initialize SearchResponse object."""
self.dibs: list[DIB] = []
def calculated_length(self) -> int:
"""Get length of KNX/IP body."""
return sum(dib.calculated_length() for dib in self.dibs)
def from_knx(self, raw: bytes) -> int:
"""Parse/deserialize from KNX/IP raw data."""
pos = 0
while raw[pos:]:
dib = DIB.determine_dib(raw[pos:])
pos += dib.from_knx(raw[pos:])
self.dibs.append(dib)
return pos
@property
def device_name(self) -> str:
"""Return name of device."""
return next(
(dib.name for dib in self.dibs if isinstance(dib, DIBDeviceInformation)),
"UNKNOWN",
)
def to_knx(self) -> bytes:
"""Serialize to KNX/IP raw data."""
return b"".join(dib.to_knx() for dib in self.dibs)
def __repr__(self) -> str:
"""Return object as readable string."""
_dibs_str = ",\n".join(dib.__repr__() for dib in self.dibs)
return f'<DescriptionResponse dibs="[\n{_dibs_str}\n]" />'
|
