AMD SimNow Simulator 4.4.5 User manual

AMD SimNow™ Simulator
4.4.5
User’s Manual
Revision
Date
2.01
November 2008
Advanced Micro Devices, Inc.
One AMD Place
Sunnyvale, CA 94088
[e-mail]

AMD
AMD Confidential
© 2004-2008 Advanced Micro Devices, Inc.
The Contents of this document are provided in connection with Advanced
Micro Devices, Inc. (“AMD”) products. AMD makes no representations or
warranties with respect to the accuracy or completeness of the contents of this
publication and reserves the right to make changes to specifications and
product descriptions at any time without notice. No license, whether express,
implied, arising by estoppels or otherwise, to any intellectual property rights is
granted by this publication. Except as set forth in AMD‟s Standard Terms and
Conditions of Sale, AMD assumes no liability whatsoever, and disclaims any
express or implied warranty, relating to its products including, but not limited
to, the implied warranty of merchantability, fitness for a particular purpose, or
infringement of any intellectual property right.
AMD‟s products are not designed, intended, authorized or warranted for use
as components in systems intended for surgical implant into the body, or in
other applications intended to support or sustain life, or in any other
application in which the failure of AMD‟s product could create a situation
where personal injury, death, or severe property or environmental damage
may occur. AMD reserves the right to discontinue or make changes to its
products at any time without notice.
Trademarks
AMD, the AMD Arrow logo, AMD Athlon, AMD Opteron and combinations thereof,
SimNow, 3DNow!, AMD-8111, AMD-8131, AMD-8132 and AMD-8151 are trademarks
of Advanced Micro Devices, Inc.
HyperTransport is a trademark of the HyperTransport Technology Consortium.
Microsoft and Windows are registered trademarks of Microsoft Corporation.
PCI-X is a registered trademark of PCI-SIG.
Sysmark is a registered trademark of Business Applications Performance Corp.
MMX is a trademark of Intel Corporation.
Other product names used in this publication are for identification purposes only and may
be trademarks of their respective companies.

AMD Confidential
User Manual November 21st, 2008
Contents iii
Contents
Figures................................................................................................................................ ix
Tables.................................................................................................................................xi
1 Overview..................................................................................................................... 1
2 Installation................................................................................................................... 3
2.1 System Requirements.......................................................................................... 3
2.2 Installation Procedure ......................................................................................... 3
2.3 Directory Structure and Executable.................................................................... 4
2.4 Setting up Linux for the Simulator ..................................................................... 4
2.5 Configuration File............................................................................................... 5
2.6 Updates and Questions........................................................................................ 6
3 Graphical User Interface............................................................................................. 7
3.1 Tool Bar Buttons................................................................................................. 7
3.2 Device Window .................................................................................................. 9
3.2.1 Add a New Device.................................................................................... 10
3.2.2 Workspace Popup Menu........................................................................... 10
3.2.2.1 Add Connection.............................................................................. 11
3.2.2.2 Configure Device............................................................................ 12
3.2.2.3 Disconnect Device ......................................................................... 12
3.2.2.4 Delete Device.................................................................................. 13
3.2.3 Example Computer Description................................................................ 13
3.2.4 Device Window –Quick Reference ......................................................... 15
3.3 Device Groups .................................................................................................. 15
3.3.1 Terms ........................................................................................................ 16
3.3.2 Concept Diagrams..................................................................................... 17
3.3.3 Working with Device Groups................................................................... 18
3.3.4 Shell Automation Commands for Device Groups.................................... 19
3.3.4.1 Device Tree..................................................................................... 19
3.3.4.2 Enabled vs. Disabled vs. Mixed................................................... 20
3.3.5 Device Group Examples........................................................................... 21
3.3.5.1 Example: 1GB DDR2 memory..................................................... 21
3.3.5.2 Example: Quad-Core Node.......................................................... 22
3.3.5.3 Example: SuperIO device............................................................. 24
3.3.6 Creating a Device Group (GUI)................................................................ 24
3.3.7 Creating a Device Group (Automation Commands) ................................ 27
3.3.8 Ungrouping a created device group.......................................................... 29
3.4 Main Window ................................................................................................... 29
3.4.1 SimStats and Diagnostic Ports.................................................................. 29
3.4.2 CPU-Statistics Graphs .............................................................................. 30
3.4.2.1 Translation Graph........................................................................... 30
3.4.2.2 Real MIPS Graph........................................................................... 30
3.4.2.3 Invalidation Rate Graph ................................................................ 31
3.4.2.4 Exception Rate Graph................................................................... 31

