diff --git a/boards/beagley/ai/05-demos.rst b/boards/beagley/ai/05-demos.rst
index ea2a23a185b12dadfb873f234c14c13555f528ee..0733a57ae75027fb5ebf5f02730de2286bc33878 100644
--- a/boards/beagley/ai/05-demos.rst
+++ b/boards/beagley/ai/05-demos.rst
@@ -9,6 +9,7 @@ Demos and tutorials
demos/beagley-ai-using-gpio
demos/beagley-ai-using-pwm
demos/beagley-ai-using-rtc
+ demos/beagley-ai-using-i2c-oled-display
demos/beagley-ai-pca9685-motor-drivers
demos/beagley-ai-expansion-nvme
demos/beagley-ai-using-imx219-csi-cameras
diff --git a/boards/beagley/ai/demos/beagley-ai-expansion-nvme.rst b/boards/beagley/ai/demos/beagley-ai-expansion-nvme.rst
index 3f1988c0ddb53a99c69ad6dd75003b42d48e3eab..5a0588a25f604a9ee1048c56523d6615899a318e 100644
--- a/boards/beagley/ai/demos/beagley-ai-expansion-nvme.rst
+++ b/boards/beagley/ai/demos/beagley-ai-expansion-nvme.rst
@@ -43,7 +43,7 @@ Step by step
.. note:: This article was written using the `BeagleY-AI Debian XFCE 12.5 2024-06-12 image <https://www.beagleboard.org/distros/beagley-ai-debian-12-5-2024-06-12-xfce/>`_.
Step 1. Boot from SD Normally
-==================================
+===============================
Grab the latest BeagleY-AI SD Image from (`BeagleBoard.org/distros <https://www.beagleboard.org/distros>`_.)
@@ -56,7 +56,7 @@ Once logged in and at the terminal, make sure your system is up to date (a reboo
Step 2. Verify that your NVMe drive is detected
-============================================================
+=================================================
The command ``lspci`` will list the attached PCI Express devices on the system:
@@ -92,8 +92,7 @@ Here we see that two devices are connected, ``mmcblk1`` corresponds to our SD ca
If your drives aren't listed as expected, please check the Troubleshooting section at the end of this document.
Step 3a. Transfer your root filesystem over to NVMe with a bootmenu option (recommended)
-================================================================================================
-
+==========================================================================================
For this method, you will need `Raspberry Pi Debug Probe <https://www.raspberrypi.com/documentation/microcontrollers/debug-probe.html>`_
or similar serial (USB to UART) adapter, to select the ``2: transfer microSD rootfs to NVMe (advanced)`` the boot menu option:
@@ -113,7 +112,7 @@ The BeagleY-AI will shutdown when complete
Step 3b. Transfer your root filesystem over to NVMe with a shell script
-=======================================================================================
+========================================================================
A variety of useful scripts are available in ``/opt/``, one of them enables us to move our micro-sd contents to NVMe and make BeagleY-AI boot from there directly.
@@ -135,7 +134,7 @@ The following 3 commands will change your U-boot prompt to boot from NVMe by def
Step 4. (optional) Verify u-boot (Serial Debug) will jump to the rootfs on the NVMe
-===========================================================================
+=====================================================================================
.. note:: boot menu ``1: return to microSD`` will allow you to return to the microSD rootfs for any reasons.
diff --git a/boards/beagley/ai/demos/beagley-ai-using-i2c-oled-display.rst b/boards/beagley/ai/demos/beagley-ai-using-i2c-oled-display.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c7a40f1da248de36b8c74724519c8da41949f696
--- /dev/null
+++ b/boards/beagley/ai/demos/beagley-ai-using-i2c-oled-display.rst
@@ -0,0 +1,365 @@
+.. _beagley-ai-using-i2c-oled-display:
+
+Using I2C OLED Display
+#######################
+
+Using I2C on BeagleY-AI is similar to using it on any Raspberry Pi compatible board.
+The image below shows the BeagleY-AI I2C pinout. For more information check `pinout.beagley.ai/pinout/i2c <https://pinout.beagley.ai/pinout/i2c>`_.
+
+.. figure:: ../images/i2c/i2c-pinout.*
+ :align: center
+ :alt: BeagleY-AI I2C pinout
+
+ BeagleY-AI I2C pinout
+
+OLED (ssd1306) displays
+************************
+
+There are several examples available online to use OLED (ssd1306) displays under linux.
+We are using `ssd1306_linux <https://github.com/armlabs/ssd1306_linux>`_ from ``armlabs`` to
+demonstrate how you can write to an OLED (ssd1306) display.
+
+.. tip:: For detailed usage examples of the library check `Examples section of the Readme <https://github.com/armlabs/ssd1306_linux?tab=readme-ov-file#example>`_.
+
+Wiring/connection
+==================
+
+Following the I2C pinout shown above let's make the connection of our OLED display with BeagleY-AI.
+Connection for both ``128x64`` and ``128x32`` resolution displays are demostrated in the images below:
+
+.. figure:: ../images/i2c/oled-128x32.*
+ :align: center
+ :alt: OLED diaplay 128x32
+
+ OLED diaplay 128x32
+
+.. figure:: ../images/i2c/oled-128x64.*
+ :align: center
+ :alt: OLED diaplay 128x64
+
+ OLED diaplay 128x64
+
+To check if your OLED is correctly connected to your BeagleY-AI you
+can use ``i2cdetect`` command as shown below.
+
+.. code:: console
+
+ i2cdetect -y -r 1
+
+The above command should show ``3c`` address occupied in the output, which is the default I2C address of our OLED display.
+
+.. code:: console
+
+ debian@BeagleBone:~/ssd1306_linux$ i2cdetect -y -r 1
+ 0 1 2 3 4 5 6 7 8 9 a b c d e f
+ 00: -- -- -- -- -- -- -- --
+ 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+ 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+ 30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- --
+ 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+ 50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+ 60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
+ 70: -- -- -- -- -- -- -- --
+
+.. _beagley-ai-ssd1306-using-kernel-driver:
+
+Using kernel driver
+===================
+
+To use the kernel driver to drive the SSD1306 oled, we have created an overlay ``/boot/firmware/overlays/k3-am67a-beagley-ai-i2c1-ssd1306.dtbo``.
+To load the overlay you have to add ``fdtoverlays /overlays/k3-am67a-beagley-ai-i2c1-ssd1306.dtbo`` to ``/boot/firmware/extlinux/extlinux.conf`` as shown below.
+
+.. note:: Current overlay is created for 128x64 OLED displays, you can update the overlay to use it for other resolution OLED displays.
+
+.. code:: text
+
+ ...
+ ...
+ ...
+
+ label microSD (default)
+ kernel /Image
+ append console=ttyS2,115200n8 root=/dev/mmcblk1p3 ro rootfstype=ext4 resume=/dev/mmcblk1p2 rootwait net.ifnames=0 quiet
+ fdtdir /
+ fdt /ti/k3-am67a-beagley-ai.dtb
+ fdtoverlays /overlays/k3-am67a-beagley-ai-i2c1-ssd1306.dtbo
+ initrd /initrd.img
+
+After rebooting the board you should see ``/dev/fb0`` available.
+
+.. code:: shell
+
+ debian@BeagleBone:~$ ls /dev | grep fb
+ fb0
+
+To show random noise on the display you can use ``/dev/urandom`` and feed it to ``/dev/fb0``,
+
+.. code:: shell
+
+ cat /dev/urandom > /dev/fb0
+
+.. figure:: ../images/i2c/oled-urandom-fb0.*
+ :align: center
+ :alt: Random noise on SSD1306 OLED
+
+ Random noise on SSD1306 OLED
+
+To show blank screen you can use ``/dev/zero`` and feed it to ``/dev/fb0``,
+
+.. code:: shell
+
+ cat /dev/zero > /dev/fb0
+
+.. figure:: ../images/i2c/oled-zero-fb0.*
+ :align: center
+ :alt: Blank (black/zero) SSD1306 OLED pixels
+
+ Blank (black/zero) SSD1306 OLED pixels
+
+To fill the screen with white pixels you can create a python script
+called ``fill-oled.py`` to create ``data.out`` file and feed it to ``/dev/fb0``,
+
+.. code:: shell
+
+ nano fill-oled.py
+
+Copy paste the below code to ``fill-oled.py``,
+
+.. code:: python
+
+ xsize = 128
+ ysize = 64
+
+ with open('data.out', 'wb') as f:
+ for y in range(0, ysize):
+ for x in range(0, xsize):
+ pixel = 255
+ f.write((pixel).to_bytes(1, byteorder='little'))
+
+To get the ``data.out`` from ``fill-oled.py`` file execute the command below,
+
+.. code:: shell
+
+ python fill-oled.py
+
+The above command should create a file called ``data.out``.
+To feed ``data.out`` to ``/dev/fb0`` execute the command below,
+
+.. code:: shell
+
+ cat data.out > /dev/fb0
+
+.. figure:: ../images/i2c/oled-rect-fb0.*
+ :align: center
+ :alt: Fill (white/ones) SSD1306 OLED pixels
+
+ Fill (white/ones) SSD1306 OLED pixels
+
+.. todo:: Add instructions to use OLED for console and printing text via ``/dev/fb0`` interface.
+
+Setup ssd1306 linux software
+=============================
+
+.. note::
+ If you tried :ref:`beagley-ai-ssd1306-using-kernel-driver`, you must remove the
+ ``fdtoverlays /overlays/k3-am67a-beagley-ai-i2c1-ssd1306.dtbo`` line from
+ ``/boot/firmware/extlinux/extlinux.conf`` and ``reboot`` your BeagleY-AI board
+ before following the instructions provided below.
+
+Clone the ``ssd1306_linux`` github repository on your BeagleY-AI.
+
+.. code:: console
+
+ git clone https://github.com/armlabs/ssd1306_linux.git
+
+Change directory to your clonned ``ssd1306_linux`` github repository.
+
+.. code:: console
+
+ cd ssd1306_linux
+
+Execute ``make`` to build the binary to control your I2C OLED display.
+
+.. code:: console
+
+ make
+
+Now, you should have ``ssd1306_bin`` binary file genreated in the folder that you can use to easily
+write text on you I2C OLED (ssd1306) display.
+
+Example1: Hello World!!!!
+---------------------------
+
+let's create a script inside the repository (ssd1306 folder) to print ``Hello World!!!!`` on the screen.
+
+.. code:: console
+
+ nano hello-world.sh
+
+Now copy paste the code shown below in your ``hello-world.sh`` file. Update the code if your display resolution
+is not ``128x64``, comment out first line and uncomment second line to choose ``128x32`` display size.
+
+.. code:: bash
+
+ ./ssd1306_bin -n 1 -I 128x64
+ #./ssd1306_bin -n 1 -I 128x32
+
+
+ ./ssd1306_bin -n 1 -c
+ ./ssd1306_bin -n 1 -r 0
+ ./ssd1306_bin -n 1 -x 1 -y 1
+ ./ssd1306_bin -n 1 -l "Hello World!!!!"
+
+Execute the ``hello-world.sh`` script using command below,
+
+.. code:: console
+
+ source hello-world.sh
+
+Executing the command above should print ``Hello World!!!!`` on your OLED display.
+
+.. figure:: ../images/i2c/oled-128x64-hello-world.*
+ :align: center
+ :alt: Hello World!!!! on 128x64 OLED
+
+ Hello World!!!! on 128x64 OLED
+
+.. figure:: ../images/i2c/oled-128x32-hello-world.*
+ :align: center
+ :alt: Hello World!!!! on 128x32 OLED
+
+ Hello World!!!! on 128x32 OLED
+
+
+Understanding the code
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. callout::
+
+ .. code-block:: bash
+
+ ./ssd1306_bin -n 1 -I 128x64 <1>
+ #./ssd1306_bin -n 1 -I 128x32 <2>
+
+
+ ./ssd1306_bin -n 1 -c <3>
+ ./ssd1306_bin -n 1 -r 0 <4>
+ ./ssd1306_bin -n 1 -x 1 -y 1 <5>
+ ./ssd1306_bin -n 1 -l "Hello World!!!!" <6>
+
+ .. annotations::
+
+ <1> Use this command to set OLED display resolution to ``128x64``
+
+ <2> Use this command to set OLED display resolution to ``128x32``
+
+ <3> Clear the display
+
+ <4> Set rotation to ``0/normal``
+
+ <5> Set cursor to location ``x:1 y:1``
+
+ <6> Write ``Hello World!!!!`` to display as line using ``-l`` command.
+
+ Note: We are using ``-n 1`` because our OLED display is connected to ``/dev/i2c-1`` port.
+
+Example2: Date and time
+------------------------
+
+To print the date and time on our OLED screen we will be using ``date`` command but you
+can also use ``hwclock`` command to show date and time from onboard RTC. For details on using
+``date`` and ``hwclock`` you can check :ref:`beagley-ai-using-rtc` demo.
+
+Let's create ``date-time.sh`` in the same folder.
+
+.. code:: console
+
+ nano date-time.sh
+
+Now copy paste the code shown below in your ``date-time.sh`` file. Make sure to update the code if your display resolution
+is not ``128x64``, comment out first line and uncomment second line to choose ``128x32`` display size.
+
+.. code:: bash
+
+ ./ssd1306_bin -n 1 -I 128x64
+ #./ssd1306_bin -n 1 -I 128x32
+
+ ./ssd1306_bin -n 1 -c
+ ./ssd1306_bin -n 1 -r 0
+
+ while :
+ do
+ ./ssd1306_bin -n 1 -x 1 -y 1
+ ./ssd1306_bin -n 1 -f 1 -m "$(date +%Y:%m:%d)\n\n$(date +%H:%M:%S)"
+ done
+
+Execute the ``date-time.sh`` script using command below,
+
+.. code:: console
+
+ source date-time.sh
+
+Executing the command above should print ``Date & Time`` on your OLED display.
+
+.. figure:: ../images/i2c/oled-128x64-date-time.*
+ :align: center
+ :alt: Date & Time on 128x64 OLED
+
+ Date & Time on 128x64 OLED
+
+.. figure:: ../images/i2c/oled-128x32-date-time.*
+ :align: center
+ :alt: Date & Time on 128x32 OLED
+
+ Date & Time on 128x32 OLED
+
+Understanding the code
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. callout::
+
+ .. code-block:: bash
+
+ ./ssd1306_bin -n 1 -I 128x64 <1>
+ #./ssd1306_bin -n 1 -I 128x32 <2>
+
+ ./ssd1306_bin -n 1 -c <3>
+ ./ssd1306_bin -n 1 -r 0 <4>
+
+ while : <5>
+ do
+ ./ssd1306_bin -n 1 -x 1 -y 1 <6>
+ ./ssd1306_bin -n 1 -f 1 -m "$(date +%Y:%m:%d)\n\n$(date +%H:%M:%S)" <7>
+ sleep 0.2 <8>
+ done
+
+ .. annotations::
+
+ <1> Use this command to set OLED display resolution to ``128x64``
+
+ <2> Use this command to set OLED display resolution to ``128x32``
+
+ <3> Clear the display
+
+ <4> Set rotation to ``0/normal``
+
+ <5> Run infinite loop to regularly update screen.
+
+ <6> Set cursor to location ``x:1 y:1``
+
+ <7> Write ``Date and Time`` to display on separate lines as message using ``-m`` command.
+
+ <8> Sleep for 200ms (200 milli seconds)
+
+ Note: We are using ``-n 1`` because our OLED display is connected to ``/dev/i2c-1`` port.
+
+.. tip:: Other I2C devices can also be connected and used with BeagleY-AI in the same way shown in this demo.
+
+
+
+
+
+
+
+
+
diff --git a/boards/beagley/ai/images/i2c/i2c-pinout.png b/boards/beagley/ai/images/i2c/i2c-pinout.png
new file mode 100644
index 0000000000000000000000000000000000000000..be9a1ffbf93d79e5ac08e895ac8a19042181e9b8
Binary files /dev/null and b/boards/beagley/ai/images/i2c/i2c-pinout.png differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x32-date-time.jpg b/boards/beagley/ai/images/i2c/oled-128x32-date-time.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..02bb2c0139be984e07da88bef6fbdfaa88abd169
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x32-date-time.jpg differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x32-hello-world.jpg b/boards/beagley/ai/images/i2c/oled-128x32-hello-world.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..15287d6ef26eb7f5b885b0b6640f19c050a55461
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x32-hello-world.jpg differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x32.png b/boards/beagley/ai/images/i2c/oled-128x32.png
new file mode 100644
index 0000000000000000000000000000000000000000..ba6bef920c4a71851b7fe7adf9ba495f4af60310
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x32.png differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x64-date-time.jpg b/boards/beagley/ai/images/i2c/oled-128x64-date-time.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..df9cc7b9996c4f4708a593b6f5e4a8422cd4993c
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x64-date-time.jpg differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x64-hello-world.jpg b/boards/beagley/ai/images/i2c/oled-128x64-hello-world.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2d4a1896dfc8dd294df500855d54dddbe488cd50
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x64-hello-world.jpg differ
diff --git a/boards/beagley/ai/images/i2c/oled-128x64.png b/boards/beagley/ai/images/i2c/oled-128x64.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0d2e0b6992712a95ab120ddb227687cc814b6ab
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-128x64.png differ
diff --git a/boards/beagley/ai/images/i2c/oled-rect-fb0.JPG b/boards/beagley/ai/images/i2c/oled-rect-fb0.JPG
new file mode 100644
index 0000000000000000000000000000000000000000..b9b9949e05c367502c3936dfdc83999d1c3a88f7
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-rect-fb0.JPG differ
diff --git a/boards/beagley/ai/images/i2c/oled-urandom-fb0.JPG b/boards/beagley/ai/images/i2c/oled-urandom-fb0.JPG
new file mode 100644
index 0000000000000000000000000000000000000000..d185e46dabd99845fc0113955a72d648f7c28e37
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-urandom-fb0.JPG differ
diff --git a/boards/beagley/ai/images/i2c/oled-zero-fb0.JPG b/boards/beagley/ai/images/i2c/oled-zero-fb0.JPG
new file mode 100644
index 0000000000000000000000000000000000000000..1515bca8b4cc04ff8d808941609a6550245239e9
Binary files /dev/null and b/boards/beagley/ai/images/i2c/oled-zero-fb0.JPG differ
diff --git a/boards/beagley/ai/images/standalone.jpg b/boards/beagley/ai/images/standalone.jpg
index 4929d71afb242b240c628ce33ae955752e2b33b1..3f8e585c5187f6f842536e083234d00c38f52667 100644
Binary files a/boards/beagley/ai/images/standalone.jpg and b/boards/beagley/ai/images/standalone.jpg differ