@@ -14,10 +14,12 @@
namespace libcamera {
+class BufferPool;
class Camera;
class CameraManager;
class DeviceEnumerator;
class MediaDevice;
+class Request;
class Stream;
class StreamConfiguration;
@@ -45,6 +47,14 @@ public:
virtual int configureStreams(Camera *camera,
std::map<Stream *, StreamConfiguration> &config) = 0;
+ virtual int allocateBuffers(Camera *camera, Stream *stream) = 0;
+ virtual int freeBuffers(Camera *camera, Stream *stream) = 0;
+
+ virtual int start(const Camera *camera) = 0;
+ virtual void stop(const Camera *camera) = 0;
+
+ virtual int queueRequest(const Camera *camera, Request *request) = 0;
+
virtual bool match(DeviceEnumerator *enumerator) = 0;
protected:
@@ -34,6 +34,14 @@ public:
int configureStreams(Camera *camera,
std::map<Stream *, StreamConfiguration> &config) override;
+ int allocateBuffers(Camera *camera, Stream *stream) override;
+ int freeBuffers(Camera *camera, Stream *stream) override;
+
+ int start(const Camera *camera) override;
+ void stop(const Camera *camera) override;
+
+ int queueRequest(const Camera *camera, Request *request) override;
+
bool match(DeviceEnumerator *enumerator);
private:
@@ -104,6 +112,32 @@ int PipelineHandlerIPU3::configureStreams(Camera *camera,
return 0;
}
+int PipelineHandlerIPU3::allocateBuffers(Camera *camera, Stream *stream)
+{
+ return -ENOTRECOVERABLE;
+}
+
+int PipelineHandlerIPU3::freeBuffers(Camera *camera, Stream *stream)
+{
+ return 0;
+}
+
+int PipelineHandlerIPU3::start(const Camera *camera)
+{
+ LOG(IPU3, Error) << "TODO: start camera";
+ return 0;
+}
+
+void PipelineHandlerIPU3::stop(const Camera *camera)
+{
+ LOG(IPU3, Error) << "TODO: stop camera";
+}
+
+int PipelineHandlerIPU3::queueRequest(const Camera *camera, Request *request)
+{
+ return 0;
+}
+
bool PipelineHandlerIPU3::match(DeviceEnumerator *enumerator)
{
DeviceMatch cio2_dm("ipu3-cio2");
@@ -30,6 +30,14 @@ public:
int configureStreams(Camera *camera,
std::map<Stream *, StreamConfiguration> &config) override;
+ int allocateBuffers(Camera *camera, Stream *stream) override;
+ int freeBuffers(Camera *camera, Stream *stream) override;
+
+ int start(const Camera *camera) override;
+ void stop(const Camera *camera) override;
+
+ int queueRequest(const Camera *camera, Request *request) override;
+
bool match(DeviceEnumerator *enumerator);
private:
@@ -82,6 +90,32 @@ int PipelineHandlerUVC::configureStreams(Camera *camera,
return 0;
}
+int PipelineHandlerUVC::allocateBuffers(Camera *camera, Stream *stream)
+{
+ return -ENOTRECOVERABLE;
+}
+
+int PipelineHandlerUVC::freeBuffers(Camera *camera, Stream *stream)
+{
+ return 0;
+}
+
+int PipelineHandlerUVC::start(const Camera *camera)
+{
+ LOG(UVC, Error) << "TODO: start camera";
+ return 0;
+}
+
+void PipelineHandlerUVC::stop(const Camera *camera)
+{
+ LOG(UVC, Error) << "TODO: stop camera";
+}
+
+int PipelineHandlerUVC::queueRequest(const Camera *camera, Request *request)
+{
+ return 0;
+}
+
bool PipelineHandlerUVC::match(DeviceEnumerator *enumerator)
{
DeviceMatch dm("uvcvideo");
@@ -30,6 +30,14 @@ public:
int configureStreams(Camera *camera,
std::map<Stream *, StreamConfiguration> &config) override;
+ int allocateBuffers(Camera *camera, Stream *stream) override;
+ int freeBuffers(Camera *camera, Stream *stream) override;
+
+ int start(const Camera *camera) override;
+ void stop(const Camera *camera) override;
+
+ int queueRequest(const Camera *camera, Request *request) override;
+
bool match(DeviceEnumerator *enumerator);
private:
@@ -77,6 +85,32 @@ int PipeHandlerVimc::configureStreams(Camera *camera,
return 0;
}
+int PipeHandlerVimc::allocateBuffers(Camera *camera, Stream *stream)
+{
+ return -ENOTRECOVERABLE;
+}
+
+int PipeHandlerVimc::freeBuffers(Camera *camera, Stream *stream)
+{
+ return 0;
+}
+
+int PipeHandlerVimc::start(const Camera *camera)
+{
+ LOG(VIMC, Error) << "TODO: start camera";
+ return 0;
+}
+
+void PipeHandlerVimc::stop(const Camera *camera)
+{
+ LOG(VIMC, Error) << "TODO: stop camera";
+}
+
+int PipeHandlerVimc::queueRequest(const Camera *camera, Request *request)
+{
+ return 0;
+}
+
bool PipeHandlerVimc::match(DeviceEnumerator *enumerator)
{
DeviceMatch dm("vimc");
@@ -109,6 +109,73 @@ PipelineHandler::~PipelineHandler()
* \return 0 on success or a negative error code on error.
*/
+/**
+ * \fn PipelineHandler::allocateBuffers()
+ * \brief Allocate buffers for a stream
+ * \param[in] camera The camera the \a stream belongs to
+ * \param[in] stream The stream to allocate buffers for
+ *
+ * This method allocates buffers internally in the pipeline handler and
+ * associates them with the stream's buffer pool.
+ *
+ * The intended caller of this method is the Camera class.
+ *
+ * \return 0 on success or a negative error code on error
+ */
+
+/**
+ * \fn PipelineHandler::freeBuffers()
+ * \brief Free all buffers associated with a stream
+ * \param[in] camera The camera the \a stream belongs to
+ * \param[in] stream The stream to free buffers from
+ *
+ * After a capture session has been stopped all buffers associated with the
+ * stream shall be freed.
+ *
+ * The intended caller of this method is the Camera class.
+ *
+ * \return 0 on success or a negative error code on error
+ */
+
+/**
+ * \fn PipelineHandler::start()
+ * \brief Start capturing from a group of streams
+ * \param[in] camera The camera to start
+ *
+ * Start the group of streams that have been configured for capture by
+ * \a configureStreams(). The intended caller of this method is the Camera
+ * class which will in turn be called from the application to indicate that it
+ * has configured the streams and is ready to capture.
+ *
+ * \return 0 on success or a negative error code on error
+ */
+
+/**
+ * \fn PipelineHandler::stop()
+ * \brief Stop capturing from all running streams
+ * \param[in] camera The camera to stop
+ *
+ * This method stops capturing and processing requests immediately. All pending
+ * requests are cancelled and complete immediately in an error state.
+ *
+ * \todo Complete the pending requests immediately
+ */
+
+/**
+ * \fn PipelineHandler::queueRequest()
+ * \brief Queue a request to the camera
+ * \param[in] camera The camera to queue the request to
+ * \param[in] request The request to queue
+ *
+ * This method queues a capture request to the pipeline handler for processing.
+ * The request contains a set of buffers associated with streams and a set of
+ * parameters. The pipeline handler shall program the device to ensure that the
+ * parameters will be applied to the frames captured in the buffers provided in
+ * the request.
+ *
+ * \return 0 on success or a negative error code on error
+ */
+
/**
* \fn PipelineHandler::match(DeviceEnumerator *enumerator)
* \brief Match media devices and create camera instances