AMD Confidential
User Manual November 21st, 2008
iv Contents
3.4.2.5 PIO Rate Graph.............................................................................. 31
3.4.2.6 MMIO Rate Graph.......................................................................... 32
3.4.3 Simulated Video........................................................................................ 32
3.4.4 Hard Disk and Floppy Display ................................................................. 32
3.4.5 Using Hard Drive, DVD-/CD-ROM and Floppy Images......................... 33
3.4.6 Registry Window...................................................................................... 33
3.4.7 Help, Problems and Bug Reports.............................................................. 34
4 Disk Images .............................................................................................................. 35
4.1 Creating A Blank Hard-Drive Image................................................................ 35
5 Running the Simulator.............................................................................................. 39
5.1 Command-Line Arguments .............................................................................. 39
5.1.1 Open a Simulation Definition File............................................................ 40
5.2 Installing an Operating System......................................................................... 42
5.2.1 Assigning Disk-Images............................................................................. 42
5.2.2 Run The Simulation.................................................................................. 44
5.2.3 Interaction with the Simulated Machine................................................... 45
5.2.4 Simulation Reset....................................................................................... 45
5.3 Multi-Machine Support..................................................................................... 45
6 Create a Simulated Computer................................................................................... 49
6.1 BSD Files.......................................................................................................... 49
6.2 Device Placement.............................................................................................. 49
6.3 Solo.bsd Device Configuration......................................................................... 51
6.4 Save and Run .................................................................................................... 52
7 Device Configuration................................................................................................ 53
7.1 AweSim Processor Device................................................................................ 55
7.2 Debugger Device .............................................................................................. 58
7.3 DIMM Device................................................................................................... 59
7.4 Emerald Graphics Device................................................................................. 65
7.5 Matrox MGA-G400 PCI/AGP.......................................................................... 69
7.6 Super IO Devices: Winbond W83627HF SIO / ITE 8712 SIO........................ 78
7.7 Memory Device ................................................................................................ 81
7.8 PCA9548 SMB Device..................................................................................... 84
7.9 PCA9556 SMB Device..................................................................................... 85
7.10 AMD 8th Generation Integrated Northbridge Device...................................... 86
7.11 AMD-8111™ Southbridge Devices – IO Hubs................................................ 90
7.12 PCI BUS Device............................................................................................... 96
7.13 AMD-8131™ PCI-X®Controller..................................................................... 98
7.14 AMD-8132™ PCI-X®Controller..................................................................... 99
7.15 PCI-X Test Device.......................................................................................... 101
7.16 AMD-8151™ AGP Bridge Device................................................................. 102
7.17 Raid Device: Compaq SmartArray 5304........................................................ 104
7.18 SMB Hub Device............................................................................................ 105
7.19 AT24C Device................................................................................................ 107
7.20 EXDI Server Device....................................................................................... 108
7.21 USB Keyboard and USB Mouse Devices....................................................... 109
7.22 XTR Device.................................................................................................... 110

AMD Confidential
User Manual November 21st, 2008
Contents v
7.22.1 Using XTR.............................................................................................. 111
7.22.1.1 Recoding XTR Trace................................................................... 111
7.22.1.2 Stop XTR Record......................................................................... 111
7.22.1.3 XTR Playback............................................................................... 111
7.22.1.4 Stop XTR Playback...................................................................... 112
7.22.2 XTR Structure......................................................................................... 114
7.22.2.1 XML Structure............................................................................... 114
7.22.2.2 XTR Binary File Contents ........................................................... 116
7.22.3 ModeFlags............................................................................................... 116
7.22.4 Limitations.............................................................................................. 117
7.22.5 Example XTR XML File........................................................................ 117
7.23 JumpDrive Device .......................................................................................... 123
7.24 E1000 Network Adapter Device..................................................................... 124
7.24.1 Simulated Link Negotiation.................................................................... 125
7.24.2 The Mediator Daemon............................................................................ 126
7.24.3 MAC Addresses for use with the Adapter.............................................. 127
7.24.4 Example Configurations ......................................................................... 127
7.24.4.1 Absolute NIC................................................................................. 127
7.24.4.2 Client-Server simulated network................................................ 128
7.24.4.3 Isolated Client-Server simulated network (Same process) ... 128
7.24.5 Visibility Diagram .................................................................................. 129
7.25 Plug and Play Monitor Device........................................................................ 130
7.26 ATI SB400/SB600/SB700 Southbridge Devices............................................ 132
7.27 ATI RS480/RS780/RD790/RD890 Northbridge Devices.............................. 134
7.28 AMD “Istanbul” Device ................................................................................. 135
7.29 AMD “Sao Paulo” Device .............................................................................. 136
7.30 AMD “Magny-Cours” Device ........................................................................ 137
8 PCI Configuration Viewer...................................................................................... 139
8.1 Scanning PCI Buses........................................................................................ 140
8.2 Modifying the PCI Configuration contents..................................................... 140
9 Logging................................................................................................................... 141
9.1 Message Log................................................................................................... 141
9.2 Error Log......................................................................................................... 143
9.3 I/O Logging..................................................................................................... 144
10 CPU Debugger.................................................................................................... 147
10.1 Using the CPU Debugger................................................................................ 147
10.1.1 Setting a Breakpoint................................................................................ 147
10.1.2 Single Stepping the Simulation............................................................... 148
10.1.3 Stepping Over an Instruction.................................................................. 148
10.1.4 Skipping an Instruction........................................................................... 149
10.1.5 Viewing a Memory Region..................................................................... 149
10.1.6 Reading PCI Configuration Registers..................................................... 150
10.1.7 Reading CPU MSR Contents.................................................................. 150
10.1.8 Find Pattern in Memory.......................................................................... 151
10.2 Debugger Command Reference...................................................................... 151
11 Debug Interface................................................................................................... 155

