Michael D Kinney e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
..
AcpiPlatform 3ca17630b7 Vlv2TbltDevicePkg/AcpiPlatform: Fix the error from InstallAcpiTable 4 years ago
Application 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
Feature a761f83dae Vlv2TbltDevicePkg/GenerateCapsule: Fix the bash scripts 4 years ago
FvInfoPei 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FvbRuntimeDxe 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
Include e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
IntelGopDepex 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
Library e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
Logo 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
MonoStatusCode 3124becd26 Vlv2TbltDevicePkg: Add the missing headers to inf files 4 years ago
PciPlatform 0fb81280a3 Vlv2TbltDevicePkg: Switch to CPU I/O 2 Protocol 4 years ago
PcuSio 8a0a748aec Vlv2TbltDevicePkg: Switch from ISA to SIO modules 4 years ago
PlatformCpuInfoDxe 0fb81280a3 Vlv2TbltDevicePkg: Switch to CPU I/O 2 Protocol 4 years ago
PlatformDxe e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformGopPolicy 0fb81280a3 Vlv2TbltDevicePkg: Switch to CPU I/O 2 Protocol 4 years ago
PlatformInfoDxe 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformInitPei d655a4c81f Vlv2TbltDevicePkg/PlatformInitPei: Update MemoryTypeInformation 4 years ago
PlatformPei d621139079 Vlv2TbltDevicePkg: Update boot mode/state behaviors 4 years ago
PlatformSetupDxe e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformSmm 4cf750e42e Vlv2TbltDevicePkg/PlatformSmm: Switch to PI SMM Protocols 4 years ago
PpmPolicy b1d2bf7eea Vlv2TbltDevicePkg: Reduce Intel Framework dependencies 4 years ago
SaveMemoryConfig 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
SmBiosMiscDxe e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
Stitch d9c8486b80 Vlv2TbltDevicePkg: Remove unused modules/libraries 4 years ago
VlvPlatformInitDxe cf23baaeb5 Vlv2TbltDevicePkg: Remove use of Data Hub Protocol 4 years ago
.gitignore 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
BfmLib.exe 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
Build_IFWI.bat b1d2bf7eea Vlv2TbltDevicePkg: Reduce Intel Framework dependencies 4 years ago
Build_IFWI.sh 20dd41e2bb Vlv2TbltDevicePkg/Build_IFWI.sh: Check the WORKSPACE env variable 4 years ago
FCE.exe 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FmpBlueSampleDevice.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FmpCertificate.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FmpGreenSampleDevice.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FmpMinnowMaxSystem.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
FmpRedSampleDevice.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformCapsule.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformCapsule.fdf 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformCapsuleGcc.dsc 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformCapsuleGcc.fdf 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
PlatformPkg.dec b304ab2a09 Vlv2TbltDevicePkg: Remove redundant gEfiSpiProtocolGuid 4 years ago
PlatformPkg.fdf e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformPkgConfig.dsc cf23baaeb5 Vlv2TbltDevicePkg: Remove use of Data Hub Protocol 4 years ago
PlatformPkgGcc.fdf e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformPkgGccX64.dsc e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformPkgIA32.dsc e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
PlatformPkgX64.dsc e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
Readme.md 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago
bld_vlv.bat e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
bld_vlv.sh e286c36ae4 Vlv2TbltDevicePkg: Re-enable BIOS ID feature 4 years ago
cln.sh 31a2b7d34b Platform/Vlv2TbltDevicePkg: Import Vlv2TbltDevicePkg from edk2 5 years ago

Readme.md

EDK II firmware for Minnowboard Max/Turbot which is based on Intel Valleyview2 SoC (Byatrail platform)


