如果你也想试试，可以看看做好的脚本，已在 macOS 和 Debian 中测试可用，注意单步执行并检查结果：https://github.com/Yonsm/scratch-gui/blob/develop/scratch_setup.sh

由于 Scratch 3.0 插件机制还不完全成型，以上步骤中需要安装 node js，并自己运行修改的 scratch-gui 和 scratch-vm。为了孩子容易理解和易用，插件中我设定了固定的 Home Assistant 地址和长效令牌，需要自己修改（nano src/extensions/scratch3_homeassistant/index.js），运行后孩子可以直接选择设备以便执行相关操作，使用非常方便。

另外，如果孩子没有接触过 Scratch 编程，可以先用 http://code.org 做编程教育启蒙，家长和孩子均无需编程背景知识即可以入门，适合5岁+小朋友。

1. 用法

• 使用方法非常简单，只要放入 www 目录，然后使用 http://xxx.xxx.xxx:8123/local/dash.html 访问即可。

  • 如果曾经登录过 Home Assistant 并保存过登录会话，访问 /local/dash.html 时会自动复用 HA localStorage accessToken 用于 WebSocket 认证。如果没有会提示转到 Home Assistant 主页登录，请选择保存本次登录才会记录 accessToken。
  • 最佳姿势：在 configuration.yaml 中加入以下配置，可以在侧栏中直接访问：

panel_iframe:
  dash:
    title: 面板
    icon: mdi:microsoft
    url: /local/dash.html

• 指定地址：你也可以把 dash.html 放在任何位置，用浏览器打开后，在使用 dash.html?password@ws:host:8123 指定要访问的 WS API 地址，其中 password 可以是 HA Legacy Password 或者永久有效的 accessToken（在 HA 用户管理页面中创建“长期访问令牌”）。

• 分组排序：dash.html 后面可以用#指定一个 group 名称（如 dash.html#group.dash，依此仅显示此分组的设备，且按这个分组排序（优先依据类型排序，同类型的按分组先后排序）。如果不指定，默认情况下使用 group.default_view 分组；如果不想使用分组，可以使用 dash.html#NA 来显示所有设备（如果你的 HA 中为使用分组功能，即 group.default_view 不存在，也会 fallback 到显示所有设备）。

2. 个性化配置

可以在 customize.yaml 中对特定的设备进行个性化定制，目前支持以下配置：

关于 template 模式：支持以下几种示例：

• 直接输入文字如，如 我的设备
• 插入 state 宏，如 状态 ${sate}
• 插入 attributes 宏，如 温度 ${temperature}℃
• 插入其它设备的 state 宏，如 气温 ${sensor.caiyun_temperature}℃
• 插入其它设备的 attributes 宏，如 气温 ${sensor.caiyun_weather.temperature}℃
• 使用 JavaScript eval 运算，如eval:"${status}"=="Charging" ? "充电中" : "${status}"

更多个性化配置案例可以在我的 customize.yaml 中搜索 dash，以上几种用法基本上都能找到案例。

具体代码参考：https://github.com/Yonsm/HAExtra/blob/master/www/dash.html

原作者代码主页：https://github.com/xoseperez/espurna 建议看看我修改过的配置：https://github.com/Yonsm/espurna/tree/Yonsm，具体修改了什么自己对比代码吧或者看git 记录吧…

另外，我为espurna增加了攀藤 PMS5003T/PMS5003ST 传感器的支持，完全重构替换了原作者PMS5003的代码，同时增加了自动休眠支持（否则一个传感器8000个小时/一年内就达到寿命极限了）；同时添加了 Sense Air S8 CO2 传感器的支持。这些代码均已 PR 给原作者并已经合并到master主干。相关功能需自己通过编译配置来启用，或者NodeMCU可参考https://github.com/Yonsm/espurna/tree/Yonsm分支中的 nodemcu_lolin 配置。

原帖发布在：https://bbs.hassbian.com/thread-3814-1-1.html，贴中附件是我编译的部分Sonoff basic和Hassmart 86的固件，供不会编译的朋友使用。

我PR了 binary_sensor、device_tracker、CO2、light、PM2.5等传感器组件，已经包含在发布版本中了。另外 fan、media_player、vaccum 我当做switch先勉强用一下，需要的话可以参考我个人的HA版本：https://github.com/Yonsm/home-assistant/tree/Yonsm，后面会逐步支持完整的风扇、空气净化器组件，也会尝试PR到HA正式版本中。