AMD Confidential
User Manual November 21st, 2008
vi Contents
11.1 Kernel Debugger............................................................................................. 155
11.2 GDB Interface................................................................................................. 156
11.2.1 Simple Approach .................................................................................... 156
11.2.2 Alternate Approach................................................................................. 157
11.2.3 Using Another Port on the Same Machine ............................................. 157
11.2.4 Using Two Separate Machines ............................................................... 157
11.3 Linux Host Serial Port Communication.......................................................... 157
12 Command API .................................................................................................... 159
13 DiskTool ............................................................................................................. 161
13.1 Command-Line Mode..................................................................................... 161
13.2 GUI Mode....................................................................................................... 162
14 BIOS Developer‟s Quick Start Guide................................................................. 167
14.1 Loading a BIOS Image ................................................................................... 167
14.2 Changing DRAM Size.................................................................................... 167
14.3 Changing SPD Data........................................................................................ 168
14.4 Clearing CMOS .............................................................................................. 169
14.5 Logging PCI Configuration Cycles ................................................................ 169
14.6 Logging CPU Cycles ...................................................................................... 170
14.7 Creating a Floppy-Disk Image........................................................................ 171
15 Frequently Asked Questions (FAQ) ................................................................... 173
A Appendix................................................................................................................. 177
A.1 Format of Floppy and Hard-Drive Images...................................................... 177
A.2 Bill of Material................................................................................................ 178
A.2.1 Computer Platform Files (BSD) ............................................................. 178
A.2.2 Device Files (*.BSL) .............................................................................. 178
A.2.3 Product Files (*.ID) ................................................................................ 179
A.2.4 Image Files (*.HDD, *.FDD, *.ROM, *.SPD, *.BIN)........................... 179
A.2.4.1 Hard-Disk Image Files........................................................................ 179
A.2.4.2 Memory SPD Files.............................................................................. 180
A.3 Supported Guest Operating Systems .............................................................. 181
A.4 CPUID............................................................................................................. 182
A.4.1 CPUID Standard Feature Support (Standard Function 0x01)................. 182
A.4.2 CPUID AMD Feature Support (Extended Function 0x80000001)......... 183
A.5 Known Issues.................................................................................................. 184
A.5.1 FSAVE/FRSTOR and FSTENV/FLDENV............................................ 184
A.5.2 Triple Faulting ........................................................................................ 184
A.5.3 Performance-Monitoring Counter Extensions........................................ 184
A.5.4 Microcode Patching................................................................................ 184
A.5.5 Instruction Coherency............................................................................. 184
A.6 Instruction Reference...................................................................................... 186
A.6.1 Notation................................................................................................... 186
A.6.1.1 Mnemonic Syntax............................................................................... 186
A.6.1.2 Opcode Syntax.................................................................................... 188
A.6.2 General Purpose Instructions.................................................................. 189
A.6.3 System Instructions................................................................................. 220
A.6.3.1 INT –Interrupt to Vector.................................................................... 222

