Change in ...coreboot[master]: 2nd version, reworked based on Asus P8H61-M LX as a template and the ...

[Balázs Vinarz (Code Review)]

Balázs Vinarz has uploaded this change for review. ( https://review.coreboot.org/c/coreboot/+/30896

Change subject: 2nd version, reworked based on Asus P8H61-M LX as a template and the old wiki
......................................................................

2nd version, reworked based on Asus P8H61-M LX as a template and the old wiki

Signed-off-by: Balazs Vinarz 
Change-Id: I35fdc87fe167c6c6ca605860aa4914d39407546f
---
A Documentation/mainboard/asus/f2a85-m.md
1 file changed, 271 insertions(+), 0 deletions(-)

git pull ssh://review.coreboot.org:29418/coreboot refs/changes/96/30896/1

diff --git a/Documentation/mainboard/asus/f2a85-m.md b/Documentation/mainboard/asus/f2a85-m.md
new file mode 100644
index 0000000..c4ee0cf
--- /dev/null
+++ b/Documentation/mainboard/asus/f2a85-m.md
@@ -0,0 +1,271 @@
+Disclaimer: This board is not widely sold any longer. However, refer to F2A85 series status for newer models. ASUS F2A85 PRO should be work in progress (WIP).
+Contents
+
+    1 Status
+        1.1 Supported processing units
+            1.1.1 CPUs
+            1.1.2 APUs
+        1.2 Notes
+        1.3 TODOs
+    2 UEFI builds that allow flash chip access
+    3 Hardware info
+        3.1 DDR voltage controller
+        3.2 The ASUS digi VRM
+        3.3 Memory
+    4 See also
+        4.1 F2A85 series status
+    5 References
+
+Status
+Device/functionality 	Status 	Comments
+CPU
+CPU works 	OK 	the board will start with an AMD A8-5500
+L1 cache enabled 	OK 	
+L2 cache enabled 	OK 	
+L3 cache enabled 	N/A 	
+Multiple CPU support 	OK 	
+Multi-core support 	OK 	
+Hardware virtualization 	Untested 	
+RAM
+EDO 	N/A 	
+SDRAM 	N/A 	
+SO-DIMM 	N/A 	
+DDR 	N/A 	
+DDR2 	N/A 	
+DDR3 	OK 	Please select right voltage in menuconfig! Default is 1.5V but some DIMMs need more or less!
+Dual channel support 	OK 	
+ECC support 	N/A 	
+On-board Hardware
+On-board IDE 3.5" 	N/A 	
+On-board IDE 2.5" 	N/A 	
+On-board SATA 	OK 	Tested all ports of sixpack.
+On-board SCSI 	N/A 	
+On-board USB 	OK 	Issues with XHCI exist with Asus' BIOS as well
+On-board VGA 	OK 	Use dd to extract the legacy BIOS, HDMI untested
+On-board Ethernet 	OK 	
+On-board Audio 	OK 	tested with headphones in line-out (lime colored)
+On-board Modem 	N/A 	
+On-board FireWire 	N/A 	
+On-board Smartcard reader 	N/A 	
+On-board CompactFlash 	N/A 	
+On-board PCMCIA 	N/A 	
+On-board Wifi 	N/A 	
+On-board Bluetooth 	N/A 	
+On-board SD card reader 	N/A 	
+Add-on slots/cards
+ISA add-on cards 	N/A 	
+Audio/Modem-Riser (AMR/CNR) cards 	N/A 	
+PCI add-on cards 	OK 	
+Mini-PCI add-on cards 	N/A 	
+Mini-PCI-Express add-on cards 	Unknown 	
+PCI-X add-on cards 	N/A 	
+AGP graphics cards 	N/A 	
+PCI Express x1 add-on cards 	OK 	
+PCI Express x2 add-on cards 	N/A 	
+PCI Express x4 add-on cards 	OK 	
+PCI Express x8 add-on cards 	N/A 	
+PCI Express x16 add-on cards 	OK 	
+PCI Express x32 add-on cards 	N/A 	
+HTX add-on cards 	N/A 	
+Legacy / Super I/O
+Floppy 	N/A 	
+Serial port 1 (COM1) 	OK 	
+Serial port 2 (COM2) 	N/A 	
+Parallel port 	N/A 	
+PS/2 keyboard 	OK 	
+PS/2 mouse 	Untested 	
+Game port 	N/A 	
+Infrared 	 ? 	
+PC speaker 	OK 	
+DiskOnChip 	N/A 	
+Input
+Trackpoint 	N/A 	
+Touchpad 	N/A 	
+Fn Hotkeys 	N/A 	
+Fingerprint Reader 	N/A 	
+Laptop
+Docking VGA 	N/A 	
+Docking LAN 	N/A 	
+Docking USB 	N/A 	
+Docking Audio 	N/A 	
+Docking Displayport 	N/A 	
+Thinklight 	N/A 	
+Webcam 	N/A 	
+Miscellaneous
+Sensors / fan control 	Untested 	
+Hardware watchdog 	Unknown 	
+SMBus 	Unknown 	
+CAN bus 	N/A 	
+CPU frequency scaling 	OK 	
+Other powersaving features 	 ? 	
+ACPI 	OK 	ACPI power button event works, suspend is WIP (work in progress).
+Reboot 	OK 	warm reboot from Asus' BIOS to coreboot does not work, use reset button after the first time you flash coreboot
+Poweroff 	OK 	
+Suspend 	OK 	
+Nonstandard LEDs 	OK 	
+High precision event timers (HPET) 	OK 	
+Random number generator (RNG) 	 ? 	
+Wake on modem ring 	Untested 	
+Wake on LAN 	Untested 	
+Wake on keyboard 	Untested 	
+Wake on mouse 	Untested 	
+TPM 	Unknown 	
+Flashrom 	OK 	
+Supported processing units
+
+ASUS F2A85-M CPU specification:[1]
+
+    AMD Socket FM2 Athlon�/A- Series Processors
+    Supports CPU up to 4 cores
+    Supports AMD� Turbo Core 3.0 Technology
+    Addenum: AMD Sempron X2 250[2]
+
+Note: Only AMD Virgo: "Trinity" desktop processing units are supported (see list below) but with a hack also Richland desktop processing units might work (contact via mailing list for details). Wikipedia's list of Trinity processors might be more actively maintained.
+CPUs
+
+    AMD Athlon X2 340
+    AMD Athlon X4 740
+    AMD Athlon X4 750k
+
+APUs
+
+The CPU architecture in these APUs are Piledriver, and their GPU is TeraScale 3 (VLIW4-based).
+
+    AMD A4-5300
+    AMD A4-5300B
+    AMD A6-5400K
+    AMD A6-5400B
+    AMD A8-5500
+    AMD A8-5500B
+    AMD A8-5600K
+    AMD A10-5700
+    AMD A10-5800B
+    AMD A10-5800K
+    AMD FirePro A300 - Only sold by OEM
+    AMD FirePro A320 - Only sold by OEM
+
+Notes
+
+    Retrieve the VGA optionrom from the vendor EFI binary by running:
+
+dd if=/dev/mem of=vgabios.bin bs=1k count=64 skip=768
+
+(source)
+
+For internal VGA: Boot the legacy BIOS, and use VGA_support chapter
+
+    Add the extracted VGA optionrom in menuconfig. The device ID for the APU graphics varies, run 'lspci -nn | grep VGA' to find the right ID.
+    If you use PS/2 de-select legacy free
+    De-select running option ROMs, Seabios will run the ROMs that coreboot loads into memory so you should get a text display from Seabios
+    It is required that seabios is the coreboot payload for the F2A85-M or the internal VGA will not be initialized. But read SeaBIOS for how to add payloads to SeaBIOS and set SeaBIOS' boot order to run your payload.
+        its internal VGA comes up just fine (using Change ID I9e0df1669d73863c95c36a3a7fee40d58f6f097e), with unpatched SeaBIOS and these settings:
+        CONFIG_VGA_ROM_RUN=y
+        CONFIG_PCI_ROM_RUN=y
+        CONFIG_ON_DEVICE_ROM_RUN=y
+    Hotswapping the PDIP BIOS chip has some issues (most likely USB3 XHCI, disable it in original bios before hot-flashing to coreboot). Drop a mail to mailing list if you have issues.
+
+TODOs
+
+    test virtualization
+    test IOMMU
+    test HDMI: video over hdmi works with the extracted vga optionrom, audio is untested.
+    blink in suspend mode (GP43, program LDN7 F8=23 and blink with F9=2 for 1s blinks)
+    fix mptable
+    fix resume with USB3.0 used (perhaps there is a bug in resume.c)
+    fix immediate resume after suspend (perhaps PCIe STS needs to be cleared)
+
+UEFI builds that allow flash chip access
+
+    v5016 is untested, but expected to work as well
+    v5018
+    v5103
+    v5104
+    v5107
+    v5202
+    v6002
+    v6004
+    v6102
+    v6402
+    v6404 (requires downgrading to v6402 to flash coreboot)
+    v6501 (requires downgrading to v6402 to flash coreboot)
+    v6502 (requires downgrading to v6402 to flash coreboot)
+
+Build v6502, v6501 and v6404 do not allow access to the flash chip.
+
+Fortunately it is possible to downgrade build v6502, v6501 and v6404 to v6402, with EZFlash.
+
+Downgrading is done by downloading build v6402 from ASUS' F2A85-M download page and copying it to (the root directory of) a FAT32 formatted USB flash drive.
+
+Enter the EFI setup, switch to advanced mode if necessary, open the 'Tool' tab and select "ASUS EZ Flash 2 Utility".
+Hardware info
+
+This board ships with a socketed Winbond 25Q64F, 64 Mbit (8 Mbyte) chip, in PDIP 300 mil package:
+Winbond 25Q64F
+
+The chip manual is available here
+
+For out of band flashing, I use a
+
+ 3M test clip model 923739-08-ND
+
+It has .300" spacing, 8 pin DIP clip, gold finish and 'headless heads'. I hook this up to a bus pirate. This works but reading and writing take forever:
+
+# time /usr/src/flashrom/flashrom -p buspirate_spi:dev=/dev/ttyUSB0 -w 20130826-coreboot.rom
+flashrom v0.9.6.1-r1669 on Linux 3.8-2-amd64 (x86_64)
+flashrom is free software, get the source code at http://www.flashrom.org
+
+Calibrating delay loop... OK.
+Found Winbond flash chip "W25Q64" (8192 kB, SPI) on buspirate_spi.
+Reading old flash chip contents... done.
+Erasing and writing flash chip... Erase/write done.
+Verifying flash... VERIFIED.
+
+real	35m35.409s
+user	0m55.976s
+sys	0m12.920s
+
+DDR voltage controller
+
+The DDR voltage controller is accessible through the AUX SMBUS device 0x15 and it is most likely driven by programmable current source NCT3933U (datasheet on nuvoton website).
+The ASUS digi VRM
+
+The ASUS digi voltage controller is accessible through the SMBUS device 0x20 and it is most likely driven by CHL8318 or similar chip (re-branded)
+Memory
+
+If you use single dimm plug it to DIMM_A2 or DIMM_B2.
+
+I use:
+
+2x 2GB DDR3 modules in blue slots:
+
+#modprobe i2c-piix4
+#modprobe eeprom
+#decode-dimms
+
+---=== Memory Characteristics ===---                                                        
+Fine time base                                  2.500 ps                                    
+Medium time base                                0.125 ns                                    
+Maximum module speed                            1333MHz (PC3-10666)                         
+Size                                            2048 MB                                     
+Banks x Rows x Columns x Bits                   8 x 14 x 10 x 64                            
+Ranks                                           2                                           
+SDRAM Device Width                              8 bits                                      
+tCL-tRCD-tRP-tRAS                               8-8-8-24                                    
+Supported CAS Latencies (tCL)                   9T, 8T, 7T, 6T  
+
+See also
+F2A85 series status
+
+Only boards with internal wiki page links are Supported Motherboards.
+
+    ASUS F2A85-M
+    ASUS F2A85-M LE
+    ASUS F2A85-M PRO[3] - the most available model in the entire F2A85 series. Be sure to check its status to see what works and what doesn't.
+    ASUS F2A85-M2 - Confirmed working in the #coreboot IRC channel 2015-03-04. Unsure if WIP.
+    ASUS F2A85-M/CSM - Unsure if WIP.
+
+References
+
+    Jump up ↑ https://www.asus.com/Motherboards/F2A85M/specifications/
+    Jump up ↑ http://support.asus.com/Cpusupport/List.aspx?SLanguage=en&m=F2A85-M&...
+    Jump up ↑ http://www.asus.com/Motherboards/F2A85M_PRO/

[Angel Pons (Code Review)]

Angel Pons has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/30896 )

Change subject: 2nd version, reworked based on Asus P8H61-M LX as a template and the old wiki
......................................................................

Patch Set 1:

(1 comment)

https://review.coreboot.org/#/c/30896/1//COMMIT_MSG 
Commit Message:

https://review.coreboot.org/#/c/30896/1//COMMIT_MSG@7 
PS1, Line 7: reworked based on Asus P8H61-M LX as a template
I am afraid this is not the case. Maybe the wrong commit was pushed?

[Balázs Vinarz (Code Review)]

Balázs Vinarz has posted comments on this change. ( https://review.coreboot.org/c/coreboot/+/30896 )

Change subject: 2nd version, reworked based on Asus P8H61-M LX as a template and the old wiki
......................................................................

Patch Set 1:
> Patch Set 1:
>
> (1 comment)

I used the other Asus board's status page as a template when creating this one.

[Balázs Vinarz (Code Review)]

Balázs Vinarz has abandoned this change. ( https://review.coreboot.org/c/coreboot/+/30896 )

Change subject: 2nd version, reworked based on Asus P8H61-M LX as a template and the old wiki
......................................................................

Abandoned

duplicate of 30895