方向编号。范围 0 - 23。

此命令用于设置激励器位置的方向编号（会存储在 EEPROM 中）。共有 24 个可能的选项 0 - 23。在使用 TI 提供的 XPR 校准启动界面图像来执行 XPR 校准时，请使用此命令。

注意：请使用显示图像尺寸命令来确保显示区域为 3840x2160。如果报告的显示分辨率小于或等于 1080p，此命令不会对显示的图像产生任何影响。

XPR 命令

0 = 固定输出启用

1 = DAC 增益

2 = 子帧延迟

3 = 激励器类型（只读）

4 = 输出启用/禁用

5 = 时钟宽度

6 = DAC 偏移

7 = 段数

8 = 段长

9 = 反转 PWM A

10 = 反转 PWM B

11 = 子帧过滤值

12 = 子帧看门狗

13 = 固定输出值

需要应用命令参数的激励器波形控制通道编号（0 或 1）

需要传递给命令的数据

此命令用于配置/设置激励器波形控制 (AWC) 块。此处，AWCx 可以是 AWC 0 或 1。字节 2-5 包含字节 0 中提到的 XPR 命令数据。字节 1 包含 AWC 通道编号，可能的值为 0 或 1。

固定输出启用：将激励器配置为固定输出模式。

字节 2：0x00 - 禁用 0x01 - 启用

字节 3-5：保留，必须设置为 0x000000

增益：设置波形发生器 DAC/PWM 增益。

字节 2：范围 0 - 255 格式 u1.7（0 至 1.9921875）

字节 3-5：保留，必须设置为 0x000000

子帧延迟：子帧延迟字节 2-5；范围 0 - 262143 且 lsb = 133.333ns

执行器类型（只读）：激励器类型

字节 2：

0x00 - 无

0x01 - Optotune（XPR-25 型号）

0x80 - TI 激励器接口 (EEPROM)

0x81 - TI 激励器接口 (MCU)

字节 3-5：保留，必须设置为 0x000000

输出启用/禁用：激励器输出启用/禁用

字节 2：0x00 - 禁用 0x01 - 启用

字节 3-5：保留，必须设置为 0x000000

注意：AWC0 和 AWC1 两者同时禁用/启用

时钟宽度：定义输出时钟的高低宽度（时钟周期将为 2*(ClkWidth+1)）

0 = 1（时钟周期为两个时钟）；lsb = 8.33ns

字节 2-5：ClkWidth

示例：ClkWidth = 0；将生成时钟 2*(0+1) *8.33 = 16.66ns

偏移：DAC/PWM 输出偏移

字节 2：范围 -128 - +127 格式 S7（-128 至 +127）

字节 3-5：保留，必须设置为 0x000000

段数：定义段数

字节 2：范围 2 - 255

字节 3-5：保留，必须设置为 0x000000

段长：定义段的大小

字节 2-3：范围 19 - 4095

字节 4-5：保留，必须设置为 0x0000

反转 PWM A：将 AWC 配置为 PWM 类型而不是 DAC 时适用

字节 2：0x00 - 无反转

0x01 - 已反转

字节 3-5：保留，必须设置为 0x000000

反转 PWM B：将 AWC 配置为 PWM 类型而不是 DAC 时适用

字节 2：0x00 - 无反转，0x01 - 已反转

字节 3-5：保留，必须设置为 0x000000

子帧过滤值：设置子帧过滤值 - 定义子帧边沿之间的最短时间。比设定值更近的边沿将被过滤掉

字节 2：0 = 禁用过滤，0 = 过滤时间将为 Val x 60us；范围：0 - 255

字节 3-5：保留，必须设置为 0x000000

子帧看门狗：定义子帧边沿之间的最长时间；如果计时器超时，则 WG 将自动输出固定输出值，并将在下一个子帧边沿恢复正常输出。

字节 2-3：0 = 禁用子帧看门狗，0 = 看门狗时间，即“时间 x 60us”；范围：范围：0 - 1023

字节 4-5：保留，必须设置为 0x0000

