[PATCH v2 0/4] docs: aspeed: Minor updates

[PATCH v2 0/4] docs: aspeed: Minor updates

[Joel Stanley]

Here are some small updates to the aspeed docs.

v2: Tweak board changes, add patch to move ADC to the supported list

Joel Stanley (4):
  docs: aspeed: Add new boards
  docs: aspeed: Update OpenBMC image URL
  docs: aspeed: Give an example of booting a kernel
  docs: aspeed: ADC is now modelled

 docs/system/arm/aspeed.rst | 26 ++++++++++++++++++++------
 1 file changed, 20 insertions(+), 6 deletions(-)

-- 
2.33.0

[PATCH v2 1/4] docs: aspeed: Add new boards

[Joel Stanley]

Add X11, FP5280G2, G220A, Rainier and Fuji. Mention that Swift will be
removed in v7.0.

Signed-off-by: Joel Stanley <joel@jms.id.au>
---
v2:
 - Add POWER10 to Rainier description
 - Include Fuji
 - Mention Swift to be removed
---
 docs/system/arm/aspeed.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
index cec87e3743d0..41a9bd5608e8 100644
--- a/docs/system/arm/aspeed.rst
+++ b/docs/system/arm/aspeed.rst
@@ -14,6 +14,7 @@ AST2400 SoC based machines :
 
 - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
 - ``quanta-q71l-bmc``      OpenBMC Quanta BMC
+- ``supermicrox11-bmc``    Supermicro X11 BMC
 
 AST2500 SoC based machines :
 
@@ -21,12 +22,16 @@ AST2500 SoC based machines :
 - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
 - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
 - ``sonorapass-bmc``       OCP SonoraPass BMC
-- ``swift-bmc``            OpenPOWER Swift BMC POWER9
+- ``swift-bmc``            OpenPOWER Swift BMC POWER9 (to be removed in v7.0)
+- ``fp5280g2-bmc``         Inspur FP5280G2 BMC
+- ``g220a-bmc``            Bytedance G220A BMC
 
 AST2600 SoC based machines :
 
 - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex-A7)
 - ``tacoma-bmc``           OpenPOWER Witherspoon POWER9 AST2600 BMC
+- ``rainier-bmc``          IBM Rainier POWER10 BMC
+- ``fuji-bmc``             Facebook Fuji BMC
 
 Supported devices
 -----------------
-- 
2.33.0

Re: [SPAM] [PATCH v2 1/4] docs: aspeed: Add new boards

[Cédric Le Goater]

On 11/17/21 07:57, Joel Stanley wrote:
> Add X11, FP5280G2, G220A, Rainier and Fuji. Mention that Swift will be
> removed in v7.0.
> 
> Signed-off-by: Joel Stanley <joel@jms.id.au>


Reviewed-by: Cédric Le Goater <clg@kaod.org>

Thanks

C.


> ---
> v2:
>   - Add POWER10 to Rainier description
>   - Include Fuji
>   - Mention Swift to be removed
> ---
>   docs/system/arm/aspeed.rst | 7 ++++++-
>   1 file changed, 6 insertions(+), 1 deletion(-)
> 
> diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
> index cec87e3743d0..41a9bd5608e8 100644
> --- a/docs/system/arm/aspeed.rst
> +++ b/docs/system/arm/aspeed.rst
> @@ -14,6 +14,7 @@ AST2400 SoC based machines :
>   
>   - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
>   - ``quanta-q71l-bmc``      OpenBMC Quanta BMC
> +- ``supermicrox11-bmc``    Supermicro X11 BMC
>   
>   AST2500 SoC based machines :
>   
> @@ -21,12 +22,16 @@ AST2500 SoC based machines :
>   - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
>   - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
>   - ``sonorapass-bmc``       OCP SonoraPass BMC
> -- ``swift-bmc``            OpenPOWER Swift BMC POWER9
> +- ``swift-bmc``            OpenPOWER Swift BMC POWER9 (to be removed in v7.0)
> +- ``fp5280g2-bmc``         Inspur FP5280G2 BMC
> +- ``g220a-bmc``            Bytedance G220A BMC
>   
>   AST2600 SoC based machines :
>   
>   - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex-A7)
>   - ``tacoma-bmc``           OpenPOWER Witherspoon POWER9 AST2600 BMC
> +- ``rainier-bmc``          IBM Rainier POWER10 BMC
> +- ``fuji-bmc``             Facebook Fuji BMC
>   
>   Supported devices
>   -----------------
> 

