projects / mirror_qemu.git / blame
| Commit | Line | Data |
|---|---|---|
| 0339c2a8 AB |
1 | Arm Server Base System Architecture Reference board (``sbsa-ref``) |
| 2 | ================================================================== | |
| 3 | ||
| 6df743dc PM |
4 | While the ``virt`` board is a generic board platform that doesn't match |
| 5 | any real hardware the ``sbsa-ref`` board intends to look like real | |
| 0339c2a8 | 6 | hardware. The `Server Base System Architecture |
| 5f1fffa0 | 7 | <https://developer.arm.com/documentation/den0029/latest>`_ defines a |
| 0339c2a8 | 8 | minimum base line of hardware support and importantly how the firmware |
| ff49fb95 | 9 | reports that to any operating system. |
| 0339c2a8 AB |
10 | |
| 11 | It is intended to be a machine for developing firmware and testing | |
| 12 | standards compliance with operating systems. | |
| 13 | ||
| 14 | Supported devices | |
| 15 | """"""""""""""""" | |
| 16 | ||
| ff49fb95 | 17 | The ``sbsa-ref`` board supports: |
| 0339c2a8 AB |
18 | |
| 19 | - A configurable number of AArch64 CPUs | |
| 20 | - GIC version 3 | |
| 21 | - System bus AHCI controller | |
| 22 | - System bus EHCI controller | |
| 23 | - CDROM and hard disc on AHCI bus | |
| 24 | - E1000E ethernet card on PCIe bus | |
| ec683110 | 25 | - Bochs display adapter on PCIe bus |
| 0339c2a8 AB |
26 | - A generic SBSA watchdog device |
| 27 | ||
| ff49fb95 MJ |
28 | |
| 29 | Board to firmware interface | |
| 30 | """"""""""""""""""""""""""" | |
| 31 | ||
| 32 | ``sbsa-ref`` is a static system that reports a very minimal devicetree to the | |
| 33 | firmware for non-discoverable information about system components. This | |
| 34 | includes both internal hardware and parts affected by the qemu command line | |
| 35 | (i.e. CPUs and memory). As a result it must have a firmware specifically built | |
| 36 | to expect a certain hardware layout (as you would in a real machine). | |
| 37 | ||
| 38 | DeviceTree information | |
| 39 | '''''''''''''''''''''' | |
| 40 | ||
| 41 | The devicetree provided by the board model to the firmware is not intended | |
| 42 | to be a complete compliant DT. It currently reports: | |
| 43 | ||
| 44 | - CPUs | |
| 45 | - memory | |
| 46 | - platform version | |
| 47 | - GIC addresses | |
| 48 | ||
| 9fe2b4a2 SM |
49 | Platform version |
| 50 | '''''''''''''''' | |
| 51 | ||
| ff49fb95 MJ |
52 | The platform version is only for informing platform firmware about |
| 53 | what kind of ``sbsa-ref`` board it is running on. It is neither | |
| 54 | a QEMU versioned machine type nor a reflection of the level of the | |
| 55 | SBSA/SystemReady SR support provided. | |
| 56 | ||
| 57 | The ``machine-version-major`` value is updated when changes breaking | |
| 58 | fw compatibility are introduced. The ``machine-version-minor`` value | |
| 59 | is updated when features are added that don't break fw compatibility. | |
| 9fe2b4a2 SM |
60 | |
| 61 | Platform version changes: | |
| 62 | ||
| 63 | 0.0 | |
| 64 | Devicetree holds information about CPUs, memory and platform version. | |
| 65 | ||
| 66 | 0.1 | |
| 67 | GIC information is present in devicetree. | |
| 68 | ||
| 69 | 0.2 | |
| 70 | GIC ITS information is present in devicetree. |