DuetG Blog

Keep It Simple, Stupid

  • 香橙派安装Home Assistant Supervised

    香橙派安装Home Assistant Supervised

    Home Assistant

    一款用于智能家居的自由开源软件，旨在成为智能家居设备的中央控制系统，专注于本地控制和隐私。通过使用Android和iOS的配套应用程序，或使用支持的虚拟助手（如Google Assistant或Amazon Alexa）通过语音命令，可以访问基于Web的用户界面。

    香橙派

    香橙派（Orange Pi）是深圳市迅龙软件有限公司旗下开源产品品牌，迅龙软件成立于2005年，是全球领先的开源硬件和开源软件服务商，致力于让极客、创客、电子爱好者享用到来自中国的优质、低价的科技产品，通过大规模的社会化协作去创建一个更加美好的信息化人类文明。

    自从买了HomePod mini，在还没收到货的时候就开始盘算着怎么让HomePod能和家里的小米设备联动起来，实现通过Siri来控制小米设备。一开始在网上找的了一种通过米家App生成Siri快捷指令从而控制小米设备的方法。仔细研究了一下，发现这个方式并不合适自己：不但需要对每一个设备的每一种操作逐一生成快捷指令并录音，更麻烦的是即便设置完成，使用的时候还需要手机和所有设备同处一个局域网下才可以。这已经和“独立通过HomePod来控制设备”这个初衷背道而驰了。细想一下，这个方案合适的人群应该是单身并且小米设备较少的用户，通过简单的添加就可以零成本实现联动。满足这样条件的可以自行搜索一下，这里就不多做介绍了。

    在Goolge以及微信上搜索“HomeKit 小米”关键字，最后发现少数派上介绍智能家居的文章实在不少，后来又在知乎上看到了篇文章，并在文章下面的评论里找到了另一篇用Android手机安装Home Assistant的指南。又在文章里找到了这篇《香橙派安装HomeAssistant-supervised》，总算是确定了使用Home Assistant Supervised作为中控的方案。

    由于Home Assistant在不断迭代更新（Core更新的速度很快），虽然当时照着上篇教程搭配少数派里的文章最终实现了联动，但体验较差，并且在使用两个月后突然就失效了。于是又做了研究，最终完美实现，促成了写这篇blog的动机。鉴于前面提到的那篇教程有些过时了，这里我就从头再写一遍吧。

    硬件要求

    • 香橙派 3 LTS + 电源（可在香橙派官网页脚给出的官方销售链接里购买）
    • 闪迪64G TF卡（感觉买64G比32G划算，实际32G也可以）
    • TF卡USB读卡器（写卡用）
    • 香橙派 3 LTS 保护壳（不一定要买散热套装，官方旗舰店的透明黑壳也是没问题的，可以加一对散热片）

    1. 为香橙派烧录 Debian 11 系统

    点击下载官方镜像，提取码：9d7v （百度云盘）

    如果可以访问Google Drive的话，也可以去英文官网给出的链接下载，不用注册且速度很好。

    根据Home Assistant Supervised官方安装指南，只能安装在Debian 11 Bullseye上 (Ubuntu也不行) 目前要求安装在Debian 12 Bookworm上，但香橙派官方只给香橙派3 LTS做了Debian 11系统，我们后面会有相应的解决方案。所以我们要下载的文件是：

    Orangepi3-lts_3.0.8_debian_bullseye_server_linux5.16.17.7z

    Windows平台上的烧录方法参见香橙派 3 LTS 用户手册中的（推荐使用balenaEtcher）

    2.4. 基于 Windows PC 将 Linux 镜像烧写到 TF 卡的方法

    点击下载官方用户手册，提取码：g4xe （百度云盘）

    2. 通过 SSH 连接香橙派

    1. Windows用户可以在Microsoft Store里安装Windows Terminal，或者使用PuTTY。
    2. 烧录好系统的TF卡插回香橙派，用网线连接路由器和香橙派，并通电启动香橙派。
    3. 在路由器中查看香橙派的IP地址。
    4. 在终端里输入
      ssh root@香橙派IP地址
      香橙派IP地址请换成实际地址
    5. 输入密码 orangepi

    3. 修改系统 CGroup 至 v1

    这是和上面那篇教程完全不同的地方，那篇并没有提及修改系统cgroup版本。之前参考着安装的时候，虽然在安装程序上会提及cgroup版本变更失败，但在使用过程中并没有弹出任何错误。不过这次重装完成后进入Home Assistant后台会立刻受到关于cgroup版本不支持的通知。所以还是在安装Home Assistant前先把系统搞好再说下一步吧。

    CGroup

    cgroups，其名称源自控制组群（英语：control groups）的简写，是Linux内核的一个功能，用来限制、控制与分离一个进程组的资源（如CPU、内存、磁盘输入输出等）。

    从 cgroup v2文档可以查到，自Debian 11 bullseye起，Debian的cgroup默认就是v2了。试着刷了一下Debian 10 buster查了查，果然还是v1。然而根据Home Assistant官网的信息，Home Assistant Supervised只能安装在cgroup v1的系统上，且只能是Debian 11 bullseye。这就意味着，无论如何都要将bullseye系统默认的v2修改成v1（我曾试过将buster升级到bullseye，cgroup妥妥自动从v1升级成了v2）。

    虽然在后续安装Home Assistant Supervised的环节，安装包会用自动脚本让cgroup从v2切回v1，但这个操作仅限于非arm版的Debian。因为普通的Debian使用的bootloader是GRUB，这个脚本也是针对GRUB设计的，并没有考虑其他bootloader。而香橙派运行的是arm版的Debian，bootloader是U-Boot。这导致安装包的自动脚本会报错，无法把cgroup切回v1，我们只能手工修改香橙派上的cgroup。

    首先在命令行运行下面命令来确定系统的cgroup版本

    stat -fc %T /sys/fs/cgroup/

    如果是cgroup v2，返回 cgroup2fs
    如果是cgroup v1，则返回 tmpfs

    接下来修改cgroup到v1：

    1. 输入 cd /boot ，进入 /boot 目录
    2. 输入 cp boot.cmd boot.cmd.bak ，备份 boot.cmd
    3. 输入 vi boot.cmd ，进入到编辑界面
    4. 无视最上面的“DO NOT EDIT THIS FILE”
    5. 找到第38行：
      if test "${docker_optimizations}" = "on"; then setenv bootargs "${bootargs} cgroup_enable=memory swapaccount=1"; fi
    6. 按 i 键键入insert编辑状态，在swapaccount=1后面加上空格并输入：
      systemd.unified_cgroup_hierarchy=0
      修改后的第38行如下：
      if test "${docker_optimizations}" = "on"; then setenv bootargs "${bootargs} cgroup_enable=memory swapaccount=1 systemd.unified_cgroup_hierarchy=0"; fi
    7. 按 esc 键退出insert编辑状态，输入 :wq 回车完成保存并退出（对 vi 操作不熟悉的可以在网上查一下教程）
    8. 在命令行输入以下指令并回车，生成新的 boot.scr
      mkimage -C none -A arm -T script -d /boot/boot.cmd /boot/boot.scr
    9. 输入 reboot ，重启香橙派

    重启完成后用SSH连接进入命令行，再次使用下方命令查看cgroup版本

    stat -fc %T /sys/fs/cgroup/

    不意外的话应该返回 tmpfs，cgroup版本修改完成。

    4. 更新系统现有软件

    输入 apt update，更新软件源
    再输入 apt full-upgrade，更新现有软件

    5. 使用以下代码安装依赖

    接下来的步骤基本上就是Home Assistant官方的安装步骤了。安装过程中会提示部分软件已经安装过了，可忽略相关提示。

    Update：2024.01.15

    感谢网友提醒，文章已随官方步骤做修改。如后续官方程序再次有变动，请以上方链接的官方步骤为准。

    apt install \
