Адаптер ioBroker для Somfy Tahoma. Этот проект не связан с Somfy. Изначально он основан на скрипте, взятом с https://forum.iobroker.net/post/336001 , и является форком проекта https://github.com/StrathCole/ioBroker.tahoma .
Адаптер подключается к API конечного пользователя Tahomalink и управляет устройствами. Настройка выполняется через Tahoma Box (и, скорее всего, через Connexoon).
Адаптер пока не обладает полным набором функций, но должен поддерживать большинство действий по управлению жалюзи, ставнями и т.д.
Пожалуйста, сначала ознакомьтесь с разделом часто задаваемых вопросов (FAQ) , чтобы избежать проблем.
В настоящее время протестированные устройства
В целом, этот адаптер должен поддерживать все устройства, доступ к которым можно получить через tahomalink.com , но разработчику адаптера сложно это гарантировать. В основном потому, что документация по используемому Somfy-API (по крайней мере, в открытом доступе) отсутствует, и разработчик может тестировать только те устройства Somfy, которые принадлежат ему лично или которые он может протестировать при поддержке желающих.
Данный адаптер обычно также поддерживает устройства, которыми можно управлять через tahomalink.com. К ним относятся:
| Устройство | Поддержка онлайн-API | Поддержка локального API |
|---|---|---|
| Коробка Тахома | ✓ | ✓ |
| Коннексон | ✓ | ✓ ( доказательство ) |
| Переключатель Тахома | ✓ | ✓ |
| Комплект подключения | ✓ ( доказательство ) | ✗ ( доказательство ) |
Было подтверждено, что следующие устройства Somfy совместимы с этим адаптером:
- S&SO RS100 io
- Oximo io
- Датчик солнца Sunis io
- Датчик температуры
- Датчик дыма io
- Адаптер-штекер
Конфигурация
Адаптер поддерживает следующие параметры конфигурации.
| Параметр | (Значение по умолчанию) | Описание |
|---|---|---|
| Имя пользователя | <your Tahomalink user> | Необходимо для аутентификации вашей учетной записи Tahoma. |
| Пароль | <Your Tahomalink password> | Необходимо для аутентификации вашей учетной записи Tahoma. |
| Интервал опроса | 20000 | Время (в миллисекундах), по истечении которого адаптер попытается получить новые данные от Tahomalink. |
| ПИН-код коробки Тахома | формат, аналогичный1234-5678-9012 | Только для LocalAPI Уникальный PIN-код вашей приставки Tahoma предоставлен компанией Somfy. Подробнее о том, как активировать/использовать его, можно узнать здесь. |
| Локальный IP-адрес | Необязательно. Используйте только в том случае, если вы хотите подключиться к локальному API вашего устройства Tahoma через указанный IP-адрес, вместо использования DNS-записи по умолчанию.gateway-<pin> , что вполне подойдёт для большинства установок. | |
| Используйте MDNS | false | Только для LocalAPI Если установлено значение true, будет предпринята попытка использовать mDNS для разрешения локального имени хоста вашего Tahoma-Box. Возможно, эта функция не поддерживается всеми маршрутизаторами, поэтому она отключена по умолчанию. |
| Попытки входа в систему 1 2 | 3 | Количество попыток повторного входа в систему после неудачной попытки входа. |
| Задержка между попытками входа в систему 1 2 | 30 | Время (в секундах), которое нужно подождать между попытками входа в систему. |
| Задержка после неудачной попытки входа в систему 1 2 | 120 | Время (в секундах), которое нужно подождать после того, как все последовательные попытки входа в систему завершатся неудачей. |
| Задержка перед повторной попыткой применения очереди 1 2 | 1500 | Время (в миллисекундах), которое необходимо подождать перед второй попыткой отправки изменений из внутренней очереди применения в Tahoma, на случай, если они были потеряны. |
1 Эти параметры конфигурации видны и настраиваемы только в Admin 5 (новый графический интерфейс) или более поздних версиях.
2 Все значения относятся к авторизации в Tahomalink, которая с точки зрения разработки представляет собой, по большей части, «черный ящик». Как показывает опыт, если установить слишком низкие значения, существует большая вероятность того, что Somfy временно заблокирует вашу учетную запись, поэтому снижайте значения по умолчанию с осторожностью!
Штаты
tahoma.X.location
В этом дереве штатов содержится личная информация пользователя, такая как город, адрес и координаты (долгота/широта).
tahoma.X.devices.*.deviceURL
В этом состоянии содержится URL-адрес устройства, который используется Tahoma для идентификации устройства.
tahoma.X.devices.*.commands
Эти состояния содержат команды кнопок для управления устройствами. Большинство устройств поддерживают такие команды, как...close иopen но и кое-что еще.
Некоторые из команд имеют:slow В конце, если это поддерживается устройством. Использование этих функций позволяет использовать режим низкой скорости или так называемый бесшумный режим.
tahoma.X.devices.*.states
В этих состояниях отображается текущее состояние устройств. В некоторых состояниях имеется следующее::slow В конце, если это поддерживается устройством. Настройка этих параметров включает низкую скорость или так называемый бесшумный режим.
| Состояние устройства | Редактируемый | Назначение/Описание |
|---|---|---|
| tahoma.X.devices.*.states.core:DeploymentState | ✓ | Предоставляет информацию о текущем состоянии развертывания и управляет им. 100 означает полное развертывание, 0 — отсутствие развертывания. Не все устройства имеют это значение, некоторые имеют.ClosureState вместо. |
| tahoma.X.devices.*.states.core:TargetDeploymentState | ✓ | Видетьtahoma.X.devices.*.states.core:DeploymentState Используйте это, например, для непосредственного изменения положения жалюзи. |
| tahoma.X.devices.*.states.coreClosureState | ✓ | Предоставляет информацию о текущем состоянии замыкания и управляет им. 100 означает полностью закрытое состояние, 0 — открытое. Не все устройства имеют это значение, некоторые имеют.DeploymentState вместо. |
| tahoma.X.devices.*.states.core:TargetClosureState | ✓ | Видетьtahoma.X.devices.*.states.core:ClosureState |
| tahoma.X.devices.*.states.core:OrientationState | ✓ | Предоставляет информацию об ориентации ламелей (например, для жалюзи) и управляет ею. Не все устройства предлагают эту функцию. |
| tahoma.X.devices.*.states.core:TargetOrientationState | ✓ | Видетьtahoma.X.devices.*.states.core:OrientationState |
| tahoma.X.devices.*.states.core:NameState | Содержит текущее название устройства. | |
| tahoma.X.devices.*.states.core:OpenClosedState | Содержитclosed если устройство полностью закрыто или развернуто на 0% иopen в противном случае. | |
| tahoma.X.devices.*.states.core:PriorityLockTimerState | Если датчик заблокировал устройство, это указывается здесь, например, датчик ветра блокирует навес. | |
| tahoma.X.devices.*.states.core:RSSILevelState | Текущее качество сигнала устройства. | |
| tahoma.X.devices.*.states.core:StatusState | available если устройство в настоящее время доступно. | |
| tahoma.X.devices.*.states.io:PriorityLockLevelState | Видетьtahoma.X.devices.*.states.core:PriorityLockTimerState | |
| tahoma.X.devices.*.states.io:PriorityLockOriginatorState | Видетьtahoma.X.devices.*.states.core:PriorityLockTimerState | |
| tahoma.X.devices.*.states.moving | Указывает, движется ли устройство в данный момент.0 = stopped ,1 = up/undeploy ,2 = down/deploy ,3 = unknown directionПримечание: Этот метод надёжно работает только при подключении к API Tahoma (а не к локальному API), поскольку локальный API не предоставляет достаточного количества обновлений событий-действий для корректного вычисления этого состояния. core:MovingState Однако в обоих случаях это должно сработать. |
Changelog
See Changelog.
0.11.0 (2025-04-15)
- Feature: Added option to specify IP address for access to local API (https://github.com/Excodibur/ioBroker.tahoma/issues/424)
0.10.4 (2024-04-28)
- Fixed: Warning resolved about invalid element in jsonConfig
0.10.3 (2024-01-29)
- Fixed: Some crashed caused by event-updates were fixed with a workaround.
0.10.2 (2023-03-25)
- Fixed: Improved core:MovingState. Should reflect moving blinds correctly now.
0.10.1 (2023-01-23)
- Fixed: Clear bearer token, if connection to local API fails, so new one can be fetched.
0.10.0 (2023-01-03)
- Fixed warnings about Failed getting execution state when using the local API.
License
The MIT License (MIT)
Copyright (c) 2020-2025 Marius Burkard & Excodibur
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.