Windows Pre-requisites

  • GIT client: Available from https://git-scm.com/downloads

  • Microsoft Visual Studio.

    • Visual Studio 2015 recommended and is used in the examples below. Visual Studio 2013 is also supported.
  • WINDDK

    • Download Microsoft Windows Driver Development Kit 3790.1830 and install it to C:\WINDDK\3790.1830.
  • Python 3

  • Install iASL

    • Install the iasl compiler by downloading iasl-win-20160527.zip from the following location: «https://acpica.org/downloads/" and place the unzipped content («iasl.exe») into the directory «C:\ASL» on your local hard drive (create the folder «C:\ASL» if it does not exist).
  • Install the NASM* assembly language compiler

  • Install Openssl

    • Download a pre-compiled Openssl Windows binary from https://wiki.openssl.org/index.php/Binaries. Search for a Windows binary in the list of «Third Party OpenSSL Related Binary Distributions». Go to the third party site to download the latest version. Download and extract to C:\Openssl, add the path of openssl.exe («C:\openssl») to system environment variable OPENSSL_PATH.

Download and Build MinnowMax using Windows/Visual Studio

Run the script below from an empty directory. The script clones the EDK II repository from GitHub and downloads and unzips the binary support files for the MinnowBoard MAX. It then sets up the environment for EDK II builds and builds the MinnowBoard MAX firmware and generates UEFI Capsules that can be used to update the MinnowBoard MAX firmware and three sample devices.

git clone --recurse-submodules https://github.com/tianocore/edk2.git

powershell "& {[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://indy.fulgan.com/SSL/openssl-1.0.2r-x64_86-win64.zip -OutFile openssl-1.0.2r-x64_86-win64.zip"}"
powershell Expand-Archive openssl-1.0.2r-x64_86-win64.zip

powershell "& {[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://firmware.intel.com/sites/default/files/MinnowBoardMax-Development190216.zip -OutFile MinnowBoardMax-Development190216.zip"}"
powershell Expand-Archive MinnowBoardMax-Development190216.zip
sleep 1
rename MinnowBoardMax-Development190216 Vlv2Binaries
cd Vlv2Binaries
powershell Expand-Archive Vlv2SocBinPkg.zip .
sleep 1
cd ..

powershell "& {[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://www.nasm.us/pub/nasm/releasebuilds/2.13.03/win64/nasm-2.13.03-win64.zip -OutFile nasm-2.13.03-win64.zip"}"
powershell Expand-Archive nasm-2.13.03-win64.zip .

mkdir Conf

set WORKSPACE=%CD%
set EDK_TOOLS_PATH=%WORKSPACE%\edk2\BaseTools
set EDK_TOOLS_BIN=%EDK_TOOLS_PATH%\BinWrappers\WindowsLike
set PACKAGES_PATH=%WORKSPACE%\edk2;%WORKSPACE%\Vlv2Binaries
path=%path%;%EDK_TOOLS_PATH%\Bin\Win32;%WORKSPACE%\openssl-1.0.2r-x64_86-win64
set NASM_PREFIX=%WORKSPACE%\nasm-2.13.03\

cd %WORKSPACE%\edk2

call edkSetup.bat Rebuild

cd Vlv2TbltDevicePkg

Build_IFWI.bat /m /y MNW2 Debug

Once all the code and tools are downloaded and installed, only the following commands are required to setup the environment. Run these from the same directory used to install the source and binaries.

set WORKSPACE=%CD%
set EDK_TOOLS_PATH=%WORKSPACE%\edk2\BaseTools
set EDK_TOOLS_BIN=%EDK_TOOLS_PATH%\BinWrappers\WindowsLike
set PACKAGES_PATH=%WORKSPACE%\edk2;%WORKSPACE%\Vlv2Binaries
path=%path%;%EDK_TOOLS_PATH%\Bin\Win32;%WORKSPACE%\openssl-1.0.2r-x64_86-win64
set NASM_PREFIX=%WORKSPACE%\nasm-2.13.03\

cd %WORKSPACE%\edk2

call edkSetup.bat Rebuild

Once the environment is setup, the MinnowBoard MAX firmware and capsules can be rebuilt using the following commands.

  • Build Debug Image

    cd Vlv2TbltDevicePkg
    Build_IFWI.bat /m /y MNW2 Debug
    
  • Build Release Image

    cd Vlv2TbltDevicePkg
    Build_IFWI.bat /m /y MNW2 Release
    

