summaryrefslogtreecommitdiffstats
path: root/Documentation/boards/imx.rst
Commit message (Collapse)AuthorAgeFilesLines
* Documentation: i.MX: point out that barebox-*-u.img is i.MX6-specificAhmad Fatoum2023-12-051-1/+1
| | | | | | | | | | | | We don't use the DCD table for RAM setup on i.MX8M, so no special barebox binary is needed for USB upload. CONFIG_HABV4_IMAGE_SIGNED_USB is already i.MX6-specific, but point this out in the documentation explicitly as well. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20231129114705.1532572-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: boards: imx: add FlexSPI sub-sectionMarco Felsch2023-10-241-0/+80
| | | | | | | | | | | Document the FlexSPI image and boot feature to make it easier for users to enable the support. Also document the image layout since it became more complex with FlexSPI and HAB, so a detailed overview is very helpful. Signed-off-by: Marco Felsch <m.felsch@pengutronix.de> Link: https://lore.barebox.org/20231017145131.3069283-30-m.felsch@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: boards: imx: replace i.MX8MQ with i.MX8MMarco Felsch2023-10-241-3/+3
| | | | | | | | | | Some parts of the documentation refer to the i.MX8MQ which are valid for all i.MX8M SoCs. Also rename the i.MX8 to i.MX8M to make it clear which family we meant. Signed-off-by: Marco Felsch <m.felsch@pengutronix.de> Link: https://lore.barebox.org/20231017145131.3069283-29-m.felsch@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/imx'Sascha Hauer2023-09-251-3/+3
|\
| * ARM: i.MX: HABv4: point out i.MX6 specifics in docs and Kconfig help textAhmad Fatoum2023-09-211-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Signed USB images are a i.MX6 quirk as we need a point to DCD for imx-usb-loader to work with, but the DCD pointer needs to be invalidated for actual boot. On i.MX8M*, RAM setup can't be done completely by DCD anymore, so not having a DCD table is the norm and we don't need a signed USB image. Thus mark CONFIG_HABV4_IMAGE_SIGNED_USB i.MX6 only and while at it, fix hardcoded instances of i.MX6 headers. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20230921075511.2098569-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: boards: imx: add some HAB documentationAhmad Fatoum2023-09-211-0/+47
|/ | | | | | | | | | | | | We could use some extra documentation on how to use the hab command to fuse a SoC and what output should be expected. Add this to the documentation. Procedure was done with HABv4 on i.MX8MM, which is not yet upstream[1], but should be equivalent for i.MX6. [1]: https://lore.barebox.org/barebox/20230705144219.504194-1-r.czerwinski@pengutronix.de/ Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20230919141552.44037-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: Merge imx_defconfig and versatilepb_defconfig into multi_v5_v6_defconfigSascha Hauer2023-05-021-1/+1
| | | | | | | | We have a imx_defconfig with only a few boards enabled and also a versatilepb_defconfig. Merge both configs into a multi_v5_v6_defconfig to reduce the number of defconfigs. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* treewide: fix includes missed by multiarch supportAhmad Fatoum2023-04-111-2/+2
| | | | | | | | | | | Found by manual inspection of the results of: rg '#include\s*<mach/[^/]+>' | rg -v 'arch/(powerpc|sandbox|mips|x86|kvx)' Fixes: 68b778c24314 ("ARM: Drop mach dir include path") Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20230411071436.1630752-13-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: imx: improve reboot mode sectionRoland Hieber2023-03-211-4/+11
| | | | | | Signed-off-by: Roland Hieber <rhi@pengutronix.de> Link: https://lore.barebox.org/20230320114123.2202362-1-rhi@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* restart: add reset -w for warm bootrom resetAhmad Fatoum2022-10-271-1/+1
| | | | | | | | | | | | | | | | | | We currently support reboot mode communication with BootROMs of the i.MX6Q/DL, i.MX8MM and STM32MP15x. For each of these, the user must take care to use the correct reset as the highest priority reset often clears the non-volatile register mapped by the syscon holding the reboot mode. As we only have one BootROM, we can improve usability by adding a global flag that describes whether a restart handler is suitable for use after a bootrom reboot mode write. Add a flag bit describing this and allow populating it from the device tree as well as from drivers. Existing i.MX/STM32 drivers will be moved onto this in follow-up commits. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20221017071000.1458292-4-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: i.MX8MM: add reboot to serial download modeAhmad Fatoum2021-08-091-0/+29
| | | | | | | | | | | | | | | | | | | | | | | | The i.MX8MM reference manual follows long established tradition in not documenting BootROM magic reboot codes. For older i.MX variants, the values can be seen in the bmode tables of Freescale's U-Boot patches. There are no such patches for the i.MX8M, but testing shows that mw 0x30390094 0x10 ; mw 0x30390098 0x40000000 is one of the configurations that trigger serial download on next warm reset on an i.MX8MM. Describe this in the device tree, so gpr.reboot_mode.next=serial reset -r imxwd-warm does the right thing for that SoC. This all might work for other i.MX8M variants as well, but the dtsi can be genericized later on when tested. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20210803165937.31608-2-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* scripts: imx-image: rename dcdofs to ivtofsSascha Hauer2020-07-141-1/+1
| | | | | | | | | This renames the dcdofs config option in the imx-image tool to ivtofs. dcdofs is a misnomer. The DCD (Device Configuration Data) is only one part of the data linked into the IVT (Image Vector Table), but the meaning of the option is really the latter, not the former. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Doc: i.MX: Document image structure for i.MXRouven Czerwinski2019-09-251-0/+73
| | | | | | | Document the image and load structure for i.MX6 and i.MX8MQ. Signed-off-by: Rouven Czerwinski <r.czerwinski@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* doc: boards: imx: add HAB sectionBastian Krause2019-06-071-0/+59
| | | | | Signed-off-by: Bastian Krause <bst@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* doc: boards: imx: document image creationBastian Krause2019-06-071-0/+15
| | | | | Signed-off-by: Bastian Krause <bst@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: i.MX: Add support for ZII i.MX8MQ based devicesAndrey Smirnov2019-02-111-0/+1
| | | | | | | | | | | | | | Add support for the following ZII i.MX8MQ based boards: - ZII i.MX8MQ RMB3 - ZII i.MX8MQ Zest Most of the basic peripherals are supported by this patch. More advanced features such as PCIe, display support, etc, are planned to be added later. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: i.MX: Increase :maxdepth: for board documentationAndrey Smirnov2019-02-111-1/+1
| | | | | | | | A number of board documentation file have subsections. Increase :maxdepth:, so we'd get proper TOC and numbering. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: i.MX: improve wording, add markup and missing articlesRoland Hieber2018-12-171-45/+57
| | | | | Signed-off-by: Roland Hieber <rhi@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: i.MX: Document how to use GPTAndrey Smirnov2018-12-101-0/+19
| | | | | | | | Document a way to avoid clashes between i.MX boot info/Barebox and GPT's Partition Entry Array. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Revert "i.MX: Add provisions to boot from IRAM"Andrey Smirnov2018-08-311-27/+0
| | | | | | | | | | | | | | | | | | | After being introduced 3 years ago this feature ended up being "obsoleted by events" and project it was supposed to be a part of winded down. Revert this feature due to: a) Lack of users b) Existence of better way to make barebox load via SRAM as intermediary step that does not require two separate images to be built (.imx-sram-img) This reverts commit 903c9477a08c5655161779ef4144886928ecc7d1. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: fix code block and literal block highlightingRoland Hieber2018-08-101-2/+6
| | | | | | | | | Use shell script highlighting where it is resonable, use console highlighting for transcripts, and fix some of the few cases where the syntax was broken, resulting in text not being rendered at all. Signed-off-by: Roland Hieber <r.hieber@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: i.MX8: Add i.MX8mq EVK supportSascha Hauer2018-06-151-1/+12
| | | | | | Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de> Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/misc'Sascha Hauer2018-06-111-1/+1
|\
| * doc: boards: imx: link to mxs documentationRoland Hieber2018-05-141-1/+1
| | | | | | | | | | Signed-off-by: Roland Hieber <r.hieber@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: i.MX: Add missing <soctype>Andrey Smirnov2018-06-111-1/+1
| | | | | | | | | | Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: imx: Change block size for 'dd' to 1024Andrey Smirnov2018-06-111-1/+1
|/ | | | | | | | Real image starts at offset 0x400 (1024), so we can skip copying extra 512 bytes of zeros. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* i.MX/DCD compiler and interpreter: logic is differentJuergen Borleis2018-03-261-0/+57
| | | | | | | | | | | Reading the manual more carefully discovers a different logic for the DCD 'check' command. They use the term "until". In order to get the manual and the software in sync, this change switches to the term "until" as well. Changing must happen at compiler and interpreter level to make it work. Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: remove :numbered: from lower level toctreesSascha Hauer2017-12-011-1/+0
| | | | | | | Only the highest level toctree may have :numbered:, otherwise sphinxs complains loudly that the subtree is already numbered. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: i.MX: Add i.MX7 base architecture supportJuergen Borleis2017-01-201-0/+1
| | | | | Signed-off-by Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: add common definitions for i.MX50 SOCAlexander Kurz2016-09-121-0/+1
| | | | | Signed-off-by: Alexander Kurz <akurz@blala.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: imx: external boot capable SOC list completeAlexander Kurz2016-06-271-2/+1
| | | | | | | | | | | The iMX35 SOC supports both internal and external boot mode, and both modes are supported by barebox. The iMX35 is the latest SOC with support for this mode, none of the later iMX series iMX50, 51, 53, 6SL, 6SDL, 6DQ, 7S or 7D does support it. Let's complete the list. Signed-off-by: Alexander Kurz <akurz@blala.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: imx: Fix underline lengthSascha Hauer2015-06-181-1/+1
| | | | Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* i.MX: Add provisions to boot from IRAMAndrey Smirnov2015-05-071-0/+27
| | | | | | | | | | | | | This commit add a very basic code to allow Barebox to be booted from IRAM. Given that the amount of IRAM on most i.MX variants is insufficient to contain a copy of Barebox with any reasonable degree of functionality this code uses IRAM only as a temporary location and eventually bootstraps from DRAM. But the presense of the intermediate IRAM-only stage allows to add provisions to test the area of DRAM that Barebox would be using to facilitate various testing scenarious. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Docs: move the individual MXS target documentation where they belong toJuergen Borleis2015-01-271-1/+0
| | | | | | | i.MX and MXS differs in their global documentation. Honor this. Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Docs: just fix a typoJuergen Borleis2015-01-271-1/+1
| | | | | Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation/boards/: Numerous grammar/typo/rendering fixes.Robert P. J. Day2014-07-021-17/+18
| | | | | | | | | | | | | | | Various fixes related to fonts, rendering, grammar, etc., such as: * spelling mistakes * hyphenation * capitalization for proper names * proper bullet list formatting * sentence structure and so on. Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: Add new sphinxs docsSascha Hauer2014-06-261-0/+103
This is a rewrite of the Documentation in reStructuredText format using Sphinx as build system, see http://sphinx-doc.org/. The documentation is built into static html pages with 'make docs'. The pages can be found under Documentation/html after building. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>