Govee Smart

Управление WiFi-устройствами Govee через LAN, MQTT и Cloud API.

Текущий релиз
3.2.1
Разработчик
krobi
Лицензия
MIT

Управляет устройствами Govee Wi-Fi от ioBroker: светодиодными лентами, лампочками и панелями, термометрами, гигрометрами и мониторами качества воздуха, умными розетками, кнопками управления батареями и пультами дистанционного управления, а также бытовой техникой, такой как обогреватели, увлажнители, аромадиффузоры, чайники, льдогенераторы, вентиляторы и очистители воздуха.

Адаптер взаимодействует с вашими устройствами локально, когда это возможно . Светильник с включенным локальным API отвечает в вашей собственной сети за миллисекунды, и облако никогда не сможет перезаписать то, что устройство только что сообщило локально. Облако заполняет информацию, известную только ему — имена устройств, их возможности, сценарии и снимки — и берет на себя управление устройствами, у которых вообще нет локального API.

Что вы получаете за то, что вкладываете

Все параметры являются необязательными: если ничего не вводить, индикаторы в вашей сети будут найдены и включены локально; бесплатный ключ API Govee добавляет имена, возможности, сцены, снимки и сегменты; ваша учетная запись Govee добавляет статус в реальном времени — подробное описание каждого шага приведено на странице вики « Настройка» .

Для каждого устройства необходимо включить локальный API в приложении Govee Home (настройки устройства → Управление по локальной сети). Без него управление устройством будет осуществляться через облако — это работает, но занимает несколько секунд на команду и ограничено скоростью запросов со стороны Govee.

Настройка

  1. Установите адаптер и создайте экземпляр.
  2. Откройте настройки экземпляра. Карточка «Подключение» проведет вас по трем указанным выше уровням и покажет, что работает, а что нет, включая проверку входа в систему, которая действительно выполняет авторизацию, а не просто заполняет форму.
  3. Если Govee запрашивает код подтверждения (это происходит при подключении нового клиента), карта запрашивает его у вас. Больше ничего не требуется; адаптер запоминает данные для входа после перезагрузки, поэтому дополнительные коды не отправляются.
  4. Устройства отображаются в разделе devices.<model>-<id> — модель и последние четыре символа собственного идентификатора устройства, например. devices.h61be-525f Если два устройства одной модели заканчиваются на одинаковые четыре символа, то второму присваивается его полный идентификатор. Созданные вами группы в приложении Govee отображаются в разделе groups..

Обновление с версии 2.x

В версии 3.0.0 каждому устройству присваивается новый идентификатор объекта один раз: devices.h61be_525f становится devices.h61be-525f, с дефисом, как и в других адаптерах устройств этого разработчика. Перенос происходит автоматически при первом запуске: значения, настройки записи, комнаты, функции и псевдонимы переносятся, а история записей продолжается в старой последовательности. Скрипты и визуализации, использующие старые идентификаторы, необходимо обновить.

Сообщение о проблеме

Откройте вкладку «Эксперт» адаптера, нажмите «Диагностика» , выберите устройство и нажмите кнопку: адаптер создаст отчет, и ваш браузер сохранит его в файл. Прикрепите этот файл к задаче на GitHub — в форме поддержки устройства запрашивается именно этот файл.

Список устройств содержит информацию обо всех устройствах, доступных или недоступных — отчет необходим именно тогда, когда что-то работает некорректно. Информация о каждом устройстве. diag.lastExport В записях точки данных указывается время последнего составления отчета.

Отчет псевдонимизирован : IP-адреса, адреса электронной почты и имена устройств заменены стабильными маркерами, идентификаторы устройств сокращены, а учетные данные вообще не отображаются. Одно и то же реальное значение всегда соответствует одному и тому же маркеру внутри одного файла, поэтому отчет остается понятным, даже не содержа никакой информации о вашем доме. Все это объясняется в заголовке файла.

Отчет позволяет добавить устройство или обнаружить ошибку без необходимости доступа к вашему оборудованию. Если в нем недостаточно информации для этого, вина лежит на отчете, а не на вас — пожалуйста, укажите это в сообщении об ошибке.

Где прочитать больше

Подробная информация доступна в вики на английском и немецком языках:

  • Настройка — три уровня, локальный API, коды подтверждения, что делать, если канал остается недоступным.
  • Поведение — какой канал что обрабатывает, как определяется доступность, что происходит при отключении облачных сервисов.
  • Дерево состояний — каждая точка данных, что её записывает и что вы можете записать сами.
  • Сцены и снимки — сцены, самостоятельно созданные сцены, снимки из облака и локально сохраненные снимки.
  • Сегменты — управление сегментами, мастер обнаружения, полосы для вырезания и списки сегментов, заполняемые вручную.
  • Группы — как работают группы в приложении Govee (см. здесь).
  • Датчики и приборы — показания, события и что означают ограничения облачных сервисов.
  • Устройства — все поддерживаемые модели, сгенерированные из собственного каталога адаптера.

→ https://github.com/krobipd/ioBroker.govee-smart/wiki

Устройство отсутствует в списке?

Отправьте диагностический отчет, и модель будет добавлена. Для этого и существует отчет — каталог пополняется на основе отчетов пользователей, и нет необходимости менять владельцев оборудования.

Changelog