HomeKit组件的文档在这：https://www.home-assistant.io/components/homekit/

其实配置很简单，configuration中加入一行 homekit: 可以了

树莓派，执行（装过HB的就不用这个了）：sudo apt-get install libavahi-compat-libdnssd-dev 如果是非虚拟环境安装，提示加密错误，执行：pip3 install pycryptodome

支持通用的ModBus协议的空调，包括走网络TCP的。另外新版HA里面有个modbus组件，写得实在不怎么样，也不具通用性。

1. 代码在此：

https://github.com/Yonsm/HAExtra/blob/master/custom_components/modbus2/climate.py

复制 homeassistant 的配置目录中 custom_components/climate/ 下，无此目录请创建。

2. 配置方法如下：

modbus:
  type: rtuovertcp
  host: 192.168.x.x
  port: 8899
 
climate:
  - platform: modbus2
    name: Daikin
    fan_mode: { registers: [6, 10, 14, 18] }
    fan_modes: { auto: 0, 一级: 1, 二级: 2, 三级: 3, 四级: 4, 五级: 5}
    hvac_mode: { registers: [5, 9, 13, 17] }
    hvac_modes: { 'off': 0, cool: 1, heat: 2, dry: 3, fan_only: 4 }
    hvac_off: { registers: [1, 2, 3, 4], register_type: coil }
    target_temperature: { registers: [4, 8, 12, 16] }
    temperature: { registers: [3, 6, 9, 12], register_type: input, scale: 0.1 }

上面是我自己的配置，完整的功能配置如下：

- platform: modbus2
  hub: ModBus,
  name: Daikin,
  
  fan_modes: { auto: 0, 一级: 1, 二级: 2, 三级: 3, 四级: 4, 五级: 5},
  hvac_modes: { 'off': 0, cool: 1, heat: 2, dry: 3, fan_only: 4 },
  preset_modes: { away: 0, home: 1 },
  swing_modes: { off: 0, both: 1, vertical: 2, horizontal: 3},
  aux_heat_off_value: 0,
  aux_heat_on_value: 1,
  aux_hvac_off_value: 0,
  aux_hvac_on_value: 1,

  aux_heat: { registers: [?, ?, ?] },
  fan_mode: { registers: [?, ?, ?] },
  humidity: { registers: [?, ?, ?] },
  hvac_mode: { registers: [?, ?, ?] },
  hvac_off: { registers: [?, ?, ?] },
  preset_mode: { registers: [?, ?, ?] },
  swing_mode: { registers: [?, ?, ?] },
  target_humidity: { registers: [?, ?, ?] },
  target_temperature: { registers: [?, ?, ?] },
  temperature: { registers: [?, ?, ?] },

其中 registers 是批量配置（即多个空调），当然也可以是单个的寄存，register: ?。完整的寄存器配置格式和 HomeAssistant ModBus Sensor 一致（除了我这里支持了批量 registers 之外）：

  { registers: [3, 6, 9, 12], register_type: input|holding|coil, slave:1, scale: 0.1, data_type: float|int|uint|custom, count: 1, structure: '>i'}

3. 关于RTU模块

大金、美的、日立、海信等中央空调通用的方案，ModBus RTU模块980买的，再买了个485串口转WIFI的模块200，1180搞定了。ModBus RTU模块在X宝上找了唯一个一，980买的，…。485串口转WIFI买的是“有人”的，墙裂推荐，一看就是认真做事的公司的产品。网上没有现成的方案，过程中全部自己接线、调试，差点快被难度吓到放弃了——终于搞定了，简直是不可能完成的任务…

原帖发布在：https://bbs.hassbian.com/thread-3581-1-1.html

补充：最近看到一个接线视频，虽然不是一样的方案，但接线方法可以参考。

1. 代码在此：

https://github.com/Yonsm/HAExtra/blob/master/custom_components/climate/saswell.py

复制 homeassistant 的配置目录中 custom_components/climate/ 下，无此目录请创建。

2. 配置方法如下：

climate:
  - platform: saswell
    #name: Saswell
    username: ***@email.com
    password: ********
    #scan_interval: 300

