docs: add firmware-development "Simulators" page (MPS2/MPS3) + translations

New tutorial page under the firmware-development section covering the two
simulation targets: MPS2_AN500 (Cortex-M7, QEMU) and MPS3_AN547 (Cortex-M55 +
Ethos-U55, Arm FVP / Corstone SSE-300). Documents what each is for, installing
and running the simulators, the virtual camera (csi snapshot test pattern vs
loading images from files), running the unit-test suite over the bundled
mpremote, and adding tests (the /remote live-mount vs /rom ROMFS model).

Registered in the firmware toctree after building.rst. Adds simulation.po
translations for all 26 locales.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: kwagyeman

docs/locale/ar/LC_MESSAGES/openmvcam/tutorial/production/firmware/simulation.po

@@ -0,0 +1,354 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) The OpenMV MicroPython Documentation is Copyright ©
+# 2014-2026 by OpenMV, Damien P. George, and others.
+# This file is distributed under the same license as the OpenMV MicroPython
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: OpenMV MicroPython 1.28\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-06-29 16:04-0700\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: cs <LL@li.org>\n"
+"Language: cs\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=((n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2);\n"
+"Generated-By: Babel 2.17.0\n"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:2
+msgid "Simulators"
+msgstr "Simulátory"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:4
+msgid ""
+"Two ``TARGET`` values build the firmware to run inside a **simulator** on "
+"your host, with no hardware attached. They exist so the firmware can be run "
+"and tested anywhere."
+msgstr ""
+"Dvě hodnoty ``TARGET`` sestavují firmware tak, aby běžel uvnitř "
+"**simulátoru** na vašem hostiteli, bez připojeného hardwaru. Existují proto,"
+" aby bylo možné firmware spustit a testovat kdekoli."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:12
+msgid "``TARGET``"
+msgstr "``TARGET``"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:13
+msgid "Core"
+msgstr "Jádro"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:14
+msgid "NPU"
+msgstr "NPU"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:15
+msgid "Simulator"
+msgstr "Simulátor"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:16
+msgid "``MPS2_AN500``"
+msgstr "``MPS2_AN500``"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:17
+msgid "Cortex-M7"
+msgstr "Cortex-M7"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:18
+msgid "None"
+msgstr "Žádný"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:19
+msgid "QEMU"
+msgstr "QEMU"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:20
+msgid "``MPS3_AN547``"
+msgstr "``MPS3_AN547``"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:21
+msgid "Cortex-M55"
+msgstr "Cortex-M55"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:22
+msgid "Ethos-U55 (256 MACs)"
+msgstr "Ethos-U55 (256 MACs)"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:23
+msgid "Arm FVP -- Corstone SSE-300"
+msgstr "Arm FVP -- Corstone SSE-300"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:25
+msgid ""
+"**MPS2_AN500** is the baseline Cortex-M7 target with no NPU. It runs under "
+"QEMU, which is fast to start and is the lightweight way to exercise the "
+"platform-independent code and the test suite."
+msgstr ""
+"**MPS2_AN500** je základní cíl Cortex-M7 bez NPU. Běží pod QEMU, který se "
+"rychle spouští a je odlehčeným způsobem, jak procvičit platformově nezávislý"
+" kód a testovací sadu."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:29
+msgid ""
+"**MPS3_AN547** is a Cortex-M55 with the Ethos-U55 NPU, run on Arm's Fast "
+"Models -- the FVP, which models the Corstone SSE-300 reference subsystem. "
+"This is the target for exercising the NPU and the ML model path in "
+"simulation."
+msgstr ""
+"**MPS3_AN547** je Cortex-M55 s NPU Ethos-U55, spouštěný na rychlých modelech"
+" Arm -- FVP, který modeluje referenční subsystém Corstone SSE-300. Toto je "
+"cíl pro procvičování NPU a cesty ML modelu v simulaci."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:33
+msgid ""
+"Both provide the ROM filesystem and plenty of RAM (and the NPU on the M55), "
+"so vision and ML scripts run unmodified."
+msgstr ""
+"Oba poskytují souborový systém ROM a spoustu RAM (a NPU na M55), takže "
+"skripty pro vidění a ML běží beze změny."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:36
+msgid ""
+"There is no real sensor, but the :mod:`csi` module still works against a "
+"virtual one -- :meth:`csi.CSI.snapshot` returns a synthetic, animated test "
+"pattern (a scrolling checkerboard in grayscale, a gradient in RGB565), not a"
+" live scene. To process real image content, load it from a file instead: an "
+":class:`image.Image` from a fixture in the ROM filesystem, or an "
+":class:`image.ImageIO` stream for recorded frames."
+msgstr ""
+"Neexistuje žádný skutečný senzor, ale modul :mod:`csi` přesto funguje proti "
+"virtuálnímu -- :meth:`csi.CSI.snapshot` vrací syntetický, animovaný "
+"testovací vzor (rolující šachovnici v odstínech šedi, gradient v RGB565), "
+"nikoli živou scénu. Pro zpracování skutečného obsahu obrazu jej místo toho "
+"načtěte ze souboru: :class:`image.Image` z fixtury v souborovém systému ROM,"
+" nebo :class:`image.ImageIO` stream pro nahrané snímky."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:44
+msgid "Building and running"
+msgstr "Sestavení a spuštění"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:46
+msgid ""
+"Each simulator is a host tool you install yourself. You build a target like "
+"any other (see :doc:`building`), then ``run`` it under the matching "
+"simulator -- ``run`` builds the ROMFS image, boots the firmware, and leaves "
+"it running with a serial connection you can attach to."
+msgstr ""
+"Každý simulátor je hostitelský nástroj, který si nainstalujete sami. Cíl "
+"sestavíte jako kterýkoli jiný (viz :doc:`building`\\ ) a poté jej spustíte "
+"pomocí ``run`` pod odpovídajícím simulátorem -- ``run`` sestaví obraz ROMFS,"
+" nabootuje firmware a nechá jej běžet se sériovým připojením, ke kterému se "
+"můžete připojit."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:52
+msgid "MPS2_AN500 (QEMU)"
+msgstr "MPS2_AN500 (QEMU)"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:54
+msgid "QEMU ships in most package managers as the Arm system emulator:"
+msgstr ""
+"QEMU se ve většině správců balíčků dodává jako systémový emulátor Arm:"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:56
+msgid "**Linux** (Debian / Ubuntu) -- install it with ``apt``::"
+msgstr "**Linux** (Debian / Ubuntu) -- nainstalujte jej pomocí ``apt``\\ ::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:60
+msgid "**macOS** -- install it with Homebrew::"
+msgstr "**macOS** -- nainstalujte jej pomocí Homebrew::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:64
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:92
+msgid "Then build and run the target::"
+msgstr "Poté sestavte a spusťte cíl::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:70
+msgid "MPS3_AN547 (Arm FVP)"
+msgstr "MPS3_AN547 (Arm FVP)"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:72
+msgid ""
+"The FVP is Arm's Fixed Virtual Platform for the Corstone SSE-300, shipped as"
+" part of `Arm Virtual Hardware <https://www.arm.com/products/development-"
+"tools/simulation/virtual-hardware>`__. It is available for **Linux** only --"
+" on a Mac, use the QEMU target above instead."
+msgstr ""
+"FVP je pevná virtuální platforma Arm pro Corstone SSE-300, dodávaná jako "
+"součást `Arm Virtual Hardware <https://www.arm.com/products/development-"
+"tools/simulation/virtual-hardware>`__\\ . Je k dispozici pouze pro **Linux**"
+" -- na Macu místo toho použijte výše uvedený cíl QEMU."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:78
+msgid ""
+"Download the bundle, extract it, and put its ``bin/`` directory on your "
+"``PATH``::"
+msgstr ""
+"Stáhněte bundle, rozbalte jej a vložte jeho adresář ``bin/`` do svého "
+"``PATH``\\ ::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:86
+msgid ""
+"The FVP also needs the SDK's Python libraries on ``LD_LIBRARY_PATH`` when it"
+" runs. Export it once per shell from the repo root -- reading "
+"``SDK_VERSION`` keeps it correct as the repo updates the pinned SDK::"
+msgstr ""
+"FVP při svém běhu také potřebuje Python knihovny z SDK na "
+"``LD_LIBRARY_PATH``\\ . Vyexportujte jej jednou na shell z kořene repozitáře"
+" -- čtení ``SDK_VERSION`` jej udržuje správný, jak repozitář aktualizuje "
+"připnuté SDK::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:98
+msgid "Running the test suite"
+msgstr "Spuštění testovací sady"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:100
+msgid ""
+"The unit tests live in ``scripts/unittest/tests/``, with their fixture "
+"images and data in ``scripts/unittest/data/``. They are run with `mpremote "
+"<https://docs.micropython.org/en/latest/reference/mpremote.html>`__, which "
+"mounts ``scripts/unittest/`` onto the running simulator and executes its "
+"``run.py``."
+msgstr ""
+"Jednotkové testy se nacházejí v ``scripts/unittest/tests/``\\ , s jejich "
+"fixturovými obrázky a daty v ``scripts/unittest/data/``\\ . Spouštějí se "
+"pomocí `mpremote "
+"<https://docs.micropython.org/en/latest/reference/mpremote.html>`__\\ , "
+"který připojí ``scripts/unittest/`` na běžící simulátor a spustí jeho "
+"``run.py``\\ ."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:105
+msgid ""
+"The simulator link is slow with stock ``mpremote``, so use the copy bundled "
+"in the repo with the serial patch applied (apply it once)::"
+msgstr ""
+"Spojení se simulátorem je se standardním ``mpremote`` pomalé, takže použijte"
+" kopii dodávanou v repozitáři s aplikovanou sériovou záplatou (aplikujte ji "
+"jednou)::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:110
+msgid ""
+"For ``MPS2_AN500`` under QEMU, start the target -- it prints the pseudo-"
+"terminal its serial port is on (for example ``/dev/pts/5``)::"
+msgstr ""
+"Pro ``MPS2_AN500`` pod QEMU spusťte cíl -- vypíše pseudoterminál, na kterém "
+"je jeho sériový port (například ``/dev/pts/5``\\ )::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:115
+msgid ""
+"Then, from another shell, point the patched ``mpremote`` at that device::"
+msgstr ""
+"Poté z jiného shellu nasměrujte záplatovaný ``mpremote`` na to zařízení::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:120
+msgid ""
+"For ``MPS3_AN547`` under the FVP, the serial port is a telnet socket on port"
+" 5555 instead::"
+msgstr ""
+"Pro ``MPS3_AN547`` pod FVP je sériovým portem místo toho telnetový socket na"
+" portu 5555::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:127
+msgid ""
+"``run.py`` discovers and executes every test, printing a ``PASSED`` / "
+"``FAILED`` line per test with timing and a summary at the end."
+msgstr ""
+"``run.py`` objeví a spustí každý test a vypisuje řádek ``PASSED`` / "
+"``FAILED`` pro každý test s časováním a souhrnem na konci."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:131
+msgid "Adding a test"
+msgstr "Přidání testu"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:133
+msgid ""
+"Tests are discovered automatically. To add one, drop a file in "
+"``scripts/unittest/tests/`` that defines a ``unittest(data_path, "
+"temp_path)`` function returning ``True`` when the test passes and ``False`` "
+"when it fails::"
+msgstr ""
+"Testy jsou objeveny automaticky. Chcete-li nějaký přidat, vložte do "
+"``scripts/unittest/tests/`` soubor, který definuje funkci "
+"``unittest(data_path, temp_path)`` vracející ``True``\\ , když test projde, "
+"a ``False``\\ , když selže::"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:146
+msgid ""
+"The ``data_path`` and ``temp_path`` arguments point into the two filesystems"
+" the simulator sees while the suite runs:"
+msgstr ""
+"Argumenty ``data_path`` a ``temp_path`` ukazují do dvou souborových systémů,"
+" které simulátor vidí během běhu sady:"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:153
+msgid "Path"
+msgstr "Cesta"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:154
+msgid "Backed by"
+msgstr "Zajištěno"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:155
+msgid "``/remote``"
+msgstr "``/remote``"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:156
+msgid ""
+"The host's ``scripts/unittest/`` directory, mounted live over the "
+"``mpremote`` connection. ``run.py`` and the ``tests/`` it discovers live "
+"here, so adding or editing a test takes effect on the next run with no "
+"rebuild. ``temp_path`` is ``/remote/temp`` on the device, which is your "
+"host's ``scripts/unittest/temp/`` -- a writable scratch directory for tests "
+"that create files."
+msgstr ""
+"Hostitelský adresář ``scripts/unittest/``\\ , připojený živě přes spojení "
+"``mpremote``\\ . ``run.py`` a ``tests/``\\ , které objeví, jsou zde, takže "
+"přidání nebo úprava testu se projeví při příštím spuštění bez opětovného "
+"sestavení. ``temp_path`` je ``/remote/temp`` na zařízení, což je váš "
+"hostitelský ``scripts/unittest/temp/`` -- zapisovatelný pracovní adresář pro"
+" testy, které vytvářejí soubory."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:162
+msgid "``/rom``"
+msgstr "``/rom``"
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:163
+msgid ""
+"The board's read-only ROM filesystem, built into the firmware image from "
+"``romfs_config.json``: the test fixtures (from ``scripts/unittest/data/``) "
+"and the bundled ML models. ``data_path`` is ``/rom`` -- reach a fixture as "
+"``data_path + \"/<file>\"``."
+msgstr ""
+"Souborový systém ROM desky určený pouze ke čtení, zabudovaný do obrazu "
+"firmwaru z ``romfs_config.json``\\ : testovací fixtury (z "
+"``scripts/unittest/data/``\\ ) a dodávané ML modely. ``data_path`` je "
+"``/rom`` -- k fixtuře se dostanete jako ``data_path + \"/<file>\"``\\ ."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:168
+msgid ""
+"So a new **test** needs no rebuild, but a new **fixture** does: the ROM "
+"image is keyed off ``romfs_config.json`` rather than the individual data "
+"files, so force the rebuild by touching the board's ``romfs_config.json`` "
+"(or ``make TARGET=<TARGET> clean``) and running again."
+msgstr ""
+"Nový **test** tedy nepotřebuje opětovné sestavení, ale nová **fixtura** ano:"
+" obraz ROM je odvozen od ``romfs_config.json`` spíše než od jednotlivých "
+"datových souborů, takže vynuťte opětovné sestavení dotknutím se desky "
+"``romfs_config.json`` (nebo ``make TARGET=<TARGET> clean``\\ ) a opětovným "
+"spuštěním."
+
+#: ../../openmvcam/tutorial/production/firmware/simulation.rst:173
+msgid ""
+"Expected values are asserted inline in the test, so there is no separate "
+"expected-output file to maintain. To skip a test at runtime -- for example "
+"when it needs hardware the simulator does not model -- raise an exception "
+"whose message contains ``\"SKIPPED\"``."
+msgstr ""
+"Očekávané hodnoty jsou v testu ověřovány vloženě, takže není potřeba "
+"udržovat žádný samostatný soubor s očekávaným výstupem. Chcete-li test za "
+"běhu přeskočit -- například když potřebuje hardware, který simulátor "
+"nemodeluje -- vyvolejte výjimku, jejíž zpráva obsahuje ``\"SKIPPED\"``\\ ."