summaryrefslogtreecommitdiff
path: root/include/libcamera/ipa/ipa_interface.h
diff options
context:
space:
mode:
authorLaurent Pinchart <laurent.pinchart@ideasonboard.com>2020-05-15 19:01:30 +0300
committerLaurent Pinchart <laurent.pinchart@ideasonboard.com>2020-05-16 03:38:47 +0300
commitf934fd1cb9371dc49e32aee061284a2dadd8ea89 (patch)
treef5d48eb40eff616cf206ca66191b6b8a9984c48c /include/libcamera/ipa/ipa_interface.h
parent93e72b695e477ac1efc22a0bdddb177199cf2fb9 (diff)
libcamera: Move IPA headers from include/ipa/ to include/libcamera/ipa/
The IPA headers are installed into $prefix/include/libcamera/ipa/, but are located in the source tree in include/ipa/. This requires files within libcamera to include them with #include <ipa/foo.h> while a third party IPA would need to use #include <libcamera/ipa/foo.h> Not only is this inconsistent, it can create issues later if IPA headers need to include each other, as the first form of include directive wouldn't be valid once the headers are installed. Fix the problem by moving the IPA headers to include/libcamera/ipa/. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Acked-by: Jacopo Mondi <jacopo@jmondi.org>
Diffstat (limited to 'include/libcamera/ipa/ipa_interface.h')
-rw-r--r--include/libcamera/ipa/ipa_interface.h173
1 files changed, 173 insertions, 0 deletions
diff --git a/include/libcamera/ipa/ipa_interface.h b/include/libcamera/ipa/ipa_interface.h
new file mode 100644
index 00000000..dc9fc714
--- /dev/null
+++ b/include/libcamera/ipa/ipa_interface.h
@@ -0,0 +1,173 @@
+/* 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_settings {
+ const char *configuration_file;
+};
+
+struct ipa_sensor_info {
+ const char *model;
+ uint8_t bits_per_pixel;
+ struct {
+ uint32_t width;
+ uint32_t height;
+ } active_area;
+ struct {
+ int32_t left;
+ int32_t top;
+ uint32_t width;
+ uint32_t height;
+ } analog_crop;
+ struct {
+ uint32_t width;
+ uint32_t height;
+ } output_size;
+ uint64_t pixel_rate;
+ uint32_t line_length;
+};
+
+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 *(*get_interface)(struct ipa_context *ctx);
+ void (*init)(struct ipa_context *ctx,
+ const struct ipa_settings *settings);
+ int (*start)(struct ipa_context *ctx);
+ void (*stop)(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_sensor_info *sensor_info,
+ 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);
+};
+
+struct ipa_context *ipaCreate();
+
+#ifdef __cplusplus
+}
+
+#include <map>
+#include <vector>
+
+#include <libcamera/buffer.h>
+#include <libcamera/controls.h>
+#include <libcamera/geometry.h>
+#include <libcamera/signal.h>
+
+namespace libcamera {
+
+struct IPASettings {
+ std::string configurationFile;
+};
+
+struct IPAStream {
+ unsigned int pixelFormat;
+ Size size;
+};
+
+struct IPABuffer {
+ unsigned int id;
+ std::vector<FrameBuffer::Plane> planes;
+};
+
+struct IPAOperationData {
+ unsigned int operation;
+ std::vector<uint32_t> data;
+ std::vector<ControlList> controls;
+};
+
+struct CameraSensorInfo;
+
+class IPAInterface
+{
+public:
+ virtual ~IPAInterface() {}
+
+ virtual int init(const IPASettings &settings) = 0;
+ virtual int start() = 0;
+ virtual void stop() = 0;
+
+ virtual void configure(const CameraSensorInfo &sensorInfo,
+ 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__ */