Skip to contentSkip to conversation

MAX78000: documentation and test

PATCH Superseded Jackson Donaldson 3 participants 5 messages Jul 11, 2025 Arm/Amlogic Meson SoC support

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore
#0 lore raw

cover MAX78000: documentation and test

Adds .rST documentation and a functional test for the MAX78000FTHR machine as requested by Peter Maydell.

Jackson Donaldson (2):
docs/system: arm: Add max78000 board description tests/functional: Add a test for the MAX78000 arm machine

 docs/system/arm/max78000.rst              | 35 +++++++++++++++++
 tests/functional/meson.build              |  1 +
 tests/functional/test_arm_max78000fthr.py | 48 +++++++++++++++++++++++
 3 files changed, 84 insertions(+)
 create mode 100644 docs/system/arm/max78000.rst
 create mode 100755 tests/functional/test_arm_max78000fthr.py
Signature · 1 line
2.34.1
#1 lore raw

PATCH 1/2 docs/system: arm: Add max78000 board description

This adds the target guide for the max78000FTHR

---
 docs/system/arm/max78000.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/system/arm/max78000.rst
docs/system/arm/max78000.rst new file +35 -0
new file mode 100644
index 0000000000..d07d8b8a36
@@ -0,0 +1,35 @@
+Analog Devices max78000 board (``max78000fthr``)
+===============================================================================================================
+
+The max78000 is a Cortex-M4 based SOC with a RISC-V coprocessor. The RISC-V coprocessor is not supported.
+
+Supported devices
+-----------------
+
+ * Instruction Cache Controller
+ * UART
+ * Global Control Register
+ * True Random Number Generator
+ * AES
+
+Notable unsupported devices
+-----------------
+
+ * I2C
+ * CNN
+ * CRC
+ * SPI
+
+Boot options
+------------
+
+The max78000 can be started using the ``-kernel`` option to load a
+firmware at address 0 as the ROM. As the ROM normally jumps to software loaded
+from the internal flash at address 0x10000000, loading your program there is
+generally advisable. If you don't have a copy of the ROM, the interrupt
+vector table from user firmware will do.
+Example:
+
+.. code-block:: bash
+
+  $ qemu-system-arm -machine max78000fthr -kernel max78000.bin -device loader,file=max78000.bin,addr=0x10000000
\ No newline at end of file
Signature · 1 line
2.34.1
#2 lore raw

Re: [PATCH 1/2] docs/system: arm: Add max78000 board description

Quoted 8 lines · Jackson Donaldson

This adds the target guide for the max78000FTHR

---
 docs/system/arm/max78000.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/system/arm/max78000.rst

Did your local system build the docs? This should have given an error because the new file isn't listed in the toctree in docs/system/target-arm.rst.

Passing configure --enable-docs will force it to complain if you're missing a prerequisite to build the docs (otherwise it only builds them if it can).

thanks
-- PMM

#3 lore raw

PATCH 2/2 tests/functional: Add a test for the MAX78000 arm machine

In reply to Jackson Donaldson

Runs a binary from the max78000test repo used in developing the qemu implementation of the max78000 to verify that the machine and implemented devices generally still work.

---
 tests/functional/meson.build              |  1 +
 tests/functional/test_arm_max78000fthr.py | 48 +++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100755 tests/functional/test_arm_max78000fthr.py
tests/functional/meson.build +1 -0
index e9f19d54a2..f837c6ddb1 100644
@@ -131,6 +131,7 @@ tests_arm_system_thorough = [
   'arm_cubieboard',
   'arm_emcraft_sf2',
   'arm_integratorcp',
+  'arm_max78000fthr',
   'arm_microbit',
   'arm_orangepi',
   'arm_quanta_gsj',
tests/functional/test_arm_max78000fthr.py new file +48 -0

48 lines not on this page · raw message

Signature · 1 line
2.34.1
Reviewed-by on v1 2/2
#4 lore raw

Re: [PATCH 2/2] tests/functional: Add a test for the MAX78000 arm machine

Quoted 11 lines · Jackson Donaldson

Runs a binary from the max78000test repo used in developing the qemu implementation of the max78000 to verify that the machine and implemented devices generally still work.

---
  tests/functional/meson.build              |  1 +
  tests/functional/test_arm_max78000fthr.py | 48 +++++++++++++++++++++++
  2 files changed, 49 insertions(+)

create mode 100755 tests/functional/test_arm_max78000fthr.py