Введение

Документ представляет инструкции по установке зависимостей OrbbecSDK и компиляции образцов OrbbecSDK.

Установка зависимостей

Orbbec SDK совместим с стандартным протоколом UVC, и стандартным UVC используются Gemini2, Femto, Femto W, Femto Mega, Astra+, Astra2, Gemini2 L, Gemini 330 Series устройства, поэтому нет необходимости устанавливать дополнительные драйверы.

Windows

1. Установка драйвера

Dabai, Dabai DCW, Dabai DW, Astra mini Pro, Astra Pro Plus, A1 Pro, Gemini E, Gemini E Lite, Gemini используют приватный протокол OpenNI и требуют установки приватных драйверов. Директория драйвера OpenNI следующая: двойной щелчок по следующему изображению директории .exe для установки драйвера.

2. Настройка OpenCV (зависимость примеров)

Отображение данных зависит от сторонней библиотеки OpenCV. Здесь мы используем OpenCV 4.3.0 в качестве примера для демонстрации настройки установки.

• Выполните установочный файл OpenCV, выберите директорию для установки opencv, и нажмите "извлечь" для выполнения установки.

• Добавьте путь OpenCV в переменные окружения системы, введите OpenCV_DIR для имени переменной, обратите внимание на регистр букв, и значение переменной — это путь к папке сборки директории установки OpenCV.

## 3. Регистрация метаданных (метки времени)

В настоящее время из-за механизма Windows, для устройств с протоколом UVC, если вам нужно получить метаданные, такие как метки времени, вам нужно сначала зарегистрироваться в реестре. Используйте документ obsensor_metadata_win10.md для завершения регистрации в реестре.

4. Создание вашего первого приложения

Программные зависимости: VisualStudio2019, cmake 3.10 и выше.

• Скачайте пакет программного обеспечения OrbbecSDK. Возьмите версию 1.5.7 в качестве примера для объяснения компиляции Windows.

• Откройте Cmake и установите папку "Examples" как путь к коду, и папку "build" под "Examples" как путь к генерации двоичного файла, как показано на следующем рисунке. Если нет папки build под Examples, вам нужно создать новую папку.

• Нажмите "Configure" и выберите соответствующую версию Visual Studio и платформы, затем нажмите "Finish", как показано ниже:

• Нажмите "Generate", как показано ниже:

• Пример проекта можно открыть двумя способами.

Метод 1: с использованием cmake, нажмите кнопку "Open Project", чтобы открыть проект Visual Studio.

Метод 2: в папке Examples/build запустите проект Visual Studio напрямую, как показано на рисунке ниже.

• Откройте интерфейс проекта Examples, как показано ниже:

• Выберите проект, который вы хотите запустить, щелкните правой кнопкой мыши и выберите "set as startup project", выберите release и 64-битную версию в опциях запуска.

• Подключите устройство к хосту.

• Скопируйте dll-файлы из папки bin Examples в папку build, где расположены сгенерированные исполняемые файлы.

• Запустите проект OBHelloOrbbec.

Linux

1. Настройка среды системы

• Установите библиотеку libudev:

  sudo apt install libudev-dev

• Установите библиотеку libusb:

  sudo apt install libusb-dev

2. Настройка прав доступа к USB-устройствам

По умолчанию, прямой доступ к USB-устройствам в системах Linux требует привилегий root. Это можно решить через файл конфигурации правил. После разархивирования файлов OrbbecSDK в папке Script будут находиться файл конфигурации "99-obsensor-libusb.rules" и скрипт установки "install_udev_rules.sh".

Запустите скрипт "install_udev_rules.sh" через команду sudo для завершения установки конфигурационных файлов правил.

sudo chmod +x ./install_udev_rules.sh
sudo ./install_udev_rules.sh

3. Увеличение размера буфера USBFS (необязательно)

По умолчанию, размер буфера USBFS составляет 16 МБ. Это значение недостаточно для изображений высокого разрешения или использования нескольких потоков и нескольких устройств. Пользователь может увеличить размер буфера до 128 МБ.### Проверка размера буфера USBFS:

cat /sys/module/usbcore/parameters/usbfs_memory_mb

Увеличение размера буфера USBFS до следующего перезапуска системы (здесь: примерное значение 128)

sudo sh -c 'echo 128 > /sys/module/usbcore/parameters/usbfs_memory_mb'

Постоянное увеличение размера буфера USBFS

Чтобы увеличить размер буфера USBFS постоянно, добавьте параметр ядра usbcore.usbfs_memory_mb=128 в конфигурацию загрузчика. Как это сделать, зависит от загрузчика на вашей системе.

Для GRUB2 (наиболее распространённого):

1. Откройте файл /etc/default/grub. Замените: GRUB_CMDLINE_LINUX_DEFAULT="quiet splash" (или другие содержимое внутри кавычек в зависимости от вашей системы) на: GRUB_CMDLINE_LINUX_DEFAULT="quiet splash usbcore.usbfs_memory_mb=128"

2. Обновите GRUB

   sudo update-grub

3. Перезапустите систему

Другие загрузчики: настройте дополнительные параметры ядра для других загрузчиков, пожалуйста, увидьте руководство по вашему загрузчику.

4. Проверка статуса устройства

• Подготовка окружения: ubuntu18.04 x64 desktop
• В качестве примера используйте Astra+, подключите к ПК с помощью USB 3.0 Type-C кабеля.
• Используйте команду lsusb, чтобы проверить, правильно ли система ПК распознала камеру.

• Определите, правильно ли распознаётся камера по PID&VID

VID: 2bc5 PID: 0536 (цветная камера)
VID: 2bc5 PID: 0636 (камера глубины)
```Создайте каталог сборки в каталоге OrbbecSDK, как показано ниже:
![image17](Image/orbbec_sample_linux_003.png)

```bash
cd OrbbecSDK
mkdir build
cd build
cmake ..
make

MacOS

Установка Xcode и Homebrew

1. Установка Xcode:

   • Xcode — это официальный инструмент разработки, предоставленный Apple, который включает C++ компилятор.
   • Вы можете бесплатно скачать его с Mac App Store.
   • Установка Xcode также устанавливает Command Line Tools, которые включают GCC компилятор и другие инструменты разработки.

2. Установка Homebrew:

   • Homebrew — это менеджер пакетов для macOS, полезный для установки различных инструментов разработки и библиотек.
   • Чтобы установить Homebrew, выполните следующую команду в терминале:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   • С помощью Homebrew вы можете легко установить другие инструменты разработки, такие как Git.

Эти шаги установят базовые инструменты для разработки на C++ на macOS.

Установка зависимостей

brew install cmake opencv

Компиляция и запуск образца

cd OrbbecSDK
mkdir build
cd build
cmake .. && make -j8
make install
cd install/bin
sudo ./OBHelloOrbbec