doc: Add documentation on supported platforms and CPUs

Message ID 20180712110623.31503-1-mpe@ellerman.id.au
State Accepted
Headers show
Series
  • doc: Add documentation on supported platforms and CPUs
Related show

Commit Message

Michael Ellerman July 12, 2018, 11:06 a.m.
This adds some info on the platforms and CPUs skiboot supports.

Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
---
 doc/index.rst              |  1 +
 doc/platforms-and-cpus.rst | 60 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 doc/platforms-and-cpus.rst

I'm a bit of an RST noob so apologies if this is badly formatted.

Comments

Stewart Smith July 17, 2018, 8:09 a.m. | #1
Michael Ellerman <mpe@ellerman.id.au> writes:
> This adds some info on the platforms and CPUs skiboot supports.
>
> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
> ---
>  doc/index.rst              |  1 +
>  doc/platforms-and-cpus.rst | 60 ++++++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 61 insertions(+)
>  create mode 100644 doc/platforms-and-cpus.rst
>
> I'm a bit of an RST noob so apologies if this is badly formatted.

I think we all are. looks good to me. Merged to master as of
caf0ff13c2543c96e1ad0d26fac1d9140c4b5ae3

(I debated if I should add in POWER7 at all, and then
went... nah... both users know it's there)
Michael Ellerman July 17, 2018, 9:52 a.m. | #2
Stewart Smith <stewart@linux.vnet.ibm.com> writes:

> Michael Ellerman <mpe@ellerman.id.au> writes:
>> This adds some info on the platforms and CPUs skiboot supports.
>>
>> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
>> ---
>>  doc/index.rst              |  1 +
>>  doc/platforms-and-cpus.rst | 60 ++++++++++++++++++++++++++++++++++++++++++++++
>>  2 files changed, 61 insertions(+)
>>  create mode 100644 doc/platforms-and-cpus.rst
>>
>> I'm a bit of an RST noob so apologies if this is badly formatted.
>
> I think we all are. looks good to me. Merged to master as of
> caf0ff13c2543c96e1ad0d26fac1d9140c4b5ae3

Thanks.

> (I debated if I should add in POWER7 at all, and then
> went... nah... both users know it's there)

You and who else? :)

I had some more details I was chasing but got stalled on, so I figured
it was better to send something rather than make it perfect. It can
always be updated of course.

cheers
Stewart Smith July 17, 2018, 10:12 a.m. | #3
Michael Ellerman <mpe@ellerman.id.au> writes:
>> (I debated if I should add in POWER7 at all, and then
>> went... nah... both users know it's there)
>
> You and who else? :)

Not even me. I think it's just Alexey and Paulus now (at least until
someone repairs the FSP in the giant P7 in the lab).

> I had some more details I was chasing but got stalled on, so I figured
> it was better to send something rather than make it perfect. It can
> always be updated of course.

Literally the entire state of the skiboot documentation.
Michael Ellerman July 18, 2018, 12:47 a.m. | #4
Stewart Smith <stewart@linux.vnet.ibm.com> writes:

> Michael Ellerman <mpe@ellerman.id.au> writes:
>>> (I debated if I should add in POWER7 at all, and then
>>> went... nah... both users know it's there)
>>
>> You and who else? :)
>
> Not even me. I think it's just Alexey and Paulus now (at least until
> someone repairs the FSP in the giant P7 in the lab).

I think it's actually just Alexey now, Paul has moved on :)

>> I had some more details I was chasing but got stalled on, so I figured
>> it was better to send something rather than make it perfect. It can
>> always be updated of course.
>
> Literally the entire state of the skiboot documentation.

s/skiboot documentation/everything/

cheers

Patch

diff --git a/doc/index.rst b/doc/index.rst
index 660085e05abb..b7a868c96e85 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -15,6 +15,7 @@  Overview
 
    overview
    opal-spec
+   platforms-and-cpus
 
 Development Process
 ===================
