全面预制&高级版版智趣盒子homeassistant使用说明书

声明: 论坛除了淘宝 smarthomefans 极客屋和hasskit这两家店的智趣盒子,其他的是直接借用和搬运我们淘宝店的图。论坛所有资源是开放使用的,但是所有售后问题请联系对应购买的卖家。

正式教程在二楼开始,所有正式用户必须要通读一次,再上机操作。教程目录在本楼结尾

关注论坛抖音账号,不定期发布视频教程。

还没有购买的先看这三个视频,如果觉得很难,先别入坑 :joy:

https://www.douyin.com/video/7062218768025423141
https://www.douyin.com/video/7056729307468549384
https://www.douyin.com/video/7056637166650264863
https://www.douyin.com/video/7056635717379771685

这三个视频仅仅是例子,让你初步感觉homeassistant的使用情况,正式使用得认真看完后面的教程!!!

智能家居|HomeAssistant|问题解答_哔哩哔哩_bilibili

新手推荐看看b站KwokWai大佬的测评视频,有个初步了解,欢迎关注热心的KwokWai大佬。

https://www.bilibili.com/video/BV1xu41117YB?spm_id_from=333.999.0.0

home assistant体验版

本帖为教程贴,不要在本帖提问。请点击下面的“智趣盒子问题反馈集中帖子”提问链接

温馨提示

  1. 因为淘宝旺旺和QQ的局限性,它们不方便积累、沉淀知识、改进固件,所有与智趣盒子相关的提问麻烦您移步到在上面智趣盒子问题反馈集中帖子进行提问。“智趣盒子问题反馈集中帖子”是目前论坛唯一关于智趣盒子的相关技术反馈通道

  2. 一定要认真看帖子,包括什么用户密码啥的,都在帖子有,要认真看。如果这个教程没有,那么请您浏览一下提问帖,上面都是别人已经踩过的坑,都解决的了,你先从里面找解决方案。

  3. 本教程尽量争取做到简单易懂,因为我们不是专业做淘宝的,平常都在上班,大家水平有限,精力有限,homeassistant牵涉面广,难免有疏漏。如果教程有没涉及的地方,遇到困难您自己解决不了的,不要通宵蛮干 ,请在上面贴出的疑问贴回复补充。

  4. 这里根据大家的日常使用过程提问比较多的,总结了大部分人可能会遇到的问题,请看这里:

购买链接:

https://item.taobao.com/item.htm?id=635639747170

本快照适合的是智趣盒子,具体升级方法请看:

一个超级重要的提示:

升级前或者设置完成您自己的配置,一定要,必须要,务必要,按照帖子提供的备份方法,备份自己原系统数据,切记备份。除非你没有重要数据,可以不用备份。
备份数据之后再升级,切记!

另外一个超级重要的提示:

教程有连贯性的,建议新手要全部浏览一次,因为你的问题,答案就在下面章节。

目录

一、 安装homeassistant的手机APP,获取智趣盒子的ip地址
二、 登陆homeassistant,根据你个人的实际情况修改基础配置
三、 home assistant的升级
四、 homeassistant的基础知识
五、 homeassistant系统备份与恢复
六、 home assistant设备接入苹果的homekit相关设置
七、 home-assistant的文件编辑器File editor和samba管理工具的使用
八、 home-assistant第三方插件商店hacs的使用方法
九、 home-assistant设备接入之米家设备接入
十、 论坛提供的小爱、小度、天猫语音平台对接
十一、 UI界面设置方案初步教程
十二、 web版的ssh使用方法
十三、 home-assistant通过穿透服务远程访问
十四、 自动化工具node-red使用教程
十五、智趣盒子对接第三方zigbee设备
十六、 美的wifi智能空调接入homeassistant和homekit
十七、涂鸦wifi智能设备对接到homeassistant
十八、易微联设备对接教程

一、盒子主机入网链接设置,通过APP或者浏览器配置智趣盒子

1.盒子主机与路由器、物联网设备链接示意图

温馨提示

  • 先给盒子插上网线,链接到路由,然后再通电。通电之后需要等待十分钟左右,等待盒子内置的服务全部启动。

  • 盒子一般不需要通过hdmi线连接到显示器,hdmi接口仅供硬刷固件时期使用,或者特殊情况调试。

  • 盒子、手机或者电脑、准备接入盒子控制的设备的 网段 要求是相同的,即系手机、盒子、电脑、需要控制的物联网设备在同一个局域网

ps:如果不懂什么是同一个局域网,请百度学习。

2.网络连接注意事项:

  • 盒子的网络是定制的千兆网口,对网线的质量要求比较高,建议使用超六类新的网线(尽量不要用太旧的网线),否则有一定的几率不能入网;

  • 盒子是本身有WIFI硬件模块,但是通常惯例,服务器不建议使用用无线连接的,会大幅度增加不稳定因素—例如信号强弱、波动延时等,所以要用网线连接。

  • 所有盒子默认是不打开WIFI的链接,也不建议没有技术基础的小白去折腾无线连接。如果有特殊需要用WIFI,自行百度armbian wifi ,网上有相关的教程。我们不对此做任何支持,强烈建议不要去折腾wifi链接盒子

  • 盒子的放置。盒子可以跟路由一起放在弱电箱,如果放在弱电箱里面,注意散热。如果有条件建议放在开放的环境。

3.手机app配置智趣盒子

要注意看这个提示:如果用手机app发现不了盒子的ip,那么请继续往下看说明书,用浏览器进入盒子的管理后台去找,具体看后面内容。

  • 苹果手机:如果是ios手机,请在苹果应用商店下载搜索home assistant的app(图中第一个)

  • 安卓手机:可以直接下载附件百度云的home-assistant.apk,安装下载得到的apk文件。

    链接: https://pan.baidu.com/s/1hqECUgSuFqlezoJFEpe6ng 提取码: bg6o
    –来自百度网盘超级会员v8的分享

  • 在手机上安装好了app, 确保手机连上同一个局域网里面的wifi 。直接打开app,弹出的页面就会发现盒子的ip了, 记住这个ip地址,同时在app上选择这个ip地址 ,具体如图:

  • 要通过手机app发现智趣盒子的ip,就必须局域网里面只有一个homeassistant实体(即不能有其他机器在运行homeassistant);

  • 盒子通电之后,进入系统,所有的容器软件启动需要时间,大概十来分钟,在这期间app是无法发现ip的,请您先耐心等待。

你可能会遇到发现不了ip的问题,请按照下面的通过浏览器管理的方式操作

4.通过电脑浏览器配置智趣盒子

  • Home-Assistant对浏览器有要求,别用什么360、qq浏览器等,需要使用chrome浏览器,点击下面链接进行下载。
  • 进入浏览器,找到路由器的dhcp管理界面,寻找smarthomefansbox-super这个设备的ip,每个品牌的dhcp管理界面进入的方法不一样,自行百度如何进入因为盒子的底部那个mac地址工厂没有按照盒子实际的mac标记的,所以别通过mac去查找ip。
  • 打开浏览器,输入http://盒子ip:3000,观察盒子系统容器运行情况


  • 如果上面的容器都是正常运行,或者没有正常启动,手动启动,变成running的状态,打开浏览器,输入http://盒子ip:8123,进入home-assistant管理界面。

6. 发现不了IP特殊情况排查方法:

  • 我们在过去发现极少部分使用者家里的网线会跟盒子不兼容,如果在路由器都找不到ip,那么尝试换一根其他的网线。把新的网线换上的时候,再把盒子断电,重新给盒子上电。然后根据上面的方法在homeassistant的app或者路由器后台查找;

  • 因为盒子都是技术手动安装和测试之后才发出的,所以99%的情况都是网线或者路由器的兼容性问题,通过更换网线或者路由器的网口,盒子和路由都断电重启之后,基本都能发现盒子的ip;

  • 确保盒子、电脑或者手机在同一个局域网内,即手机的ip网段、盒子的ip网段、电脑浏览器的网段一致。举个例子,盒子的ip段是192.168.31.146,那么手机或者电脑的网段也是在192.168.31.xx这里面;

  • 有部分使用者会在使用过程中,发现登陆不了,遇到这种情况,进入路由器的后台检查盒子的ip是否发生了变化。 因为不同的品牌路由分配ip的机制不一样,会存在路由器不定时给盒子重新分配ip的情况。如果重新分配了ip,你通过原来的ip就会链接不上homeassistant了。

请注意了,一定要操作的:

为了避免出现这种情况,第一次查找到盒子的ip之后,请您务必在路由器管理后台把盒子的ip固定(分配静态ip)。具体方式,请百度你的路由品牌是如何固定设备ip的方法

二、homeassistant个人基础配置

