Разработка Rockchip ISP30: полный справочник RkAiq для RK3588 и отладка

Это справочный материал платформы: полностью сохранена техническая часть 436-страничного английского оригинала V1.2.5 (стр.16–436), включая форматы RK-RAW и заключительные главы кодов ошибок и сокращений. Соответствующий китайский PDF не предоставлен; китайская и русская статьи — полные переводы этой версии. Все 42 технических рисунка взяты из английского PDF, в том числе с китайскими подписями, уже присутствующими в оригинале. Десять таблиц форматов и расположения битов RAW дополнительно восстановлены в редактируемом виде. Изображения целых страниц не заменяют текст.

В исходнике указаны RK3588 / Linux 5.10: BuildRoot и Android — Y, Debian и Yocto — N. Это исторические сведения исходника, не гарантия совместимости всех BSP. Для ArmSoM сначала проверьте SoC, поколение ISP, сенсор/VCM, ядро, библиотеку AIQ, файл IQ и ветку SDK/BSP конкретной платы. ArmSoM Sige7 использует RK3588, однако API и примеры этой статьи на её оборудовании не проверялись. Данные и примеры относятся к исходнику, а не к измерениям ArmSoM. Команды оборудования и операции камеры/мотора не выполнялись.

Неоднозначности оригинала: сохранены повторяющиеся заголовки API, смешение поколений ISP и типов, противоречия единиц, значений по умолчанию, уровней журнала и описаний полей RAW. Они перечислены в редакционных заметках; значения и идентификаторы не исправляются молча. Комментарии кода оставлены на языке оригинала. Команды и API могут менять состояние камеры или мотора: перед использованием необходимы проверка и адаптация.

EDITORIAL-NOTES · ArmSoM Sige7 · ArmSoM camera documentation · Rockchip Linux

1. Общий обзор

1.1 Структурная схема

RK3588 VI — общее обозначение модулей видеоввода, включающих:

Интерфейсы и сбор данных: C/DPHY, DVP, CSI, VICAP.

Обработка изображений: ISP-0, ISP-1, FEC-0, FEC-1.

ISP RK3588 относится к RK ISP v3.0; далее в документе он обозначается ISP30.

1.2 Режимы работы

Один ISP и один CIS (CMOS Image Sensor):

Сквозной/онлайновый режим RAW: синие стрелки на схеме показывают путь данных 1.0.

Режим обратного чтения/офлайновой обработки Raw: оранжевые стрелки показывают пути данных 1.1 и 1.2.

Режим двух ISP 2-in-1 для одного CIS:

В режиме 2-in-1 ISP-0 и ISP-1 отдельно обрабатывают левую и правую части изображения одного CIS, обеспечивая поддержку CIS высокого разрешения.

Несколько CIS:

Один ISP в режиме обратного чтения/офлайновой обработки Raw может обслуживать несколько входов CIS посредством временного мультиплексирования.

1.3 Производительность и ограничения

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

Поддерживается ввод данных Raw12.

ISP30 обрабатывает данные Raw12. При вводе Raw14 младшие биты отбрасываются для обработки как Raw12. У данных с разрядностью менее 12 бит младшие разряды дополняются до Raw12.

Поддерживаются цветные Bayer CIS и монохромные Mono CIS.

Поддерживается многокадровый HDR 3-in-1. Типы HDR CIS перечислены ниже:

В сквозном/онлайновом режиме Raw минимальная задержка до уведомления о выводе данных ISP30 в DDR составляет примерно время передачи кадра/15.

В режиме временного мультиплексирования один ISP поддерживает до четырёх входных источников данных.

В сквозном/онлайновом режиме RAW минимальный кадровый интервал гашения составляет 136 строк, минимальный строчный — 16 пикселей.

Модуль CSM не поддерживает преобразование в ограниченный диапазон YUV; подробности приведены в описании API IMGPROC/CSM.

2. Обзор

ISP30 включает алгоритмы коррекции тёмного тока и дефектных пикселей, 3A, HDR, коррекции затенения и геометрических искажений объектива, 3DLUT, шумоподавления (в домене RAW, многокадрового, цветового и др.) и повышения резкости.

ISP30 состоит из аппаратной реализации алгоритмов и программного логического управления; RkAiq реализует программное управление.

RkAiq получает статистику изображения от драйвера ISP, объединяет её с параметрами IQ Tuning, рассчитывает алгоритмами новые параметры ISP, Sensor и других аппаратных блоков и непрерывно повторяет процесс для получения наилучшего изображения.

2.1 Описание функций

Рис. 1-1. Структурная схема системы ISP21 (подпись исходника)

Общая программно-аппаратная схема ISP30 приведена на рис. 1-1. Сенсор передаёт поток ISP HW, который выводит изображение после последовательности алгоритмов обработки. RkAiq непрерывно получает статистику ISP HW и алгоритмами, включая 3A, формирует новые параметры для аппаратных модулей. Инструмент Tuning позволяет изменять параметры онлайн в реальном времени и затем сохранить новый файл параметров IQ.

2.2 Архитектура RkAiq

Рис. 1-2. Общая архитектура RkAiq

1. Программная концепция ISP30 RkAiq показана на рис. 1-2 и включает четыре части:

1. Динамическая библиотека RkAiq lib содержит основную логику: получает статистику драйвера и передаёт её отдельным алгоритмическим библиотекам.

2. Integrated algo libs: статические алгоритмические библиотеки RK по умолчанию зарегистрированы в динамической библиотеке RkAiq lib.

3. customer 3A libs: заказчик может реализовать собственную библиотеку 3A или других алгоритмов согласно интерфейсам. После регистрации в RkAiq lib предоставленные интерфейсы позволяют выбрать собственную библиотеку или библиотеку RK.

4. IQ file: файл результатов настройки IQ хранит параметры алгоритмов и статические параметры системы, например CIS.

2.3 Программная архитектура

Рис. 1-3. Программная архитектура

Программная схема ISP30 на рис. 1-3 включает три основных слоя:

1. Слой kernel содержит аппаратные драйверы камеры: ISP, sensor, VCM, flashlight, IrCutter и другие, основанные на V4L2 и Media framework.

2. Слой framework интегрирует RkAiq lib двумя способами:

Режим IspServer: Rkaiq lib работает в отдельном процессе IspServer, с которым клиент взаимодействует через dbus. Это также позволяет предоставлять существующим сторонним приложениям, например v4L-CTL, изображения с настроенной обработкой ISP без изменения их исходного кода.

Прямая интеграция: RkAiq lib можно встроить непосредственно в приложение.

3. Слой user: пользовательские приложения.

2.4 Программный процесс

Рис. 1-4. Блок-схема процесса

Последовательность вызовов RkAiq показана на рис. 1-4. Пунктирные блоки необязательны; синий текст обозначает настройки приложения, необходимые для работы с процессом RkAiq.

configure media pipeline: при необходимости настройте тракт ISP30, например выходное разрешение sensor; драйвер имеет настройки по умолчанию. rk_aiq_uapi2_sysctl_init: инициализирует RkAiq, параметры IQ и библиотеки алгоритмов. other Aiq or algo params uapis: необязательно задайте параметры через API алгоритмов и зарегистрируйте сторонние библиотеки. rk_aiq_uapi2_sysctl_prepare: подготавливает начальные параметры библиотек и аппаратных модулей и передаёт их драйверу.

video capture start: включает поток ISP для приложения; этот шаг выполняется после rk_aiq_uapi2_sysctl_prepare.

rk_aiq_uapi2_sysctl_start: запускает внутренний процесс RkAiq. После успешного вызова sensor начинает выдавать данные, а ISP — обрабатывать и выводить изображение.

Rkaiq running: непрерывно получает статистику драйвера ISP, рассчитывает новые параметры алгоритмами, включая 3A, и передаёт их драйверу. PC Online Tuning Tool: ПК может настраивать параметры онлайн через Tuning Tool. video capture stop: перед остановкой RkAiq остановите поток данных. rk_aiq_uapi2_sysctl_stop: останавливает процесс RkAiq; после этого можно изменить параметры и перезапустить его либо перезапустить без изменений.

rk_aiq_uapi2_sysctl_deinit: освобождает ресурсы RkAiq.

2.5 Описание API

API RKAiq делятся на функциональный и модульный уровни.

Функциональный API оборачивает модульный API и предназначен прежде всего для простых настроек функций модуля в прикладном продукте.

Модульный API предоставляет детальную настройку и запрос параметров модуля без разделения API по функциям.

Модульные API RKAiq поддерживают синхронный и асинхронный режимы; функциональные API по умолчанию используют синхронный режим модульных API.

Синхронный режим (Sync): блокирующий API. AIQ обновляет параметры в основном с гранулярностью видеокадра; время возможной блокировки вызывающего потока <= периода видеокадра.

Асинхронный режим (ASync): неблокирующий API. AIQ сохраняет параметры в своём буфере и в соответствующий момент передаёт аппаратуре последние настройки ISP.

Использование синхронного и асинхронного режимов модульного API

Второй параметр модульного API обычно представляет набор настроек — структуру атрибутов. Её член rk_aiq_uapi_sync_t задаёт режим вызова текущего API; подробнее см. тип данных ниже:

2.5.1 rk_aiq_uapi_sync_t

【Описание】Режим синхронизации модуля

【Определение】

 typedef struct rk_aiq_uapi_sync_s {
     rk_aiq_uapi_mode_sync_e     sync_mode;
     bool                        done;
 } rk_aiq_uapi_sync_t;

【Члены】

Примеры использования API AIQ разделены по модулям; рекомендуется обращаться непосредственно к этим примерам.

rkisp_demo/demo/sample

3. Управление системой

3.1 Обзор функций

Управление системой включает общие атрибуты AIQ, инициализацию, запуск, завершение работы и настройку модулей AIQ.

3.2 Справочник API

3.2.1 rk_aiq_uapi2_sysctl_preInit

【Описание】Предварительная установка параметров перед инициализацией AIQ, например используемого файла IQ.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_preInit (const char* sns_ent_name,
                          rk_aiq_working_mode_t mode,
                          const char* force_iq_file);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать до rk_aiq_uapi2_sysctl_init.

mode используется только для выбора файла IQ, но не задаёт режим ISP: его задают в rk_aiq_uapi2_sysctl_prepare. Если force_iq_file не пуст, mode не действует.

Параметр force_iq_file содержит полный путь.

Функция необязательна и служит только для изменения некоторых настроек по умолчанию до rk_aiq_uapi2_sysctl_init.

3.2.2 rk_aiq_uapi2_sysctl_preInit_scene

【Описание】Выбор параметров сцены IQ до инициализации AIQ.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_preInit_scene (const char* sns_ent_name,
                          const char *main_scene,
                         const char *sub_scene);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать до rk_aiq_uapi2_sysctl_init.

main_scene выбирают из массива основных сцен файла IQ; обычно по умолчанию используется “normal”.

sub_scene выбирают из массива подсцен основной сцены файла IQ; обычно по умолчанию используется “day”.

По умолчанию выбирается normal-day. Для hdr-day или другого пользовательского режима укажите сцену этой функцией, иначе параметры IQ могут оказаться неверными.

3.2.3 rk_aiq_uapi2_sysctl_switch_scene

【Описание】Переключение параметров сцены IQ после инициализации AIQ.

【Синтаксис】

 int
 rk_aiq_uapi2_sysctl_switch_scene (const rk_aiq_sys_ctx_t* sys_ctx,
                          const char *main_scene,
                         const char *sub_scene);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать после rk_aiq_uapi2_sysctl_init.

main_scene выбирают из массива основных сцен файла IQ.

sub_scene выбирают из массива подсцен основной сцены файла IQ.

Интерфейс динамически переключает IQ; он пока недостаточно протестирован и может дать неожиданный результат, поэтому используйте его осторожно.

3.2.4 rk_aiq_uapi2_sysctl_init

【Описание】Инициализация контекста AIQ.

【Синтаксис】

 rk_aiq_sys_ctx_t*
 rk_aiq_uapi2_sysctl_init (const char* sns_ent_name,
                          const char* iq_file_dir,
                          rk_aiq_error_cb err_cb,
                          rk_aiq_metas_cb metas_cb);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать до других функций.

3.2.5 rk_aiq_uapi2_sysctl_deinit

【Описание】Освобождение контекста AIQ.

