Re: [PATCH] docs/system/ppc: Document running Linux on AmigaNG machines

[BALATON Zoltan]

On Fri, 16 Feb 2024, Thomas Huth wrote:
> On 16/02/2024 01.10, BALATON Zoltan wrote:
> > Documentation on how to run Linux on the amigaone, pegasos2 and
> > sam460ex machines is currently burried in the depths of the qemu-devel
>
> s/burried/buried/
>
> > mailing list and in the source code. Let's collect the information in
> > the QEMU handbook for a one stop solution.
> >
> > Co-authored-by: Bernhard Beschow <shentey@gmail.com>
> > Signed-off-by: BALATON Zoltan <balaton@eik.bme.hu>
> > ---
> > Supersedes: <20231216123013.67978-1-shentey@gmail.com>
> >
> >   MAINTAINERS                 |   1 +
> >   docs/system/ppc/amigang.rst | 160 ++++++++++++++++++++++++++++++++++++
> >   docs/system/target-ppc.rst  |   1 +
> >   3 files changed, 162 insertions(+)
> >   create mode 100644 docs/system/ppc/amigang.rst
> >
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index a24c2b51b6..8e5b47e7b4 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -1560,6 +1560,7 @@ F: hw/rtc/m41t80.c
> >   F: pc-bios/canyonlands.dt[sb]
> >   F: pc-bios/u-boot-sam460ex-20100605.bin
> >   F: roms/u-boot-sam460ex
> > +F: docs/system/ppc/amigang.rst
> >     pegasos2
> >   M: BALATON Zoltan <balaton@eik.bme.hu>
> > diff --git a/docs/system/ppc/amigang.rst b/docs/system/ppc/amigang.rst
> > new file mode 100644
> > index 0000000000..c03a7e0d66
> > --- /dev/null
> > +++ b/docs/system/ppc/amigang.rst
> > @@ -0,0 +1,160 @@
> > +AmigaNG boards (``amigaone``, ``pegasos2``, ``sam460ex``)
> > +=========================================================
> > +
> > +These PowerPC machines emulate boards that are primarily used for
> > +running Amiga like OSes (AmigaOS 4, MorphOS and AROS) but these can
> > +also run Linux which is what this section documents.
> > +
> > +Eyetech AmigaOne/Mai Logic Teron (``amigaone``)
> > +===============================================
>
> Wouldn't it be better to use a subsection here (i.e. "----" instead of 
> "====") ? And also adjust the subsections below to subsubsections?

This used to be the top but I've added another paragraph and forgot to 
change the headings. I'll check how other docs are organised and send 
another version after waiting for some time to see if anobody else spots 
some typos.

Thanks,
BALATON Zoltan

> > +
> > +The ``amigaone`` machine emulates an AmigaOne XE mainboard by Eyetech
> > +which is a rebranded Mai Logic Teron board with modified U-Boot
> > +firmware to support AmigaOS 4.
> > +
> > +Emulated devices
> > +----------------
> > +
> > + * PowerPC 7457 CPU (can also use``-cpu g3, 750cxe, 750fx`` or ``750gx``)
> > + * Articia S north bridge
> > + * VIA VT82C686B south bridge
> > + * PCI VGA compatible card (guests may need other card instead)
> > + * PS/2 keyboard and mouse
> > +
> > +Firmware
> > +--------
> > +
> > +A firmware binary is necessary for the boot process. It is a modified
> > +U-Boot under GPL but its source is lost so it cannot be included in
> > +QEMU. A binary is available at
> > +https://www.hyperion-entertainment.com/index.php/downloads?view=files&parent=28.
> > +The ROM image is in the last 512kB which can be extracted with the
> > +following command:
> > +
> > +.. code-block:: bash
> > +
> > +  $ tail -c 524288 updater.image > u-boot-amigaone.bin
> > +
> > +The BIOS emulator in the firmware is unable to run QEMU‘s standard
> > +vgabios so ``VGABIOS-lgpl-latest.bin`` is needed instead which can be
> > +downloaded from http://www.nongnu.org/vgabios.
> > +
> > +Running Linux
> > +-------------
> > +
> > +There are some Linux images under the following link that work on the
> > +``amigaone`` machine:
> > +https://sourceforge.net/projects/amigaone-linux/files/debian-installer/.
> > +To boot the system run:
> > +
> > +.. code-block:: bash
> > +
> > +  $ qemu-system-ppc -machine amigaone -bios u-boot-amigaone.bin \
> > +                    -cdrom "A1 Linux Net Installer.iso" \
> > +                    -device 
> > ati-vga,model=rv100,romfile=VGABIOS-lgpl-latest.bin
> > +
> > +From the firmware menu that appears select ``Boot sequence`` →
> > +``Amiga Multiboot Options`` and set ``Boot device 1`` to
> > +``Onboard VIA IDE CDROM``. Then hit escape until the main screen appears 
> > again,
> > +hit escape once more and from the exit menu that appears select either
> > +``Save settings and exit`` or ``Use settings for this session only``. It 
> > may
> > +take a long time loading the kernel into memory but eventually it boots 
> > and the
> > +installer becomes visible. The ``ati-vga`` RV100 emulation is not
> > +complete yet so only frame buffer works, DRM and 3D is not available.
> ...
>
> Thomas