From 84c87ea5673afafe3c4353bb57927e752ad6a47a Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Sun, 19 Jan 2025 03:09:09 +0530
Subject: [PATCH] Add microSD card creation steps

---
 boards/pocketbeagle-2/02-quick-start.rst | 57 ++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/boards/pocketbeagle-2/02-quick-start.rst b/boards/pocketbeagle-2/02-quick-start.rst
index 31057b46..f7124ca2 100644
--- a/boards/pocketbeagle-2/02-quick-start.rst
+++ b/boards/pocketbeagle-2/02-quick-start.rst
@@ -30,6 +30,63 @@ In the box you will find two main items,
 
 .. todo:: Add picture of PocketBeagle 2 box content
 
+Creating bootable microSD card
+*******************************
+
+To get started with creating a bootable microSD card, you need folloiwing items,
+
+1. Up to date `bb-imager-rs <https://openbeagle.org/ayush1325/bb-imager-rs/>`_
+2. microSD card (8GB or larger)
+
+.. tip::
+
+   If required you can manually download the image from 
+   `beagleboard.org distros page <https://www.beagleboard.org/distros/>`_, for example,
+   https://www.beagleboard.org/distros/pocketbeagle2-debian-12-9-2025-01-15-minimal
+
+   .. figure:: images/distro/pocketbeagle-2-distro-selection.png
+      :align: center
+      :alt: Distro selection
+
+      Distros selection
+
+To begin you have to select PocketBeagle 2 from the list of boards, 
+then select the image you want to flash, and finally select the microSD card.
+After doing this you have to select the config button to configure the image 
+and then click on the flash button to start the flashing process.
+
+.. figure:: images/distro/bb-imager-selection.png
+   :align: center
+   :alt: Board and image selection
+
+   Board and image selection
+
+Below image shows the configuration options available for the image.
+
+.. figure:: images/distro/bb-imager-config.png
+   :align: center
+   :alt: Configuration options
+
+   Configuration options
+
+Make sure to select the correct microSD card and click on the flash button to start the flashing process.
+
+.. figure:: images/distro/bb-imager-flashing.png
+   :align: center
+   :alt: Flashing in progress
+
+   Flashing in progress
+
+Once the flashing is done, you will see the following screen.
+
+.. figure:: images/distro/bb-imager-flashing-done.png
+   :align: center
+   :alt: Flashing done
+
+   Flashing done
+
+Your microSD card is now ready to boot the PocketBeagle 2.
+
 Methods of operation
 *********************
 
-- 
GitLab