From nobody Sun May 19 02:26:46 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61309+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61309+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1592257421; cv=none; d=zohomail.com; s=zohoarc; b=Xq0EN2LtplVh9BvugWDc5cB2eEMWhhYv8dNMZJXACLeb/eL0w3FnEsoAtv4grWmf5xTpSih43DuER3W7pKP4GnlC2EJ+vOHlRIW1YXUhPUnz7KrX383AbV7xS9I38D75XYiVq1h9aVlUcLUH1P1sbDvMilo9c49AQ0fGJT6n5pk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1592257421; h=Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To; bh=xu3WdfzTurHABhoRsRDM7A5nDTD/e658KcYLi3FKUaE=; b=MKOns7UGwZUsJ1aCLwonSRwKhIS2yhXNFcgCaz3r5TVWNKEDA0w8kAN2wAKl8AF9qLIq2urBEL4GzAvi5Tv05am07noWnSagCPypPxMI0Rm3hxa6IKmb39kRjD1jCCqrweDGf3sLsCHI9uWoM/5zaHQFIqWfRBRCd5pgRvj8YaU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61309+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1592257420986437.03362335415636; Mon, 15 Jun 2020 14:43:40 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id skyjYY1788612xFMcKdUDq8I; Mon, 15 Jun 2020 14:43:40 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web11.120.1592257418629679929 for ; Mon, 15 Jun 2020 14:43:38 -0700 X-Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 6CC3831B; Mon, 15 Jun 2020 14:43:37 -0700 (PDT) X-Received: from localhost.localdomain (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 227063F6CF; Mon, 15 Jun 2020 14:43:37 -0700 (PDT) From: "Samer El-Haj-Mahmoud" To: devel@edk2.groups.io Cc: Leif Lindholm , Ard Biesheuvel , Pete Batard , Andrei Warkentin Subject: [edk2-devel] [edk2-platform][PATCH v2 1/2] Platforms/RaspberryPi: Add RPi4 settings to Readme Date: Mon, 15 Jun 2020 17:43:30 -0400 Message-Id: <20200615214331.12949-2-Samer.El-Haj-Mahmoud@arm.com> In-Reply-To: <20200615214331.12949-1-Samer.El-Haj-Mahmoud@arm.com> References: <20200615214331.12949-1-Samer.El-Haj-Mahmoud@arm.com> Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,samer.el-haj-mahmoud@arm.com X-Gm-Message-State: EeTyhiqbn5odnLdRkJP0tRLDx1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1592257420; bh=VVhpmEqUc1tszX3hE/EmN0YndmdyFdJWKHMcQTjp+0I=; h=Cc:Date:From:Reply-To:Subject:To; b=f71KXmfbDTfvRuYqpg9QE3f2x8+wVCr+kjzpo/A6A3ID/xnwy6pYu4Q5wMWjNmedsS3 FEeKad+sPyegdoITivSVR1D+mlMrH5wOEyPvKVBeyl9AqDhWpR0n8JN9n9Ax2nOJfz235 pdVisJCsjfbf/fQwNrO8rZr1Op80KGPX6QM= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Add a section to the the RPi4 Readme for 'Configuration Settings', with instructions on scripting from the UEFI Shell. Cc: Leif Lindholm Cc: Ard Biesheuvel Cc: Pete Batard Cc: Andrei Warkentin Signed-off-by: Samer El-Haj-Mahmoud Reviewed-by: Pete Batard --- Platform/RaspberryPi/RPi4/Readme.md | 74 +++++++++++++++++++- 1 file changed, 73 insertions(+), 1 deletion(-) diff --git a/Platform/RaspberryPi/RPi4/Readme.md b/Platform/RaspberryPi/RPi= 4/Readme.md index 03eb6c391aca..98388e3caba1 100644 --- a/Platform/RaspberryPi/RPi4/Readme.md +++ b/Platform/RaspberryPi/RPi4/Readme.md @@ -143,4 +143,76 @@ all functionality may be available. =20 - Network booting via onboard NIC. - SPCR hardcodes type to PL011, and thus will not expose correct - (miniUART) UART if DT overlays to switch UART are used on Pi 4B. \ No newline at end of file + (miniUART) UART if DT overlays to switch UART are used on Pi 4B. + +# Configuration Settings +The Raspberry Pi UEFI configuration settings can be viewed and changed usi= ng both the UI configuration menu (under `Device Manager` -> `Raspberry Pi = Configuration`), as well as the UEFI Shell. To configure using the UEFI She= ll, use `setvar` command to read/write the UEFI variables with GUID =3D `CD= 7CC258-31DB-22E6-9F22-63B0B8EED6B5`. + +The syntax to read a setting is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 +``` + +The syntax to write a setting is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3D +``` + +For string-type settings (e.g. Asset Tag), the syntax to write is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3DL"= " =3D0x0000 +``` + +UEFI Setting | NAME | VALUE +-----------------------------|-----------------------|--------------------= --------- +**CPU Configuration** | +CPU Clock | `CpuClock` | Low =3D `0x00000000`
Defau= lt =3D `0x00000001` (default)
Max =3D `0x00000002`
Custom =3D `0x00= 000003` +CPU Clock Rate (MHz) | `CustomCpuClock` | Hex numeric value, 4-byt= es
(e.g. `0x000005DC` for 1500 MHz) +**Display Configuration** | +Virtual 640x480 | `DisplayEnableScaledVModes` | Checked =3D B= it 0 set (i.e. ` \| 0x01`) +Virtual 800x600 | `DisplayEnableScaledVModes` | Checked =3D B= it 1 set (i.e. ` \| 0x02`) +Virtual 1024x768 | `DisplayEnableScaledVModes` | Checked =3D B= it 2 set (i.e. ` \| 0x04`) +Virtual 720p | `DisplayEnableScaledVModes` | Checked =3D B= it 3 set (i.e. ` \| 0x08`) +Virtual 1080p | `DisplayEnableScaledVModes` | Checked =3D B= it 4 set (i.e. ` \| 0x10`) +Native resolution | `DisplayEnableScaledVModes` | Checked =3D B= it 5 set (i.e. ` \| 0x20`) (default) +Screenshot support | `DisplayEnableSShot` | Control-Alt-F12 =3D = `0x00000001` (default)
Not Enabled =3D `0x00000000` +**Advanced Configuration** | +Limit RAM to 3 GB | `RamLimitTo3GB` | Disable =3D `0x00000000` =
Enabled=3D `0x00000001` (default) +System Table Selection | `SystemTableMode`| ACPI =3D `0x00000000` (d= efault)
ACPI + Devicetree =3D `0x00000001`
Devicetree =3D `0x00000= 002` +Asset Tag | `AssetTag` | String, 32 characters or less = (e.g. `L"ABCD123"`)
(default `L""`) +**SD/MMC Configuration** | +uSD/eMMC Routing | `SdIsArasan` | Arasan SDHC =3D `0x00000001`= (default)
eMMC2 SDHCI =3D `0x00000000` +Multi-Block Support | `MmcDisableMulti` | Multi-block transfers = =3D `0x00000000` (default)
Single block transfers =3D `0x00000001` +uSD Max Bus Width | `MmcForce1Bit` | 4-bit Mode =3D `0x00000000= ` (default)
1-bit Mode =3D `0x00000001` +uSD Force Default Speed | `MmcForceDefaultSpeed` | Allow High Speed = =3D `0x00000000` (default)
Force Default Speed =3D `0x00000001` +SD Default Speed (MHz) | `MmcSdDefaultSpeedMHz` | Hex numeric value,= 4-bytes (e.g. `0x00000019` for 25 MHz)
(default 25) +SD High Speed (MHz) | `MmcSdHighSpeedMHz` | Hex numeric value, 4-= bytes (e.g. `0x00000032` for 50 MHz)
(default 50) +**Debugging Configuration** | +JTAG Routing | `DebugEnableJTAG` | Enable JTAG via GPIO = =3D `0x00000001`
Disable JTAG=3D `0x00000000` (default) + +**Examples:** + +- To read the 'System Table Selection' setting : +``` +setvar SystemTableMode -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 +``` + +- To change the 'System Table Selection' setting to 'Devicetree' : +``` +setvar SystemTableMode -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt = -nv =3D0x00000002 +``` + +- To read the 'Limit RAM to 3 GB' setting: +``` +setvar RamLimitTo3GB -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 +``` + +- To change the 'Limit RAM to 3 GB' setting to 'Disabled': +``` +setvar RamLimitTo3GB -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -n= v =3D0x00000000 +``` + +- To change the Asset Tag to the string "ASSET-TAG-123" : +``` +setvar AssetTag -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3D= L"ASSET-TAG-123" =3D0x0000 +``` --=20 2.17.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#61309): https://edk2.groups.io/g/devel/message/61309 Mute This Topic: https://groups.io/mt/74904862/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- From nobody Sun May 19 02:26:46 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61310+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61310+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1592257420; cv=none; d=zohomail.com; s=zohoarc; b=URcQebEaWX4jYnQPk5pBl08XTsduu6AF+22Cfgp87XK9YY2yU52QyLfOS8X4RuAnrmavmzXZQIesBMriM2INrdbXYK7cBo9f9n8SMR328xQUHnxwNgj7rPL6yoZqwEMAh1L/OfWY4OXUpbRkcXXN8EgR2yZ/R/3oTANZ64RvkKo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1592257420; h=Date:From:In-Reply-To:List-Id:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To; bh=trK2I1bqyuMeIsqLo2gRcUj26IyUWAZaMUHEqC+cexg=; b=XMYukb87DJbrPq6kDs478Eg08jPRAlpRQA9HgzaEdjFLwPt/FOVf89nQ0cMArnYo1VnI7agVjae0bfura5JMU2xmfOEdqF3Czl++F/AYTn/yv5WICdodOQFPvPDcjtZ2JiRA17o2FSD6RwDQi3Pj9tDMoEBRCBy6r2uG0NVL34U= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61310+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 159225741990120.16143576714296; Mon, 15 Jun 2020 14:43:39 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id Yf2jYY1788612xU7EFNmuOZU; Mon, 15 Jun 2020 14:43:39 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web12.117.1592257418620815147 for ; Mon, 15 Jun 2020 14:43:38 -0700 X-Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 9C1571042 for ; Mon, 15 Jun 2020 14:43:37 -0700 (PDT) X-Received: from localhost.localdomain (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 7DCD53F6CF for ; Mon, 15 Jun 2020 14:43:37 -0700 (PDT) From: "Samer El-Haj-Mahmoud" To: devel@edk2.groups.io Subject: [edk2-devel] [edk2-platform][PATCH v2 2/2] Platforms/RaspberryPi: Add RPi3 settings to Readme Date: Mon, 15 Jun 2020 17:43:31 -0400 Message-Id: <20200615214331.12949-3-Samer.El-Haj-Mahmoud@arm.com> In-Reply-To: <20200615214331.12949-1-Samer.El-Haj-Mahmoud@arm.com> References: <20200615214331.12949-1-Samer.El-Haj-Mahmoud@arm.com> Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,samer.el-haj-mahmoud@arm.com X-Gm-Message-State: QYm4WKGjwDpiE1CGdrf6aXx2x1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1592257419; bh=xqNEFW6rD61Mk100xWHdfHKX9M8tfNKpXeeIsKeoQp0=; h=Date:From:Reply-To:Subject:To; b=e2ZqzsKZgYTmQVBoIt4yVjC76+zwfQQE+ejdspc+MRt9B+t0AWCeGTMSIrD782zaisq WI3DZOoPmGnosqMZBQGrH5Tx2gJAZuLJOttjQZb5ZnU68tYOZBRD7wmpDTrysGOQaRzzw QpySVw2TrjcK6ueK3y06KxbA5Mpi+KPR/48= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Add a section to the the RPi3 readme for 'Configuration Settings', with instructions on scripting from the UEFI Shell. Signed-off-by: Samer El-Haj-Mahmoud --- Platform/RaspberryPi/RPi3/Readme.md | 61 ++++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/Platform/RaspberryPi/RPi3/Readme.md b/Platform/RaspberryPi/RPi= 3/Readme.md index 075ea199a0d9..9080cff15841 100644 --- a/Platform/RaspberryPi/RPi3/Readme.md +++ b/Platform/RaspberryPi/RPi3/Readme.md @@ -201,3 +201,64 @@ install a kernel that relies on Device Tree rather tha= n ACPI. - SPCR hardcodes UART type to miniUART, and thus will not expose correct (PL011) UART on CM3 and Pi2B or if DT overlays to switch UART are used on Pi 3B/3B+/3A+. + +# Configuration Settings +The Raspberry Pi UEFI configuration settings can be viewed and changed usi= ng both the UI configuration menu (under `Device Manager` -> `Raspberry Pi = Configuration`), as well as the UEFI Shell. To configure using the UEFI She= ll, use `setvar` command to read/write the UEFI variables with GUID =3D `CD= 7CC258-31DB-22E6-9F22-63B0B8EED6B5`. + +The syntax to read a setting is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 +``` + +The syntax to write a setting is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3D +``` + +For string-type settings (e.g. Asset Tag), the syntax to write is: +``` +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3DL"= " =3D0x0000 +``` + +UEFI Setting | NAME | VALUE +-----------------------------|-----------------------|--------------------= --------- +**CPU Configuration** | +CPU Clock | `CpuClock` | Low =3D `0x00000000`
Defau= lt =3D `0x00000001` (default)
Max =3D `0x00000002`
Custom =3D `0x00= 000003` +CPU Clock Rate (MHz) | `CustomCpuClock` | Hex numeric value, 4-byt= es
(e.g. `0x000005DC` for 1500 MHz) +**Display Configuration** | +Virtual 640x480 | `DisplayEnableScaledVModes` | Checked =3D B= it 0 set (i.e. ` \| 0x01`) +Virtual 800x600 | `DisplayEnableScaledVModes` | Checked =3D B= it 1 set (i.e. ` \| 0x02`) +Virtual 1024x768 | `DisplayEnableScaledVModes` | Checked =3D B= it 2 set (i.e. ` \| 0x04`) +Virtual 720p | `DisplayEnableScaledVModes` | Checked =3D B= it 3 set (i.e. ` \| 0x08`) +Virtual 1080p | `DisplayEnableScaledVModes` | Checked =3D B= it 4 set (i.e. ` \| 0x10`) +Native resolution | `DisplayEnableScaledVModes` | Checked =3D B= it 5 set (i.e. ` \| 0x20`) (default) +Screenshot support | `DisplayEnableSShot` | Control-Alt-F12 =3D = `0x00000001` (default)
Not Enabled =3D `0x00000000` +**Advanced Configuration** | +System Table Selection | `SystemTableMode`| ACPI =3D `0x00000000` ACPI + Devicetree =3D `0x00000001` (default)
Devicetree =3D `0x00000= 002` +Asset Tag | `AssetTag` | String, 32 characters or less = (e.g. `L"ABCD123"`)
(default `L""`) +**SD/MMC Configuration** | +uSD/eMMC Routing | `SdIsArasan` | Arasan SDHC =3D `0x00000001`=
Broadcom SDHOST =3D `0x00000000` (default) +Multi-Block Support | `MmcDisableMulti` | Multi-block transfers = =3D `0x00000000` (default)
Single block transfers =3D `0x00000001` +uSD Max Bus Width | `MmcForce1Bit` | 4-bit Mode =3D `0x00000000= ` (default)
1-bit Mode =3D `0x00000001` +uSD Force Default Speed | `MmcForceDefaultSpeed` | Allow High Speed = =3D `0x00000000` (default)
Force Default Speed =3D `0x00000001` +SD Default Speed (MHz) | `MmcSdDefaultSpeedMHz` | Hex numeric value,= 4-bytes (e.g. `0x00000019` for 25 MHz)
(default 25) +SD High Speed (MHz) | `MmcSdHighSpeedMHz` | Hex numeric value, 4-= bytes (e.g. `0x00000032` for 50 MHz)
(default 50) +**Debugging Configuration** | +JTAG Routing | `DebugEnableJTAG` | Enable JTAG via GPIO = =3D `0x00000001`
Disable JTAG=3D `0x00000000` (default) + +**Examples:** + +- To read the 'System Table Selection' setting : +``` +setvar SystemTableMode -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 +``` + +- To change the 'System Table Selection' setting to 'Devicetree' : +``` +setvar SystemTableMode -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt = -nv =3D0x00000002 +``` + +- To change the Asset Tag to the string "ASSET-TAG-123" : +``` +setvar AssetTag -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =3D= L"ASSET-TAG-123" =3D0x0000 +``` --=20 2.17.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#61310): https://edk2.groups.io/g/devel/message/61310 Mute This Topic: https://groups.io/mt/74904863/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-