summaryrefslogtreecommitdiffstats
path: root/Documentation
Commit message (Collapse)AuthorAgeFilesLines
* doc: bootchooser: fix typoHEADmasterUlrich Ölmann20 hours1-1/+1
| | | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Link: https://lore.barebox.org/20220722101823.2585924-1-u.oelmann@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: devel: porting: bring up to dateAhmad Fatoum36 hours1-24/+38
| | | | | | | | | Recent barebox rework has simplified things a bit, so update the porting doc accordingly. Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220805040927.1658824-2-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: devel: project-ideas: update after DSA framework additionAhmad Fatoum36 hours1-4/+2
| | | | | | | | | We have a proper abstraction for switches now, so drop this idea from the list. Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220805040927.1658824-1-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/rpi4'Sascha Hauer2022-06-291-6/+11
|\
| * doc: bcm283x: reference newer firmwareAhmad Fatoum2022-06-171-2/+2
| | | | | | | | | | | | | | | | | | | | The old firmware can boot a Raspberry Pi 4 apparently, but it doesn't contain bcm2711 device trees, so it's probably not an actually supported configuration. Point at a newer firmware instead. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220609055922.667016-21-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * ARM: rpi: add Raspberry Pi 4 supportAhmad Fatoum2022-06-171-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | With basic driver support added in previous commits, add the boilerplate to have barebox-raspberry-pi.img usable as bootloader for the Raspberry Pi 4 in 64-Bit mode. Tested peripherals: - SD-Card - pinctrl - clocksource - mini-UART Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220609055922.667016-19-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * ARM: rpi: add generic Raspberry Pi imageAhmad Fatoum2022-06-171-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a new image that can be booted on all supported boards. This work by including DTs for all enabled boards in config and then consulting the mailbox interface at runtime to deduce which DT to pass to barebox proper. An alternative would have been to use the existing barebox-dt-2nd.img with a VideoCore-supplied device tree, but that has the drawback of requiring barebox to observe the same bindings as the kernel that's booted later. This approach makes migration straight-forward, because no difference in VideoCore configuration is required. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220609055922.667016-8-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Merge branch 'for-next/rockchip'Sascha Hauer2022-06-291-0/+1
|\ \ | |/ |/|
| * arm: rockchip: add support for the radxa rock3 boardMichael Riesch2022-06-081-0/+1
| | | | | | | | | | | | | | | | | | Add basic support for the Radxa ROCK3 Model A board (featuring the Rockchip RK3568 SoC). Signed-off-by: Michael Riesch <michael.riesch@wolfvision.net> Link: https://lore.barebox.org/20220531162624.245664-4-michael.riesch@wolfvision.net Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | ARM: i.MX8MN: Fix script to extract firmware blobsUwe Kleine-König2022-06-091-2/+2
|/ | | | | | | | | | The directory created by extracting firmware-imx-8.12.bin is called firmware-imx-8.12, not firmware-imx-8.0. Fixes: 35d4cf996034 ("ARM: i.MX8MN: add i.MX8MN-EVK support") Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de> Link: https://lore.barebox.org/20220608103654.118355-1-u.kleine-koenig@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: user: usb: fix literal block :: when : is intendedAhmad Fatoum2022-05-231-1/+1
| | | | | | | | | | | The line is followed by a list, not an indented literal block, so just a single colon should be used. This fixes following warning: WARNING: Literal block expected; none found. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220520111429.2716691-2-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: boards: stm32mp: document USB bootstrap via DFUAhmad Fatoum2022-05-231-0/+30
| | | | | | | | | | TF-A v2.6 now supports DFU for USB bootstrap on the STM32MP1. This is normally exercised by the STM32CubeProgrammer, but is easily usable with just dfu-util as well. Document how to. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220520111429.2716691-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/rpi'Sascha Hauer2022-05-191-0/+6
|\
| * ARM: configs: rpi: add and document single barebox-dt-2nd bootloaderAhmad Fatoum2022-04-251-0/+6
| | | | | | | | | | | | | | | | | | | | | | With recent rework, we can install barebox along with all supported Raspberry Pi device trees to the boot partition and let the VideoCore take core of passing the correct device tree to barebox. Enable the relevant option in config and document this briefly. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220425062849.17954-5-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: boards: stm32mp: elaborate on how to buildAhmad Fatoum2022-05-031-1/+3
| | | | | | | | | | | | | | | | | | | | The docs only show how to configure, not how to build the configuration. Add the missing info to make this more evident. Reported-by: https://stackoverflow.com/users/18074165/fila2016 Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220502065346.1804502-1-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: remote-control: be explicit about python2 requirementAhmad Fatoum2022-04-291-1/+1
|/ | | | | | | | This should help users a bit when using the tool. Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220426064658.423912-1-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: boards: i.MX8MP-EVK: Fix typoSascha Hauer2022-04-251-1/+1
| | | | | | Fix misspelled SoC name. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/stm32'Sascha Hauer2022-03-141-16/+59
|\
| * ARM: stm32mp: add board support for STM32MP135F-DKAhmad Fatoum2022-03-081-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | We already have the needed drivers in place to support the upcoming STM32MP131. Linux already has a basic DT for the DK board. Add a barebox board that leverages it. To try it out modify the existing FIP with: fiptool update --nt-fw build/images/barebox-stm32mp-generic-bl33.img \ --hw-config build/arch/arm/dts/stm32mp135f-dk.dtb \ mmcblk0p3 Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220221103625.3728055-2-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * ARM: stm32mp: build extra barebox-stm32mp-generic-bl33.imgAhmad Fatoum2022-02-231-7/+44
| | | | | | | | | | | | | | | | | | | | | | | | | | barebox-dt-2nd.img expects being loaded at an offset, so the stack can grow down from entry point. The STM32MP TF-A default is to not have an offset. Avoid this issue by having a stm32mp specific entry point that sets up a 64 byte stack after end of barebox. As it's stm32mp-specific anyway, we can skip the early FDT parsing and ask the SDRAM controller about RAM size. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220220124736.3052502-8-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * ARM: stm32mp: change stm32image extension to .stm32Ahmad Fatoum2022-02-231-12/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The .img extension for stm32mp1 images is unfortunate. The format is deprecated and its header makes it not directly executable and thus not suitable as-is for use in a FIP image where the BL33 is run from offset 0. To make existence of the STM32 header evident, rename the extension from .img to .stm32. As it's still supported by TF-A, have symlinks, so user build script can use the old names for now. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220220124736.3052502-5-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: devel: project-ideas: align with GSoC guidelinesAhmad Fatoum2022-03-031-7/+37
|/ | | | | | | | | | | | | | | | | | | | | Google informed orgs for GSoC 2022 about required info for ideas list: As we state in the Defining a Project Idea List section of the Mentor guide, please provide the following information for each idea: a) a project title/description b) more detailed description of the project (2-5+ sentences) c) expected outcomes d) skills required/preferred e) possible mentors f) expected size of project (175 or 350 hour) g) an easy, medium or hard difficulty rating of each project. We are nearly there, add the missing points. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220302155846.2990159-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/misc'Sascha Hauer2022-02-182-2/+4
|\
| * ARM: Rockchip: Add rk3568 BananaPi R2 Pro board supportFrank Wunderlich2022-02-111-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds support for the BananaPi R2 Pro board. It is basicly a copy of rk3568 evb board but with slightly modified DTS. Added GPIO-Leds to dts and modified the hw-detection a bit. Tested features so far are: - 1st stage booting - Network - SD card and Emmc - usb (1.1 and 3 work, usb2 not working) - power LED (green) Signed-off-by: Frank Wunderlich <frank-w@public-files.de> Link: https://lore.barebox.org/20220211091354.11573-1-linux@fw-web.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * Documentation: reboot-mode: mention that system.reboot_mode.next is ↵Ulrich Ölmann2022-01-241-1/+2
| | | | | | | | | | | | | | | | initially set to 'normal' Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Link: https://lore.barebox.org/20220120114725.2580392-2-u.oelmann@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * Documentation: reboot-mode: fix typosUlrich Ölmann2022-01-241-2/+2
| | | | | | | | | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Link: https://lore.barebox.org/20220120114725.2580392-1-u.oelmann@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Merge branch 'for-next/doc'Sascha Hauer2022-02-186-3/+155
|\ \
| * | Documentation: user: watchdog: note new wd -x optionAhmad Fatoum2022-01-261-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | wd command documentation is generated automatically and will list the new -x option. It's still a good idea to reference this in the watchdog user doc as well. Do so. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-6-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * | Documentation: boards: openrisc: fix wrong header formatAhmad Fatoum2022-01-261-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Build warns that line is too short. Fix it. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-5-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * | Documentation: regulator: reference new directory from indexAhmad Fatoum2022-01-261-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | The binding was recently added, but unreferenced. Fix this. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-4-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * | Documentation: add chapter on Talks about bareboxJohannes Schneider2022-01-262-0/+131
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | There's been a number of talks about barebox. Collect them in a new chapter for those, who prefer something less dry than wading through the docs. A top-level chapter is chosen, so it's more visible to visitors. The ordering is reverse chronological, except for the first entry: The newest talk is German about running DOOM in barebox, which is a bit detached to how barebox is normally used. Instead, let's keep the first entry as a pointer to the latest overview talk and then use reverse chronological order for the rest. Signed-off-by: Johannes Schneider <JSchneider@jetter.de> Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-2-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * | Documentation: user: introduction: update with lore/matrix/libera infoAhmad Fatoum2022-01-261-2/+11
| |/ | | | | | | | | | | | | | | | | | | | | The Website already points at Libera instead of Freenode. Update the intro section, so the docs are correct as well. While at it, mention lore and matrix. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: devel: add new project ideas sectionAhmad Fatoum2022-02-173-0/+177
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This section will collect ideas to improve barebox and should serve as a pool of ideas for people who want to enter the field of firmware development but need some guidance what to work on. These tasks can be adopted as part of programs like Google Summer of Code or by motivated individuals outside such programs. It's structured after coreboot's https://doc.coreboot.org/contributing/project_ideas.html Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220217082714.81749-2-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: user: barebox: fix formatting for code blockAhmad Fatoum2022-02-171-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Sphinx build warns that: Error in "code-block" directive: maximum 1 argument(s) allowed, 17 supplied. .. code-block:: console sh: mkimage -n barebox -A arm -T kernel -C none -a 0x80000000 -d \ build/images/barebox-freescale-imx53-loco.img image Problem is a missing blank line. Add it. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220217082349.81494-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: Describe how to generate a uImage for use with bootmSascha Hauer2022-02-071-1/+12
| | | | | | | | | | | | | | U-Boot's bootm command doesn't take raw barebox images. Describe how to generate a uImage from them which then can be started with bootm. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: user: barebox: mention generic dt 2nd stage supportAhmad Fatoum2022-02-071-3/+15
| | | | | | | | | | | | | | | | | | | | | | Most users interested in chainloading barebox will probably want to use the generic DT format for that: It will pass the checks the boot command may have and it will ensure the system is in the correct state, e.g. that caches are disabled. Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220205231930.2948516-2-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: remove some references to zbarebox.binAhmad Fatoum2022-02-073-6/+6
|/ | | | | | | | | | At least ARM doesn't generate zbarebox.bin anymore. Remove some of the left-over references. Reported-by: Frank Wunderlich <frank-w@public-files.de> Signed-off-by: Ahmad Fatoum <ahmad@a3f.at> Link: https://lore.barebox.org/20220205231930.2948516-1-ahmad@a3f.at Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* treewide: add SPDX-License-Identifier for .gitignoreAhmad Fatoum2022-01-051-0/+2
| | | | | | | | | Makes the files not appear when searching for files that lack SPDX-License-Identifier. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220103120539.1730644-4-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/rockchip'Sascha Hauer2021-12-151-6/+22
|\
| * arm: rockchip: add support for the quartz64 boardMichael Riesch2021-11-171-6/+22
| | | | | | | | | | | | | | | | | | | | | | The Pine64 Quartz64 board features the Rockchip RK3566, a reduced but largely identical version of the RK3568. Two models (A and B) of the Quartz64 board are envisaged, where this patch targets the already available model A. Signed-off-by: Michael Riesch <michael.riesch@wolfvision.net> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | documentation: regulator: add allow-dummy-supplyAndrej Picej2021-11-251-0/+35
| | | | | | | | | | | | | | | | Add "barebox,allow-dummy-supply" property documentation. Signed-off-by: Andrej Picej <andrej.picej@norik.com> Link: https://lore.barebox.org/20211119095429.1905473-7-andrej.picej@norik.com Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation/boards/riscv.rst: fix code blocksAntony Pavlov2021-11-221-2/+2
|/ | | | | | Signed-off-by: Antony Pavlov <antonynpavlov@gmail.com> Link: https://lore.barebox.org/20211006223038.129681-1-antonynpavlov@gmail.com Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/scripts-common-library'Sascha Hauer2021-11-151-0/+15
|\
| * scripts: Add rk-usb-loader toolSascha Hauer2021-11-101-0/+15
| | | | | | | | | | | | | | | | | | This adds a tool suitable for bootstrapping barebox on Rockchip RK3568 SoCs. It has been tested on this SoC only. It might or might not work with minor adjustments on other SoCs. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de> Tested-by: Michael Riesch <michael.riesch@wolfvision.net>
* | Documentation: reboot-mode: fix typosUlrich Ölmann2021-10-221-4/+4
|/ | | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Link: https://lore.barebox.org/20211021143654.13824-1-u.oelmann@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: Rockchip: fix path to rkbin firmware in documentationAhmad Fatoum2021-10-121-1/+1
| | | | | | | | | | | Like in the two lines following it, the rk3568_bl31_v1.24.elf firmware's top level directory is bin/. Checked against 7d631e0d5b2d ("rk3568: bl31: update version to v1.24"). Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20211011142215.25846-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/zynqmp'Sascha Hauer2021-10-071-2/+2
|\
| * Documentation: boards: zynqmp: fix broken linksMichael Riesch2021-10-041-2/+2
| | | | | | | | | | | | | | | | | | The external links are not properly recognized. Remove quotation marks as a fix. Signed-off-by: Michael Riesch <michael.riesch@wolfvision.net> Link: https://lore.barebox.org/20210913121350.9307-3-michael.riesch@wolfvision.net Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Merge branch 'for-next/targettools'Sascha Hauer2021-10-071-0/+45
|\ \
| * | scripts: allow building USB loader tools for target as wellAhmad Fatoum2021-10-021-0/+45
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We currently build the USB loader tools only for the host (build) system, but it can be useful to cross compile them as well for the target. We already have some target tools, but support for those is easier, because they don't link against libraries. We use pkg-config to get cc and ld flags, but we always assume that pkg-config is for the host system and there is no well-defined way to request pkg-config for the target system. Support this by introducing a new CROSS_PKG_CONFIG. This will be consulted only for target tools and default to $(CROSS_COMPILE)pkgconfig. Users can override it as necessary, for example, with Yocto, pkg-config will be for the cross environment, so target tools can now be built with: export ARCH=sandbox CROSS_COMPILE=aarch64-linux-gnu- export CROSS_PKG_CONFIG=pkg-config scripts make targettools_defconfig make scripts Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20210917174127.23345-4-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>