diff --git a/boards/pocketbeagle2/01-introduction.rst b/boards/pocketbeagle2/01-introduction.rst
index bfae90eb8ff40cc7f77499e8abe9f3e0925e4878..67b575c752d942f53032d00e6adee6e6ac7a77e6 100644
--- a/boards/pocketbeagle2/01-introduction.rst
+++ b/boards/pocketbeagle2/01-introduction.rst
@@ -4,8 +4,8 @@ Introduction
###############
PocketBeagle2 is based on `Texas Instrments AM6232 SoC <https://www.ti.com/product/AM623>`_, it's dual A53 cores can
-provides more than double the performance of the classic PocketBeagle. The new design comes with pre-soldered headers, 3-pin
-JST-SH 1.00mm uart debug port, USB-C port, MSPM0L1105, 512MB RAM, LiPo Battery charger, and optional eMMC storage.
+provides more than double the performance of the classic PocketBeagle. The new design comes with pre-soldered headers,
+3-pin JST-SH 1.00mm uart debug port, USB-C port, MSPM0L1105, 512MB RAM, LiPo Battery charger, and optional eMMC storage.
.. table::
:align: center
@@ -28,7 +28,7 @@ The board is intended to provide functionality well beyond classic PocketBeagle,
while still providing compatibility with PocketBeagle's expansion headers as
much as possible. There are several significant differences between the designs.
-.. _beaglebone-comparison-table, BeagleBone comparison:
+.. _pocketbeagle-comparison-table, PocketBeagle comparison:
.. table:: Table: PocketBeagle comparison
@@ -58,9 +58,38 @@ PocketBeagle2 Features and Specification
This section covers the specifications and features of the board and provides a high level
description of the major components and interfaces that make up the board.
-.. _ai64-features,PocketBeagle2 features tabled:
-
-.. todo:: Add Table: PocketBeagle2 Features and Specification
+.. _pocketbeagle2-features,PocketBeagle2 features tabled:
+
+.. table:: Table: PocketBeagle2 Features and Specification
+
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | | Feature |
+ +=========================+=========================================================================================================================================+
+ | **Processor** | `Texas Instruments AM6232 <https://www.ti.com/product/AM623>`_ |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **SDRAM Memory** | LPDDR4 3200MHz (512MB) Kingston D2516AN9EXGXN-TU |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **Onboard Flash** | eMMC (2GB) Kingston EMMC04G-MT32-01G10 |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **PMIC** | TPS6521903 |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **Debug Support** | 3 pin 3.3V JST-SH 1.00mm UART debug port (RPI debug probe compatible) |
+ + +-----------------------------------------------------------------------------------------------------------------------------------------+
+ | | 10-pin JTAG TAG-CONNECT footprint |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **Power Source** | USB C or Cape Header VIN (5V @ 1A) |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **PCB** | 55 x 35 mm |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **Indicators** | 1x Power, 1x Battery charging, and 4x User Controllable LEDs |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **SD/MMC Connector** | microSD (1.8/3.3V) |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **User Input** | 1. Power Button |
+ | | 2. User/Boot Button |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
+ | **Weight** | 12.7gm |
+ +-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
.. _pocketbeagle2-component-locations:
diff --git a/boards/pocketbeagle2/02-quick-start.rst b/boards/pocketbeagle2/02-quick-start.rst
new file mode 100644
index 0000000000000000000000000000000000000000..4e577c5345cfb99a7e2cd98e883a4791a2b0611a
--- /dev/null
+++ b/boards/pocketbeagle2/02-quick-start.rst
@@ -0,0 +1,53 @@
+.. _pocketbeagle2-quick-start:
+
+Quick Start Guide
+##################
+
+This section provides instructions on how to hook up your board. This Beagle requires a 5V @ 1A (5W)
+power supply to work properly via either USB Type-C power adapter or via cape header pins.
+
+Recommended adapters can be found at :ref:`accessories-power-supplies` section.
+
+.. _pocketbeagle2-whats-in-the-box:
+
+What’s In the Box
+*******************
+
+In the box you will find two main items,
+
+* `PocketBeagle2 <https://www.beagleboard.org/boards/pocketbeagle2>`_
+* Instruction card
+
+.. note::
+
+ A USB-C to USB-C / USB-A to USB-C cable is not included, but recommended for the tethered scenario and creates
+ a developer experience where the board can be used immediately with no other equipment needed.
+
+.. tip::
+
+ For board files, 3D model, and more, you can checkout
+ `PocketBeagle2 repository on OpenBeagle <https://openbeagle.org/pocketbeagle/pocketbeagle-2>`_.
+
+.. todo:: Add picture of PocketBeagle2 box content
+
+Methods of operation
+*********************
+
+1. Directly tethered to a PC via USB-C port.
+2. With techlab cape for sesors, USB host, LEDs and Buttons.
+
+.. _pocketbeagle2-main-connection-scenarios:
+
+Main Connection Scenarios
+============================
+
+This section describes how to connect and power the board and serves as a slightly more detailed
+description of the Quick Start Guide included in the box. The board can be configured in several
+different ways, but we will discuss the two most common scenarios.
+
+* Tethered to a PC via the USB cable
+* Attached to a cape like techlab cape
+
+.. todo:: Add connection information in detail
+
+
diff --git a/boards/pocketbeagle2/03-design-and-specifications.rst b/boards/pocketbeagle2/03-design-and-specifications.rst
new file mode 100644
index 0000000000000000000000000000000000000000..8d3132ec322a7d1592a3d67d5c30e3ca298d4a7c
--- /dev/null
+++ b/boards/pocketbeagle2/03-design-and-specifications.rst
@@ -0,0 +1,144 @@
+.. _pocketbeagle2-design:
+
+Design and Specifications
+##########################
+
+If you want to know how PocketBeagle2 is designed and the detailed specifications, then
+this chapter is for you. We are going to attept to provide you a short and crisp overview
+followed by discussing each hardware design element in detail.
+
+Block Diagram and Overview
+**************************
+
+.. todo:: Add block diagram
+
+.. _pocketbeagle2-processor:
+
+System on Chip (SoC)
+*********************
+
+.. _pocketbeagle2-boot-modes:
+
+Boot Modes
+===========
+
+.. _pocketbeagle2-power-management:
+
+Power Management
+*****************
+
+
+PMIC
+====
+
+.. _pocketbeagle2-connectivity-and-expansion:
+
+General connectivity and expansion
+************************************
+
+USB type C
+===========
+
+Cape headers
+=============
+
+P1 cape header
+---------------
+
+P2 cape header
+---------------
+
+Double pins (shorted)
+---------------------
+
+MicroSD Connector
+=================
+
+.. todo:: Add MicroSD card slot information
+
+Buttons & LEDs
+***************
+
+User & Power Button
+=====================
+
+
+.. todo:: Add button details
+
+LED Indicators
+===============
+
+.. todo:: Add information about LED indicators
+
+
+.. _pocketbeagle2-memory-media-storage:
+
+Memory, Media, and storage
+***************************
+
+Described in the following sections are the three memory devices found on the board.
+.. _pocketbeagle2-gb-embedded-mmc:
+
+4GB Embedded MMC
+=================
+
+.. _pocketbeagle2-4gb-ddr4:
+
+512MB LPDDR4
+==============
+
+.. _pocketbeagle2-4kb-eeprom:
+
+MSPM0 ADC & EEPROM
+==================
+
+.. _pocketbeagle2-debug-ports:
+
+Debug Ports
+************
+
+Serial debug ports
+===================
+
+
+TagConnect
+===========
+
+
+Mechanical specifications
+**************************
+
+Dimensions & Weight
+====================
+
+.. table:: Dimensions & weight
+
+ +--------------------+----------------------------------------------------+
+ | Parameter | Value |
+ +====================+====================================================+
+ | Size | 56 x 35mm |
+ +--------------------+----------------------------------------------------+
+ | Max heigh | 13.6 |
+ +--------------------+----------------------------------------------------+
+ | PCB Size | 55 x 35mm |
+ +--------------------+----------------------------------------------------+
+ | PCB Layers | 10--layers |
+ +--------------------+----------------------------------------------------+
+ | PCB Thickness | 1.6mm |
+ +--------------------+----------------------------------------------------+
+ | RoHS compliant | Yes |
+ +--------------------+----------------------------------------------------+
+ | Net Weight | 12.7g |
+ +--------------------+----------------------------------------------------+
+ | Gross Weight | 19g |
+ +--------------------+----------------------------------------------------+
+
+
+Board Dimensions
+=================
+
+.. figure:: images/pocketbeagle2-revA-dimensions.jpg
+ :align: center
+ :alt: PocketBeagle2 RevA Dimensions
+
+ PocketBeagle2 RevA Dimensions
diff --git a/boards/pocketbeagle2/04-expansion.rst b/boards/pocketbeagle2/04-expansion.rst
new file mode 100644
index 0000000000000000000000000000000000000000..2d37c087522d39d010d4142f66c2f52c09e172ed
--- /dev/null
+++ b/boards/pocketbeagle2/04-expansion.rst
@@ -0,0 +1,195 @@
+.. _pocketbeagle2-expansion:
+
+Expansion
+############
+
+.. _pocketbeagle2-pinout-diagrams:
+
+Pinout Diagrams
+***************
+
+PocketBeagle2 P1 & P2 cape headers are designed to be compatible with PocketBeagle classic as much as possible.
+Below pinout diagrams are design to simplify cape header pin usage and cape design process for PB2. To start
+using P1 / P2 cape header choose respective pinout diagram tab below.
+
+.. tab-set::
+
+ .. tab-item:: P1 cape header
+
+ .. todo: Add PB2 P1 cape header pinout
+
+ .. tab-item:: P2 cape header
+
+ .. todo: Add PB2 P2 cape header pinout
+
+.. _pocketbeagle2-connectors:
+
+Cape Header Connectors
+**********************
+
+Beagle cape expansion interface on the PocketBeagle2 like other Beagles is comprised of two
+headers P1 & P2. All signals on the expansion headers are **3.3V** unless
+otherwise indicated. **On some of the cape header pins on PocketBeagle2 multiple SoC pins are shorted and
+only one of them should be used at a time.** Information regarding the double/shorted pins is provided
+in the :ref:`pocketbeagle2-pinout-diagrams` above (simplified) and cape header pin tables below (detailed).
+
+.. danger::
+ Do not connect 5V logic level signals to these pins or the board will be damaged.
+
+ **NO PINS ARE TO BE DRIVEN UNTIL AFTER THE SYS_RESET LINE GOES HIGH. DO NOT APPLY
+ VOLTAGE TO ANY I/O PIN WHEN POWER IS NOT SUPPLIED TO THE BOARD.
+ IT WILL DAMAGE THE PROCESSOR AND VOID THE WARRANTY.**
+
+Connector P1
+==============
+
+The following tables show the pinout of the **P1** expansion header. The
+SW is responsible for setting the default function of each pin. Refer to
+the processor documentation for more information on these pins and
+detailed descriptions of all of the pins listed. In some cases there may
+not be enough signals to complete a group of signals that may be
+required to implement a total interface.
+
+The column heading is the pin number on the expansion header.
+
+The **GPIO** row is the expected gpio identifier number in the Linux
+kernel.
+
+Each row includes the gpiochipX and pinY in the format of
+`X Y`. You can use these values to directly control the GPIO pins with the
+commands shown below.
+
+.. code:: bash
+
+ # to set the GPIO pin state to HIGH
+ debian@BeagleBone:~$ gpioset X Y=1
+
+ # to set the GPIO pin state to LOW
+ debian@BeagleBone:~$ gpioset X Y=0
+
+ For Example:
+
+ +---------+----------+
+ | Pin | P1.03 |
+ +=========+==========+
+ | GPIO | 1 20 |
+ +---------+----------+
+
+ Use the commands below for controlling this pin (P1.03) where X = 1 and Y = 20
+
+ # to set the GPIO pin state to HIGH
+ debian@BeagleBone:~$ gpioset 1 20=1
+
+ # to set the GPIO pin state to LOW
+ debian@BeagleBone:~$ gpioset 1 20=0
+
+The **BALL** row is the pin number on the processor.
+
+The **REG** row is the offset of the control register for the processor
+pin.
+
+The **MODE #** rows are the mode setting for each pin. Setting each mode
+to align with the mode column will give that function on that pin.
+
+
+.. important::
+
+ **DO NOT APPLY VOLTAGE TO ANY I/O PIN WHEN POWER IS NOT SUPPLIED TO THE
+ BOARD. IT WILL DAMAGE THE PROCESSOR AND VOID THE WARRANTY.**
+
+ **NO PINS ARE TO BE DRIVEN UNTIL AFTER THE SYS_RESET LINE GOES HIGH.**
+
+P1.02-P1.03
+-------------
+
++------------+--------------------------+-----------------+------------------+
+| Pin | P1.02 | P1.02A | P1.03 |
++============+==========================+=================+==================+
+| GPIO | 1 10 | 0 87 | 1 51 |
++------------+--------------------------+-----------------+------------------+
+| BALL | E18 | AA19 | F18 |
++------------+--------------------------+-----------------+------------------+
+| REG | MCASP0_AXR0 | RGMII2_TX_CTL | USB1_DRVVBUS |
++------------+--------------------------+-----------------+------------------+
+
+
+P1.04-P1.06
+-------------
+
++------------+------------------+------------------+------------------+------------------+
+| Pin | P1.04 | P1.04A | P1.06 | P1.06A |
++============+==================+==================+==================+==================+
+| GPIO | 1 12 | 0 89 | 1 13 | 0 78 |
++------------+------------------+------------------+------------------+------------------+
+| BALL | D20 | Y18 | E19 | AD18 |
++------------+------------------+------------------+------------------+------------------+
+| REG | MCASP0_AFSX | RGMII2_TD0 | MCASP0_AFSR | RGMII1_TD3 |
++------------+------------------+------------------+------------------+------------------+
+
+.. todo:: Add complete P1 cape header pin tables
+
+Connector P2
+==============
+
+The following tables show the pinout of the **P2** expansion header. The
+SW is responsible for setting the default function of each pin. Refer to
+the processor documentation for more information on these pins and
+detailed descriptions of all of the pins listed. In some cases there may
+not be enough signals to complete a group of signals that may be
+required to implement a total interface.
+
+The column heading is the pin number on the expansion header.
+
+The **GPIO** row is the expected gpio identifier number in the Linux
+kernel.
+
+Each row includes the gpiochipX and pinY in the format of
+`X Y`. You can use these values to directly control the GPIO pins with the
+commands shown below.
+
+.. code:: bash
+
+ # to set the GPIO pin state to HIGH
+ debian@BeagleBone:~$ gpioset X Y=1
+
+ # to set the GPIO pin state to LOW
+ debian@BeagleBone:~$ gpioset X Y=0
+
+ For Example:
+
+ +---------+----------+
+ | Pin | P2.11 |
+ +=========+==========+
+ | GPIO | 1 1 |
+ +---------+----------+
+
+ Use the commands below for controlling this pin (P2.11) where X = 1 and Y = 1
+
+ # to set the GPIO pin state to HIGH
+ debian@BeagleBone:~$ gpioset 1 20=1
+
+ # to set the GPIO pin state to LOW
+ debian@BeagleBone:~$ gpioset 1 20=0
+
+The **BALL** row is the pin number on the processor.
+
+The **REG** row is the offset of the control register for the processor
+pin.
+
+The **MODE #** rows are the mode setting for each pin. Setting each mode
+to align with the mode column will give that function on that pin.
+
+If included, the **2nd BALL** row is the pin number on the processor for
+a second processor pin connected to the same pin on the expansion
+header. Similarly, all row headings starting with **2nd** refer to data
+for this second processor pin.
+
+.. important::
+
+ **DO NOT APPLY VOLTAGE TO ANY I/O PIN WHEN POWER IS NOT SUPPLIED TO THE
+ BOARD. IT WILL DAMAGE THE PROCESSOR AND VOID THE WARRANTY.**
+
+ **NO PINS ARE TO BE DRIVEN UNTIL AFTER THE SYS_RESET LINE GOES HIGH.**
+
+
+.. todo:: Add P2 cape header pin details.
diff --git a/boards/pocketbeagle2/06-support.rst b/boards/pocketbeagle2/06-support.rst
index 28383216c9c9a0c0be5ba394f95870546ece0651..9748ec1d267ba60b412a58ef10c1bc0a0dffc94b 100644
--- a/boards/pocketbeagle2/06-support.rst
+++ b/boards/pocketbeagle2/06-support.rst
@@ -20,7 +20,7 @@ Export designations
* EUHSCODE: 8543709099
* UPC number: 841454123484
-.. _hardware-design:
+.. _pocketbeagle2-hardware-design:
Hardware Design
****************
@@ -33,7 +33,7 @@ Production board boot media
.. todo:: Add production image link with board revision information.
-.. _software-updates:
+.. _pocketbeagle2-software-updates:
Software Updates
******************
@@ -58,9 +58,9 @@ It should look something like as shown in example below,
.. code-block:: shell
root@BeagleBone:~# cat /etc/dogtag
- BeagleBoard.org Debian Bullseye Xfce Image 2022-01-14
+ BeagleBoard.org Debian Image 2024-02-24
-.. _rma-support:
+.. _pocketbeagle2-rma-support:
RMA Support
*****************
@@ -71,7 +71,7 @@ revision of the board. The serial numbers and revisions keep moving. Different b
locations depending on when they were made. The following figures show the three locations of the serial
and revision number.
-.. _getting-help:
+.. _pocketbeagle2-getting-help:
Getting Help
**************
@@ -84,7 +84,7 @@ queries on link: `BeagleBoard.org forum <https://forum.beagleboard.org/tag/pocke
Mechanical Details
******************
-.. _dimensions-and-weight:
+.. _pocketbeagle2-dimensions-and-weight:
Dimensions and Weight
======================
@@ -106,9 +106,9 @@ Dimensions and Weight
+--------------------+----------------------------------------------------+
| RoHS compliant | Yes |
+--------------------+----------------------------------------------------+
- | Gross Weight | 19g |
- +--------------------+----------------------------------------------------+
| Net Weight | 12.7g |
+--------------------+----------------------------------------------------+
+ | Gross Weight | 19g |
+ +--------------------+----------------------------------------------------+
diff --git a/boards/pocketbeagle2/images/pocketbeagle2-revA-dimensions.jpg b/boards/pocketbeagle2/images/pocketbeagle2-revA-dimensions.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b4a9ffaa22e3fc3ec50506d6a9182e61a6f47102
Binary files /dev/null and b/boards/pocketbeagle2/images/pocketbeagle2-revA-dimensions.jpg differ