如果是直接用电脑浏览器操作的,请您用chrome浏览器或者edge浏览器,别用什么360、qq浏览器等,360这些浏览器可能不能正常登陆,并且注意要下载64位的浏览器,别用32位的浏览器,可能会出现打不开某些插件的情况。

  1. 手机app直接登陆,或者通过电脑浏览器输入ip:8123登陆,电脑浏览器登陆情况如下:


    如果是电脑浏览器登陆的,必须要注意的是:ip地址后面加上:8123,记得冒号必须为英文状态下的。
    例如刚刚我们找到的ip是192.168.31.178,那么我们的登陆管理地址应为:http://192.168.31.178:8123

  2. 默认的用户名和密码
    用户名: smarthomefans
    密码: abc123456


    值得注意的是:

  • 这个是homeassistant的用户名和密码,不要把它跟系统的ssh或者samba共享文件夹的用户名和密码搞错了**

  • 因为要预设插件和相应的,一定要预设用户名和密码,不是什么别人用过了的机器

  1. 登陆之后,修改homeassistant的基本配置信息,用户密码必须第一时间进行修改,否则产生的不良后果责任自负。
  • 修改smarthomefans管理账号的密码

第一种方法是:你改了名称之后,是修改了显示的名称,实际的登陆的用户名并没有改变,你还得用smarthomefans这个用户名和新的密码登陆。



第二种方法是彻底homeassistant修改用户名和密码
shi

温馨提示:

这里要用到webssh这个工具,如何使用,请看后面webssh这章节。

  • 打开浏览器,输入盒子的ip或者ip:5032,登陆到盒子的ssh,登陆账号是root,ssh的密码淘宝找客服索取;

  • 输入一下,在root@smarthomefansbox#的后面复制黏贴命令:

rm -rf /usr/share/hassio/homeassistant/.storage 
mkdir /usr/share/hassio/homeassistant/.storage 
chmod +x /usr/share/hassio/homeassistant/.storage 
docker restart homeassistant 

输完上面命令之后记在键盘上按回车键,等一小会,系统才会重启!!!

注意:清理了预设账户和密码之后,原来关联旧账号和密码的hacs插件商店和文件管理,这两个工具需要重新绑定新的账号,具体设置分别看后面章节。

  1. 修改用户资料





2022.5.0以后的版本入口在:配置–区域与地点–区域注册表


请根据自己的版本找到入口,修改实际的区域。


如果:
1. 遇到了忘记homeassistant用户名和密码的情况

请按照下面的方式情况解决。让你homeassistant恢复初始设置用户名和密码状态。**

三、home assistant的升级

注意supervisor入口的变化:

homeassistant core 在2021.12.0以前版本,入口在左侧工具栏supervisor这里。

homeassistant core 在2021.12.0-2022.4.7版本,入口改在配置-- 加载项、备份、supervisor这里。




**homeassistant core 在2022.5.0版本,入口之后,supervisor的功能拆分放在了:

注意:homeassistant的服务器在海外,所以要先按照这个教程,把你浏览器和盒子的环境设置好。(盒子设置这一块,20211015之后的版本默认设置好了盒子的环境,不要再自己设置)

设置好了浏览器网络和盒子的github环境,根据下面教程进一步操作。

1.登陆homeassistant管理前端页面。

2.点击左下角配置进入配置管理界面,看看配置页面顶部,看看是否有相关的升级信息。


注意:如果有更新,请先打开发行说明,详细阅读更新说明,看看该版本升级有没有破坏性升级。
这个一定要注意!一定要注意!一定要注意!

温馨提示:

homeassistant的版本号一般为xxxx(年)xx(月)x(次数),例如2021年十二月的版本可能会是2021.12.x,一般当月首个版本更新,可能会有bug,相当于测试版,我们个人习惯一般只更新当月最后的版本,一般为5-7,这样,月初发布的版本存在的bug可能已经被修复,这样相当于稳定版。



3. 确认该次更新是自己能掌握,点击升级按钮更新,点击一次就可以,不要反复点击。

注意:记得一定要默认勾选更新前创建备份这个选项。这表示,会备份你的homeassistant旧版本及配置,这样升级到旧的版本之后,出了问题还可以退回去。

注意:因为每家网络时间不同,所以要从国外服务器拉镜像回来的时间也不一样。所以要耐心等。

  1. 升级完成

  2. 手动更新:

这种情况是适用于你家网络没有出国学习工具的情况下,相关节点被墙,需要手动更新。

另外,在supervisor里面,你会看到这样的提示


这个表示我们的盒子安装不是安装官方的hassos的安装方法,我们开放了底层linux的root权限–国内要用到很多东西,需要用到底层root权限,都会这样提示。这个不是什么错误,不影响整个系统使用。

