diff mbox series

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

Message ID 20200602155536.30594-1-krjdev@gmail.com
State Superseded
Headers show
Series doc: board: xilinx: zynq.rst: add description how to flash a SD card | expand

Commit Message

Johannes Krottmayer June 2, 2020, 3:55 p.m. UTC
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?

Signed-off-by: Johannes Krottmayer <krjdev at gmail.com>
---
 doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Comments

Michal Simek June 3, 2020, 6:23 a.m. UTC | #1
On 02. 06. 20 17:55, Johannes Krottmayer wrote:
> 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.

> 
> Signed-off-by: Johannes Krottmayer <krjdev at gmail.com>
> ---
>  doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
> 
> diff --git a/doc/board/xilinx/zynq.rst b/doc/board/xilinx/zynq.rst
> index 6a09df1d15..e5f002af85 100644
> --- a/doc/board/xilinx/zynq.rst
> +++ b/doc/board/xilinx/zynq.rst
> @@ -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

here should be /dev/sdx0

> +        sudo cp spl/boot.bin /mnt
> +        sudo cp u-boot.img /mnt
> +
>  Mainline status
>  ---------------
>  
> 

Thanks,
Michal
Johannes Krottmayer June 3, 2020, 9:01 a.m. UTC | #2
On 03.06.20 at 08:23,  Michal Simek wrote:
> On 02. 06. 20 17:55, Johannes Krottmayer wrote:
>> 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.

Thanks!

>>
>> Signed-off-by: Johannes Krottmayer <krjdev at gmail.com>
>> ---
>>  doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
>>  1 file changed, 19 insertions(+)
>>
>> diff --git a/doc/board/xilinx/zynq.rst b/doc/board/xilinx/zynq.rst
>> index 6a09df1d15..e5f002af85 100644
>> --- a/doc/board/xilinx/zynq.rst
>> +++ b/doc/board/xilinx/zynq.rst
>> @@ -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
> 
> 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?

>> +        sudo cp spl/boot.bin /mnt
>> +        sudo cp u-boot.img /mnt
>> +
>>  Mainline status
>>  ---------------
>>  
>>
> 
> Thanks,
> Michal
> 

Kind regards,
Johannes K.
Michal Simek June 3, 2020, 9:06 a.m. UTC | #3
On 03. 06. 20 11:01, Johannes Krottmayer wrote:
> On 03.06.20 at 08:23,  Michal Simek wrote:
>> On 02. 06. 20 17:55, Johannes Krottmayer wrote:
>>> 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.
> 
> Thanks!
> 
>>>
>>> Signed-off-by: Johannes Krottmayer <krjdev at gmail.com>
>>> ---
>>>  doc/board/xilinx/zynq.rst | 19 +++++++++++++++++++
>>>  1 file changed, 19 insertions(+)
>>>
>>> diff --git a/doc/board/xilinx/zynq.rst b/doc/board/xilinx/zynq.rst
>>> index 6a09df1d15..e5f002af85 100644
>>> --- a/doc/board/xilinx/zynq.rst
>>> +++ b/doc/board/xilinx/zynq.rst
>>> @@ -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
>>
>> 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?


grr. yes 1 of course.

M
diff mbox series

Patch

diff --git a/doc/board/xilinx/zynq.rst b/doc/board/xilinx/zynq.rst
index 6a09df1d15..e5f002af85 100644
--- a/doc/board/xilinx/zynq.rst
+++ b/doc/board/xilinx/zynq.rst
@@ -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
 ---------------