对您的配置进行故障排除


在配置家庭助理时,您可能会遇到麻烦。必威是什么也许整合没有出现或表现奇怪。此页面将讨论一些最常见的问题。

在我们涉足常见问题之前,请确保您知道配置目录在哪里。必威是什么家庭助理将打印出启动时使用的配置目录。

每当集成或配置选项会导致警告时,它将存储在home-assistant.log在配置目录中。此文件是在家庭助理开始时重置的。必威是什么

我的整合没有出现

当集成不显示时,可能会发生许多不同的事情。在尝试任何这些步骤之前,请确保查看home-assistant.log文件,看看是否有与您要设置的集成有关的任何错误。

如果您的配置文件中的条目不正确,则可以使用配置检查命令(下)来协助识别它们。

配置问题

家庭助理最常见的问题之一是无效的必威是什么configuration.yaml或其他配置文件。

  • 必威是什么家庭助理提供了一个CLI,可让您查看其如何解释它们,每个安装类型都有自己的共同任务中的部分:

  • 配置文件,包括configuration.yaml必须是UTF-8编码。如果您看到错误'utf-8'编解码器无法解码字节,编辑有问题的配置并将其重新保存为UTF-8。

  • 您可以使用配置的YAML结构这个在线yaml解析器或者YAML验证器

  • 要了解有关YAML怪癖的更多信息,请阅读Yaml特质由Saltstack(其中有针对Saltstack的示例,但可以很好地解释YAML问题)。

configuration.yaml不允许多个部分具有相同的名称。如果要为一个组件加载多个平台,则可以附加数字或字符串名称或使用这种风格

传感器-平台预报...-平台比特币...

另一个常见的问题是缺少所需的配置设置。如果是这种情况,集成将将其报告给home-assistant.log。你可以看看各种集成页面有关如何设置组件的说明。

看到记录器集成有关如何定义特定模块所需的记录级别的说明。

如果您发现任何错误或想扩展文档,请让我们知道

依赖性问题

几乎所有集成都有外部依赖性,可以与您的设备和服务进行通信。有时,家庭助理无法安必威是什么装必要的依赖项。如果是这种情况,它应该显示在home-assistant.log

第一步是试图重新启动家庭助理,看看问题是否持续。必威是什么如果确实如此,请查看日志以查看错误是什么。如果您无法弄清楚,请报告它因此,我们可以调查正在发生的事情。

集成问题

可能会发生一些集成不能立即工作,或者在家庭助理已经运行一段时间后停止工作。必威是什么如果这发生在您身上,请报告它这样我们就可以看看。

多个文件

如果您正在为设置使用多个文件,请确保指针是正确的,并且文件的格式是有效的。了解不同类型的不同类型很重要!包括以及如何构造每个文件的内容 - 可以找到有关将您的配置分为多个文件的各种方法的更多信息这里

!包括设备/灯传感器!包括设备/传感器

内容lights.yaml(注意它不包含光:):

-平台Hyperion主持人192.168.1.98...

内容传感器

-平台mqtt姓名房间湿度”state_topic房间/湿度”-平台mqtt姓名运动”state_topic门/运动”...
每当您报告问题时,请注意,我们是志愿者,他们无法访问世界上每个设备,也无法无限的时间来解决所有问题。

实体名称

实体名称中唯一有效的字符是:

  • 小写字母
  • 数字
  • 下划线

如果您创建具有其他字符的实体,那么家庭助手可能不会为该实体产生错误。必威是什么但是,您会发现尝试使用该实体的尝试将产生错误(或可能默默失败)。