From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f68.google.com (mail-wr1-f68.google.com [209.85.221.68]) by mx.groups.io with SMTP id smtpd.web12.14726.1592217833797381619 for ; Mon, 15 Jun 2020 03:43:54 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@akeo-ie.20150623.gappssmtp.com header.s=20150623 header.b=yEAOSwcZ; spf=none, err=permanent DNS error (domain: akeo.ie, ip: 209.85.221.68, mailfrom: pete@akeo.ie) Received: by mail-wr1-f68.google.com with SMTP id j10so16572022wrw.8 for ; Mon, 15 Jun 2020 03:43:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=akeo-ie.20150623.gappssmtp.com; s=20150623; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=iO7Z/V+j37S1hzCosY+AYzslonpa9BbqwdmmG2eT5Gw=; b=yEAOSwcZF/KJoN6vF2+6sNwL0v/RDLLxEEqlGbZWFgl/M/+vxH5xne9DS+TM6lVn4I MPhmIW20d37YpjhWzEPkFi3XDzzO/M05V1h7LAw5wkZmcAMLMFaODqf1jdX/ONYCwN/l 3Vn36xYrLdqUSmhDNcW0LhMstIcC4jpEUznTjUbfg9n9cgzTG54JG0ZkDTKtpquMAfUk vOfDtXX/dsxQQUSnhxgitrqkibkO1b1bbGJtJqMWhva7f8ONjNKq7XbCA2x3wFt5MxMg /GCrLwlekcGOhUQoK89WXdUXbbwdUAyNYrh2ML0i+kqiAMlGmJMcO0uaI1AvAXOWhUqM cHSw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=iO7Z/V+j37S1hzCosY+AYzslonpa9BbqwdmmG2eT5Gw=; b=WLaDFkOUbMtGLLxH30RjdFFxLaH6l8a5LwryeGYf1hu5ywLOTgjunvv5E/38YFsUE6 3ZZ2bmrwMzkdouR44KqsGYuviKnebx0QMNzqrS2c9qiKrgHF4ddY/4/zD7zK1KL0XbYb CtWk3eogWxtCoNWGckggEECY/I03I2NUX2lU+zgtngsKBp5eC/kXFVzE+R2a+YJLp1KG ACd54DzAjw4w/2M5gf+FMQjq0nfBaM/z+JW7zo8M61wJGfv9QIQkGqJVxpHoaJc8tptx DZGtF3DpNmFpTHWVrWjDFWgcvysjzQbZ9qkqDfhRxCPE7XoV+RP2sVVDqgstWXYk3Mdy n/BA== X-Gm-Message-State: AOAM5319eWATqHSORvFaaYE4VEMFnemksDoSRD7eBotLcUu2AAAAWRsn KjbVGPneo431L7NrL/cIqLpHeg== X-Google-Smtp-Source: ABdhPJw55IYpslBIeNm7CSAD0/aFKeO6fPszM6xcQIbO2to4rW3WuJCoDv89BFFh8ijcUNn8XO/zCg== X-Received: by 2002:adf:e751:: with SMTP id c17mr26731675wrn.134.1592217832207; Mon, 15 Jun 2020 03:43:52 -0700 (PDT) Return-Path: Received: from [10.0.0.122] ([84.203.48.247]) by smtp.googlemail.com with ESMTPSA id b201sm22092481wmb.36.2020.06.15.03.43.50 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 15 Jun 2020 03:43:51 -0700 (PDT) Subject: Re: [edk2-platform][PATCH v1 1/2] Platforms/RaspberryPi: Add RPi4 settings to Readme To: Samer El-Haj-Mahmoud , devel@edk2.groups.io Cc: Leif Lindholm , Ard Biesheuvel , Andrei Warkentin References: <20200613134144.4610-1-Samer.El-Haj-Mahmoud@arm.com> <20200613134144.4610-2-Samer.El-Haj-Mahmoud@arm.com> From: "Pete Batard" Message-ID: <2b1882f9-9702-6652-479d-60b7618a7a29@akeo.ie> Date: Mon, 15 Jun 2020 11:43:50 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101 Thunderbird/68.9.0 MIME-Version: 1.0 In-Reply-To: <20200613134144.4610-2-Samer.El-Haj-Mahmoud@arm.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-GB Content-Transfer-Encoding: 7bit Hi Samer, One remark inline: On 2020.06.13 14:41, Samer El-Haj-Mahmoud wrote: > 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 > --- > Platform/RaspberryPi/RPi4/Readme.md | 74 +++++++++++++++++++- > 1 file changed, 73 insertions(+), 1 deletion(-) > > diff --git a/Platform/RaspberryPi/RPi4/Readme.md b/Platform/RaspberryPi/RPi4/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. > > - 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 using both the UI configuration menu (under `Device Manager` -> `Raspberry Pi Configuration`), as well as the UEFI Shell. To configure using the UEFI Shell, use `setvar` command to read/write the UEFI variables with GUID = `CD7CC258-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 = > +``` > + > +For string-type settings (e.g. Asset Tag), the syntax to write is: > +``` > +setvar -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =L"" =0x0000 > +``` > + > +UEFI Setting | NAME | VALUE > +-----------------------------|-----------------------|----------------------------- > +**CPU Configuration** | > +CPU Clock | `CpuClock` | Low = `0x00000000`
Default = `0x00000001` (default)
Max = `0x00000002`
Custom = `0x00000003` > +CPU Clock Rate (MHz) | `CustomCpuClock` | Hex numeric value, 4-bytes
(e.g. `0x000005DC` for 1500 MHz) > +**Display Configuration** | > +Virtual 640x480 | `DisplayEnableScaledVModes` | Checked = Bit 0 set (i.e. ` | 0x01` 1. A closing parenthesis is missing at the end. 2. A backslash must be added before the pipe in the last code section, or else it won't display. This is due to https://github.com/github/markup/issues/1078. In other words, you need to have: ` \| 0x01` > +Virtual 800x600 | `DisplayEnableScaledVModes` | Checked = Bit 1 set (i.e. ` | 0x02` > +Virtual 1024x768 | `DisplayEnableScaledVModes` | Checked = Bit 2 set (i.e. ` | 0x04` > +Virtual 720p | `DisplayEnableScaledVModes` | Checked = Bit 3 set (i.e. ` | 0x08` > +Virtual 1080p | `DisplayEnableScaledVModes` | Checked = Bit 4 set (i.e. ` | 0x10` > +Native resolution | `DisplayEnableScaledVModes` | Checked = Bit 5 set (i.e. ` | 0x20` (default) Same as above for these 5 lines. Regards, /Pete > +Screenshot support | `DisplayEnableSShot` | Control-Alt-F12 = `0x00000001` (default)
Not Enabled = `0x00000000` > +**Advanced Configuration** | > +Limit RAM to 3 GB | `RamLimitTo3GB` | Disable = `0x00000000`
Enabled= `0x00000001` (default) > +System Table Selection | `SystemTableMode`| ACPI = `0x00000000` (default)
ACPI + Devicetree = `0x00000001`
Devicetree = `0x00000002` > +Asset Tag | `AssetTag` | String, 32 characters or less (e.g. `L"ABCD123"`)
(default `L""`) > +**SD/MMC Configuration** | > +uSD/eMMC Routing | `SdIsArasan` | Arasan SDHC = `0x00000001` (default)
eMMC2 SDHCI = `0x00000000` > +Multi-Block Support | `MmcDisableMulti` | Multi-block transfers = `0x00000000` (default)
Single block transfers = `0x00000001` > +uSD Max Bus Width | `MmcForce1Bit` | 4-bit Mode = `0x00000000` (default)
1-bit Mode = `0x00000001` > +uSD Force Default Speed | `MmcForceDefaultSpeed` | Allow High Speed = `0x00000000` (default)
Force Default Speed = `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 = `0x00000001`
Disable JTAG= `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 =0x00000002 > +``` > + > +- 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 -nv =0x00000000 > +``` > + > +- To change the Asset Tag to the string "ASSET-TAG-123" : > +``` > +setvar AssetTag -guid CD7CC258-31DB-22E6-9F22-63B0B8EED6B5 -bs -rt -nv =L"ASSET-TAG-123" =0x0000 > +``` >