apparmor \
cifs-utils \
curl \
dbus \
jq \
libglib2.0-bin \
lsb-release \
network-manager \
nfs-common \
systemd-journal-remote \
systemd-resolved \
udisks2 \
wget -y

    6. 使用以下代码安装Docker-CE

    $ curl -fsSL https://get.docker.com -o get-docker.sh
$ sh get-docker.sh --mirror Aliyun

    7. 安装OS-Agent

    先在这里查询最新的OS Agent版本：
    https://github.com/home-assistant/os-agent/releases/latest

    接下来用 wget 命令下载我们需要的安装包，注意选择正确的架构，香橙派应当选择 aarch64，如os-agent_1.6.0_linux_aarch64.deb

    右键复制安装包的下载地址，粘贴至终端，完成下载使用命令如下：

    $ wget https://github.com/home-assistant/os-agent/releases/download/1.6.0/os-agent_1.6.0_linux_aarch64.deb

    注意将地址替换成最新的版本，完成下载后再用以下命令安装：

    $ dpkg -i os-agent_1.6.0_linux_aarch64.deb

    8. 安装Home Assistant Supervised

    之前教程里相关的其他操作目前都被集成到了新版的安装包脚本里，所以只需要下载最新的安装包就可以了。

    Update 2024.01.15
    注意：由于最新的 homeassistant-supervised.deb 要求的Debian系统已经升级到12 Bookworm了，在Debian 11上安装的过程中检查依赖会报错缺少 systemd-resolved 这个包，而这个包是Debian 12上才有的，我们需要在安装命令中使用 --ignore-depends=systemd-resolved 来忽略掉这个报错。

    命令如下：

    $ wget -O homeassistant-supervised.deb https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb
$ dpkg -i --ignore-depends=systemd-resolved homeassistant-supervised.deb

    安装过程中会看到切换cgroup版本的脚本执行失败的提示，不用管它。

    紧接着会自动进入蓝色选择机器类型的界面，注意选择机器类型 qemuarm-64

    如果选错了类型可以执行 dpkg -P homeassistant-supervised，卸载后再重新安装。

    默认的 $DATA_SHARE 文件夹位置在 /usr/share/hassio，所有Home Assistant相关的文件都在这个文件夹里。

    如果想更换位置需要在安装的时候指定，安装命令如下：

    $ DATA_SHARE=/想要指定的homeassistant文件夹位置 dpkg -i --ignore-depends=systemd-resolved homeassistant-supervised.deb

    9. 确认安装

    执行 docker ps 来查看容器的状态，一般来说需要20分钟左右会完成所有镜像的拉取和执行。如果很长时间都没有任何容器在运行，很可能是 ghcr.io 这个网址不通。需要执行 ping ghcr.io 来是否确认连通。

    如果不通需要查询 ghcr.io 的IP地址，并修改主机的 hosts 文件。具体方法请自行搜索，不再赘述。

    10. 使用Home Assistant

    浏览器地址栏输入 http://香橙派IP:8123，即可访问Home Assistant的管理后台，如果显示需要等待，就再多等一会儿。安装彻底完成后会显示注册用户的界面。关于Home Assistant的用法可以在少数派里搜到很多，这里不再多说，主要提一下Home Assistant社区市场（HACS）的安装方法，和小米设备集成的推荐。

    • HACS相当于为Home Assistant提供了更多的功能扩展，官方称之为集成，而非加载项。
      安装方法：
      1. 前往加载项商店 （第一次打开My Home Assistant页面需要配置一下，在框内输入 http://香橙派IP:8123，并保存，之后可以自动跳转）
      2. 搜索 SSH，安装社区版的 SSH & Web Terminal（如果搜索 SSH 没有任何结果，需要在你的用户资料下开启高级模式）
      3. 在 SSH & Web Terminal 的配置页面，选项一栏中找到 password: "" 一行，在引号中设置一个SSH密码（密码随便）。在网络一栏中设置一个SSH端口（数字随便）
      4. 在信息页面开启在侧边栏显示，并点击下方的启动
      5. 刷新页面后在左侧侧边栏找到 Terminal，点击并开启终端
      6. 在终端内执行 HACS 下载脚本
      wget -O - https://get.hacs.xyz | bash -
      7. 完成下载后通过添加集成，搜索HACS，跟着步骤便可完成安装和配置。
    • 关于小米设备集成主要介绍一下好用的HACS小米集成。
      之前查看少数派的文章，都在推荐”Xiaomi MIoT“这款集成，GitHub仓库地址是：
      https://github.com/ha0y/xiaomi_miot_raw
      但实际使用体验感觉一般，代码目前最后一次更新是4月10号，也有7个月没更新过了。这次重装之后尝试了”Xiaomi Miot Auto“这款，仓库地址是：
      https://github.com/al-one/hass-xiaomi-miot
      目前最后一次更新是18天前，实际用下来感觉非常不错，是目前我主力使用的小米集成。

    全文完

    Last Update: 2024.01.15

  • 人生检录处

    人生检录处

    孔子说“四十而不惑”。好像人总是要活到一个整数的年龄才能够顺利的跳进下一个阶段。当然这句话的开头是“吾十有五而志于学“，虽然不是整十的年龄，但对于一个Teenager来说，十五可能也算个神圣的数字。于是在这样一个看上去糟糕透顶的时间里，我进入到了三十几岁的最后一年。对于“四十不惑”的起跑线来说，自己算是已经在检录处点过到了。

    可能确实是只有人到了四十岁才能不再困惑吧，至少尽管现在已经开始了人生第三十九个年头几个小时了，我还是十分迷惑，甚至有些不知所措。也许我还得再等364天才行吧。

    疫情已经是第三个年头，不知道什么时候才能真正地结束，像03年那样忽然就悄无声息地过去。到目前为止我仍悲观地认为，只要不能尽快发明特效药与特效疫苗，所有人或早或晚在某个时间将会不可避免地全部被感染，无论政府采用何种抗疫方针。尽管如此，尽管我其实对自己被感染的结果早已不再恐惧，但在心底深处，我仍希望疫情能够彻底过去。全面爆发，绝大部分人感染，这样的结局能够避免发生。不是为了我自己，只是单纯地为了家人。没错，有了家人之后人的个性确实和之前不一样了。

    疫情中的这几年对很多人来说可能是停滞的几年，而对我来讲状况已经发生了很大变化。简而言之，自己终于找到了归宿成家了。这应该是我最后全家两人一起过的生日了，下一个生日的时候，也就是从检录处终于抵达起跑线的时候，就是三个人一起过生日了。这是一件值得期待的事情，让我对四十岁多了一些期待，尽管三十几岁的最后一年就像上学时母亲给的压钱包底用的十元纸币一样，让我十分地舍不得。而花时间和花钱不一样的是，尽管你再舍不得，也无法把时间存下来，早晚都会在那一天，把这最后的365天全部挥霍殆尽，然后毅然又或迷惘地带着全家跳进到自己不惑之年。而从现在起，孩子会越来越多地占据了我的人生，直至死方休。

    对于尚未出生的孩子来说，想必眼下也是他的人生检录处。不知道属于他的未来是怎样的一场比赛——田赛、径赛，又或是象棋、篮球也未可知。更重要的是，这会是一场公平的比赛吗？很快就要迎来孩子的起点了。人们总说不要输在起点，而这唯一的办法只有靠平日的训练，这训练自然是我们做父母的基本功了。可在这样一个混乱的时代，做父母的即便要多努力，也还是需要一些好运气的。

    希望一切顺利。

  • Langsam, bitte

    Langsam, bitte

    眼看天气一天天变暖，于是决定把因为太冷而停掉的锻炼的习惯再捡起来。这次不同于去年，不再是玩儿票似的随便跑跑，而是认真地启用了各种健康Apps：Zepp、Zepp Life（小米运动）、Keep、MyFitnessPal和WaterMinder等等，树立了75公斤的Flag，坚持每天运动（跑步、跳绳等），严格控制和计算卡路里摄入，以期能在两三个月后拥有一个精力充沛的肉体。

    这阵仗可能是这辈子我头次这么认真对待减肥和健康了，即便是在20多年前练田径的时候也没有过。要说到缘由，除了三个月后要面对呱呱坠地的婴儿，妻妊娠期略高的血糖也让我不得不重视起家庭的饮食结构和运动情况——厨房杀手自然是做不得，吃饱就倒对自己更无异于谋财害命：不但自己早早一命呜呼，还要把钱都送给医院。

    然而开始跑步的时候，在Keep上遇到了一个有趣的事儿，也是促使我想坐下来记录这篇文章的原因。虽说自己从小就跑步，甚至可以说曾经就是靠跑步吃饭来着，但在决定用Keep记录跑步，头次打开“跑步”这个项目时，在程序内向导的“循循善诱”下，我还是按照指导由程序给自己安排了一套长达四周的跑步计划。这有点儿像当年教练出的训练计划。我还依稀地记得郭琪教练拿着体育组里那个破旧的小夹板，在一沓卷了角的稿纸上编写着每日训练计划——那就是我那时每天下午3个小时命运的安排。于是Keep也为我往后的四周时间里安排了每天一小时左右的命运。

    只是这第一天的计划实在是有些太过简单：按配速9-10分/公里的速度跑30分钟。于是用臂包把手机绑上（有些Old School了，看了看现在年轻人都拿在手上），又把Amazfit手表的跑步状态激活，一副全副武装的模样在400米跑道上跑了起来。

    可是跑起来之后才发现，原来这并不是一件容易的事。

    （更多…）
  • Imagine

    Imagine

    希望乌克兰人民能平安无事

  • 利用Huginn监控iPad mini发售

    利用Huginn监控iPad mini发售

    阅读本文需要有一定的Huginn和IFTTT使用基础

    作为一个iPad mini 2的老用户，对今年的iPad mini说实话还是很满意的。只不过一直看好的蜂窝网络版始终显示还在报批中，这让我非常的恼火。一来不知道猴年马月能用上，再来又害怕没赶上开卖，下单又要等更久的时间。毕竟现在iPhone 13 Pro官网要等上一个月才发货，而又有传闻蜂窝网络版iPad mini 6就是因为把芯片匀给了iPhone才推迟了上市。总之众说纷纭，让我十分不爽。

    年中的时候一个偶然的事件让我深度地研究了一下Huginn的用法，又在腾讯云开了台服务器（国内的服务器真不知道还能干些啥），把Huginn以Docker的形式挂了上去。虽然后来原本计划用到Huginn的事情没能成行，但机器倒也还一直跑着。于是就决定利用Huginn来完成iPad mini发售的监控。下面简单说一说思路和具体操作。

    Huginn作为一个自动采集平台，虽然没有python来的自由，但贵在有用户界面，并且系统稳定（至少半年跑下来非常稳）。但单独使用Huginn来抓取页面很多时候是会失败的，原因在于这个需要抓取的页面是动态生成的，需要浏览器来渲染生成才可以（这是半年前我花了一两天才想明白的问题）。这次抓取苹果官方商店页面时也同样遇到这样的情况，单独使用Website Agent是获取不到页面的。这个时候还需要一个能够让页面完成渲染的服务，我这里用的是browserless。browerless也是开源软件，在服务器里多跑一个Docker容器就完事儿了。

    那么总结一下工作逻辑：
    1、使用Post Agent调用browerless的API完成页面的渲染，设置每十分钟渲染一次
    2、使用Website Agent获取渲染完成的页面并解析（如果是监控的话，找出可能变动的位置）
    3、使用Data Output Agent完成RSS输出
    //以上是在Huginn中完成
    4、使用IFTTT的rss to email Applet（这样的Applet有很多，搜一下就有了，不需要自己写）。把rss地址设置成Huginn的RSS地址，邮箱可以设置成QQ邮箱。
    //以上是在IFTTT中完成
    5、利用微信中的QQ邮箱获取提醒

    放一下Huginn每个Agent的代码

    //Post Agent