自动列出账户下实际数量的设备，默认五分钟同步一次温度和状态（是不是慢了点儿，不过地暖本来就很慢：）

3. 关于Saswell 温控面板

型号为 SAS920WHL-7W-WIFI，价格368，X东和X猫均可购买（商家跟我没关系）。我自己家公共空间换用了 WIFI 版，卧室都是用199的无 WIFI 周编程版，型号SAS920WHL-7W，每天4-6个时间点定期自动切换，也够用了。

自行更换面板很容易，我原来是沃茨 W-H4111L（意格供暖js竟然不给有周编程功能的 W-H4111P ，不然就不用这么折腾了）

原帖发布在：https://bbs.hassbian.com/thread-3387-1-1.html

天猫精灵后台配置流程，请参考这篇文章的步骤。直说能用的配置：

• 账户授权连接：https://g.yonsm.net:8122/authorize.py
• Client ID：hagenie（或者随便）
• Client Secret：ga（随便输入即可）
• Access Token URL：https://g.yonsm.net:8122/access.py
• 开发者网关地址：https://g.yonsm.net:8122/gate.py
• 设备管理跳转连接：（空）

以上配置后直接可以把天猫精灵和 HA 驳接起来了，在账户配置页面输入你的 HA UR http://xxx.xxx.xxx:8123 （注意：必须公网能访问的HA URL）和密码（关于密码的建议使用姿势参见最后）。

目前支持除 sensor 和其它设备的打开和关闭，能自动列出设备，基本零配置搞定全部事情，不需要搭建任何服务器。

二、进阶配置

天猫精灵最重要的三个参数：

1. zone：仅支持特定的区域，如客厅、餐厅等，详细看这里
2. deviceName：设备名称也只支持特定的，否则可以显示但它听不懂可能不能控制
3. deviceType：必须从这个文档中候选

在 gate.py 中会尝试自动从 HA 的配置信息中，根据一些规则尝试自动识别。但有时候可能识别不了，可以在 customize.yaml 中为设备设定天猫精灵能认出来的区域和名称：

hagenie_zone: 客厅
hagenie_deviceName: 吸顶灯
hagenie_deviceType: outlet

以上 hagenie_zone 即可以在HA device entity设备中配置，也可以HA group entity下面给组内所有设备配置。

建议：把设备分组，分组名来自这里，设备名从这里选择 ，这样剩下的事情会自动搞定，不用配置。

三、自定义服务器

注意：以上配置理把所有密码发往我的服务器，虽然我肯定谨守不存、不看、不用三不政策（老社区信用口碑网友：），如果简单测试可以这么玩玩，如果要长期用建议自己搭建服务器，所有代码在这里，持续更新完善中：

https://github.com/Yonsm/HAExtra/tree/master/hagenie

1. 服务器环境：其中三个 py 文件即可以在 apache 的 cgi-bin 下跑；也可以用 hagenie.py 作为服务器运行（需要完整的 server.pem，记住是需要 chain.pem cert.pem privkey.pem 合一，我被天猫精灵SSL检查这个坑了好久——如果看不明白，建议用前面的简单方式吧），hagenie.py可以在树莓派上跑，但响应比较慢会被天猫精灵服务器直接超时放弃，多试几次可能就好了，但控制起来了比较慢也不爽。

2. Python 需求：以上支持 python2 或 python3，自动适应；如果 HA 是 https 的需要安装 requests，否则自动使用 urllib 或 urllib2。

3. 实现细节：直接用 python 做了个伪 oauth2，并且把 oauth流程中流转的数据字段充分利用起来，用来传递 HA URL 地址和密码了…玩玩可以的，不要批评我的 “Oh … Alternative User Token Handover…to…”，哈哈

四、最佳姿势

如果你直接使用 hagenie.ga 服务器，推荐的姿势是使用密码（以便自己访问），但在天猫精灵开发者控制台中不要输入正确的密码（这样不会被 hagenie 服务器看到明文密码了），但在 configuration.yaml 中加入以下配置来信任 hagenie.ga 服务器的 IP 地址：

http:
  api_password: *****
  trusted_networks:
    - 127.0.0.1
    - 101.132.66.191
    - 192.168.1.0/24

原帖发布在：https://bbs.hassbian.com/thread-2700-1-1.html

