All of lore.kernel.org
 help / color / mirror / Atom feed
From: Johan Jonker <jbx6244@gmail.com>
To: u-boot@0leil.net
Cc: kever.yang@rock-chips.com, sjg@chromium.org, trini@konsulko.com,
	u-boot@lists.u-boot-project.org, eddie.cai.linux@gmail.com
Subject: [PATCH v3 06/12] rockchip: doc: add more eMMC program examples
Date: Thu, 30 Jul 2026 15:34:37 +0200	[thread overview]
Message-ID: <44039d61-ca43-4f12-8051-66fcbe0ce5a3@gmail.com> (raw)
In-Reply-To: <5aed2a27-bd7d-4b71-a6c1-0b46b41f3462@gmail.com>

There are more tools that can program a eMMC.
Add more eMMC program examples.

Signed-off-by: Johan Jonker <jbx6244@gmail.com>
---

Changed V3:
use eMMC
use list per example
mention loader matching to SoC
---
 doc/board/rockchip/rockchip.rst | 47 +++++++++++++++++++++------------
 1 file changed, 30 insertions(+), 17 deletions(-)

diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst
index af5c00591234..c089419b65e5 100644
--- a/doc/board/rockchip/rockchip.rst
+++ b/doc/board/rockchip/rockchip.rst
@@ -393,36 +393,49 @@ To write an image that boots from a SD card (assumed to be /dev/sda):
 eMMC
 """"

-eMMC flash would probe on mmc0 in most of the Rockchip platforms.
+* Program example with fastboot for rk3399 and full U-Boot:

-Create GPT partition layout as defined in $partitions:
+  eMMC flash would probe on mmc0 in most of the Rockchip platforms.

-.. code-block:: bash
+  Create GPT partition layout as defined in $partitions:

-        mmc dev 0
-        gpt write mmc 0 $partitions
+  .. code-block:: bash

-Connect the USB-OTG cable between the host and a target device.
+          mmc dev 0
+          gpt write mmc 0 $partitions

-Launch fastboot on the target with:
+  Connect the USB-OTG cable between the host and a target device.

-.. code-block:: bash
+  Launch fastboot on the target with:

-        fastboot 0
+  .. code-block:: bash

-Upon a successful gadget connection the host shows the USB device with:
+          fastboot 0

-.. code-block:: bash
+  Upon a successful gadget connection the host shows the USB device with:

-        lsusb
-        # Bus 001 Device 020: ID 2207:330c Fuzhou Rockchip Electronics Company RK3399 in Mask ROM mode
+  .. code-block:: bash

-Program the flash with:
+          lsusb
+          # Bus 001 Device 020: ID 2207:330c Fuzhou Rockchip Electronics Company RK3399 in Mask ROM mode

-.. code-block:: bash
+  Program the flash with:
+
+  .. code-block:: bash
+
+          sudo fastboot -i 0x2207 flash loader1 idbloader.img
+          sudo fastboot -i 0x2207 flash loader2 u-boot.itb
+
+* Program example with rkdeveloptool for rk3308 in BootROM mode:
+
+  Use a loader binary that matches the SoC.
+
+  .. code-block:: bash

-        sudo fastboot -i 0x2207 flash loader1 idbloader.img
-        sudo fastboot -i 0x2207 flash loader2 u-boot.itb
+          rkdeveloptool db rk3308_loader_v1.26.117.bin
+          rkdeveloptool wl 0x40 idbloader.img
+          rkdeveloptool wl 0x4000 u-boot.itb
+          rkdeveloptool rd

 Note:

--
2.39.5


  parent reply	other threads:[~2026-07-30 13:34 UTC|newest]

Thread overview: 36+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-07-30 13:29 [PATCH v3 00/12] doc: clean up README.rockchip Johan Jonker
2026-07-30 13:32 ` [PATCH v3 01/12] rockchip: scripts: remove rkmux.py Johan Jonker
2026-07-30 15:43   ` Quentin Schulz
2026-07-30 13:33 ` [PATCH v3 02/12] rockchip: doc: change TPL phrase Johan Jonker
2026-07-30 15:54   ` Quentin Schulz via U-Boot
2026-07-30 13:33 ` [PATCH v3 03/12] rockchip: doc: add BootROM mode text Johan Jonker
2026-07-31  7:47   ` Jonas Karlman
2026-07-30 13:33 ` [PATCH v3 04/12] rockchip: doc: remove TODO Johan Jonker
2026-07-30 13:34 ` [PATCH v3 05/12] rockchip: doc: add more building instructions Johan Jonker
2026-07-30 13:34 ` Johan Jonker [this message]
2026-07-31  8:20   ` [PATCH v3 06/12] rockchip: doc: add more eMMC program examples Jonas Karlman
2026-07-30 13:34 ` [PATCH v3 07/12] rockchip: doc: add boot medium layout text Johan Jonker
2026-07-31  8:32   ` Jonas Karlman
     [not found]     ` <jonas@kwiboo.se>
2026-07-31 15:10       ` Stefan Monnier
2026-07-31 18:01         ` Jonas Karlman
2026-08-04 15:38       ` [PATCH 1/9] ram: rockchip: rk3568: Simplify get_info() ops Stefan Monnier
2026-08-04 18:53         ` Jonas Karlman
2026-07-30 13:35 ` [PATCH v3 08/12] rockchip: tools: add comment section to rksd.c Johan Jonker
2026-07-31  8:41   ` Jonas Karlman
2026-07-30 13:35 ` [PATCH v3 09/12] rockchip: tools: add comment section to rkspi.c Johan Jonker
2026-07-31  8:51   ` Jonas Karlman
2026-07-30 13:35 ` [PATCH v3 10/12] rockchip: tools: add comment section to rkimage.c Johan Jonker
2026-07-30 13:36 ` [PATCH v3 11/12] rockchip: doc: rockusb: remove refer to README.rockchip Johan Jonker
2026-07-30 13:36 ` [PATCH v3 12/12] rockchip: doc: remove README.rockchip Johan Jonker
  -- strict thread matches above, loose matches on Subject: below --
2026-08-04 10:57 [PATCH 0/9] rockchip: Remove unneeded syscon driver for RK35xx Jonas Karlman
2026-08-04 10:57 ` [PATCH 1/9] ram: rockchip: rk3568: Simplify get_info() ops Jonas Karlman
2026-08-04 10:57 ` [PATCH 2/9] ram: rockchip: rk3588: " Jonas Karlman
2026-08-04 10:57 ` [PATCH 3/9] video: rockchip: dw_mipi_dsi: Get GRF base address from phandle Jonas Karlman
2026-08-04 10:57 ` [PATCH 4/9] rockchip: rk3568: Remove unneeded syscon driver Jonas Karlman
2026-08-04 10:57 ` [PATCH 5/9] rockchip: rk3588: " Jonas Karlman
2026-08-04 10:57 ` [PATCH 6/9] rockchip: rk3576: " Jonas Karlman
2026-08-04 10:57 ` [PATCH 7/9] rockchip: rk3528: " Jonas Karlman
2026-08-04 10:57 ` [PATCH 8/9] rockchip: rk3506: " Jonas Karlman
2026-08-04 10:57 ` [PATCH 9/9] rockchip: include: Remove unused ROCKCHIP_SYSCON_x enum values Jonas Karlman
2026-08-04 19:19 ` [PATCH 0/9] rockchip: Remove unneeded syscon driver for RK35xx Simon Glass
2026-08-04 19:57   ` Jonas Karlman

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=44039d61-ca43-4f12-8051-66fcbe0ce5a3@gmail.com \
    --to=jbx6244@gmail.com \
    --cc=eddie.cai.linux@gmail.com \
    --cc=kever.yang@rock-chips.com \
    --cc=sjg@chromium.org \
    --cc=trini@konsulko.com \
    --cc=u-boot@0leil.net \
    --cc=u-boot@lists.u-boot-project.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.