对您的配置进行故障排除
在配置家庭助理时,您可能会遇到麻烦。必威是什么也许整合没有出现或表现奇怪。此页面将讨论一些最常见的问题。
在我们涉足常见问题之前,请确保您知道配置目录在哪里。必威是什么家庭助理将打印出启动时使用的配置目录。
每当集成或配置选项会导致警告时,它将存储在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:“门/运动”...
实体名称
实体名称中唯一有效的字符是:
- 小写字母
- 数字
- 下划线
如果您创建具有其他字符的实体,那么家庭助手可能不会为该实体产生错误。必威是什么但是,您会发现尝试使用该实体的尝试将产生错误(或可能默默失败)。