Petr Polezhaev
157df4e795
- PROTOCOL.md: полная спецификация (KDF, envelope/CBC-цепочка, local_reg, key exchange, commands.json 206/200, datapoint push, тайминги, таблицы свойств шаблонов A/B/F, облачный provisioning). Факты из APK помечены [APK], проверенные живыми экспериментами на AP-WC1E — [ПРОВЕРЕНО НА ПРИБОРЕ]: mDNS только :10276; лимит 2 LAN-сессии (3-я -> 503); принудительный re-key при возрасте сессии >= ~44с (единственный механизм самолечения десинхрона — 400/401 модуль игнорирует); записи не эхируются; delete_session освобождает слот. - LEGACY_ANALYSIS.md: причины рассинхрона (keep-alive 1200с вместо 10-15с + seq_no-фильтр) и перегрузки модуля; требования к новой реализации. - PLAN_CORE_LIBRARY.md: план C++20-библиотеки fglair-core (Linux + ESP-IDF), ключ lanip_key считается статичным, ротация — только ошибка + ручной перепровижининг. - PLAN_HOME_ASSISTANT.md: pyfglair (cffi wheel) + custom component, облачный provisioning только в config flow, ключ виден в диагностике для копирования в ESPHome. - PLAN_ESPHOME.md: external component, только ESP-IDF framework. - tools/probe_reference.py: эталонный клиент протокола (проверен на приборе end-to-end); tools/probe_mdns.py — mDNS-проба. - legacy/: снимок скрипта (апстрим gyro-labs/AirCon, вложенный клон не версионируется); apk/*.apk исключены из версионирования.
526 lines
22 KiB
Python
526 lines
22 KiB
Python
from dataclasses import dataclass, field
|
|
from dataclasses_json import dataclass_json
|
|
import enum
|
|
|
|
|
|
class AirFlowState(enum.IntEnum):
|
|
OFF = 0
|
|
VERTICAL_ONLY = 1
|
|
HORIZONTAL_ONLY = 2
|
|
VERTICAL_AND_HORIZONTAL = 3
|
|
|
|
|
|
class FanSpeed(enum.IntEnum):
|
|
AUTO = 0
|
|
LOWER = 5
|
|
LOW = 6
|
|
MEDIUM = 7
|
|
HIGH = 8
|
|
HIGHER = 9
|
|
|
|
|
|
class SleepMode(enum.IntEnum):
|
|
STOP = 0
|
|
ONE = 1
|
|
TWO = 2
|
|
THREE = 3
|
|
FOUR = 4
|
|
|
|
|
|
class StateMachine(enum.IntEnum):
|
|
FANONLY = 0
|
|
HEAT = 1
|
|
COOL = 2
|
|
DRY = 3
|
|
AUTO = 4
|
|
FAULTSHIELD = 5
|
|
POWEROFF = 6
|
|
OFFLINE = 7
|
|
READONLYSHARED = 8
|
|
|
|
|
|
class AcWorkMode(enum.IntEnum):
|
|
FAN = 0
|
|
HEAT = 1
|
|
COOL = 2
|
|
DRY = 3
|
|
AUTO = 4
|
|
|
|
|
|
class AirFlow(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class DeviceErrorStatus(enum.Enum):
|
|
NORMALSTATE = 0
|
|
FAULTSTATE = 1
|
|
|
|
|
|
class Dimmer(enum.Enum):
|
|
ON = 0
|
|
OFF = 1
|
|
|
|
|
|
class DoubleFrequency(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class Economy(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class EightHeat(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class FastColdHeat(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class Power(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class Quiet(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class TemperatureUnit(enum.Enum):
|
|
CELSIUS = 0
|
|
FAHRENHEIT = 1
|
|
|
|
|
|
class HumidifierWorkMode(enum.Enum):
|
|
NORMAL = 0
|
|
NIGHTLIGHT = 1
|
|
SLEEP = 2
|
|
|
|
|
|
class HumidifierWater(enum.Enum):
|
|
OK = 0
|
|
NO_WATER = 1
|
|
|
|
|
|
class Mist(enum.Enum):
|
|
SMALL = 1
|
|
MIDDLE = 2
|
|
BIG = 3
|
|
|
|
|
|
class MistState(enum.Enum):
|
|
OFF = 0
|
|
ON = 1
|
|
|
|
|
|
class FglOperationMode(enum.IntEnum):
|
|
OFF = 0
|
|
ON = 1
|
|
AUTO = 2
|
|
COOL = 3
|
|
DRY = 4
|
|
FAN_ONLY = 5
|
|
HEAT = 6
|
|
|
|
|
|
class FglFanSpeed(enum.IntEnum):
|
|
QUIET = 0
|
|
LOW = 1
|
|
MEDIUM = 2
|
|
HIGH = 3
|
|
AUTO = 4
|
|
|
|
|
|
class Properties(object):
|
|
|
|
@classmethod
|
|
def _get_metadata(cls, attr: str):
|
|
return cls.__dataclass_fields__[attr].metadata
|
|
|
|
@classmethod
|
|
def get_type(cls, attr: str):
|
|
return cls.__dataclass_fields__[attr].type
|
|
|
|
@classmethod
|
|
def parse_attr(cls, attr, value):
|
|
"""If a field supplies a parser function in its metadata, use it to parse its value from the raw data."""
|
|
# Retrieve the desired type from the class attribute type hinting
|
|
native_type = cls.__dataclass_fields__[attr].type
|
|
value_fmt = native_type(value)
|
|
|
|
# Detect parser for this attribute
|
|
parser = cls.__dataclass_fields__[attr].metadata.get('parser')
|
|
if parser:
|
|
value_fmt = parser(value)
|
|
|
|
return value_fmt
|
|
|
|
@classmethod
|
|
def get_base_type(cls, attr: str):
|
|
return cls._get_metadata(attr)['base_type']
|
|
|
|
@classmethod
|
|
def get_precision(cls, attr: str):
|
|
return cls._get_metadata(attr).get('precision', 1)
|
|
|
|
@classmethod
|
|
def get_update_precision(cls, attr: str):
|
|
metadata = cls._get_metadata(attr)
|
|
return metadata.get('update_precision', metadata.get('precision', 1))
|
|
|
|
@classmethod
|
|
def get_read_only(cls, attr: str):
|
|
return cls._get_metadata(attr)['read_only']
|
|
|
|
|
|
@dataclass_json
|
|
@dataclass
|
|
class AcProperties(Properties):
|
|
# ack_cmd: bool = field(default=None, metadata={'base_type': 'boolean', 'read_only': False})
|
|
f_electricity: int = field(default=100, metadata={'base_type': 'integer', 'read_only': True})
|
|
f_e_arkgrille: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_incoiltemp: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_incom: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_indisplay: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_ineeprom: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_inele: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_infanmotor: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_inhumidity: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_inkeys: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_inlow: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_intemp: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_invzero: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outcoiltemp: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outeeprom: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outgastemp: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outmachine2: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outmachine: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outtemp: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_outtemplow: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_e_push: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_filterclean: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_humidity: int = field(default=50, metadata={
|
|
'base_type': 'integer',
|
|
'read_only': True
|
|
}) # Humidity
|
|
f_power_display: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': True})
|
|
f_temp_in: float = field(default=81.0, metadata={
|
|
'base_type': 'decimal',
|
|
'read_only': True
|
|
}) # EnvironmentTemperature (Fahrenheit)
|
|
f_voltage: int = field(default=0, metadata={'base_type': 'integer', 'read_only': True})
|
|
t_backlight: Dimmer = field(default=Dimmer.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Dimmer[x]
|
|
}
|
|
}) # DimmerStatus
|
|
t_control_value: int = field(default=None, metadata={'base_type': 'integer', 'read_only': False})
|
|
t_device_info: bool = field(default=0, metadata={'base_type': 'boolean', 'read_only': False})
|
|
t_display_power: bool = field(default=None, metadata={'base_type': 'boolean', 'read_only': False})
|
|
t_eco: Economy = field(default=Economy.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Economy[x]
|
|
}
|
|
})
|
|
t_fan_leftright: AirFlow = field(default=AirFlow.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: AirFlow[x]
|
|
}
|
|
}) # HorizontalAirFlow
|
|
t_fan_mute: Quiet = field(default=Quiet.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Quiet[x]
|
|
}
|
|
}) # QuietModeStatus
|
|
t_fan_power: AirFlow = field(default=AirFlow.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: AirFlow[x]
|
|
}
|
|
}) # VerticalAirFlow
|
|
t_fan_speed: FanSpeed = field(default=FanSpeed.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FanSpeed[x]
|
|
}
|
|
}) # FanSpeed
|
|
t_ftkt_start: int = field(default=None, metadata={'base_type': 'integer', 'read_only': False})
|
|
t_power: Power = field(default=Power.ON,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Power[x]
|
|
}
|
|
}) # PowerStatus
|
|
t_run_mode: DoubleFrequency = field(default=DoubleFrequency.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: DoubleFrequency[x]
|
|
}
|
|
}) # DoubleFrequency
|
|
t_setmulti_value: int = field(default=None, metadata={'base_type': 'integer', 'read_only': False})
|
|
t_sleep: SleepMode = field(default=SleepMode.STOP,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: SleepMode[x]
|
|
}
|
|
}) # SleepMode
|
|
t_temp: int = field(default=81, metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False
|
|
}) # CurrentTemperature
|
|
t_temptype: TemperatureUnit = field(default=TemperatureUnit.FAHRENHEIT,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: TemperatureUnit[x]
|
|
}
|
|
}) # CurrentTemperatureUnit
|
|
t_temp_eight: EightHeat = field(default=EightHeat.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: EightHeat[x]
|
|
}
|
|
}) # EightHeatStatus
|
|
t_temp_heatcold: FastColdHeat = field(default=FastColdHeat.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FastColdHeat[x]
|
|
}
|
|
}) # FastCoolHeatStatus
|
|
t_work_mode: AcWorkMode = field(default=AcWorkMode.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: AcWorkMode[x]
|
|
}
|
|
}) # WorkModeStatus
|
|
|
|
|
|
@dataclass_json
|
|
@dataclass
|
|
class HumidifierProperties(Properties):
|
|
humi: int = field(default=0, metadata={'base_type': 'integer', 'read_only': False})
|
|
mist: Mist = field(default=Mist.SMALL,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Mist[x]
|
|
}
|
|
})
|
|
mistSt: MistState = field(default=MistState.OFF,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': True,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: MistState[x]
|
|
}
|
|
})
|
|
realhumi: int = field(default=0, metadata={'base_type': 'integer', 'read_only': True})
|
|
remain: int = field(default=0, metadata={'base_type': 'integer', 'read_only': True})
|
|
switch: Power = field(default=Power.ON,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Power[x]
|
|
}
|
|
})
|
|
temp: int = field(default=81, metadata={'base_type': 'integer', 'read_only': True})
|
|
timer: int = field(default=-1, metadata={'base_type': 'integer', 'read_only': False})
|
|
water: HumidifierWater = field(default=HumidifierWater.OK,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': True,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: HumidifierWater[x]
|
|
}
|
|
})
|
|
workmode: HumidifierWorkMode = field(default=HumidifierWorkMode.NORMAL,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: HumidifierWorkMode[x]
|
|
}
|
|
})
|
|
|
|
|
|
@dataclass_json
|
|
@dataclass
|
|
class FglProperties(Properties):
|
|
operation_mode: FglOperationMode = field(default=FglOperationMode.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FglOperationMode[x]
|
|
}
|
|
})
|
|
fan_speed: FglFanSpeed = field(default=FglFanSpeed.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FglFanSpeed[x]
|
|
}
|
|
})
|
|
adjust_temperature: int = field(default=25,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'precision': 0.1,
|
|
'update_precision': 1.0,
|
|
'read_only': False
|
|
})
|
|
display_temperature: float = field(default=25,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': True,
|
|
'parser': lambda x: round((x-5000)/50)/2,
|
|
})
|
|
af_vertical_direction: int = field(default=3,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False
|
|
})
|
|
af_vertical_swing: AirFlow = field(default=AirFlow.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: AirFlow[x]
|
|
}
|
|
}) # HorizontalAirFlow
|
|
af_horizontal_direction: int = field(default=3,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False
|
|
})
|
|
af_horizontal_swing: AirFlow = field(default=AirFlow.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: AirFlow[x]
|
|
}
|
|
}) # HorizontalAirFlow
|
|
economy_mode: Economy = field(default=Economy.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Economy[x]
|
|
}
|
|
})
|
|
|
|
|
|
@dataclass_json
|
|
@dataclass
|
|
class FglBProperties(Properties):
|
|
operation_mode: FglOperationMode = field(default=FglOperationMode.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FglOperationMode[x]
|
|
}
|
|
})
|
|
fan_speed: FglFanSpeed = field(default=FglFanSpeed.AUTO,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: FglFanSpeed[x]
|
|
}
|
|
})
|
|
adjust_temperature: int = field(default=25,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'precision': 0.1,
|
|
'read_only': False
|
|
})
|
|
display_temperature: float = field(default=25,
|
|
metadata={
|
|
'base_type': 'float',
|
|
'read_only': True,
|
|
'parser': lambda x: round((x-5000)/50)/2,
|
|
})
|
|
af_vertical_move_step1: int = field(default=3,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False
|
|
})
|
|
af_horizontal_move_step1: int = field(default=3,
|
|
metadata={
|
|
'base_type': 'integer',
|
|
'read_only': False
|
|
})
|
|
economy_mode: Economy = field(default=Economy.OFF,
|
|
metadata={
|
|
'base_type': 'boolean',
|
|
'read_only': False,
|
|
'dataclasses_json': {
|
|
'encoder': lambda x: x.name,
|
|
'decoder': lambda x: Economy[x]
|
|
}
|
|
})
|