* [PATCH V2 01/12] board: imx: address dd usage in README
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
@ 2020-10-14 9:11 ` Peng Fan
2020-11-01 14:38 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 02/12] doc: board: Convert i.MX8MP EVK README to reST Peng Fan
` (11 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:11 UTC (permalink / raw)
To: u-boot
When using cygwin64 "dd (coreutils) 8.26 Packaged by Cygwin (8.26-2)",
the last not 512bytes aligned data wat cut off and not burned into SD
card.
Saying the flash.bin size is 1085608 bytes, not 512bytes aligned. It only
burned 1085440 bytes, the leaving 168 bytes were not burnned and cause
boot issue.
So update README dd command to add "conv=notrunc"
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8mm_evk/README | 2 +-
board/freescale/imx8mn_evk/README | 2 +-
board/freescale/imx8mp_evk/README | 2 +-
board/freescale/imx8mq_evk/README | 2 +-
board/freescale/imx8qxp_mek/README | 2 +-
board/freescale/imxrt1020-evk/README | 4 ++--
board/freescale/imxrt1050-evk/README | 4 ++--
board/freescale/mx6sabreauto/README | 8 ++++----
board/freescale/mx6sabresd/README | 12 ++++++------
board/freescale/mx6ul_14x14_evk/README | 4 ++--
board/freescale/mx6ullevk/README | 2 +-
11 files changed, 22 insertions(+), 22 deletions(-)
diff --git a/board/freescale/imx8mm_evk/README b/board/freescale/imx8mm_evk/README
index fa3f079f31..3307711d5d 100644
--- a/board/freescale/imx8mm_evk/README
+++ b/board/freescale/imx8mm_evk/README
@@ -30,7 +30,7 @@ $ export ATF_LOAD_ADDR=0x920000
$ make flash.bin
Burn the flash.bin to MicroSD card offset 33KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33
+$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
Boot
====
diff --git a/board/freescale/imx8mn_evk/README b/board/freescale/imx8mn_evk/README
index ff3d15c02b..ec007afb25 100644
--- a/board/freescale/imx8mn_evk/README
+++ b/board/freescale/imx8mn_evk/README
@@ -30,7 +30,7 @@ $ export ATF_LOAD_ADDR=0x960000
$ make flash.bin
Burn the flash.bin to MicroSD card offset 32KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32
+$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
Boot
====
diff --git a/board/freescale/imx8mp_evk/README b/board/freescale/imx8mp_evk/README
index 7dd3a9352a..3c64979be9 100644
--- a/board/freescale/imx8mp_evk/README
+++ b/board/freescale/imx8mp_evk/README
@@ -33,7 +33,7 @@ $ export ATF_LOAD_ADDR=0x960000
$ make flash.bin
Burn the flash.bin to the MicroSD card at offset 32KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32; sync
+$sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync
Boot
====
diff --git a/board/freescale/imx8mq_evk/README b/board/freescale/imx8mq_evk/README
index 859f852255..2689459b9f 100644
--- a/board/freescale/imx8mq_evk/README
+++ b/board/freescale/imx8mq_evk/README
@@ -30,7 +30,7 @@ $ make imx8mq_evk_defconfig
$ make flash.bin
Burn the flash.bin to MicroSD card offset 33KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33
+$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
Boot
====
diff --git a/board/freescale/imx8qxp_mek/README b/board/freescale/imx8qxp_mek/README
index 6e4eb5996b..6f99d0e13e 100644
--- a/board/freescale/imx8qxp_mek/README
+++ b/board/freescale/imx8qxp_mek/README
@@ -43,7 +43,7 @@ Flash the binary into the SD card
Burn the flash.bin binary to SD card offset 32KB:
-$ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32
+$ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
Boot
====
diff --git a/board/freescale/imxrt1020-evk/README b/board/freescale/imxrt1020-evk/README
index abee7ca5f3..9bc5bc00bc 100644
--- a/board/freescale/imxrt1020-evk/README
+++ b/board/freescale/imxrt1020-evk/README
@@ -11,11 +11,11 @@ This will generate the SPL image called SPL and the u-boot.img.
- Flash the SPL image into the micro SD card:
-sudo dd if=SPL of=/dev/sdX bs=1k seek=1; sync
+sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
- Flash the u-boot.img image into the micro SD card:
-sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128; sync
+sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
- Jumper settings:
diff --git a/board/freescale/imxrt1050-evk/README b/board/freescale/imxrt1050-evk/README
index a7e68fa9b3..f321300246 100644
--- a/board/freescale/imxrt1050-evk/README
+++ b/board/freescale/imxrt1050-evk/README
@@ -11,11 +11,11 @@ This will generate the SPL image called SPL and the u-boot.img.
- Flash the SPL image into the micro SD card:
-sudo dd if=SPL of=/dev/sdX bs=1k seek=1; sync
+sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
- Flash the u-boot.img image into the micro SD card:
-sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128; sync
+sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
- Jumper settings:
diff --git a/board/freescale/mx6sabreauto/README b/board/freescale/mx6sabreauto/README
index 4c0fda1a2d..710026a05e 100644
--- a/board/freescale/mx6sabreauto/README
+++ b/board/freescale/mx6sabreauto/README
@@ -13,11 +13,11 @@ This will generate the SPL and u-boot-dtb.img binaries.
- Flash the SPL binary into the SD card:
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 && sync
+$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
- Flash the u-boot-dtb.img binary into the SD card:
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 && sync
+$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
Booting via Falcon mode
-----------------------
@@ -36,11 +36,11 @@ This will generate the SPL image called SPL and the u-boot-dtb.img.
- Flash the SPL image into the SD card:
-$ sudo dd if=SPL of=/dev/sdb bs=1K seek=1 && sync
+$ sudo dd if=SPL of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
- Flash the u-boot-dtb.img image into the SD card:
-$ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 && sync
+$ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 conv=notrunc && sync
Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there:
diff --git a/board/freescale/mx6sabresd/README b/board/freescale/mx6sabresd/README
index 4ea4454b9f..974b0be175 100644
--- a/board/freescale/mx6sabresd/README
+++ b/board/freescale/mx6sabresd/README
@@ -25,11 +25,11 @@ This will generate the SPL and u-boot-dtb.img binaries.
- Flash the SPL binary into the SD card:
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 && sync
+$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
- Flash the u-boot-dtb.img binary into the SD card:
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 && sync
+$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
2. Booting from eMMC
@@ -53,8 +53,8 @@ Mount the eMMC in the host PC:
- Flash SPL and u-boot-dtb.img binaries into the eMMC:
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 && sync
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 && sync
+$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
+$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
Set SW6 to eMMC 8-bit boot: 11010110
@@ -69,11 +69,11 @@ This will generate the SPL image called SPL and the u-boot-dtb.img.
- Flash the SPL image into the SD card:
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none && sync
+$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync
- Flash the u-boot-dtb.img image into the SD card:
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none && sync
+$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync
Create a partition for root file system and extract it there:
diff --git a/board/freescale/mx6ul_14x14_evk/README b/board/freescale/mx6ul_14x14_evk/README
index e101abe48c..70eb86efba 100644
--- a/board/freescale/mx6ul_14x14_evk/README
+++ b/board/freescale/mx6ul_14x14_evk/README
@@ -14,11 +14,11 @@ This will generate the SPL image called SPL and the u-boot.img.
- Flash the SPL image into the micro SD card:
-sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1; sync
+sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1 conv=notrunc; sync
- Flash the u-boot.img image into the micro SD card:
-sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69; sync
+sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69 conv=notrunc; sync
- Jumper settings:
diff --git a/board/freescale/mx6ullevk/README b/board/freescale/mx6ullevk/README
index d5c8770863..47a35f61a2 100644
--- a/board/freescale/mx6ullevk/README
+++ b/board/freescale/mx6ullevk/README
@@ -15,7 +15,7 @@ This generates the u-boot-dtb.imx image in the current directory.
- Flash the u-boot-dtb.imx image into the micro SD card:
-$ sudo dd if=u-boot-dtb.imx of=/dev/sdb bs=1K seek=1 && sync
+$ sudo dd if=u-boot-dtb.imx of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
- Jumper settings:
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 01/12] board: imx: address dd usage in README
2020-10-14 9:11 ` [PATCH V2 01/12] board: imx: address dd usage in README Peng Fan
@ 2020-11-01 14:38 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:38 UTC (permalink / raw)
To: u-boot
> When using cygwin64 "dd (coreutils) 8.26 Packaged by Cygwin (8.26-2)",
> the last not 512bytes aligned data wat cut off and not burned into SD
> card.
> Saying the flash.bin size is 1085608 bytes, not 512bytes aligned. It only
> burned 1085440 bytes, the leaving 168 bytes were not burnned and cause
> boot issue.
> So update README dd command to add "conv=notrunc"
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 02/12] doc: board: Convert i.MX8MP EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
2020-10-14 9:11 ` [PATCH V2 01/12] board: imx: address dd usage in README Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:38 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 03/12] doc: board: Convert i.MX8MN " Peng Fan
` (10 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8mp_evk/README | 41 --------------------
doc/board/freescale/imx8mp_evk.rst | 61 ++++++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 62 insertions(+), 41 deletions(-)
delete mode 100644 board/freescale/imx8mp_evk/README
create mode 100644 doc/board/freescale/imx8mp_evk.rst
diff --git a/board/freescale/imx8mp_evk/README b/board/freescale/imx8mp_evk/README
deleted file mode 100644
index 3c64979be9..0000000000
--- a/board/freescale/imx8mp_evk/README
+++ /dev/null
@@ -1,41 +0,0 @@
-U-Boot for the NXP i.MX8MP EVK board
-
-Quick Start
-===========
-- Build the ARM Trusted firmware binary
-- Get the firmware-imx package
-- Build U-Boot
-- Boot
-
-Get and Build the ARM Trusted firmware
-======================================
-Note: $(srctree) is the U-Boot source directory
-Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
-branch: imx_5.4.3_2.0.0
-$ make PLAT=imx8mp bl31
-$ sudo cp build/imx8mp/release/bl31.bin $(srctree)
-
-Get the ddr firmware
-====================
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin
-$ chmod +x firmware-imx-8.7.bin
-$ ./firmware-imx-8.7
-$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
-$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
-$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
-$ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
-
-Build U-Boot
-============
-$ export CROSS_COMPILE=aarch64-poky-linux-
-$ make imx8mp_evk_defconfig
-$ export ATF_LOAD_ADDR=0x960000
-$ make flash.bin
-
-Burn the flash.bin to the MicroSD card at offset 32KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync
-
-Boot
-====
-Set Boot switch to SD boot
-Use /dev/ttyUSB2 for U-Boot console
diff --git a/doc/board/freescale/imx8mp_evk.rst b/doc/board/freescale/imx8mp_evk.rst
new file mode 100644
index 0000000000..b34742e33e
--- /dev/null
+++ b/doc/board/freescale/imx8mp_evk.rst
@@ -0,0 +1,61 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imx8mp_evk
+==========
+
+U-Boot for the NXP i.MX8MP EVK board
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get the firmware-imx package
+- Build U-Boot
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+Note: $(srctree) is the U-Boot source directory
+Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
+branch: imx_5.4.3_2.0.0
+
+.. code-block:: bash
+
+ $ make PLAT=imx8mp bl31
+ $ sudo cp build/imx8mp/release/bl31.bin $(srctree)
+
+Get the ddr firmware
+--------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin
+ $ chmod +x firmware-imx-8.7.bin
+ $ ./firmware-imx-8.7
+ $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
+ $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
+ $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
+ $ sudo cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-poky-linux-
+ $ make imx8mp_evk_defconfig
+ $ export ATF_LOAD_ADDR=0x960000
+ $ make flash.bin
+
+Burn the flash.bin to the MicroSD card at offset 32KB:
+
+.. code-block:: bash
+
+ $sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync
+
+Boot
+----
+
+Set Boot switch to SD boot
+Use /dev/ttyUSB2 for U-Boot console
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 8d42b35b96..070d678725 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -7,3 +7,4 @@ Freescale
:maxdepth: 2
b4860qds
+ imx8mp_evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 02/12] doc: board: Convert i.MX8MP EVK README to reST
2020-10-14 9:12 ` [PATCH V2 02/12] doc: board: Convert i.MX8MP EVK README to reST Peng Fan
@ 2020-11-01 14:38 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:38 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 03/12] doc: board: Convert i.MX8MN EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
2020-10-14 9:11 ` [PATCH V2 01/12] board: imx: address dd usage in README Peng Fan
2020-10-14 9:12 ` [PATCH V2 02/12] doc: board: Convert i.MX8MP EVK README to reST Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 04/12] doc: board: Convert i.MX8MM " Peng Fan
` (9 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8mn_evk/README | 37 -------------------
doc/board/freescale/imx8mn_evk.rst | 57 ++++++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 58 insertions(+), 37 deletions(-)
delete mode 100644 board/freescale/imx8mn_evk/README
create mode 100644 doc/board/freescale/imx8mn_evk.rst
diff --git a/board/freescale/imx8mn_evk/README b/board/freescale/imx8mn_evk/README
deleted file mode 100644
index ec007afb25..0000000000
--- a/board/freescale/imx8mn_evk/README
+++ /dev/null
@@ -1,37 +0,0 @@
-U-Boot for the NXP i.MX8MN EVK board
-
-Quick Start
-===========
-- Build the ARM Trusted firmware binary
-- Get firmware-imx package
-- Build U-Boot
-- Boot
-
-Get and Build the ARM Trusted firmware
-======================================
-Note: srctree is U-Boot source directory
-Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
-branch: imx_4.19.35_1.1.0
-$ make PLAT=imx8mn bl31
-$ cp build/imx8mn/release/bl31.bin $(srctree)
-
-Get the ddr firmware
-=============================
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.5.bin
-$ chmod +x firmware-imx-8.5.bin
-$ ./firmware-imx-8.5
-$ cp firmware-imx-8.5/firmware/ddr/synopsys/ddr4*.bin $(srctree)
-
-Build U-Boot
-============
-$ export CROSS_COMPILE=aarch64-poky-linux-
-$ make imx8mn_ddr4_evk_defconfig
-$ export ATF_LOAD_ADDR=0x960000
-$ make flash.bin
-
-Burn the flash.bin to MicroSD card offset 32KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
-
-Boot
-====
-Set Boot switch to SD boot
diff --git a/doc/board/freescale/imx8mn_evk.rst b/doc/board/freescale/imx8mn_evk.rst
new file mode 100644
index 0000000000..c3e92cecee
--- /dev/null
+++ b/doc/board/freescale/imx8mn_evk.rst
@@ -0,0 +1,57 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imx8mn_evk
+==========
+
+U-Boot for the NXP i.MX8MN EVK board
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get firmware-imx package
+- Build U-Boot
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+Note: srctree is U-Boot source directory
+Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
+branch: imx_4.19.35_1.1.0
+
+.. code-block:: bash
+
+ $ make PLAT=imx8mn bl31
+ $ cp build/imx8mn/release/bl31.bin $(srctree)
+
+Get the ddr firmware
+--------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.5.bin
+ $ chmod +x firmware-imx-8.5.bin
+ $ ./firmware-imx-8.5
+ $ cp firmware-imx-8.5/firmware/ddr/synopsys/ddr4*.bin $(srctree)
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-poky-linux-
+ $ make imx8mn_ddr4_evk_defconfig
+ $ export ATF_LOAD_ADDR=0x960000
+ $ make flash.bin
+
+Burn the flash.bin to MicroSD card offset 32KB:
+
+.. code-block:: bash
+
+ $sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
+
+Boot
+----
+
+Set Boot switch to SD boot
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 070d678725..77b6802098 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -7,4 +7,5 @@ Freescale
:maxdepth: 2
b4860qds
+ imx8mn_evk
imx8mp_evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 03/12] doc: board: Convert i.MX8MN EVK README to reST
2020-10-14 9:12 ` [PATCH V2 03/12] doc: board: Convert i.MX8MN " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 04/12] doc: board: Convert i.MX8MM EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (2 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 03/12] doc: board: Convert i.MX8MN " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 05/12] doc: board: Convert i.MX8MQ " Peng Fan
` (8 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8mm_evk/README | 37 --------------------
doc/board/freescale/imx8mm_evk.rst | 56 ++++++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 57 insertions(+), 37 deletions(-)
delete mode 100644 board/freescale/imx8mm_evk/README
create mode 100644 doc/board/freescale/imx8mm_evk.rst
diff --git a/board/freescale/imx8mm_evk/README b/board/freescale/imx8mm_evk/README
deleted file mode 100644
index 3307711d5d..0000000000
--- a/board/freescale/imx8mm_evk/README
+++ /dev/null
@@ -1,37 +0,0 @@
-U-Boot for the NXP i.MX8MM EVK board
-
-Quick Start
-===========
-- Build the ARM Trusted firmware binary
-- Get ddr firmware
-- Build U-Boot
-- Boot
-
-Get and Build the ARM Trusted firmware
-======================================
-Note: builddir is U-Boot build directory (source directory for in-tree builds)
-Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
-branch: imx_4.19.35_1.0.0
-$ make PLAT=imx8mm bl31
-$ cp build/imx8mm/release/bl31.bin $(builddir)
-
-Get the ddr firmware
-=============================
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.0.bin
-$ chmod +x firmware-imx-8.0.bin
-$ ./firmware-imx-8.0
-$ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
-
-Build U-Boot
-============
-$ export CROSS_COMPILE=aarch64-poky-linux-
-$ make imx8mm_evk_defconfig
-$ export ATF_LOAD_ADDR=0x920000
-$ make flash.bin
-
-Burn the flash.bin to MicroSD card offset 33KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
-
-Boot
-====
-Set Boot switch to SD boot
diff --git a/doc/board/freescale/imx8mm_evk.rst b/doc/board/freescale/imx8mm_evk.rst
new file mode 100644
index 0000000000..f75190227c
--- /dev/null
+++ b/doc/board/freescale/imx8mm_evk.rst
@@ -0,0 +1,56 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imx8mm_evk
+==========
+
+U-Boot for the NXP i.MX8MM EVK board
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get ddr firmware
+- Build U-Boot
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+Note: builddir is U-Boot build directory (source directory for in-tree builds)
+Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
+branch: imx_4.19.35_1.0.0
+
+.. code-block:: bash
+
+ $ make PLAT=imx8mm bl31
+ $ cp build/imx8mm/release/bl31.bin $(builddir)
+
+Get the ddr firmware
+--------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.0.bin
+ $ chmod +x firmware-imx-8.0.bin
+ $ ./firmware-imx-8.0
+ $ cp firmware-imx-8.0/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-poky-linux-
+ $ make imx8mm_evk_defconfig
+ $ export ATF_LOAD_ADDR=0x920000
+ $ make flash.bin
+
+Burn the flash.bin to MicroSD card offset 33KB:
+
+.. code-block:: bash
+
+ $sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
+
+Boot
+----
+Set Boot switch to SD boot
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 77b6802098..33b1be95f5 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -7,5 +7,6 @@ Freescale
:maxdepth: 2
b4860qds
+ imx8mm_evk
imx8mn_evk
imx8mp_evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 04/12] doc: board: Convert i.MX8MM EVK README to reST
2020-10-14 9:12 ` [PATCH V2 04/12] doc: board: Convert i.MX8MM " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 05/12] doc: board: Convert i.MX8MQ EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (3 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 04/12] doc: board: Convert i.MX8MM " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 06/12] doc: board: Convert i.MX8QXP MEK " Peng Fan
` (7 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8mq_evk/README | 37 --------------------
doc/board/freescale/imx8mq_evk.rst | 56 ++++++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 57 insertions(+), 37 deletions(-)
delete mode 100644 board/freescale/imx8mq_evk/README
create mode 100644 doc/board/freescale/imx8mq_evk.rst
diff --git a/board/freescale/imx8mq_evk/README b/board/freescale/imx8mq_evk/README
deleted file mode 100644
index 2689459b9f..0000000000
--- a/board/freescale/imx8mq_evk/README
+++ /dev/null
@@ -1,37 +0,0 @@
-U-Boot for the NXP i.MX8MQ EVK board
-
-Quick Start
-===========
-- Build the ARM Trusted firmware binary
-- Get ddr and hdmi fimware
-- Build U-Boot
-- Boot
-
-Get and Build the ARM Trusted firmware
-======================================
-Note: srctree is U-Boot source directory
-Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
-branch: imx_4.19.35_1.0.0
-$ make PLAT=imx8mq bl31
-$ cp build/imx8mq/release/bl31.bin $(builddir)
-
-Get the ddr and hdmi firmware
-=============================
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-7.9.bin
-$ chmod +x firmware-imx-7.9.bin
-$ ./firmware-imx-7.9.bin
-$ cp firmware-imx-7.9/firmware/hdmi/cadence/signed_hdmi_imx8m.bin $(builddir)
-$ cp firmware-imx-7.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
-
-Build U-Boot
-============
-$ export CROSS_COMPILE=aarch64-poky-linux-
-$ make imx8mq_evk_defconfig
-$ make flash.bin
-
-Burn the flash.bin to MicroSD card offset 33KB
-$sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
-
-Boot
-====
-Set Boot switch SW801: 1100 and Bmode: 10 to boot from Micro SD.
diff --git a/doc/board/freescale/imx8mq_evk.rst b/doc/board/freescale/imx8mq_evk.rst
new file mode 100644
index 0000000000..0a64ecc5ba
--- /dev/null
+++ b/doc/board/freescale/imx8mq_evk.rst
@@ -0,0 +1,56 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imx8mq_evk
+==========
+
+U-Boot for the NXP i.MX8MQ EVK board
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get ddr and hdmi fimware
+- Build U-Boot
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+Note: srctree is U-Boot source directory
+Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
+branch: imx_4.19.35_1.0.0
+
+.. code-block:: bash
+
+ $ make PLAT=imx8mq bl31
+ $ cp build/imx8mq/release/bl31.bin $(builddir)
+
+Get the ddr and hdmi firmware
+-----------------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-7.9.bin
+ $ chmod +x firmware-imx-7.9.bin
+ $ ./firmware-imx-7.9.bin
+ $ cp firmware-imx-7.9/firmware/hdmi/cadence/signed_hdmi_imx8m.bin $(builddir)
+ $ cp firmware-imx-7.9/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ export CROSS_COMPILE=aarch64-poky-linux-
+ $ make imx8mq_evk_defconfig
+ $ make flash.bin
+
+Burn the flash.bin to MicroSD card offset 33KB:
+
+.. code-block:: bash
+
+ $sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33 conv=notrunc
+
+Boot
+----
+Set Boot switch SW801: 1100 and Bmode: 10 to boot from Micro SD.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 33b1be95f5..5c10c95b93 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -10,3 +10,4 @@ Freescale
imx8mm_evk
imx8mn_evk
imx8mp_evk
+ imx8mq_evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 05/12] doc: board: Convert i.MX8MQ EVK README to reST
2020-10-14 9:12 ` [PATCH V2 05/12] doc: board: Convert i.MX8MQ " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 06/12] doc: board: Convert i.MX8QXP MEK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (4 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 05/12] doc: board: Convert i.MX8MQ " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 07/12] doc: board: Convert i.MXRT1020 EVK " Peng Fan
` (6 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imx8qxp_mek/README | 50 ----------------------
doc/board/freescale/imx8qxp_mek.rst | 66 +++++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 67 insertions(+), 50 deletions(-)
delete mode 100644 board/freescale/imx8qxp_mek/README
create mode 100644 doc/board/freescale/imx8qxp_mek.rst
diff --git a/board/freescale/imx8qxp_mek/README b/board/freescale/imx8qxp_mek/README
deleted file mode 100644
index 6f99d0e13e..0000000000
--- a/board/freescale/imx8qxp_mek/README
+++ /dev/null
@@ -1,50 +0,0 @@
-U-Boot for the NXP i.MX8QXP EVK board
-
-Quick Start
-===========
-
-- Build the ARM Trusted firmware binary
-- Get scfw_tcm.bin and ahab-container.img
-- Build U-Boot
-- Flash the binary into the SD card
-- Boot
-
-Get and Build the ARM Trusted firmware
-======================================
-
-$ git clone https://source.codeaurora.org/external/imx/imx-atf
-$ cd imx-atf/
-$ git checkout origin/imx_4.19.35_1.1.0 -b imx_4.19.35_1.1.0
-$ make PLAT=imx8qx bl31
-
-Get scfw_tcm.bin and ahab-container.img
-==============================
-
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-sc-firmware-1.2.7.1.bin
-$ chmod +x imx-sc-firmware-1.2.7.1.bin
-$ ./imx-sc-firmware-1.2.7.1.bin
-$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-2.3.1.bin
-$ chmod +x imx-seco-2.3.1.bin
-$ ./imx-seco-2.3.1.bin
-
-Copy the following binaries to U-Boot folder:
-
-$ cp imx-atf/build/imx8qx/release/bl31.bin .
-$ cp imx-seco-2.3.1/firmware/seco/mx8qx-ahab-container.img ./ahab-container.img
-$ cp imx-sc-firmware-1.2.7.1/mx8qx-mek-scfw-tcm.bin .
-
-Build U-Boot
-============
-$ make imx8qxp_mek_defconfig
-$ make flash.bin
-
-Flash the binary into the SD card
-=================================
-
-Burn the flash.bin binary to SD card offset 32KB:
-
-$ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
-
-Boot
-====
-Set Boot switch SW2: 1100.
diff --git a/doc/board/freescale/imx8qxp_mek.rst b/doc/board/freescale/imx8qxp_mek.rst
new file mode 100644
index 0000000000..215627cfa6
--- /dev/null
+++ b/doc/board/freescale/imx8qxp_mek.rst
@@ -0,0 +1,66 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imx8qxp_mek
+===========
+
+U-Boot for the NXP i.MX8QXP EVK board
+
+Quick Start
+-----------
+
+- Build the ARM Trusted firmware binary
+- Get scfw_tcm.bin and ahab-container.img
+- Build U-Boot
+- Flash the binary into the SD card
+- Boot
+
+Get and Build the ARM Trusted firmware
+--------------------------------------
+
+.. code-block:: bash
+
+ $ git clone https://source.codeaurora.org/external/imx/imx-atf
+ $ cd imx-atf/
+ $ git checkout origin/imx_4.19.35_1.1.0 -b imx_4.19.35_1.1.0
+ $ make PLAT=imx8qx bl31
+
+Get scfw_tcm.bin and ahab-container.img
+---------------------------------------
+
+.. code-block:: bash
+
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-sc-firmware-1.2.7.1.bin
+ $ chmod +x imx-sc-firmware-1.2.7.1.bin
+ $ ./imx-sc-firmware-1.2.7.1.bin
+ $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-2.3.1.bin
+ $ chmod +x imx-seco-2.3.1.bin
+ $ ./imx-seco-2.3.1.bin
+
+Copy the following binaries to U-Boot folder:
+
+.. code-block:: bash
+
+ $ cp imx-atf/build/imx8qx/release/bl31.bin .
+ $ cp imx-seco-2.3.1/firmware/seco/mx8qx-ahab-container.img ./ahab-container.img
+ $ cp imx-sc-firmware-1.2.7.1/mx8qx-mek-scfw-tcm.bin .
+
+Build U-Boot
+------------
+
+.. code-block:: bash
+
+ $ make imx8qxp_mek_defconfig
+ $ make flash.bin
+
+Flash the binary into the SD card
+---------------------------------
+
+Burn the flash.bin binary to SD card offset 32KB:
+
+.. code-block:: bash
+
+ $ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=32 conv=notrunc
+
+Boot
+----
+Set Boot switch SW2: 1100.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 5c10c95b93..6cd352565f 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -11,3 +11,4 @@ Freescale
imx8mn_evk
imx8mp_evk
imx8mq_evk
+ imx8qxp_mek
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 06/12] doc: board: Convert i.MX8QXP MEK README to reST
2020-10-14 9:12 ` [PATCH V2 06/12] doc: board: Convert i.MX8QXP MEK " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 07/12] doc: board: Convert i.MXRT1020 EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (5 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 06/12] doc: board: Convert i.MX8QXP MEK " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 08/12] doc: board: Convert i.MXRT1050 " Peng Fan
` (5 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imxrt1020-evk/README | 31 --------------------
doc/board/freescale/imxrt1020-evk.rst | 41 +++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 42 insertions(+), 31 deletions(-)
delete mode 100644 board/freescale/imxrt1020-evk/README
create mode 100644 doc/board/freescale/imxrt1020-evk.rst
diff --git a/board/freescale/imxrt1020-evk/README b/board/freescale/imxrt1020-evk/README
deleted file mode 100644
index 9bc5bc00bc..0000000000
--- a/board/freescale/imxrt1020-evk/README
+++ /dev/null
@@ -1,31 +0,0 @@
-How to use U-Boot on NXP i.MXRT1020 EVK
------------------------------------------------
-
-- Build U-Boot for i.MXRT1020 EVK:
-
-$ make mrproper
-$ make imxrt1020-evk_defconfig
-$ make
-
-This will generate the SPL image called SPL and the u-boot.img.
-
-- Flash the SPL image into the micro SD card:
-
-sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
-
-- Flash the u-boot.img image into the micro SD card:
-
-sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
-
-- Jumper settings:
-
-SW8: 0 1 1 0
-
-where 0 means bottom position and 1 means top position (from the
-switch label numbers reference).
-
-- Connect the USB cable between the EVK and the PC for the console.
-(The USB console connector is the one close the ethernet connector)
-
-- Insert the micro SD card in the board, power it up and U-Boot messages should
-come up.
diff --git a/doc/board/freescale/imxrt1020-evk.rst b/doc/board/freescale/imxrt1020-evk.rst
new file mode 100644
index 0000000000..267f80c517
--- /dev/null
+++ b/doc/board/freescale/imxrt1020-evk.rst
@@ -0,0 +1,41 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imxrt1020-evk
+=============
+
+How to use U-Boot on NXP i.MXRT1020 EVK
+---------------------------------------
+
+- Build U-Boot for i.MXRT1020 EVK:
+
+.. code-block:: bash
+
+ $ make mrproper
+ $ make imxrt1020-evk_defconfig
+ $ make
+
+This will generate the SPL image called SPL and the u-boot.img.
+
+- Flash the SPL image into the micro SD card:
+
+.. code-block:: bash
+
+ $sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
+
+- Flash the u-boot.img image into the micro SD card:
+
+.. code-block:: bash
+
+ $sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
+
+- Jumper settings::
+
+ SW8: 0 1 1 0
+
+where 0 means bottom position and 1 means top position (from the
+switch label numbers reference).
+
+- Connect the USB cable between the EVK and the PC for the console.
+ The USB console connector is the one close the ethernet connector
+
+- Insert the micro SD card in the board, power it up and U-Boot messages should come up.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 6cd352565f..81c4826beb 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -12,3 +12,4 @@ Freescale
imx8mp_evk
imx8mq_evk
imx8qxp_mek
+ imxrt1020-evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 07/12] doc: board: Convert i.MXRT1020 EVK README to reST
2020-10-14 9:12 ` [PATCH V2 07/12] doc: board: Convert i.MXRT1020 EVK " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 08/12] doc: board: Convert i.MXRT1050 EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (6 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 07/12] doc: board: Convert i.MXRT1020 EVK " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 09/12] doc: board: Convert i.MX6 Sabreauto " Peng Fan
` (4 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/imxrt1050-evk/README | 31 --------------------
doc/board/freescale/imxrt1050-evk.rst | 41 +++++++++++++++++++++++++++
doc/board/freescale/index.rst | 1 +
3 files changed, 42 insertions(+), 31 deletions(-)
delete mode 100644 board/freescale/imxrt1050-evk/README
create mode 100644 doc/board/freescale/imxrt1050-evk.rst
diff --git a/board/freescale/imxrt1050-evk/README b/board/freescale/imxrt1050-evk/README
deleted file mode 100644
index f321300246..0000000000
--- a/board/freescale/imxrt1050-evk/README
+++ /dev/null
@@ -1,31 +0,0 @@
-How to use U-Boot on NXP i.MXRT1050 EVK
------------------------------------------------
-
-- Build U-Boot for i.MXRT1050 EVK:
-
-$ make mrproper
-$ make imxrt1050-evk_defconfig
-$ make
-
-This will generate the SPL image called SPL and the u-boot.img.
-
-- Flash the SPL image into the micro SD card:
-
-sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
-
-- Flash the u-boot.img image into the micro SD card:
-
-sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
-
-- Jumper settings:
-
-SW7: 1 0 1 0
-
-where 0 means bottom position and 1 means top position (from the
-switch label numbers reference).
-
-- Connect the USB cable between the EVK and the PC for the console.
-(The USB console connector is the one close the ethernet connector)
-
-- Insert the micro SD card in the board, power it up and U-Boot messages should
-come up.
diff --git a/doc/board/freescale/imxrt1050-evk.rst b/doc/board/freescale/imxrt1050-evk.rst
new file mode 100644
index 0000000000..c1fb48f0cd
--- /dev/null
+++ b/doc/board/freescale/imxrt1050-evk.rst
@@ -0,0 +1,41 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+imxrt1050-evk
+=============
+
+How to use U-Boot on NXP i.MXRT1050 EVK
+---------------------------------------
+
+- Build U-Boot for i.MXRT1050 EVK:
+
+.. code-block:: bash
+
+ $ make mrproper
+ $ make imxrt1050-evk_defconfig
+ $ make
+
+This will generate the SPL image called SPL and the u-boot.img.
+
+- Flash the SPL image into the micro SD card:
+
+.. code-block:: bash
+
+ $sudo dd if=SPL of=/dev/sdX bs=1k seek=1 conv=notrunc; sync
+
+- Flash the u-boot.img image into the micro SD card:
+
+.. code-block:: bash
+
+ $sudo dd if=u-boot.img of=/dev/sdX bs=1k seek=128 conv=notrunc; sync
+
+- Jumper settings::
+
+ SW7: 1 0 1 0
+
+where 0 means bottom position and 1 means top position (from the
+switch label numbers reference).
+
+- Connect the USB cable between the EVK and the PC for the console.
+ The USB console connector is the one close the ethernet connector
+
+- Insert the micro SD card in the board, power it up and U-Boot messages should come up.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 81c4826beb..c9d7411875 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -13,3 +13,4 @@ Freescale
imx8mq_evk
imx8qxp_mek
imxrt1020-evk
+ imxrt1050-evk
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 08/12] doc: board: Convert i.MXRT1050 EVK README to reST
2020-10-14 9:12 ` [PATCH V2 08/12] doc: board: Convert i.MXRT1050 " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 09/12] doc: board: Convert i.MX6 Sabreauto README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (7 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 08/12] doc: board: Convert i.MXRT1050 " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 10/12] doc: board: Convert i.MX6 Sabresd " Peng Fan
` (3 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/mx6sabreauto/README | 82 ----------------------
doc/board/freescale/index.rst | 1 +
doc/board/freescale/mx6sabreauto.rst | 100 +++++++++++++++++++++++++++
3 files changed, 101 insertions(+), 82 deletions(-)
delete mode 100644 board/freescale/mx6sabreauto/README
create mode 100644 doc/board/freescale/mx6sabreauto.rst
diff --git a/board/freescale/mx6sabreauto/README b/board/freescale/mx6sabreauto/README
deleted file mode 100644
index 710026a05e..0000000000
--- a/board/freescale/mx6sabreauto/README
+++ /dev/null
@@ -1,82 +0,0 @@
-How to use and build U-Boot on mx6sabreauto
--------------------------------------------
-
-mx6sabreauto_defconfig target supports mx6q/mx6dl/mx6qp sabreauto variants.
-
-In order to build it:
-
-$ make mx6sabreauto_defconfig
-
-$ make
-
-This will generate the SPL and u-boot-dtb.img binaries.
-
-- Flash the SPL binary into the SD card:
-
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
-
-- Flash the u-boot-dtb.img binary into the SD card:
-
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
-
-Booting via Falcon mode
------------------------
-
-Write in mx6sabreauto_defconfig the following define below:
-
-CONFIG_SPL_OS_BOOT=y
-
-In order to build it:
-
-$ make mx6sabreauto_defconfig
-
-$ make
-
-This will generate the SPL image called SPL and the u-boot-dtb.img.
-
-- Flash the SPL image into the SD card:
-
-$ sudo dd if=SPL of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
-
-- Flash the u-boot-dtb.img image into the SD card:
-
-$ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 conv=notrunc && sync
-
-Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there:
-
-$ sudo cp uImage /media/boot
-
-$ sudo cp imx6dl-sabreauto.dtb /media/boot
-
-Create a partition for root file system and extract it there:
-
-$ sudo tar xvf rootfs.tar.gz -C /media/root
-
-The SD card must have enough space for raw "args" and "kernel".
-To configure Falcon mode for the first time, on U-Boot do the following commands:
-
-- Load dtb file from boot partition:
-
-# load mmc 0:1 ${fdt_addr} imx6dl-sabreauto.dtb
-
-- Load kernel image from boot partition:
-
-# load mmc 0:1 ${loadaddr} uImage
-
-- Write kernel at 2MB offset:
-
-# mmc write ${loadaddr} 0x1000 0x4000
-
-- Setup kernel bootargs:
-
-# setenv bootargs "console=ttymxc3,115200 root=/dev/mmcblk0p1 rootfstype=ext4 rootwait quiet rw"
-
-- Prepare args:
-
-# spl export fdt ${loadaddr} - ${fdt_addr}
-
-- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors)
-
-# mmc write 18000000 0x800 0x800
-
-- Restart the board and then SPL binary will launch the kernel directly.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index c9d7411875..cc079cadce 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -14,3 +14,4 @@ Freescale
imx8qxp_mek
imxrt1020-evk
imxrt1050-evk
+ mx6sabreauto
diff --git a/doc/board/freescale/mx6sabreauto.rst b/doc/board/freescale/mx6sabreauto.rst
new file mode 100644
index 0000000000..fe4cd9d214
--- /dev/null
+++ b/doc/board/freescale/mx6sabreauto.rst
@@ -0,0 +1,100 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+mx6sabreauto
+============
+
+How to use and build U-Boot on mx6sabreauto
+-------------------------------------------
+
+mx6sabreauto_defconfig target supports mx6q/mx6dl/mx6qp sabreauto variants.
+
+In order to build it:
+
+.. code-block:: bash
+
+ $ make mx6sabreauto_defconfig
+ $ make
+
+This will generate the SPL and u-boot-dtb.img binaries.
+
+- Flash the SPL binary into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
+
+- Flash the u-boot-dtb.img binary into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
+
+Booting via Falcon mode
+-----------------------
+
+Write in mx6sabreauto_defconfig the following define below:
+
+CONFIG_SPL_OS_BOOT=y
+
+In order to build it:
+
+.. code-block:: bash
+
+ $ make mx6sabreauto_defconfig
+ $ make
+
+This will generate the SPL image called SPL and the u-boot-dtb.img.
+
+- Flash the SPL image into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=SPL of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
+
+- Flash the u-boot-dtb.img image into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1K seek=69 conv=notrunc && sync
+
+Create a FAT16 boot partition to store uImage and the dtb file, then copy the files there:
+
+.. code-block:: bash
+
+ $ sudo cp uImage /media/boot
+ $ sudo cp imx6dl-sabreauto.dtb /media/boot
+
+Create a partition for root file system and extract it there:
+
+.. code-block:: bash
+
+ $ sudo tar xvf rootfs.tar.gz -C /media/root
+
+The SD card must have enough space for raw "args" and "kernel".
+To configure Falcon mode for the first time, on U-Boot do the following commands:
+
+- Load dtb file from boot partition::
+
+ # load mmc 0:1 ${fdt_addr} imx6dl-sabreauto.dtb
+
+- Load kernel image from boot partition::
+
+ # load mmc 0:1 ${loadaddr} uImage
+
+- Write kernel at 2MB offset::
+
+ # mmc write ${loadaddr} 0x1000 0x4000
+
+- Setup kernel bootargs::
+
+ # setenv bootargs "console=ttymxc3,115200 root=/dev/mmcblk0p1 rootfstype=ext4 rootwait quiet rw"
+
+- Prepare args::
+
+ # spl export fdt ${loadaddr} - ${fdt_addr}
+
+- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors)::
+
+ # mmc write 18000000 0x800 0x800
+
+- Restart the board and then SPL binary will launch the kernel directly.
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 09/12] doc: board: Convert i.MX6 Sabreauto README to reST
2020-10-14 9:12 ` [PATCH V2 09/12] doc: board: Convert i.MX6 Sabreauto " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 10/12] doc: board: Convert i.MX6 Sabresd README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (8 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 09/12] doc: board: Convert i.MX6 Sabreauto " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK " Peng Fan
` (2 subsequent siblings)
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
board/freescale/mx6sabresd/README | 114 -------------------------
doc/board/freescale/index.rst | 1 +
doc/board/freescale/mx6sabresd.rst | 132 +++++++++++++++++++++++++++++
3 files changed, 133 insertions(+), 114 deletions(-)
delete mode 100644 board/freescale/mx6sabresd/README
create mode 100644 doc/board/freescale/mx6sabresd.rst
diff --git a/board/freescale/mx6sabresd/README b/board/freescale/mx6sabresd/README
deleted file mode 100644
index 974b0be175..0000000000
--- a/board/freescale/mx6sabresd/README
+++ /dev/null
@@ -1,114 +0,0 @@
-How to use and build U-Boot on mx6sabresd
------------------------------------------
-
-The following methods can be used for booting mx6sabresd boards:
-
-1. Booting from SD card
-
-2. Booting from eMMC
-
-3. Booting via Falcon mode (SPL launches the kernel directly)
-
-
-1. Booting from SD card via SPL
--------------------------------
-
-mx6sabresd_defconfig target supports mx6q/mx6dl/mx6qp sabresd variants.
-
-In order to build it:
-
-$ make mx6sabresd_defconfig
-
-$ make
-
-This will generate the SPL and u-boot-dtb.img binaries.
-
-- Flash the SPL binary into the SD card:
-
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
-
-- Flash the u-boot-dtb.img binary into the SD card:
-
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
-
-
-2. Booting from eMMC
---------------------
-
-$ make mx6sabresd_defconfig
-
-$ make
-
-This will generate the SPL and u-boot-dtb.img binaries.
-
-- Boot first from SD card as shown in the previous section
-
-In U-boot change the eMMC partition config:
-
-=> mmc partconf 2 1 0 0
-
-Mount the eMMC in the host PC:
-
-=> ums 0 mmc 2
-
-- Flash SPL and u-boot-dtb.img binaries into the eMMC:
-
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
-
-Set SW6 to eMMC 8-bit boot: 11010110
-
-
-3. Booting via Falcon mode
---------------------------
-
-$ make mx6sabresd_defconfig
-$ make
-
-This will generate the SPL image called SPL and the u-boot-dtb.img.
-
-- Flash the SPL image into the SD card:
-
-$ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync
-
-- Flash the u-boot-dtb.img image into the SD card:
-
-$ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync
-
-Create a partition for root file system and extract it there:
-
-$ sudo tar xvf rootfs.tar.gz -C /media/root
-
-The SD card must have enough space for raw "args" and "kernel".
-To configure Falcon mode for the first time, on U-Boot do the following commands:
-
-- Setup the IP server:
-
-# setenv serverip <server_ip_address>
-
-- Download dtb file:
-
-# dhcp ${fdt_addr} imx6q-sabresd.dtb
-
-- Download kernel image:
-
-# dhcp ${loadaddr} uImage
-
-- Write kernel at 2MB offset:
-
-# mmc write ${loadaddr} 0x1000 0x4000
-
-- Setup kernel bootargs:
-
-# setenv bootargs "console=ttymxc0,115200 root=/dev/mmcblk1p1 rootfstype=ext4 rootwait quiet rw"
-
-- Prepare args:
-
-# spl export fdt ${loadaddr} - ${fdt_addr}
-
-- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors)
-
-# mmc write 18000000 0x800 0x800
-
-- Press KEY_VOL_UP key, power up the board and then SPL binary will
-launch the kernel directly.
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index cc079cadce..716bb1e3ac 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -15,3 +15,4 @@ Freescale
imxrt1020-evk
imxrt1050-evk
mx6sabreauto
+ mx6sabresd
diff --git a/doc/board/freescale/mx6sabresd.rst b/doc/board/freescale/mx6sabresd.rst
new file mode 100644
index 0000000000..fe15ba7b79
--- /dev/null
+++ b/doc/board/freescale/mx6sabresd.rst
@@ -0,0 +1,132 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+mx6sabresd
+==========
+
+How to use and build U-Boot on mx6sabresd
+-----------------------------------------
+
+The following methods can be used for booting mx6sabresd boards:
+
+1. Booting from SD card
+
+2. Booting from eMMC
+
+3. Booting via Falcon mode (SPL launches the kernel directly)
+
+
+1. Booting from SD card via SPL
+-------------------------------
+
+mx6sabresd_defconfig target supports mx6q/mx6dl/mx6qp sabresd variants.
+
+In order to build it:
+
+.. code-block:: bash
+
+ $ make mx6sabresd_defconfig
+ $ make
+
+This will generate the SPL and u-boot-dtb.img binaries.
+
+- Flash the SPL binary into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
+
+- Flash the u-boot-dtb.img binary into the SD card:
+
+.. code-block:: bash
+
+ $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
+
+2. Booting from eMMC
+--------------------
+
+.. code-block:: bash
+
+ $ make mx6sabresd_defconfig
+ $ make
+
+This will generate the SPL and u-boot-dtb.img binaries.
+
+- Boot first from SD card as shown in the previous section
+
+In U-boot change the eMMC partition config::
+
+ => mmc partconf 2 1 0 0
+
+Mount the eMMC in the host PC::
+
+ => ums 0 mmc 2
+
+- Flash SPL and u-boot-dtb.img binaries into the eMMC:
+
+.. code-block:: bash
+
+ $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 conv=notrunc && sync
+ $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 conv=notrunc && sync
+
+Set SW6 to eMMC 8-bit boot: 11010110
+
+3. Booting via Falcon mode
+--------------------------
+
+.. code-block:: bash
+
+ $ make mx6sabresd_defconfig
+ $ make
+
+This will generate the SPL image called SPL and the u-boot-dtb.img.
+
+- Flash the SPL image into the SD card
+
+.. code-block:: bash
+
+ $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1 oflag=sync status=none conv=notrunc && sync
+
+- Flash the u-boot-dtb.img image into the SD card
+
+.. code-block:: bash
+
+ $ sudo dd if=u-boot-dtb.img of=/dev/sdX bs=1K seek=69 oflag=sync status=none conv=notrunc && sync
+
+Create a partition for root file system and extract it there
+
+.. code-block:: bash
+
+ $ sudo tar xvf rootfs.tar.gz -C /media/root
+
+The SD card must have enough space for raw "args" and "kernel".
+To configure Falcon mode for the first time, on U-Boot do the following commands:
+
+- Setup the IP server::
+
+ # setenv serverip <server_ip_address>
+
+- Download dtb file::
+
+ # dhcp ${fdt_addr} imx6q-sabresd.dtb
+
+- Download kernel image::
+
+ # dhcp ${loadaddr} uImage
+
+- Write kernel at 2MB offset::
+
+ # mmc write ${loadaddr} 0x1000 0x4000
+
+- Setup kernel bootargs::
+
+ # setenv bootargs "console=ttymxc0,115200 root=/dev/mmcblk1p1 rootfstype=ext4 rootwait quiet rw"
+
+- Prepare args::
+
+ # spl export fdt ${loadaddr} - ${fdt_addr}
+
+- Write args 1MB data (0x800 sectors) to 1MB offset (0x800 sectors)::
+
+ # mmc write 18000000 0x800 0x800
+
+- Press KEY_VOL_UP key, power up the board and then SPL binary will launch the kernel directly.
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 10/12] doc: board: Convert i.MX6 Sabresd README to reST
2020-10-14 9:12 ` [PATCH V2 10/12] doc: board: Convert i.MX6 Sabresd " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (9 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 10/12] doc: board: Convert i.MX6 Sabresd " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:38 ` sbabic at denx.de
2020-10-14 9:12 ` [PATCH V2 12/12] doc: board: Convert i.MX6ULL " Peng Fan
2020-10-14 15:28 ` [PATCH V2 00/12] imx: doc update Tom Rini
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
doc/board/freescale/index.rst | 1 +
.../board/freescale/mx6ul_14x14_evk.rst | 62 ++++++++++++-------
2 files changed, 40 insertions(+), 23 deletions(-)
rename board/freescale/mx6ul_14x14_evk/README => doc/board/freescale/mx6ul_14x14_evk.rst (65%)
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 716bb1e3ac..046a839a52 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -16,3 +16,4 @@ Freescale
imxrt1050-evk
mx6sabreauto
mx6sabresd
+ mx6ul_14x14_evk
diff --git a/board/freescale/mx6ul_14x14_evk/README b/doc/board/freescale/mx6ul_14x14_evk.rst
similarity index 65%
rename from board/freescale/mx6ul_14x14_evk/README
rename to doc/board/freescale/mx6ul_14x14_evk.rst
index 70eb86efba..8298bf8e1e 100644
--- a/board/freescale/mx6ul_14x14_evk/README
+++ b/doc/board/freescale/mx6ul_14x14_evk.rst
@@ -1,11 +1,18 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+mx6ul_14x14_evk
+===============
+
How to use U-Boot on Freescale MX6UL 14x14 EVK
-----------------------------------------------
- Build U-Boot for MX6UL 14x14 EVK:
-$ make mrproper
-$ make mx6ul_14x14_evk_defconfig
-$ make
+.. code-block:: bash
+
+ $ make mrproper
+ $ make mx6ul_14x14_evk_defconfig
+ $ make
This will generate the SPL image called SPL and the u-boot.img.
@@ -14,35 +21,38 @@ This will generate the SPL image called SPL and the u-boot.img.
- Flash the SPL image into the micro SD card:
-sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1 conv=notrunc; sync
+.. code-block:: bash
+
+ sudo dd if=SPL of=/dev/mmcblk0 bs=1k seek=1 conv=notrunc; sync
- Flash the u-boot.img image into the micro SD card:
-sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69 conv=notrunc; sync
+.. code-block:: bash
-- Jumper settings:
+ sudo dd if=u-boot.img of=/dev/mmcblk0 bs=1k seek=69 conv=notrunc; sync
-SW601: 0 0 1 0
-Sw602: 1 0
+- Jumper settings::
+
+ SW601: 0 0 1 0
+ Sw602: 1 0
where 0 means bottom position and 1 means top position (from the
switch label numbers reference).
- Connect the USB cable between the EVK and the PC for the console.
-(The USB console connector is the one close the push buttons)
+ The USB console connector is the one close the push buttons
-- Insert the micro SD card in the board, power it up and U-Boot messages should
-come up.
+- Insert the micro SD card in the board, power it up and U-Boot messages should come up.
2. Booting via Serial Download Protocol (SDP)
---------------------------------------------
The mx6ulevk board can boot from USB OTG port using the SDP, target will
enter in SDP mode in case an SD Card is not connect or boot switches are
-set as below:
+set as below::
-Sw602: 0 1
-SW601: x x x x
+ Sw602: 0 1
+ SW601: x x x x
The following tools can be used to boot via SDP, for both tools you must
connect an USB cable in USB OTG port.
@@ -54,13 +64,15 @@ https://github.com/NXPmicro/mfgtools
The following script should be created to boot SPL + u-boot-dtb.img binaries:
- $ cat uuu_script
- uuu_version 1.1.4
+.. code-block:: bash
+
+ $ cat uuu_script
+ uuu_version 1.1.4
- SDP: boot -f SPL
- SDPU: write -f u-boot-dtb.img -addr 0x877fffc0
- SDPU: jump -addr 0x877fffc0
- SDPU: done
+ SDP: boot -f SPL
+ SDPU: write -f u-boot-dtb.img -addr 0x877fffc0
+ SDPU: jump -addr 0x877fffc0
+ SDPU: done
Please note that the address above is calculated based on SYS_TEXT_BASE address:
@@ -68,7 +80,9 @@ Please note that the address above is calculated based on SYS_TEXT_BASE address:
Power on the target and run the following command from U-Boot root directory:
- $ sudo ./uuu uuu_script
+.. code-block:: bash
+
+ $ sudo ./uuu uuu_script
- Method 2: imx usb loader tool (imx_usb):
@@ -78,5 +92,7 @@ https://github.com/boundarydevices/imx_usb_loader
Build the source code and run the following commands from U-Boot root
directory:
- $ sudo ./imx_usb SPL
- $ sudo ./imx_usb u-boot-dtb.img
+.. code-block:: bash
+
+ $ sudo ./imx_usb SPL
+ $ sudo ./imx_usb u-boot-dtb.img
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK README to reST
2020-10-14 9:12 ` [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK " Peng Fan
@ 2020-11-01 14:38 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:38 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 12/12] doc: board: Convert i.MX6ULL EVK README to reST
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (10 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 11/12] doc: board: Convert i.MX6UL 14x14 EVK " Peng Fan
@ 2020-10-14 9:12 ` Peng Fan
2020-11-01 14:39 ` sbabic at denx.de
2020-10-14 15:28 ` [PATCH V2 00/12] imx: doc update Tom Rini
12 siblings, 1 reply; 26+ messages in thread
From: Peng Fan @ 2020-10-14 9:12 UTC (permalink / raw)
To: u-boot
Convert plain text documentation to reStructuredText format and add
it to Sphinx TOC tree. No essential content change.
Signed-off-by: Peng Fan <peng.fan@nxp.com>
---
doc/board/freescale/index.rst | 1 +
.../board/freescale/mx6ullevk.rst | 29 +++++++++++++------
2 files changed, 21 insertions(+), 9 deletions(-)
rename board/freescale/mx6ullevk/README => doc/board/freescale/mx6ullevk.rst (66%)
diff --git a/doc/board/freescale/index.rst b/doc/board/freescale/index.rst
index 046a839a52..313cf409a6 100644
--- a/doc/board/freescale/index.rst
+++ b/doc/board/freescale/index.rst
@@ -17,3 +17,4 @@ Freescale
mx6sabreauto
mx6sabresd
mx6ul_14x14_evk
+ mx6ullevk
diff --git a/board/freescale/mx6ullevk/README b/doc/board/freescale/mx6ullevk.rst
similarity index 66%
rename from board/freescale/mx6ullevk/README
rename to doc/board/freescale/mx6ullevk.rst
index 47a35f61a2..a26248a1e3 100644
--- a/board/freescale/mx6ullevk/README
+++ b/doc/board/freescale/mx6ullevk.rst
@@ -1,26 +1,37 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+mx6ullevk
+=========
+
How to use U-Boot on Freescale MX6ULL 14x14 EVK
-----------------------------------------------
+-----------------------------------------------
- First make sure you have installed the dtc package (device tree compiler):
-$ sudo apt-get install device-tree-compiler
+.. code-block:: bash
+
+ $ sudo apt-get install device-tree-compiler
- Build U-Boot for MX6ULL 14x14 EVK:
-$ make mrproper
-$ make mx6ull_14x14_evk_defconfig
-$ make
+.. code-block:: bash
+
+ $ make mrproper
+ $ make mx6ull_14x14_evk_defconfig
+ $ make
This generates the u-boot-dtb.imx image in the current directory.
- Flash the u-boot-dtb.imx image into the micro SD card:
-$ sudo dd if=u-boot-dtb.imx of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
+.. code-block:: bash
+
+ $ sudo dd if=u-boot-dtb.imx of=/dev/sdb bs=1K seek=1 conv=notrunc && sync
-- Jumper settings:
+- Jumper settings::
-SW601: 0 0 1 0
-Sw602: 1 0
+ SW601: 0 0 1 0
+ Sw602: 1 0
Where 0 means bottom position and 1 means top position (from the switch label
numbers reference).
--
2.28.0
^ permalink raw reply related [flat|nested] 26+ messages in thread* [PATCH V2 12/12] doc: board: Convert i.MX6ULL EVK README to reST
2020-10-14 9:12 ` [PATCH V2 12/12] doc: board: Convert i.MX6ULL " Peng Fan
@ 2020-11-01 14:39 ` sbabic at denx.de
0 siblings, 0 replies; 26+ messages in thread
From: sbabic at denx.de @ 2020-11-01 14:39 UTC (permalink / raw)
To: u-boot
> Convert plain text documentation to reStructuredText format and add
> it to Sphinx TOC tree. No essential content change.
> Signed-off-by: Peng Fan <peng.fan@nxp.com>
Applied to u-boot-imx, master, thanks !
Best regards,
Stefano Babic
--
=====================================================================
DENX Software Engineering GmbH, Managing Director: Wolfgang Denk
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: +49-8142-66989-53 Fax: +49-8142-66989-80 Email: sbabic at denx.de
=====================================================================
^ permalink raw reply [flat|nested] 26+ messages in thread
* [PATCH V2 00/12] imx: doc update
2020-10-14 9:11 [PATCH V2 00/12] imx: doc update Peng Fan
` (11 preceding siblings ...)
2020-10-14 9:12 ` [PATCH V2 12/12] doc: board: Convert i.MX6ULL " Peng Fan
@ 2020-10-14 15:28 ` Tom Rini
12 siblings, 0 replies; 26+ messages in thread
From: Tom Rini @ 2020-10-14 15:28 UTC (permalink / raw)
To: u-boot
On Wed, Oct 14, 2020 at 05:11:58PM +0800, Peng Fan wrote:
> V2:
> Migrate README to doc/board/freescale
> patch 1 is not changed.
Thanks for doing this!
--
Tom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <https://lists.denx.de/pipermail/u-boot/attachments/20201014/d8da6aa2/attachment.sig>
^ permalink raw reply [flat|nested] 26+ messages in thread