1. 代码在此：

https://github.com/Yonsm/HAExtra/blob/master/custom_components/sensor/phicomm.py

复制 homeassistant 的配置目录中 custom_components/sensor/ 下，无此目录请创建。

2. 配置方法如下：

sensor:
  - platform: phicomm
    #name: Phicomm
    username: 139********
    password: ********
    #scan_interval: 120
    #sensors: [pm25,hcho,temperature,humidity]

自动列出账户下的多个斐讯悟空设备；启用了四个传感器类型；每60秒更新一次；每个传感器均仔细挑选了 mdi 的图标，无需额外配置。

3. 【可选】上面配置好了之后就可以了，但默认是英文名称。建议 customize.yaml 中配置中文名称如下：

sensor.aircat_temperature:
  friendly_name: 温度
sensor.aircat_humidity:
  friendly_name: 湿度
sensor.aircat_pm25:
  friendly_name: 颗粒物
  homebridge_name: 空气质量
sensor.aircat_hcho:
  friendly_name: 甲醛

4. 【可选】建议在 groups.yaml 中添加如下代码进行分组：

xxxx_room:
    entities:
      - sensor.phicomm_temperature
      - sensor.phicomm_humidity
      - sensor.phicomm_pm25
      - sensor.phicomm_hcho

原帖发布在：https://bbs.hassbian.com/thread-2698-1-1.html

1. 代码在此：

https://github.com/Yonsm/HAExtra/blob/master/custom_components/sensor/caiyun.py

复制 homeassistant 的配置目录中 custom_components/sensor/ 下，无此目录请创建。

2. 配置方法和 yr 类似，最简单的配置版本如下：

sensor:
  - platform: caiyun

以上默认启用这些传感器20分钟更新一次，自动使用 HA 中配置的地理位置。

下面是完整的配置项，每个传感器均仔细挑选了 mdi 的图标，无需额外配置：

sensor:
  - platform: caiyun
    #name: CaiYun
    #scan_interval: 1200
    #latitude: 30.000
    #longitude: 120.000
    monitored_conditions: # Optional
      - weather
      - temperature
      - humidity
      - cloud_rate
      - pressure
      - wind_direction
      - wind_speed
      - local_precipitation
      - nearest_precipitation
      - precipitation_distance
      - aqi
      - pm25
      - pm10
      - o3
      - co
      - no2
      - so2

3. 【可选】上面配置好了之后就可以了，但默认是英文名称。建议 customize.yaml 中配置中文名称如下：

group.outside:
  friendly_name: 室外
sun.sun:
  friendly_name: 日照

sensor.caiyun_weather:
  friendly_name: 天气
sensor.caiyun_temperature:
  friendly_name: 室外气温
sensor.caiyun_humidity:
  friendly_name: 室外湿度
sensor.caiyun_cloud_rate:
  friendly_name: 云量
sensor.caiyun_pressure:
  friendly_name: 气压
sensor.caiyun_wind_direction:
  friendly_name: 风向
sensor.caiyun_wind_speed:
  friendly_name: 风速
sensor.caiyun_local_precipitation:
  friendly_name: 降水强度
sensor.caiyun_nearest_precipitation:
  friendly_name: 附近降水强度
sensor.caiyun_precipitation_distance:
  friendly_name: 附近降水距离
sensor.caiyun_aqi:
  friendly_name: 空气指数
sensor.caiyun_pm25:
  friendly_name: 室外颗粒物
  homebridge_name: 空气质量
sensor.caiyun_pm10:
  friendly_name: 室外大颗粒物
sensor.caiyun_o3:
  friendly_name: 室外臭氧
sensor.caiyun_co:
  friendly_name: 室外一氧化碳
sensor.caiyun_no2:
  friendly_name: 室外二氧化氮
sensor.caiyun_so2:
  friendly_name: 室外二氧化硫

4. 【可选】建议在 groups.yaml 中添加如下代码进行分组：