AMD Confidential
User Manual November 21st, 2008
Contents vii
A.6.3.2 IRET –Return from Interrupt............................................................. 223
A.6.4 Virtualization Instruction Reference....................................................... 223
A.6.5 64-Bit Media Instruction Reference........................................................ 223
A.6.6 3DNow!™ Instruction Set ...................................................................... 224
A.6.7 Extension to the 3DNow! Instruction Set............................................... 225
A.6.8 Prescott New Instructions....................................................................... 225
A.6.8.1 MONITOR –Setup Monitor Address................................................. 226
A.6.8.2 MWAIT –Monitor Wait..................................................................... 226
A.7 Automation Commands.................................................................................. 227
A.7.1 Shell ........................................................................................................ 228
A.7.2 IDE.......................................................................................................... 232
A.7.3 USB......................................................................................................... 233
A.7.4 CMOS..................................................................................................... 234
A.7.5 ACPI ....................................................................................................... 234
A.7.6 Floppy..................................................................................................... 234
A.7.7 Debug...................................................................................................... 234
A.7.8 AMD-8151™ AGP Bridge ..................................................................... 235
A.7.9 VGA........................................................................................................ 235
A.7.10 Serial....................................................................................................... 235
A.7.11 HyperTransport™ Technology Configuration ....................................... 237
A.7.12 8th Generation Northbridge..................................................................... 238
A.7.13 DBC ........................................................................................................ 238
A.7.14 AMD-8111™ Device.............................................................................. 238
A.7.15 EHC......................................................................................................... 239
A.7.16 Journal..................................................................................................... 239
A.7.17 CPU......................................................................................................... 239
A.7.17.1 Profiling in SimNow™ Technology............................................... 239
A.7.17.2 CPU Code Generator Commands................................................... 241
A.7.18 Emerald Graphics.................................................................................... 241
A.7.19 Matrox MGA-G400 Graphics................................................................. 242
A.7.20 PCI Bus................................................................................................... 242
A.7.21 SIO.......................................................................................................... 242
A.7.22 Memory Device ...................................................................................... 243
A.7.23 Raid......................................................................................................... 244
A.7.24 DIMM ..................................................................................................... 245
A.7.25 Keyboard and Mouse.............................................................................. 246
A.7.26 JumpDrive............................................................................................... 247
A.7.27 E1000...................................................................................................... 250
A.7.28 XTR......................................................................................................... 250
A.7.29 ATI SB400/SB600/SB700...................................................................... 251
A.7.30 ATI RS480.............................................................................................. 251
A.7.31 ATI RS780.............................................................................................. 252
A.7.32 ATI RD790/RD780/RX780.................................................................... 252
A.7.33 ATI RD890S/RD890/RD780S/RX880................................................... 252
Index ............................................................................................................................... 254

AMD Confidential
User Manual November 21st, 2008
viii Contents

AMD Confidential
User Manual November 21st, 2008
Figures ix
Figures
Figure 3-1: Main Window (In Simulation)......................................................................... 7
Figure 3-2: Device Window................................................................................................ 9
Figure 3-3: Workspace Popup Menu................................................................................ 11
Figure 3-4: Add Connection Dialog of Device Properties Window................................. 12
Figure 3-5: Computer Simulation in “cheetah_1p.bsd” File ............................................ 13
Figure 3-6: Device group: BSD with one machine group and three child devices........... 17
Figure 3-7: Device group (different conceptual view –devices are inside groups)......... 18
Figure 3-8: Device Group (2 group devices 1 library device).......................................... 18
Figure 3-9: Modify Group ................................................................................................ 18
Figure 3-10: Device Group............................................................................................... 19
Figure 3-11: Example DIMM Device Group.................................................................... 21
Figure 3-12: Created DIMM Device Group ..................................................................... 22
Figure 3-13: Children of DIMM Device Group ............................................................... 22
Figure 3-14: Group Devices.............................................................................................. 24
Figure 3-15: Console Window.......................................................................................... 29
Figure 3-16: Progress Meter and Diagnostic Ports........................................................... 30
Figure 3-17: CPU Translation Graph................................................................................ 30
Figure 3-18: CPU Real MIPS Graph................................................................................ 31
Figure 3-19: CPU Invalidation Graph............................................................................... 31
Figure 3-20: CPU Exception Rate Graph ......................................................................... 31
Figure 3-21: CPU PIO Rate Graph................................................................................... 32
Figure 3-22: CPU MMIO Rate Graph.............................................................................. 32
Figure 3-23: Primary, Secondary, and Floppy Displays................................................... 33
Figure 3-24: Registry Window ......................................................................................... 34
Figure 4-1: DiskTool Dialogue Window.......................................................................... 36
Figure 4-2: DiskTool Shell Window................................................................................. 36
Figure 4-3: New Image Size............................................................................................. 37
Figure 4-4: Create Blank Image........................................................................................ 37
Figure 4-5: DiskTool Operation Successful ..................................................................... 38
Figure 5-1: Main Window (No BSD Loaded).................................................................. 39
Figure 5-2: Main Window (BSD Loaded)........................................................................ 41
Figure 5-3: Device Window.............................................................................................. 42
Figure 5-4: Installing WindowsXP................................................................................... 44
Figure 5-5: Special Keys Generator................................................................................. 45
Figure 6-1: Solo.bsd Configuration .................................................................................. 49
Figure 6-2: Connections Tab of Device Properties Window............................................ 50
Figure 6-3: PCI Bus Configuration dialog window.......................................................... 52
Figure 7-1: AweSim Processor-Type Properties .............................................................. 56
Figure 7-2: AweSim Processor Logging Properties Dialog ............................................. 57
Figure 7-3: AMD Opteron™ Processor Virtual Bank-Select Line Configuration........... 60
Figure 7-4: AMD Athlon™ 64 Processor Bank-Select Line Configuration .................... 60
Figure 7-5: DIMM-Bank Options Properties Dialog........................................................ 62
Figure 7-6: DIMM Module Properties Dialog.................................................................. 63

