> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 自动切换线性与 SHDR 模式

> 在 QCS6490 平台上实现线性（Linear）与 SHDR v2 管线之间的无缝运行时切换。

QCS6490
稳定

> [card] vhdr=3
>
> 激活标志

> [card] Linear ↔ SHDR
>
> 无缝切换

> [card] 预初始化
>
> 低延迟

> [!NOTE]
>
> **平台适用范围：**\\
>
> 此功能仅适用于 **QCS6490**。

> [!NOTE]
>
> **SHDR OpenCL 前提条件：**\\
>
> SHDR 用例需要为 cam-server 激活 Adreno OpenCL。\\
>
> 在运行任何 SHDR 用例之前，请确保已完成
> [流式传输摄像头 - 前提条件](https://dragonwingdocs.qualcomm.com/zh/Technologies/Camera/stream-cameras.md#前提条件)中所述的**前提条件第 3 步（为 cam-server 激活 Adreno OpenCL）**。

***

## 01 · 它是什么？

此功能可在不终止活动摄像头会话的情况下，实现线性（Linear）与 SHDR v2 模式管线之间的**动态切换**。

主要架构优势包括：

* \*\*会话连续性：\*\*防止在光照水平（lux）波动期间中断视频会话。
* \*\*延迟优化：\*\*管线在会话创建期间预初始化，以最小化切换开销。
* \*\*资源管理：\*\*在重新配置阶段自动释放并重新获取硬件模块（传感器、IFE、IPE）。

> [!NOTE]
>
> 此功能仅适用于 **SHDR v2** 和**线性**模式管线。

***

## 02 · 验证设置

> [!NOTE]
>
> 使用 SSH 连接到设备控制台。有关说明，请参阅 [How To SSH?](https://dragonwingdocs.qualcomm.com/Linux/devices/iq9075-evk/set-up-the-device.md#connect-over-ssh)。

**1. 初始化日志收集**

在设备上运行以下命令以监控运行时事件：

```bash Log Collection theme={null}
# journalctl -f > /opt/log.txt
```

***

## 03 · 功能验证

在 GST 命令中使用 `vhdr=3` 启用此功能。要启用该功能并在线性与 SHDR 模式之间切换：

**1. 执行元数据应用**

运行 `gst-camera-metadata-example` 应用以支持运行时供应商标签配置。

```bash GStreamer (Auto Mode Switch) theme={null}
gst-camera-metadata-example -p "qtiqmmfsrc name=camsrc camera=0 vhdr=3 ! \
video/x-raw,format=NV12,width=3840,height=2160,framerate=30/1,\
interlace-mode=progressive,colorimetry=bt601 ! queue ! v4l2h264enc capture-io-mode=4 \
output-io-mode=5 ! queue ! h264parse ! mp4mux ! queue ! filesink location=/opt/mux4k.mp4"
```

**2. 切换到 READY 状态**

在应用中选择 **(1) READY**。

**3. 初始化 PLAYING 状态**

选择 **(3) PLAYING**。摄像头以线性模式启动。

**4. 打开元数据菜单**

选择 **(4) META**。将显示以下菜单：

```text Metadata Root Menu theme={null}
 ---------MENU---------
(1)        video-metadata
(2)        image-metadata
(3)        static-metadata
(4)        session-metadata
```

**5. 选择视频类别**

选择 **(1) video-metadata**。将显示以下菜单：

```text Video Metadata Menu theme={null}
 ---------video-metadata---------
(1)        List all available tags
(2)        Dump all tags values in a file
(3)        Dump custom tags values in a file
(4)        Get a tag
(5)        Set a tag
```

**6. 调用标签修改**

选择 **(5) Set a tag**。

**7. 定义供应商标签**

出现提示，要求输入以空格分隔且不带引号的 section 名称和标签名称。输入：
`org.quic.camera.videoHDRmode modeType`

**8. 触发模式切换**

出现设置值的提示。输入 **1** 切换到 SHDR 模式。

> [!TIP]
>
> 要在线性与 SHDR 模式之间切换，请重复此过程，并根据需要输入 **1**（SHDR 模式）和 **0**（线性模式）。

> [!WARNING]
>
> 要关闭摄像头，请选择 **(q) QUIT** 或按 **CTRL + C**。

***

## 04 · 日志验证

通过检查以下日志特征来验证管线重新配置：

### 线性模式选择

```text CamX Status (Linear) theme={null}
cam-server[1693]: CamX: [REQMAP]1693 2652 [CORE   ] camxsession.cpp:4811
ProcessRequest() chiFrameNum: 0 <==> requestId: 1 <==> sequenceId: 0
<==> CSLSyncId: 1 -- RealTimeFeatureZSLPreviewRawYUV_0
```

### SHDR 模式选择

```text CamX Status (SHDR) theme={null}
cam-server[1693]: CamX: [REQMAP]1693 2652 [CORE   ] camxsession.cpp:4811
ProcessRequest() chiFrameNum: 296 <==> requestId: 297 <==> sequenceId:
296 <==> CSLSyncId: 297 -- RealTimeSHDR_0
```
