图像数据

此命令接收图像数据并将其写入 VPS DRAM 缓冲区。需要时，该命令会执行解压。由于 USB 的限制，可能无法一次性发送整个图像数据。因此，必须多次调用此命令来加载整个图像。其还存储 API 未处理的任何字节（如果 API 没有执行操作所需的所有字节）。这些未处理的字节将在下次接收到数据时发送给回调函数。一旦将整个图像加载到存储器后，API 即会显示已加载的初始屏幕。加载图像的剩余像素也由回调函数返回。

此命令会将预定义的 XPR 校准图案作为闪存图像加载并显示在屏幕上。3840x2160 显示区域上重复显示 64x64 图案。

方向编号。范围 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()。

红色

绿色

蓝色

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

颜色

0 = 红色的 SSI SPI/PWM 指示符

1 = 绿色的 SSI SPI/PWM 指示符

2 = 蓝色的 SSI SPI/PWM 指示符

3 = SPI 系统的样片 1。

4 = Sample2 C2

5 = PWM 系统的 SSI SPI 黄色/红外

6 = 对于 PWM 系统，对 SPI 感应使用 SSI 青色使用 SSI 青色

7 = 对于 PWM 系统，对 SPI/频率使用 SSI 品红色

8 = 白色的 SSI SPI 指示符

9 = 黑色的 SSI SPI 指示符

10 = 红外的 SSI SPI 指示符

最大驱动电平

设置最大驱动电平

索引

选择 SSI 的占空比索引

1 - 启用校准模式

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

LED 颜色

0 = 红色

1 = 绿色

2 = 蓝色

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

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

亮度 Y 坐标

红色传感器输出

绿色传感器输出

蓝色传感器输出

占空比

格式 = u8.8

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