libcamera  v0.4.0
Supporting cameras in Linux since 2019
software_isp.h
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 /*
3  * Copyright (C) 2023, Linaro Ltd
4  *
5  * Simple software ISP implementation
6  */
7 
8 #pragma once
9 
10 #include <functional>
11 #include <initializer_list>
12 #include <map>
13 #include <memory>
14 #include <stdint.h>
15 #include <string>
16 #include <tuple>
17 #include <vector>
18 
19 #include <libcamera/base/class.h>
20 #include <libcamera/base/log.h>
21 #include <libcamera/base/signal.h>
22 #include <libcamera/base/thread.h>
23 
24 #include <libcamera/geometry.h>
25 #include <libcamera/pixel_format.h>
26 
27 #include <libcamera/ipa/soft_ipa_interface.h>
28 #include <libcamera/ipa/soft_ipa_proxy.h>
29 
31 #include "libcamera/internal/dma_buf_allocator.h"
33 #include "libcamera/internal/shared_mem_object.h"
34 #include "libcamera/internal/software_isp/debayer_params.h"
35 
36 namespace libcamera {
37 
38 class DebayerCpu;
39 class FrameBuffer;
40 class PixelFormat;
41 class Stream;
42 struct StreamConfiguration;
43 
44 LOG_DECLARE_CATEGORY(SoftwareIsp)
45 
47 {
48 public:
49  SoftwareIsp(PipelineHandler *pipe, const CameraSensor *sensor,
50  ControlInfoMap *ipaControls);
51  ~SoftwareIsp();
52 
53  int loadConfiguration([[maybe_unused]] const std::string &filename) { return 0; }
54 
55  bool isValid() const;
56 
57  std::vector<PixelFormat> formats(PixelFormat input);
58 
59  SizeRange sizes(PixelFormat inputFormat, const Size &inputSize);
60 
61  std::tuple<unsigned int, unsigned int>
62  strideAndFrameSize(const PixelFormat &outputFormat, const Size &size);
63 
64  int configure(const StreamConfiguration &inputCfg,
65  const std::vector<std::reference_wrapper<StreamConfiguration>> &outputCfgs,
66  const ipa::soft::IPAConfigInfo &configInfo);
67 
68  int exportBuffers(const Stream *stream, unsigned int count,
69  std::vector<std::unique_ptr<FrameBuffer>> *buffers);
70 
71  void processStats(const uint32_t frame, const uint32_t bufferId,
72  const ControlList &sensorControls);
73 
74  int start();
75  void stop();
76 
77  void queueRequest(const uint32_t frame, const ControlList &controls);
78  int queueBuffers(uint32_t frame, FrameBuffer *input,
79  const std::map<const Stream *, FrameBuffer *> &outputs);
80 
81  void process(uint32_t frame, FrameBuffer *input, FrameBuffer *output);
82 
87 
88 private:
89  void saveIspParams();
90  void setSensorCtrls(const ControlList &sensorControls);
91  void statsReady(uint32_t frame, uint32_t bufferId);
92  void inputReady(FrameBuffer *input);
93  void outputReady(FrameBuffer *output);
94 
95  std::unique_ptr<DebayerCpu> debayer_;
96  Thread ispWorkerThread_;
97  SharedMemObject<DebayerParams> sharedParams_;
98  DebayerParams debayerParams_;
99  DmaBufAllocator dmaHeap_;
100 
101  std::unique_ptr<ipa::soft::IPAProxySoft> ipa_;
102 };
103 
104 } /* namespace libcamera */
A camera sensor.
Utilities to help constructing class interfaces.
A abstract camera sensor.
Definition: camera_sensor.h:38
A map of ControlId to ControlInfo.
Definition: controls.h:367
Associate a list of ControlId with their values for an object.
Definition: controls.h:411
Helper class for dma-buf allocations.
Definition: dma_buf_allocator.h:24
Frame buffer data and its associated dynamic metadata.
Definition: framebuffer.h:49
Create and manage cameras based on a set of media devices.
Definition: pipeline_handler.h:35
libcamera image pixel format
Definition: pixel_format.h:17
Helper class to allocate an object in shareable memory.
Definition: shared_mem_object.h:60
Generic signal and slot communication mechanism.
Definition: signal.h:39
Describe a range of sizes.
Definition: geometry.h:201
Describe a two-dimensional size.
Definition: geometry.h:53
Class for the Software ISP.
Definition: software_isp.h:47
Signal< FrameBuffer * > outputBufferReady
A signal emitted when the output frame buffer completes.
Definition: software_isp.h:84
Signal< FrameBuffer * > inputBufferReady
A signal emitted when the input frame buffer completes.
Definition: software_isp.h:83
Signal< const ControlList & > setSensorControls
A signal emitted when the values to write to the sensor controls are ready.
Definition: software_isp.h:86
int loadConfiguration([[maybe_unused]] const std::string &filename)
Load a configuration from a file.
Definition: software_isp.h:53
Signal< uint32_t, uint32_t > ispStatsReady
A signal emitted when the statistics for IPA are ready.
Definition: software_isp.h:85
Video stream for a camera.
Definition: stream.h:76
A thread of execution.
Definition: thread.h:30
Data structures related to geometric objects.
Logging infrastructure.
#define LOG_DECLARE_CATEGORY(name)
Declare a category of log messages.
const ControlIdMap controls
List of all supported libcamera controls.
Definition: control_ids.cpp:1985
Top-level libcamera namespace.
Definition: backtrace.h:17
Create pipelines and cameras from a set of media devices.
libcamera pixel format
Signal & slot implementation.
Struct to hold the debayer parameters.
Definition: debayer_params.h:18
Configuration parameters for a stream.
Definition: stream.h:40
Thread support.