From patchwork Tue Jun 16 14:37:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 11607905 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 39313618 for ; Tue, 16 Jun 2020 14:38:12 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 1FC1220644 for ; Tue, 16 Jun 2020 14:38:12 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="D6KvstmS" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728928AbgFPOiK (ORCPT ); Tue, 16 Jun 2020 10:38:10 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35728 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727804AbgFPOiK (ORCPT ); Tue, 16 Jun 2020 10:38:10 -0400 Received: from mail-ej1-x62b.google.com (mail-ej1-x62b.google.com [IPv6:2a00:1450:4864:20::62b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AC256C06174E for ; Tue, 16 Jun 2020 07:38:09 -0700 (PDT) Received: by mail-ej1-x62b.google.com with SMTP id y13so21781961eju.2 for ; Tue, 16 Jun 2020 07:38:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=I0NvXcxMumO5ln1pcxq8IrXZMMunSbwaH93Ozqoo2qY=; b=D6KvstmSk0YXD0i8uqQdJ61DWUBsCQ27FLB+4FCQRrzhNH+ZCO/wpDxjf7p3BFownW lbmzCSOQpb1IgDGdLNO+U6TQPRAKTYDp3651rvcsLKGWrWunKUKQ8OplQwTTJBzvNY9N hLB2WbtoAVTnYXI4iVoPrH+9agYQ1yRbPiS3PnVQXWRXOmUy5iqOfuRlbb6dgb/NFdFJ llMTwyoip/IQJZ9lqIzC9ZOY/nqmfKBuTfBiPo1cR27g8b4c8yx4Jm+1p9ZPlwpbCPa+ emEwIbYV0iHCJGf/Jwo7xUX0ES4VFzi7MCKZs0R/pUsN+1hSl2PxkOtJXBYNXUsTZ1Ft fVeQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=I0NvXcxMumO5ln1pcxq8IrXZMMunSbwaH93Ozqoo2qY=; b=DUdQ35RzOXc9d1xos494KhS6m4Oem8qXsWOpn80/29HrV6pmwpshB8PYtzN+Awfick sot6W4ccU78B3g8FxkcV82f+1dHqlfvjqf29Q7BH+xx/f6TUtBKpO7bZBboF1Thotnd3 j10ySXVY9LjRz1Cl+L6+n0CBBohOWtaFA4RtgZhXV8/tNRmvug0xhVj6HUQJRiHt1Efy jIT5F4asBOFB7pl6xQG9ZpqZ1fbACdqBCwaJFeSL8MHGpA4fRAWqFVCNfQMtlD7pYrWi 6r6HqdGQPnYVMZH2OpBC3IWxjmBHuH35oJbYRCwY74wsdZ4/8n7FtpH6S4JXU6sx1QpB fKGA== X-Gm-Message-State: AOAM532c2Ux9VkBrEzsbXLAY8sHvECFGL2bMbONVUsqN2nHXNcbm64bI 4Ms0OuktePPa2grpwbPR5Zpb/vj2i+0a8w== X-Google-Smtp-Source: ABdhPJz7yNrh0gZ8l9DxrKI/HoDUZRuCF3F+xxWp9QNDNI7P4YgiNcbHvQ8pnJdsfu2HCjV5WezYhg== X-Received: by 2002:a17:906:cd06:: with SMTP id oz6mr3246023ejb.434.1592318287131; Tue, 16 Jun 2020 07:38:07 -0700 (PDT) Received: from localhost.localdomain (212-5-158-38.ip.btc-net.bg. [212.5.158.38]) by smtp.gmail.com with ESMTPSA id a8sm10163348edb.29.2020.06.16.07.38.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jun 2020 07:38:06 -0700 (PDT) From: Stanimir Varbanov To: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Hans Verkuil , Tomasz Figa , Mauro Carvalho Chehab , Stanimir Varbanov Subject: [PATCH] docs: dev-decoder: Add one more reason for dynamic change Date: Tue, 16 Jun 2020 17:37:35 +0300 Message-Id: <20200616143735.21766-1-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.17.1 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Add bit-depth change as one more reason which could change in the middle of the stream. For the worst case the stream is 8bit at the beginning but later in the bit-stream it changes to 10bit. That change should be propagated to the client so that it can take the appropriate action. In that case it has to stop the streaming on the capture queue, re-negotiate the pixel format, allocate new buffers and start the streaming again. Signed-off-by: Stanimir Varbanov --- Documentation/userspace-api/media/v4l/dev-decoder.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Documentation/userspace-api/media/v4l/dev-decoder.rst b/Documentation/userspace-api/media/v4l/dev-decoder.rst index 606b54947e10..45b31262f360 100644 --- a/Documentation/userspace-api/media/v4l/dev-decoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-decoder.rst @@ -906,7 +906,9 @@ reflected by corresponding queries): * visible resolution (selection rectangles), -* the minimum number of buffers needed for decoding. +* the minimum number of buffers needed for decoding, + +* bit-depth of the bitstream has been changed. Whenever that happens, the decoder must proceed as follows: