From nobody Thu Dec 18 19:31:05 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1633015322; cv=none; d=zohomail.com; s=zohoarc; b=MSydONJ2pzXAZTMAMcU95NnXvBB+4b1OFCR5vOecXE3H5FT+fNa1XUO5/ZYfLG2XPmTAUSdsTwK4U9C5GHUHCqp94SSxUJkxdQe47mnzPgtkx9/F8TvkpkwLoex5JXVLmNSnvsBCs4jjGU1WEhGcbP6xsfBSXAYRxnJyh0kNo8Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1633015322; h=Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=u3LelZdD7qPOY216rLv/itDL3Wpuq00I0pFgeV7VjOE=; b=kugFleVJUlPzKrr0/niMivwf0+EIZ5YliDeUKN/YJB9Af1i4fTzHimgKv0hKM681fhFc1wxjinIlHMzw+sVTR9jOjYkEHVvFFEpGWLM080UQpz4JrQI908S/+uSDHc6j8gSkKOnhS65ewS37CkC57AIaNLXUrCQlNlKVZ31cp84= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1633015322732624.9855413591281; Thu, 30 Sep 2021 08:22:02 -0700 (PDT) Received: from localhost ([::1]:45808 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVxsn-0006cJ-O9 for importer@patchew.org; Thu, 30 Sep 2021 11:22:01 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:33108) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVxjP-0000Hv-Ni for qemu-devel@nongnu.org; Thu, 30 Sep 2021 11:12:21 -0400 Received: from mail-wm1-x32b.google.com ([2a00:1450:4864:20::32b]:45663) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVxjL-00040I-EJ for qemu-devel@nongnu.org; Thu, 30 Sep 2021 11:12:17 -0400 Received: by mail-wm1-x32b.google.com with SMTP id b192-20020a1c1bc9000000b0030cfaf18864so4600996wmb.4 for ; Thu, 30 Sep 2021 08:12:14 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [81.2.115.148]) by smtp.gmail.com with ESMTPSA id g8sm1952098wrm.46.2021.09.30.08.12.12 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Sep 2021 08:12:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=u3LelZdD7qPOY216rLv/itDL3Wpuq00I0pFgeV7VjOE=; b=TNopLoNtvYobasKjESWyi+Q9IbgxnfjTaFHmDOV96YsBIkHU57juV1RxzPehenrkkT A3xNP4CuIHurGsBHS2FCGBF7+k2Doo8YSS9VsfgIxnNALGsiPtjWKPOGZB/Wgld8NBsB WCsLnRTfESTiCf6gJMjOm1vO96QbATHZ2NnxExj7FcKo/D/i4Pk03aQ1nWKvtG2nlISH SspSfF4+1oQKNDJZX5obvLdGW7JqZKgKLVTXamA4ZrNSZtgbJQ33ilvcOw1TeU9dSn+c p8sgGdgfGqAGHIi5vlkE+BvRzmHx6+gZhbJkmA/svXhtfBhfG29meZ5WO5GysywzJh8v 76Og== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=u3LelZdD7qPOY216rLv/itDL3Wpuq00I0pFgeV7VjOE=; b=omu5/KoLnNgeHhHdtEFatV6xjgVA0iBjK/2hUYFmIcuh23zC03AaVtB9dPtE/95nAx nZ0pI97DpAu5f9MbNIiBTxUcYIOMcGZpyxWyYRObcE6lnYBC5l2jvuI8HGw2Rs+mhrf/ OTg3rPs9KpGvUkiS2YTmDjsCS/MMe9Gk2MvTvgT+gh99FO8Yvvm8myPkL6XfqALkzECR O3el0Zobbwwf5bH2M6Dqfk8nTSh+DKun1aEBTn5JRvoqyVQzl/FzTHXU46Z0eCT9F0ae rwV1/Ub+5LyLbjXzn0cfTfF6RBhbkESZObom1xP/mHvHUrDO7We3gPEeGC6H2j4yRcKb oubQ== X-Gm-Message-State: AOAM533ft9bzvm2CO50dfdycEqfDPlvnRvbm1n061UBNI38vhSwYOEwL cpltRVQL2es/3z5yngYbB9f30flmFkn6Cw== X-Google-Smtp-Source: ABdhPJx0DebkVhbVzvWKwj4iIoS+ufnPeYrhsCU3z57XxBSOXPCX4e7epP91H9SwCCezZVPDOiM66Q== X-Received: by 2002:a05:600c:4c96:: with SMTP id g22mr13835978wmp.83.1633014733387; Thu, 30 Sep 2021 08:12:13 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org Subject: [PULL 11/22] docs/system/arm: xlnx-versal-virt: BBRAM and eFUSE Usage Date: Thu, 30 Sep 2021 16:11:50 +0100 Message-Id: <20210930151201.9407-12-peter.maydell@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20210930151201.9407-1-peter.maydell@linaro.org> References: <20210930151201.9407-1-peter.maydell@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32b; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32b.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, WEIRD_QUOTING=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: pass (identity @linaro.org) X-ZM-MESSAGEID: 1633015325266100001 Content-Type: text/plain; charset="utf-8" From: Tong Ho Add BBRAM and eFUSE usage to the Xilinx Versal Virt board document. Signed-off-by: Tong Ho Message-id: 20210917052400.1249094-10-tong.ho@xilinx.com Reviewed-by: Peter Maydell Signed-off-by: Peter Maydell --- docs/system/arm/xlnx-versal-virt.rst | 49 ++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/system/arm/xlnx-versal-virt.rst b/docs/system/arm/xlnx-ve= rsal-virt.rst index 27f73500d95..92ad10d2da4 100644 --- a/docs/system/arm/xlnx-versal-virt.rst +++ b/docs/system/arm/xlnx-versal-virt.rst @@ -32,6 +32,8 @@ Implemented devices: - OCM (256KB of On Chip Memory) - XRAM (4MB of on chip Accelerator RAM) - DDR memory +- BBRAM (36 bytes of Battery-backed RAM) +- eFUSE (3072 bytes of one-time field-programmable bit array) =20 QEMU does not yet model any other devices, including the PL and the AI Eng= ine. =20 @@ -175,3 +177,50 @@ Run the following at the U-Boot prompt: fdt set /chosen/dom0 reg <0x00000000 0x40000000 0x0 0x03100000> booti 30000000 - 20000000 =20 +BBRAM File Backend +"""""""""""""""""" +BBRAM can have an optional file backend, which must be a seekable +binary file with a size of 36 bytes or larger. A file with all +binary 0s is a 'blank'. + +To add a file-backend for the BBRAM: + +.. code-block:: bash + + -drive if=3Dpflash,index=3D0,file=3Dversal-bbram.bin,format=3Draw + +To use a different index value, N, from default of 0, add: + +.. code-block:: bash + + -global xlnx,bbram-ctrl.drive-index=3DN + +eFUSE File Backend +"""""""""""""""""" +eFUSE can have an optional file backend, which must be a seekable +binary file with a size of 3072 bytes or larger. A file with all +binary 0s is a 'blank'. + +To add a file-backend for the eFUSE: + +.. code-block:: bash + + -drive if=3Dpflash,index=3D1,file=3Dversal-efuse.bin,format=3Draw + +To use a different index value, N, from default of 1, add: + +.. code-block:: bash + + -global xlnx,efuse.drive-index=3DN + +.. warning:: + In actual physical Versal, BBRAM and eFUSE contain sensitive data. + The QEMU device models do **not** encrypt nor obfuscate any data + when holding them in models' memory or when writing them to their + file backends. + + Thus, a file backend should be used with caution, and 'format=3Dluks' + is highly recommended (albeit with usage complexity). + + Better yet, do not use actual product data when running guest image + on this Xilinx Versal Virt board. --=20 2.20.1