【Синтаксис】

 void
 rk_aiq_uapi2_sysctl_deinit( rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Не вызывать, когда AIQ находится в состоянии start.

3.2.6 rk_aiq_uapi2_sysctl_prepare

【Описание】Подготовка рабочей среды AIQ.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_prepare(const rk_aiq_sys_ctx_t* ctx,
                            uint32_t  width,
                            uint32_t  height,
                            rk_aiq_working_mode_t mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать до rk_aiq_uapi2_sysctl_start.

Если требуется вызов после rk_aiq_uapi2_sysctl_start, сначала вызовите rk_aiq_uapi2_sysctl_stop, затем rk_aiq_uapi2_sysctl_prepare для повторной подготовки рабочей среды.

3.2.7 rk_aiq_uapi2_sysctl_start

【Описание】Запуск системы управления AIQ. После запуска она непрерывно получает статистику 3A от драйвера ISP, выполняет алгоритм 3A и применяет рассчитанные параметры.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_start(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Вызывать после rk_aiq_uapi2_sysctl_prepare.

3.2.8 rk_aiq_uapi2_sysctl_stop

【Описание】Остановка системы управления AIQ.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_stop(const rk_aiq_sys_ctx_t* ctx, bool keep_ext_hw_st);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.9 rk_aiq_uapi2_sysctl_getStaticMetas

【Описание】Запрос статических сведений о sensor, например разрешения и формата данных.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_getStaticMetas(const char* sns_ent_name,
 rk_aiq_static_info_t* static_info);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.10 rk_aiq_uapi2_sysctl_enumStaticMetas

【Описание】Перечисление статических сведений, полученных AIQ.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_enumStaticMetas(int index, rk_aiq_static_info_t*
 static_info);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.11 rk_aiq_uapi2_sysctl_enableAxlib

【Описание】Установка состояния пользовательской библиотеки алгоритмов.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_enableAxlib(const rk_aiq_sys_ctx_t* ctx,
                                const int algo_type,
                                const int lib_id,
                                bool enable);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Если lib_id соответствует работающей библиотеке, функцию можно вызвать в любом состоянии, кроме неинициализированного.

В остальных случаях вызывать только в состоянии prepared: библиотека алгоритма algo_type заменяется новой библиотекой с идентификатором lib_id.

3.2.12 rk_aiq_uapi2_sysctl_getAxlibStatus

【Описание】Получение состояния библиотеки алгоритмов.

【Синтаксис】

 bool
 rk_aiq_uapi2_sysctl_getAxlibStatus(const rk_aiq_sys_ctx_t* ctx,
                                   const int algo_type,
                                   const int lib_id);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.13 rk_aiq_uapi2_sysctl_getEnabledAxlibCtx

【Описание】Получение структуры контекста включённой библиотеки алгоритмов.

【Синтаксис】

 const RkAiqAlgoContext*
 rk_aiq_uapi2_sysctl_getEnabledAxlibCtx(const rk_aiq_sys_ctx_t* ctx, const int
 algo_type);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

【Примечание】

Возвращаемая структура контекста алгоритма используется внутренней закрытой функцией. Для пользовательских библиотек вызывайте её после rk_aiq_uapi2_sysctl_enableAxlib, иначе возвращается NULL.

3.2.14 rk_aiq_uapi2_sysctl_setCpsLtCfg

【Описание】Установка параметров управления подсветкой.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_setCpsLtCfg(const rk_aiq_sys_ctx_t* ctx,
                        rk_aiq_cpsl_cfg_t* cfg);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.15 rk_aiq_uapi2_sysctl_getCpsLtInfo

【Описание】Получение параметров управления подсветкой.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_getCpsLtInfo(const rk_aiq_sys_ctx_t* ctx,
                        rk_aiq_cpsl_info_t* info);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.16 rk_aiq_uapi2_sysctl_queryCpsLtCap

【Описание】Запрос возможностей подсветки.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_queryCpsLtCap(const rk_aiq_sys_ctx_t* ctx,
                        rk_aiq_cpsl_cap_t* cap);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.17 rk_aiq_uapi2_sysctl_getBindedSnsEntNmByVd

【Описание】Запрос имени сущности sensor, соответствующей узлу video.

【Синтаксис】

 const char* rk_aiq_uapi2_sysctl_getBindedSnsEntNmByVd(const char* vd);

【Параметры】

【Возвращаемое значение】

【Примечание】

Параметр должен содержать путь узла ISPP scale.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.18 rk_aiq_uapi2_sysctl_updateIq

【Описание】Динамическое обновление текущего файла параметров IQ без остановки потока.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_sysctl_updateIq(const rk_aiq_sys_ctx_t* sys_ctx, char*
 iqfile);

【Параметры】

【Возвращаемое значение】

【Примечание】

iqfile должен содержать полный путь.

Обновление параметров IQ не переключает рабочий режим: например, переход HDR/normal нельзя выполнить обновлением файла IQ. Однако отдельные функции переключаются разными настройками IQ; например, дневной/ночной режим целиком переключается конфигурацией IQ.

При переключении IQ его параметры заменяют настройки пользовательского API. Например, IQ может задать ручной или автоматический AWB; после вызова функции текущий режим AWB в любом случае заменяется конфигурацией нового IQ по умолчанию.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_sysctl.h

Библиотека: librkaiq.so

3.2.19 rk_aiq_uapi2_sysctl_getCrop

【Описание】Получение параметров кадрирования.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_sysctl_getCrop(const rk_aiq_sys_ctx_t* sys_ctx, rk_aiq_rect_t
 *rect);

【Параметры】

【Возвращаемое значение】

3.3 Типы данных

3.3.1 rk_aiq_working_mode_t

【Описание】Режим работы тракта AIQ.

【Определение】

 typedef enum {
     RK_AIQ_WORKING_MODE_NORMAL,
     RK_AIQ_WORKING_MODE_ISP_HDR2    = 0x10,
     RK_AIQ_WORKING_MODE_ISP_HDR3    = 0x20,
 } rk_aiq_working_mode_t;

【Члены】

【Меры предосторожности】

Сначала запросите режимы, поддерживаемые sensor и AIQ; установка неподдерживаемого режима не действует.

3.3.2 rk_aiq_static_info_t

【Описание】Статические сведения AIQ.

【Определение】

 typedef struct {
     rk_aiq_sensor_info_t    sensor_info;
     rk_aiq_lens_info_t      lens_info;
     bool has_lens_vcm;
     bool has_fl;
     bool fl_strth_adj_sup;
     bool has_irc;
     bool fl_ir_strth_adj_sup;
 } rk_aiq_static_info_t;

【Члены】

3.3.3 rk_aiq_sensor_info_t

【Описание】Сведения о sensor.

【Определение】

 typedef struct {
     char sensor_name[32];
     rk_frame_fmt_t  support_fmt[SUPPORT_FMT_MAX];
     int32_t num;
     /* binded pp stream media index */
     int8_t binded_strm_media_idx;
 } rk_aiq_sensor_info_t;

【Члены】

3.3.4 rk_aiq_module_id_t

【Описание】Идентификатор модуля AIQ.

【Определение】

 typedef enum {
     RK_MODULE_INVAL = 0,
     RK_MODULE_DPCC,
     RK_MODULE_BLS,
     RK_MODULE_LSC,
     RK_MODULE_AWB_GAIN,
     RK_MODULE_CTK,
     RK_MODULE_GOC,
     RK_MODULE_SHARP,
     RK_MODULE_AE,
     RK_MODULE_AWB,
     RK_MODULE_NR,
     RK_MODULE_GIC,
     RK_MODULE_3DLUT,
     RK_MODULE_LDCH,
     RK_MODULE_TNR,
     RK_MODULE_FEC,
     RK_MODULE_MAX
 }rk_aiq_module_id_t;

【Члены】

3.3.5 rk_aiq_cpsl_cfg_t

【Описание】Структура настройки подсветки.

【Определение】

 typedef struct rk_aiq_cpsl_cfg_s {
     RKAiqOPMode_t mode;
     rk_aiq_cpsls_t lght_src;
     bool gray_on; /*!< force to gray if light on */
     union {
         struct {
             float sensitivity; /*!< Range [0-100] */
             uint32_t sw_interval; /*!< switch interval time, unit  seconds */
         } a; /*< auto mode */
         struct {
             uint8_t on; /*!< disable 0, enable 1 */
             float strength_led; /*!< Range [0-100] */
             float strength_ir; /*!< Range [0-100] */
         } m; /*!< manual mode */
     } u;
 } rk_aiq_cpsl_cfg_t;

【Члены】

3.3.6 rk_aiq_cpsl_info_t

【Описание】Структура запроса сведений о подсветке.

【Определение】

 typedef struct rk_aiq_cpsl_info_s {
     int32_t mode;
     uint8_t on;
     bool gray;
     float strength_led;
     float strength_ir;
     float sensitivity;
     uint32_t sw_interval;
     int32_t lght_src;
 } rk_aiq_cpsl_info_t;

【Члены】

3.3.7 rk_aiq_cpsl_cap_t

【Описание】Структура поддерживаемых возможностей подсветки.

【Определение】

 typedef struct rk_aiq_cpsl_cap_s {
     int32_t supported_modes[RK_AIQ_OP_MODE_MAX];
     uint8_t modes_num;
     int32_t supported_lght_src[RK_AIQ_CPSLS_MAX];
     uint8_t lght_src_num;
     rk_aiq_range_t strength_led;
     rk_aiq_range_t sensitivity;
     rk_aiq_range_t strength_ir;
 } rk_aiq_cpsl_cap_t;

【Члены】

3.3.8 rk_aiq_rect_t

【Описание】Определение структуры параметров кадрирования.

【Определение】

 typedef struct rk_aiq_rect_s {
     int left;
     int top;
     int width;
     int height;
 } rk_aiq_rect_t;

【Члены】

4. Офлайновая обработка кадров

4.1 Обзор

RKAIQ поддерживает офлайновую обработку кадров RAW: разбирает файл собственного формата RAW RK, передаёт его ISP и выводит изображение, пригодное для нормального отображения.

Примечание: функция офлайновой обработки кадров не протестирована.

4.2 Функциональная схема

Схема офлайновой обработки кадров

4.3 Описание функций

Поддерживается ввод файла RK-RAW. При файловом интерфейсе вызывающий процесс блокируется до завершения обработки файла и успешного вывода.

Поддерживается ввод буфера RK-RAW с асинхронной обработкой. Процесс не блокируется; после обработки буфера вызывается обратный вызов, если он зарегистрирован.

Поддерживается ввод буфера RK-RAW с синхронной обработкой. Процесс блокируется до окончания обработки буфера и успешного вывода.

4.4 Формат RK-RAW

См. документ RK RAW File Format.

4.5 Поддерживаемые форматы RAW

Поддерживаются raw8/raw10/raw12 и четыре формата Bayer: BGGR/GBRG/GRBG/RGGB.

4.6 Справочник API

4.7 Структуры данных

4.8 Особенности использования

При создании AIQ Context для обработки RK Raw параметр sns_ent_name интерфейса rk_aiq_uapi2_sysctl_init должен быть “FakeCamera”.

Обработка Raw зависит от файла эффектов IQ XML. XML должен быть подготовлен для того же разрешения, что и входной кадр RK Raw; файл необходимо назвать FakeCamera.xml и поместить в путь загрузки XML.

4.9 Пример использования

Пример работы с API офлайновой обработки кадров: rkisp_demo, путь YOUR_SDK_DIR/external/camera_engine_rkaiq/rkisp_demo.

5. Группы камер

5.1 Обзор

В круговом обзоре и подобных сценариях камеры объединяют для общего управления и настройки экспозиции и других параметров. Для этого создают group. Camera Group API основан на AIQ API отдельной камеры; если не оговорено иное, API отдельного AIQ подходит и группе. По типу переданного Context AIQ направляет запрос группе либо одной камере.

5.1.1 rk_aiq_uapi2_camgroup_create

【Описание】При создании Camera group для каждой Camera создаётся отдельный AIQ ctx, управляемый Group Ctx.

【Синтаксис】

 rk_aiq_camgroup_ctx_t*
 rk_aiq_uapi2_camgroup_create (rk_aiq_camgroup_instance_cfg_t* cfg);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h

Библиотека: librkaiq.so

【Примечание】

rk_aiq_uapi2_sysctl_init создаёт среду AIQ отдельной камеры. Для sensor entity, среда которой уже создана этой функцией, нельзя дополнительно создавать групповую среду через rk_aiq_uapi2_camgroup_create, и наоборот.

Сцена IQ по умолчанию — normal-day. Для HDR и других режимов предварительно настройте сцену через rk_aiq_uapi2_sysctl_preInit_scene.

5.1.2 rk_aiq_uapi2_camgroup_prepare

【Описание】Создаёт начальные параметры и тракты согласно выбранному режиму pipeline, вызывая rk_aiq_uapi2_sysctl_prepare для AIQ ctx каждой Camera.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_prepare (rk_aiq_camgroup_ctx_t* camgroup_ctx,
 rk_aiq_working_mode_t mode);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.3 rk_aiq_uapi2_camgroup_start

【Описание】Запускает группу камер, вызывая rk_aiq_uapi2_sysctl_start для AIQ ctx каждой Camera.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_start (rk_aiq_camgroup_ctx_t* camgroup_ctx);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.4 rk_aiq_uapi2_camgroup_stop

【Описание】Останавливает группу камер, вызывая rk_aiq_uapi2_sysctl_stop для AIQ ctx каждой Camera.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_stop (rk_aiq_camgroup_ctx_t* camgroup_ctx);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.5 rk_aiq_uapi2_camgroup_destroy

【Описание】Уничтожает группу камер, вызывая rk_aiq_uapi2_sysctl_deinit для AIQ ctx каждой Camera.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_destroy (rk_aiq_camgroup_ctx_t* camgroup_ctx);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.6 rk_aiq_uapi2_camgroup_getOverlapMap

【Описание】В круговом обзоре получает сведения о перекрытии камер из контекста CameraGroup.

【Синтаксис】

 struct RK_PS_SrcOverlapMap*
 rk_aiq_uapi2_camgroup_getOverlapMap (rk_aiq_camgroup_ctx_t* camgroup_ctx);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.7 rk_aiq_uapi2_camgroup_getOverlapMap

【Описание】В круговом обзоре получает сведения о перекрытии камер из файла.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_getOverlapMap_from_file (const char* map_file,
                                                             struct
 RK_PS_SrcOverlapMap** overlapMap);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.8 rk_aiq_uapi2_camgroup_getAiqCtxBySnsNm

【Описание】Получает контекст AIQ отдельной Camera по имени сущности Sensor в группе.

【Синтаксис】

 rk_aiq_sys_ctx_t*
 rk_aiq_uapi2_camgroup_getAiqCtxBySnsNm (rk_aiq_camgroup_ctx_t* camgroup_ctx,
 const char* sns_entity_name);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.9 rk_aiq_uapi2_camgroup_getCamInfos

【Описание】Получает сведения о камерах группы, например имена сущностей sensor.

【Синтаксис】

 XCamReturn
 rk_aiq_uapi2_camgroup_getCamInfos (rk_aiq_camgroup_ctx_t* camgroup_ctx,
                    rk_aiq_camgroup_camInfos_t* camInfos);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_camgroup.h; библиотека: librkaiq.so

5.1.10 rk_aiq_uapi2_camgroup_bind

【Описание】Зарезервированный интерфейс, не реализован.

5.1.11 rk_aiq_uapi2_camgroup_unbind

【Описание】Зарезервированный интерфейс, не реализован.

5.2 Структуры данных

5.2.1 rk_aiq_camgroup_instance_cfg_t

【Описание】Параметры Carmelaghrup (написание исходника).

【Определение】

   typedef struct rk_aiq_camgroup_instance_cfg_s {
       const char* sns_ent_nm_array[RK_AIQ_CAM_GROUP_MAX_CAMS];
       int sns_num;
       const char* config_file_dir;
        /* followings are relative path to config_file_dir */
        const char* single_iq_file;
        const char* group_iq_file;
        const char* overlap_map_file;
    } rk_aiq_camgroup_instance_cfg_t;

【Члены】

5.2.2 rk_aiq_camgroup_camInfos_t

【Описание】Сведения о каждой камере Camera group.

【Определение】

    typedef struct rk_aiq_camgroup_camInfos_s {
        int valid_sns_num;
        const char* sns_ent_nm[RK_AIQ_CAM_GROUP_MAX_CAMS];
        int sns_camPhyId[RK_AIQ_CAM_GROUP_MAX_CAMS];
   } rk_aiq_camgroup_camInfos_t;

【Члены】

5.2.3 struct RK_PS_SrcOverlapMap

【Описание】Определение областей перекрытия камер.

【Определение】

        struct RK_PS_SrcOverlapMap
      {
            char versionInfo[64];
            RK_PS_SrcOverlapPosition srcOverlapPositon[8];
            unsigned char overlapMap[15 * 15 * 8];
        };

【Члены】

6. AE

6.1 Обзор

Модуль AE определяет экспозицию текущего изображения системой автоматического замера и автоматически настраивает диафрагму объектива, затвор и усиление sensor для наилучшего качества изображения.

6.2 Основные понятия

Время экспозиции: время накопления заряда sensor, от начала экспонирования пикселя до считывания заряда.

Усиление экспозиции: общий коэффициент усиления выходного заряда sensor, обычно включающий цифровое и аналоговое усиление. Аналоговое вносит несколько меньше шума, поэтому обычно предпочтительнее.

Диафрагма: механизм объектива, изменяющий размер светового отверстия.

Подавление мерцания: устраняет мерцание из-за несовпадения частоты питания лампы и частоты кадров sensor; обычно ограничивает выдержку и изменяет частоту кадров sensor.

6.3 Описание функций

Модуль AE состоит из статистики AE и алгоритма стратегии управления AE.

6.4 Справочник функционального API

6.4.1 rk_aiq_uapi2_setAeLock

【Описание】

Настройка блокировки экспозиции AE.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAeLock（const rk_aiq_sys_ctx_t* ctx, bool on);

【Параметры】

【Возвращаемое значение】

6.4.2 rk_aiq_uapi2_setExpMode

【Описание】Установка автоматического или ручного режима экспозиции.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setExpMode(const rk_aiq_sys_ctx_t* ctx, opMode_t mode);

【Параметры】

【Возвращаемое значение】

【Примечание】

При переходе к ручной экспозиции усиление и выдержка берутся из начальных значений файла эффектов. Чтобы одновременно задать экспозицию, используйте rk_aiq_uapi2_setManualExp.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.3 rk_aiq_uapi2_getExpMode

【Описание】Получение режима экспозиции.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getExpMode(const rk_aiq_sys_ctx_t* ctx, opMode_t *mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.4 rk_aiq_uapi2_setManualExp

【Описание】Установка ручной экспозиции с заданием усиления и выдержки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setManualExp(const rk_aiq_sys_ctx_t* ctx, float gain,
 float time);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.5 rk_aiq_uapi2_setExpGainRange

【Описание】Установка диапазона усиления.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setExpGainRange(const rk_aiq_sys_ctx_t* ctx, paRange_t
 *gain);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.6 rk_aiq_uapi2_getExpGainRange

【Описание】Получение диапазона усиления.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getExpGainRange(const rk_aiq_sys_ctx_t* ctx, paRange_t
 *gain);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.7 rk_aiq_uapi2_setExpTimeRange

【Описание】Установка диапазона выдержки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setExpTimeRange(const rk_aiq_sys_ctx_t* ctx, paRange_t
 *time);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.8 rk_aiq_uapi2_getExpTimeRange

【Описание】Получение диапазона выдержки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getExpTimeRange(const rk_aiq_sys_ctx_t* ctx, paRange_t
 *time);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.9 rk_aiq_uapi2_setBLCMode

【Описание】Включение компенсации контрового света и выбор области.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setBLCMode(const rk_aiq_sys_ctx_t* ctx, bool on,
 aeMeasAreaType_t areaType);

【Параметры】

【Возвращаемое значение】

【Примечание】

Интерфейс доступен только в линейном режиме.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.10 rk_aiq_uapi2_setBLCStrength

【Описание】Установка степени усиления тёмных областей.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setBLCStrength(const rk_aiq_sys_ctx_t* ctx, int
 strength);

【Параметры】

【Возвращаемое значение】

【Примечание】

Интерфейс доступен только в линейном режиме.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.11 rk_aiq_uapi2_setHLCMode

【Описание】Включение подавления ярких областей.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setHLCMode(const rk_aiq_sys_ctx_t* ctx, bool on);

【Параметры】

【Возвращаемое значение】

【Примечание】

Интерфейс доступен только в линейном режиме.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.12 rk_aiq_uapi2_setHLCStrength

【Описание】Установка степени подавления ярких областей.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setHLCStrength(const rk_aiq_sys_ctx_t* ctx, int
 strength);

【Параметры】

【Возвращаемое значение】

【Примечание】

Интерфейс доступен только в линейном режиме.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.sov (написание исходника, требуется проверка).

6.4.13 rk_aiq_uapi2_setAntiFlickerEn

【Описание】Включение подавления мерцания на частоте сети.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAntiFlickerEn(const rk_aiq_sys_ctx_t* ctx, bool on)；

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.14 rk_aiq_uapi2_getAntiFlickerEn

【Описание】Включение подавления мерцания на частоте сети.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getAntiFlickerEn(const rk_aiq_sys_ctx_t* ctx, bool* on)；

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.15 rk_aiq_uapi2_setAntiFlickerMode

【Описание】Установка режима подавления мерцания.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAntiFlickerMode(const rk_aiq_sys_ctx_t* ctx,
 antiFlickerMode_t mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.16 rk_aiq_uapi2_getAntiFlickerMode

【Описание】Получение режима подавления мерцания.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getAntiFlickerMode(const rk_aiq_sys_ctx_t* ctx,
 antiFlickerMode_t *mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.17 rk_aiq_uapi2_setExpPwrLineFreqMode

【Описание】Установка частоты подавления мерцания.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setExpPwrLineFreqMode(const rk_aiq_sys_ctx_t* ctx,
 expPwrLineFreq_t freq);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.4.18 rk_aiq_uapi2_getExpPwrLineFreqMode

【Описание】Получение частоты подавления мерцания.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getExpPwrLineFreqMode(const rk_aiq_sys_ctx_t* ctx,
 expPwrLineFreq_t *freq);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

6.5 Типы данных функционального API

6.5.1 opMode_t

【Описание】Определение автоматического и ручного режимов.

【Определение】

 typedef enum opMode_e {
     OP_AUTO = 0,
     OP_MANUALl = 1,
     OP_INVAL
 } opMode_t;

【Члены】

6.5.2 paRange_t

【Описание】Определение диапазона параметра.

【Определение】

 typedef struct paRange_s {
     float max;
     float min;
 } paRange_t;

【Члены】

6.5.3 aeMeasAreaType_t

【Описание】Определение типа области измерения AE.

【Определение】

 typedef enum aeMeasAreaType_e {
     AE_MEAS_AREA_AUTO = 0,
     AE_MEAS_AREA_UP,
     AE_MEAS_AREA_BOTTOM,
     AE_MEAS_AREA_LEFT,
     AE_MEAS_AREA_RIGHT,
     AE_MEAS_AREA_CENTER,
 } aeMeasAreaType_t;

【Члены】

6.5.4 expPwrLineFreq_t

【Описание】Определение частоты подавления мерцания.

【Определение】

 typedef enum expPwrLineFreq_e {
        EXP_PWR_LINE_FREQ_DIS   = 0,
        EXP_PWR_LINE_FREQ_50HZ  = 1,
        EXP_PWR_LINE_FREQ_60HZ  = 2,
 } expPwrLineFreq_t;

【Члены】

6.5.5 antiFlickerMode_t

【Описание】Определение режима подавления мерцания.

【Определение】

 typedef enum antiFlickerMode_e {
     ANTIFLICKER_NORMAL_MODE = 0,
     ANTIFLICKER_AUTO_MODE = 1,
 } antiFlickerMode_t;

【Члены】

6.6 Справочник модульного API

6.6.1 rk_aiq_user_api2_ae_setExpSwAttr

【Описание】Установка программных атрибутов экспозиции AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setExpSwAttr(const rk_aiq_sys_ctx_t* ctx,
                                 const Uapi_ExpSwAttrV2_t expSwAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

Настройка ручной экспозиции

Компоненты экспозиции: выдержка sensor, его усиление и цифровое усиление ISP. После выбора ручного режима задайте ручные состояния каждого компонента (ManualGainEn, ManualTimeEn, ManualIspDgainEn) и соответствующие значения. В ручном режиме все компоненты должны управляться вручную; значения ограничены sensor и объективом. При превышении ограничений sensor алгоритм автоматически исправляет значение.

 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.AecOpType = RK_AIQ_OP_MODE_MANUAL;
 //LinearAE
 expSwAttr.stManual.LinearAE.ManualGainEn = true;
 expSwAttr.stManual.LinearAE.ManualTimeEn = true;
 expSwAttr.stManual.LinearAE.GainValue = 1.0f; /*gain = 1x*/
 expSwAttr.stManual.LinearAE.TimeValue = 0.02f; /*time = 1/50s*/
 //HdrAE (should set all frames)
 expSwAttr.stManual.HdrAE.ManualGainEn = true;
 expSwAttr.stManual.HdrAE.ManualTimeEn = true;
 expSwAttr.stManual.HdrAE.GainValue[0] = 1.0f; /*sframe gain = 1x*/
 expSwAttr.stManual.HdrAE.TimeValue[0] = 0.002f; /*sframe time = 1/500s*/
 expSwAttr.stManual.HdrAE.GainValue[1] = 2.0f; /*mframe gain = 2x*/
 expSwAttr.stManual.HdrAE.TimeValue[1] = 0.01f; /*mframe time = 1/100s*/
 expSwAttr.stManual.HdrAE.GainValue[2] = 4.0f; /*lframe gain = 4x*/
 expSwAttr.stManual.HdrAE.TimeValue[2] = 0.02f; /*lframe time = 1/50s*/
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка автоматической экспозиции

Для автоматической экспозиции задаются диапазоны компонентов; при выходе за ограничения sensor алгоритм корректирует их автоматически.

【Примечание】Параметры задания диапазона компонентов экспозиции отличаются от параметров получения диапазона.

 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.AecOpType = RK_AIQ_OP_MODE_AUTO;
 //set time range in struct "stAdvanced"
 expSwAttr.stAdvanced.SetAeRangeEn = true;/*must enable*/
 //LinAE
 expSwAttr.stAdvanced.SetLinAeRange.stExpTimeRange.Max = 0.04f; /*time_max =
 0.04*/
 expSwAttr.stAdvanced.SetLinAeRange.stExpTimeRange.Min = 0.001f; /*time_min =
 0.001*/
 //HdrAE
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[0].Max = 0.002f; /*sframe
 time_max = 0.02*/
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[0].Min = 0.001f; /*sframe
 time_min = 0.01*/
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[1].Max = 0.003f; /*mframe
 time_max = 0.03*/
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[1].Min = 0.002f; /*mframe
 time_min = 0.02*/
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[2].Max = 0.04f; /*lframe
 time_max = 0.03*/
 expSwAttr.stAdvanced.SetHdrAeRange.stExpTimeRange[2].Min = 0.03f; /*lframe
 time_min = 0.02*/
 //get time range in struct "stAuto"
 printf("linear time range=[%f,%f]\n",
     expSwAttr.stAuto.LinAeRange.stExpTimeRange.Min,
 expSwAttr.stAuto.LinAeRange.stExpTimeRange.Max);
 printf("hdr stime range=[%f,%f], mtime range=[%f,%f], ltime range=[%f,%f]\n",
     expSwAttr.stAuto.HdrAeRange.stExpTimeRange[0].Min,
 expSwAttr.stAuto.HdrAeRange.stExpTimeRange[0].Max,
     expSwAttr.stAuto.HdrAeRange.stExpTimeRange[1].Min,
 expSwAttr.stAuto.HdrAeRange.stExpTimeRange[1].Max,
     expSwAttr.stAuto.HdrAeRange.stExpTimeRange[2].Min,
 expSwAttr.stAuto.HdrAeRange.stExpTimeRange[2].Max);
 //set gain range in struct "stAdvanced"
 expSwAttr.stAdvanced.SetAeRangeEn = true;/*must enable*/
 //LinAE
 expSwAttr.stAdvanced.SetLinAeRange.stGainRange.Max = 32.0f; /*gain_max = 32x*/
 expSwAttr.stAdvanced.SetLinAeRange.stGainRange.Min = 1.0f; /*gain_min = 1x*/
 //HdrAE
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[0].Max = 32.0f; /*sframe gain_max
 = 2x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[0].Min = 1.0f; /*sframe gain_min =
 1x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[1].Max = 64.0f; /*mframe gain_max
 = 64x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[1].Min = 1.0f; /*mframe gian_min =
 1x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[2].Max = 64.0f; /*lframe gain_max
 = 64x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[2].Min = 1.0f; /*lframe gain_min =
 1x*/
 //get gain range in struct "stAuto"
 printf("linear gain range=[%f,%f]\n",
     expSwAttr.stAuto.LinAeRange.stGainRange.Min,
 expSwAttr.stAuto.LinAeRange.stGainRange.Max);
 printf("hdr sgain range=[%f,%f], mgain range=[%f,%f], lgain range=[%f,%f]\n",
     expSwAttr.stAuto.HdrAeRange.stGainRange[0].Min,
 expSwAttr.stAuto.HdrAeRange.stGainRange[0].Max,
     expSwAttr.stAuto.HdrAeRange.stGainRange[1].Min,
 expSwAttr.stAuto.HdrAeRange.stGainRange[1].Max,
     expSwAttr.stAuto.HdrAeRange.stGainRange[2].Min,
 expSwAttr.stAuto.HdrAeRange.stGainRange[2].Max);
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка полуручной экспозиции

Полуручная экспозиция требует ручного управления хотя бы одним компонентом (выдержкой sensor, его усилением или цифровым усилением ISP), тогда как остальные управляются автоматически; иначе происходит выход с ошибкой. Для ручного усиления при автоматических выдержке и усилении ISP есть два способа. Способ 1: в ручном режиме задать false для ручного управления выдержкой и усилением ISP, true для усиления sensor и нужное ручное значение. Способ 2: в автоматическом режиме установить одинаковые максимум и минимум усиления, равные фиксируемому значению.

【Примечание】Способ 1: в HDR ручное управление синхронно для всех кадров — соответствующие компоненты имеют одинаковое состояние. Максимальная экспозиция длинного кадра должна превышать максимальную короткого, минимальная длинного — минимальную короткого. Способ 2: в HDR состояния могут различаться, например ручное усиление короткого и автоматическое длинного кадра. Требования к превышению максимума и минимума длинного кадра над коротким сохраняются.

 //Method One
 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.AecOpType = RK_AIQ_OP_MODE_MANUAL;
 //LinearAE
 expSwAttr.stManual.LinearAE.ManualGainEn = true;
 expSwAttr.stManual.LinearAE.ManualTimeEn = false;
 expSwAttr.stManual.LinearAE.ManualIspDgainEn = false;
 expSwAttr.stManual.LinearAE.GainValue = 2.0f; /*gain = 2x*/
 //HdrAE (need to set all frames)
 expSwAttr.stManual.HdrAE.ManualGainEn = true;
 expSwAttr.stManual.HdrAE.ManualTimeEn = false;
 expSwAttr.stManual.HdrAE.ManualIspDgainEn = false;
 expSwAttr.stManual.HdrAE.GainValue[0] = 1.0f; /*sframe gain = 1x*/
 expSwAttr.stManual.HdrAE.GainValue[1] = 2.0f; /*mframe gain = 2x*/
 expSwAttr.stManual.HdrAE.GainValue[2] = 4.0f; /*lframe gain = 4x*/
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);
 //Method Two
 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.AecOpType = RK_AIQ_OP_MODE_AUTO;
 //set gain range
 expSwAttr.stAdvanced.SetAeRangeEn = true;/*Must be enabled*/
 //LinAE
 expSwAttr.stAdvanced.SetLinAeRange.stGainRange.Max = 2.0f; /*gain_max = 2x*/
 expSwAttr.stAdvanced.SetLinAeRange.stGainRange.Min = 2.0f;  /*gain_min = 2x*/
 //HdrAE (allow to set only one frame)
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[0].Max = 2.0f; /*sframe gain_max =
 2x*/
 expSwAttr.stAdvanced.SetHdrAeRange.stGainRange[0].Min = 2.0f;  /*sframe gain_min
 = 2x*/
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка фиксированной частоты кадров или её автоматического снижения

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

 //set fixed framemode
 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.stAuto.stFrmRate.isFpsFix = true;
 expSwAttr.stAuto.stFrmRate.FpsValue = 25; /*fps = 25*/
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);
 //set auto framemode
 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 expSwAttr.stAuto.stFrmRate.isFpsFix = false;
 /*Generally, the automatic frame reduction mode is configured by tuning personnel
 in advance with the minimum frame rate and the gain value corresponding to the
 switching frame rate*/
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка скорости регулировки экспозиции и задержки в кадрах

 Uapi_ExpSwAttrV2_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 //set ae speed
 expSwAttr.stAuto.stAeSpeed.DampOver = 0.8f;
 expSwAttr.stAuto.stAeSpeed.DampDark2Bright = 0.8f;
 expSwAttr.stAuto.stAeSpeed.DampUnder = 0.8f;
 expSwAttr.stAuto.stAeSpeed.DampBright2Dark = 0.8f;
 //set ae delay
 expSwAttr.stAuto.BlackDelayFrame = 2;
 expSwAttr.stAuto.WhiteDelayFrame = 4;
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка подавления мерцания

 Uapi_ExpSwAttr_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 //set antifilicker mode
 expSwAttr.stAuto.stAntiFlicker.enable = true;
 expSwAttr.stAuto.stAntiFlicker.Frequency = AECV2_FLICKER_FREQUENCY_50HZ;
 expSwAttr.stAuto.stAntiFlicker.Mode = AECV2_ANTIFLICKER_AUTO_MODE;
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

Настройка весов AE

Задаются веса 15X15, которые алгоритм сжимает под фактическую сетку аппаратных блоков. Можно менять веса непосредственно в JSON либо через stadvanced; при отключении последнего восстанавливаются веса JSON. Рекомендуется второй способ.

Для приложений с лицами при появлении лица рекомендуется expSwAttr.stAdvanced.enable = true и использование весов expSwAttr.stAdvanced; при исчезновении — false для возврата исходных весов.

 Uapi_ExpSwAttr_t expSwAttr;
 ret = rk_aiq_user_api2_ae_getExpSwAttr(ctx, &expSwAttr);
 uint8_t GridWeights[225]={
 0,  0, 1,  2,  2,  3,  4,  5,  4, 3,  2,  2,  1,  0,  0,
 0,  1, 2,  3,  3,  4,  5,  6,  5, 4,  3,  3,  2,  1,  0,
 1,  2, 3,  5,  5,  6,  7,  8,  7, 6,  5,  5,  3,  2,  1,
 2,  3, 5,  7,  7,  8,  9, 10,  9, 8,  7,  7,  5,  3,  2,
 2,  3, 5,  7,  8,  9, 10, 11, 10, 9,  8,  7,  5,  3,  2,
 2,  4, 6,  8,  9, 10, 11, 12, 11,10,  9,  8,  6,  4,  2,
 2,  4, 6,  9, 10, 11, 12, 13, 12,11, 10,  9,  6,  4,  2,
 3,  5 ,7, 10, 11, 12, 13, 14, 13,12, 11, 10,  7,  5,  3,
 2,  4, 6,  9, 10, 11, 12, 13, 12,11, 10,  9,  6,  4,  2,
 2,  4, 6,  8,  9, 10, 11, 12, 11,10,  9,  8,  6,  4,  2,
 2,  3, 5,  7,  8,  9, 10, 11, 10, 9,  8,  7,  5,  3,  2,
 2,  3, 5,  7,  7,  8,  9, 10,  9, 8,  7,  7,  5,  3,  2,
 1,  2, 4,  6,  6,  7,  8,  9,  8, 7,  6,  6,  4,  2,  1,
 0,  1, 3,  5,  5,  6,  7,  8,  7, 6,  5,  5,  3,  1,  0,
 0,  1, 3,  5,  5,  6,  7,  8,  7, 6,  5,  5,  3,  1,  0
 };
 //method one：
 memcpy(expSwAttr.GridWeights.uCoeff, GridWeights,
 sizeof(expSwAttr.GridWeights.uCoeff));
 //method two:
 expSwAttr.stAdvanced.enable = true; //important! true means preferring to use these parameters
 memcpy(expSwAttr.stAdvanced.GridWeights, GridWeights,
 sizeof(expSwAttr.stAdvanced.GridWeights));
 ret = rk_aiq_user_api2_ae_setExpSwAttr(ctx, expSwAttr);

6.6.2 rk_aiq_user_api2_ae_getExpSwAttr

【Описание】Получение программных атрибутов экспозиции AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getExpSwAttr(const rk_aiq_sys_ctx_t* ctx,
                         Uapi_ExpSwAttrV2_t* pExpSwAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.3 rk_aiq_user_api2_ae_setLinAeRouteAttr

【Описание】Установка стратегии распределения экспозиции AE для сцены в линейном режиме.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setLinAeRouteAttr(const rk_aiq_sys_ctx_t* ctx, const
 Uapi_LinAeRouteAttr_t linAeRouteAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

 Uapi_LinAeRouteAttr_t LinAeRouteAttr;
 memset(&LinAeRouteAttr,0x00,sizeof(Uapi_LinAeRouteAttr_t));
 rk_aiq_user_api2_ae_getLinAeRouteAttr(sys_ctx,&LinAeRouteAttr);
 int len = 8;
 float TimeDot[8]={0,0.01,0.01,0.02,0.02,0.03,0.03,0.04};
 float GainDot[8]={1,1,4,4,8,8,16,32};
 float IspGainDot[8]={1,1,1,1,1,1,1,1};
 int PirisDot[8]={512,512,512,512,512,512,512,512};
 LinAeRouteAttr.TimeDot_len = len;
 LinAeRouteAttr.GainDot_len = len;
 LinAeRouteAttr.IspDGainDot_len = len;
 LinAeRouteAttr.PIrisDot_len = len;
 LinAeRouteAttr.GainDot = GainDot;
 LinAeRouteAttr.IspDGainDot = IspGainDot;
 LinAeRouteAttr.TimeDot = TimeDot;
 LinAeRouteAttr.PIrisDot = PirisDot;
 rk_aiq_user_api2_ae_setLinAeRouteAttr(sys_ctx,LinAeRouteAttr);

6.6.4 rk_aiq_user_api2_ae_getLinAeRouteAttr

【Описание】Получение стратегии распределения экспозиции AE для сцены в линейном режиме.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getLinAeRouteAttr(const rk_aiq_sys_ctx_t* ctx,
 Uapi_LinAeRouteAttr_t* pLinAeRouteAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.5 rk_aiq_user_api2_ae_setHdrAeRouteAttr

【Описание】Установка стратегии распределения экспозиции AE для сцены в режиме HDR.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setHdrAeRouteAttr(const rk_aiq_sys_ctx_t* ctx, const
 Uapi_HdrAeRouteAttr_t hdrAeRouteAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

 Uapi_HdrAeRouteAttr_t stHdrRoute;
 memset(&stHdrRoute,0x00,sizeof(Uapi_HdrAeRouteAttr_t));
 ret = rk_aiq_user_api2_ae_getHdrAeRouteAttr(ctx,&stHdrRoute);
 int len = 6;
 float HdrTimeDot[3][6] = {0.0, 0.01, 0.01, 0.01, 0.01, 0.01,
                           0.0, 0.02, 0.02, 0.02, 0.02, 0.02,
                           0.0, 0.03, 0.03, 0.03, 0.03, 0.03};
 float HdrGainDot[3][6] = {1, 1, 4, 6, 8, 12,
                           1, 1, 4, 6, 8, 12,
                           1, 1, 4, 6, 8, 12};
 float HdrIspDGainDot[3][6] = {1, 1, 1, 1, 1, 1,
                               1, 1, 1, 1, 1, 1,
                               1, 1, 1, 1, 1, 1};
 int   HdrPIrisGainDot[6] = {1, 1, 1, 1, 1, 1};
 stHdrRoute.Frm0TimeDot_len = len;
 stHdrRoute.Frm0GainDot_len = len;
 stHdrRoute.Frm0IspDGainDot_len = len;
 stHdrRoute.Frm1TimeDot_len = len;
 stHdrRoute.Frm1GainDot_len = len;
 stHdrRoute.Frm1IspDGainDot_len = len;
 stHdrRoute.Frm2TimeDot_len = len;
 stHdrRoute.Frm2GainDot_len = len;
 stHdrRoute.Frm2IspDGainDot_len = len;
 stHdrRoute.PIrisDot_len = len;
 stHdrRoute.Frm0TimeDot = HdrTimeDot[0];
 stHdrRoute.Frm0GainDot = HdrGainDot[0];
 stHdrRoute.Frm0IspDGainDot = HdrIspDGainDot[0];
 stHdrRoute.Frm1TimeDot = HdrTimeDot[1];
 stHdrRoute.Frm1GainDot = HdrGainDot[1];
 stHdrRoute.Frm1IspDGainDot = HdrIspDGainDot[1];
 stHdrRoute.Frm2TimeDot = HdrTimeDot[2];
 stHdrRoute.Frm2GainDot = HdrGainDot[2];
 stHdrRoute.Frm2IspDGainDot = HdrIspDGainDot[2];
 stHdrRoute.PIrisDot = HdrPIrisGainDot;
 ret = rk_aiq_user_api2_ae_setHdrAeRouteAttr(ctx,stHdrRoute);

6.6.6 rk_aiq_user_api2_ae_getHdrAeRouteAttr

【Описание】Получение стратегии распределения экспозиции AE для сцены в режиме HDR.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getHdrAeRouteAttr(const rk_aiq_sys_ctx_t* ctx,
 Uapi_HdrAeRouteAttr_t* pHdrAeRouteAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.7 rk_aiq_user_api2_ae_setLinExpAttr

【Описание】Установка параметров экспозиции AE в линейном режиме.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setLinExpAttr(const rk_aiq_sys_ctx_t* ctx, const
 Uapi_LinExpAttrV2_t linExpAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

Установка параметров линейной экспозиции AE, включая Evbias для регулировки яркости, BackLightCtrl для компенсации контрового света и OverExpCtrl для подавления ярких областей. Последние две функции нельзя включать одновременно.

 Uapi_LinExpAttrV2_t linExpAttr;
 memset(&linExpAttr,0,sizeof(Uapi_LinExpAttrV2_t));
 ret = rk_aiq_user_api2_ae_getLinExpAttr(ctx, &linExpAttr);
 //set Evbias
 printf("Evbias=%f\n", linExpAttr.Evbias);
 linExpAttr.Evbias = 100.0f;
 //set BackLightCtrl
 linExpAttr.BackLightCtrl.Enable = true;
 linExpAttr.BackLightCtrl.StrBias = 200.0f;
 //set OverExpCtrl
 linExpAttr.OverExpCtrl.Enable = true;
 linExpAttr.OverExpCtrl.StrBias = 100.0f;
 ret = rk_aiq_user_api2_ae_setLinExpAttr(ctx, linExpAttr);

6.6.8 rk_aiq_user_api2_ae_getLinExpAttr

【Описание】Получение параметров линейной экспозиции AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getLinExpAttr(const rk_aiq_sys_ctx_t* ctx,
 Uapi_LinExpAttrV2_t* pLinExpAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.9 rk_aiq_user_api2_ae_setHdrExpAttr

【Описание】Установка параметров экспозиции AE в режиме HDR.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setHdrExpAttr(const rk_aiq_sys_ctx_t* ctx, const
 Uapi_HdrExpAttrV2_t hdrExpAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

Установка параметров HDR AE, включая ручное/автоматическое соотношение экспозиций и регулировку яркости Evbias.

 Uapi_HdrExpAttrV2_t HdrExpAttr;
 memset(&HdrExpAttr,0,sizeof(Uapi_HdrExpAttrV2_t));
 ret = rk_aiq_user_api2_ae_getHdrExpAttr(ctx, &HdrExpAttr);
 //set hdr mframe params
 int len = 8;
 float explevel[8] = {0, 0.096, 0.192, 0.384, 0.96, 1.344, 1.92, 3};
 float setpoint[8] = {50, 45, 40, 35, 30, 25, 20, 15};
 HdrExpAttr.HdrAEAttr.MframeCtrl.MExpLevel_len = len;
 HdrExpAttr.HdrAEAttr.MframeCtrl.MSetPoint_len = len;
 HdrExpAttr.HdrAEAttr.MframeCtrl.MExpLevel = explevel;
 HdrExpAttr.HdrAEAttr.MframeCtrl.MSetPoint = setpoint;
 //set ExpRatioType (AUTO/FIX)
 HdrExpAttr.ExpRatioCtrl.ExpRatioType = AECV2_HDR_RATIOTYPE_MODE_AUTO;
 //set Evbias
 HdrExpAttr.Evbias = -100.0f;
 ret = rk_aiq_user_api2_ae_setHdrExpAttr(ctx, HdrExpAttr);

6.6.10 rk_aiq_user_api2_ae_getHdrExpAttr

【Описание】Получение параметров экспозиции AE в режиме HDR.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getHdrExpAttr(const rk_aiq_sys_ctx_t* ctx,
 Uapi_HdrExpAttrV2_t* pHdrExpAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.11 rk_aiq_user_api2_ae_setIrisAttr

【Описание】Установка параметров управления диафрагмой AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setIrisAttr(const rk_aiq_sys_ctx_t * sys_ctx, const
 Uapi_IrisAttrV2_t irisAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

 Uapi_IrisAttrV2_t irisAttr;
 ret = rk_aiq_user_api2_ae_getIrisAttr(ctx, &irisAttr);
 irisAttr.enable = true; /*run AIris*/
 //set P-iris attributes
 irisAttr.IrisType = IRIS_P_TYPE;
 irisAttr.PIrisAttr.TotalStep = 81;
 irisAttr.PIrisAttr.EffcStep = 44;
 irisAttr.PIrisAttr.ZeroIsMax = true;
 uint16_t StepTable[1024] = {512, 511, 506, 499, 491, 483, 474, 465, 456,
                             446, 437, 427, 417, 408, 398, 388, 378, 368,
                             359, 349, 339, 329, 319, 309, 300, 290, 280,
                             271, 261, 252, 242, 233, 224, 214, 205, 196,
                             187, 178, 170, 161, 153, 144, 136, 128, 120,
                             112, 105, 98, 90, 83, 77, 70, 64, 58,
                             52, 46, 41, 36, 31, 27, 23, 19, 16,
                             13, 10, 8, 6, 4, 3, 1, 1, 0,
                             0, 0, 0, 0, 0, 0, 0, 0, 0};
 memcpy(irisAttr.PIrisAttr.StepTable,StepTable,sizeof(irisAttr.PIrisAttr.StepTable
 ));
 ret = rk_aiq_user_api2_ae_setIrisAttr(ctx, irisAttr);
 //set DC-iris attributes
 irisAttr.IrisType = IRIS_DC_TYPE;
 irisAttr.DCIrisAttr.Kp= 0.5f;
 irisAttr.DCIrisAttr.Ki= 0.2f;
 irisAttr.DCIrisAttr.Kd = 0.3f;
 irisAttr.DCIrisAttr.OpenPwmDuty = 40;
 irisAttr.DCIrisAttr.ClosePwmDuty = 22;
 irisAttr.DCIrisAttr.MinPwmDuty = 0;
 irisAttr.DCIrisAttr.MaxPwmDuty = 100;
 ret = rk_aiq_user_api2_ae_setIrisAttr(ctx, irisAttr);
 //set manual iris with auto ae
 irisAttr.IrisOpType = RK_AIQ_OP_MODE_MANUAL;
 if(irisAttr.IrisType == IRIS_P_TYPE);
     irisAttr.ManualAttr.PIrisGainValue = 512; /*p-iris F#=1.4*/
 if(irisAttr.IrisType == IRIS_DC_TYPE);
     irisAttr.ManualAttr.DCIrisHoldValue = 20; /*dc-iris PwmDuty=20*/
 ret = rk_aiq_user_api2_ae_setIrisAttr(ctx, irisAttr);

6.6.12 rk_aiq_user_api2_ae_getIrisAttr

【Описание】Получение параметров управления диафрагмой AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getIrisAttr(const rk_aiq_sys_ctx_t * sys_ctx, const
 Uapi_IrisAttrV2_t* irisAttr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.13 rk_aiq_user_api2_ae_setExpWinAttr

【Описание】Установка атрибутов окна статистики AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_setExpWinAttr(const rk_aiq_sys_ctx_t* sys_ctx, const
 Uapi_ExpWin_t ExpWin);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

【Пример】

Измените координаты статистики AE по положению лица для измерения яркости его области.

Примечание: при настройке координат обеспечьте ExpWin.h_offs+ExpWin.h_size<=pic_width и ExpWin.v_offs+ExpWin.v_size<=pic_height.

 Uapi_ExpWin_t ExpWin;
 //Suppose the sensor resolution is 2688X1520, the lateral offset of the face from the upper left corner of the screen is 100 pixel, the vertical offset is 100 pixel, and the face size is a square with a side length of 100 pixel
 ExpWin.h_offs=100;
 ExpWin.v_offs=100;
 ExpWin.h_size=100;
 ExpWin.v_size=100;
 rk_aiq_user_api2_ae_setExpWinAttr(ctx, ExpWin);

6.6.14 rk_aiq_user_api2_ae_getExpWinAttr

【Описание】Получение атрибутов окна статистики AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_getExpWinAttr(const rk_aiq_sys_ctx_t* sys_ctx,const
 Uapi_ExpWin_t* ExpWin);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.6.15 rk_aiq_user_api2_ae_queryExpResInfo

【Описание】Получение внутренних состояний AE.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_ae_queryExpResInfo(const rk_aiq_sys_ctx_t* ctx,
 Uapi_ExpQueryInfo_t* pExpResInfo);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочные файлы: rk_aiq_user_api2_ae.h, rk_aiq_uapi2_ae_int.h

Библиотека: librkaiq.so

6.7 Типы данных модульного API

6.7.1 Uapi_ExpSwAttr_t

【Описание】

Структура параметров управления общими функциями AE.

【Определение】

 typedef struct Uapi_ExpSwAttrV2_s {
     rk_aiq_uapi_sync_t                 sync;
     uint8_t                            Enable;
     CalibDb_CamRawStatsModeV2_t        RawStatsMode;
     CalibDb_CamHistStatsModeV2_t       HistStatsMode;
     CalibDb_CamYRangeModeV2_t          YRangeMode;
     uint8_t                            AecRunInterval;
     RKAiqOPMode_t                      AecOpType;
     Cam15x15UCharMatrix_t              GridWeights;
     Uapi_AeAttrV2_t                    stAuto;
     Uapi_MeAttrV2_t                    stManual;
     Uapi_ExpSwAttr_AdvancedV2_t        stAdvanced;
 } Uapi_ExpSwAttrV2_t;

【Члены】

Связанные типы данных

rk_aiq_uapi_sync_t

Uapi_ExpSwAttr_AdvancedV2_t

Uapi_AeAttrV2_t

Uapi_MeAttrV2_t

6.7.1.1 Uapi_ExpSwAttr_AdvancedV2_t

【Описание】

Приоритет параметров структуры.

【Определение】

 typedef struct Aec_uapi_advanced_attr_s {
     bool                          enable;
     uint8_t                       GridWeights[15 * 15];
     bool                          SetAeRangeEn;
     Aec_LinAeRange_t              SetLinAeRange;
     Aec_HdrAeRange_t              SetHdrAeRange;
 } Aec_uapi_advanced_attr_t;
 typedef Aec_uapi_advanced_attr_t Uapi_ExpSwAttr_AdvancedV2_t;

【Члены】

【Меры предосторожности】

Uapi_ExpSwAttrV2_t содержит веса AE 15X15, которые алгоритм разворачивает под фактическое количество аппаратных весов. Для экспозиции лица и подобных областей можно использовать веса 15X15 из Uapi_ExpSwAttr_AdvancedV2_t; алгоритм сжимает их под аппаратную конфигурацию. Для использования весов Uapi_ExpSwAttr_Advanced_t установите enable в 1. В последнем имени типа исходника отсутствует V2; оно сохранено.

Для задания диапазона AE через API установите SetAeRangeEn в 1; иначе используются диапазоны файла настройки. Для разных режимов предусмотрены SetLinAeRange и SetHdrAeRange; последний задаёт диапазоны для каждого кадра. Окончательные действующие диапазоны выдержки и усиления запрашивают в stAuto: здесь хранятся только заданные, не окончательные диапазоны.

6.7.1.1.1 Aec_AeRange_t

【Описание】Определение диапазона параметров AE.

【Определение】

 typedef struct Aec_AeRange_s {
     float                   Min;
     float                   Max;
 } Aec_AeRange_t;

【Члены】

6.7.1.1.2 Aec_LinAeRange_t

【Описание】Определение диапазонов AE в линейном режиме.

【Определение】

 typedef struct Aec_LinAeRange_s {
     Aec_AeRange_t      stExpTimeRange;
     Aec_AeRange_t      stGainRange;
     Aec_AeRange_t      stIspDGainRange;
     Aec_AeRange_t      stPIrisRange;
 } Aec_LinAeRange_t;

【Члены】

【Меры предосторожности】

Если максимум/минимум компонента равен исходному 0, заданный диапазон не действует; фактические границы определяются узлами маршрута разложения экспозиции AecRoute.

При ненулевых максимуме/минимуме заданный диапазон действует. Если ограничения sensor/ISP не превышены, фактические границы равны заданным и соответствующим образом корректируются узлы AecRoute. При превышении ограничений используются максимум/минимум узлов AecRoute.

6.7.1.1.3 Aec_HdrAeRange_t

【Описание】Определение диапазонов AE в режиме HDR.

【Определение】

 typedef struct Aec_HdrAeRange_s {
     Aec_AeRange_t      stExpTimeRange[3];
     Aec_AeRange_t      stGainRange[3];
     Aec_AeRange_t      stIspDGainRange[3];
     Aec_AeRange_t      stPIrisRange;
 } Aec_HdrAeRange_t;

【Члены】

【Меры предосторожности】

stExpTimeRange, stGainRange и stIspDGainRange — массивы из трёх элементов. В двухкадровом HDR действуют только 0 и 1 для короткого и длинного кадров; в трёхкадровом — 0–2 для короткого, среднего и длинного.

При исходных нулевых максимуме/минимуме заданный диапазон не действует; фактические границы определяются узлами маршрута разложения экспозиции после коррекции алгоритмом.

При ненулевых максимуме/минимуме заданный диапазон действует. Если ограничения sensor/ISP не превышены, фактические границы равны заданным, а границы узлов маршрута разложения экспозиции корректируются под них; при превышении ограничений sensor/ISP

фактические границы определяются максимумом/минимумом узлов маршрута разложения экспозиции. Платформа 1106 пока не поддерживает isp dgain, поэтому stIspDGainRange временно не действует.

6.7.1.2 Uapi_AeAttrV2_t

【Описание】Определение атрибутов автоматической экспозиции AE.

【Определение】

 typedef struct Uapi_AeAttrV2_s {
     Uapi_AeSpeedV2_t           stAeSpeed;
     DelayFrmNum
     uint8_t                    BlackDelayFrame;
     uint8_t                    WhiteDelayFrame;
     Auto/Fixed fps
     Uapi_AeFpsAttrV2_t         stFrmRate;
     Uapi_AntiFlickerV2_t       stAntiFlicker;
     auto range
     Aec_LinAeRange_t           LinAeRange;//result LinAerange
     Aec_HdrAeRange_t           HdrAeRange;//result HdrAerange
 } Uapi_AeAttrV2_t;

【Члены】

【Меры предосторожности】

LinAeRange/HdrAeRange — фактически используемые диапазоны после внутренней проверки и коррекции. Если заданный API диапазон превышает ограничения sensor, применяются ограничения sensor. Они описаны в параметре sensorinfo модуля AE документа Rockchip_Tuning_Guide_ISP30_CN.pdf, на который ссылается исходник.

Чтобы задать диапазоны компонентов AE, используйте параметры Uapi_ExpSwAttr_AdvancedV2_t и SetAeRangeEn = 1; иначе действуют диапазоны файла настройки.

6.7.1.2.1 Uapi_AeSpeedV2_t

【Описание】Определение скоростей регулировки AE.

【Определение】

 typedef struct CalibDb_AeSpeedV2_s {
     float                   DampOver;
     float                   DampUnder;
     float                   DampDark2Bright;
     float                   DampBright2Dark;
 } CalibDb_AeSpeedV2_t;
 typedef CalibDb_AeSpeedV2_t Uapi_AeSpeedV2_t;

【Члены】

6.7.1.2.2 Uapi_AeFpsAttrV2_t

【Описание】Определение частоты кадров AE.

【Определение】

 typedef struct CalibDb_AeFrmRateAttrV2_s {
     bool             isFpsFix;
     uint8_t          FpsValue;
 } CalibDb_AeFrmRateAttrV2_t;
 typedef CalibDb_AeFrmRateAttrV2_t Uapi_AeFpsAttrV2_t;

【Члены】

6.7.1.2.3 Uapi_AntiFlickerV2_t

【Описание】Определение атрибутов подавления мерцания.

【Определение】

 typedef struct CalibDb_AntiFlickerAttrV2_s {
     bool                           enable;
     CalibDb_FlickerFreq_t          Frequency;
     CalibDb_AntiFlickerMode_t      Mode;
 } CalibDb_AntiFlickerAttrV2_t;
 typedef CalibDb_AntiFlickerAttrV2_t Uapi_AntiFlickerV2_t;

【Члены】

【Меры предосторожности】

Для выключения установите enable = 0; алгоритм задаст Frequency=AECV2_FLICKER_FREQUENCY_OFF. Если enable = 1, значение частоты OFF недействительно и заменяется исходным AECV2_FLICKER_FREQUENCY_50HZ.

В обычном режиме AECV2_ANTIFLICKER_NORMAL_MODE выдержка меняется с яркостью, но её минимум фиксирован: 1/120 sec (60Hz) или 1/100 sec (50Hz); исходник указывает отсутствие ограничения «минимальной выдержкой».

При освещении выдержка согласуется с частотой источника, предотвращая мерцание.

При высокой яркости нужна более короткая выдержка. Ограничение минимальной выдержки обычного режима может привести к пересвету. Автоматический AECV2_ANTIFLICKER_AUTO_MODE меняет выдержку по яркости вплоть до минимума sensor. Основное отличие проявляется при высокой яркости: можно подавить пересвет, однако защита от мерцания тогда не действует.

6.7.1.3 Uapi_MeAttrV2_t

【Описание】

Ручные параметры экспозиции разделены на LinearAE и HdrAE.

【Определение】

 typedef struct Uapi_MeAttrV2_s {
     Uapi_LinMeAttrV2_t     stLinMe;
     Uapi_HdrMeAttrV2_t     stHdrMe;
 } Uapi_MeAttrV2_t;

【Связанные типы данных】

Uapi_LinMeAttrV2_t

Uapi_HdrMeAttrV2_t

6.7.1.3.1 Uapi_LinMeAttrV2_t

【Описание】

Параметры ручного управления экспозицией LinearAE.

【Определение】

 typedef struct Uapi_LinMeAttrV2_s {
     bool                 ManualTimeEn;
     bool                 ManualGainEn;
     bool                 ManualIspDgainEn;
     float                TimeValue;
     float                GainValue;
     float                IspDGainValue;
 } Uapi_LinMeAttrV2_t;

【Члены】

【Меры предосторожности】

Действует только при AeOptype = MANUAL. Если ManualTimeEn, ManualGainEn и ManualIspDgainEn равны 1, режим ручной; при отключении любого — полуавтоматический. Далее исходник говорит о «всех четырёх, равных 0»: это приравнивается к автоматическому режиму с сообщением об ошибке; несоответствие количества сохранено.

В ручном/полуручном режиме выдержка и усиление ограничены границами автоматического режима; при выходе за них используются соответствующие границы автоматического режима.

RK356X не поддерживает цифровое усиление ISP; ManualIspDgainEn и IspDGainValue не действуют.

6.7.1.3.2 Uapi_HdrMeAttrV2_t

【Описание】

Параметры ручного управления экспозицией HdrAE.

【Определение】

 typedef struct Uapi_HdrMeAttrV2_s {
     bool                    ManualTimeEn;
     bool                    ManualGainEn;
     bool                    ManualIspDgainEn;
     Cam3x1FloatMatrix_t     TimeValue;
     Cam3x1FloatMatrix_t     GainValue;
     Cam3x1FloatMatrix_t     IspDGainValue;
 } Uapi_HdrMeAttrV2_t;

【Члены】

Значения переменных совпадают с Uapi_LinMeAttrV2_t.

【Меры предосторожности】

TimeValue/GainValue/IspDGainValue — массивы из трёх элементов. В двухкадровом HDR действуют [0-1] для короткого и длинного кадров; в трёхкадровом — [0-2] для короткого, среднего и длинного.

В ручном/полуручном режиме выдержка и усиление ограничены границами автоматического режима; при выходе за них используются соответствующие границы автоматического режима.

RK356X пока не поддерживает цифровое усиление ISP; ManualIspDgainEn и IspDGainValue не действуют.

6.7.2 Uapi_LinAeRouteAttr_t

【Описание】Определение атрибутов маршрута разложения линейной экспозиции AE.

【Определение】

 typedef struct CalibDb_LinAeRoute_AttrV2_s {
     float* TimeDot;
     int TimeDot_len;
     float* GainDot;
     int GainDot_len;
     float* IspDGainDot;
     int IspDGainDot_len;
     int* PIrisDot;
     int PIrisDot_len;
 } CalibDb_LinAeRoute_AttrV2_t;
 typedef struct Uapi_LinAeRouteAttr_s {
   rk_aiq_uapi_sync_t            sync;
   CalibDb_LinAeRoute_AttrV2_t   Params;
 } Uapi_LinAeRouteAttr_t;

【Члены】

【Меры предосторожности】

Число узлов кривой не ограничено, рекомендуется не менее 6.

Экспозиция узла — произведение выдержки, усиления sensor, цифрового усиления ISP, эквивалентного усиления диафрагмы и других компонентов. Она должна монотонно возрастать: следующий узел больше предыдущего. Далее исходник говорит: «у первого узла минимальная экспозиция, у второго — максимальная»; сомнительное соответствие многоузловому описанию сохранено.

Выдержка узла задаётся в секундах, допускается минимум 0; код корректирует фактическую минимальную выдержку по ограничениям sensor.

Компонент диафрагмы поддерживает только P-Iris, но не DC-Iris. Эквивалентное усиление P-iris действует лишь при включённом автоматическом Airis; иначе диафрагма фиксирована в начальном положении. Расчёт описан в AecIrisCtrl.

Заданные узлы не являются окончательным маршрутом. Фактические границы компонентов определяются совместно узлами и вручную настроенными пределами. Сначала выполняется первая коррекция границ узлов:

Если ограничения SENSOR/ISP не превышены, границы узлов не меняются; иначе ограничиваются возможностями SENSOR/ISP. При нулевых ручных границах действует результат первой коррекции. При ненулевых ручных границах в допустимых пределах выполняется вторая коррекция по ручному диапазону; если ручные границы превышают ограничения, сохраняется результат первой коррекции. Между соседними узлами увеличивают только один компонент при фиксированных остальных. Этот компонент задаёт стратегию участка: например, увеличение только усиления означает его приоритет.

RK356X пока не поддерживает цифровое усиление ISP, поэтому IspgainDot не действует.

6.7.3 Uapi_HdrAeRouteAttr_t

【Описание】Определение атрибутов маршрута разложения HDR-экспозиции AE.

【Определение】

 typedef struct CalibDb_HdrAeRoute_AttrV2_s {
     float* Frm0TimeDot;
     int Frm0TimeDot_len;
     float* Frm0GainDot;
     int Frm0GainDot_len;
     float* Frm0IspDGainDot;
     int Frm0IspDGainDot_len;
     float* Frm1TimeDot;
     int Frm1TimeDot_len;
     float* Frm1GainDot;
     int Frm1GainDot_len;
     float* Frm1IspDGainDot;
     int Frm1IspDGainDot_len;
     float* Frm2TimeDot;
     int Frm2TimeDot_len;
     float* Frm2GainDot;
     int Frm2GainDot_len;
     float* Frm2IspDGainDot;
     int Frm2IspDGainDot_len;
     int* PIrisDot;
     int PIrisDot_len;
 } CalibDb_HdrAeRoute_AttV2r_t;
 typedef struct Uapi_HdrAeRouteAttr_s {
   rk_aiq_uapi_sync_t            sync;
   CalibDb_HdrAeRoute_AttrV2_t   Params;
 } Uapi_HdrAeRouteAttr_t;

【Поля】

【Меры предосторожности】

Число узлов не ограничено; рекомендуется не менее 6 для плавного разложения экспозиции.

В двухкадровом HDR задаются Frm0/1TimeDot, Frm0/1GainDot и Frm0/1IspDGainDot для короткого и длинного кадров. В трёхкадровом — Frm0/1/2TimeDot, Frm0/1/2GainDot и Frm0/1/2IspDGainDot для короткого, среднего и длинного. Распределяйте выдержки разумно: их сумма не должна превышать максимум, допускаемый частотой кадров!

Экспозиция узла — произведение выдержки, усиления sensor, цифрового усиления ISP, эквивалентного усиления диафрагмы и других компонентов. Она должна монотонно возрастать: следующий узел больше предыдущего. Далее исходник говорит: «у первого узла минимальная экспозиция, у второго — максимальная»; сомнительное соответствие многоузловому описанию сохранено.

Выдержка узла задаётся в секундах, допускается минимум 0; код корректирует фактическую минимальную выдержку по ограничениям sensor.

Компонент диафрагмы поддерживает только P-Iris, но не DC-Iris. Эквивалентное усиление P-iris действует лишь при включённом автоматическом Airis; иначе диафрагма фиксирована в начальном положении. Расчёт описан в AecIrisCtrl.

Заданные узлы не являются окончательным маршрутом: границы компонентов зависят и от узлов, и от ручных пределов. Сначала границы узлов проверяются: в пределах SENSOR/ISP остаются прежними, иначе ограничиваются аппаратурой. При нулевых ручных границах действует первая коррекция; при ненулевых допустимых границах выполняется

вторая коррекция по ручному диапазону. Если ручные границы превышают ограничения, действует первая коррекция. При росте экспозиции соседних узлов увеличивают один компонент, фиксируя остальные. Этот компонент определяет стратегию участка: например, увеличение только усиления задаёт его приоритет.

356X пока не поддерживает цифровое усиление ISP; Frm0/1/2ispDGainDot не действуют.

6.7.4 Uapi_LinExpAttrV2_t

【Описание】

Определение параметров настройки линейной экспозиции AE.

【Определение】

 typedef struct CalibDb_LinearAE_AttrV2_s {
     uint8_t RawStatsEn;
     float ToleranceIn;
     float ToleranceOut;
     float Evbias;
     CalibDb_AeStrategyModeV2_t      StrategyMode;
     CalibDb_LinExpInitExpV2_t       InitExp;
     CalibDb_LinAeRoute_AttrV2_t     Route;
     CalibDb_AecDynamicSetpointV2_t  DySetpoint;
     CalibDb_AecBacklightV2_t        BackLightCtrl;
     CalibDb_AecOverExpCtrlV2_t OverExpCtrl;
 } CalibDb_LinearAE_AttrV2_t;
 typedef struct Uapi_LinExpAttrV2_s {
   rk_aiq_uapi_sync_t            sync;
   CalibDb_LinearAE_AttrV2_t     Params;
 } Uapi_LinExpAttrV2_t;

【Члены】

【Меры предосторожности】

EvBias корректирует целевую яркость SetPoint/IRSetPoint (фиксированную или динамическую) для особых сцен. Действующая цель равна (SetPoint)*[1+abs(EvBias)/100]^[EvBias/abs(EvBias)]. При EvBias=100 она вдвое выше исходной, при EvBias=-100 — вдвое ниже.

Допуск яркости AE задаётся Tolerance. После сходимости B должна находиться в [действующая целевая яркость X(1-Tolerance/100), действующая целевая яркость X(1+Tolerance/100)]. Большие ToleranceIn/Out влияют на скорость реакции и действие EvBias; если шаг EvBias меньше ToleranceIn/Out, коррекция яркости может не проявиться.

StrategyMode пока не действует.

【Связанные типы данных】

CalibDb_AecDynamicSetpointV2_t

CalibDb_AecBacklightV2_t

CalibDb_AecOverExpCtrlV2_t

6.7.4.1 CalibDb_AecDynamicSetpointV2_t

【Описание】Определение динамических целевых значений AE.

【Определение】

 typedef struct CalibDb_AecDynamicSetpointV2_s {
     float* ExpLevel;
     int ExpLevel_len;
     float* DySetpoint;
     int DySetpoint_len;
 } CalibDb_AecDynamicSetpointV2_t;

【Члены】

6.7.5 Uapi_HdrExpAttrV2_t

【Описание】Определение параметров настройки HDR-экспозиции AE.

【Определение】

 typedef struct CalibDb_HdrAE_AttrV2_s {
     float ToleranceIn;
     float ToleranceOut;
     float Evbias;
     CalibDb_AeStrategyModeV2_t StrategyMode;
     float LumaDistTh; //used for area-growing
     CalibDb_HdrExpInitExpV2_t InitExp;
     CalibDb_HdrAeRoute_AttrV2_t Route;
     CalibDb_ExpRatioCtrlV2_t ExpRatioCtrl;
     CalibDb_LongFrmCtrlV2_t LongFrmMode;
     CalibDb_LfrmCtrlV2_t LframeCtrl;
     CalibDb_MfrmCtrlV2_t MframeCtrl;
     CalibDb_SfrmCtrlV2_t SframeCtrl;
 } CalibDb_HdrAE_AttrV2_t;
 typedef struct Uapi_HdrExpAttrV2_s {
   rk_aiq_uapi_sync_t            sync;
   CalibDb_HdrAE_AttrV2_t        Params;
 } Uapi_HdrExpAttrV2_t;

【Члены】

【Связанные типы данных】

CalibDb_LFrameCtrlV2_t

CalibDb_MFrameCtrlV2_t

CalibDb_SFrameCtrlV2_t

6.7.6 Uapi_IrisAttrV2_t

【Описание】

Параметры управления диафрагмой.

【Определение】

 typedef struct CalibDb_AecIrisCtrlV2_s {
     uint8_t Enable;
     CalibDb_IrisTypeV2_t IrisType;
     RKAiqOPMode_t IrisOpType;
     CalibDb_MIris_AttrV2_t ManualAttr;
     CalibDb_PIris_AttrV2_t PIrisAttr;
     CalibDb_DCIris_AttrV2_t DCIrisAttr;
 } CalibDb_AecIrisCtrlV2_t;
 typedef struct Uapi_IrisAttrV2_s {
   rk_aiq_uapi_sync_t            sync;
   CalibDb_AecIrisCtrlV2_t       Params;
 } Uapi_IrisAttrV2_t;

【Члены】

6.7.6.1 CalibDb_MIris_AttrV2_t

【Описание】

Параметры ручного управления диафрагмой.

【Определение】

 typedef struct CalibDb_MIris_AttrV2_s {
     int PIrisGainValue;
     int DCIrisHoldValue;
 } CalibDb_MIris_AttrV2_t;

【Члены】

【Меры предосторожности】

Ручное управление включается при IrisOpType = RK_AIQ_OP_MODE_MANUAL. Для P-диафрагмы действует только PirisGainValue, для DC — только DCIrisHoldValue.

DCIrisHoldValue непосредственно задаёт PWM двигателя в ручном режиме, диапазон [0,100]. При HoldValue между ClosePwmDuty и OpenPwmDuty из AecIrisCtrl размер сохраняется. Выше OpenPwmDuty диафрагма открывается тем быстрее, чем больше значение; ниже ClosePwmDuty закрывается тем быстрее, чем меньше значение.

6.7.6.2 CalibDb_PIris_AttrV2_t

【Описание】

Атрибуты P-диафрагмы.

【Определение】

 #define AEC_PIRIS_STAP_TABLE_MAX (1024)
 typedef struct CalibDb_PIris_AttrV2_s {
     uint16_t              TotalStep;
     uint16_t              EffcStep;
     bool                  ZeroIsMax;
     uint16_t              StepTable[AEC_PIRIS_STAP_TABLE_MAX];
 } CalibDb_PIris_AttrV2_t;

【Члены】

6.7.6.3 CalibDb_DCIris_AttrV2_t

【Описание】

Атрибуты DC-диафрагмы.

【Определение】

 typedef struct CalibDb_DCIris_AttrV2_s {
     float       Kp;
     float       Ki;
     float       Kd;
     int         MinPwmDuty;
     int         MaxPwmDuty;
     int         OpenPwmDuty;
     int         ClosePwmDuty;
 } CalibDb_DCIris_AttrV2_t;

【Члены】

【Меры предосторожности】

При выключении автоматической диафрагмы DC-iris по умолчанию полностью открывается, P-iris переходит в положение максимального отверстия. Изменить эти начальные положения можно через InitPIrisGainValue и InitDCIrisDutyValue модуля AecInitValue.

Основной процесс алгоритма автоматической диафрагмы Airis:

Для DC-iris алгоритм Airis управляет отверстием по отклонению яркости от цели. Когда экспозиция минимальна, но яркость превышает целевой допуск, управление AE прекращается, выдержка и усиление фиксируются, включается AIRIS. Если яркость стабильна и PWM DC-iris

превышает OpenPwmDuty, диафрагма считается полностью открытой; Airis завершается и возвращает управление AE.

P-iris управляется через AecRoute: размер отверстия преобразуется в эквивалентное усиление для разложения экспозиции.

StepTable обычно строят по соответствию положения двигателя и отверстия, предоставленному производителем. AecRoute AE переводит отверстие в эквивалентное усиление, поэтому требуется хорошая линейность P-iris. Диапазон усиления [1,1024]: F1.0 соответствует 1024, F1.4 — 512, далее до F32.0 — 1. Пересчитайте отверстия в усиления и заполните StepTable в порядке положений step0, step1…stepN.

TotalStep — полное число шагов двигателя, зависящее от объектива. EffcStep — число используемых шагов, обычно меньше TotalStep. Возле закрытого конца ошибка эквивалентного усиления велика и возможны колебания, поэтому эти положения обычно не используются.

Таблица 4-1 связывает положение двигателя, отверстие и усиление для примера StepTable. Соответствия положения и площади в столбцах 1–2 и 4–5 предоставлены производителем объектива. У него 81 шаг; step0 соответствует максимальному отверстию F1.4 и усилению 512. Для step3 площадь 195.869 даёт усиление = 512* (195.869/201.062)=499 после округления. Остальные значения рассчитываются аналогично. Далее исходник ссылается на «таблицу 1-1»: у закрытого конца площадь может быть в тысячи раз меньше максимальной, ошибка усиления велика; такие положения не рекомендуется использовать из-за колебаний экспозиции. Заполните StepTable усилениями в порядке step0, step1…stepN. Различие ссылок на таблицу сохранено.

OpenPwmDuty и ClosePwmDuty измеряют для конкретного DC-iris объектива. Некоторые объективы открываются выше OpenPwmDuty. Далее исходник говорит о закрытии ниже OpenPwmDuty, но затем определяет ClosePwmDuty <= PWM <= OpenPwmDuty как область удержания HoldValue; противоречие не исправлено молча. У других объективов один порог: выше — открытие, ниже — закрытие, на пороге — удержание. Тогда ClosePwmDuty = OpenPwmDuty = HoldValue.

Настройка ручной диафрагмы аналогична ручной экспозиции: AecOpType перевести в ручной режим и включить AecManualCtrl.ManualIrisEn. Исходник дважды указывает IrisType = P-iris, связывая его сначала только с PirisGainValue, затем только с DCIrisValue. Противоречивое условие типа сохранено и требует проверки перед применением.

Таблица 4-1. Положение двигателя P-iris, площадь отверстия и эквивалентное усиление

6.7.7 Uapi_ExpWin_t

【Описание】Определение атрибутов окна статистики AE.

【Определение】

 typedef struct window {
     uint16_t h_offs;
     uint16_t v_offs;
     uint16_t h_size;
     uint16_t v_size;
 } window_t;
 typedef struct Uapi_ExpWin_s {
   rk_aiq_uapi_sync_t            sync;
   window                        Params;
 } Uapi_ExpWin_t;

【Члены】

6.7.8 Uapi_ExpQueryInfo_t

【Описание】Определение запроса параметров экспозиции AE.

【Определение】

 typedef struct Uapi_ExpQueryInfo_s {
     bool              IsConverged;
     bool              IsExpMax;
     float             LumaDeviation;
     float             HdrLumaDeviation[3];
     float             MeanLuma;
     float             HdrMeanLuma[3];
     float             GlobalEnvLux;
     float             BlockEnvLux[ISP2_RAWAE_WINNUM_MAX];
     RKAiqAecExpInfo_t CurExpInfo;
     unsigned short    Piris;
     float             LinePeriodsPerField;
     float             PixelPeriodsPerLine;
     float             PixelClockFreqMHZ;
 } Uapi_ExpQueryInfo_t;

【Члены】

6.8 Поиск проблем и отладка

При мерцании яркости, перерегулировании или несоответствии ожидаемой яркости рекомендуется записать AE LOG проблемной сцены для быстрого анализа.

6.8.1 Тест синхронизации экспозиции и статистики

Перед калибровкой ISP разработчик драйвера или настройщик должен заполнить SensorInfo в IQ XML. Ошибки этих параметров экспозиции могут вызвать неправильную экспозицию, мерцание и другие проблемы. После настройки рекомендуется самопроверка SyncTest; параметры описаны в Rockchip_Tuning_Guide_ISP30.

SyncTest циклически задаёт N наборов экспозиций для проверки кадров вступления в силу выдержки, усиления sensor и переключения DCG. Он также проверяет линейность и правильность формул преобразования регистров выдержки/усиления и связанных параметров.

Параметры SyncTest:

【Описание】

Тест синхронизации циклически задаёт N экспозиций через заданное число кадров, проверяя кадры вступления в силу выдержки/усиления и настройки экспозиции sensor.

【Члены】

AlterExp

Два набора по режиму: LinearAE и HdrAE.

В исходном примере LOG приведены только ключевые сведения. Красная рамка отмечает переключение экспозиции. Если яркость соответствует экспозиции без задержки, опережения и нарушения линейности, sensorinfo предварительно можно считать настроенным правильно.

6.8.2 Мерцание при изменении экспозиции

Возможные причины мерцания при изменении экспозиции:

(1) Неверные кадры вступления в силу gain/time в CISExpUpdate. В примере LOG показаны только ключевые строки каждого кадра.

Красная рамка показывает ошибочную яркость: она изменяется противоположно росту/снижению экспозиции. Резкий скачок приходится на второй кадр после изменения выдержки и усиления и следует выдержке. Это указывает на неверные кадры вступления в силу gain/time: они действуют не одновременно, нарушая соответствие яркости и экспозиции. Исправьте число кадров gain/time. Для воспроизведения используйте AE syncTest

с двумя наборами различных усилений/выдержек, переключая их и проверяя воспроизведение по LOG.

(2) Ошибка драйвера вызывает колебания яркости без сходимости, часто при ярком освещении. В LOG приведены ключевые строки кадров.

На рисунке выдержка колеблется между 59ms и 44ms; отношение средних яркостей сильно отличается от отношения экспозиций, что указывает на нелинейность. Сначала выведите регистр экспозиции в драйвере sensor и сравните с LOG. Для проверки переключайте через syncTest несколько экспозиций, включая проблемную, и анализируйте линейность яркости по кадрам LOG.

(3) Мерцание вызывается модулями после AE. В примере LOG показаны ключевые строки кадров.

В левом LOG при снижении SMeanLuma и MMeanLuma меняется яркость выхода TmoMeanluma; в таком случае требуется отладка TMO.

7. AWB

7.1 Обзор

AWB изменяет усиления цветовых каналов камеры, компенсируя цветовую температуру среды и собственное различие усилений устройства, чтобы изображение верно передавало цвет объекта.

7.2 Основные понятия

Цветовая температура определяется через абсолютное чёрное тело: если излучение источника в видимом диапазоне совпадает с ним, температура этого тела называется цветовой температурой источника.

Баланс белого: при разных цветовых температурах белый на sensor может выглядеть синеватым или красноватым. Алгоритм регулирует R, G и B для реалистичного белого.

7.3 Описание функций

AWB состоит из статистики WB и алгоритма управления балансом белого.

7.4 Справочник функционального API

7.4.1 rk_aiq_uapi2_setWBMode

【Описание】Установка режима баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setWBMode(const rk_aiq_sys_ctx_t* ctx, opMode_t mode);

【Параметры】

【Возвращаемое значение】

【Примечание】

В ручном режиме усиление WB определяется текущими ручными параметрами. Для перехода в ручной режим с одновременным заданием усиления используйте rk_aiq_uapi2_setMWBGain.

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.2 rk_aiq_uapi2_getWBMode

【Описание】Получение режима баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getWBMode(const rk_aiq_sys_ctx_t* ctx, opMode_t *mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.3 rk_aiq_uapi2_lockAWB

【Описание】Блокировка текущих параметров WB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_lockAWB(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.4 rk_aiq_uapi2_unlockAWB

【Описание】Снятие блокировки параметров WB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_unlockAWB(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.5 rk_aiq_uapi2_setMWBScene

【Описание】Установка сцены баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setMWBScene(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_wb_scene_t scene);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.6 rk_aiq_uapi2_getMWBScene

【Описание】Получение сцены баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getMWBScene(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_wb_scene_t *scene);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.7 rk_aiq_uapi2_setMWBGain

【Описание】Установка коэффициентов ручного усиления WB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setMWBGain(const rk_aiq_sys_ctx_t* ctx, rk_aiq_wb_gain_t
 *gain);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.8 rk_aiq_uapi2_getWBGain

【Описание】Получение коэффициентов усиления WB для ручного и автоматического режимов.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getWBGain(const rk_aiq_sys_ctx_t* ctx, rk_aiq_wb_gain_t
 *gain);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.9 rk_aiq_uapi2_setMWBCT

【Описание】Установка цветовой температуры ручного WB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setMWBCT(const rk_aiq_sys_ctx_t* ctx, unsigned int ct);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.10 rk_aiq_uapi2_getWBCT

【Описание】Получение цветовой температуры WB в автоматическом и ручном режимах.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getWBCT(const rk_aiq_sys_ctx_t* ctx, unsigned int *ct);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.11 rk_aiq_uapi2_setAwbGainOffsetAttrib

【Описание】Установка смещения усиления AWB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAwbGainOffsetAttrib(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_uapiV2_wb_awb_wbGainOffset_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.12 rk_aiq_uapi2_getAwbGainOffsetAttrib

【Описание】Получение смещения усиления AWB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getAwbGainOffsetAttrib(const rk_aiq_sys_ctx_t* ctx,
 CalibDbV2_Awb_gain_offset_cfg_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.13 rk_aiq_uapi2_setAwbGainAdjustAttrib

【Описание】Установка коррекции цветового тона AWB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAwbGainAdjustAttrib(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_uapiV2_wb_awb_wbGainAdjust_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.14 rk_aiq_uapi2_getAwbGainAdjustAttrib

【Описание】Получение параметров коррекции тона AWB.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getAwbGainAdjustAttrib(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_uapiV2_wb_awb_wbGainAdjust_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.15 rk_aiq_uapi2_setAwbV30AllAttrib

【Описание】Установка всех параметров API баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setAwbV30AllAttrib(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_uapiV2_wbV30_attrib_t attr);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.4.16 rk_aiq_uapi2_getAwbV30AllAttrib

【Описание】Получение всех параметров API баланса белого.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getAwbV30AllAttrib(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_uapiV2_wbV30_attrib_t *attr);

【Параметр】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.5 Типы данных функционального API

7.5.1 rk_aiq_wb_op_mode_t

【Описание】Определение режима WB.

【Определение】

 typedef enum rk_aiq_wb_op_mode_s {
     RK_AIQ_WB_MODE_INVALID        = 0,
     RK_AIQ_WB_MODE_MANUAL         = 1,
     RK_AIQ_WB_MODE_AUTO           = 2,
     RK_AIQ_WB_MODE_MAX
 } rk_aiq_wb_op_mode_t;

【Члены】

7.5.2 rk_aiq_wb_mwb_mode_t

【Описание】Определение типа ручного режима WB.

【Определение】

 typedef enum rk_aiq_wb_mwb_mode_e {
     RK_AIQ_MWB_MODE_INVAILD              = 0,
     RK_AIQ_MWB_MODE_CCT                  = 1,
     RK_AIQ_MWB_MODE_WBGAIN               = 2,
     RK_AIQ_MWB_MODE_SCENE                = 3,
 } rk_aiq_wb_mwb_mode_t;

【Члены】

7.5.3 rk_aiq_wb_gain_t

【Описание】Определение параметров усиления WB.

【Определение】

 typedef struct rk_aiq_wb_gain_s {
     float rgain;
     float grgain;
     float gbgain;
     float bgain;
 } rk_aiq_wb_gain_t;

【Члены】

7.5.4 rk_aiq_wb_scene_t

【Описание】Определение параметров усиления WB.

【Определение】

 typedef enum rk_aiq_wb_scene_e {
     RK_AIQ_WBCT_INCANDESCENT = 0,
     RK_AIQ_WBCT_FLUORESCENT,
     RK_AIQ_WBCT_WARM_FLUORESCENT,
     RK_AIQ_WBCT_DAYLIGHT,
     RK_AIQ_WBCT_CLOUDY_DAYLIGHT,
     RK_AIQ_WBCT_TWILIGHT,
     RK_AIQ_WBCT_SHADE
 } rk_aiq_wb_scene_t;

【Члены】

7.5.5 rk_aiq_wb_cct_t

【Описание】Определение параметров усиления WB.

【Определение】

 typedef struct rk_aiq_wb_cct_s {
     float CCT;
     float CCRI;
 } rk_aiq_wb_cct_t;

【Члены】

7.5.6 rk_aiq_wb_mwb_attrib_t

【Описание】Определение атрибутов ручного WB.

【Определение】

 typedef struct rk_aiq_wb_mwb_attrib_s {
     rk_aiq_wb_mwb_mode_t mode;
     union MWBPara_u {
         rk_aiq_wb_gain_t gain;
         rk_aiq_wb_scene_t scene;
         rk_aiq_wb_cct_t cct;
     } para;
 } rk_aiq_wb_mwb_attrib_t;

【Члены】

7.5.7 rk_aiq_uapiV2_wb_awb_wbGainOffset_t

【Описание】Определение смещения усиления AWB.

【Определение】

 typedef struct rk_aiq_uapiV2_wb_awb_wbGainOffset_s{
   rk_aiq_uapi_sync_t sync;
   CalibDbV2_Awb_gain_offset_cfg_t gainOffset;
 }rk_aiq_uapiV2_wb_awb_wbGainOffset_t;

【Члены】

7.5.8 CalibDbV2_Awb_gain_offset_cfg_t

【Описание】Определение смещения усиления AWB.

【Определение】

 typedef struct CalibDbV2_Awb_gain_offset_cfg_s{
   bool enable;
   float offset[4];
 }CalibDbV2_Awb_gain_offset_cfg_t;

【Члены】

7.5.9 rk_aiq_uapiV2_wb_awb_wbGainAdjust_t

【Описание】Определение коррекции цветового тона AWB.

【Определение】

 typedef struct rk_aiq_uapiV2_wb_awb_wbGainAdjustLut_s {
   float lumaValue;
   int ct_grid_num;
   int cri_grid_num;
   float ct_in_range[2];//min,max, equal distance sapmle
   float cri_in_range[2];//min,max
   float *ct_lut_out;//size is ct_grid_num*cri_grid_num
   float *cri_lut_out;
 } rk_aiq_uapiV2_wb_awb_wbGainAdjustLut_t;
 typedef struct rk_aiq_uapiV2_wb_awb_wbGainAdjust_s {
   rk_aiq_uapi_sync_t sync;
   bool enable;
   rk_aiq_uapiV2_wb_awb_wbGainAdjustLut_t *lutAll;
   int lutAll_len;
 } rk_aiq_uapiV2_wb_awb_wbGainAdjust_t;

【Члены】

Подробнее см. раздел цветовой настройки WBGain в Rockchip_Color_Optimization_Guide.

7.5.10 rk_aiq_uapiV2_wbV30_awb_attrib_t

【Описание】Определение параметров API AWB.

【Определение】

 typedef struct rk_aiq_uapiV2_wbV30_awb_attrib_s {
     rk_aiq_uapiV2_wb_awb_wbGainAdjust_t wbGainAdjust;
     CalibDbV2_Awb_gain_offset_cfg_t wbGainOffset;
 } rk_aiq_uapiV2_wbV30_awb_attrib_t;

【Члены】

7.5.11 rk_aiq_uapiV2_wbV32_attrib_t

【Описание】Определение всех параметров API WB.

【Определение】

 typedef struct rk_aiq_uapiV2_wbV30_attrib_s {
     rk_aiq_uapi_sync_t sync;
     bool byPass;
     rk_aiq_wb_op_mode_t mode;
     rk_aiq_wb_mwb_attrib_t stManual;
     rk_aiq_uapiV2_wbV30_awb_attrib_t stAuto;
 } rk_aiq_uapiV2_wbV30_attrib_t;

【Члены】

7.6 Справочник модульного API

7.6.1 rk_aiq_user_api2_awbV30_SetAllAttrib

【Описание】Установка всех параметров API баланса белого.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awbV30_SetAllAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wbV30_attrib_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.2 rk_aiq_user_api2_awbV30_GetAllAttrib

【Описание】Получение всех параметров API WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awbV30_GetAllAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wbV30_attrib_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.3 rk_aiq_user_api2_awb_GetCCT

【Описание】Получение цветовой температуры WB в автоматическом и ручном режимах.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_GetCCT(const rk_aiq_sys_ctx_t* sys_ctx, rk_aiq_wb_cct_t
 *cct);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.4 rk_aiq_user_api2_awb_QueryWBInfo

【Описание】Получение усиления и цветовой температуры WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_QueryWBInfo(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_wb_querry_info_t *wb_querry_info);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.5 rk_aiq_user_api2_awb_Lock

【Описание】Блокировка текущих параметров WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_Lock(const rk_aiq_sys_ctx_t* sys_ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.6 rk_aiq_user_api2_awb_Unlock

【Описание】Снятие блокировки параметров WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_Lock(const rk_aiq_sys_ctx_t* sys_ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.7 rk_aiq_user_api2_awb_SetWpModeAttrib

【Описание】Установка режима баланса белого.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_SetWpModeAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_opMode_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.8 rk_aiq_user_api2_awb_GetWpModeAttrib

【Описание】Получение режима баланса белого.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_GetWpModeAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_opMode_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.9 rk_aiq_user_api2_awb_SetMwbAttrib

【Описание】Установка ручных параметров WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_SetMwbAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_wb_mwb_attrib_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.10 rk_aiq_user_api2_awb_GetMwbAttrib

【Описание】Установка ручных параметров WB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_SetMwbAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_wb_mwb_attrib_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.11 rk_aiq_user_api2_awb_SetWbGainAdjustAttrib

【Описание】Установка коррекции цветового тона AWB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_SetWbGainAdjustAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_awb_wbGainAdjust_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.12 rk_aiq_user_api2_awb_GetWbGainAdjustAttrib

【Описание】Получение параметров коррекции тона AWB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_GetWbGainAdjustAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_awb_wbGainAdjust_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.13 rk_aiq_user_api2_awb_SetWbGainOffsetAttrib

【Описание】Установка смещения усиления AWB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_SetWbGainOffsetAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_awb_wbGainOffset_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.6.14 rk_aiq_user_api2_awb_GetWbGainOffsetAttrib

【Описание】Получение смещения усиления AWB.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_awb_GetWbGainOffsetAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 rk_aiq_uapiV2_wb_awb_wbGainOffset_t *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_awb.h, rk_aiq_uapi2_awb_int.h

Библиотека: librkaiq.so

【Пример】

См. sample_awb_module.cpp.

7.7 Типы данных модульного API

7.7.1 rk_aiq_wb_querry_info_t

【Описание】Определение запрашиваемых сведений WB.

【Определение】

 typedef struct rk_aiq_wb_querry_info_s {
     rk_aiq_wb_gain_t gain;
     rk_aiq_wb_cct_t cctGloabl;
     bool awbConverged;
     uint32_t LVValue;
 } rk_aiq_wb_querry_info_t;

【Члены】

7.7.2 rk_aiq_wb_op_mode_t

【Описание】Определение режима WB.

【Определение】

 typedef struct rk_aiq_uapiV2_wb_opMode_s {
   rk_aiq_uapi_sync_t sync;
   rk_aiq_wb_op_mode_t mode;
 } rk_aiq_uapiV2_wb_opMode_t;

【Члены】

7.7.3 rk_aiq_wb_mwb_attrib_t

【Описание】Определение атрибутов ручного WB.

【Определение】

 typedef struct rk_aiq_wb_mwb_attrib_s {
      rk_aiq_uapi_sync_t sync;
     rk_aiq_wb_mwb_mode_t mode;
     union MWBPara_u {
         rk_aiq_wb_gain_t gain;
         rk_aiq_wb_scene_t scene;
         rk_aiq_wb_cct_t cct;
     } para;
 } rk_aiq_wb_mwb_attrib_t;

【Члены】

8. AF

8.1 Обзор

Модуль AF регулирует объектив камеры для резкого изображения объекта.

8.2 Описание функций

AF состоит из статистики и алгоритма управления; ниже показана схема модуля статистики AF.

ch0/ch1/ch2 соответствуют кадрам S/M/L HDR; debayer — объединённый кадр HDR.

windowA выводит главным образом FV V1/V2/H1/H2 размером 15*15, яркость и число ярких пикселей.

windowB выводит главным образом одно значение FV, яркость и число ярких пикселей.

8.3 Разработка пользовательских алгоритмов AF

Расположение примера: sdk: external/camera_engine_rkaiq/rkisp_demo/demo/af_algo_demo

8.4 Справочник функционального API

8.4.1 rk_aiq_uapi2_setFocusMode

【Описание】Настройка режима фокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setFocusMode(const rk_aiq_sys_ctx_t* ctx, opMode_t mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.2 rk_aiq_uapi2_getFocusMode

【Описание】Получение текущего режима фокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getFocusMode(const rk_aiq_sys_ctx_t* ctx, opMode_t
 *mode);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.3 rk_aiq_uapi2_setFocusWin

【Описание】Установка окна автофокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setFocusWin(const rk_aiq_sys_ctx_t* ctx, paRect_t *rect);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.4 rk_aiq_uapi2_getFocusWin

【Описание】Установка окна автофокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getFocusWin(const rk_aiq_sys_ctx_t* ctx, paRect_t *rect);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.5 rk_aiq_uapi2_lockFocus

【Описание】Блокировка автофокуса и приостановка фокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_lockFocus(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.6 rk_aiq_uapi2_unlockFocus

【Описание】Разблокировка автофокуса и продолжение фокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_unlockFocus(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.7 rk_aiq_uapi2_oneshotFocus

【Описание】Однократная фокусировка без продолжения после завершения.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_oneshotFocus(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.8 rk_aiq_uapi2_manualTrigerFocus

【Описание】Ручной запуск фокусировки с дальнейшим контролем резкости и повторной фокусировкой при размытии.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_manualTrigerFocus(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.9 rk_aiq_uapi2_trackingFocus

【Описание】Непрерывный контроль резкости и повторная фокусировка при размытии; обычно используется после rk_aiq_uapi2_oneshotFocus.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_trackingFocus(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.10 rk_aiq_uapi2_getSearchResult

【Описание】Получение результата фокусировки.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getSearchResult(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_af_result_t* result);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.11 rk_aiq_uapi2_getZoomRange

【Описание】Получение диапазона зума, ограничивающего код положения на входе rk_aiq_uapi_setOpZoomPosition.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getZoomRange(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_af_zoomrange* range);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.12 rk_aiq_uapi2_setOpZoomPosition

【Описание】Установка и изменение положения зума.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setOpZoomPosition(const rk_aiq_sys_ctx_t* ctx, int pos);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.13 rk_aiq_uapi2_getOpZoomPosition

【Описание】Получение положения зума.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getOpZoomPosition(const rk_aiq_sys_ctx_t* ctx, int *pos);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.14 rk_aiq_uapi2_endOpZoomChange

【Описание】Завершение установки положения зума; вызывается после rk_aiq_uapi_setOpZoomPosition и запускает фокусировку.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_endOpZoomChange(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.15 rk_aiq_uapi2_getFocusRange

【Описание】Получение диапазона фокусировки, ограничивающего код положения на входе rk_aiq_uapi_setFocusPosition.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getFocusRange(const rk_aiq_sys_ctx_t* ctx,
 rk_aiq_af_focusrange* range);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.16 rk_aiq_uapi2_setFocusPosition

【Описание】Установка положения фокуса в ручном режиме.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setFocusPosition(const rk_aiq_sys_ctx_t* ctx, unsigned
 short code);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.17 rk_aiq_uapi2_getFocusPosition

【Описание】Получение текущего положения фокуса.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getFocusPosition(const rk_aiq_sys_ctx_t* ctx, unsigned
 short *code);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.18 rk_aiq_uapi2_startZoomCalib

【Описание】Калибровка моторизованного модуля.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_startZoomCalib(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.4.19 rk_aiq_uapi2_resetZoom

【Описание】Сброс моторизованного модуля.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_resetZoom(const rk_aiq_sys_ctx_t* ctx);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

8.5 Типы данных функционального API

8.5.1 opMode_t

【Описание】Определение режима статистики AF.

【Определение】

 typedef enum opMode_e {
     OP_AUTO   = 0,
     OP_MANUAL = 1,
     OP_SEMI_AUTO = 2,
     OP_INVAL
 } opMode_t;

【Члены】

8.5.2 rk_aiq_af_zoomrange

【Описание】Определение диапазона зума.

【Определение】

 typedef struct {
     int min_pos;
     int max_pos;
     float min_fl;
     float max_fl;
 } rk_aiq_af_zoomrange;

【Члены】

8.5.3 rk_aiq_af_focusrange

【Описание】Определение диапазона фокуса.

【Определение】

 typedef struct {
     int min_pos;
     int max_pos;
 } rk_aiq_af_focusrange;

【Члены】

8.5.4 rk_aiq_af_result_t

【Описание】Определение результатов поиска AF.

【Определение】

 typedef enum rk_aiq_af_sec_stat_e
 {
     RK_AIQ_AF_SEARCH_INVAL   = 0,
     RK_AIQ_AF_SEARCH_RUNNING = 1,
     RK_AIQ_AF_SEARCH_END     = 2
 } rk_aiq_af_sec_stat_t;
 typedef struct {
     rk_aiq_af_sec_stat_t stat;
     int32_t final_pos;
 } rk_aiq_af_result_t;

【Члены】

8.6 Справочник модульного API

8.6.1 rk_aiq_user_api2_af_SetAttrib

【Описание】Установка атрибутов фокусировки.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_af_SetAttrib(const rk_aiq_sys_ctx_t* sys_ctx, rk_aiq_af_attrib_t
 attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_af.h

Библиотека: librkaiq.so

8.6.2 rk_aiq_user_api2_af_GetAttrib

【Описание】Получение атрибутов фокусировки.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_af_GetAttrib(const rk_aiq_sys_ctx_t* sys_ctx, rk_aiq_af_attrib_t
 *attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_af.h

Библиотека: librkaiq.so

8.7 Типы данных модульного API

8.7.1 RKAIQ_AF_MODE

【Описание】Определение режима работы фокуса.

【Определение】

 typedef enum _RKAIQ_AF_MODE
 {
     RKAIQ_AF_MODE_NOT_SET = -1,
     RKAIQ_AF_MODE_AUTO,
     RKAIQ_AF_MODE_MACRO,
     RKAIQ_AF_MODE_INFINITY,
     RKAIQ_AF_MODE_FIXED,
     RKAIQ_AF_MODE_EDOF,
     RKAIQ_AF_MODE_CONTINUOUS_VIDEO,
     RKAIQ_AF_MODE_CONTINUOUS_PICTURE,
     RKAIQ_AF_MODE_ONESHOT_AFTER_ZOOM,
 } RKAIQ_AF_MODE;

【Члены】

8.7.2 RKAIQ_AF_HWVER

【Описание】Определение режима работы фокуса.

【Определение】

 typedef enum _RKAIQ_AF_HWVER
 {
     RKAIQ_AF_HW_V20 = 0,
     RKAIQ_AF_HW_V30,
     RKAIQ_AF_HW_VMAX
 } RKAIQ_AF_HWVER;

【Члены】

8.7.3 rk_aiq_af_algo_meas_v30_t

【Описание】Определение режима статистики AF.

【Определение】

 typedef struct {
     unsigned char af_en;
     unsigned char rawaf_sel;
     unsigned char gamma_en;
     unsigned char gaus_en;
     unsigned char v1_fir_sel;
     unsigned char hiir_en;
     unsigned char viir_en;
     unsigned char v1_fv_outmode;    // 0 square, 1 absolute
     unsigned char v2_fv_outmode;    // 0 square, 1 absolute
     unsigned char h1_fv_outmode;    // 0 square, 1 absolute
     unsigned char h2_fv_outmode;    // 0 square, 1 absolute
     unsigned char ldg_en;
     unsigned char accu_8bit_mode;   //fix to 1
     unsigned char ae_mode;
     unsigned char y_mode;           //fix to 0
     unsigned char line_en[RKAIQ_RAWAF_LINE_NUM];
     unsigned char line_num[RKAIQ_RAWAF_LINE_NUM];
     unsigned char window_num;
     unsigned short wina_h_offs;
     unsigned short wina_v_offs;
     unsigned short wina_h_size;
     unsigned short wina_v_size;
     unsigned short winb_h_offs;
     unsigned short winb_v_offs;
     unsigned short winb_h_size;
     unsigned short winb_v_size;
     unsigned short gamma_y[RKAIQ_RAWAF_GAMMA_NUM];
     // [old version param]
     unsigned short thres;
     unsigned char shift_sum_a;
     unsigned char shift_sum_b;
     unsigned char shift_y_a;
     unsigned char shift_y_b;

     /**********[Vertical IIR (v1 & v2)]************/
     short v1_iir_coe[9];
     short v1_fir_coe[3];
     short v2_iir_coe[3];
     short v2_fir_coe[3];
     /**********[Horizontal IIR (h1 & h2)]************/
     short h1_iir1_coe[6];
     short h2_iir1_coe[6];
     short h1_iir2_coe[6];
     short h2_iir2_coe[6];
     /**********[Focus value statistic param]**********/
     // level depended gain
     // input8 lumi, output8bit gain
     unsigned char h_ldg_lumth[2];    //luminance thresh
     unsigned char h_ldg_gain[2];     //gain for [minLum,maxLum]
     unsigned short h_ldg_gslp[2];    //[slope_low,-slope_high]
     unsigned char v_ldg_lumth[2];
     unsigned char v_ldg_gain[2];
     unsigned short v_ldg_gslp[2];
     // coring
     unsigned short v_fv_thresh;
     unsigned short h_fv_thresh;
     // left shift, more needed if outmode=square
     unsigned char v1_fv_shift; //only for sel1
     unsigned char v2_fv_shift;
     unsigned char h1_fv_shift;
     unsigned char h2_fv_shift;
     /**********[High light]**********/
     unsigned short highlit_thresh;
 }  rk_aiq_af_algo_meas_v30_t;

【Члены】

8.7.4 rk_aiq_af_attrib_t

【Описание】Конфигурация фокусировки.

【Определение】

 typedef struct rk_aiq_af_attrib_s {
     rk_aiq_uapi_sync_t sync;
     RKAIQ_AF_MODE AfMode;
     RKAIQ_AF_HWVER AfHwVer;
     bool contrast_af;
     bool laser_af;
     bool pdaf;
     int h_offs;
     int v_offs;
     unsigned int h_size;
     unsigned int v_size;
     short fixedModeDefCode;
     short macroModeDefCode;
     short infinityModeDefCode;
     union {
         rk_aiq_af_algo_meas_v20_t manual_meascfg;
         rk_aiq_af_algo_meas_v30_t manual_meascfg_v30;
     };
 } rk_aiq_af_attrib_t;

【Члены】

8.8 Дополнительные указания

8.8.1 Проверка драйвера VCM

1. Правильны ли начальный и конечный токи VCM.

Сначала получите данные о начальном и конечном токах у производителя модуля.

Затем проверьте сведения на нескольких модулях:

В DTS задайте максимальный поддерживаемый VCM диапазон токов.

В ручном фокусе постепенно изменяйте позицию от 64; когда объектив начинает двигаться и объект дальше 10 метров резок, запишите позицию.

Начальный ток: (vcm_max_mA - vcm_min_mA) * (64 - curPos) / 64.

Продолжайте регулировку и запишите позицию резкого близкого объекта (10cm или 20cm).

Конечный ток: (vcm_max_mA - vcm_min_mA) * (64 - curPos) / 64.

2. Стабильно ли конечное положение VCM при движении с разных направлений.

В ручном режиме выберите позицию и подойдите к ней от 0 и от 64; сравните резкость изображений и близость статистики AF.

3. Правильно ли время перемещения объектива.

8.8.2 Проверка драйвера моторизованного модуля

1. Совпадает ли конечная позиция после отдельных шагов и одного многошагового перемещения.

1. Выберите наиболее резкое положение zoom/focus, запишите позицию двигателя и сохраните изображение A.

2. Отведите двигатель на несколько шагов и верните по одному шагу в записанную позицию; сохраните B.

3. Снова отведите двигатель на несколько шагов и верните одним перемещением; сохраните C.

4. Сравните резкость и поле зрения A, B и C.

2. Совпадает ли конечная позиция после случайных перемещений.

1. Выберите наиболее резкое положение zoom/focus, запишите позицию двигателя и сохраните изображение A.

2. Скриптом выполните 400–500 случайных перемещений zoom либо focus, верните исходную позицию и сохраните B.

3. Сравните резкость и поле зрения A и B.

3. Совпадает ли конечная позиция после одновременного движения двигателей.

1. Выберите наиболее резкое положение zoom/focus, запишите позицию двигателя и сохраните изображение A.

2. Скриптом одновременно выполните 400–500 случайных перемещений zoom и focus, верните исходные позиции и сохраните B.

3. Сравните резкость и поле зрения A и B.

9. IMGPROC

9.1 Обзор

imgproc обозначает модули, влияющие на вид изображения.

9.2 Merge

9.2.1 Описание функций

Merge объединяет несколько кадров в один.

9.2.2 Основные понятия

Действует только в режиме HDR.

9.2.3 Справочник функционального API

9.2.4 Справочник модульного API

9.2.4.1 rk_aiq_user_api2_amerge_SetAttrib

【Описание】Установка атрибутов merge.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_amerge_SetAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 amerge_attrib_t attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_amerge.h

Библиотека: librkaiq.so

9.2.4.2 rk_aiq_user_api2_amerge_GetAttrib

【Описание】Получение атрибутов merge.

【Синтаксис】

 XCamReturn
 rk_aiq_user_api2_amerge_GetAttrib(const rk_aiq_sys_ctx_t* sys_ctx,
 amerge_attrib_t* attr);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_amerge.h

Библиотека: librkaiq.so

9.2.5 Типы данных модульного API

9.2.5.1 merge_OpMode_t

【Описание】Определение режима merge.

【Определение】

 typedef enum merge_OpModeV21_e {
     MERGE_OPMODE_API_OFF = 0,
     MERGE_OPMODE_MANU    = 1,
 } merge_OpModeV21_t;

【Члены】

9.2.5.2 MergeBaseFrame_t

【Описание】Определение опорного кадра объединения.

【Определение】

 typedef enum MergeBaseFrame_e {
     BASEFRAME_LONG  = 0,
     BASEFRAME_SHORT = 1,
 } MergeBaseFrame_t;

【Члены】

9.2.5.3 MergeCurrCtlData_t

【Описание】Определение управляющих параметров Merge.

【Определение】

 typedef struct MergeCurrCtlData_s {
     float Envlv;
     float MoveCoef;
 } MergeCurrCtlData_t;

【Члены】

9.2.5.4 mMergeOECurveV21_t

【Описание】Определение ручной кривой пересвета Merge.

【Определение】

 typedef struct mMergeOECurveV21_s {
     float Smooth;
     float Offset;
 } mMergeOECurveV21_t;

【Члены】

9.2.5.5 mMergeMDCurveV21_t

【Описание】Определение кривой движения режима длинного кадра.

【Определение】

 typedef struct mMergeMDCurveV21_s {
     float LM_smooth;
     float LM_offset;
     float MS_smooth;
     float MS_offset;
 } mMergeMDCurveV21_t;

【Члены】

9.2.5.6 mMergeAttrV21_t

【Описание】Определение ручных атрибутов merge RK3588.

【Определение】

 typedef struct mMergeAttrV21_s {
     mMergeOECurveV21_t OECurve;
     mMergeMDCurveV21_t MDCurve;
 } mMergeAttrV21_t;

【Члены】

9.2.5.7 mergeAttrV21_t

【Описание】Настройка атрибутов merge RK356x.

【Определение】

 typedef struct mergeAttrV21_s {
     merge_OpModeV21_t    opMode;
     mMergeAttrV21_t      stManual;
     MergeCurrCtlData_t   CtlInfo;
 } mergeAttrV21_t;

【Члены】

9.2.5.8 mLongFrameModeData_t

【Описание】Определение управляющих параметров длинного кадра.

【Определение】

 typedef struct mLongFrameModeData_s {
     mMergeOECurveV21_t OECurve;
     mMergeMDCurveV21_t MDCurve;
 } mLongFrameModeData_t;

【Члены】

9.2.5.9 mMergeMDCurveV30Short_t

【Описание】Определение кривой движения короткого кадра.

【Определение】

 typedef struct mMergeMDCurveV30Short_s{
     float Coef;
     float ms_thd0;
     float lm_thd0;
 } mMergeMDCurveV30Short_t;

【Члены】

9.2.5.10 mShortFrameModeData_t

【Описание】Определение управляющих параметров короткого кадра.

【Определение】

 typedef struct mShortFrameModeData_s {
     mMergeOECurveV21_t      OECurve;
     mMergeMDCurveV30Short_t MDCurve;
 } mShortFrameModeData_t;

【Члены】

9.2.5.11 mMergeAttrV30_t

【Описание】Определение ручных атрибутов merge RK3588.

【Определение】

 typedef struct mMergeAttrV30_s {
     MergeBaseFrame_t      BaseFrm;
     mLongFrameModeData_t  LongFrmModeData;
     mShortFrameModeData_t ShortFrmModeData;
 } mMergeAttrV30_t;

【Члены】

9.2.5.12 MergeOECurveV10_t

【Описание】Определение автоматической кривой пересвета Merge.

【Определение】

 typedef struct MergeOECurveV10_s {
     float EnvLv[MERGE_ENVLV_STEP_MAX];
     float Smooth[MERGE_ENVLV_STEP_MAX];
     float Offset[MERGE_ENVLV_STEP_MAX];
 } MergeOECurveV10_t;

【Члены】

9.2.5.13 MergeMDCurveV10_t

【Описание】Определение кривой движения режима длинного кадра.

【Определение】

 typedef struct MergeMDCurveV10_s {
     float MoveCoef[MERGE_ENVLV_STEP_MAX];
     float LM_smooth[MERGE_ENVLV_STEP_MAX];
     float LM_offset[MERGE_ENVLV_STEP_MAX];
     float MS_smooth[MERGE_ENVLV_STEP_MAX];
     float MS_offset[MERGE_ENVLV_STEP_MAX];
 } MergeMDCurveV10_t;

【Члены】

9.2.5.14 MergeEachChnCurveV12_t

【Описание】Определение кривой обнаружения подканала в режиме длинного кадра.

【Определение】

 typedef struct MergeEachChnCurveV12_s {
     float EnvLv[MERGE_ENVLV_STEP_MAX];
     float Smooth[MERGE_ENVLV_STEP_MAX];
     float Offset[MERGE_ENVLV_STEP_MAX];
 } MergeEachChnCurveV12_t;

【Члены】

9.2.5.15 LongFrameModeDataV12_t

【Описание】Определение управляющих параметров длинного кадра.

【Определение】

 typedef struct LongFrameModeDataV12_s {
     bool                   EnableEachChn;
     MergeOECurveV10_t      OECurve;
     MergeMDCurveV10_t      MDCurve;
     MergeEachChnCurveV12_t EachChnCurve;
     float                  OECurve_damp;
     float                  MDCurveLM_damp;
     float                  MDCurveMS_damp;
 } LongFrameModeDataV12_t;

【Члены】

9.2.5.16 MergeMDCurveV11Short_t

【Описание】Определение кривой движения короткого кадра.

【Определение】

 typedef struct MergeMDCurveV11Short_s{
     float Coef;
     float ms_thd0;
     float lm_thd0;
 } MergeMDCurveV11Short_t;

【Члены】

9.2.5.17 ShortFrameModeData_t

【Описание】Определение управляющих параметров короткого кадра.

【Определение】

 typedef struct ShortFrameModeData_s {
     MergeOECurveV10_t      OECurve;
     MergeMDCurveV11Short_t MDCurve;
     float                  OECurve_damp;
     float                  MDCurve_damp;
 } ShortFrameModeData_t;

【Члены】

9.2.5.18 CalibDbV2_merge_V12_t

【Описание】Определение автоматических атрибутов merge.

【Определение】

 typedef struct CalibDbV2_merge_V12_s {
     MergeBaseFrame_t       BaseFrm;
     float                  ByPassThr;
     LongFrameModeDataV12_t LongFrmModeData;
     ShortFrameModeData_t   ShortFrmModeData;
 } CalibDbV2_merge_V12_t;

【Члены】

9.2.5.19 MergeCurrCtlData_t

【Описание】Настройка merge RK3588.

【Определение】

 typedef struct mergeAttrV30_s {
     merge_OpModeV21_t    opMode;
     mMergeAttrV30_t      stManual;
     MergeCurrCtlData_t   CtlInfo;
 } mergeAttrV30_t;

【Члены】

9.2.5.20 mergeAttr_t

【Описание】Конфигурация атрибутов merge.

【Определение】

 typedef struct mergeAttr_s {
     rk_aiq_uapi_sync_t  sync;
     mergeAttrV21_t      attrV21;
     mergeAttrV30_t      attrV30;
 } mergeAttr_t;

【Члены】

9.3 DRC

9.3.1 Описание функций

DRC (сжатие высокого динамического диапазона) переводит изображение большей разрядности в меньшую.

9.3.2 Основные понятия

DRC применяется в линейном режиме и HDR.

9.3.3 Справочник функционального API

9.3.3.1 rk_aiq_uapi2_setDrcGain

【Описание】

Быстрая установка параметров кривой DrcGain.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setDrcGain(const rk_aiq_sys_ctx_t* ctx, float Gain, float
 Alpha, float Clip);

При этом API работает в DRC_OPMODE_DRC_GAIN. Параметры вызова сохраняются в stDrcGain, определяющем три параметра кривой DrcGain; остальные параметры DRC по-прежнему берутся из модуля DRC в JSON.

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

9.3.3.2 rk_aiq_uapi2_getDrcGain

【Описание】

Получение параметров быстрой кривой DrcGain.

API возвращает параметры stDrcGain; они являются реально используемыми только в режиме DRC_OPMODE_DRC_GAIN.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getDrcGain(const rk_aiq_sys_ctx_t* ctx, float Gain, float
 Alpha, float Clip);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

9.3.3.3 rk_aiq_uapi2_setDrcHiLit

【Описание】

Быстрая установка DrcHiLit.

В режиме DRC_OPMODE_HILIT параметры вызова сохраняются в stHiLit и определяют HiLight; остальные параметры DRC по-прежнему берутся из JSON.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setDrcHiLit(const rk_aiq_sys_ctx_t* ctx, float Strength);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

9.3.3.4 rk_aiq_uapi2_getDrcHiLit

【Описание】

Получение параметров быстрой настройки DrcHiLit.

API получает параметры stHiLit; они реально используются только в DRC_OPMODE_HILIT.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getDrcHiLit(const rk_aiq_sys_ctx_t* ctx, float Strength);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

9.3.3.5 rk_aiq_uapi2_setDrcLocalData

【Описание】

Быстрая установка DrcLocalData.

В DRC_OPMODE_LOCAL_TMO параметры сохраняются в stLocalDataV30 и определяют LocalData; остальные параметры DRC берутся из JSON.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_setDrcLocalData(const rk_aiq_sys_ctx_t* ctx, float
 LocalWeit, float GlobalContrast, float LoLitContrast，int LocalAutoEnable, float
 LocalAutoWeit);

【Параметры】

【Возвращаемое значение】

【Зависимости】

Заголовочный файл: rk_aiq_user_api2_imgproc.h

Библиотека: librkaiq.so

9.3.3.6 rk_aiq_uapi2_getDrcLocalData

【Описание】

Получение параметров DrcLocalData.

API получает LocalData из stLocalDataV30; они применяются только в DRC_OPMODE_LOCAL_TMO.

【Синтаксис】

 XCamReturn rk_aiq_uapi2_getDrcLocalData(const rk_aiq_sys_ctx_t* ctx, float*
 LocalWeit, float* GlobalContrast, float* LoLitContrast，int* LocalAutoEnable,
 float* LocalAutoWeit);

【Параметры】

【Возвращаемое значение】