全面版&高级版智趣盒子专用说明书

占坑 :grin:
改进版草稿,请勿留言

第一章 HOME-ASSISTANT基本介绍

1.1.什么是HOME-ASSISTANT?

HomeAssistant是构建智慧空间的神器。是一个成熟完整的基于 Python 的智能家居系统,设备支持度高,支持自动化(Automation)、群组化(Group)、UI 客制化(Theme) 等等高度定制化设置。同样实现设备的 Siri 控制。基于HomeAssistant,可以方便地连接各种外部设备(智能设备、摄像头、邮件、短消息、云服务等,成熟的可连接组件有近千种),手动或按照自己的需求自动化地联动这些外部设备,构建随心所欲的智慧空间。HomeAssistant是开源的,它不属于任何商业公司,用户可以无偿使用。

1.2.为什么安装HOME-ASSISTANT?

1.2.1.支持接入多种品牌、多协议

支持接入多种品牌、多协议,前提是目标设备要有开放端口(厂家提供或者开发者通过各种途径获取)或者获得了设备相关控制命令,然后有人在这个基础上开发了对于集成插件。目前国内有对接插件的品牌主要覆盖了米家及米家生态链(绝大部分米家产品可以接);涂鸦方案设备【厂家和HOME-ASSISTANT官方开放的云端插件覆盖WIFI设备及Zigbee设备及蓝牙设备看,第三方开发者提供了WiFi设备的局域网插件】;homekit系列设备;美的智能空调;格力智能空调;科沃斯扫地机器人;等等【待补充】。可以对接多种标准协议,例如485,KNX,红外,射频等【需要对接标准协议的网关】

1.2.2.支持桥接功能

把对接入HOME-ASSISTANT的设备桥接到第三方平台,例如HOMEKIT、天猫精灵音箱、百度音箱、小爱音箱、谷歌音箱、若琪音音箱

1.2.3.支持统一管理

接入HOME-ASSISTANT的各个品牌设备或者服务可以在HOME-ASSISTANT里进行自动化联动,各种交互

1.2.4.支持个性设置

可以自定义界面,自定义用户等

1.2.5.隐私更安全

HOME-ASSISTANT服务器本身部署在家庭局域网内,只要选取的设备及相应的服务同样具备局域网协议可以打造一个用户个人掌控的私人物联网络

1.3.盒子有什么用?

1.3.1.软硬一体集成HOME-ASSISTANT系统,免去繁琐的安装流程

1.3.2.添加语音控制插件及本地应用商店

1.3.3.配套手机控制小程序,提高操作便捷性

第二章 搭建HOME-ASSISTANT服务器需要的条件及系统部署

2.1.硬件要求

  • 搭载了HOME-ASSISTANT系统的服务器(智趣盒子已集成);
  • 正常联网的路由器;
  • 手机或者电脑(调试设置盒子使用);
  • 网线(建议使用新的5类、6类或超6类);
  • 自备需要接入的智能设备,接入家庭局域网。

2.2.网络环境要求

  • 路由、盒子、手机或电脑及需要接入的智能设备需要在同一局域网(即手机或电脑、盒子、智能设备的IP需要在同一网段)

  • 如何把家庭网络设置为同一局域网,或者多个路由、交换机设备如何设置在同一个局域网,请自行百度学习:

  • 盒子只能使用网线连接路由器,不能通过WIFI链接。

2.3.盒子接入步骤

2.3.1.硬件连接

  • 先给盒子插上网线,链接到路由,然后再通电–这个顺序不能乱。盒子通电后需要等待十分钟左右,等待内置的服务全部启动,下载相关依赖。
  • 盒子一般不需要通过hdmi线连接到显示器,hdmi接口仅供硬刷固件时期使用,或者特殊情况调试。
  • 盒子、手机或者电脑、准备接入盒子控制的设备的网段要求是相同的,即系手机、盒子、电脑、需要控制的物联网设备在同一个局域网,逻辑图如下:

【注意事项】

  • 盒子的网络是定制的网口,建议使用全新网线(尽量不要用太旧的网线,否则有一定的几率不能入网);
  • 盒子是本身有WIFI硬件模块,但是为了保证网络的稳定,服务器(盒子)不建议使用用无线连接,这样会大幅度增加不稳定因素—例如信号强弱、波动延时等,所以需要用网线连接。
  • 盒子默认是不打开WIFI的链接,也不建议没有技术基础的小白去折腾无线连接。如果有特殊需要用WIFI,可自行百度armbian wifi ,网上有相关的教程。我们不对此做任何支持,强烈建议不要去折腾wifi链接盒子;
  • 关于盒子的放置,盒子可以跟路由一起放在弱电箱,如果放在弱电箱里面,注意散热,如果有条件建议和路由器一起放在开放的环境。

2.3.2.手机APP登录

