Intel® Quark™ SoC

The Quark™ SoC code was developed using the Galileo Gen 2 board:

Overall development
SoC support
FSP 1.1 integration
Board support

Quark™ Documentation

Block Diagram
Intel® 64 and IA-32 Architectures Software Developer Manual
Specifications:
- X1000 - Documentation:

Quark™ EDK2 CorebootPayloadPkg

Build Instructions:

Set up build environment

For the Galileo Gen 2, replace the following lines in CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc:

  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio|FALSE
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0x03F8

with:

#
# Quark configuration
#
  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber|1

#
# Specify Galileo HSUART1 serial port
#
[PcdsPatchableInModule.common]
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialPciDeviceInfo|{0xff}
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio|TRUE
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0xA0019000
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterStride|4

  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialClockRate|44236800
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialBaudRate|921600
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialLineControl|3 # 8-bits, no parity
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseHardwareFlowControl|FALSE
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialDetectCable|FALSE
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialFifoControl|1 # Enable FIFO
  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialExtendedTxFifoSize|16

Build Instructions:

Linux (assumes GCC48):

Edit Conf/tools_def.txt to add " -march=i586" to the IA32_CC_FLAGS for the GCC compiler being used:
```
*_GCC48_IA32_CC_FLAGS             = DEF(GCC48_IA32_CC_FLAGS) -Os -march=i586
```

build -p CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc  -a IA32  -t GCC48  -b DEBUG  -DDEBUG_PROPERTY_MASK=0x27  -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
ls Build/CorebootPayloadPkgIA32/DEBUG_GCC48/FV/UEFIPAYLOAD.fd

Windows:

build -p CorebootPayloadPkg\CorebootPayloadPkgIa32.dsc  -a IA32  -t VS2012x86  -b DEBUG  -DDEBUG_PROPERTY_MASK=0x27  -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
dir Build\CorebootPayloadPkgIA32\DEBUG_VS2012x86\FV\UEFIPAYLOAD.fd

In the .config for coreboot, set the following Kconfig values:
- CONFIG_PAYLOAD_ELF=y
- CONFIG_PAYLOAD_FILE="path to UEFIPAYLOAD.fd"
Build coreboot
Copy the image build/coreboot.rom into flash

Quark™ EDK2 Build Environment

Use the following steps to setup a build environment:

Get the EDK2 sources:
1. EDK2: git clone https://github.com/tianocore/edk2.git
2. EDK2-FatPkg: git clone https://github.com/tianocore/edk2-FatPkg.git FatPkg
3. EDK2-non-osi: git clone https://github.com/tianocore/edk2-non-osi.git
4. Win32 BaseTools: git clone https://github.com/tianocore/edk2-BaseTools-win32.git

Set up a build window:

Linux:

export WORKSPACE=$PWD
export PACKAGES_PATH="$PWD/edk2:$PWD/FatPkg:$PWD/edk2-non-osi"
cd edk2
export WORKSPACE=$PWD
. edksetup.sh

Windows:

set WORKSPACE=%CD%
set PACKAGES_PATH=%WORKSPACE%\edk2;%WORKSPACE%\FatPkg;%WORKSPACE%\edk2-non-osi
set EDK_TOOLS_BIN=%WORKSPACE%\edk2-BaseTools-win32
cd edk2
edksetup.bat

EDK2 Documentation:

Build V1.26
Coding Standards V2.1
DEC V1.25
DSC V1.26
Driver Writer's Guide
Expression Syntax V1.1
FDF V1.26
INF V1.25
PCD PCDV0.55
UNI V1.2 Errata A
VRF V1.9

Quark™ FSP

Documentation:

Intel® Firmware Support Package External Architecture Specification V1.1

Quark™ EDK2 BIOS

Build Instructions:

Set up build environment

Build the image:

Linux:

build -p QuarkPlatformPkg/Quark.dsc  -a IA32  -t GCC48  -b DEBUG  -DDEBUG_PROPERTY_MASK=0x27  -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
ls Build/Quark/DEBUG_GCC48/FV/Quark.fd

Windows:

build -p QuarkPlatformPkg/Quark.dsc  -a IA32  -t VS2012x86  -b DEBUG  -DDEBUG_PROPERTY_MASK=0x27  -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
dir Build\Quark\DEBUG_VS2012x86\FV\Quark.fd

Documentation:

EDK II firmware for Intel® Quark™ SoC X1000 based platforms
Intel® Quark™ SoC X1000 UEFI Firmware Writer's Guide

Modified: 29 February 2016