Patch Detail

HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 10356,
    "url": "https://patchwork.libcamera.org/api/patches/10356/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/10356/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20201106103707.49660-9-paul.elder@ideasonboard.com>",
    "date": "2020-11-06T10:36:38",
    "name": "[libcamera-devel,v4,08/37] libcamera: Add IPADataSerializer",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "c87a006473561c3dd3e86f6c691005f73efb8eeb",
    "submitter": {
        "id": 17,
        "url": "https://patchwork.libcamera.org/api/people/17/?format=api",
        "name": "Paul Elder",
        "email": "paul.elder@ideasonboard.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/10356/mbox/",
    "series": [
        {
            "id": 1448,
            "url": "https://patchwork.libcamera.org/api/series/1448/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=1448",
            "date": "2020-11-06T10:36:30",
            "name": "IPA isolation implementation",
            "version": 4,
            "mbox": "https://patchwork.libcamera.org/series/1448/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/10356/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/10356/checks/",
    "tags": {},
    "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 CB0CDBDB89\n\tfor <parsemail@patchwork.libcamera.org>;\n\tFri,  6 Nov 2020 10:37:41 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 9566362D34;\n\tFri,  6 Nov 2020 11:37:41 +0100 (CET)",
            "from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 71D3C62D2B\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tFri,  6 Nov 2020 11:37:40 +0100 (CET)",
            "from pyrite.rasen.tech (unknown\n\t[IPv6:2400:4051:61:600:2c71:1b79:d06d:5032])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id EBB2FB16;\n\tFri,  6 Nov 2020 11:37:38 +0100 (CET)"
        ],
        "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=\"NbPp9F/N\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1604659060;\n\tbh=7vhmcqhdbfghme6zzD10/G4Jl8ckE03XJg4uSUJfNEg=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=NbPp9F/NGzjK5KYMc4UTxingTJB7icJWr74pFNXjqFE8sDvJIeaZE9AKFK5P105Q+\n\tmfKvXFNNoMHbaPr/0QjKdd6iJKNLU3fTT0+bMDdeHLW7kwcQvS5Hqw1iWdzBqlgX9a\n\t+3IOgO+MwV2IX1mZo+MACHVNqZ4LOwQ4OrPrw+04=",
        "From": "Paul Elder <paul.elder@ideasonboard.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Fri,  6 Nov 2020 19:36:38 +0900",
        "Message-Id": "<20201106103707.49660-9-paul.elder@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.27.0",
        "In-Reply-To": "<20201106103707.49660-1-paul.elder@ideasonboard.com>",
        "References": "<20201106103707.49660-1-paul.elder@ideasonboard.com>",
        "MIME-Version": "1.0",
        "Subject": "[libcamera-devel] [PATCH v4 08/37] libcamera: Add IPADataSerializer",
        "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>",
        "Content-Type": "text/plain; charset=\"us-ascii\"",
        "Content-Transfer-Encoding": "7bit",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "Add an IPADataSerializer which implments de/serialization of built-in\n(PODs, vector, map, string) and libcamera data structures. This is\nintended to be used by the proxy and the proxy worker in the IPC layer.\n\nSigned-off-by: Paul Elder <paul.elder@ideasonboard.com>\n\n---\nChanges in v4:\n- rename readUInt/appendUInt to readPOD/appendPOD\n  - put them in anonymous namespace\n  - and add length check\n    - fatal if failure, because it means not enough data to deserialize,\n      which is technically a segfault\n  - use the new readPOD/appendPOD with length protections\n  - expand on their docs correspondingly\n- change snake_case to camelCase\n- add optimizations to the hand-written de/serializers\n- reserve vector length where trivially possible\n- remove unnecessary IPADataSerializer<type>:: explicit calls (if\n  they're calling a specialization from the same specialization)\n\nChanges in v3:\n- reimplement append/readUInt with memcpy (intead of bit shifting)\n- change DECLARE_INTEGRAL_SERIALIZER with DECLARE_POD_SERIALIZER\n  - use this for int64_t, bool, float, and double\n- fix comment style\n\nChanges in v2:\n- added serializers for all integer types, bool, and string\n- use string serializer for IPASettings serializer\n- add documentation\n- add serializer for const ControlList\n---\n .../libcamera/internal/ipa_data_serializer.h  | 1004 +++++++++++++++++\n src/libcamera/ipa_data_serializer.cpp         |  178 +++\n src/libcamera/meson.build                     |    1 +\n 3 files changed, 1183 insertions(+)\n create mode 100644 include/libcamera/internal/ipa_data_serializer.h\n create mode 100644 src/libcamera/ipa_data_serializer.cpp",
    "diff": "diff --git a/include/libcamera/internal/ipa_data_serializer.h b/include/libcamera/internal/ipa_data_serializer.h\nnew file mode 100644\nindex 00000000..9a18f914\n--- /dev/null\n+++ b/include/libcamera/internal/ipa_data_serializer.h\n@@ -0,0 +1,1004 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2020, Google Inc.\n+ *\n+ * ipa_data_serializer.h - Image Processing Algorithm data serializer\n+ */\n+#ifndef __LIBCAMERA_INTERNAL_IPA_DATA_SERIALIZER_H__\n+#define __LIBCAMERA_INTERNAL_IPA_DATA_SERIALIZER_H__\n+\n+#include <deque>\n+#include <iostream>\n+#include <string.h>\n+#include <tuple>\n+#include <vector>\n+\n+#include <libcamera/buffer.h>\n+#include <libcamera/control_ids.h>\n+#include <libcamera/geometry.h>\n+#include <libcamera/ipa/ipa_interface.h>\n+\n+#include \"libcamera/internal/byte_stream_buffer.h\"\n+#include \"libcamera/internal/camera_sensor.h\"\n+#include \"libcamera/internal/control_serializer.h\"\n+#include \"libcamera/internal/log.h\"\n+\n+namespace libcamera {\n+\n+LOG_DECLARE_CATEGORY(IPADataSerializer)\n+\n+namespace {\n+\n+template<typename T>\n+void appendPOD(std::vector<uint8_t> &vec, T val)\n+{\n+\tsize_t byteWidth = sizeof(val);\n+\tstd::vector<uint8_t> v(byteWidth);\n+\tmemcpy(&v[0], &val, byteWidth);\n+\n+\tvec.insert(vec.end(), v.begin(), v.end());\n+}\n+\n+template<typename T>\n+T readPOD(std::vector<uint8_t> &vec, size_t pos)\n+{\n+\tT ret = 0;\n+\tsize_t byteWidth = sizeof(ret);\n+\tif (pos + byteWidth > vec.size())\n+\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t<< \"Not enough data to deserialize POD\";\n+\n+\tmemcpy(&ret, &vec[pos], byteWidth);\n+\treturn ret;\n+}\n+\n+template<typename T>\n+T readPOD(std::vector<uint8_t>::iterator it, size_t pos,\n+\t  std::vector<uint8_t>::iterator end)\n+{\n+\tT ret = 0;\n+\tsize_t byteWidth = sizeof(ret);\n+\n+\tif (pos + it >= end)\n+\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t<< \"Not enough data to deserialize POD\";\n+\n+\tstd::vector<uint8_t> v(it + pos, it + pos + byteWidth);\n+\tmemcpy(&ret, v.data(), byteWidth);\n+\treturn ret;\n+}\n+\n+} /* namespace */\n+\n+template<typename T>\n+class IPADataSerializer\n+{\n+#ifdef __DOXYGEN__\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(T data, ControlSerializer *cs);\n+\n+\tstatic T deserialize(std::vector<uint8_t> &data,\n+\t\t\t     ControlSerializer *cs);\n+\tstatic T deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t     std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t     ControlSerializer *cs);\n+\n+\tstatic T deserialize(std::vector<uint8_t> &data,\n+\t\t\t     std::vector<int32_t> &fds,\n+\t\t\t     ControlSerializer *cs);\n+\tstatic T deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t     std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t     std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t     std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t     ControlSerializer *cs);\n+#endif /* __DOXYGEN__ */\n+};\n+\n+#ifndef __DOXYGEN__\n+\n+template<typename V>\n+class IPADataSerializer<std::vector<V>>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const std::vector<V> &data, ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tstd::vector<int32_t> fdsVec;\n+\n+\t\t/* Serialize the length. */\n+\t\tuint32_t vecLen = data.size();\n+\t\tappendPOD<uint32_t>(dataVec, vecLen);\n+\n+\t\t/* Serialize the members. */\n+\t\tfor (auto const &it : data) {\n+\t\t\tstd::vector<uint8_t> dvec;\n+\t\t\tstd::vector<int32_t> fvec;\n+\n+\t\t\tstd::tie(dvec, fvec) =\n+\t\t\t\tIPADataSerializer<V>::serialize(it, cs);\n+\n+\t\t\tappendPOD<uint32_t>(dataVec, dvec.size());\n+\t\t\tappendPOD<uint32_t>(dataVec, fvec.size());\n+\n+\t\t\tdataVec.insert(dataVec.end(), dvec.begin(), dvec.end());\n+\t\t\tfdsVec.insert(fdsVec.end(), fvec.begin(), fvec.end());\n+\t\t}\n+\n+\t\treturn {dataVec, fdsVec};\n+\t}\n+\n+\tstatic std::vector<V> deserialize(std::vector<uint8_t> &data, ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic std::vector<V> deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<int32_t> fds;\n+\t\treturn deserialize(dataBegin, dataEnd, fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic std::vector<V> deserialize(std::vector<uint8_t> &data, std::vector<int32_t> &fds,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic std::vector<V> deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\tuint32_t vecLen = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\t\tstd::vector<V> ret(vecLen);\n+\n+\t\tstd::vector<uint8_t>::iterator dataIter = dataBegin + 4;\n+\t\tstd::vector<int32_t>::iterator fdIter = fdsBegin;\n+\t\tfor (uint32_t i = 0; i < vecLen; i++) {\n+\t\t\tuint32_t sizeofData = readPOD<uint32_t>(dataIter, 0, dataEnd);\n+\t\t\tuint32_t sizeofFds  = readPOD<uint32_t>(dataIter, 4, dataEnd);\n+\n+\t\t\tret[i] = IPADataSerializer<V>::deserialize(dataIter + 8,\n+\t\t\t\t\t\t\t\t   dataIter + 8 + sizeofData,\n+\t\t\t\t\t\t\t\t   fdIter,\n+\t\t\t\t\t\t\t\t   fdIter + sizeofFds,\n+\t\t\t\t\t\t\t\t   cs);\n+\n+\t\t\tdataIter += 8 + sizeofData;\n+\t\t\tfdIter += sizeofFds;\n+\t\t}\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+template<typename K, typename V>\n+class IPADataSerializer<std::map<K, V>>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const std::map<K, V> &data, ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tstd::vector<int32_t> fdsVec;\n+\n+\t\t/* Serialize the length. */\n+\t\tuint32_t mapLen = data.size();\n+\t\tappendPOD<uint32_t>(dataVec, mapLen);\n+\n+\t\t/* Serialize the members. */\n+\t\tfor (auto const &it : data) {\n+\t\t\tstd::vector<uint8_t> dvec;\n+\t\t\tstd::vector<int32_t> fvec;\n+\n+\t\t\tstd::tie(dvec, fvec) =\n+\t\t\t\tIPADataSerializer<K>::serialize(it.first, cs);\n+\n+\t\t\tappendPOD<uint32_t>(dataVec, dvec.size());\n+\t\t\tappendPOD<uint32_t>(dataVec, fvec.size());\n+\n+\t\t\tdataVec.insert(dataVec.end(), dvec.begin(), dvec.end());\n+\t\t\tfdsVec.insert(fdsVec.end(), fvec.begin(), fvec.end());\n+\n+\t\t\tstd::tie(dvec, fvec) =\n+\t\t\t\tIPADataSerializer<V>::serialize(it.second, cs);\n+\n+\t\t\tappendPOD<uint32_t>(dataVec, dvec.size());\n+\t\t\tappendPOD<uint32_t>(dataVec, fvec.size());\n+\n+\t\t\tdataVec.insert(dataVec.end(), dvec.begin(), dvec.end());\n+\t\t\tfdsVec.insert(fdsVec.end(), fvec.begin(), fvec.end());\n+\t\t}\n+\n+\t\treturn {dataVec, fdsVec};\n+\t}\n+\n+\tstatic std::map<K, V> deserialize(std::vector<uint8_t> &data, ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic std::map<K, V> deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<int32_t> fds;\n+\t\treturn deserialize(dataBegin, dataEnd, fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic std::map<K, V> deserialize(std::vector<uint8_t> &data, std::vector<int32_t> &fds,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic std::map<K, V> deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t  ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::map<K, V> ret;\n+\n+\t\tuint32_t mapLen = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\n+\t\tstd::vector<uint8_t>::iterator dataIter = dataBegin + 4;\n+\t\tstd::vector<int32_t>::iterator fdIter = fdsBegin;\n+\t\tfor (uint32_t i = 0; i < mapLen; i++) {\n+\t\t\tuint32_t sizeofData = readPOD<uint32_t>(dataIter, 0, dataEnd);\n+\t\t\tuint32_t sizeofFds  = readPOD<uint32_t>(dataIter, 4, dataEnd);\n+\n+\t\t\tK key = IPADataSerializer<K>::deserialize(dataIter + 8,\n+\t\t\t\t\t\t\t\t  dataIter + 8 + sizeofData,\n+\t\t\t\t\t\t\t\t  fdIter,\n+\t\t\t\t\t\t\t\t  fdIter + sizeofFds,\n+\t\t\t\t\t\t\t\t  cs);\n+\n+\t\t\tdataIter += 8 + sizeofData;\n+\t\t\tfdIter += sizeofFds;\n+\t\t\tsizeofData = readPOD<uint32_t>(dataIter, 0, dataEnd);\n+\t\t\tsizeofFds  = readPOD<uint32_t>(dataIter, 4, dataEnd);\n+\n+\t\t\tconst V value = IPADataSerializer<V>::deserialize(dataIter + 8,\n+\t\t\t\t\t\t\t\t\t  dataIter + 8 + sizeofData,\n+\t\t\t\t\t\t\t\t\t  fdIter,\n+\t\t\t\t\t\t\t\t\t  fdIter + sizeofFds,\n+\t\t\t\t\t\t\t\t\t  cs);\n+\t\t\tret.insert({key, value});\n+\n+\t\t\tdataIter += 8 + sizeofData;\n+\t\t\tfdIter += sizeofFds;\n+\t\t}\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+#define DECLARE_POD_SERIALIZER(type)\t\t\t\t\t\\\n+template<>\t\t\t\t\t\t\t\t\\\n+class IPADataSerializer<type>\t\t\t\t\t\t\\\n+{\t\t\t\t\t\t\t\t\t\\\n+public:\t\t\t\t\t\t\t\t\t\\\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\t\\\n+\tserialize(const type data,\t\t\t\t\t\\\n+\t\t  [[maybe_unused]] ControlSerializer *cs = nullptr)\t\\\n+\t{\t\t\t\t\t\t\t\t\\\n+\t\tstd::vector<uint8_t> dataVec;\t\t\t\t\\\n+\t\tdataVec.reserve(sizeof(type));\t\t\t\t\\\n+\t\tappendPOD<type>(dataVec, data);\t\t\t\\\n+\t\t\t\t\t\t\t\t\t\\\n+\t\treturn {dataVec, {}};\t\t\t\t\t\\\n+\t}\t\t\t\t\t\t\t\t\\\n+\t\t\t\t\t\t\t\t\t\\\n+\tstatic type deserialize(std::vector<uint8_t> &data,\t\t\\\n+\t\t\t\t[[maybe_unused]] ControlSerializer *cs = nullptr)\\\n+\t{\t\t\t\t\t\t\t\t\\\n+\t\treturn deserialize(data.begin(), data.end());\t\t\\\n+\t}\t\t\t\t\t\t\t\t\\\n+\t\t\t\t\t\t\t\t\t\\\n+\tstatic type deserialize(std::vector<uint8_t>::iterator dataBegin,\\\n+\t\t\t\t[[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\\\n+\t\t\t\t[[maybe_unused]] ControlSerializer *cs = nullptr)\\\n+\t{\t\t\t\t\t\t\t\t\\\n+\t\treturn readPOD<type>(dataBegin, 0, dataEnd);\t\t\\\n+\t}\t\t\t\t\t\t\t\t\\\n+\t\t\t\t\t\t\t\t\t\\\n+\tstatic type deserialize(std::vector<uint8_t> &data,\t\t\\\n+\t\t\t\t[[maybe_unused]] std::vector<int32_t> &fds,\\\n+\t\t\t\t[[maybe_unused]] ControlSerializer *cs = nullptr)\\\n+\t{\t\t\t\t\t\t\t\t\\\n+\t\treturn deserialize(data.begin(), data.end());\t\t\\\n+\t}\t\t\t\t\t\t\t\t\\\n+\t\t\t\t\t\t\t\t\t\\\n+\tstatic type deserialize(std::vector<uint8_t>::iterator dataBegin,\\\n+\t\t\t\tstd::vector<uint8_t>::iterator dataEnd,\\\n+\t\t\t\t[[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\\\n+\t\t\t\t[[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\\\n+\t\t\t\t[[maybe_unused]] ControlSerializer *cs = nullptr)\\\n+\t{\t\t\t\t\t\t\t\t\\\n+\t\treturn deserialize(dataBegin, dataEnd);\t\t\t\\\n+\t}\t\t\t\t\t\t\t\t\\\n+};\n+\n+DECLARE_POD_SERIALIZER(bool)\n+DECLARE_POD_SERIALIZER(uint8_t)\n+DECLARE_POD_SERIALIZER(uint16_t)\n+DECLARE_POD_SERIALIZER(uint32_t)\n+DECLARE_POD_SERIALIZER(uint64_t)\n+DECLARE_POD_SERIALIZER(int8_t)\n+DECLARE_POD_SERIALIZER(int16_t)\n+DECLARE_POD_SERIALIZER(int32_t)\n+DECLARE_POD_SERIALIZER(int64_t)\n+DECLARE_POD_SERIALIZER(float)\n+DECLARE_POD_SERIALIZER(double)\n+\n+template<>\n+class IPADataSerializer<std::string>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const std::string &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn {{data.begin(), data.end()}, {}};\n+\t}\n+\n+\tstatic std::string deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn {data.begin(), data.end()};\n+\t}\n+\n+\tstatic std::string deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn {dataBegin, dataEnd};\n+\t}\n+\n+\tstatic std::string deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn {data.begin(), data.end()};\n+\t}\n+\n+\tstatic std::string deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn {dataBegin, dataEnd};\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<FileDescriptor>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const FileDescriptor &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec = { data.isValid() };\n+\t\tstd::vector<int32_t> fdVec;\n+\t\tif (data.isValid())\n+\t\t\tfdVec.push_back(data.fd());\n+\n+\t\treturn {dataVec, fdVec};\n+\t}\n+\n+\tstatic FileDescriptor deserialize(std::vector<uint8_t> &data, std::vector<int32_t> &fds,\n+\t\t\t\t\t  [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), fds.begin(), fds.end());\n+\t}\n+\n+\tstatic FileDescriptor deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t  std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t  [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tif (std::distance(dataBegin, dataEnd) < 1)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"Invalid data to deserialize FileDescriptor\";\n+\n+\t\tbool valid = !!(*dataBegin);\n+\n+\t\tif (valid && std::distance(fdsBegin, fdsEnd) < 1)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"Invalid fds to deserialize FileDescriptor\";\n+\n+\t\treturn valid ? FileDescriptor(*fdsBegin) : FileDescriptor();\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<IPASettings>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const IPASettings &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn IPADataSerializer<std::string>::serialize(data.configurationFile);\n+\t}\n+\n+\tstatic IPASettings deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn { IPADataSerializer<std::string>::deserialize(data.begin(), data.end()) };\n+\t}\n+\n+\tstatic IPASettings deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn { IPADataSerializer<std::string>::deserialize(dataBegin, dataEnd) };\n+\t}\n+\n+\tstatic IPASettings deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn { IPADataSerializer<std::string>::deserialize(data.begin(), data.end()) };\n+\t}\n+\n+\tstatic IPASettings deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t       [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn { IPADataSerializer<std::string>::deserialize(dataBegin, dataEnd) };\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<CameraSensorInfo>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const CameraSensorInfo &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\n+\t\tuint32_t strLen = data.model.size();\n+\t\tappendPOD<uint32_t>(dataVec, strLen);\n+\n+\t\tdataVec.insert(dataVec.end(), data.model.begin(), data.model.end());\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.bitsPerPixel);\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.activeAreaSize.width);\n+\t\tappendPOD<uint32_t>(dataVec, data.activeAreaSize.height);\n+\n+\t\tappendPOD<uint32_t>(dataVec, static_cast<uint32_t>(data.analogCrop.x));\n+\t\tappendPOD<uint32_t>(dataVec, static_cast<uint32_t>(data.analogCrop.y));\n+\t\tappendPOD<uint32_t>(dataVec, data.analogCrop.width);\n+\t\tappendPOD<uint32_t>(dataVec, data.analogCrop.height);\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.outputSize.width);\n+\t\tappendPOD<uint32_t>(dataVec, data.outputSize.height);\n+\n+\t\tappendPOD<uint64_t>(dataVec, data.pixelRate);\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.lineLength);\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic CameraSensorInfo deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t    [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end());\n+\t}\n+\n+\tstatic CameraSensorInfo deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t    [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t    [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tCameraSensorInfo ret;\n+\n+\t\tuint32_t strLen = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\t\tstd::string str(dataBegin + 4, dataBegin + 4 + strLen);\n+\t\tret.model = str;\n+\n+\t\tstd::vector<uint8_t>::iterator it = dataBegin + 4 + strLen;\n+\n+\t\tret.bitsPerPixel = readPOD<uint32_t>(it, 0, dataEnd);\n+\n+\t\tret.activeAreaSize.width = readPOD<uint32_t>(it, 4, dataEnd);\n+\t\tret.activeAreaSize.height = readPOD<uint32_t>(it, 8, dataEnd);\n+\n+\t\tret.analogCrop.x = static_cast<int32_t>(readPOD<uint32_t>(it, 12, dataEnd));\n+\t\tret.analogCrop.y = static_cast<int32_t>(readPOD<uint32_t>(it, 16, dataEnd));\n+\t\tret.analogCrop.width = readPOD<uint32_t>(it, 20, dataEnd);\n+\t\tret.analogCrop.height = readPOD<uint32_t>(it, 24, dataEnd);\n+\n+\t\tret.outputSize.width = readPOD<uint32_t>(it, 28, dataEnd);\n+\t\tret.outputSize.height = readPOD<uint32_t>(it, 32, dataEnd);\n+\n+\t\tret.pixelRate = readPOD<uint64_t>(it, 36, dataEnd);\n+\n+\t\tret.lineLength = readPOD<uint32_t>(it, 44, dataEnd);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic CameraSensorInfo deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t    [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t\t    [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end());\n+\t}\n+\n+\tstatic CameraSensorInfo deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t    std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t    [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t    [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t    [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(dataBegin, dataEnd);\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<IPAStream>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const IPAStream &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.pixelFormat);\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.size.width);\n+\t\tappendPOD<uint32_t>(dataVec, data.size.height);\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic IPAStream deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t     [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end());\n+\t}\n+\n+\tstatic IPAStream deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t     [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t     [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tIPAStream ret;\n+\n+\t\tret.pixelFormat = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\n+\t\tret.size.width = readPOD<uint32_t>(dataBegin, 4, dataEnd);\n+\t\tret.size.height = readPOD<uint32_t>(dataBegin, 8, dataEnd);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic IPAStream deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t     [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t     [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end());\n+\t}\n+\n+\tstatic IPAStream deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t     std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t     [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t     [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t     [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(dataBegin, dataEnd);\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<const ControlList>\n+{\n+public:\n+\t/* map arg will be generated, since it's per-pipeline anyway. */\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const ControlList &data, const ControlInfoMap &map,\n+\t\t  ControlSerializer *cs)\n+\t{\n+\t\tif (!cs)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"ControlSerializer not provided for serialization of ControlList\";\n+\n+\t\tsize_t size = cs->binarySize(map);\n+\t\tstd::vector<uint8_t> infoData(size);\n+\t\tByteStreamBuffer buffer(infoData.data(), infoData.size());\n+\t\tint ret = cs->serialize(map, buffer);\n+\n+\t\tif (ret < 0 || buffer.overflow()) {\n+\t\t\tLOG(IPADataSerializer, Error) << \"Failed to serialize ControlList's ControlInfoMap\";\n+\t\t\treturn {{}, {}};\n+\t\t}\n+\n+\t\tsize = cs->binarySize(data);\n+\t\tstd::vector<uint8_t> listData(size);\n+\t\tbuffer = ByteStreamBuffer(listData.data(), listData.size());\n+\t\tret = cs->serialize(data, buffer);\n+\n+\t\tif (ret < 0 || buffer.overflow()) {\n+\t\t\tLOG(IPADataSerializer, Error) << \"Failed to serialize ControlList\";\n+\t\t\treturn {{}, {}};\n+\t\t}\n+\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tdataVec.reserve(8 + infoData.size() + listData.size());\n+\t\tappendPOD<uint32_t>(dataVec, infoData.size());\n+\t\tappendPOD<uint32_t>(dataVec, listData.size());\n+\t\tdataVec.insert(dataVec.end(), infoData.begin(), infoData.end());\n+\t\tdataVec.insert(dataVec.end(), listData.begin(), listData.end());\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic const ControlList deserialize(std::vector<uint8_t> &data, ControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic const ControlList deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\tif (!cs)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"ControlSerializer not provided for deserialization of ControlList\";\n+\n+\t\tuint32_t infoDataSize = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\t\tuint32_t listDataSize = readPOD<uint32_t>(dataBegin, 4, dataEnd);\n+\n+\t\tstd::vector<uint8_t>::iterator it = dataBegin + 8;\n+\n+\t\tstd::vector<uint8_t> infoData(it, it + infoDataSize);\n+\t\tstd::vector<uint8_t> listData(it + infoDataSize, it + infoDataSize + listDataSize);\n+\n+\t\tByteStreamBuffer buffer(const_cast<const uint8_t *>(infoData.data()), infoData.size());\n+\t\tControlInfoMap map = cs->deserialize<ControlInfoMap>(buffer);\n+\t\t/* It's fine if map is empty. */\n+\t\tif (buffer.overflow()) {\n+\t\t\tLOG(IPADataSerializer, Error)\n+\t\t\t\t<< \"Failed to deserialize ControlLists's ControlInfoMap: buffer overflow\";\n+\t\t\treturn ControlList();\n+\t\t}\n+\n+\t\tbuffer = ByteStreamBuffer(const_cast<const uint8_t *>(listData.data()), listData.size());\n+\t\tControlList list = cs->deserialize<ControlList>(buffer);\n+\t\tif (buffer.overflow())\n+\t\t\tLOG(IPADataSerializer, Error) << \"Failed to deserialize ControlList: buffer overflow\";\n+\t\tif (list.empty())\n+\t\t\tLOG(IPADataSerializer, Error) << \"Failed to deserialize ControlList: empty list\";\n+\n+\t\treturn list;\n+\t}\n+\n+\tstatic const ControlList deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic const ControlList deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(dataBegin, dataEnd, cs);\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<ControlList>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const ControlList &data, const ControlInfoMap &map,\n+\t\t  ControlSerializer *cs)\n+\t{\n+\t\tconst ControlList &list_const = const_cast<const ControlList &>(data);\n+\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tstd::tie(dataVec, std::ignore) =\n+\t\t\tIPADataSerializer<const ControlList>::serialize(list_const, map, cs);\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic ControlList deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\tControlList ret;\n+\t\tconst ControlList &list = ret;\n+\t\tconst_cast<ControlList &>(list) =\n+\t\t\tIPADataSerializer<const ControlList>::deserialize(data, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlList deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\tControlList ret;\n+\t\tconst ControlList &list = ret;\n+\t\tconst_cast<ControlList &>(list) =\n+\t\t\tIPADataSerializer<const ControlList>::deserialize(dataBegin, dataEnd, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlList deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\tControlList ret;\n+\t\tconst ControlList &list = ret;\n+\t\tconst_cast<ControlList &>(list) =\n+\t\t\tIPADataSerializer<const ControlList>::deserialize(data, fds, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlList deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t       std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t       [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t       ControlSerializer *cs)\n+\t{\n+\t\tControlList ret;\n+\t\tconst ControlList &list = ret;\n+\t\tconst_cast<ControlList &>(list) =\n+\t\t\tIPADataSerializer<const ControlList>::deserialize(dataBegin, dataEnd,\n+\t\t\t\t\t\t\t\t\t  fdsBegin, fdsEnd, cs);\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<const ControlInfoMap>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const ControlInfoMap &map, ControlSerializer *cs)\n+\t{\n+\t\tif (!cs)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"ControlSerializer not provided for serialization of ControlInfoMap\";\n+\n+\t\tsize_t size = cs->binarySize(map);\n+\t\tstd::vector<uint8_t> infoData(size);\n+\t\tByteStreamBuffer buffer(infoData.data(), infoData.size());\n+\t\tint ret = cs->serialize(map, buffer);\n+\n+\t\tif (ret < 0 || buffer.overflow())\n+\t\t\treturn {{}, {}};\n+\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tappendPOD<uint32_t>(dataVec, infoData.size());\n+\t\tdataVec.insert(dataVec.end(), infoData.begin(), infoData.end());\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic const ControlInfoMap deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t\tControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic const ControlInfoMap deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t\t[[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t\tControlSerializer *cs)\n+\t{\n+\t\tif (!cs)\n+\t\t\tLOG(IPADataSerializer, Fatal)\n+\t\t\t\t<< \"ControlSerializer not provided for deserialization of ControlInfoMap\";\n+\n+\t\tuint32_t infoDataSize = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\n+\t\tstd::vector<uint8_t>::iterator it = dataBegin + 4;\n+\n+\t\tstd::vector<uint8_t> infoData(it, it + infoDataSize);\n+\n+\t\tByteStreamBuffer buffer(const_cast<const uint8_t *>(infoData.data()), infoData.size());\n+\t\tconst ControlInfoMap map = cs->deserialize<ControlInfoMap>(buffer);\n+\n+\t\treturn map;\n+\t}\n+\n+\tstatic const ControlInfoMap deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t\t[[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t\t\tControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), cs);\n+\t}\n+\n+\tstatic const ControlInfoMap deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t  ControlSerializer *cs)\n+\t{\n+\t\treturn deserialize(dataBegin, dataEnd, cs);\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<ControlInfoMap>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const ControlInfoMap &map, [[maybe_unused]] ControlSerializer *cs)\n+\t{\n+\t\tconst ControlInfoMap &map_const = const_cast<const ControlInfoMap &>(map);\n+\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tstd::tie(dataVec, std::ignore) =\n+\t\t\tIPADataSerializer<const ControlInfoMap>::serialize(map_const, cs);\n+\n+\t\treturn {dataVec, {}};\n+\t}\n+\n+\tstatic ControlInfoMap deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t  ControlSerializer *cs)\n+\t{\n+\t\tControlInfoMap ret;\n+\t\tconst ControlInfoMap &map = ret;\n+\t\tconst_cast<ControlInfoMap &>(map) =\n+\t\t\tIPADataSerializer<const ControlInfoMap>::deserialize(data, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlInfoMap deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t\t[[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t\tControlSerializer *cs)\n+\t{\n+\t\tControlInfoMap ret;\n+\t\tconst ControlInfoMap &map = ret;\n+\t\tconst_cast<ControlInfoMap &>(map) =\n+\t\t\tIPADataSerializer<const ControlInfoMap>::deserialize(dataBegin, dataEnd, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlInfoMap deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t\t[[maybe_unused]] std::vector<int32_t> &fds,\n+\t\t\t\t\t\tControlSerializer *cs)\n+\t{\n+\t\tControlInfoMap ret;\n+\t\tconst ControlInfoMap &map = ret;\n+\t\tconst_cast<ControlInfoMap &>(map) =\n+\t\t\tIPADataSerializer<const ControlInfoMap>::deserialize(data, fds, cs);\n+\n+\t\treturn ret;\n+\t}\n+\n+\tstatic ControlInfoMap deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t  std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t  [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t  ControlSerializer *cs)\n+\t{\n+\t\tControlInfoMap ret;\n+\t\tconst ControlInfoMap &map = ret;\n+\t\tconst_cast<ControlInfoMap &>(map) =\n+\t\t\tIPADataSerializer<const ControlInfoMap>::deserialize(dataBegin, dataEnd,\n+\t\t\t\t\t\t\t\t\t     fdsBegin, fdsEnd, cs);\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+template<>\n+class IPADataSerializer<FrameBuffer::Plane>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const FrameBuffer::Plane &data, [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\t\tstd::vector<int32_t> fdsVec;\n+\n+\t\tstd::vector<uint8_t> fdBuf;\n+\t\tstd::vector<int32_t> fdFds;\n+\t\tstd::tie(fdBuf, fdFds) =\n+\t\t\tIPADataSerializer<FileDescriptor>::serialize(data.fd);\n+\t\tdataVec.insert(dataVec.end(), fdBuf.begin(), fdBuf.end());\n+\t\tfdsVec.insert(fdsVec.end(), fdFds.begin(), fdFds.end());\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.length);\n+\n+\t\treturn {dataVec, fdsVec};\n+\t}\n+\n+\tstatic FrameBuffer::Plane deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t\t      std::vector<int32_t> &fds,\n+\t\t\t\t\t      ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic FrameBuffer::Plane deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t\t      [[maybe_unused]] std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t\t      std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t\t      [[maybe_unused]] std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t\t      [[maybe_unused]] ControlSerializer *cs = nullptr)\n+\t{\n+\t\tFrameBuffer::Plane ret;\n+\n+\t\tret.fd = IPADataSerializer<FileDescriptor>::deserialize(dataBegin, dataBegin + 1,\n+\t\t\t\t\t\t\t\t\tfdsBegin, fdsBegin + 1);\n+\t\tret.length = readPOD<uint32_t>(dataBegin, 1, dataEnd);\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+\n+template<>\n+class IPADataSerializer<IPABuffer>\n+{\n+public:\n+\tstatic std::tuple<std::vector<uint8_t>, std::vector<int32_t>>\n+\tserialize(const IPABuffer &data, ControlSerializer *cs = nullptr)\n+\t{\n+\t\tstd::vector<uint8_t> dataVec;\n+\n+\t\tappendPOD<uint32_t>(dataVec, data.id);\n+\n+\t\tstd::vector<uint8_t> planesDataVec;\n+\t\tstd::vector<int32_t> planesFdsVec;\n+\t\tstd::tie(planesDataVec, planesFdsVec) =\n+\t\t\tIPADataSerializer<std::vector<FrameBuffer::Plane>>::serialize(data.planes, cs);\n+\n+\t\tdataVec.insert(dataVec.end(), planesDataVec.begin(), planesDataVec.end());\n+\n+\t\treturn {dataVec, planesFdsVec};\n+\t}\n+\n+\tstatic IPABuffer deserialize(std::vector<uint8_t> &data,\n+\t\t\t\t     std::vector<int32_t> &fds,\n+\t\t\t\t     ControlSerializer *cs = nullptr)\n+\t{\n+\t\treturn deserialize(data.begin(), data.end(), fds.begin(), fds.end(), cs);\n+\t}\n+\n+\tstatic IPABuffer deserialize(std::vector<uint8_t>::iterator dataBegin,\n+\t\t\t\t     std::vector<uint8_t>::iterator dataEnd,\n+\t\t\t\t     std::vector<int32_t>::iterator fdsBegin,\n+\t\t\t\t     std::vector<int32_t>::iterator fdsEnd,\n+\t\t\t\t     ControlSerializer *cs = nullptr)\n+\t{\n+\t\tIPABuffer ret;\n+\n+\t\tret.id = readPOD<uint32_t>(dataBegin, 0, dataEnd);\n+\n+\t\tret.planes =\n+\t\t\tIPADataSerializer<std::vector<FrameBuffer::Plane>>::deserialize(\n+\t\t\t\tdataBegin + 4, dataEnd, fdsBegin, fdsEnd, cs);\n+\n+\t\treturn ret;\n+\t}\n+};\n+\n+#endif /* __DOXYGEN__ */\n+\n+} /* namespace libcamera */\n+\n+#endif /* __LIBCAMERA_INTERNAL_IPA_DATA_SERIALIZER_H__ */\ndiff --git a/src/libcamera/ipa_data_serializer.cpp b/src/libcamera/ipa_data_serializer.cpp\nnew file mode 100644\nindex 00000000..eb3d6362\n--- /dev/null\n+++ b/src/libcamera/ipa_data_serializer.cpp\n@@ -0,0 +1,178 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2020, Google Inc.\n+ *\n+ * ipa_data_serializer.cpp - Image Processing Algorithm data serializer\n+ */\n+\n+#include \"libcamera/internal/ipa_data_serializer.h\"\n+\n+#include \"libcamera/internal/log.h\"\n+\n+/**\n+ * \\file ipa_data_serializer.h\n+ * \\brief IPA Data Serializer\n+ */\n+\n+namespace libcamera {\n+\n+LOG_DEFINE_CATEGORY(IPADataSerializer)\n+\n+/**\n+ * \\class IPADataSerializer\n+ * \\brief IPA Data Serializer\n+ *\n+ * Static template class that provides functions for serializing and\n+ * deserializing IPA data.\n+ */\n+\n+namespace {\n+\n+/**\n+ * \\fn template<typename T> void appendPOD(std::vector<uint8_t> &vec, T val)\n+ * \\brief Append uint to end of byte vector, in little-endian order\n+ * \\tparam T Type of uint to append\n+ * \\param[in] vec Byte vector to append to\n+ * \\param[in] val Value of uint to append\n+ *\n+ * This function is meant to be used by the IPA data serializer, and the\n+ * generated IPA proxies.\n+ */\n+\n+/**\n+ * \\fn template<typename T> T readPOD(std::vector<uint8_t> &vec, size_t pos)\n+ * \\brief Read POD from byte vector, in little-endian order\n+ * \\tparam T Type of POD to read\n+ * \\param[in] vec Byte vector to read from\n+ * \\param[in] pos Index in vec to start reading from\n+ *\n+ * This function is meant to be used by the IPA data serializer, and the\n+ * generated IPA proxies.\n+ *\n+ * If the \\a pos plus the byte-width of the desired POD is past the end of\n+ * \\a vec, a fatal error will occur, as it means there is insufficient data\n+ * for deserialization, which should never happen.\n+ *\n+ * \\return The POD read from \\a vec at index \\a pos\n+ */\n+\n+/**\n+ * \\fn template<typename T> T readPOD(std::vector<uint8_t>::iterator it, size_t pos,\n+ * \t\t\t\t      std::vector<uint8_t>::iterator end)\n+ * \\brief Read POD from byte vector, in little-endian order\n+ * \\tparam T Type of POD to read\n+ * \\param[in] it Iterator of byte vector to read from\n+ * \\param[in] pos Index in byte vector to read from\n+ * \\param[in] end Iterator marking end of byte vector\n+ *\n+ * This function is meant to be used by the IPA data serializer, and the\n+ * generated IPA proxies.\n+ *\n+ * If the \\a pos plus the byte-width of the desired POD is past \\a end, it is\n+ * a fata error will occur, as it means there is insufficient data for\n+ * deserialization, which should never happen.\n+ *\n+ * \\return The POD read from \\a it at index \\a pos\n+ */\n+\n+} /* namespace */\n+\n+/**\n+ * \\fn template<typename T> IPADataSerializer<T>::serialize(\n+ * \tT data,\n+ * \tControlSerializer *cs = nullptr)\n+ * \\brief Serialize an object into byte vector and fd vector\n+ * \\tparam T Type of object to serialize\n+ * \\param[in] data Object to serialize\n+ * \\param[in] cs ControlSerializer\n+ *\n+ * \\a cs is only necessary if the object type \\a T or its members contain\n+ * ControlList or ControlInfoMap.\n+ *\n+ * \\return Tuple of byte vector and fd vector, that is the serialized form\n+ * of \\a data\n+ */\n+\n+/**\n+ * \\fn template<typename T> IPADataSerializer<T>::deserialize(\n+ * \tstd::vector<uint8_t> &data,\n+ * \tControlSerializer *cs = nullptr)\n+ * \\brief Deserialize byte vector into an object\n+ * \\tparam T Type of object to deserialize to\n+ * \\param[in] data Byte vector to deserialize from\n+ * \\param[in] cs ControlSerializer\n+ *\n+ * This version of deserialize() can be used if the object type \\a T and its\n+ * members don't have any FileDescriptor.\n+ *\n+ * \\a cs is only necessary if the object type \\a T or its members contain\n+ * ControlList or ControlInfoMap.\n+ *\n+ * \\return The deserialized object\n+ */\n+\n+/**\n+ * \\fn template<typename T> IPADataSerializer<T>::deserialize(\n+ * \tstd::vector<uint8_t>::iterator dataBegin,\n+ * \tstd::vector<uint8_t>::iterator dataEnd,\n+ * \tControlSerializer *cs = nullptr)\n+ * \\brief Deserialize byte vector into an object\n+ * \\tparam T Type of object to deserialize to\n+ * \\param[in] dataBegin Begin iterator of byte vector to deserialize from\n+ * \\param[in] dataEnd End iterator of byte vector to deserialize from\n+ * \\param[in] cs ControlSerializer\n+ *\n+ * This version of deserialize() can be used if the object type \\a T and its\n+ * members don't have any FileDescriptor.\n+ *\n+ * \\a cs is only necessary if the object type \\a T or its members contain\n+ * ControlList or ControlInfoMap.\n+ *\n+ * \\return The deserialized object\n+ */\n+\n+/**\n+ * \\fn template<typename T> IPADataSerializer<T>::deserialize(\n+ * \tstd::vector<uint8_t> &data,\n+ * \tstd::vector<int32_t> &fds,\n+ * \tControlSerializer *cs = nullptr)\n+ * \\brief Deserialize byte vector and fd vector into an object\n+ * \\tparam T Type of object to deserialize to\n+ * \\param[in] data Byte vector to deserialize from\n+ * \\param[in] fds Fd vector to deserialize from\n+ * \\param[in] cs ControlSerializer\n+ *\n+ * This version of deserialize() (or the iterator version) must be used if\n+ * the object type \\a T or its members contain FileDescriptor.\n+ *\n+ * \\a cs is only necessary if the object type \\a T or its members contain\n+ * ControlList or ControlInfoMap.\n+ *\n+ * \\return The deserialized object\n+ */\n+\n+/**\n+ * \\fn template<typename T> IPADataSerializer::deserialize(\n+ * \tstd::vector<uint8_t>::iterator dataBegin,\n+ * \tstd::vector<uint8_t>::iterator dataEnd,\n+ * \tstd::vector<int32_t>::iterator fdsBegin,\n+ * \tstd::vector<int32_t>::iterator fdsEnd,\n+ * \tControlSerializer *cs = nullptr)\n+ * \\brief Deserialize byte vector and fd vector into an object\n+ * \\tparam T Type of object to deserialize to\n+ * \\param[in] dataBegin Begin iterator of byte vector to deserialize from\n+ * \\param[in] dataEnd End iterator of byte vector to deserialize from\n+ * \\param[in] fdsBegin Begin iterator of fd vector to deserialize from\n+ * \\param[in] fdsEnd End iterator of fd vector to deserialize from\n+ * \\param[in] cs ControlSerializer\n+ *\n+ * This version of deserialize() (or the vector version) must be used if\n+ * the object type \\a T or its members contain FileDescriptor.\n+ *\n+ * \\a cs is only necessary if the object type \\a T or its members contain\n+ * ControlList or ControlInfoMap.\n+ *\n+ * \\return The deserialized object\n+ */\n+\n+} /* namespace libcamera */\ndiff --git a/src/libcamera/meson.build b/src/libcamera/meson.build\nindex 99b27e66..01bcffd4 100644\n--- a/src/libcamera/meson.build\n+++ b/src/libcamera/meson.build\n@@ -24,6 +24,7 @@ libcamera_sources = files([\n     'geometry.cpp',\n     'ipa_context_wrapper.cpp',\n     'ipa_controls.cpp',\n+    'ipa_data_serializer.cpp',\n     'ipa_interface.cpp',\n     'ipa_manager.cpp',\n     'ipa_module.cpp',\n",
    "prefixes": [
        "libcamera-devel",
        "v4",
        "08/37"
    ]
}