2.3.2.1. APP下载

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

  • 安卓手机:直接下载附件百度云的home-assistant.apk,链接: https://pan.baidu.com/s/1hqECUgSuFqlezoJFEpe6ng 5 提取码: bg6o,下载到手机后完成安装即可发现盒子

  • 在手机上安装好app, 确保手机与盒子接入同一路由器(WIFI),直接打开app,弹出的页面就会发现盒子的ip, 记下这个ip地址(电脑端登录需要手动输入),同时在app上选择这个ip地址 ,具体如图:

【注意事项】

如不能正常显示上述界面,请重新检查盒子、路由器、及手机的ip地址是否在同一网段。

部分路由或者家庭网络防火墙会拦截盒子发出的自动发现信息,有可能导致app不能直接发现盒子的ip

如果出现这种情况,请按照后面的教程,如何使用电脑网页端登录方法,用浏览器操作。

【注意事项】

因为要预装插件,所以必须预设账号和密码。如何修改预设账号和密码,请见后面的教程。

2.3.3.电脑网页端登录

  • 浏览器要求:为了保证HOME-ASSISTANT的稳定运行,浏览器要求使用chrome浏览器查看盒子IP地址

【注意事项】

Home-Assistant对浏览器有要求,别用什么360、qq浏览器等,需要使用chrome浏览器, 点击上面链接进行下载

  • 打开chrome浏览器,找到路由器的dhcp或者路由器的设备管理界面,寻找smarthomefansbox这个设备的ip(如手机已发现盒子IP,可以直接使用该IP登陆),每个路由器品牌的dhcp管理界面进入的方法不一样,自行百度如何进入。因为工厂是没有按照盒子实际的mac标记的,盒子的底部那个mac地址请忽略,所以别通过mac去查找ip。

    【注意事项】

如果不会用浏览器进入路由后台找设备ip的,可以尝试使用以下教程,通过ip扫描工具发现设备的ip。

  • 登陆盒子:打开浏览器,输入http://盒子ip:8123,进入home-assistant管理界面,输入默认账户:smarthomefans 密码:abc123456,即可成功登陆管理界面

2.3.4.能发现ip但进入不了8123管理界面的排查方法:

  • 盒子系统容器运行查看:打开浏览器,输入http://盒子ip:3000,观察盒子系统容器运行情况



  • 如果上面的容器都是正常运行,或者没有正常启动,手动启动,变成running的状态,打开浏览器,输入http://盒子ip:8123(记得冒号必须为英文状态下的),可以成功进入home-assistant管理界面。

2.3.5.发现不了盒子IP的排查方法

  • 再次检查硬件连接是否到位,检查网线是否正常(可以更换网线重新连接尝试),过去发现极少部分使用者家里的网线会跟盒子不兼容,如果在路由器都找不到ip,那么尝试换一根其他的网线,把新的网线换上的时候,再把盒子断电,重新给盒子上电。然后根据上面的方法在homeassistant的app或者路由器后台查找;
  • 确保盒子、电脑或者手机在同一个局域网内,即手机的ip网段、盒子的ip网段、电脑浏览器的网段一致。举个例子,盒子的ip段是192.168.31.146,那么手机或者电脑的网段也是在192.168.31.xx这里面;
  • 有部分使用者会在使用过程中,发现登陆不了,遇到这种情况,进入路由器的后台检查盒子的ip是否发生了变化。 因为不同的品牌路由分配ip的机制不一样,会存在路由器不定时给盒子重新分配ip的情况。如果重新分配了ip,你通过原来的ip就会链接不上homeassistant了

【特别注意】

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

2.4.其他说明事项

第三章 HOME-ASSISTANT基础设置

3.1.HOME-ASSISTANT操作界面功能简介

概览:介入homeassistant的设备展示、控制界面;

能源:介入homeassistan的设备能耗数据统计界面;

地图:介入homeassistant的设备位置信息管理界面。

日志:介入homeassistant的设备日志管理界面–这个不要跟homeassistant系统日志或者supervisor运行日志搞混淆;

历史:介入homeassistant的设备历史记录管理界面;

file editor:homeassistant配置文件管理工具,是supervisor的addon(加载项、附件);

hacs:homeassitant的第三方社区集成或者主题、卡片收集商店;

node-red :supervisor的addon(加载项、附件),一个可以跟homeassistant对接的第三方自动化的强大工具;

zigbee2mqtt:supervisor的addon(加载项、附件),z2m硬件网关管理界面,z2m是一个第三方zigbee网关。–如果没有z2m硬件网关,这个管理界面默认不能打开。

媒体: homeassistant的媒体播放器管理界面;

文件管理:homeassistant的第三方文件管理工具,中文界面;

开发者工具:homeassistant的开发管理工具,这里可以对介入homeassistant的设备管理调试;

配置:homeassistant系统的管理配置入口,homeassistant本身的设置大部分在这里进行;

通知:homeassistant系统的相关信息通知入口;

用户名:homeassistant系统的用户管理入口;

3.2.HOME-ASSISTANT账户及密码修改

3.2.1 初始登录用户账号

  • 初始登录账号:smarthomefans,密码:abc123456,

  • 预设的账号为超级管理员,该账户由开发人员封装系统时设置。

3.2.2 登陆密码修改:

  • 系统用户设置由左边功能栏的【配置】→【人员】进入,进入可以看到一个名字“smarthomefans”,可以根据需要修改名字

  • 该名字为系统展示名字,用于区分不同用户,下方【更改密码】功能则可修改系统初始登陆密码(注意:仅修改初始登陆密码,成功修改密码后,登陆账号仍为smarthomefans,登陆密码则为新设置密码)




【注意】:

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

因为要预设插件和相应的,一定要预设用户名和密码才可以进行相关操作,并非二手机器;

登陆之后,必须第一时间修改用户密码,否则产生的不良后果责任自负。

3.2.3 完全修改登录用户及密码-重置超级管理员账户和密码

【温馨提示】

  • 该功能会清楚盒子所有的账户体系预设信息,再次登陆需要重新设置(清理了预设账户和密码之后,原来关联旧账号和密码的home-assistantcs插件商店和文件管理,这两个工具需要重新绑定新的账号,具体设置分别看后面章节)

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

【具体操作方法】

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

  • 在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 

3.3.HOME-ASSISTANT用户基本资料修改

3.3.1 用户资料修改

3.3.2 通用配置修改

3.4.HOME-ASSISTANT核心及加载项升级更新

3.4.1.homeassistant 核心及加载项(附件或者addon)介绍

3.4.2.HOME-ASSISTANt核心(home-assistant core)升级更新

【温馨提示】

为了保障安全,强烈建议升级前先备份,备份方式可参考后述内容,同时HOME-ASSISTANT的核心升级前请勾选更新备份,更新的时候尽量不要其他操作。

  • 登陆homeassistant管理前端页面

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


    【温馨提示】

  • 如果有更新,请先打开发行说明,详细阅读更新说明,看看该版本升级有没有破坏性升级。这个一定要注意!一定要注意!一定要注意!homeassistant的版本号一般为xxxx(年)xx(月)x(次数),例如2021年十二月的版本可能会是2021.12.x,一般当月首个版本更新,可能会有bug,相当于测试版,我们个人习惯一般只更新当月最后的版本,一般为 5-7,这样,月初发布的版本存在的bug可能已经被修复,这样相当于稳定版。

  • 确认该次更新是自己能掌握,点击升级按钮更新 (强烈建议勾选在更新前创建备份,备份你的homeassistant旧版本及配置,这样升级到旧的版本之后,出了问题还可以退回去)点击一次就可以,不要反复点击。

升级完成

【温馨提示】

  • 如果按照上面程序更新不了的,另有手动更新方式适用于特殊网络情况,请有需要请点击查看下面的专项教程

3.5.系统备份及还原

3.5.1. home-assistant 快照备份

【温馨提示】

  • 如果盒子不是在linux系统层面进行了破坏性的操作,无需动则刷写固件进行还原。因为homeassistant的supervisor版本是构建在docker上的,你对homeassistant的操作设置是发生在容器层面的,所以homeassistant出了问题,你可以只对homeassistant的容器层面的配置进行还原。

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

  • 备份步骤:左边栏的【配置】–》【系统】–》【备份】–》【+创建备份】
    image



  • 备份后记得要把做好快照的文件下载到自己的电脑,记得保管好这个文件。



重要的事情说三次,记得要把备份的文件从盒子下载到电脑,然后想办法保管好。记得,记得,记得!

3.5.2. home-assistant 还原

【温馨提示】

  • 假如homeassistant出了问题,排除不了问题,可以先清理homeassistant。首先进入系统的ssh(如何进入ssh,请看盒子的说明书),输入以下命令:
rm -rf * /usr/share/hassio/homeassistant
mkdir /usr/share/hassio/homeassistant
chmod 755 /usr/share/hassio/homeassistant
docker restart homeassistant
  • 输入以上命令后按键盘inter键,homeassistant会重启,大概等几分钟,homeassistant就进入初始状态。

  • homeassistant初始化之后,手动设置一下homeassistant的相关信息,随便设置信息即可。

  • 如果你之前已经做了快照,它也会留在机子里,选择具体的快照进行还原。选择还原快照的时候,记得只点击一次,然后不要重复点击,点击之后会过一小会,homeassistant管理界面断开,进入还原状态。



  • 上传盒子未保存的备份快照文件,上传之后,还原步骤同上。

3.6.查看系统日志

第四章 homeassistant管理辅助工具

4.1. 文件编辑器之一文件管理使用方法

4.2 文件管理samba工具的使用方法

4.3 系统工具webssh的使用方法

4.4 第三方集成与主题商店hacs的使用方法