[{"id":5388,"web_url":"https://patchwork.libcamera.org/comment/5388/","msgid":"<20200625013909.GT5980@pendragon.ideasonboard.com>","date":"2020-06-25T01:39:09","subject":"Re: [libcamera-devel] [PATCH v3 10/10] libcamera: ipu3: Allow\n\tzero-copy RAW stream capture","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"Hi Niklas,\n\nThank you for the patch.\n\nOn Tue, Jun 23, 2020 at 04:09:30AM +0200, Niklas Söderlund wrote:\n> With the refactored CIO2 interface it's now easy to add zero-copy for\n> buffers in the RAW stream. Use the internally allocated buffers inside\n> the CIO2Device if no buffer for the RAW stream is provided by the\n> application, or use the application-provided buffer if any.\n> \n> Signed-off-by: Niklas Söderlund <niklas.soderlund@ragnatech.se>\n> Reviewed-by: Jacopo Mondi <jacopo@jmondi.org>\n> ---\n> * Changes since v2\n> - Add todo of potential common need code.\n> \n> * Changes since v1\n> - Update comments.\n> - Use Request::findBuffer() instead of own logic.\n> ---\n>  src/libcamera/pipeline/ipu3/cio2.cpp | 58 ++++++++++++++---------\n>  src/libcamera/pipeline/ipu3/cio2.h   |  7 ++-\n>  src/libcamera/pipeline/ipu3/ipu3.cpp | 69 +++++++++-------------------\n>  3 files changed, 61 insertions(+), 73 deletions(-)\n> \n> diff --git a/src/libcamera/pipeline/ipu3/cio2.cpp b/src/libcamera/pipeline/ipu3/cio2.cpp\n> index efaa460b246697a6..ab7f96dad19b0560 100644\n> --- a/src/libcamera/pipeline/ipu3/cio2.cpp\n> +++ b/src/libcamera/pipeline/ipu3/cio2.cpp\n> @@ -213,31 +213,16 @@ int CIO2Device::exportBuffers(unsigned int count,\n>  \treturn output_->exportBuffers(count, buffers);\n>  }\n>  \n> -FrameBuffer *CIO2Device::getBuffer()\n> -{\n> -\tif (availableBuffers_.empty()) {\n> -\t\tLOG(IPU3, Error) << \"CIO2 buffer underrun\";\n> -\t\treturn nullptr;\n> -\t}\n> -\n> -\tFrameBuffer *buffer = availableBuffers_.front();\n> -\n> -\tavailableBuffers_.pop();\n> -\n> -\treturn buffer;\n> -}\n> -\n> -void CIO2Device::putBuffer(FrameBuffer *buffer)\n> -{\n> -\tavailableBuffers_.push(buffer);\n> -}\n> -\n>  int CIO2Device::start()\n>  {\n> -\tint ret = output_->allocateBuffers(CIO2_BUFFER_COUNT, &buffers_);\n> +\tint ret = output_->exportBuffers(CIO2_BUFFER_COUNT, &buffers_);\n>  \tif (ret < 0)\n>  \t\treturn ret;\n>  \n> +\tret = output_->importBuffers(CIO2_BUFFER_COUNT);\n> +\tif (ret)\n> +\t\tLOG(IPU3, Error) << \"Failed to import CIO2 buffers\";\n> +\n>  \tfor (std::unique_ptr<FrameBuffer> &buffer : buffers_)\n>  \t\tavailableBuffers_.push(buffer.get());\n>  \n> @@ -269,11 +254,42 @@ int CIO2Device::stop()\n>  \treturn ret;\n>  }\n>  \n> -int CIO2Device::queueBuffer(FrameBuffer *buffer)\n> +int CIO2Device::queueBuffer(Request *request, FrameBuffer *rawBuffer)\n>  {\n> +\tFrameBuffer *buffer = rawBuffer;\n> +\n> +\t/* If no buffer is provided in the request, use an internal one. */\n> +\tif (!buffer) {\n> +\t\tif (availableBuffers_.empty()) {\n> +\t\t\tLOG(IPU3, Error) << \"CIO2 buffer underrun\";\n> +\t\t\treturn -EINVAL;\n> +\t\t}\n> +\n> +\t\tbuffer = availableBuffers_.front();\n> +\t\tavailableBuffers_.pop();\n> +\t}\n> +\n> +\tbuffer->setRequest(request);\n> +\n>  \treturn output_->queueBuffer(buffer);\n>  }\n>  \n> +void CIO2Device::tryReturnBuffer(FrameBuffer *buffer)\n> +{\n> +\t/*\n> +\t * \\todo Once more pipelines deal with buffers that may be allocated\n> +\t * internally or externally at the this pattern might become a common\n\n\"at the this\" ?\n\nReviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\n\n> +\t * need. At that point this check should be moved to something clever\n> +\t * in FrameBuffer.\n> +\t */\n> +\tfor (const std::unique_ptr<FrameBuffer> &buf : buffers_) {\n> +\t\tif (buf.get() == buffer) {\n> +\t\t\tavailableBuffers_.push(buffer);\n> +\t\t\tbreak;\n> +\t\t}\n> +\t}\n> +}\n> +\n>  void CIO2Device::cio2BufferReady(FrameBuffer *buffer)\n>  {\n>  \tbufferReady.emit(buffer);\n> diff --git a/src/libcamera/pipeline/ipu3/cio2.h b/src/libcamera/pipeline/ipu3/cio2.h\n> index 405e6c03755367c4..9f2e8a98af7043eb 100644\n> --- a/src/libcamera/pipeline/ipu3/cio2.h\n> +++ b/src/libcamera/pipeline/ipu3/cio2.h\n> @@ -18,6 +18,7 @@ namespace libcamera {\n>  class CameraSensor;\n>  class FrameBuffer;\n>  class MediaDevice;\n> +class Request;\n>  class V4L2DeviceFormat;\n>  class V4L2Subdevice;\n>  class V4L2VideoDevice;\n> @@ -40,15 +41,13 @@ public:\n>  \tint exportBuffers(unsigned int count,\n>  \t\t\t  std::vector<std::unique_ptr<FrameBuffer>> *buffers);\n>  \n> -\tFrameBuffer *getBuffer();\n> -\tvoid putBuffer(FrameBuffer *buffer);\n> -\n>  \tint start();\n>  \tint stop();\n>  \n>  \tCameraSensor *sensor() { return sensor_; }\n>  \n> -\tint queueBuffer(FrameBuffer *buffer);\n> +\tint queueBuffer(Request *request, FrameBuffer *rawBuffer);\n> +\tvoid tryReturnBuffer(FrameBuffer *buffer);\n>  \tSignal<FrameBuffer *> bufferReady;\n>  \n>  private:\n> diff --git a/src/libcamera/pipeline/ipu3/ipu3.cpp b/src/libcamera/pipeline/ipu3/ipu3.cpp\n> index 4818027e8db1f7a3..6c43169eb0915965 100644\n> --- a/src/libcamera/pipeline/ipu3/ipu3.cpp\n> +++ b/src/libcamera/pipeline/ipu3/ipu3.cpp\n> @@ -122,7 +122,6 @@ public:\n>  \t}\n>  \n>  \tvoid imguOutputBufferReady(FrameBuffer *buffer);\n> -\tvoid imguInputBufferReady(FrameBuffer *buffer);\n>  \tvoid cio2BufferReady(FrameBuffer *buffer);\n>  \n>  \tCIO2Device cio2_;\n> @@ -737,25 +736,24 @@ void PipelineHandlerIPU3::stop(Camera *camera)\n>  int PipelineHandlerIPU3::queueRequestDevice(Camera *camera, Request *request)\n>  {\n>  \tIPU3CameraData *data = cameraData(camera);\n> -\tFrameBuffer *buffer;\n>  \tint error = 0;\n>  \n> -\t/* Get a CIO2 buffer, associate it with the request and queue it. */\n> -\tbuffer = data->cio2_.getBuffer();\n> -\tif (!buffer)\n> -\t\treturn -EINVAL;\n> -\n> -\tbuffer->setRequest(request);\n> -\tdata->cio2_.queueBuffer(buffer);\n> +\t/*\n> +\t * Queue a buffer on the CIO2, using the raw stream buffer provided in\n> +\t * the request, if any, or a CIO2 internal buffer otherwise.\n> +\t */\n> +\tFrameBuffer *rawBuffer = request->findBuffer(&data->rawStream_);\n> +\terror = data->cio2_.queueBuffer(request, rawBuffer);\n> +\tif (error)\n> +\t\treturn error;\n>  \n> +\t/* Queue all buffers from the request aimed for the ImgU. */\n>  \tfor (auto it : request->buffers()) {\n>  \t\tIPU3Stream *stream = static_cast<IPU3Stream *>(it.first);\n> -\t\tbuffer = it.second;\n> -\n> -\t\t/* Skip raw streams, they are copied from the CIO2 buffer. */\n>  \t\tif (stream->raw_)\n>  \t\t\tcontinue;\n>  \n> +\t\tFrameBuffer *buffer = it.second;\n>  \t\tint ret = stream->device_->dev->queueBuffer(buffer);\n>  \t\tif (ret < 0)\n>  \t\t\terror = ret;\n> @@ -885,8 +883,8 @@ int PipelineHandlerIPU3::registerCameras()\n>  \t\t */\n>  \t\tdata->cio2_.bufferReady.connect(data.get(),\n>  \t\t\t\t\t&IPU3CameraData::cio2BufferReady);\n> -\t\tdata->imgu_->input_->bufferReady.connect(data.get(),\n> -\t\t\t\t\t&IPU3CameraData::imguInputBufferReady);\n> +\t\tdata->imgu_->input_->bufferReady.connect(&data->cio2_,\n> +\t\t\t\t\t&CIO2Device::tryReturnBuffer);\n>  \t\tdata->imgu_->output_.dev->bufferReady.connect(data.get(),\n>  \t\t\t\t\t&IPU3CameraData::imguOutputBufferReady);\n>  \t\tdata->imgu_->viewfinder_.dev->bufferReady.connect(data.get(),\n> @@ -915,22 +913,6 @@ int PipelineHandlerIPU3::registerCameras()\n>   * Buffer Ready slots\n>   */\n>  \n> -/**\n> - * \\brief Handle buffers completion at the ImgU input\n> - * \\param[in] buffer The completed buffer\n> - *\n> - * Buffers completed from the ImgU input are immediately queued back to the\n> - * CIO2 unit to continue frame capture.\n> - */\n> -void IPU3CameraData::imguInputBufferReady(FrameBuffer *buffer)\n> -{\n> -\t/* \\todo Handle buffer failures when state is set to BufferError. */\n> -\tif (buffer->metadata().status == FrameMetadata::FrameCancelled)\n> -\t\treturn;\n> -\n> -\tcio2_.putBuffer(buffer);\n> -}\n> -\n>  /**\n>   * \\brief Handle buffers completion at the ImgU output\n>   * \\param[in] buffer The completed buffer\n> @@ -963,27 +945,18 @@ void IPU3CameraData::cio2BufferReady(FrameBuffer *buffer)\n>  \t\treturn;\n>  \n>  \tRequest *request = buffer->request();\n> -\tFrameBuffer *raw = request->findBuffer(&rawStream_);\n>  \n> -\tif (!raw) {\n> -\t\t/* No RAW buffers present, just queue to IMGU. */\n> -\t\timgu_->input_->queueBuffer(buffer);\n> -\t\treturn;\n> -\t}\n> -\n> -\t/* RAW buffers present, special care is needed. */\n> -\tif (request->buffers().size() > 1)\n> -\t\timgu_->input_->queueBuffer(buffer);\n> -\n> -\tif (raw->copyFrom(buffer))\n> -\t\tLOG(IPU3, Debug) << \"Copy of FrameBuffer failed\";\n> -\n> -\tpipe_->completeBuffer(camera_, request, raw);\n> -\n> -\tif (request->buffers().size() == 1) {\n> -\t\tcio2_.putBuffer(buffer);\n> +\t/*\n> +\t * If the request contains a buffer for the RAW stream only, complete it\n> +\t * now as there's no need for ImgU processing.\n> +\t */\n> +\tif (request->findBuffer(&rawStream_) &&\n> +\t    pipe_->completeBuffer(camera_, request, buffer)) {\n>  \t\tpipe_->completeRequest(camera_, request);\n> +\t\treturn;\n>  \t}\n> +\n> +\timgu_->input_->queueBuffer(buffer);\n>  }\n>  \n>  /* -----------------------------------------------------------------------------","headers":{"Return-Path":"<libcamera-devel-bounces@lists.libcamera.org>","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id C4486C0101\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 25 Jun 2020 01:39:12 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 5CB08603BE;\n\tThu, 25 Jun 2020 03:39:12 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id ACA95603BB\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 25 Jun 2020 03:39:10 +0200 (CEST)","from pendragon.ideasonboard.com (81-175-216-236.bb.dnainternet.fi\n\t[81.175.216.236])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 2E2C6A60;\n\tThu, 25 Jun 2020 03:39:10 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"mTUoUYkr\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1593049150;\n\tbh=7CUMccVEiOniRAdSaX6ZAtEtL2r6jByq/DeEez8woVw=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=mTUoUYkrRvcDuIPnDz/2GXEbYTzDapNQdnnFUruDlc3/nmrtpgcGm5OHo6rYh7gcy\n\tlLwyZMd/4NADketY4owzKdcFapfHQK0DbOGE0l/9bXC0AvpN1ldpdhYA45i0qbP0xh\n\tZwhUZKV6AK9/DbkIkLPSFh+0S2OvkOzqVLCU9dr4=","Date":"Thu, 25 Jun 2020 04:39:09 +0300","From":"Laurent Pinchart <laurent.pinchart@ideasonboard.com>","To":"Niklas =?utf-8?q?S=C3=B6derlund?= <niklas.soderlund@ragnatech.se>","Message-ID":"<20200625013909.GT5980@pendragon.ideasonboard.com>","References":"<20200623020930.1781469-1-niklas.soderlund@ragnatech.se>\n\t<20200623020930.1781469-11-niklas.soderlund@ragnatech.se>","MIME-Version":"1.0","Content-Disposition":"inline","In-Reply-To":"<20200623020930.1781469-11-niklas.soderlund@ragnatech.se>","Subject":"Re: [libcamera-devel] [PATCH v3 10/10] libcamera: ipu3: Allow\n\tzero-copy RAW stream capture","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"<libcamera-devel.lists.libcamera.org>","List-Unsubscribe":"<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>","List-Archive":"<https://lists.libcamera.org/pipermail/libcamera-devel/>","List-Post":"<mailto:libcamera-devel@lists.libcamera.org>","List-Help":"<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>","List-Subscribe":"<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>","Cc":"libcamera-devel@lists.libcamera.org","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"base64","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"}}]