diff --git a/doc/platforms-and-cpus.rst b/doc/platforms-and-cpus.rst
new file mode 100644
index 000000000000..923de9d91680
--- /dev/null
+++ b/doc/platforms-and-cpus.rst
@@ -0,0 +1,60 @@ 
+Supported platforms & CPUs
+==========================
+
+NB. This file should only contain publicly available information.
+
+CPUs
+----
+
+=============== =============== =====================
+Name            PVR             Other names
+=============== =============== =====================
+Power8E         0x004bxxxx      Murano
+Power8          0x004dxxxx      Venice
+Power8NVL       0x004cxxxx      Naples
+Power9N         0x004e0xxx      Nimbus 12 small core
+Power9N         0x004e1xxx      Nimbus 24 small core
+Power9C         0x004e2xxx      Cumulus 12 small core
+Power9C         0x004e3xxx      Cumulus 24 small core
+=============== =============== =====================
+
+Platforms
+---------
+
+======== ============ =========== ================== ========================== ============================= =======
+Platform Sub platform Host CPU(s) Manufacturer       compatible                 Other names/Notes             Link(s)
+======== ============ =========== ================== ========================== ============================= =======
+astbmc   barreleye    Power8      Ingrasys (Foxconn) "ingrasys,barreleye"       Barreleye, Rackspace machine
+astbmc   firestone    Power8      Wistron, IBM       "ibm,firestone"            Firestone, S822LC             [#]_
+astbmc   garrison     Power8      IBM                "ibm,garrison"             Minsky, "S822LC for HPC"      [#]_
+astbmc   habanero     Power8      Tyan               "tyan,habanero"            Habanero, TN71-BP012
+astbmc   p8dtu        Power8      Supermicro         "supermicro,p8dtu1u"       Briggs, "S822LC for Big Data" [#]_ [#]_
+astbmc   p8dtu        Power8      Supermicro         "supermicro,p8dtu2u"       Stratton, S821LC              [#]_ [#]_
+astbmc   p8dnu        Power8      Supermicro         "supermicro,p8dnu(1u|2u)?"
+astbmc   p9sdu        Power9      Supermicro         "supermicro,p9dsu"         Boston, LC921/LC922           [#]_
+astbmc   palmetto     Power8      Tyan               "tyan,palmetto"            Palmetto, GN70-BP010
+astbmc   romulus      Power9                         "ibm,romulus"              Romulus
+astbmc   vesnin       Power9      Yadro              "YADRO,vesnin"             VESNIN
+astbmc   witherspoon  Power9                         "ibm,witherspoon"          Witherspoon, Newell, AC922    [#]_
+astbmc   zaius        Power9      Ingrasys (Foxconn) "ingrasys,zaius"           Zaius, Google Machine
+ibm-fsp  apollo       Power8                         "ibm,apollo"
+ibm-fsp  firenze      Power8E                        "ibm,firenze"
+ibm-fsp  zz           Power9                         "ibm,zz-(1|2)s(2|4)u"
+rhesus   n/a          Power8E                        "ibm,powernv"              Rhesus, Google machine
+======== ============ =========== ================== ========================== ============================= =======
+
+
+.. rubric:: Footnotes
+
+.. Firestone
+.. [#] `IBM Back In HPC With Power Systems LC Clusters <https://www.nextplatform.com/2015/10/08/ibm-back-in-hpc-with-power-systems-lc-clusters/>`_
+.. Minsky
+.. [#] `Refreshed IBM Power Linux Systems Add NVLink <https://www.nextplatform.com/2016/09/08/refreshed-ibm-power-linux-systems-add-nvlink/>`_
+.. Briggs
+.. [#] `Refreshed IBM Power Linux Systems Add NVLink <https://www.nextplatform.com/2016/09/08/refreshed-ibm-power-linux-systems-add-nvlink/>`_
+.. [#] `First Look IBM POWER8 S822LC 8001-22C (Briggs) <https://www.youtube.com/watch?v=TnW-NcLR28g>`_
+.. Stratton
+.. [#] `Refreshed IBM Power Linux Systems Add NVLink <https://www.nextplatform.com/2016/09/08/refreshed-ibm-power-linux-systems-add-nvlink/>`_
+.. [#] `First Look IBM POWER8 S821LC 8001-12C (Stratton) <https://www.youtube.com/watch?v=OM3wU4Uu8LI>`_
+.. [#] `Boston Power9s Set To Debut <https://www.itjungle.com/2018/05/14/boston-power9s-set-to-debut/>`_
+.. [#] `POWER9 TO THE PEOPLE <https://www.nextplatform.com/2017/12/05/power9-to-the-people/>`_