outside:
    entities:
      - sun.sun
      - sensor.caiyun_weather
      - sensor.caiyun_temperature
      - sensor.caiyun_humidity
      - sensor.caiyun_cloud_rate
      - sensor.caiyun_pressure
      - sensor.caiyun_wind_direction
      - sensor.caiyun_wind_speed
      - sensor.caiyun_local_precipitation
      - sensor.caiyun_nearest_precipitation
      - sensor.caiyun_precipitation_distance
      - sensor.caiyun_aqi
      - sensor.caiyun_pm25
      - sensor.caiyun_pm10
      - sensor.caiyun_o3
      - sensor.caiyun_co
      - sensor.caiyun_no2
      - sensor.caiyun_so2

原帖发布在：https://bbs.hassbian.com/thread-2697-1-1.html

功能：

1. 批量处理指定目录、当前目录、脚本目录下的 mp4

   mkv

   mov

   avi

   wmv

   vob 文件（其它扩展名自行编辑添加）；

2. 处理指定文件名；
3. 混合同文件名名 srt/ass 字幕（自动检测 UTF 编码，默认 GB18030 编码）；

使用步骤：

1. 下载附件，解压缩；
2. （可选）修改 BestVideo.cmd 或 BestVide.sh 中的相关参数（主要是目标宽度和高度，以及其它更进一步的定制化参数修改）。
3. 把要转码的文件放在通 BestVideo.cmd 或 BestVide.sh 同一个目录；
4. （可选）如果需要硬编码字幕，确保 srt 和 ass 字幕文件和视频文件同名；
5. 双击 BestVideo.cmd （Windows）或 BestVide.sh (macOS，之前需确保 chmod +x BestVideo.sh 过)，等待转码完成；
6. 在 OUT 目录下可以找到同名视频文件。

下载

下载 macOS 版

下载 Windows 版

脚本

macOS 版（在10.12.3测试通过）

#!/bin/sh

inTypes="mp4|mkv|mov|avi|wmv|vob"
outDir=OUT

videoWidth=720
videoHeight=338
videoLevel=3.1
videoProfile=main
videoConstantRateFactor=17

audioChannel=2
audioCodec=aac
audioBitRate=225k
audioSampleRate=44.1k

audioOptions="-acodec $audioCodec -ab $audioBitRate -ar $audioSampleRate -ac $audioChannel"
videoOptions="-s ${videoWidth}x$videoHeight -vcodec libx264 -crf $videoConstantRateFactor -profile:v $videoProfile -level $videoLevel"
cropOptions1="-vf crop=in_w:in_w*$videoHeight/$videoWidth"
cropOptions2="-vf crop=in_h*$videoWidth/$videoHeight:in_h"

CDIR=$(cd "${0%/*}"; pwd)
PATH=$CDIR:$PATH
pushd $PWD >/dev/null

