【HomeKit】HAT User Manual教程

前言：这篇文章是对于苹果协议文件《HomeKit Accessory Tester (HAT)
User Manual》的学习，即 HomeKit配件测试仪(HAT) 用户手册，该版本是第11次修订

第一章

概述

本文档介绍了Apple HomeKit配件测试仪(HAT)的配置和使用方法。HAT是一个Mac应用程序，它充当多个HomeKit附件协议(HAP)客户端，用于开发、调试和测试附件功能。

1.1设备清单

HAT要求Mac能够运行macOS 10.14 (Mojave)或更高版本，具有Wi-Fi连接并能够通过BLE进行通信。运行HAT不需要额外的硬件。

1.2应用方式

HAT应用程序有两个主要模式:Manual Mode和Certification Assistant模式。应用程序目前只包含手动模式。

1.3事件跟踪

HAT的事件跟踪窗口表示在使用配件期间发生的事件流。这包括高级描述，如“开始发现”，但扩展到包括解密的HTTP和BLE有效负载。

HAT将还捕获使用HAP的每个网络接口上的低级数据包。然后可以进行事件跟踪通过 File > Save保存菜单项或按Command-S。

以下HTTP有效负载类型具有额外的显示属性

• JSON有效负载
• TLV8有效载荷
• 配对列表

每个事件都包含一组详细信息，可以在主跟踪视图中通过双击事件，或单击工具栏中的“详细信息”。您也可以将这些详细信息复制到粘贴板上，从而生成文本的格式与显示的格式类似。

事件跟踪包括一个筛选器，它将显示的内容限制为包含所提供的潜台词的事件。

图1.1:事件跟踪-基本视图

通过按住“option”或打开Preferences中的设置，所选行的时间戳增量将显示相对于其他的。

图1.2:事件跟踪-时间戳增量

在流量视图中双击一个事件，详细信息视图将在窗口的右侧弹出选项卡查看其他详细信息。

图1.3:事件跟踪-详细信息视图

1.4手动模式

HAT的手动模式用于开发和调试附件。它允许附件开发人员以一种比实际面向公众的客户端更低级的方式发起客户端操作。

1.4.1打开Trace

“手动模式”窗口将跟踪打开时发生的所有事件。该跟踪可以通过手动模式窗口右下角的“跟踪”按钮打开。事件跟踪章节详细描述了该窗口显示的内容。跟踪记录所有事件，低级网络数据。这个跟踪视图还将在未来的版本中包含错误信息。跟踪可以保存到您的计算机上，并在以后需要时重新打开。

图1.4:手动模式-跟踪按钮

1.4.2创建虚拟设备

启动应用程序后，您应该看到手动模式窗口。通过该窗口，您可以创建和管理IP和BLE客户端，它们充当虚拟的iOS设备。默认情况下，将为您创建一个IP和BLE设备。如果您选择删除它们，您可能必须使用窗口左下角的“+”按钮手动重新创建它们。在模拟钥匙链共享时，一次用多个虚拟客户端测试您的配件可能是有益的

图1.5:手动模式-初始窗口

1.4.3设备设置

一旦您创建了一个设备，您将看到一个屏幕来配置其初始属性。您可以选择使用设备自己的密钥存储，或者，如果您创建了多个设备，您可以共享另一个设备的密钥存储来模拟iCloud密钥链共享。显式选择密钥存储是可选的。一旦设备被使用，按钮的选择将被应用，此时其他设备可能会共享该密钥存储。
图1.6:手动模式-初始IP设备设置

图1.7:手动模式-初始BLE设备设置

1.4.4发现配件

开始发现后，您的bonjourn -enabled或BLE配件将显示在设备下。选择访问键将显示更详细的信息。

图1.8:手动模式- IP附件摘要

图1.9:手动模式- BLE配件摘要

1.4.5配对

看到设备后，就可以开始配对了。在配对过程中，系统会提示您输入配件的密码。HAT还提供了禁用会话安全性、禁用加密和使配对成为可选的功能。

在配件上实现配对之前，这个特性可能有利于开发更高级的应用程序功能。

注意
禁用会话安全性的功能仅用于开发和调试目的，附件不能附带在没有会话安全性的情况下运行的功能

图1.10:手动模式-配对和会话安全

1.4.6配件/服务发现

配对后，您可以通过单击附件服务器摘要框中“访问系列”旁边的“发现”按钮启动服务发现。这样做将发现附件服务器提供的所有附件，并允许您访问所有包含的特征。

图1.11:手动模式-发现

1.4.7读写特性

在查看特性时，您可以读取其值，也可以向其写入各种类型的值。

图1.12:手动模式-读/写特性

第二章

修订历史

日期	rev	备注
7/8/19	11	移除隧道部分。删除了关于归档bug和已知的问题，这些信息可以在README中找到
5/3/16	10	新的bug归档模板
4/5/16	9	HAT 3.2的隧道设置
1/7/16	8	在HAT 3.0中支持HAP规范R6
4/17/15	7	添加了验证配对列表的规则，并更新了BLE功能，在HAT 1.0中添加和移除控制器
1/30/15	6	更新了HTTP验证，并增加了用于写入的UI增强HAT 1.0 Beta 6中的自定义特性
1/16/15	5	支持自定义服务和特性添加到HAT 1.0Beta 4
11/7/14	4	更新HAT 1.0 Beta 4的图像和注释
7/30/14	3	与HAT 1.0 Beta 3相关的IP和BLE验证规则
6/23/14	2	BLE支持与HAT 1.0 Beta 2a相关
4/7/14	1	HAT 1.0 Beta 1的快速入门指南