四、home assistant的基本知识

1. lovelace的基本操作









2. home assistant的配置概况

注意:建议新手都点开探索一下里面的详细功能。

3. home assistant 对接设备或服务









4. 如何查看系统日志,排除错误

2022.5.0之后版本入口






2022.5.0之前的入口




五、homeassistant系统备份与恢复

必须注意:系统的配置设置好后或者自己的配置都稳定运行了之后,第一时间必须做个备份。而且要养成备份快照的好习惯

注意:homeassistant core 在2021.12.0版本之后,入口改在配置-- 附加组件备份supervisor这里了。

homeassistant supervisor的快照备份与还原,请点击查看这个最新教程:

六、home assistant设备接入苹果的homekit相关设置

home assistant设备接入苹果的homekit相关设置

  1. 说明:home assistant平台提供的 HomeKit Bridge 集成可以将homeassistant的相关设备接入苹果的Homekit里面,以便从 Apple 的 Home 应用程序和 Siri 进行控制。为了更好的接入,请确保您已仔细阅读下面列出的注意事项
  2. 具体操作步骤











  3. 注意事项:
    a. 默认自带或者创建的第一个homekit桥接是会把所有的设备都接入homekit的,如果有某些设备没有自动接入,那是存在两种可能,一种是你设备太多了,超过百个左右,需要新的桥接。homekit桥接是可以创建多个的,你可以根据自己的需求创建。
    b.另外一种可能是某些设备类型不能自动接入,所以可以根据下面的方法,手动接入指定的设备。









    c.还有一种可能,要查一下,看看自己的相关设备类型或者设备有没有被勾选



七、home-assistant的文件管理器File editor和samba的使用

第一部分:File editor的使用方法

1.file editor工具可以对home-assistant的配置文件进行编辑和管理。


2. 点击file editor可以对整个配置文件夹的文件进行管理。

如果你遇到:

  1. FILE EDITORER不能启动。addon的日志是空的,没有任何东西。
    可能是你盒子启动的时候,载入文件的过程中,addon需要的依赖文件被墙了,没下载完整,所以重新安装这个addon即可。解决方案在此:


2. 如果遇到这种情况,表示file editor浏览器兼容性问题,换到chrome浏览器就可以了。

**第二部分:homeassistant配置工具samba的使用

1. 修改samba用户名和密码,修改用户名不能用汉字,必须小写字母,密码也是一样。



2. 在电脑的文件管理器在输入法为英文状态下,输入\ \ip,ip为盒子的IP地址,两个\之间没有空格。输入上面设置好的samba对应的用户名和密码即可以进入配置文件库。注意是文件浏览器,不是网页浏览器

3. 可以通过这个文件管理器对home-assistant的文件进行添加、删除、修改等操作。


4. 涉及对yaml配置文件操作,可以通过这个教程的专用编辑工具使用。

记得,千万别用win系统自带的记事本编辑。
另外,要编辑yaml的文件最好在homeassistant管理后台,我内置的file editor编辑。

八、 home-assistant第三方插件商店hacs的使用方法

如果不能访问或者不能下载的,一定要看这个,手动下载解决方案在此:

hacs商店出现下面这种情况,并不是什么错误,是因为hacs没有自己的服务器,用的是github免费的服务器,如果访问人数过多,会随机限制一些访问,主要耐心等,或者过一两个小时重启homeassistant,就可以了。


image

另外,hacs预设的时候,绑定的是论坛开发者的github账号。太多人用可能会限流,所以建议重新绑定自己的github账号。

如果要重新绑定自己的github账号,具体方法如下:

  1. 进入配置,找到设备与服务,在里面把我预设的hacs集成删掉,然后重启homeassistant core,一定要重启homeassistant core,否则重新添加不了。




    image

  2. 根据教程把自己浏览器设置成github能顺利访问,然后注册github账号



设置好github的访问环境之后,进入下面的网址,注册自己的账号。

https://github.com/
  1. 进入配置,设备与服务栏目,重新添加hacs集成







  2. 进入hacs商店查看运行状态

hacs应用商店使用指引

  1. 认识hacs社区应用商店


  2. 下载自定义主题,美化home-assistant页面

  1. 安装第三方自定义插件

保存之后再到对应的插件或者主题仓库查找

如果hacs出现限流又要下载插件,请看这个手动下载插件的教程

如果hacs没有限流,然后又下载不了插件,请用这个方案:

老版本的手动启动hacs商店的方案,2021.11.x之后购买的智趣盒子都不用这种方案了。

