Files
external_libcamera/include/libcamera/ipa/ipu3.mojom
T
Umang Jain ff9276cc62 ipa: Move core IPA interface documentation to a .cpp file
Moving the core.mojom documentation to its corresponding .cpp file
(core_ipa_interface.cpp). This will allow Doxygen to generate the
documentation for IPABuffer, IPASettings and IPAStream structures.
Since the .mojom files are placed in include/ directory, the .cpp file
will live in $sourcedir/src/libcamera/ipa/ - which can also contain
documentation for other mojom generated IPA interfaces in subsequent
commit.

Also hide the constructors in generated IPA interface from doxygen,
via  #ifndef __DOXYGEN__. These constructors provide no major value in
documenting them, instead will spew out doxygen warnings during the
build.

Signed-off-by: Umang Jain <umang.jain@ideasonboard.com>
Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Paul Elder <paul.elder@ideasonboard.com>
Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
2021-05-24 14:13:01 +03:00

50 lines
1.0 KiB
Plaintext

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
* \todo Document the interface as src/libcamera/ipa/ipu3_ipa_interface.cpp
* and remove the EXCLUDE_PATTERNS entry in Doxygen.in for its generation.
*/
module ipa.ipu3;
import "include/libcamera/ipa/core.mojom";
enum IPU3Operations {
ActionSetSensorControls = 1,
ActionParamFilled = 2,
ActionMetadataReady = 3,
EventProcessControls = 4,
EventStatReady = 5,
EventFillParams = 6,
};
struct IPU3Event {
IPU3Operations op;
uint32 frame;
uint32 bufferId;
libcamera.ControlList controls;
};
struct IPU3Action {
IPU3Operations op;
libcamera.ControlList controls;
};
interface IPAIPU3Interface {
init(libcamera.IPASettings settings) => (int32 ret);
start() => (int32 ret);
stop();
configure(map<uint32, libcamera.ControlInfoMap> entityControls,
libcamera.Size bdsOutputSize) => ();
mapBuffers(array<libcamera.IPABuffer> buffers);
unmapBuffers(array<uint32> ids);
[async] processEvent(IPU3Event ev);
};
interface IPAIPU3EventInterface {
queueFrameAction(uint32 frame, IPU3Action action);
};