summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPeter Maydell <peter.maydell@linaro.org>2026-08-19 19:54:28 +0100
committerPeter Maydell <peter.maydell@linaro.org>2026-09-01 11:15:20 +0100
commitad64baf49de8af2d374906b37738e4c7fb9a795a (patch)
tree32a9f55bf3ba8fe86e955d5580ac421b0edef4f2 /docs
parentb2f7dd27a989984ced08a6cba5c04a649dd02cd0 (diff)
downloadqemu-ad64baf49de8af2d374906b37738e4c7fb9a795a.tar.gz
qemu-ad64baf49de8af2d374906b37738e4c7fb9a795a.zip
hw/arm: Remove the 'musicpal' machine
The 'musicpal' machine emulates the Freecom MusicPal, which was an "internet radio" released in the mid-2000s. The stock system used a 2.6.16 Linux kernel, but as far as I'm aware, support for the hardware was never upstreamed to the mainline kernel. There are a number of reasons for deprecating this board: * The hardware is now solidly obsolete * It was never supported in mainline Linux * The SoC is a Marvell one with no public datasheet * The only QEMU changes to it have been the usual tree wide updates and refactoring work * The only bug report we've ever had about it has been one of the usual "bug found by static analysis" kind But in fact we can just drop it immediately, because in commit 59754f85ed35 ("target/arm: Do memory type alignment check when translation disabled") in 2024 we broke the boot of the standard firmware image for this board. (The image's u-boot does a LDRH to an unaligned address, which is UNPREDICTABLE; we used to let it through, but that commit makes it take a Data Abort, so the image crashes before it boots the kernel.) Since nobody complained, we can deduce that nobody's actually using this machine. Remove the machine proper, and note this in the docs. Devices used only by this board will be removed in subsequent commits. Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Acked-by: Jan Kiszka <jan.kiszka@web.de> Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Reviewed-by: Philippe Mathieu-Daudé <philmd@oss.qualcomm.com> Message-id: 20260819185430.3467629-4-peter.maydell@linaro.org
Diffstat (limited to 'docs')
-rw-r--r--docs/about/removed-features.rst10
-rw-r--r--docs/system/arm/musicpal.rst19
-rw-r--r--docs/system/target-arm.rst1
3 files changed, 10 insertions, 20 deletions
diff --git a/docs/about/removed-features.rst b/docs/about/removed-features.rst
index 0735b4ea1d..6a9944a0c7 100644
--- a/docs/about/removed-features.rst
+++ b/docs/about/removed-features.rst
@@ -1251,6 +1251,16 @@ machine they want to use to avoid confusion. Existing users of the ``spike``
machine must ensure that they're setting the ``spike`` machine in the
command line (``-M spike``).
+Arm ``musicpal`` machine (removed in 11.2)
+''''''''''''''''''''''''''''''''''''''''''
+
+The ``musicpal`` machine was an emulation of the Freecom MusicPal, an
+"internet radio" device from the mid-2000s. This hardware was never
+supported in upstream Linux, was based on a Marvell SoC with no public
+documentation, and is now obsolete. We accidentally broke booting this
+board in 2024, without anybody noticing; it has therefore been removed
+without a deprecation period.
+
linux-user mode CPUs
--------------------
diff --git a/docs/system/arm/musicpal.rst b/docs/system/arm/musicpal.rst
deleted file mode 100644
index 9de380edf8..0000000000
--- a/docs/system/arm/musicpal.rst
+++ /dev/null
@@ -1,19 +0,0 @@
-Freecom MusicPal (``musicpal``)
-===============================
-
-The Freecom MusicPal internet radio emulation includes the following
-elements:
-
-- Marvell MV88W8618 Arm core.
-
-- 32 MB RAM, 256 KB SRAM, 8 MB flash.
-
-- Up to 2 16550 UARTs
-
-- MV88W8xx8 Ethernet controller
-
-- MV88W8618 audio controller, WM8750 CODEC and mixer
-
-- 128x64 display with brightness control
-
-- 2 buttons, 2 navigation wheels with button function
diff --git a/docs/system/target-arm.rst b/docs/system/target-arm.rst
index e34492402f..260cd7e4d6 100644
--- a/docs/system/target-arm.rst
+++ b/docs/system/target-arm.rst
@@ -87,7 +87,6 @@ Board-specific documentation
arm/cubieboard
arm/emcraft-sf2
arm/exynos
- arm/musicpal
arm/kzm
arm/nrf
arm/nuvoton