Skip to contentSkip to conversation

doc: board: xilinx: zynq.rst: add description how to flash a SD card

PATCH New Johannes Krottmayer 2 participants 6 messages Jun 2, 2020 – Jun 4, 2020 Arm/Zynq architecture

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

---
 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +19 -0
index 6a09df1d15..e5f002af85 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
+        sudo mkfs.vfat -F 32 /dev/sdx1
+
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx /mnt
+        sudo cp spl/boot.bin /mnt
+        sudo cp u-boot.img /mnt
+
 Mainline status
 ---------------
 
Signature · 1 line
2.26.2
#1 lore raw

PATCH 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Quoted 7 lines · Johannes Krottmayer

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

remove these 4 lines above from commit message and move it below ---.

And no problem to extend documentation for newcomers.

Quoted 20 lines
---
 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +6 -0
index 6a09df1d15..e5f002af85 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 78

Quoted 10 lines
doc/board/xilinx/zynq.rst +10 -0
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
+        sudo mkfs.vfat -F 32 /dev/sdx1
+
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx /mnt

here should be /dev/sdx0

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 84

Quoted 7 lines
doc/board/xilinx/zynq.rst +3 -0
+        sudo cp spl/boot.bin /mnt
+        sudo cp u-boot.img /mnt
+
 Mainline status
 ---------------
 

Thanks,
Michal

#2 lore raw

PATCH 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Quoted 4 lines · Michal Simek
Quoted 3 lines · Johannes Krottmayer

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

Quoted 8 lines
Quoted 4 lines

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

remove these 4 lines above from commit message and move it below ---.

And no problem to extend documentation for newcomers.

Thanks!

Quoted 24 lines
Quoted 24 lines
---
 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +10 -0
index 6a09df1d15..e5f002af85 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
Quoted 9 lines

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 78

Quoted 6 lines
doc/board/xilinx/zynq.rst +6 -0
+        sudo mkfs.vfat -F 32 /dev/sdx1
+
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx /mnt

here should be /dev/sdx0

Oops, sorry! But "/dev/sdx1" should be correct according to command "sudo mkfs.vfat -F 32 /dev/sdx1".

At least on my used system. Typo?

Quoted 11 lines

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 84

Quoted 7 lines
doc/board/xilinx/zynq.rst +3 -0
+        sudo cp spl/boot.bin /mnt
+        sudo cp u-boot.img /mnt
+
 Mainline status
 ---------------
 

Thanks,
Michal

Kind regards,
Johannes K.

#3 lore raw

PATCH 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Quoted 50 lines · Johannes Krottmayer
Quoted 4 lines · Michal Simek
Quoted 3 lines · Johannes Krottmayer

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

Quoted 8 lines
Quoted 4 lines

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

remove these 4 lines above from commit message and move it below ---.

And no problem to extend documentation for newcomers.

Thanks!

Quoted 24 lines
Quoted 24 lines
---
 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +10 -0
index 6a09df1d15..e5f002af85 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
Quoted 9 lines

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 78

Quoted 6 lines
doc/board/xilinx/zynq.rst +6 -0
+        sudo mkfs.vfat -F 32 /dev/sdx1
+
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx /mnt

here should be /dev/sdx0

Quoted 4 lines

Oops, sorry! But "/dev/sdx1" should be correct according to command "sudo mkfs.vfat -F 32 /dev/sdx1".

At least on my used system. Typo?

grr. yes 1 of course.

M

#4 lore raw

PATCH v2 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

---
Changes for v2
- added missing partition number in mount command

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +19 -0
index 6a09df1d15..f564434b69 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
+        sudo mkfs.vfat -F 32 /dev/sdx1
+
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx1 /mnt
+        sudo cp spl/boot.bin /mnt
+        sudo cp u-boot.img /mnt
+
 Mainline status
 ---------------
 
Signature · 1 line
2.26.2
Applied
#5 lore raw

PATCH v2 1/1 doc: board: xilinx: zynq.rst: add description how to flash a SD card

Quoted 38 lines · Johannes Krottmayer

Add a short description in the ZYNQ documentation how to prepare a SD card and copy the related images to SD card.

---
Changes for v2
- added missing partition number in mount command

I think, it's necessary for the documentation to avoid such user questions (like mine) in this list.

Okay?

 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
doc/board/xilinx/zynq.rst +12 -0
index 6a09df1d15..f564434b69 100644
@@ -60,6 +60,25 @@ SLCR bootmode register Bit[3:0] values
 "modeboot" variable can assign any of "norboot", "sdboot" or "jtagboot"
 bootmode strings at runtime.
 
+Flashing
+--------
+
+SD Card
+^^^^^^^
+
+To write an image that boots from a SD card first create a FAT32 partition
+and a FAT32 filesystem on the SD card::
+
+        sudo fdisk /dev/sdx
+        sudo mkfs.vfat -F 32 /dev/sdx1
+

doc/board/xilinx/zynq.rst SLCR bootmode register Bit[3:0] values · line 84

Quoted 10 lines
doc/board/xilinx/zynq.rst +7 -0
+Mount the SD card and copy the SPL and U-Boot to the root directory of the
+SD card::
+
+        sudo mount -t vfat /dev/sdx1 /mnt
+        sudo cp spl/boot.bin /mnt
+        sudo cp u-boot.img /mnt
+
 Mainline status
 ---------------
 

Applied.
M