AMD Confidential
User Manual November 21st, 2008
xFigures
Figure 7-7: Graphics-Device VGA Sub Device Properties Dialog.................................. 66
Figure 7-8: Graphics Device Frame Buffer SubDevice Properties .................................. 67
Figure 7-9: Matrox G400 Block Diagram ........................................................................ 69
Figure 7-10: Matrox G400 Information Property Dialog................................................. 71
Figure 7-11: Matrox G400 Configuration Properties ....................................................... 72
Figure 7-12: Enable Full Hardware Acceleration on WindowsXP guest......................... 77
Figure 7-13: Super IO Properties Dialog: Winbond W83627HF..................................... 79
Figure 7-14: Memory Configuration Properties Dialog ................................................... 82
Figure 7-15: PCA9548 SMB Configuration Properties Dialog........................................ 84
Figure 7-16: PCA9556 SMB Configuration Properties Dialog........................................ 85
Figure 7-17: Northbridge Logging Capabilities Properties Dialog .................................. 87
Figure 7-18: Northbridge HT Link Configuration Properties Dialog............................... 87
Figure 7-19: Northbridge DDR2 Training Properties Dialog........................................... 88
Figure 7-20: USB Properties Dialog (AMD-8111™ Southbridge) .................................. 91
Figure 7-21: CMOS Properties Dialog (AMD-8111™ Southbridge) .............................. 92
Figure 7-22: HDD Primary Channel Properties Dialog (AMD-8111 Southbridge)......... 93
Figure 7-23: Device Options Properties Dialog (AMD-8111 chipset)............................. 94
Figure 7-24: Logging Options Properties Dialog (AMD-8111 chipset)........................... 95
Figure 7-25: PCI Bus Properties Dialog........................................................................... 97
Figure 7-26: AMD-8131™ Device Hot Plug Configuration............................................ 98
Figure 7-27: AMD-8132™ Device Hot Plug Configuration............................................ 99
Figure 7-28: AMD-8132 Properties Dialog.................................................................... 100
Figure 7-29: AMD-8151™ Device Properties Dialog.................................................... 102
Figure 7-30: SMB Hub Properties Dialog...................................................................... 106
Figure 7-31: AT24C Device Configuration.................................................................... 107
Figure 7-32: Communication via Mediator .................................................................... 124
Figure 7-33: Multi-Machine Communication without a Mediator................................. 125
Figure 7-34: Visibility Diagram...................................................................................... 129
Figure 7-35: Plug and Play Monitor Device Configuration............................................ 131
Figure 7-36: ATI SB600 SATA Configuration Dialog .................................................. 133
Figure 8-1: PCI Configuration Viewer........................................................................... 139
Figure 9-1: Message Log................................................................................................ 142
Figure 9-2: Error Log...................................................................................................... 143
Figure 9-3: I/O Logging Dialog...................................................................................... 144
Figure 10-1: CPU Debugger Window ............................................................................ 147
Figure 13-1: DiskTool Shell Window............................................................................. 163
Figure 13-2: DiskTool GUI Window.............................................................................. 164
Figure 13-3: DiskTool Drive Information ...................................................................... 164
Figure 13-4: DiskTool Progress Window....................................................................... 165
Figure 14-1: Memory Configurator................................................................................ 168
Figure 14-2: Diagnostics Display ................................................................................... 169
Figure 14-3: Message Log Window ............................................................................... 170
Figure 15-1: Console Window........................................................................................ 227