收到智趣盒子,第一次进入hasc的时候,你的hasc有可能显示这样的状态,它并不是出错,而是系统安装的时候,是用我的github账号申请的token,所以,你要按照下面的步骤操作,更换自己的token。

更改个人的token

  1. 如果个人申请不了,请论坛私信给我,注明需要hacs的github的token,我发给你。
  2. 建议个人申请github的token,具体方案如下:

如果按照上面改token的方式,出现这种token被禁用的情况,请参考下面的解决方案

出现下面这两种情况,并不是什么错误,是因为hacs没有自己的服务器,用的是github免费的服务器,如果访问人数过多,会随机限制一些访问,主要耐心等,或者过一两个小时重启homeassistant,就可以了。
image
image

1赞

九、home-assistant设备接入之米家设备接入

首先米家系列的wifi的推荐这种方式,绑定米家账号和密码,直接对接:

其实特别的接入,比如蓝牙mesh,zigbee单独接入的接入方法,请详细阅读此教程:

有任何疑问请在教程提供的专用帖子提问。

推荐使用两位大神的米家设备接入方案,不懂得请加入群。


密码是al-one

密码是ha0y

1赞

十、论坛提供的小爱、小度、天猫语音平台对接。

有使用疑问,请加入qq群提问。

1赞

十一、UI界面设置方案初步教程

b站搜lovelace一堆教程,看多几次就会了。

1赞

十二、web版的ssh使用方法

机子集成了网页版的ssh,方便需要用到ssh的时候操作

  1. 进入方法:
  • 20211219之前的购买的版本:在浏览器直接输入盒子ip,这个需要输入管理用户名和密码。
    webssh管理界面的用户名为:smarthomefans,密码:abc123456

  • 20211219之前的购买的版本:在浏览器直接输入盒子ip:5032,免登陆,直接进入webssh管理界面。
  • 进入webssh管理界面后,再登陆系统的ssh,需要root的用户名和密码。具体的信息请联系淘宝客服。

2.进入ssh,就可以输入相应代码操作

  1. 修改网页版的ssh管理用户名和密码方法如下:

  2. 修改盒子的root用户密码方法如下:
    输入代码:passwd root


密码记得一定要修改,要不有安全风险,责任自己负责。

如果webss不能用:

  1. win的用户请用putty,同样的效果。
    ssh工具putty的使用方法

  2. mac用户,使用终端。

十三、home-assistant通过远程服务访问

现在提供两种穿透服务教程,推荐homeassistant 快速穿透ddnsto服务教程这种方式,点击下面链接进去看具体服务。

论坛提供的molo,因为政策原因,在中国大陆相关资质太难取得了,论坛的财力有限,在国内取不了认证,服务器放在海外,还要登陆github访问,速度不如上面的ddnsto。所以推荐大家用ddnsto。
###########################################################################
为了安全性,现在需要手动内置molo插件并启动它。
1.请根据一下教程操作下载插件,然后设置:


或者使用附件最新的版本molohub.zip (47.5 KB)
把附件解压,通过samba把molohub这个文件夹复制到/config/custom_components里面


  1. 把附件的molohub.yaml的配置文件通过samba上传到/config/packages
    molohub.yaml (28 字节)

    复制进去之后重新启动homeassistant core。
    3.启动hom-eassistant之后,点击通知




  2. 弹出上面最后一个图示界面,进入hom-eassistant,如果有图示界面,则表示已经把home-assistant和molohub绑定了。

  3. 如何远程使用molohub远程工具

2021.6.0ha版本改了标准,molo要加个版本号,如果出现molo报错没有版本号信息,请看这个上传更新版本号教程

2赞

十四、 自动化工具 node-red的使用教程

视频的看看这个:

图文的看这个:

问题解决–重新安装node-red,解决node-red存在时差问题。

如果是智趣盒子在supervisor的addon安装的node-red,如果时间跟现实时间不对,请通过以下方式解决:通过卸载node-red,并重新安装nodered。实际这也是node-red的安装过程,特别是密码设置部分要注意,不按照图示,是启动不了的。








如果上述方法还不行,可能homeassistant的时区没有修正,则用下面的方法试试:

https://bbs.hassbian.com/thread-12127-1-1.html

另外直接在浏览器登陆nodered,用户名和密码不是在addon设置的那堆用户名和密码,二是homeassistant的登陆用户名和密码

十六、 美的wifi智能空调接入homeassistant和homekit

十七、涂鸦wifi设备对接教程

请移步看看这个教程

十八、易微联设备对接教程