[PATCH v2 2/4] docs: aspeed: Update OpenBMC image URL

[Joel Stanley]

This is the latest URL for the OpenBMC CI. The old URL still works, but
redirects.

Reviewed-by: Cédric Le Goater <clg@kaod.org>
Signed-off-by: Joel Stanley <joel@jms.id.au>
---
 docs/system/arm/aspeed.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
index 41a9bd5608e8..b87697fcf0b1 100644
--- a/docs/system/arm/aspeed.rst
+++ b/docs/system/arm/aspeed.rst
@@ -82,7 +82,7 @@ The Aspeed machines can be started using the ``-kernel`` option to
 load a Linux kernel or from a firmware. Images can be downloaded from
 the OpenBMC jenkins :
 
-   https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/distro=ubuntu,label=docker-builder
+   https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
 
 or directly from the OpenBMC GitHub release repository :
 
-- 
2.33.0

[PATCH v2 3/4] docs: aspeed: Give an example of booting a kernel

[Joel Stanley]

A common use case for the ASPEED machine is to boot a Linux kernel.
Provide a full example command line.

Reviewed-by: Cédric Le Goater <clg@kaod.org>
Signed-off-by: Joel Stanley <joel@jms.id.au>
---
 docs/system/arm/aspeed.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
index b87697fcf0b1..6aafd611e9a5 100644
--- a/docs/system/arm/aspeed.rst
+++ b/docs/system/arm/aspeed.rst
@@ -78,9 +78,9 @@ Missing devices
 Boot options
 ------------
 
-The Aspeed machines can be started using the ``-kernel`` option to
-load a Linux kernel or from a firmware. Images can be downloaded from
-the OpenBMC jenkins :
+The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
+to load a Linux kernel or from a firmware. Images can be downloaded from the
+OpenBMC jenkins :
 
    https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
 
@@ -88,6 +88,15 @@ or directly from the OpenBMC GitHub release repository :
 
    https://github.com/openbmc/openbmc/releases
 
+To boot a kernel directly from a Linux build tree:
+
+.. code-block:: bash
+
+  $ qemu-system-arm -M ast2600-evb -nographic \
+        -kernel arch/arm/boot/zImage \
+        -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
+        -initrd rootfs.cpio
+
 The image should be attached as an MTD drive. Run :
 
 .. code-block:: bash
-- 
2.33.0

[PATCH v2 4/4] docs: aspeed: ADC is now modelled

[Joel Stanley]

Move it to the supported list.

Signed-off-by: Joel Stanley <joel@jms.id.au>
---
v2: New patch
---
 docs/system/arm/aspeed.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
index 6aafd611e9a5..d8b102fa0ad0 100644
--- a/docs/system/arm/aspeed.rst
+++ b/docs/system/arm/aspeed.rst
@@ -56,13 +56,13 @@ Supported devices
  * Front LEDs (PCA9552 on I2C bus)
  * LPC Peripheral Controller (a subset of subdevices are supported)
  * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA
+ * ADC
 
 
 Missing devices
 ---------------
 
  * Coprocessor support
- * ADC (out of tree implementation)
  * PWM and Fan Controller
  * Slave GPIO Controller
  * Super I/O Controller
-- 
2.33.0

Re: [PATCH v2 0/4] docs: aspeed: Minor updates

[Peter Maydell]

On Wed, 17 Nov 2021 at 06:58, Joel Stanley <joel@jms.id.au> wrote:
>
> Here are some small updates to the aspeed docs.
>
> v2: Tweak board changes, add patch to move ADC to the supported list
>
> Joel Stanley (4):
>   docs: aspeed: Add new boards
>   docs: aspeed: Update OpenBMC image URL
>   docs: aspeed: Give an example of booting a kernel
>   docs: aspeed: ADC is now modelled

Hi; I've added this patchset to my set of things to apply
to target-arm.next for 7.0; thanks.

-- PMM