From nobody Thu May 2 18:28:02 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+61238+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+61238+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1592055710; cv=none; d=zohomail.com; s=zohoarc; b=MipZ8xnRDXlSWV0nnfUZrGfZRfXqIMZy49/U4PsvSzUcz7KpwXvR4PJrYg/hYbWL8oCdpqldG0q7QskpyRk4bZqsVOT8lRYw7uCnQmHmNai+P98fWKgjZpuZ65aOD5LJr/gazg7uh/MQzuOAu9SqYn8XqmYcy+flW8CmLQVRy10= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1592055710; h=Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To; bh=nm+rEW4/661odPpfkTdieKmFZb7YUALkCJouOoUOJwM=; b=nu6Wv2DaAO05AImrEUqZoG4/pn/8qjgBqRSZhNIlD2MCUK+VOs6ihzuKFRFhfmurCwKfmTQvPTui3DhMDMlHm25JyLjOG+nZ3TrH66jRYigB6bsNf9u0HHznZAAU8vsHXICeEuAqi8MCLvps9NMV2eYw0Ua6Q7dCHvrlFbRoRos= 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+61238+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1592055710267744.7837999135564; Sat, 13 Jun 2020 06:41:50 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id T0lFYY1788612xfMi4LvySGP; Sat, 13 Jun 2020 06:41:49 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web11.8970.1592055708421473975 for ; Sat, 13 Jun 2020 06:41:48 -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 6BD29C0A; Sat, 13 Jun 2020 06:41:47 -0700 (PDT) X-Received: from localhost.localdomain (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id BFD8E3F6CF; Sat, 13 Jun 2020 06:41:46 -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 v1 1/2] Platforms/RaspberryPi: Add RPi4 settings to Readme Date: Sat, 13 Jun 2020 09:41:43 -0400 Message-Id: <20200613134144.4610-2-Samer.El-Haj-Mahmoud@arm.com> In-Reply-To: <20200613134144.4610-1-Samer.El-Haj-Mahmoud@arm.com> References: <20200613134144.4610-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: PJFerEkZc4bcZlRSuhDOo0y5x1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1592055709; bh=NCY8hRlZ9u57Mq8byI4Kt4qbk92JFohlrIz+gNXEsz8=; h=Cc:Date:From:Reply-To:Subject:To; b=kmhDo8cITSsTU9JE8KfXM3U+vj+s5d9cE2ObuLaFlFcEnDso6XC/ABNexiMET12c4rM x3WKXpgCpTNYw/hBNHusQNcTE7/JNDxx22AbAbn9vv14qvkHHl3H/6uCQ7qkDsiEnlBW5 QLwEqRGiIU8d85Yd+s00GNYOWLpJFOForDo= 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: Ard Biesheuvel --- 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..d27465d965ab 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 (#61238): https://edk2.groups.io/g/devel/message/61238 Mute This Topic: https://groups.io/mt/74857350/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 Thu May 2 18:28:02 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+61237+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+61237+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1592055709; cv=none; d=zohomail.com; s=zohoarc; b=Aqgt68ngee9/isWm/5mgydjUtMsnRvzI70h5LHnY/fBLpk7IdenLRphshEeHOITzQh69zGFXr6UjjeT7vyCbeaCWuTQ4XlY1Zr3rvIKZEr4VZ12isI2bcz6vmy/grat87MsPqpXb0i8Tvl+kow5/mgAmH7fVZJNEs/scNW37px0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1592055709; h=Date:From:In-Reply-To:List-Id:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To; bh=v3JzpjGAAOyjqZH3MrwwJoz8pNLWl8R+UxbVoK8SJ1E=; b=LOZBsDLxnzU1oD2hiVcvXGxgcJZ+Ult9UXmqgEBXhCrIHV7QRl6pjPqWaPbBhMdlBw7oqHAjqe5065SkrL9Zuou3HVcVgqn11wGqpbbN9ts4Lw8PIqXpGcmxNijMdEEjS5nXDncW4BRzcIAD5n7313fQgMAOTF3n3epCqIqulJs= 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+61237+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1592055709864426.990286981075; Sat, 13 Jun 2020 06:41:49 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id zdcMYY1788612xVDYR9LEeZ8; Sat, 13 Jun 2020 06:41:49 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web12.8893.1592055708106039349 for ; Sat, 13 Jun 2020 06:41:48 -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 A0FC6D6E for ; Sat, 13 Jun 2020 06:41:47 -0700 (PDT) X-Received: from localhost.localdomain (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 7FEAC3F6CF for ; Sat, 13 Jun 2020 06:41:47 -0700 (PDT) From: "Samer El-Haj-Mahmoud" To: devel@edk2.groups.io Subject: [edk2-devel] [edk2-platform][PATCH v1 2/2] Platforms/RaspberryPi: Add RPi3 settings to Readme Date: Sat, 13 Jun 2020 09:41:44 -0400 Message-Id: <20200613134144.4610-3-Samer.El-Haj-Mahmoud@arm.com> In-Reply-To: <20200613134144.4610-1-Samer.El-Haj-Mahmoud@arm.com> References: <20200613134144.4610-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: 8ApDZf8b9hkwMUmn0irfu8jXx1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1592055709; bh=5XiQRYSvRrhri/Krv3cYsFsMBRlmd2pJDCQQXcZQtwo=; h=Date:From:Reply-To:Subject:To; b=Ami8SEMj7EHcUGKzoyswcfKBFwE1f6qa1XHdT3duCW0wxxV/o8rit1qEP25IIToUdJ2 Jm5kMtcP/Ujg8VHDrhwYxshRSjpvcdCzAXQIXV85W/IaBjQOI/6pSaR2MBLLAzEjQMmaz 7S7lckQqAxS0qp5VlvBl+1Pj3VYMMxeq9Bs= 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 Reviewed-by: Ard Biesheuvel --- 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..3694c1239c70 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 (#61237): https://edk2.groups.io/g/devel/message/61237 Mute This Topic: https://groups.io/mt/74857349/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-