<p>Patrick Rudolph has uploaded this change for <strong>review</strong>.</p><p><a href="https://review.coreboot.org/c/coreboot/+/30056">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Documentation: Add arch x86<br><br>Describe state and assuptions made about x86_64 support.<br><br>Change-Id: I308a09b0eac269afd30df95ed3ea195238a6cfbe<br>Signed-off-by: Patrick Rudolph <siro@das-labor.org><br>---<br>M Documentation/arch/index.md<br>A Documentation/arch/x86/index.md<br>2 files changed, 33 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://review.coreboot.org:29418/coreboot refs/changes/56/30056/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/Documentation/arch/index.md b/Documentation/arch/index.md</span><br><span>index c3b080e..a0f1050 100644</span><br><span>--- a/Documentation/arch/index.md</span><br><span>+++ b/Documentation/arch/index.md</span><br><span>@@ -6,3 +6,6 @@</span><br><span> ## RISC-V</span><br><span> </span><br><span> - [RISC-V documentation](riscv/index.md)</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+## x86</span><br><span style="color: hsl(120, 100%, 40%);">+- [x86 documentation](x86/index.md)</span><br><span>diff --git a/Documentation/arch/x86/index.md b/Documentation/arch/x86/index.md</span><br><span>new file mode 100644</span><br><span>index 0000000..b77a34b</span><br><span>--- /dev/null</span><br><span>+++ b/Documentation/arch/x86/index.md</span><br><span>@@ -0,0 +1,30 @@</span><br><span style="color: hsl(120, 100%, 40%);">+# x86 architecture documentation</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This section contains documentation about coreboot on x86 architecture.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+## State of x86_64 support</span><br><span style="color: hsl(120, 100%, 40%);">+At the moment there's no single board that supports x86_64 or to be exact</span><br><span style="color: hsl(120, 100%, 40%);">+`ARCH_RAMSTAGE_X86_64` and `ARCH_ROMSTAGE_X86_64`.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+In order to add support for x86_64 the following assumptions are made:</span><br><span style="color: hsl(120, 100%, 40%);">+* All memory returned by malloc must be below 4GiB in physical memory</span><br><span style="color: hsl(120, 100%, 40%);">+* All code that is to be run must be below 4GiB in physical memory</span><br><span style="color: hsl(120, 100%, 40%);">+* The high dword of pointers is always zero</span><br><span style="color: hsl(120, 100%, 40%);">+* The reference implementation is qemu</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+## Steps to add basic support for x86_64</span><br><span style="color: hsl(120, 100%, 40%);">+* Add x86_64 toolchain support - *DONE*</span><br><span style="color: hsl(120, 100%, 40%);">+* Fix compilation errors - *DONE*</span><br><span style="color: hsl(120, 100%, 40%);">+* Fix linker errors - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+* Add x86_64 rmodule support - *ONGERRIT*</span><br><span style="color: hsl(120, 100%, 40%);">+* Add x86_64 exception handlers - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+* Setup page tables for long mode - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+* Add assembly code for long mode - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+* Add assembly code to return to protected mode - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+* Implement reference code for mainboard `emulation/qemu-q35` - *TODO*</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+## Porting other boards</span><br><span style="color: hsl(120, 100%, 40%);">+* Fix compilation errors</span><br><span style="color: hsl(120, 100%, 40%);">+* Test how well CAR works with x86_64 and paging</span><br><span style="color: hsl(120, 100%, 40%);">+* Improve mode switches</span><br><span style="color: hsl(120, 100%, 40%);">+* Test libgfxinit / VGA Option ROMs / FSP</span><br><span></span><br></pre><p>To view, visit <a href="https://review.coreboot.org/c/coreboot/+/30056">change 30056</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://review.coreboot.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://review.coreboot.org/c/coreboot/+/30056"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: coreboot </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I308a09b0eac269afd30df95ed3ea195238a6cfbe </div>
<div style="display:none"> Gerrit-Change-Number: 30056 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Patrick Rudolph <siro@das-labor.org> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>