if [ $# = 0 ]; then
	videoPath=.
else
	videoPath="$1"
fi

MakeVideo()
{
	if [ ! -d "$outDir" ]; then mkdir "$outDir"; fi

	subtitle="${1%.*}.ass"
	if [ ! -f "$subtitle" ]; then subtitle="${1%.*}.srt"; fi
	if [ -f "$subtitle" ]; then 
		detectedCharset=`file -b --mime-encoding "$subtitle"`
		if [[ "$detectedCharset" =~ "utf" ]]; then charsetOption=; else charsetOption=":charenc=GB18030"; fi
		echo "Subtitle: $subtitle"
		echo "Charset: $detectedCharset"
		ffmpeg -i "$1" -y $audioOptions $videoOptions $cropOptions1,subtitles="$subtitle"$charsetOption "$outDir/${1%.*}.mp4" </dev/null
		if [ $? == 1 ]; then
			ffmpeg -i "$1" -y $audioOptions $videoOptions $cropOptions2,subtitles="$subtitle"$charsetOption "$outDir/${1%.*}.mp4" </dev/null
		fi
	else
		ffmpeg -i "$1" -y $audioOptions $videoOptions $cropOptions1 "$outDir/${1%.*}.mp4" </dev/null
		if [ $? == 1 ]; then
			ffmpeg -i "$1" -y $audioOptions $videoOptions $cropOptions2 "$outDir/${1%.*}.mp4" </dev/null
		fi
	fi
}

if [ -d "$videoPath" ]; then
	cd "$videoPath"
	find -E . -iregex ".*\.($inTypes)" -maxdepth 1 | while read f ; do MakeVideo "${f##*/}" ; done
	if [ ! -d "$outDir" ]; then
		cd "$CDIR"
		find -E . -iregex ".*\.($inTypes)" -maxdepth 1 | while read f ; do MakeVideo "${f##*/}" ; done
		if [ ! -d "$outDir" ]; then
			echo "Usage: $0 [FILE|DIR|] - Empty means ./ or $CDIR"
		fi
	fi
else
	if [[ "${videoPath}" =~ "/" ]]; then cd "${videoPath%/*}"; fi
	MakeVideo "${videoPath##*/}"
fi

popd >/dev/null

Windows 版（在 Windows 7 下测试通过）

@ECHO OFF

SET inTypes=*.mp4 *.mkv *.mov *.avi *.wmv *.vob
SET outDir=OUT

SET videoWidth=720
SET videoHeight=338
SET videoLevel=3.1
SET videoProfile=main
SET videoConstantRateFactor=17

SET audioChannel=2
SET audioCodec=aac
SET audioBitRate=225k
SET audioSampleRate=44.1k

SET audioOptions=-acodec %audioCodec% -ab %audioBitRate% -ar %audioSampleRate% -ac %audioChannel%
SET videoOptions=-s %videoWidth%x%videoHeight% -vcodec libx264 -crf %videoConstantRateFactor% -profile:v %videoProfile% -level %videoLevel%
SET cropOptions1=-vf crop=in_w:in_w*%videoHeight%/%videoWidth%
SET cropOptions2=-vf crop=in_h*%videoWidth%/%videoHeight%:in_h

PATH=%PATH%;%~dp0
PUSHD %CD%

IF [%1]==[] (
	SET videoPath=.
) ELSE (
	SET videoPath=%1
)

IF EXIST %videoPath%\NUL (
	CD /d %videoPath%
	FOR %%I IN (%inTypes%) DO CALL :MakeVideo "%%~nxI"
) ELSE (
	CD /d %~dp1
	CALL :MakeVideo "%~nx1"
)

POPD
EXIT /b 0

:MakeVideo
	SET subtitleOptions=
	SET subtitle=%~n1.ass
	IF NOT EXIST "%subtitle%" SET subtitle=%~n1.srt
	IF NOT EXIST "%subtitle%" GOTO :endSubtitle
		SET charsetOption=
		CALL :DetectCharset "%subtitle%"
		IF NOT ERRORLEVEL 1 SET charsetOption=:charenc=GB18030
		SET subtitleOptions=",subtitles=%subtitle%:original_size=%videoWidth%x%videoHeight%%charsetOption%"
		ECHO.
		ECHO Subtitle: %subtitle%
		ECHO Charset: %detectedCharset%
	:endSubtitle

	IF NOT EXIST %outDir% MD %outDir%
	@ECHO ON
	ffmpeg -i %1 -y %audioOptions% %videoOptions% %cropOptions1%%subtitleOptions% "%outDir%\%~n1.mp4"
	IF %ERRORLEVEL% EQU 1 ffmpeg -i %1 -y %audioOptions% %videoOptions% %cropOptions2%%subtitleOptions% "%outDir%\%~n1.mp4"
	@ECHO OFF
EXIT /b 0

:DetectCharset
	SET hexFile=%~n1.hex
	CERTUTIL -f -encodehex %1 "%hexFile%" >NUL
	FOR /f "usebackq delims=" %%E IN ("%hexFile%") DO (
		SET "firstLine=%%E" >NUL
		GOTO :endFor
	)
	:endFor
	DEL /Q /F "%hexFile%" >NUL 2>&1

	ECHO %firstLine% | FIND "ef bb bf"     >NUL && SET "detectedCharset=UTF-8"     && EXIT /b 1
	ECHO %firstLine% | FIND "ff fe 00 00"  >NUL && SET "detectedCharset=UTF-32 LE" && EXIT /b 5
	ECHO %firstLine% | FIND "ff fe"        >NUL && SET "detectedCharset=UTF-16"    && EXIT /b 2
	ECHO %firstLine% | FIND "fe ff 00"     >NUL && SET "detectedCharset=UTF-16 BE" && EXIT /b 3
	ECHO %firstLine% | FIND "00 00 fe ff"  >NUL && SET "detectedCharset=UTF-32 BE" && EXIT /b 4
	SET "detectedCharset=ASCII"
EXIT /b 0

仅记录