//留意browserless需要设置Token
{
  "post_url": "http://[browserless_IP]:[browserless_Port]/content?token=[browserless_Token]",
  "expected_receive_period_in_days": "1",
  "content_type": "json",
  "method": "post",
  "payload": {
    "url": "https://www.apple.com.cn/shop/buy-ipad/ipad-mini",
    "gotoOptions": {
      "timeout": "10000",
      "waitUntil": "networkidle2"
    }
  },
  "emit_events": "true",
  "no_merge": "false",
  "output_mode": "clean"
}
    //Website Agent
//抓取的是标题位置的div，因为下方会有小字说明正在等待批准，开售后小字会被移除
{
  "expected_update_period_in_days": "2",
  "data_from_event": "{{ body }}",
  "type": "html",
  "mode": "on_change",
  "extract": {
    "url": {
      "value": ".",
      "xpath": "//*[@id=\"as-standardnav\"]/div/div[2]/div[1]/a/@href"
    },
    "title": {
      "value": "normalize-space(.)",
      "xpath": "//*[@id=\"root\"]/div[2]/div[3]/div[2]/div[1]/div/div/h1"
    },
    "description": {
      "xpath": "//*[@id=\"root\"]/div[2]/div[3]/div[2]/div[1]/div",
      "value": "normalize-space(.)"
    }
  }
}

    Data Output Agent没什么特殊的设置，按照Website Agent把地址，标题和描述设置好就行了。

    最后说一下成果。今天上午突然微信收到邮件提示可以买了，鉴于每十分钟轮询一遍网页，理论上我下单的时间应该是够早的，但在网站给出的发货时间已经是4-5周了。没办法，即便如此还是要等的。（目前网站提示的已经是5周后了）看来虽然iPad mini 6不错，但似乎也没有那么抢手。所以上面这一通折腾我到底又是为了什么呢？