From 430837996b3cbb85849be92cc4d9ce98ce2a0905 Mon Sep 17 00:00:00 2001 From: Alessandro Gatti Date: Wed, 24 Sep 2025 22:26:39 +0200 Subject: py/modsys: Add architecture flags to MicroPython metadata. This commit adds the currently supported architecture flags value as the upper part of "sys.implementation._mpy". This had the side effect of perturbing quite a bit of testing infrastructure and invalidating documentation related to MPY files. To make the test suite run successfully and keep the documentation in sync the following changes have been made: * The target info feature check file now isolates eventual architecture flags and adds them as a separate field * The test runner now picks up the new architecture flags field, reports it to STDOUT if needed and stores it for future uses * Relevant test files for MPY files import code had to be updated to mask out the architecture flags bits in order to perform correctly * MPY file format documentation was updated to show how to mask off and properly display the architecture flags information. This works out of the box if the flag bits can fit in a smallint value once merged with the MPY file header value. Signed-off-by: Alessandro Gatti --- docs/reference/mpyfiles.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'docs/reference') diff --git a/docs/reference/mpyfiles.rst b/docs/reference/mpyfiles.rst index 9687f5e46..58e45e158 100644 --- a/docs/reference/mpyfiles.rst +++ b/docs/reference/mpyfiles.rst @@ -58,12 +58,14 @@ If importing an .mpy file fails then try the following: sys_mpy = sys.implementation._mpy arch = [None, 'x86', 'x64', 'armv6', 'armv6m', 'armv7m', 'armv7em', 'armv7emsp', 'armv7emdp', - 'xtensa', 'xtensawin', 'rv32imc', 'rv64imc'][sys_mpy >> 10] + 'xtensa', 'xtensawin', 'rv32imc', 'rv64imc'][(sys_mpy >> 10) & 0x0F] print('mpy version:', sys_mpy & 0xff) print('mpy sub-version:', sys_mpy >> 8 & 3) print('mpy flags:', end='') if arch: print(' -march=' + arch, end='') + if (sys_mpy >> 16) != 0: + print(' -march-flags=' + (sys_mpy >> 16), end='') print() * Check the validity of the .mpy file by inspecting the first two bytes of -- cgit v1.2.3