3.1.1 (2026-10-01)

  • Fixed: a cloud command that fails because the Govee server name cannot be resolved is sent again within 10 seconds instead of being lost after one try
  • Fixed: after a failed command the light's real state is read back right away, so its datapoint no longer stays on the wrong value — also without a Govee account
  • Fixed: calls that never reached Govee (DNS or connection errors) no longer use up the daily budget, so an appliance is not blocked for the rest of the day
  • Fixed: a group command that only some of its lights took now names the lights that did not switch and why, so a dark light no longer goes unnoticed
  • Improved: connection errors in the log are written in plain words, e.g. that the Govee server name could not be resolved and the DNS is the likely cause

3.1.0 (2026-10-01)

  • Fixed: a rejected background token refresh of the Govee account now counts toward the login protection and asks to check email/password instead of retrying silently
  • Fixed: "Test login" in the connection card counts toward the account's login limit (3 per hour) and says when the next test is possible
  • Fixed: segment colours and brightness are confirmed only after the command went out — a refused Cloud command no longer leaves them acked
  • Fixed: stopping the adapter while it is still starting really stops it — it no longer goes on to search the network or log in to your Govee account afterwards
  • Fixed: a light found on the network before the saved data loads keeps its scene speed and remembered libraries after a restart
  • Fixed: a group offers only the colour temperatures every member supports, so no member is sent a value outside its range
  • Fixed: when Govee no longer accepts the account session, scene, music and DIY libraries, snapshots and groups ask for a fresh login instead of reading as empty
  • Fixed: a Cloud rate limit or rejected API key is reported once, with the real waiting time — no longer three times or with a wrong retry hint
  • Fixed: moving a 2.x device tree to its new id no longer loses recordings or room assignments when the move fails or is interrupted
  • Fixed: a light whose scene library has not loaded yet keeps its scenes.scene_speed datapoint, value and recording — a start without saved data deleted and re-created it
  • Improved: a restart leaves the object tree untouched when nothing changed, so scripts and history that watch object changes no longer see needless updates
  • Fixed: a mode or level dropdown only takes a value the device declares — a fan speed no longer shows 50, an air purifier's level no longer 0 in Auto mode
  • Fixed: the manual device sync after a failed start shows the Cloud connected and stops the pending retry; a device it adds gets its first values without a log warning
  • Fixed: a Govee e-mail or password of spaces only counts as not entered — at start, in the sensor hint and in the connection card's test
  • Fixed: the refresh button of a light keeps its scene list across restarts and corrects a wrong segment count; devices that are not lights no longer use up Cloud calls
  • Fixed: a temperature reading carries °C whichever way it arrives — a model that declares Fahrenheit no longer flips the unit to °F (the value is always °C)
  • Fixed: a segment colour above 255 is sent as 255 — it wrapped to 0 before; a segment brightness is rounded like the light's brightness
  • Improved: a lamp that is unplugged or unreachable on your network leaves one warning in the log instead of a new warning for every command you send to it
  • Fixed: a group that is switched off or set to a colour clears its scene and music dropdowns the same way a single light already does
  • Fixed: a heater that declares no temperature unit shows none instead of an invented °F; a command delivered after the device came back shows the value that was sent
  • Fixed: an untested model without catalog corrections no longer warns to turn on the experimental switch — it works as it is; the log only asks for a diagnostics report
  • Fixed: the settings describe the experimental switch for what it does — it turns on the catalog corrections of untested models; every device appears without it
  • Improved: after you press the device sync or the refresh button, the log tells you what it found, for example which new devices were added to the object tree
  • Fixed: the connection card words every answer in the admin's language — a full login window shows the time on your own clock, and a repeated login test no longer claims a code was just requested
  • Fixed: the music mode read from Govee's state answer showed the mode at that position instead of the reported one; a mode the device never declared is no longer written
  • Fixed: the segment detection wizard no longer counts a dark segment at the end when the measurement runs all the way to the longest strip Govee supports
  • Improved: appliance modes and levels and the device type show readable names in your ioBroker language; scripts may still write the names Govee uses, such as Auto

3.0.1 (2026-09-27)

  • Improved: the note the Admin shows before an update to 3.x is short now: the warning, one example old → new and a link to the details

3.0.0 (2026-09-26)

  • Changed: every device gets a new object ID once — model and last four characters with a hyphen, e.g. devices.h61be-525f; scripts and visualizations need the new IDs
  • Changed: the move carries values, recording settings, rooms, functions and aliases along, and recorded history continues in its old series
  • Fixed: two devices of one model whose IDs end alike now get a tree each and each receives its own commands — until now they shared one
  • New: the H1741 battery table lamp reports its charge level in sensor.battery; Govee reports a fully charged battery as about 80 percent
  • Fixed: fans and heaters with a numeric level (H7102, H7130) store it as a number, and the H7121 no longer puts a warning in the log at every refresh

2.41.0 (2026-09-26)

  • Changed: Discovery follows the selected network interface only — the additional scan addresses setting is gone, and the broadcast goes to the network of the chosen card
  • Fixed: info.cloudConnected turns false while the Govee Cloud stays unreachable and true again with its next answer — until now only a rejected API key cleared it

License

MIT License

Copyright (c) 2026 krobi krobi@power-dreams.com

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.

Developed with assistance from Claude.ai