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

# 使用 ocr_service 运行基本 OCR

`ocr_service` 示例应用程序启用一个提供光学字符识别 (OCR) 功能的服务。

它从 ROS 系统捕获图像主题,并通过 `ocr_topic` 发布结果。

## `ocr_service` 的管道流程

下图显示了基本消息和数据传输通道,以及相关的客户端/服务器和 ROS 节点。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-staging/zh/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/ocr-service-pipeline.svg" alt="pipeline" style={{ display: 'block', margin: '0 auto', width: '80%' }} />

<p style={{ textAlign: 'center', fontWeight: 'bold' }}>
  图: ocr\_service 管道
</p>

## `ocr_service` 管道中使用的 ROS 节点

|     ROS 节点    | 描述                                                 |
| :-----------: | :------------------------------------------------- |
|  `OCR_CLIENT` | 向 `ocr_server` 发送 OCR 请求并获取服务器结果。                  |
|  `OCR_SERVER` | 从 `ocr_server` 获取 OCR 请求,并根据请求 fork `ocr_rosnode`。 |
| `OCR_ROSNODE` | 根据请求订阅图像主题。                                        |

## `ocr_service` 管道中使用的 ROS 主题

<table>
  <thead>
    <tr>
      <th style={{ width: '26%' }}>ROS 主题</th>
      <th style={{ width: '29%' }}>消息类型</th>
      <th style={{ width: '20%' }}>发布者/订阅者</th>
      <th style={{ width: '25%' }}>描述</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`/image_topic_name`</td>
      <td>`<sensor_msgs.msg.Image>`</td>
      <td>订阅来自其他节点的图像</td>
      <td>要处理的图像。</td>
    </tr>

    <tr>
      <td>`/ocr_image_topic_name`</td>
      <td>`<std_msgs.msg.String>`</td>
      <td>由 `ocr-rosnode` 发布</td>
      <td>发布 OCR 结果。</td>
    </tr>
  </tbody>
</table>

## 前提条件

您已根据 [设置运行示例应用程序的环境](./set-up-env-for-sample-app) **设置好设备**。

## 运行开箱即用的 `ocr_service`

<Accordion title="试一试">
  <Steps>
    <Step title="在设备上设置 QIR SDK 和 ROS2 环境">
      启动三个终端,并在每个终端中运行以下命令。

      `ROS_DOMAIN_ID` 的取值范围:\[0, 232]

      ```bash theme={null}
      ssh root@[ip-addr]
      ```

      ```bash title="SSH Session" theme={null}
      source /usr/share/qirp-setup.sh
      export ROS_DOMAIN_ID=xx
      ```
    </Step>

    <Step title="启动 ocr_server">
      在终端 1 中,启动 `ocr_server`。

      ```bash title="SSH Session" theme={null}
      ros2 run ocr_service ocr_server
      ```
    </Step>

    <Step title="推送图像并运行 ocr_testnode">
      在终端 2 中,将一张图像推送到设备并运行 `ocr_testnode`。

      ```bash theme={null}
      wget https://raw.githubusercontent.com/qualcomm-qrb-ros/ocr_service/stable/1.0.0/scripts/digital_720p.png -O digital_720p.png
      scp digital_720p.png root@[ip-addr]:/opt
      ```

      ```bash title="SSH Session" theme={null}
      ros2 run ocr_service ocr_testnode --topic imagetest --picture /opt/digital_720p.png
      ```
    </Step>

    <Step title="运行 ocr_client">
      在终端 3 中,运行 `ocr_client`。

      ```bash title="SSH Session" theme={null}
      ros2 run ocr_service ocr_client imagetest
      ```

      您将看到以下日志:

      <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-staging/zh/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/ocr-results.png" alt="result" style={{ display: 'block', margin: '0 auto' }} />
    </Step>
  </Steps>
</Accordion>

## 构建并运行 `ocr_service`

<Accordion title="试一试">
  <Steps>
    <Step title="在主机上构建 ocr_msg 和 ocr_service">
      ```bash theme={null}
      cd <qirp_decompressed_workspace>
      source setup.sh
      cd qirp-samples/platform/ocr_service
      colcon build --merge-install --cmake-args ${CMAKE_ARGS}
      ```
    </Step>

    <Step title="将 ocr_msg 和 ocr_service 推送到设备">
      ```bash theme={null}
      cd <qirp_decompressed_workspace>
      cd qirp-samples/platform/ocr_service/install
      tar -zcvf ocr_service.tar.gz lib/ share/
      scp ocr_service.tar.gz root@[ip-addr]:/opt
      ssh root@[ip-addr]
      ```

      ```bash title="SSH Session" theme={null}
      tar --no-overwrite-dir --no-same-owner -zxf /opt/ocr_service.tar.gz -C /usr/ros/jazzy/
      ```

      ```bash theme={null}
      wget https://raw.githubusercontent.com/qualcomm-qrb-ros/ocr_service/stable/1.0.0/scripts/digital_720p.png -O digital_720p.png
      scp digital_720p.png root@[ip-addr]:/opt
      ```
    </Step>

    <Step title="运行 ocr_service">
      使用 [运行开箱即用的 ocr\_service](#run-out-of-the-box-ocr_service) 中的步骤在设备上运行 `ocr_service`。
    </Step>
  </Steps>
</Accordion>