bc9527de45
The C++ objects that are expected to convey data through the IPA API will have associated methods that would require IPAs to link to libcamera. Even though the libcamera license allows this, suppliers of closed-source IPAs may have a different interpretation. To ease their mind and clearly separate vendor code and libcamera code, define a plain C IPA API. The corresponding C objects are stored in plain C structures or have their binary format documented, removing the need for linking to libcamera code on the IPA side. The C API adds three new C structures, ipa_context, ipa_context_ops and ipa_callback_ops. The ipa_context_ops and ipa_callback_ops contain function pointers for all the IPA interface methods and signals, respectively. The ipa_context represents a context of operation for the IPA, and is passed to the IPA oparations. The IPAInterface class is retained as it is easier to use than a plain C API for pipeline handlers, and wrappers will be developed to translate between the C and C++ APIs. Switching to the C API internally will be done in a second step. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Jacopo Mondi <jacopo@jmondi.org> Reviewed-by: Niklas Söderlund <niklas.soderlund@ragnatech.se>
135 lines
2.9 KiB
C++
135 lines
2.9 KiB
C++
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
/*
|
|
* Copyright (C) 2019, Google Inc.
|
|
*
|
|
* ipa_interface.h - Image Processing Algorithm interface
|
|
*/
|
|
#ifndef __LIBCAMERA_IPA_INTERFACE_H__
|
|
#define __LIBCAMERA_IPA_INTERFACE_H__
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct ipa_context {
|
|
const struct ipa_context_ops *ops;
|
|
};
|
|
|
|
struct ipa_stream {
|
|
unsigned int id;
|
|
unsigned int pixel_format;
|
|
unsigned int width;
|
|
unsigned int height;
|
|
};
|
|
|
|
struct ipa_control_info_map {
|
|
unsigned int id;
|
|
const uint8_t *data;
|
|
size_t size;
|
|
};
|
|
|
|
struct ipa_buffer_plane {
|
|
int dmabuf;
|
|
size_t length;
|
|
};
|
|
|
|
struct ipa_buffer {
|
|
unsigned int id;
|
|
unsigned int num_planes;
|
|
struct ipa_buffer_plane planes[3];
|
|
};
|
|
|
|
struct ipa_control_list {
|
|
const uint8_t *data;
|
|
unsigned int size;
|
|
};
|
|
|
|
struct ipa_operation_data {
|
|
unsigned int operation;
|
|
const uint32_t *data;
|
|
unsigned int num_data;
|
|
const struct ipa_control_list *lists;
|
|
unsigned int num_lists;
|
|
};
|
|
|
|
struct ipa_callback_ops {
|
|
void (*queue_frame_action)(void *cb_ctx, unsigned int frame,
|
|
struct ipa_operation_data &data);
|
|
};
|
|
|
|
struct ipa_context_ops {
|
|
void (*destroy)(struct ipa_context *ctx);
|
|
void (*init)(struct ipa_context *ctx);
|
|
void (*register_callbacks)(struct ipa_context *ctx,
|
|
const struct ipa_callback_ops *callbacks,
|
|
void *cb_ctx);
|
|
void (*configure)(struct ipa_context *ctx,
|
|
const struct ipa_stream *streams,
|
|
unsigned int num_streams,
|
|
const struct ipa_control_info_map *maps,
|
|
unsigned int num_maps);
|
|
void (*map_buffers)(struct ipa_context *ctx,
|
|
const struct ipa_buffer *buffers,
|
|
size_t num_buffers);
|
|
void (*unmap_buffers)(struct ipa_context *ctx, const unsigned int *ids,
|
|
size_t num_buffers);
|
|
void (*process_event)(struct ipa_context *ctx,
|
|
const struct ipa_operation_data *data);
|
|
};
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
|
|
#include <map>
|
|
#include <vector>
|
|
|
|
#include <libcamera/buffer.h>
|
|
#include <libcamera/controls.h>
|
|
#include <libcamera/geometry.h>
|
|
#include <libcamera/signal.h>
|
|
|
|
#include "v4l2_controls.h"
|
|
|
|
namespace libcamera {
|
|
|
|
struct IPAStream {
|
|
unsigned int pixelFormat;
|
|
Size size;
|
|
};
|
|
|
|
struct IPABuffer {
|
|
unsigned int id;
|
|
BufferMemory memory;
|
|
};
|
|
|
|
struct IPAOperationData {
|
|
unsigned int operation;
|
|
std::vector<uint32_t> data;
|
|
std::vector<ControlList> controls;
|
|
};
|
|
|
|
class IPAInterface
|
|
{
|
|
public:
|
|
virtual ~IPAInterface() {}
|
|
|
|
virtual int init() = 0;
|
|
|
|
virtual void configure(const std::map<unsigned int, IPAStream> &streamConfig,
|
|
const std::map<unsigned int, const ControlInfoMap &> &entityControls) = 0;
|
|
|
|
virtual void mapBuffers(const std::vector<IPABuffer> &buffers) = 0;
|
|
virtual void unmapBuffers(const std::vector<unsigned int> &ids) = 0;
|
|
|
|
virtual void processEvent(const IPAOperationData &data) = 0;
|
|
Signal<unsigned int, const IPAOperationData &> queueFrameAction;
|
|
};
|
|
|
|
} /* namespace libcamera */
|
|
#endif
|
|
|
|
#endif /* __LIBCAMERA_IPA_INTERFACE_H__ */
|