此演示的 Web GUI 可在 https://dev.ti.com/gallery/info/PositionSensing/TMAG5x73_LiquidLevelDemo/ 上找到。您必须在 dev.ti.com 上登录您的帐户，才能访问 GUI。点击任意位置的空白即可启动 GUI。通过点击下载按钮并选择相应的下载项，可以下载演示以供离线使用。

打开 GUI 并将 TI-SCB 与 TMAG5273 A1 连接。导航至“Registers”页面并设置以下项目：

• （可选）将 DEVICE_CONFIG_1→CONV_AVG 设置为“101b= 32x Average ...”
• 将 SENSOR_CONFIG_1→MAG_CH_EN 设置为“0011b = X, Y Channel Enabled”
• 将 SENSOR_CONFIG_2→ANGLE_EN 设置为“01b = X 1st - Y 2nd”角度计算
• 确认 A1 EVM/器件版本的 SENSOR_CONFIG_2→X_Y_RANGE 为 ±40mT。

然后，在寄存器映射页面顶部，将 Auto Read 设置为 As fast as possible。

图 3-10 GUI 概述

接下来，导航到“Plots”页面。“Liquid Level Demo”选项卡将打开，如图 3-10 所示。

窗口上第一个图下方显示了 Calculated Angle 和 Device Angle。Device Angle 是 TMAG5273 器件本身报告的角度，以 0.25° 为增量。Calculated Angle 是根据所选两个轴的磁场强度计算得出的角度，演示中的磁体方向为 X 和 Y。

GUI 值最初是为我们使用 4"×4"×4" 亚克力立方体的演示设置配置的。3D 打印零件位于水箱边缘上，磁体和传感器距离水箱底部 39.0mm。浮臂的半径为 62.8mm。对于粘附到浮臂上的磁体，TMAG5273 读取的真实角度为 120°，当水箱中的水从 0% 到 100% 时角度改变 66 度（到 54°）。所有这些参数都可以根据终端系统进行调整，以适应任何尺寸的水箱或浮臂半径。图 3-11 中显示了这些参数。这些参数用于计算浮子上升时水箱充满的百分比。它计算浮臂随液位上升而呈圆弧运动时的垂直距离变化。

图 3-11 GUI 预设可配置参数

GUI 包含配置控制，用于控制应用到数据的卡尔曼滤波器的 R 和 Q 值。这实际上是一个移动平均法，有助于将水箱中的液体溅射问题纳入考虑范围。默认情况下，R 的值为 0.01，Q 的值为 10，但可以根据每个应用的设计调整这些值。底部有一个拨动开关可以完全禁用卡尔曼滤波器。

当水箱中没有水时，点击 ZERO LEVEL 按钮以设置浮臂的零位置。不同应用中浮臂的零位置可能会有所不同，具体取决于磁体的安装方式以及系统处于空液位时磁体的位置。

这两张图都显示了为容器添加或排出液体时的液位。这两个图表显示相同的数据，但右侧基于温度计的图表更新速度稍快，并且具有较大的填充百分比读数。如果导航到“Plots”选项卡，GUI 也可以像标准 TMAG5273 EVM GUI 一样工作。