x86: Support booting Linux kernel on Intel Galileo
v2 cover x86: Support booting Linux kernel on Intel Galileo
Currently U-Boot works great on Intel Galileo board, but it still has some issues when booting a Linux kernel. The issues are mainly with Isolated Memory Region (IMR) and thermal sensor support in the Linux kernel for Intel Quark SoC. For example, kernel just hangs after kernel IMR driver is probed.
It turns out U-Boot still misses some key register programming. Add those register initializtion so that Linux kernel can boot succesfully.
Tested on Intel Galileo board, with an AHCI mini-PCIe card with an SSD attached (to test PCI IRQ behind the root port), as well as a micro-SD card, a USB flash disk and ethernet under Linux.
Note the mainline Linux designware Ethernet driver uses an API dmi_get_system_info() to determine the PHY address. Since U-Boot currently does not support the DMI, to test the Ethernet under Linux we need patch the kernel driver, but in the long term, we should add DMI support in U-Boot. Add a TODO in README.x86 for now.
Changes in v2:
- Change all macros to use a single msg_port_generic_clrsetbits
- Update per review comments from Simon
Bin Meng (8):
x86: galileo: Enable random mac address for Quark
x86: quark: Add clrbits, setbits, clrsetbits macros for message port
access
x86: quark: Convert to use clrbits, setbits, clrsetbits macros
x86: quark: Lock HMBOUND register before jumping to kernel
x86: quark: Initialize thermal sensor properly
x86: galileo: Add PCIe root port IRQ routing
x86: doc: Document some porting hints about Intel Quark
x86: doc: Add DMI to the TODO list
arch/x86/cpu/quark/quark.c | 115 ++++++++++++++++------------- arch/x86/dts/galileo.dts | 12 +++ arch/x86/include/asm/arch-quark/msg_port.h | 31 ++++++++ arch/x86/include/asm/arch-quark/quark.h | 15 ++++ configs/galileo_defconfig | 1 + doc/README.x86 | 26 +++++++ 6 files changed, 149 insertions(+), 51 deletions(-)
Signature · 1 line
1.8.2.1
PATCH v2 1/8 x86: galileo: Enable random mac address for Quark
Not like other Intel Ethernet controllers (e.g.: E1000), Intel Quark SoC integrated designware Ethernet controller does not have a chipset defined way to store/restore mac address. Enable random mac address so that we can use Ethernet even without 'ethaddr'.
---
Changes in v2: None
configs/galileo_defconfig | 1 + 1 file changed, 1 insertion(+)
configs/galileo_defconfig +1 -0
@@ -11,6 +11,7 @@ CONFIG_BOOTSTAGE=y CONFIG_BOOTSTAGE_REPORT=y CONFIG_CMD_BOOTSTAGE=y CONFIG_OF_CONTROL=y +CONFIG_NET_RANDOM_ETHADDR=y CONFIG_SPI_FLASH=y CONFIG_DM_ETH=y CONFIG_ETH_DESIGNWARE=y
Signature · 1 line
1.8.2.1
PATCH v2 1/8 x86: galileo: Enable random mac address for Quark
Quoted 5 lines · Bin Meng
Not like other Intel Ethernet controllers (e.g.: E1000), Intel Quark SoC integrated designware Ethernet controller does not have a chipset defined way to store/restore mac address. Enable random mac address so that we can use Ethernet even without 'ethaddr'.
Quoted 8 lines
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>---
Changes in v2: None
configs/galileo_defconfig | 1 + 1 file changed, 1 insertion(+)
Applied to u-boot-x86, thanks!
PATCH v2 2/8 x86: quark: Add clrbits, setbits, clrsetbits macros for message port access
In reply to Bin MengOn Intel Quark, lots of registers on the message port need be programmed. Add handy clrbits, setbits, clrsetbits macros for message port access.
---
Changes in v2:
- Change all macros to use a single msg_port_generic_clrsetbits
arch/x86/include/asm/arch-quark/msg_port.h | 31 ++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+)
arch/x86/include/asm/arch-quark/msg_port.h +31 -0
@@ -101,6 +101,37 @@ u32 msg_port_io_read(u8 port, u32 reg);*/ void msg_port_io_write (u8 port,u32 reg,u32 value); +/* clrbits, setbits, clrsetbits macros for message port access */ + +#define msg_port_normal_read msg_port_read +#define msg_port_normal_write msg_port_write + +#define msg_port_generic_clrsetbits (type, port, reg, clr, set) \ + msg_port_##type##_write(port, reg, \ + (msg_port_##type##_read(port, reg) \ + & ~(clr)) | (set)) + +#define msg_port_clrbits (port, reg, clr) \ + msg_port_generic_clrsetbits(normal, port, reg, clr, 0) +#define msg_port_setbits (port, reg, set) \ + msg_port_generic_clrsetbits(normal, port, reg, 0, set) +#define msg_port_clrsetbits (port, reg, clr, set) \ + msg_port_generic_clrsetbits(normal, port, reg, clr, set) + +#define msg_port_alt_clrbits (port, reg, clr) \ + msg_port_generic_clrsetbits(alt, port, reg, clr, 0) +#define msg_port_alt_setbits (port, reg, set) \ + msg_port_generic_clrsetbits(alt, port, reg, 0, set) +#define msg_port_alt_clrsetbits (port, reg, clr, set) \ + msg_port_generic_clrsetbits(alt, port, reg, clr, set) + +#define msg_port_io_clrbits (port, reg, clr) \ + msg_port_generic_clrsetbits(io, port, reg, clr, 0) +#define msg_port_io_setbits (port, reg, set) \ + msg_port_generic_clrsetbits(io, port, reg, 0, set) +#define msg_port_io_clrsetbits (port, reg, clr, set) \ + msg_port_generic_clrsetbits(io, port, reg, clr, set) +#endif /* __ASSEMBLY__ */ #endif /* _QUARK_MSG_PORT_H_ */
Signature · 1 line
1.8.2.1
PATCH v2 2/8 x86: quark: Add clrbits, setbits, clrsetbits macros for message port access
Quoted 7 lines · Bin Meng
On Intel Quark, lots of registers on the message port need be programmed. Add handy clrbits, setbits, clrsetbits macros for message port access.
Signed-off-by Bin Meng <[email protected]>Reviewed-by Simon Glass <[email protected]>
Quoted 7 lines
---
Changes in v2:
- Change all macros to use a singlemsg_port_generic_clrsetbitsarch/x86/include/asm/arch-quark/msg_port.h | 31 ++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+)
Applied to u-boot-x86, thanks!
PATCH v2 3/8 x86: quark: Convert to use clrbits, setbits, clrsetbits macros
In reply to Bin MengChange existing codes to use clrbits, setbits, clrsetbits macros.
---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 72 ++++++++++++++-------------------------------- 1 file changed, 21 insertions(+), 51 deletions(-)
arch/x86/cpu/quark/quark.c +21 -51
@@ -73,8 +73,6 @@ static void quark_setup_bars(void)static void quark_pcie_early_init (void ) { -u32 pcie_cfg; -/* * Step1: Assert PCIe signal PERST# *
@@ -84,23 +82,18 @@ static void quark_pcie_early_init(void)board_assert_perst ();/* Step2: PHY common lane reset */ - pcie_cfg =msg_port_alt_read (MSG_PORT_SOC_UNIT ,PCIE_CFG ); - pcie_cfg |=PCIE_PHY_LANE_RST ; -msg_port_alt_write (MSG_PORT_SOC_UNIT ,PCIE_CFG , pcie_cfg); +msg_port_alt_setbits (MSG_PORT_SOC_UNIT ,PCIE_CFG ,PCIE_PHY_LANE_RST );/* wait 1 ms for PHY common lane reset */ mdelay (1 );/* Step3: PHY sideband interface reset and controller main reset */ - pcie_cfg =msg_port_alt_read (MSG_PORT_SOC_UNIT ,PCIE_CFG ); - pcie_cfg |= (PCIE_PHY_SB_RST |PCIE_CTLR_MAIN_RST ); -msg_port_alt_write (MSG_PORT_SOC_UNIT ,PCIE_CFG , pcie_cfg); +msg_port_alt_setbits (MSG_PORT_SOC_UNIT ,PCIE_CFG , +PCIE_PHY_SB_RST |PCIE_CTLR_MAIN_RST );/* wait 80ms for PLL to lock */ mdelay (80 );/* Step4: Controller sideband interface reset */ - pcie_cfg =msg_port_alt_read (MSG_PORT_SOC_UNIT ,PCIE_CFG ); - pcie_cfg |=PCIE_CTLR_SB_RST ; -msg_port_alt_write (MSG_PORT_SOC_UNIT ,PCIE_CFG , pcie_cfg); +msg_port_alt_setbits (MSG_PORT_SOC_UNIT ,PCIE_CFG ,PCIE_CTLR_SB_RST );/* wait 20ms for controller sideband interface reset */ mdelay (20 );
@@ -108,66 +101,43 @@ static void quark_pcie_early_init(void)board_deassert_perst ();/* Step6: Controller primary interface reset */ - pcie_cfg =msg_port_alt_read (MSG_PORT_SOC_UNIT ,PCIE_CFG ); - pcie_cfg |=PCIE_CTLR_PRI_RST ; -msg_port_alt_write (MSG_PORT_SOC_UNIT ,PCIE_CFG , pcie_cfg); +msg_port_alt_setbits (MSG_PORT_SOC_UNIT ,PCIE_CFG ,PCIE_CTLR_PRI_RST );/* Mixer Load Lane 0 */ - pcie_cfg =msg_port_io_read (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L0 ); - pcie_cfg &= ~((1 <<6 ) | (1 <<7 )); -msg_port_io_write (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L0 , pcie_cfg); +msg_port_io_clrbits (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L0 , + (1 <<6 ) | (1 <<7 ));/* Mixer Load Lane 1 */ - pcie_cfg =msg_port_io_read (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L1 ); - pcie_cfg &= ~((1 <<6 ) | (1 <<7 )); -msg_port_io_write (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L1 , pcie_cfg); +msg_port_io_clrbits (MSG_PORT_PCIE_AFE ,PCIE_RXPICTRL0_L1 , + (1 <<6 ) | (1 <<7 )); }static void quark_usb_early_init (void ) { -u32 usb; -/* The sequence below comes from Quark firmware writer guide */ - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_GLOBAL_PORT ); - usb &= ~(1 <<1 ); - usb |= ((1 <<6 ) | (1 <<7 )); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_GLOBAL_PORT , usb); +msg_port_alt_clrsetbits (MSG_PORT_USB_AFE ,USB2_GLOBAL_PORT , +1 <<1 , (1 <<6 ) | (1 <<7 )); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_COMPBG ); - usb &= ~((1 <<8 ) | (1 <<9 )); - usb |= ((1 <<7 ) | (1 <<10 )); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_COMPBG , usb); +msg_port_alt_clrsetbits (MSG_PORT_USB_AFE ,USB2_COMPBG , + (1 <<8 ) | (1 <<9 ), (1 <<7 ) | (1 <<10 )); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_PLL2 ); - usb |= (1 <<29 ); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_PLL2 , usb); +msg_port_alt_setbits (MSG_PORT_USB_AFE ,USB2_PLL2 ,1 <<29 ); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_PLL1 ); - usb |= (1 <<1 ); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_PLL1 , usb); +msg_port_alt_setbits (MSG_PORT_USB_AFE ,USB2_PLL1 ,1 <<1 ); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_PLL1 ); - usb &= ~((1 <<3 ) | (1 <<4 ) | (1 <<5 )); - usb |= (1 <<6 ); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_PLL1 , usb); +msg_port_alt_clrsetbits (MSG_PORT_USB_AFE ,USB2_PLL1 , + (1 <<3 ) | (1 <<4 ) | (1 <<5 ),1 <<6 ); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_PLL2 ); - usb &= ~(1 <<29 ); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_PLL2 , usb); +msg_port_alt_clrbits (MSG_PORT_USB_AFE ,USB2_PLL2 ,1 <<29 ); - usb =msg_port_alt_read (MSG_PORT_USB_AFE ,USB2_PLL2 ); - usb |= (1 <<24 ); -msg_port_alt_write (MSG_PORT_USB_AFE ,USB2_PLL2 , usb); +msg_port_alt_setbits (MSG_PORT_USB_AFE ,USB2_PLL2 ,1 <<24 ); }static void quark_enable_legacy_seg (void ) { -u32 hmisc2; - - hmisc2 =msg_port_read (MSG_PORT_HOST_BRIDGE ,HMISC2 ); - hmisc2 |= (HMISC2_SEGE |HMISC2_SEGF |HMISC2_SEGAB ); -msg_port_write (MSG_PORT_HOST_BRIDGE ,HMISC2 , hmisc2); +msg_port_setbits (MSG_PORT_HOST_BRIDGE ,HMISC2 , +HMISC2_SEGE |HMISC2_SEGF |HMISC2_SEGAB ); }int arch_cpu_init (void )
Signature · 1 line
1.8.2.1
PATCH v2 3/8 x86: quark: Convert to use clrbits, setbits, clrsetbits macros
Quoted 10 lines · Bin Meng
Change existing codes to use clrbits, setbits, clrsetbits macros.
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 72 ++++++++++++++-------------------------------- 1 file changed, 21 insertions(+), 51 deletions(-)
Applied to u-boot-x86, thanks!
PATCH v2 4/8 x86: quark: Lock HMBOUND register before jumping to kernel
In reply to Bin MengWhen Linux kernel boots, it hangs at:
[ 0.829408] Intel Quark side-band driver registered
This happens when Quark kernel Isolated Memory Region (IMR) driver tries to lock an IMR register to protect kernel's text and rodata sections. However in order to have IMR function correctly, HMBOUND register must be locked otherwise the system just hangs.
---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 3 +++ arch/x86/include/asm/arch-quark/quark.h | 1 + 2 files changed, 4 insertions(+)
arch/x86/cpu/quark/quark.c +3 -0
@@ -288,5 +288,8 @@ void board_final_cleanup(void) val &= ~0xff0000 ;writel (val, &rcba->esd); +/* Lock HMBOUND for security */ +msg_port_setbits (MSG_PORT_HOST_BRIDGE ,HM_BOUND ,HM_BOUND_LOCK ); +return ; }
arch/x86/include/asm/arch-quark/quark.h +1 -0
@@ -32,6 +32,7 @@/* Host Memory I/O Boundary */ #define HM_BOUND 0x08 +#define HM_BOUND_LOCK 0x00000001/* Extended Configuration Space */ #define HEC_REG 0x09
Signature · 1 line
1.8.2.1
PATCH v2 4/8 x86: quark: Lock HMBOUND register before jumping to kernel
Quoted 11 lines · Bin Meng
When Linux kernel boots, it hangs at:
[ 0.829408] Intel Quark side-band driver registeredThis happens when Quark kernel Isolated Memory Region (IMR) driver tries to lock an IMR register to protect kernel's text and rodata sections. However in order to have IMR function correctly, HMBOUND register must be locked otherwise the system just hangs.
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>
Quoted 7 lines
---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 3 +++ arch/x86/include/asm/arch-quark/quark.h | 1 + 2 files changed, 4 insertions(+)
Applied to u-boot-x86, thanks!
PATCH v2 5/8 x86: quark: Initialize thermal sensor properly
In reply to Bin MengThermal sensor on Quark SoC needs to be properly initialized per Quark firmware writer guide, otherwise when booting Linux kernel, it triggers system shutdown because of wrong temperature in the thermal sensor is detected by the kernel driver (see below):
[ 5.119819] thermal_sys: Critical temperature reached(206 C),shutting down [ 5.128997] Failed to start orderly shutdown: forcing the issue [ 5.135495] Emergency Sync complete
---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 40 +++++++++++++++++++++++++++++++++ arch/x86/include/asm/arch-quark/quark.h | 14 ++++++++++++ 2 files changed, 54 insertions(+)
arch/x86/cpu/quark/quark.c +40 -0
@@ -134,6 +134,43 @@ static void quark_usb_early_init(void)msg_port_alt_setbits (MSG_PORT_USB_AFE ,USB2_PLL2 ,1 <<24 ); } +static void quark_thermal_early_init (void ) +{ +/* The sequence below comes from Quark firmware writer guide */ + +/* thermal sensor mode config */ +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG1 , + (1 <<3 ) | (1 <<4 ) | (1 <<5 ),1 <<5 ); +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG1 , + (1 <<8 ) | (1 <<9 ) | (1 <<10 ) | (1 <<11 ) | + (1 <<12 ),1 <<9 ); +msg_port_alt_setbits (MSG_PORT_SOC_UNIT ,TS_CFG1 ,1 <<14 ); +msg_port_alt_clrbits (MSG_PORT_SOC_UNIT ,TS_CFG1 ,1 <<17 ); +msg_port_alt_clrbits (MSG_PORT_SOC_UNIT ,TS_CFG1 ,1 <<18 ); +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG2 ,0xffff ,0x011f ); +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG3 ,0xff ,0x17 ); +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG3 , + (1 <<8 ) | (1 <<9 ),1 <<8 ); +msg_port_alt_clrbits (MSG_PORT_SOC_UNIT ,TS_CFG3 ,0xff000000 ); +msg_port_alt_clrsetbits (MSG_PORT_SOC_UNIT ,TS_CFG4 , +0x7ff800 ,0xc8 <<11 ); + +/* thermal monitor catastrophic trip set point (105 celsius) */ +msg_port_clrsetbits (MSG_PORT_RMU ,TS_TRIP ,0xff ,155 ); + +/* thermal monitor catastrophic trip clear point (0 celsius) */ +msg_port_clrsetbits (MSG_PORT_RMU ,TS_TRIP ,0xff0000 ,50 <<16 ); + +/* take thermal sensor out of reset */ +msg_port_alt_clrbits (MSG_PORT_SOC_UNIT ,TS_CFG4 ,1 <<0 ); + +/* enable thermal monitor */ +msg_port_setbits (MSG_PORT_RMU ,TS_MODE ,1 <<15 ); + +/* lock all thermal configuration */ +msg_port_setbits (MSG_PORT_RMU ,RMU_CTRL , (1 <<5 ) | (1 <<6 )); +} +static void quark_enable_legacy_seg (void ) { msg_port_setbits(MSG_PORT_HOST_BRIDGE, HMISC2,
@@ -173,6 +210,9 @@ int arch_cpu_init(void)/* Initialize USB2 PHY */ quark_usb_early_init (); +/* Initialize thermal sensor */ +quark_thermal_early_init (); +/* Turn on legacy segments (A/B/E/F) decode to system RAM */ quark_enable_legacy_seg ();
arch/x86/include/asm/arch-quark/quark.h +14 -0
@@ -42,9 +42,17 @@/* ACPI PBLK Base Address Register */ #define PBLK_BA 0x70 +/* Control Register */ +#define RMU_CTRL 0x71 +/* SPI DMA Base Address Register */ #define SPI_DMA_BA 0x7a +/* Thermal Sensor Register */ +#define TS_MODE 0xb0 +#define TS_TEMP 0xb1 +#define TS_TRIP 0xb2 +/* Port 0x05: Memory Manager Message Port Registers */ /* eSRAM Block Page Control */
@@ -65,6 +73,12 @@/* Port 0x31: SoC Unit Port Registers */ +/* Thermal Sensor Config */ +#define TS_CFG1 0x31 +#define TS_CFG2 0x32 +#define TS_CFG3 0x33 +#define TS_CFG4 0x34 +/* PCIe Controller Config */ #define PCIE_CFG 0x36#define PCIE_CTLR_PRI_RST 0x00010000
Signature · 1 line
1.8.2.1
PATCH v2 5/8 x86: quark: Initialize thermal sensor properly
Quoted 11 lines · Bin Meng
Thermal sensor on Quark SoC needs to be properly initialized per Quark firmware writer guide, otherwise when booting Linux kernel, it triggers system shutdown because of wrong temperature in the thermal sensor is detected by the kernel driver (see below):
[ 5.119819] thermal_sys: Critical temperature reached(206 C),shutting down [ 5.128997] Failed to start orderly shutdown: forcing the issue [ 5.135495] Emergency Sync completeSigned-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>
Quoted 7 lines
---
Changes in v2: None
arch/x86/cpu/quark/quark.c | 40 +++++++++++++++++++++++++++++++++ arch/x86/include/asm/arch-quark/quark.h | 14 ++++++++++++ 2 files changed, 54 insertions(+)
Applied to u-boot-x86, thanks!
PATCH v2 6/8 x86: galileo: Add PCIe root port IRQ routing
In reply to Bin MengNow we have enabled PCIe root port on Quark SoC, add its PIRQ routing information in the device tree as well.
---
Changes in v2: None
arch/x86/dts/galileo.dts | 12 ++++++++++++ 1 file changed, 12 insertions(+)
arch/x86/dts/galileo.dts +12 -0
@@ -92,6 +92,18 @@ PCI_BDF(0, 21, 0) INTA PIRQE PCI_BDF(0, 21, 1) INTB PIRQF PCI_BDF(0, 21, 2) INTC PIRQG + PCI_BDF(0, 23, 0) INTA PIRQA + PCI_BDF(0, 23, 1) INTB PIRQB + + /* PCIe root ports downstream interrupts */ + PCI_BDF(1, 0, 0) INTA PIRQA + PCI_BDF(1, 0, 0) INTB PIRQB + PCI_BDF(1, 0, 0) INTC PIRQC + PCI_BDF(1, 0, 0) INTD PIRQD + PCI_BDF(2, 0, 0) INTA PIRQB + PCI_BDF(2, 0, 0) INTB PIRQC + PCI_BDF(2, 0, 0) INTC PIRQD + PCI_BDF(2, 0, 0) INTD PIRQA >; }; };
Signature · 1 line
1.8.2.1
PATCH v2 6/8 x86: galileo: Add PCIe root port IRQ routing
Quoted 11 lines · Bin Meng
Now we have enabled PCIe root port on Quark SoC, add its PIRQ routing information in the device tree as well.
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>---
Changes in v2: None
arch/x86/dts/galileo.dts | 12 ++++++++++++ 1 file changed, 12 insertions(+)
Applied to u-boot-x86, thanks!
PATCH v2 7/8 x86: doc: Document some porting hints about Intel Quark
In reply to Bin MengDocument porting considerations for Intel Quark based board, including MRC parameters and PCIe initialization.
---
Changes in v2:
- Update per review comments from Simon
doc/README.x86 | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+)
doc/README.x86 +24 -0
@@ -733,6 +733,30 @@ Example output: PCI_BDF(0, 3, 0) INTA PIRQA ... +Porting Hints +------------- + +Quark-specific considerations: + +To port U-Boot to other boards based on the Intel Quark SoC, a few things need +to be taken care of. The first important part is the Memory Reference Code (MRC) +parameters. Quark MRC supports memory-down configuration only. All these MRC +parameters are supplied via the board device tree. To get started, first copy +the MRC section of arch/x86/dts/galileo.dts to your board's device tree, then +change these values by consulting board manuals or your hardware vendor. +Available MRC parameter values are listed in include/dt-bindings/mrc/quark.h. +The other tricky part is with PCIe. Quark SoC integrates two PCIe root ports, +but by default they are held in reset after power on. In U-Boot, PCIe +initialization is properly handled as per Quark's firmware writer guide. +In your board support codes, you need provide two routines to aid PCIe +initialization, which are board_assert_perst() and board_deassert_perst(). +The two routines need implement a board-specific mechanism to assert/deassert +PCIe PERST# pin. Care must be taken that in those routines that any APIs that +may trigger PCI enumeration process are strictly forbidden, as any access to +PCIe root port's configuration registers will cause system hang while it is +held in reset. For more details, check how they are implemented by the Intel +Galileo board support codes in board/intel/galileo/galileo.c. + TODO List --------- - Audio
Signature · 1 line
1.8.2.1
PATCH v2 7/8 x86: doc: Document some porting hints about Intel Quark
Quoted 6 lines · Bin Meng
Document porting considerations for Intel Quark based board, including MRC parameters and PCIe initialization.
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>
Quoted 7 lines
---
Changes in v2:
- Update per review comments from Simondoc/README.x86 | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+)
Applied to u-boot-x86, thanks!
PATCH v2 8/8 x86: doc: Add DMI to the TODO list
In reply to Bin MengDesktop Management Interface (DMI) is not supported by U-Boot now. Add it to the TODO list.
---
Changes in v2: None
doc/README.x86 | 2 ++ 1 file changed, 2 insertions(+)
doc/README.x86 +2 -0
@@ -762,6 +762,7 @@ TODO List - Audio - Chrome OS verified boot - SMI and ACPI support, to provide platform info and facilities to Linux +- Desktop Management Interface (DMI) [15] support References ----------
@@ -779,3 +780,4 @@ References [12] http://events.linuxfoundation.org/sites/events/files/slides/chromeos_and_diy_vboot_0.pdf [13] http://events.linuxfoundation.org/sites/events/files/slides/elce-2014.pdf [14] doc/device-tree-bindings/misc/intel,irq-router.txt +[15] http://en.wikipedia.org/wiki/Desktop_Management_Interface
Signature · 1 line
1.8.2.1
PATCH v2 8/8 x86: doc: Add DMI to the TODO list
Quoted 11 lines · Bin Meng
Desktop Management Interface (DMI) is not supported by U-Boot now. Add it to the TODO list.
Signed-off-by Bin Meng <[email protected]>Acked-by Simon Glass <[email protected]>---
Changes in v2: None
doc/README.x86 | 2 ++ 1 file changed, 2 insertions(+)
Applied to u-boot-x86, thanks!