mirror of
https://github.com/andvikt/mega_hacs.git
synced 2025-12-11 17:14:28 +05:00
Compare commits
13 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e51b50797c | ||
|
|
c4205c7ddc | ||
|
|
6164966d0b | ||
|
|
ff6225a959 | ||
|
|
57f355d479 | ||
|
|
7d6273539e | ||
|
|
5da2973351 | ||
|
|
5eadd295f1 | ||
|
|
5bf432a27f | ||
|
|
d934e87ae5 | ||
|
|
0b54db9c44 | ||
|
|
2d15b60929 | ||
|
|
b0b4fdd6cf |
26
.github/ISSUE_TEMPLATE/bug-report.md
vendored
Normal file
26
.github/ISSUE_TEMPLATE/bug-report.md
vendored
Normal file
@@ -0,0 +1,26 @@
|
||||
---
|
||||
name: Bug report
|
||||
about: Create a report to help us improve
|
||||
title: ''
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Описание**
|
||||
A clear and concise description of what the bug is.
|
||||
|
||||
**Версии систем**
|
||||
Enviroment: raspberry/linux/windows/macos/docker
|
||||
HA version:
|
||||
mega_hacs version:
|
||||
megad firmware version:
|
||||
|
||||
**Ожидаемое поведение**
|
||||
A clear and concise description of what you expected to happen.
|
||||
|
||||
**Screenshots**
|
||||
If applicable, add screenshots to help explain your problem.
|
||||
|
||||
**LOG**
|
||||
Прочитайте в документации как включить подробный лог интеграции и приложите его здесь
|
||||
@@ -16,7 +16,7 @@ from homeassistant.helpers import config_validation as cv
|
||||
from homeassistant.components import mqtt
|
||||
from homeassistant.config_entries import ConfigEntry
|
||||
from .const import DOMAIN, CONF_INVERT, CONF_RELOAD, PLATFORMS, CONF_PORTS, CONF_CUSTOM, CONF_SKIP, CONF_PORT_TO_SCAN, \
|
||||
CONF_MQTT_INPUTS, CONF_HTTP, CONF_RESPONSE_TEMPLATE, CONF_ACTION, CONF_GET_VALUE
|
||||
CONF_MQTT_INPUTS, CONF_HTTP, CONF_RESPONSE_TEMPLATE, CONF_ACTION, CONF_GET_VALUE, CONF_ALLOW_HOSTS
|
||||
from .hub import MegaD
|
||||
from .config_flow import ConfigFlow
|
||||
from .http import MegaView
|
||||
@@ -26,6 +26,7 @@ _LOGGER = logging.getLogger(__name__)
|
||||
CONFIG_SCHEMA = vol.Schema(
|
||||
{
|
||||
DOMAIN: {
|
||||
vol.Optional(CONF_ALLOW_HOSTS): [str],
|
||||
vol.Required(str, description='id меги из веб-интерфейса'): {
|
||||
vol.Optional(int, description='номер порта'): {
|
||||
vol.Optional(CONF_SKIP, description='исключить порт из сканирования', default=False): bool,
|
||||
@@ -62,6 +63,7 @@ async def async_setup(hass: HomeAssistant, config: dict):
|
||||
"""YAML-конфигурация содержит только кастомизации портов"""
|
||||
hass.data[DOMAIN] = {CONF_CUSTOM: config.get(DOMAIN, {})}
|
||||
hass.data[DOMAIN][CONF_HTTP] = view = MegaView(cfg=config.get(DOMAIN, {}))
|
||||
view.allowed_hosts |= set(config.get(DOMAIN, {}).get(CONF_ALLOW_HOSTS, []))
|
||||
hass.http.register_view(view)
|
||||
hass.services.async_register(
|
||||
DOMAIN, 'save', partial(_save_service, hass), schema=vol.Schema({
|
||||
|
||||
@@ -25,15 +25,15 @@ STEP_USER_DATA_SCHEMA = vol.Schema(
|
||||
vol.Optional(CONF_PORT_TO_SCAN, default=0): int,
|
||||
vol.Optional(CONF_MQTT_INPUTS, default=True): bool,
|
||||
vol.Optional(CONF_NPORTS, default=37): int,
|
||||
vol.Optional(CONF_UPDATE_ALL, default=True): bool,
|
||||
# vol.Optional(CONF_UPDATE_ALL, default=True): bool,
|
||||
},
|
||||
)
|
||||
|
||||
|
||||
async def get_hub(hass: HomeAssistant, data):
|
||||
_mqtt = hass.data.get(mqtt.DOMAIN)
|
||||
if not isinstance(_mqtt, mqtt.MQTT):
|
||||
raise exceptions.MqttNotConfigured("mqtt must be configured first")
|
||||
# if not isinstance(_mqtt, mqtt.MQTT):
|
||||
# raise exceptions.MqttNotConfigured("mqtt must be configured first")
|
||||
hub = MegaD(hass, **data, lg=_LOGGER, mqtt=_mqtt, loop=asyncio.get_event_loop())
|
||||
hub.mqtt_id = await hub.get_mqtt_id()
|
||||
if not await hub.authenticate():
|
||||
|
||||
@@ -23,6 +23,7 @@ CONF_RESPONSE_TEMPLATE = 'response_template'
|
||||
CONF_ACTION = 'action'
|
||||
CONF_UPDATE_ALL = 'update_all'
|
||||
CONF_GET_VALUE = 'get_value'
|
||||
CONF_ALLOW_HOSTS = 'allow_hosts'
|
||||
PLATFORMS = [
|
||||
"light",
|
||||
"switch",
|
||||
|
||||
@@ -60,7 +60,7 @@ class MegaD:
|
||||
):
|
||||
"""Initialize."""
|
||||
if mqtt_inputs is None or mqtt_inputs == 'None' or mqtt_inputs is False:
|
||||
self.http = hass.data[DOMAIN][CONF_HTTP]
|
||||
self.http = hass.data.get(DOMAIN, {}).get(CONF_HTTP)
|
||||
self.http.allowed_hosts |= {host}
|
||||
else:
|
||||
self.http = None
|
||||
@@ -123,10 +123,16 @@ class MegaD:
|
||||
async with self.lck:
|
||||
self.entities.append(ent)
|
||||
|
||||
async def get_sensors(self):
|
||||
async def get_sensors(self, only_list=False):
|
||||
self.lg.debug(self.sensors)
|
||||
ports = []
|
||||
for x in self.sensors:
|
||||
await self.get_port(x)
|
||||
if only_list and x.http_cmd != 'list':
|
||||
continue
|
||||
if x.port in ports:
|
||||
continue
|
||||
await self.get_port(x.port, force_http=True, http_cmd=x.http_cmd)
|
||||
ports.append(x.port)
|
||||
|
||||
@property
|
||||
def is_online(self):
|
||||
@@ -157,6 +163,7 @@ class MegaD:
|
||||
self.lg.debug('poll')
|
||||
if self.mqtt is None:
|
||||
await self.get_all_ports()
|
||||
await self.get_sensors(only_list=True)
|
||||
return
|
||||
if len(self.sensors) > 0:
|
||||
await self.get_sensors()
|
||||
@@ -188,7 +195,9 @@ class MegaD:
|
||||
self.lg.warning('%s returned %s (%s)', url, req.status, await req.text())
|
||||
return None
|
||||
else:
|
||||
return await req.text()
|
||||
ret = await req.text()
|
||||
self.lg.debug('response %s', ret)
|
||||
return ret
|
||||
|
||||
async def save(self):
|
||||
await self.send_command(cmd='s')
|
||||
@@ -209,15 +218,20 @@ class MegaD:
|
||||
ret = {'value': ret}
|
||||
return ret
|
||||
|
||||
async def get_port(self, port):
|
||||
async def get_port(self, port, force_http=False, http_cmd='get'):
|
||||
"""
|
||||
Запрос состояния порта. Состояние всегда возвращается в виде объекта, всегда сохраняется в центральное
|
||||
хранилище values
|
||||
"""
|
||||
self.lg.debug(f'get port %s', port)
|
||||
if self.mqtt is None:
|
||||
ret = await self.request(pt=port, cmd='get')
|
||||
if self.mqtt is None or force_http:
|
||||
ret = await self.request(pt=port, cmd=http_cmd)
|
||||
ret = self.parse_response(ret)
|
||||
self.lg.debug('parsed: %s', ret)
|
||||
if http_cmd == 'list' and isinstance(ret, dict) and 'value' in ret:
|
||||
await asyncio.sleep(1)
|
||||
ret = await self.request(pt=port, http_cmd=http_cmd)
|
||||
ret = self.parse_response(ret)
|
||||
self.values[port] = ret
|
||||
return ret
|
||||
|
||||
@@ -346,7 +360,7 @@ class MegaD:
|
||||
return pty, m
|
||||
|
||||
async def scan_ports(self, nports=37):
|
||||
for x in range(nports+1):
|
||||
for x in range(0, nports+1):
|
||||
ret = await self.scan_port(x)
|
||||
if ret:
|
||||
yield [x, *ret]
|
||||
@@ -357,11 +371,15 @@ class MegaD:
|
||||
async for port, pty, m in self.scan_ports(nports):
|
||||
if pty == "0":
|
||||
ret['binary_sensor'][port].append({})
|
||||
elif pty == "1" and m in ['0', '1']:
|
||||
elif pty == "1" and m in ['0', '1', '3']:
|
||||
ret['light'][port].append({'dimmer': m == '1'})
|
||||
elif pty == '3':
|
||||
try:
|
||||
values = await self.get_port(port)
|
||||
http_cmd = 'get'
|
||||
values = await self.get_port(port, force_http=True)
|
||||
if values is None or (isinstance(values, dict) and str(values.get('value')) in ('', 'None')):
|
||||
values = await self.get_port(port, force_http=True, http_cmd='list')
|
||||
http_cmd = 'list'
|
||||
except asyncio.TimeoutError:
|
||||
self.lg.warning(f'timout on port {port}')
|
||||
continue
|
||||
@@ -382,6 +400,7 @@ class MegaD:
|
||||
unit_of_measurement=UNITS.get(key, UNITS[TEMP]),
|
||||
device_class=CLASSES.get(key, CLASSES[TEMP]),
|
||||
id_suffix=key,
|
||||
http_cmd=http_cmd,
|
||||
))
|
||||
return ret
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
"ssdp": [],
|
||||
"zeroconf": [],
|
||||
"homekit": {},
|
||||
"dependencies": [],
|
||||
"after_dependencies": ["mqtt"],
|
||||
"codeowners": [
|
||||
"@andvikt"
|
||||
],
|
||||
|
||||
@@ -101,6 +101,7 @@ class Mega1WSensor(MegaPushEntity):
|
||||
unit_of_measurement,
|
||||
device_class,
|
||||
key=None,
|
||||
http_cmd='get',
|
||||
*args,
|
||||
**kwargs
|
||||
):
|
||||
@@ -115,8 +116,8 @@ class Mega1WSensor(MegaPushEntity):
|
||||
self.key = key
|
||||
self._device_class = device_class
|
||||
self._unit_of_measurement = unit_of_measurement
|
||||
if self.port not in self.mega.sensors:
|
||||
self.mega.sensors.append(self.port)
|
||||
self.mega.sensors.append(self)
|
||||
self.http_cmd = http_cmd
|
||||
|
||||
@property
|
||||
def unit_of_measurement(self):
|
||||
@@ -143,16 +144,30 @@ class Mega1WSensor(MegaPushEntity):
|
||||
|
||||
@property
|
||||
def state(self):
|
||||
ret = None
|
||||
if self.key:
|
||||
ret = self.mega.values.get(self.port, {}).get('value', {}).get(self.key)
|
||||
try:
|
||||
ret = self.mega.values.get(self.port, {})
|
||||
if isinstance(ret, dict):
|
||||
ret = ret.get(self.key)
|
||||
except:
|
||||
self.lg.error(self.mega.values.get(self.port, {}).get('value', {}))
|
||||
return
|
||||
else:
|
||||
ret = self.mega.values.get(self.port, {}).get('value')
|
||||
if ret is None and self._state is not None:
|
||||
ret = self._state.state
|
||||
try:
|
||||
ret = float(ret)
|
||||
ret = str(ret)
|
||||
except:
|
||||
ret = None
|
||||
return ret
|
||||
|
||||
@property
|
||||
def name(self):
|
||||
n = super().name
|
||||
c = self.customize.get(CONF_NAME, {}).get(self.key)
|
||||
c = self.customize.get(CONF_NAME, {})
|
||||
if isinstance(c, dict):
|
||||
c = c.get(self.key)
|
||||
return c or n
|
||||
@@ -37,7 +37,8 @@
|
||||
"reload": "[%key:common::config_flow::data::reload%]",
|
||||
"invert": "[%key:common::config_flow::data::invert%]",
|
||||
"mqtt_inputs": "[%key:common::config_flow::data::mqtt_inputs%]",
|
||||
"nports": "[%key:common::config_flow::data::nports%]"
|
||||
"nports": "[%key:common::config_flow::data::nports%]",
|
||||
"update_all": "[%key:common::config_flow::data::update_all%]"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -21,7 +21,8 @@
|
||||
"scan_interval": "Scan interval (sec), 0 - don't update",
|
||||
"port_to_scan": "Port to poll aliveness (needed only if no sensors used)",
|
||||
"nports": "Number of ports",
|
||||
"update_all": "Update all outs when input"
|
||||
"update_all": "Update all outs when input",
|
||||
"mqtt_inputs": "Use MQTT"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
98
readme.md
98
readme.md
@@ -14,8 +14,52 @@
|
||||
большого кол-ва команд (например в сценах). Каждая следующая команда отправляется только после получения ответа о
|
||||
выполнении предыдущей.
|
||||
|
||||
## Установка
|
||||
Рекомендованный способ с поддержкой обновлений - [HACS](https://hacs.xyz/docs/installation/installation):
|
||||
|
||||
HACS - Integrations - Explore, в поиске ищем MegaD.
|
||||
|
||||
Альтернативный способ установки:
|
||||
```shell
|
||||
# из папки с конфигом
|
||||
wget -q -O - https://raw.githubusercontent.com/andvikt/mega_hacs/master/install.sh | bash -
|
||||
```
|
||||
Не забываем перезагрузить HA
|
||||
|
||||
## Настройка
|
||||
`Настройки` -> `Интеграции` -> `Добавить интеграцию` в поиске ищем mega
|
||||
|
||||
Все имеющиеся у вас порты будут настроены автоматически. Вы можете менять названия, иконки и entity_id так же из интерфейса.
|
||||
|
||||
#### Кастомизация устройств с помощью yaml:
|
||||
```yaml
|
||||
# configuration.yaml
|
||||
|
||||
mega:
|
||||
hello: # ID меги, как в UI
|
||||
7: # номер порта
|
||||
domain: switch # тип устройства (switch или light, по умолчанию для цифровых выходов используется light)
|
||||
invert: true # инвертировать или нет (по умолчанию false)
|
||||
name: Насос # имя устройства
|
||||
8:
|
||||
# исключить из сканирования
|
||||
skip: true
|
||||
33:
|
||||
# для датчиков можно кастомизировать только имя и unit_of_measurement
|
||||
# для температуры и влажность unit определяется автоматически, для остальных юнита нет
|
||||
name:
|
||||
hum: "влажность"
|
||||
temp: "температура"
|
||||
unit_of_measurement:
|
||||
hum: "%" # если датчиков несколько, то можно указывать юниты по их ключам
|
||||
temp: "°C"
|
||||
14:
|
||||
name: какой-то датчик
|
||||
unit_of_measurement: "°C" # если датчик один, то просто строчкой
|
||||
```
|
||||
|
||||
## Зависимости
|
||||
**Важно!!** Для максимальной совместимости необходимо настроить интеграцию [mqtt](https://www.home-assistant.io/integrations/mqtt/)
|
||||
Для совместимости c mqtt необходимо настроить интеграцию [mqtt](https://www.home-assistant.io/integrations/mqtt/)
|
||||
в HomeAssistant, а так же обновить ваш контроллер до последней версии, тк были важные обновления в части mqtt
|
||||
|
||||
## HTTP in
|
||||
@@ -73,50 +117,24 @@ mega:
|
||||
{% if m==2 %}1:0{% else %}d{% endif %}
|
||||
|
||||
```
|
||||
|
||||
## Установка
|
||||
Рекомендованный способ с поддержкой обновлений - [HACS](https://hacs.xyz/docs/installation/installation):
|
||||
|
||||
HACS - Integrations - Explore, в поиске ищем MegaD.
|
||||
|
||||
Альтернативный способ установки:
|
||||
## Отладка ответов
|
||||
Для отладки ответов сервера можно самим имитировать запросы контроллера, если у вас есть доступ к консоли
|
||||
HA:
|
||||
```shell
|
||||
# из папки с конфигом
|
||||
wget -q -O - https://raw.githubusercontent.com/andvikt/mega_hacs/master/install.sh | bash -
|
||||
curl -v -X GET 'http://localhost:8123/mega?pt=5&m=1'
|
||||
```
|
||||
Не забываем перезагрузить HA
|
||||
|
||||
## Настройка
|
||||
`Настройки` -> `Интеграции` -> `Добавить интеграцию` в поиске ищем mega
|
||||
|
||||
Все имеющиеся у вас порты будут настроены автоматически. Вы можете менять названия, иконки и entity_id так же из интерфейса.
|
||||
|
||||
#### Кастомизация устройств с помощью yaml:
|
||||
Если доступа нет, нужно в файл конфигурации добавить ip компьюетра, с которого вы хотите делать запросы, например:
|
||||
```yaml
|
||||
# configuration.yaml
|
||||
|
||||
mega:
|
||||
hello: # ID меги, как в UI
|
||||
7: # номер порта
|
||||
domain: switch # тип устройства (switch или light, по умолчанию для цифровых выходов используется light)
|
||||
invert: true # инвертировать или нет (по умолчанию false)
|
||||
name: Насос # имя устройства
|
||||
8:
|
||||
# исключить из сканирования
|
||||
skip: true
|
||||
33:
|
||||
# для датчиков можно кастомизировать только имя и unit_of_measurement
|
||||
# для температуры и влажность unit определяется автоматически, для остальных юнита нет
|
||||
name:
|
||||
hum: "влажность"
|
||||
temp: "температура"
|
||||
unit_of_measurement:
|
||||
hum: "%" # если датчиков несколько, то можно указывать юниты по их ключам
|
||||
temp: "°C"
|
||||
14:
|
||||
name: какой-то датчик
|
||||
unit_of_measurement: "°C" # если датчик один, то просто строчкой
|
||||
allow_hosts:
|
||||
- 192.168.1.1
|
||||
```
|
||||
И тогда можно с локальной машины делать запросы на ваш сервер HA:
|
||||
```shell
|
||||
curl -v -X GET 'http://192.168.88.1.4:8123/mega?pt=5&m=1'
|
||||
```
|
||||
В ответ будет приходить либо `d`, либо скрипт, который вы настроили
|
||||
|
||||
|
||||
## События
|
||||
`binary_sensor` срабатывает когда цифровой выход принимает значение 'ON'. `binary_sensor` имеет смысл использовать
|
||||
|
||||
Reference in New Issue
Block a user