The generated firmware image is the newest .bin file in edk2/Vlv2TbltDevicePkg/Stitch. The file is in the form MNW2MAX1.X64.0084.D01.<DATE>.bin.

The CapsuleApp and generated UEFI Capsules are in Build/Vlv2TbltDevicePkg/Capsules

Linux Pre-requisites

  • The tool GenBiosId has a dependency on libc.so.6. Make sure it is installed. Here are a few example installation commands:

    sudo dnf install libc.so.6

    apt-get install libc:i386

Download and Build MinnowMax using Linux/GCC

Run the script below from an empty directory. The script clones the EDK II repository from GitHub and downloads and unzips the binary support files for the MinnowBoard MAX. It then sets up the environment for EDK II builds and builds the MinnowBoard MAX firmware and generates UEFI Capsules that can be used to update the MinnowBoard MAX firmware and three sample devices.

git clone --recurse-submodules https://github.com/tianocore/edk2.git

mkdir Vlv2Binaries
cd Vlv2Binaries
wget https://firmware.intel.com/sites/default/files/MinnowBoardMax-Development190216.zip
unzip MinnowBoardMax-Development190216.zip
unzip Vlv2SocBinPkg.zip

cd ..
mkdir Conf

export WORKSPACE=$PWD/edk2
export PACKAGES_PATH=$PWD/Vlv2Binaries
export EDK_TOOLS_PATH=$WORKSPACE/BaseTools

cd edk2
cd Vlv2TbltDevicePkg
. Build_IFWI.sh MNW2 Debug

Once all the code is downloaded and installed, only the following commands are required to setup the environment. Run these from the same directory used to install the source and binaries.

export WORKSPACE=$PWD/edk2
export PACKAGES_PATH=$PWD/Vlv2Binaries
export EDK_TOOLS_PATH=$WORKSPACE/BaseTools

cd edk2
cd Vlv2TbltDevicePkg

Once the environment is setup, the MinnowBoard MAX firmware and capsules can be rebuilt using the following commands.

  • Build Debug Image

    cd Vlv2TbltDevicePkg
    ./Build_IFWI.sh MNW2 Debug
    
  • Build Release Image

    cd Vlv2TbltDevicePkg
    ./Build_IFWI.sh MNW2 Release
    

The generated firmware image is the MNW2MAX_X64_D_0084_01_GCC.bin file in edk2\Vlv2TbltDevicePkg\Stitch

The CapsuleApp and generated UEFI Capsules are in Build\Vlv2TbltDevicePkg\Capsules

Use DediProg to update FLASH image on a MinnowBoard MAX Target

Update MinnowBoard MAX Firmware from UEFI Capsules

  • Copy the Build/Vlv2TbltDevicePkg/Capsules directory to a USB FLASH drive
  • Connect USB FLASH Drive to MinnowBoard MAX
  • Boot MinnowBoard MAX to the Boot Manager
  • Boot the EFI Internal Shell boot option
  • Mount the USB FLASH Drive (usually FS1)
  • Use cd command to go to Capsules/TestCert directory
  • Run the following command to apply all four capsules

    CapsuleApp.efi Red.cap Green.cap Blue.cap MinnowMax.cap
    
  • The MinnowBoard MAX should reboot and the four capsules are applied in the order listed. The progress bar matches the color name of the capsule. MinnowMax.cap uses the color purple. Once all capsules are processed, the MinnowBoard MAX should reboot again using the new firmware images.

Generate and Test a UX BitMap Capsule

  • Use bitmap editor to generate a BMP file. Recommend resolution of 600 wide by 100 tell and either 24 or 32 bits per pixel.
  • Save BMP file to USB FLASH drive
  • Use CapsuleApp.efi to convert BMP file to a UX Capsule

    CapsuleApp.efi -G MyImage.bmp -O MyImage.cap
    
  • When updating firmware using capsules, add UX capsule to the list of capsules passed into CapsuleApp.efi.

    CapsuleApp.efi MyImage.cap Red.cap Green.cap Blue.cap MinnowMax.cap
    
  • When the capsules are processed the UX bitmap image should be displayed at the bottom of the screen.