本帖最后由 Mirukuteii 于 2018-9-3 12:53 编辑
HASS初级教程:1-熟悉前端UI和配置文件
系列教程的学习前提
- 了解HASS基本情况,已经成功部署稳定可靠的HASS后台和WEB前端。
- 熟悉任意文本编辑软件,包括但不限于VSCode、Sublime、Atom、Cloud9等。
- 能够通过SSH、WinSCP、Samba等方式,接入HASS后台并查看和修改文件。
- 有学习的耐心和恒心,注重基础,注重积累,不急于求成。
一、 恭喜安装成功
不管你是通过什么样的途径,现在已经成功的安装了HASS(全文默认起点为0.77.2),并且已经可以登录到8123端口的HTTP前端,那么首先让我们来熟悉一下HASS的WEB前端。
注意:强烈推荐使用最新版的Chorme浏览器登录HASS前端。
二、 创建账号进入前端
激动地第一次登录系统,系统会提醒你创建账号,如图所示:
姓名:在HASS系统中显示出来的名字,相当于昵称,目前可包括中文和各类符号在内的UTF-8编码的字符。
用户名:登录HASS所用的id,目前可包括中文和各类符号在内的UTF-8编码的字符,推荐使用英文字符。
密码:登录HASS所用的密码,只能使用英文字符。
注意:第一个登录HASS的用户为 系统所有者 (Owner),拥有管理其他用户的权限,所以务必认真填写。
创建账户完毕后,系统将提醒你登录,如图所示:
填上刚才创建的用户名和密码,即可完成登录,进入HASS实例。
提示:图中的 Home Assistant Local 指的是HASS默认的认证模式。
三、 前端界面概况
第一次登录前端的界面大致如下图所示,请自行熟悉,不具体介绍了。
主要概况
当前用户档案
配置面板
用户管理
- 查看用户
- 新建用户
- 用户详情
通用配置
四、 开发者工具
重点了解状态和信息面板
状态
信息
五、HASS的配置文件
1. 配置文件根目录
在上面的开发者工具中,我们已经找到了配置文件根目录。
HASS的配置文件根目录 就是存放配置文件 的地方。
该目录本来由用户指定,但对于大多数新人来讲,初次安装HASS用的或许是现成的安装方法,所以或许不清楚具体路径,那么通过上面的办法即可找到。
如图所示为putty下打开的配置文件根目录,初级阶段涉及到的所有HASS的配置文件都在这个目录里面。
2. 配置文件
使用SSH、WinSCP、Samba等方法,进入到配置文件根目录 。找到configuration.yaml 文件,它就是HASS的配置文件 。请牢记该文件,我们通过配置该文件,对HASS提出要求,而HASS则根据它,来调用组件,从而实现我们的要求。掌握该文件,是掌握HASS的第一步,我们将在下面的以后的教程中具体研究如何掌握它。
3. 配置子文件
在配置文件根目录 中,除了configuration.yaml 之外,你还会看到:
如图所示为WinSCP(记得设置隐藏文件可见)下的配置文件的根目录。
automations.yaml 自动化子文件;
customize.yaml 自定义子文件;
entity_registry.yaml 实体注册子文件;
groups.yaml 群组子文件;
scripts.yaml 脚本子文件;
secrets.yaml 私密子文件;
- 其它
yaml 文件。
以上这些文件并不是必须的,而是依附于配置文件 ,并由系统自动生成的子配置文件 。它们的名称,它们的位置,它们存在的意义,都是由配置文件 决定的。子配置文件 包含了需要从配置文件 中分离出来,以便于修改和存放的配置内容。你完全可以通过修改配置文件 ,改变他们的位置、名称及意义,并添加和构建类似的文件。
本系列教程前期,只涉及对配置文件 本体的操作,而后期,在学习分离配置文件 后,将使用PKG配置文件 来管理配置,也不会使用以上这些子文件。所以,如果按照本文教程学习,这些子文件都删掉吧(除了私密子文件和实体注册子文件)。具体原因将在分离配置文件 章节中进行阐述。
4.配置文件根目录下的其它文件和文件夹
home-assistant.log 文件
HASS日志文件:由系统的logger组件生成的日志文件,每次HASS启动,该文件就会重新生成。
home-assistant_v2.db 文件
HASS数据库文件:由系统的recorder组件生成的数据库文件,主要为系统的history等组件提供支持。HASS已经默认为定期清理数据库,以后你也可以更换数据库。
packages 文件夹
HASS自动生成的PKG配置文件 目录,后面将在分离配置文件 部分讨论。
- 其它文件和文件夹,暂不进行解释。
|