summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Documentation/Intel/NativeRaminit/SandyBridge_registers.md1400
-rw-r--r--Documentation/Intel/NativeRaminit/Sandybridge.md124
-rw-r--r--Documentation/Intel/NativeRaminit/Sandybridge_freq.md132
-rw-r--r--Documentation/Intel/NativeRaminit/Sandybridge_read.md142
-rw-r--r--Documentation/Intel/NativeRaminit/timA_lane0-3_adjust_fine.pngbin0 -> 92363 bytes
-rw-r--r--Documentation/Intel/NativeRaminit/timA_lane0-3_discover_420x.pngbin0 -> 100726 bytes
-rw-r--r--Documentation/Intel/NativeRaminit/timA_lane0-3_rt53.pngbin0 -> 103600 bytes
-rw-r--r--Documentation/Intel/NativeRaminit/timA_lane0-3_rt54.pngbin0 -> 104571 bytes
-rw-r--r--Documentation/Intel/NativeRaminit/timA_lane0-3_rt55.pngbin0 -> 105582 bytes
9 files changed, 1798 insertions, 0 deletions
diff --git a/Documentation/Intel/NativeRaminit/SandyBridge_registers.md b/Documentation/Intel/NativeRaminit/SandyBridge_registers.md
new file mode 100644
index 0000000000..2dce11bcc8
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/SandyBridge_registers.md
@@ -0,0 +1,1400 @@
+Inoffical Documentation of Intel MCHBAR register space.
+
+The MCHBAR can be enabled by using register 0x48 of PCI(0:0:0) device.
+
+This documentation is incomplete and might be incorrect.
+Please handle with care !
+
+**MCHBAR + 0x4**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0x10**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x14**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x18**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x1c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x20**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x24**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x28**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x2c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x204**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0x210**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x214**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x218**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x21c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x220**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x224**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x228**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x22c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 1
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x404**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0x410**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x414**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x418**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x41c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x420**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x424**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x428**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x42c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 2
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x604**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0x610**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x614**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x618**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x61c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x620**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x624**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x628**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x62c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 3
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x804**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0x810**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x814**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x818**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x81c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0x820**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x824**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x828**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x82c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 4
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xa04**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0xa10**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xa14**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xa18**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xa1c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xa20**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xa24**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xa28**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xa2c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 5
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xc04**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0xc10**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xc14**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+| 0:5| Rank 0 CLK phase shift, low |
+| 6:11| Rank 1 CLK phase shift, low |
+| 12:17| Rank 2 CLK phase shift, low |
+| 18:23| Rank 3 CLK phase shift, low |
+| 24:27| Rankmap to enable clock crossover on |
+
+**MCHBAR + 0xc18**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+| 0 | Rank 0 CLK phase shift, high |
+| 1 | Rank 1 CLK phase shift, high |
+| 2 | Rank 2 CLK phase shift, high |
+| 3 | Rank 3 CLK phase shift, high |
+
+**MCHBAR + 0xc1c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xc20**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xc24**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xc28**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xc2c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 6
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xe04**
+
+*Width:* 64 Bit
+
+*Desc:* Lane training result Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:63| Training result, each bit corresponds to one of the 64 settings of IO delay |
+
+**MCHBAR + 0xe10**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 0 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xe14**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 1 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xe18**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 2 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xe1c**
+
+*Width:* 32 Bit
+
+*Desc:* Read delay settings, Rank 3 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| IO phase shift in 1/64th DCKs |
+| 6:11| DQS phase shift on rising edge in 1/64 DCKs |
+| 16:18| IO delay in DCKs |
+| 20:25| DQS phase shift on falling edge in 1/64 DCKs |
+
+**MCHBAR + 0xe20**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 0 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xe24**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 1 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xe28**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 2 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0xe2c**
+
+*Width:* 24 Bit
+
+*Desc:* Write delay settings, Rank 3 Register, Channel 0, lane 7
+
+|Bit| Description |
+|---|-------------|
+| 0:5| DQ IO phase shift in 1/64th DCKs |
+| 8:13| DQS IO phase shift in 1/64th DCKs |
+| 15:17| DQS IO phase shift in DCKs |
+| 20 | DQ IO phase shift in DCKs |
+
+**MCHBAR + 0x1810**
+
+*Width:* 32 Bit
+
+*Desc:* COMP1 Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 9:11| ODT |
+| 21:23| CLK drive up |
+| 27:29| CTRL drive up |
+
+**MCHBAR + 0x320c**
+
+*Width:* 32 Bit
+
+*Desc:* Command crossover enable Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:5| CLK phase, low |
+| 12 | CLK phase, high |
+| 14 | Enable hardware |
+| 17 | Enable on slot 1 |
+| 27 | Enable on slot 2 |
+
+**MCHBAR + 0x3714**
+
+*Width:* 32 Bit
+
+*Desc:* COMP2 Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| COMP2 value |
+
+**MCHBAR + 0x4000**
+
+*Width:* 24 Bit
+
+*Desc:* TC_DBP - Timming of DDR - Bin Parameter Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:3| tRCD |
+| 4:7| tRP |
+| 8:11| CAS |
+| 12:15| CWL |
+| 16:19| tRAS |
+
+**MCHBAR + 0x4004**
+
+*Width:* 32 Bit
+
+*Desc:* TC_RAP - Timing of DDR - Regular Access Parameters Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:3| tRRD |
+| 4:7| tRTP |
+| 8:11| CKE |
+| 12:15| WTR |
+| 16:19| tFAW |
+| 24:27| tWR |
+| 29 | Command 3-state options, 0: Drive when channel is active, tri-state when inactive, 1: Always drive command bus |
+| 30:31| CMD stretch, 00: 1N, 10: 2N, 11: 3N |
+
+**MCHBAR + 0x400c**
+
+*Width:* 24 Bit
+
+*Desc:* OTHP ODT control Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:3| tXPDLL ? |
+| 5:7| tXP ? |
+| 16:17| ODT stretch |
+| 18:19| ODT stretch |
+
+**MCHBAR + 0x401c**
+
+*Width:* 16 Bit
+
+*Desc:* OTHP Workaround (SandyBridge only) Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 12:13| ODT stretch |
+| 14:15| ODT stretch |
+
+**MCHBAR + 0x4024**
+
+*Width:* 32 Bit
+
+*Desc:* Rounttrip time Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:7| RTT Rank 0 DIMM 0 |
+| 8:15| RTT Rank 1 DIMM 0 |
+| 16:23| RTT Rank 0 DIMM 1 |
+| 24:31| RTT Rank 1 DIMM 1 |
+
+**MCHBAR + 0x4028**
+
+*Width:* 24 Bit
+
+*Desc:* SC_IO_LATENCY Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:3| IO latency Rank 0 DIMM 0 |
+| 4:7| IO latency Rank 1 DIMM 0 |
+| 8:11| IO latency Rank 0 DIMM 1 |
+| 12:15| IO latency Rank 1 DIMM 1 |
+| 16:21| Rount trip - I/O compensation |
+
+**MCHBAR + 0x4200**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, address Register, Channel 0, queue idx 0
+
+|Bit| Description |
+|---|-------------|
+| 0:15| Address |
+| 20:22| Bank address |
+| 24:25| Slotrank |
+
+**MCHBAR + 0x4204**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, address Register, Channel 0, queue idx 1
+
+|Bit| Description |
+|---|-------------|
+| 0:15| Address |
+| 20:22| Bank address |
+| 24:25| Slotrank |
+
+**MCHBAR + 0x4208**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, address Register, Channel 0, queue idx 2
+
+|Bit| Description |
+|---|-------------|
+| 0:15| Address |
+| 20:22| Bank address |
+| 24:25| Slotrank |
+
+**MCHBAR + 0x420c**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, address Register, Channel 0, queue idx 3
+
+|Bit| Description |
+|---|-------------|
+| 0:15| Address |
+| 20:22| Bank address |
+| 24:25| Slotrank |
+
+**MCHBAR + 0x4220**
+
+*Width:* 8 Bit
+
+*Desc:* RAM training queue, command IO Register, Channel 0, queue idx 0
+
+|Bit| Description |
+|---|-------------|
+| 0 | !RAS |
+| 1 | !CAS |
+| 2 | !WE |
+
+**MCHBAR + 0x4224**
+
+*Width:* 8 Bit
+
+*Desc:* RAM training queue, command IO Register, Channel 0, queue idx 1
+
+|Bit| Description |
+|---|-------------|
+| 0 | !RAS |
+| 1 | !CAS |
+| 2 | !WE |
+
+**MCHBAR + 0x4228**
+
+*Width:* 8 Bit
+
+*Desc:* RAM training queue, command IO Register, Channel 0, queue idx 2
+
+|Bit| Description |
+|---|-------------|
+| 0 | !RAS |
+| 1 | !CAS |
+| 2 | !WE |
+
+**MCHBAR + 0x422c**
+
+*Width:* 8 Bit
+
+*Desc:* RAM training queue, command IO Register, Channel 0, queue idx 3
+
+|Bit| Description |
+|---|-------------|
+| 0 | !RAS |
+| 1 | !CAS |
+| 2 | !WE |
+
+**MCHBAR + 0x4230**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, cooldown Register, Channel 0, queue idx 0
+
+|Bit| Description |
+|---|-------------|
+| 16:31| Clock cycles to wait after command |
+
+**MCHBAR + 0x4234**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, cooldown Register, Channel 0, queue idx 1
+
+|Bit| Description |
+|---|-------------|
+| 16:31| Clock cycles to wait after command |
+
+**MCHBAR + 0x4238**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, cooldown Register, Channel 0, queue idx 2
+
+|Bit| Description |
+|---|-------------|
+| 16:31| Clock cycles to wait after command |
+
+**MCHBAR + 0x423c**
+
+*Width:* 32 Bit
+
+*Desc:* RAM training queue, cooldown Register, Channel 0, queue idx 3
+
+|Bit| Description |
+|---|-------------|
+| 16:31| Clock cycles to wait after command |
+
+**MCHBAR + 0x4284**
+
+*Width:* 24 Bit
+
+*Desc:* RAM training queue, cooldown Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0 | Start executing DRAM command queue |
+| 16:19| (Number of queued commands - 1) * 4 |
+
+**MCHBAR + 0x4298**
+
+*Width:* 40 Bit
+
+*Desc:* TC - Refresh parameters Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:15| tREFI, average period between refresh in DCLK cycles |
+| 16:24| tRFC, Time of refresh, from beginning of refresh until next ACT or refresh is allowed in DCLK cycles |
+| 25:32| tREFIx9, Maximum time allowed between refreshes to a rank. Should be programmed to 8.9 * tREFI / 1024 |
+
+**MCHBAR + 0x42a4**
+
+*Width:* 32 Bit
+
+*Desc:* SRFTP Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:11| tXSDLL |
+| 12:15| tXS_offset |
+| 16:25| tZQOPER |
+| 28:31| tMOD |
+
+**MCHBAR + 0x4c20**
+
+*Width:* 32 Bit
+
+*Desc:* Scheduler parameters Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| scheduler parameters |
+
+**MCHBAR + 0x4cb0**
+
+*Width:* 16 Bit
+
+*Desc:* PM - Power-down configuration, Broadcast Register
+
+|Bit| Description |
+|---|-------------|
+| 0:7| PDWN_idle_counter, This defines the rank indle period in DCLK cycles that causes power-down entrance. The minimum value should be greater then or equal to the worst roundtrip time plus burst length. |
+| 8:10| PDWN_mode, selects the mode of power-down: 0x0: No power down, 0x1: APD, 0x2: PPD, 0x3: APD+PPD, 0x4: Reserved, 0x5: Reserved, 0x6: PPD-DLLoff, 0x7: APD+PPD+DLLof |
+
+**MCHBAR + 0x4e80**
+
+*Width:* 32 Bit
+
+*Desc:* Power mode preset Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| Power mode preset |
+
+**MCHBAR + 0x4e94**
+
+*Width:* 16 Bit
+
+*Desc:* TC - Refresh parameters Register
+
+|Bit| Description |
+|---|-------------|
+| 0:7| OREF_RI, Rank idle period that defines an oppertunity for refresh |
+| 8:11| Refresh_HP_WM, tREFI count level that turns the refresh priority to high |
+| 12:15| Refresh_panic_WM, tREFI count level in which the refresh priority is panic |
+
+**MCHBAR + 0x4e98**
+
+*Width:* 40 Bit
+
+*Desc:* TC - Refresh parameters Register
+
+|Bit| Description |
+|---|-------------|
+| 0:15| tREFI, average period between refresh in DCLK cycles |
+| 16:24| tRFC, Time of refresh, from beginning of refresh until next ACT or refresh is allowed in DCLK cycles |
+| 25:32| tREFIx9, Maximum time allowed between refreshes to a rank. Should be programmed to 8.9 * tREFI / 1024 |
+
+**MCHBAR + 0x5000**
+
+*Width:* 8 Bit
+
+*Desc:* Global channel size control Register
+
+|Bit| Description |
+|---|-------------|
+| 0:1| CH_A, defines the largest channel. 00: Channel 0, 01: Channel 1, 10: Channel 2 |
+| 2:3| CH_B, defines the mid-size channel. 00: Channel 0, 01: Channel 1, 10: Channel 2 |
+| 2:3| CH_C, defines the smallest channel. 00: Channel 0, 01: Channel 1, 10: Channel 2, CH_C is 10 if only 2 channels are supported |
+
+**MCHBAR + 0x5004**
+
+*Width:* 32 Bit
+
+*Desc:* Address Decode Register, Channel 0
+
+|Bit| Description |
+|---|-------------|
+| 0:7| DIMMA size in 256 MB multiples |
+| 16 | DIMM A select (DAS) Slot to DIMM mapping, 0: DIMMA, DIMMB, 1: DIMMB, DIMMA |
+| 17 | DIMM A number of ranks |
+| 19 | DIMM A DRAM width x8 / x16 |
+| 8:15| DIMM B size in 256 MB multiples |
+| 18 | DIMM B number of ranks |
+| 20 | DIMM B DRAM width in 8x / x16 |
+| 21 | Rank interleave enable |
+| 22 | Enhanced interleave enable |
+| 26 | High order Rank interleave enable |
+| 27:29| High Order Rank interleave Address. Selects on of address bits 20-27 to use for high rank interleave |
+| 24:25| ECC, 00: No ECC active, 01: ECC is active on IO, 11: ECC is active on both IO and ECC logic |
+
+**MCHBAR + 0x5030**
+
+*Width:* 8 Bit
+
+*Desc:* Global DDR3 control Register
+
+|Bit| Description |
+|---|-------------|
+| 1 | DDR reset |
+| 2 | DCLK enable |
+| 5 | IO reset |
+
+**MCHBAR + 0x5034**
+
+*Width:* 32 Bit
+
+*Desc:* Version Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| MRC version |
+
+**MCHBAR + 0x5060**
+
+*Width:* 16 Bit
+
+*Desc:* PM - Self refresh config Register
+
+|Bit| Description |
+|---|-------------|
+| 0:15| Idle_timer, The value is used when the SREF_enable field is set and defines the # of cycles that there should not be any transaction in order to enter self-refresh. |
+| 16 | SR_Enable, enable self-refresh mechanism. Clear SREF_en and SREF_exit first. |
+
+**MCHBAR + 0x5084**
+
+*Width:* 24 Bit
+
+*Desc:* RCOMP status Register
+
+|Bit| Description |
+|---|-------------|
+| 16 | Busy |
+
+**MCHBAR + 0x5090**
+
+*Width:* 32 Bit
+
+*Desc:* ECC - Address compare for ECC error injection Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| Inject error when ECC_Inj_Addr_Compare[31:0] = ADDR[37:6] |
+
+**MCHBAR + 0x5094**
+
+*Width:* 32 Bit
+
+*Desc:* ECC - Address mask for ECC error injection Register
+
+|Bit| Description |
+|---|-------------|
+| 0:31| Inject error when ECC_inj_Addr_Compare[31:0] = ADDR[37:6] && ECC_Inj_Addr_Mask[31:0] |
+
+**MCHBAR + 0x5e00**
+
+*Width:* 32 Bit
+
+*Desc:* MC_BIOS_REQ Register
+
+|Bit| Description |
+|---|-------------|
+| 0:7| Selected multiplier: 100Mhz [7,12], 133Mhz [3,19] |
+| 8 | 1: 100Mhz reference clock, 0: 133Mhz reference clock (IvyBridge only) |
+| 31 | PLL busy |
+
+**MCHBAR + 0x5e04**
+
+*Width:* 8 Bit
+
+*Desc:* MC_BIOS_DATA Register
+
+|Bit| Description |
+|---|-------------|
+| 0:7| Active multiplier: 100Mhz [7,12], 133Mhz [3,19] |
+
+**MCHBAR + 0x5f08**
+
+*Width:* 16 Bit
+
+*Desc:* RCOMP control Register
+
+|Bit| Description |
+|---|-------------|
+| 8 | Force RCOMP |
diff --git a/Documentation/Intel/NativeRaminit/Sandybridge.md b/Documentation/Intel/NativeRaminit/Sandybridge.md
new file mode 100644
index 0000000000..b27ce9330c
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/Sandybridge.md
@@ -0,0 +1,124 @@
+# Sandy Bridge Raminit
+
+## Introduction
+
+This documentation is intended to document the closed source memory controller
+hardware for Intel 2nd Gen (Sandy Bride) and 3rd Gen (Ivy Bridge) core-i CPUs.
+
+The memory initialization code has to take care of lots of duties:
+1. Selection of operating frequency
+* Selection of common timings
+* Applying frequency specific compensation values
+* Read training of all populated channels
+* Write training of all populated channels
+* Adjusting delay networks of address and command signals
+* DQS training of all populated channels
+* Programming memory map
+* Report DRAM configuration
+* Error handling
+
+## Definitions
+| Symbol | Description | Units | Valid region |
+|---------|-------------------------------------------------------------------|------------|--------------|
+| SCK | DRAM system clock cycle time | s | - |
+| tCK | DRAM system clock cycle time | 1/256th ns | - |
+| DCK | Data clock cycle time: The time between two SCK clock edges | s | - |
+| timA | IO phase: The phase delay of the IO signals | 1/64th DCK | [0-512) |
+| SPD | Manufacturer set memory timings located on an EEPROM on every DIMM| bytes | - |
+| REFCK | Reference clock, either 100 or 133 | Mhz | 100, 133 |
+| MULT | DRAM PLL multiplier | - | [3-12] |
+| XMP | Extreme Memory Profiles | - | - |
+
+## (Inoffical) register documentation
+[Sandy Bride - Register documentation](SandyBridge_registers.md)
+
+## Frequency selection
+[Sandy Bride - Frequency selection](SandyBridge_freq.md)
+
+## Read training
+[Sandy Bride - Read training](SandyBridge_read.md)
+
+### SMBIOS type 17
+The SMBIOS specification allows to report the memory configuration in use.
+On GNU/Linux you can run `# dmidecode -t 17` to view it.
+Example output of dmidecode:
+
+```
+Handle 0x0045, DMI type 17, 34 bytes
+ Memory Device
+ Array Handle: 0x0042
+ Error Information Handle: Not Provided
+ Total Width: 64 bits
+ Data Width: 64 bits
+ Size: 8192 MB
+ Form Factor: DIMM
+ Set: None
+ Locator: ChannelB-DIMM0
+ Bank Locator: BANK 2
+ Type: DDR3
+ Type Detail: Synchronous
+ Speed: 933 MHz
+ Manufacturer: 0420
+ Serial Number: 00000000
+ Asset Tag: 9876543210
+ Part Number: F3-1866C9-8GSR
+ Rank: 2
+ Configured Clock Speed: 933 MHz
+```
+The memory frequency printed by dmidecode is the active memory frequency. It's
+**not** the double datarate and it's **not** the one encoded maximum frequency
+in each DIMM's SPD.
+
+> **Note:** This feature is available since coreboot 4.4
+
+### MRC cache
+The name *MRC cache* might be missleading as in case of *Native ram init*
+there's no MRC, but for historical reasons it's still named *MRC cache*.
+The MRC cache is part of flash memory that is writeable by coreboot.
+At the end of the boot process coreboot will write the RAM training results to
+flash for future use, as RAM training is time intensive. Storing the results
+allows to boot faster on normal boot and allows to support S3 resume,
+as the RAM training results can't be stored in RAM (you need to configure
+the memory controller first to access RAM).
+
+The MRC cache needs to be invalidated in case the memory configuration has
+been changed. To detect a changed memory configuration the CRC16 of each DIMM
+is stored to MRC cache.
+> **Note:** This feature is available since coreboot 4.4
+
+### Error handling
+As of writing the only supported error handling is to disable the failing
+channel and restart the memory training sequence. It's very likely to succeed,
+as memory channels operate independent of each other.
+In case no DIMM could be initilized coreboot will halt. The screen will stay
+black until you power of your device. On some platforms there's additional
+feedback to indicate such an event.
+
+If you find `dmidecode -t 17` to report only half of the memory installed,
+it's likely that a fatal memory init failure had happened.
+It is assumed, that a working board with less physical memory, is much better,
+than a board that doesn't boot at all.
+
+> **Note:** This feature is available since coreboot 4.5
+
+Try to swap memory modules and or try to use a different vendor. If nothing
+helps you could have a look at capter [Debuggin] or report a ticket
+at [ticket.coreboot.org]. Please provide a full RAM init log,
+that has been captured using EHCI debug.
+
+To enable extensive RAM training logging enable the Kconfig option
+`DEBUG_RAM_SETUP`
+#### Lenovo Thinkpads
+Lenovo Thinkpads do have an additional feature to indicate that RAM init has
+failed and coreboot has died (it calls die() on fatal error, thus the name).
+The Kconfig options
+`H8_BEEP_ON_DEATH`
+`H8_FLASH_LEDS_ON_DEATH`
+enable blinking LEDs and enable a beep to indicate death.
+
+> **Note:** This feature is available since coreboot 4.7
+
+## Debugging
+It's recommended to use an external debugger, such as serial or EHCI debug
+dongle. In case of failing memory init the board might not boot at all,
+preventing you from using CBMEM.
diff --git a/Documentation/Intel/NativeRaminit/Sandybridge_freq.md b/Documentation/Intel/NativeRaminit/Sandybridge_freq.md
new file mode 100644
index 0000000000..af880866cf
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/Sandybridge_freq.md
@@ -0,0 +1,132 @@
+# Frequency selection
+
+## Introduction
+This chapter explains the frequency selection done on Sandybride and Ivybridge.
+
+## Definitions
+| Symbol | Description | Units | Valid region |
+|---------|-------------------------------------------------------------------|------------|--------------|
+| SCK | DRAM system clock cycle time | s | - |
+| tCK | DRAM system clock cycle time | 1/256th ns | - |
+| DCK | Data clock cycle time: The time between two SCK clock edges | s | - |
+| SPD | Manufacturer set memory timings located on an EEPROM on every DIMM| bytes | - |
+| REFCK | Reference clock, either 100 or 133 | Mhz | 100, 133 |
+| MULT | DRAM PLL multiplier | - | [3-12] |
+| XMP | Extreme Memory Profiles | - | - |
+
+## SPD
+The [SPD](https://de.wikipedia.org/wiki/Serial_Presence_Detect "Serial Presence Detect")
+located on every DIMM is factory program with various timings. One of them
+specifies the maximum clock frequency the DIMM should be used with. The
+operating frequency is stores as fixed point value (tCK), rounded to the next
+smallest supported operating frequency. Some
+[SPD](https://de.wikipedia.org/wiki/Serial_Presence_Detect "Serial Presence Detect")
+contains additional and optional
+[XMP](https://de.wikipedia.org/wiki/Extreme_Memory_Profile "Extreme Memory Profile")
+data, that stores so called "performance" modes, that advertises higher clock
+frequencies.
+
+## XMP profiles
+At time of writing coreboot's raminit is able to parse XMP profile 1 and 2.
+Only **XMP profile 1** is being used in case it advertises:
+* 1.5V operating voltage
+* The channel's installed DIMM count doesn't exceed the XMP coded limit
+
+In case the XMP profile doesn't fullfill those limits, the regular SPD will be
+used.
+> **Note:** XMP Profiles are supported since coreboot 4.4.
+
+It is possible to ignore the max DIMM count limit set by XMP profiles.
+By activating Kconfig option `NATIVE_RAMINIT_IGNORE_XMP_MAX_DIMMS` it is
+possible to install two DIMMs per channel, even if XMP tells you not to do.
+
+> **Note:** Ignoring XMP Profiles limit is supported since coreboot 4.7.
+
+## Soft fuses
+Every board manufacturer does program "soft" fuses to indicate the maximum
+DRAM frequency supported. However, those fuses don't set a limit in hardware
+and thus are called "soft" fuses, as it is possible to ignore them.
+
+> **Note:** Ignoring the fuses might cause system instability !
+
+On Sandy Bride *CAPID0_A* is being read, and on Ivybridge *CAPID0_B* is being
+read. coreboot reads those registers and honors the limit in case the Kconfig
+option `CONFIG_NATIVE_RAMINIT_IGNORE_MAX_MEM_FUSES` wasn't set.
+Power users that want to let their RAM run at DRAM's "stock" frequency need to
+enable the Kconfig symbol.
+
+It is possible to override the soft fuses limit by using a board-specific
+[devicetree](#devicetree) setting.
+
+> **Note:** Ignoring max mem freq. fuses is supported since coreboot 4.7.
+
+## <a name="hard_fuses"></a> Hard fuses
+"Hard" fuses are programmed by Intel and limit the maximum frequency that can
+be used on a given CPU/board/chipset. At time of writing there's no register
+to read this limit, before trying to set a given DRAM frequency. The memory PLL
+won't lock, indicating that the chosen memory multiplier isn't available. In
+this case coreboot tries the next smaller memory multiplier until the PLL will
+lock.
+
+## <a name="devicetree"></a> Devicetree
+The devicetree register ```max_mem_clock_mhz``` overrides the "soft" fuses set
+by the board manufacturer.
+
+By using this register it's possible to force a minimum operating frequency.
+
+## Reference clock
+While Sandybride supports 133 MHz reference clock (REFCK), Ivy Bridge also
+supports 100 MHz reference clock. The reference clock is multiplied by the DRAM
+multiplier to select the DRAM frequency (SCK) by the following formula:
+
+ REFCK * MULT = 1 / DCK
+
+> **Note:** Since coreboot 4.6 Ivy Bridge supports 100MHz REFCK.
+
+## Sandy Bride's supported frequencies
+| SCK [Mhz] | DDR [Mhz] | Mutiplier (MULT) | Reference clock (REFCK) | Comment |
+|------------|-----------|------------------|-------------------------|---------------|
+| 400 | DDR3-800 | 3 | 133 MHz | |
+| 533 | DDR3-1066 | 4 | 133 MHz | |
+| 666 | DDR3-1333 | 5 | 133 MHz | |
+| 800 | DDR3-1600 | 6 | 133 MHz | |
+| 933 | DDR3-1866 | 7 | 133 MHz | |
+| 1066 | DDR3-2166 | 8 | 133 MHz | ||
+
+## Ivybridge's supported frequencies
+| SCK [Mhz] | DDR [Mhz] | Mutiplier (MULT) | Reference clock (REFCK) | Comment |
+|------------|-----------|------------------|-------------------------|---------------|
+| 400 | DDR3-800 | 3 | 133 MHz | |
+| 533 | DDR3-1066 | 4 | 133 MHz | |
+| 666 | DDR3-1333 | 5 | 133 MHz | |
+| 800 | DDR3-1600 | 6 | 133 MHz | |
+| 933 | DDR3-1866 | 7 | 133 MHz | |
+| 1066 | DDR3-2166 | 8 | 133 MHz | |
+| 700 | DDR3-1400 | 7 | 100 MHz | '1 |
+| 800 | DDR3-1600 | 8 | 100 MHz | '1 |
+| 900 | DDR3-1800 | 9 | 100 MHz | '1 |
+| 1000 | DDR3-2000 | 10 | 100 MHz | '1 |
+| 1100 | DDR3-2200 | 11 | 100 MHz | '1 |
+| 1200 | DDR3-2400 | 12 | 100 MHz | '1 ||
+
+> '1: since coreboot 4.6
+
+## Multiplier selection
+coreboot select the maximum frequency to operate at by the following formula:
+```
+if devicetree's max_mem_clock_mhz > 0:
+ freq_max := max_mem_clock_mhz
+else:
+ freq_max := soft_fuse_max_mhz
+
+for i in SPDs:
+ freq_max := MIN(freq_max, ddr_spd_max_mhz[i])```
+
+As you can see, by using DIMMs with different maximum DRAM frequencies, the
+slowest DIMMs' frequency will be selected, to prevent over-clocking it.
+
+The selected frequency gives the PLL multiplier to operate at. In case the PLL
+locks (see Take me to [Hard fuses](#hard_fuses)) the frequency will be used for
+all DIMMs. At this point it's not possible to change the multiplier again,
+until the system has been powered off. In case the PLL doesn't lock, the next
+smaller multiplier will be used until a working multiplier will be found.
diff --git a/Documentation/Intel/NativeRaminit/Sandybridge_read.md b/Documentation/Intel/NativeRaminit/Sandybridge_read.md
new file mode 100644
index 0000000000..d43f9316e4
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/Sandybridge_read.md
@@ -0,0 +1,142 @@
+# Read training
+
+## Introduction
+
+This chapter explains the read training sequence done on Sandy Bride and
+Ivy Bridge memory initialization.
+
+Read training is done to compensate the skew between DQS and SCK and to find
+the smallest supported roundtrip delay.
+
+Every board does have a vendor depended routing topology, and can be equip
+with any combination of DDR3 memory modules, that introduces different
+skew between the memory lanes. With DDR3 a "Fly-By" routing topology
+has been introduced, that makes the biggest part of DQS-SCK skew.
+The memory code measures the actual skew and actives delay gates,
+that will "compensate" the skew.
+
+When in read training the DRAM and the controller are placed in a special mode.
+On every read instruction the DRAM outputs a predefined pattern and the memory
+controller samples the DQS after a given delay. As the pattern is known, the
+actual delay of every lane can be measured.
+
+The values programmed in read training effect DRAM-to-MC transfers only !
+
+## Definitions
+| Symbol | Description | Units | Valid region |
+|---------|-------------------------------------------------------------------|------------|--------------|
+| SCK | DRAM system clock cycle time | s | - |
+| tCK | DRAM system clock cycle time | 1/256th ns | - |
+| DCK | Data clock cycle time: The time between two SCK clock edges | s | - |
+| timA | IO phase: The phase delay of the IO signals | 1/64th DCK | [0-512) |
+| SPD | Manufacturer set memory timings located on an EEPROM on every DIMM| bytes | - |
+| REFCK | Reference clock, either 100 or 133 | Mhz | 100, 133 |
+| MULT | DRAM PLL multiplier | - | [3-12] |
+| XMP | Extreme Memory Profiles | - | - |
+| DQS | Data Strobe signal used to sample all lane's DQ signals | - | - |
+
+## Hardware
+The hardware does have delay logic blocks that can delay the DQ / DQS of a
+lane/rank by one or multiple clock cylces and it does have delay logic blocks
+that can delay the signal by a multiple of 1/64th DCK per lane.
+
+All delay values can be controlled via software by writing registers in the
+MCHBAR.
+
+## IO phase
+
+The IO phase can be adjusted in [0-512) * 1/64th DCK. Incrementing it by 64 is
+the same as Incrementing IO delay by 1.
+
+## IO delay
+Delays the DQ / DQS signal by one or multiple clock cycles.
+
+### Roundtrip time
+The roundtrip time is the time the memory controller waits for data arraving
+after a read has been issued. Due to clock-domain crossings, multiple
+delay instances and phase interpolators, the signal runtime to DRAM and back
+to memory controller defaults to 55 DCKs. The real roundtrip time has to be
+measured.
+
+After a read command has been issued, a counter counts down until zero has been
+reached and activates the input buffers.
+
+The following pictures shows the relationship between those three values.
+The picture was generated from 16 IO delay values times 64 timA values.
+The highest IO delay was set on the right-hand side, while the last block
+on the left-hand side has zero IO delay.
+
+** roundtrip 55 DCKs **
+![alt text][timA_lane0-3_rt55]
+
+[timA_lane0-3_rt55]: timA_lane0-3_rt55.png "timA for lane0 - lane3, roundtrip 55"
+
+** roundtrip 54 DCKs **
+![alt text][timA_lane0-3_rt54]
+
+[timA_lane0-3_rt54]: timA_lane0-3_rt54.png "timA for lane0 - lane3, roundtrip 54"
+
+
+** roundtrip 53 DCKs **
+![alt text][timA_lane0-3_rt53]
+
+[timA_lane0-3_rt53]: timA_lane0-3_rt53.png "timA for lane0 - lane3, roundtrip 53"
+
+As you can see the signal has some jitter as every sample was taken in a
+different loop iteration. The result register only contains a single bit per
+lane.
+
+## Algorithm
+### Steps
+The algorithm finds the roundtrip time, IO delay and IO phase. The IO phase
+will be adjusted to match the falling edge of the preamble of each lane.
+The roundtrip time is adjusted to an minimal value, that still includes the
+preamble.
+
+### Synchronize to data phase
+
+The first measurement done in read-leveling samples all DQS values for one
+phase [0-64) * 1/64th DCK. It then searches for the middle of the low data
+symbol and adjusts timA to the found phase and thus the following measurements
+will be aligned to the low data symbol.
+The code assumes that the initial roundtrip time causes the measurement to be
+in the alternating pattern data phase.
+
+### Finding the preamble
+After adjusting the IO phase to the middle of one data symbol the preamble will
+be located. Unlike the data phase, which is an alternating pattern (010101...),
+the preamble consists of two high data cycles.
+
+The code decrements the IO delay/RTT and samples the DQS signal with timA
+untouched. As it has been positioned in the middle of the data symbol, it'll
+read as either "low" or "high".
+
+If it's "low" we are still in the data phase.
+If it's "high" we have found the preamble.
+
+The roundtrip time and IO delay will be adjusted until all lanes are aligned.
+The resulting IO delay is visible in the picture below.
+
+** roundtrip time: 49 DCKs, IO delay (at blue point): 6 DCKs **
+![alt text][timA_lane0-3_discover_420x]
+
+[timA_lane0-3_discover_420x]: timA_lane0-3_discover_420x.png "timA for lane0 - lane3, finding minimum roundtrip time"
+
+** Note: The sampled data has been shifted by timA. The preamble is now
+in phase. **
+
+## Fine adjustment
+
+As timA still points the middle of the data symbol an offset of 32 is added.
+It now points the falling edge of the preamble.
+The fine adjustment is to reduce errors introduced by jitter. The phase is
+adjusted from `timA - 25` to `timA + 25` and the DQS signal is sampled 100
+times. The fine adjustment finds the middle of each rising edge (it's actual
+the falling edge of the preamble) to get the final IO phase. You can see the
+result in the picture below.
+
+![alt text][timA_lane0-3_adjust_fine]
+
+[timA_lane0-3_adjust_fine]: timA_lane0-3_adjust_fine.png "timA for lane0 - lane3, fine adjustment"
+
+Lanes 0 - 2 will be adjusted by a phase of -10, while lane 3 is already correct.
diff --git a/Documentation/Intel/NativeRaminit/timA_lane0-3_adjust_fine.png b/Documentation/Intel/NativeRaminit/timA_lane0-3_adjust_fine.png
new file mode 100644
index 0000000000..d72e4c6d84
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/timA_lane0-3_adjust_fine.png
Binary files differ
diff --git a/Documentation/Intel/NativeRaminit/timA_lane0-3_discover_420x.png b/Documentation/Intel/NativeRaminit/timA_lane0-3_discover_420x.png
new file mode 100644
index 0000000000..6f33217d1e
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/timA_lane0-3_discover_420x.png
Binary files differ
diff --git a/Documentation/Intel/NativeRaminit/timA_lane0-3_rt53.png b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt53.png
new file mode 100644
index 0000000000..191e792845
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt53.png
Binary files differ
diff --git a/Documentation/Intel/NativeRaminit/timA_lane0-3_rt54.png b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt54.png
new file mode 100644
index 0000000000..fa7f6089d0
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt54.png
Binary files differ
diff --git a/Documentation/Intel/NativeRaminit/timA_lane0-3_rt55.png b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt55.png
new file mode 100644
index 0000000000..7f2fa397dd
--- /dev/null
+++ b/Documentation/Intel/NativeRaminit/timA_lane0-3_rt55.png
Binary files differ