固定输出值：定义在选择固定输出模式时要在 DAC/PWM 上输出的值。

字节 2：要在 DAC/PWM 上输出的值；范围 - 128 至 127 字节 3-5：保留，必须设置为 0x000000

注意：若要使用子帧过滤值和子帧看门狗，必须小心设置一个比工作频率的 2 倍大 10% 左右的值。

例如，对于 4K @ 60Hz，该值可以设置为 (1/ (60*2)) *1.10*10^6 = 9166us。

边框顶部的行数。范围 0 - 4095

边框底部的行数。范围 0 - 4095

左边框的像素数。范围 0 - 4095

右边框的像素数。范围 0 - 4095

此命令用于为边框排除函数配置 DynamicBlack 边框区域的面积。边框排除函数使用户能够减少信箱区域（黑色边框）对主要明亮图像的影响（信箱区域降低了算法的整体场景亮度）。该函数还有助于算法更好地处理带有明亮字幕的图像（其中，字幕增加了整体场景的亮度）。此命令还将用于具有多个控制器的配置，以便排除任何图像重叠问题，这是其他图像处理算法所需的功能。

边框像素的权重值，0 = 0% 加权；1 = 25% 加权；2 = 50% 加权；3 = 75% 加权

0 = 加权 0%

1 = 加权 25%

2 = 加权 50%

3 = 加权 75%

可裁剪的像素数。范围 = 0 至 65535。

此命令用于返回为了让 DynamicBlack 光圈移动而在当前配置的步数。

增益值。典型值范围为 1.0 至 8.0。

格式 = u4.12

此命令用于控制 DynamicBlack 增益值。典型值范围为 1.0 至 8.0。需要启用手动模式来设置增益，因为它会覆盖每帧计算的增益值。

DB 直方图数组的起始地址。数组大小为 34。每个区间的 LSB 代表 32 个像素。每个区间在 0x0003FFFF 处饱和。

此命令用于返回 DynamicBlack(DB) 直方图数据的起始地址。直方图包含来自前一帧的场景亮度数据。DB 直方图包含的 34 个区间用于测量所示图像中的非重叠强度范围。每个区间的值等于区间强度范围内的像素数。每个像素的强度计算为该像素的红色、绿色和蓝色值的最大值。换而言之，像素强度 = MAX( R, G, B )。每个像素的格式为无符号 8.8，生成 16 位值。区间 32 和 33 是特殊区间，分别代表值恰好为零和只有小数值的像素。此函数的使用独立于光圈控制之外，可改善黑暗场景中的图像。

色度 x 坐标（以 u1.15 格式传输）

格式 = u1.15

色度 y 坐标（以 u1.15 格式传输）

格式 = u1.15

亮度 Y 坐标

获取系统当前白点的 x,y 坐标。调用此命令前应初始化 WPC 并设置校准数据。

搜索可用占空比并设置正确 LED 白点的理想占空比。使用此命令前应设置传感器校准数据。

LED 颜色

0 = 红色

1 = 绿色

2 = 蓝色

色度 x 坐标（采用 u1.15 格式）

色度 y 坐标（采用 u1.15 格式）

亮度 Y 坐标

通过此命令设置 WPC 传感器校准数据。应在调用此命令前成功完成 WPC_Init()。

红色

绿色

蓝色

返回红色、蓝色和绿色积分传感器的输出

1 - 启用校准模式

此命令用于将系统设置为旁路模式。将系统设置为旁路模式会禁用任何图像处理功能，以在输入源图像和显示图像上的像素之间建立一对一的对应关系。希望看到 XPR 子帧清晰分割。不能退出校准模式。请重新启动系统。

LED 颜色

0 = 红色

1 = 绿色

2 = 蓝色

色度 x 坐标（采用 u1.15 格式）

色度 y 坐标（采用 u1.15 格式）

亮度 Y 坐标

红色传感器输出

绿色传感器输出

蓝色传感器输出

占空比

格式 = u8.8

通过此命令设置整个 WPC 传感器校准数据结构。应在调用此命令前成功完成 WPC_Init()。