docs: Add AE3 OLED Breakout / Battery Shield + AI-friendly docs.

Documentation:
- shields/ae3-oled-breakout.rst — 128x128 SSD1351 OLED, AS90R joystick
  via PCA9674A on I2C 4, JTAG header pinout (1.8 V), Qwiic pinout,
  notes on the recovery / OLED-enable switches, M1.6 mounting holes,
  examples that mirror the official 50-Arduino-Boards/52-Alif-Boards
  scripts.
- shields/ae3-battery-shield.rst — HV / BAT / LV JST power inputs with
  output rails (3.3 V from HV; 3.0 V from BAT or LV), 100 mA Li-Po
  charger with PG/CHG status (green/red LEDs on P6/P7), Li-Po and LV
  ADC monitors on P8/P9, SD-card power switch on P11, mounting holes,
  sdcard + charger-status + ADC usage examples.
- shields.rst — new "AE3 accessories" card grid between Modern and
  Legacy, plus toctree entries; mobile padding fix so the landing
  doesn't double-pad inside the Shibuya container on phones.

AI / LLM enablement:
- Enabled Shibuya's "Copy page" + Open in ChatGPT / Claude / Perplexity
  dropdown (show_ai_links + all three providers).
- Set html_baseurl so the dropdown links and llms.txt URLs are
  absolute (https://docs.openmv.io/_sources/...).
- Added GitHub source_type/user/repo/docs_path/version to html_context
  as a fallback.
- Added sphinx_llms_txt extension — auto-emits /llms.txt and
  /llms-full.txt every build (zero per-page maintenance).
- Added twitter / youtube / linkedin Shibuya footer icons.

CSS:
- Widen the right-column TOC to 18rem above 1280 px and let the
  GitHub repo widget links wrap on natural separators, so
  "openmv/openmv-doc" no longer breaks mid-word.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: kwagyeman

docs/conf.py

@@ -41,8 +41,22 @@
     "openmv_version": openmv_version,
     "micropython_version": micropython_version,
     "build_date": build_date,
+    # Tells Shibuya where the page source lives — used as a fallback
+    # for the "Copy page" / "Open in ChatGPT/Claude/Perplexity" links
+    # when html_baseurl isn't set (in which case Shibuya reads from
+    # the deployed site's /_sources/ tree instead).
+    "source_type": "github",
+    "source_user": "openmv",
+    "source_repo": "openmv-doc",
+    "source_docs_path": "/micropython/docs/",
+    "source_version": "master",
 }
 
+# Site root — used by sphinx-llms-txt to emit absolute URLs in
+# /llms.txt and by Shibuya's "Copy page" / "Open in ChatGPT" dropdown
+# to fetch raw page source from /_sources/.
+html_baseurl = "https://docs.openmv.io/"
+
 # -- Landing page code examples (rendered via Pygments to match site code style) --
 from pygments import highlight as _pygments_highlight
 from pygments.lexers import PythonLexer as _PythonLexer
@@ -256,6 +270,9 @@ def _render_landing_code(src):
     "sphinx.ext.intersphinx",
     "sphinx.ext.todo",
     "sphinx.ext.coverage",
+    # Auto-generates /llms.txt + /llms-full.txt during the build so LLMs
+    # can discover and ingest the docs without any per-page maintenance.
+    "sphinx_llms_txt",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -416,9 +433,15 @@ def _render_landing_code(src):
     "color_mode": "auto",
     "github_url": "https://github.com/openmv/openmv",
     "discussion_url": "https://forums.openmv.io/",
+    "twitter_url": "https://x.com/openmvcam",
+    "youtube_url": "https://www.youtube.com/channel/UCk43Dxy_qcwwYyLsP6EWatQ",
+    "linkedin_url": "https://www.linkedin.com/company/16193624/",
     "globaltoc_expand_depth": 1,
     "toctree_collapse": True,
-    "show_ai_links": False,
+    "show_ai_links": True,
+    "open_in_chatgpt": True,
+    "open_in_claude": True,
+    "open_in_perplexity": True,
     "nav_links": [
         {"title": "Home", "url": "index"},
         {"title": "Tutorial", "url": "openmvcam/tutorial/index"},

docs/openmvcam/ae3-battery-shield-hero.jpg

@@ -111,6 +111,37 @@ Modern shields
      </section>
    </div>
 
+AE3 accessories
+---------------
+
+.. raw:: html
+
+   <div class="omv-cards-page">
+     <section class="omv-section">
+       <div class="omv-grid cols-4">
+
+         <a class="omv-card board" href="shields/ae3-oled-breakout.html">
+           <div class="board-thumb"><img src="../_images/ae3-oled-breakout-hero.jpg" alt="AE3 OLED Breakout"></div>
+           <div class="board-body">
+             <h4>AE3 OLED Breakout</h4>
+             <p>128×128 RGB OLED, 5‑way joystick, Qwiic, and a 10‑pin ARM SWD header.</p>
+             <span class="card-arrow">Explore →</span>
+           </div>
+         </a>
+
+         <a class="omv-card board" href="shields/ae3-battery-shield.html">
+           <div class="board-thumb"><img src="../_images/ae3-battery-shield-hero.jpg" alt="AE3 Battery Shield"></div>
+           <div class="board-body">
+             <h4>AE3 Battery Shield</h4>
+             <p>5–36 V, 1.8–5.5 V, or 3.7 V Li‑Po power for the AE3 plus an SPI microSD socket.</p>
+             <span class="card-arrow">Explore →</span>
+           </div>
+         </a>
+
+       </div>
+     </section>
+   </div>
+
 Legacy shields
 --------------
 
@@ -245,6 +276,8 @@ Legacy shields
    shields/rs422-rs485-shield.rst
    shields/driver-shield.rst
    shields/relay-shield.rst
+   shields/ae3-oled-breakout.rst
+   shields/ae3-battery-shield.rst
    shields/lcd-shield.rst
    shields/wifi-shield.rst
    shields/proto-shield.rst

docs/openmvcam/ae3-oled-breakout-hero.jpg

@@ -0,0 +1,134 @@
+AE3 Battery Shield
+==================
+
+The AE3 Battery Shield powers the :doc:`OpenMV AE3 </openmvcam/quickref/openmv-ae3>`
+from a wide range of supplies — 5–36 V, a 3.7 V Li‑Po cell, or
+1.8–5.5 V for 3 alkaline cells in series — and adds an SPI microSD
+card socket on ``P0``–``P3``. All three power inputs land on JST terminals; the
+shield ships with a JST‑to‑pigtail adapter for the wide input and
+a JST‑to‑DC‑barrel‑jack adapter for the alkaline input.
+
+.. image:: ../ae3-battery-shield-hero.jpg
+    :alt: AE3 Battery Shield
+    :width: 400px
+    :align: center
+
+For full datasheet, photos, and ordering see the
+`AE3 Battery Shield product page <https://openmv.io/collections/openmv-ae3-accessories/products/openmv-ae3-battery-shield>`_.
+
+Highlights
+----------
+
+* **HV PWR** — 5–36 V, reverse‑voltage tolerant to −36 V. Powers
+  the AE3 at **3.3 V** (up to 600 mA).
+* **BAT** — 3.7 V single‑cell Li‑Po. Powers the AE3 at **3.0 V**
+  (up to 800 mA). The on‑board charger runs at a **100 mA charge
+  current** whenever 3.3 V is available on the shield — supplied
+  by USB, HV PWR, or 3.3 V fed to the AE3 through its Qwiic
+  connector. A 6.25 hr safety timer caps the supported battery
+  capacity at **625 mAh**.
+* **LV PWR** — 1.8–5.5 V for **3 alkaline cells in series**,
+  reverse‑voltage tolerant to −5.5 V. Powers the AE3 at **3.0 V**
+  (up to 800 mA).
+* **microSD card socket** wired to ``P0``–``P3`` over SPI, with a
+  software‑controlled power switch on ``P11``.
+
+.. note::
+
+   The shield ships with a case that holds the AE3 firmly against
+   the connector. Four corner **M1.6** mounting holes let you bolt
+   the shield down to an enclosure or fixture.
+
+Pin reference
+-------------
+
+.. csv-table::
+   :header: "Pin", "Function"
+   :widths: 20, 80
+
+   "P0",          "microSD SPI **MOSI**"
+   "P1",          "microSD SPI **MISO**"
+   "P2",          "microSD SPI **SCLK**"
+   "P3",          "microSD SPI **CS**"
+   "P6",          "Charger **power‑good** (low when 3.3 V is present on the shield — USB, HV PWR, or Qwiic 3.3 V; charging only happens while this is low)"
+   "P7",          "Charger **charging** (low while the Li‑Po is being charged)"
+   "P8",          "Li‑Po battery voltage monitor — shield divides **0–5 V** down to **0–1.8 V** at the pin"
+   "P9",          "LV input voltage monitor — shield divides **0–6 V** down to **0–1.8 V** at the pin"
+   "P11",         "microSD **power enable** (drive high to power the card)"
+   "HV PWR in",   "5–36 V on a JST terminal (reverse‑voltage tolerant; JST‑to‑pigtail adapter included)"
+   "BAT in",      "3.7 V single‑cell Li‑Po on a JST terminal"
+   "LV PWR in",   "1.8–5.5 V on a JST terminal for 3 alkaline cells in series (reverse‑voltage tolerant; JST‑to‑DC‑barrel‑jack adapter included)"
+   "3.3V rail",   "Powers the AE3 and the shield's on‑board electronics"
+   "GND rail",    "Common ground"
+
+Usage
+-----
+
+Plug an AE3 onto the shield and connect any one of the three power
+inputs — the shield ORs the rails internally and feeds the AE3 from
+whichever source is present.
+
+.. note::
+
+   With only ``BAT`` connected (no USB, HV PWR, or Qwiic 3.3 V
+   feeding the shield), the AE3 runs at 3.0 V off the Li‑Po, the
+   charger is idle, and both status LEDs are off.
+
+The microSD socket is exposed on the AE3's SPI bus through
+:class:`machine.SPI` and the standard ``sdcard`` driver. Drive
+``P11`` high to power the card, then wrap the block device in a
+``VfsFat`` and mount it at ``/sdcard``::
+
+    import os
+    import machine
+    import sdcard
+
+    machine.Pin("P11", machine.Pin.OUT, value=1)  # enable card power
+
+    spi = machine.SPI(0, baudrate=10_000_000)
+    cs  = machine.Pin("P3", machine.Pin.OUT, value=1)
+
+    sd  = sdcard.SDCard(spi, cs)
+    os.mount(os.VfsFat(sd), "/sdcard")
+    print(os.listdir("/sdcard"))
+
+Watch the charger status by reading its two status pins. ``P6``
+(power‑good) goes low as soon as 3.3 V is present on the shield —
+from USB, HV PWR, or 3.3 V fed back through the AE3's Qwiic —
+which is also when the charger is allowed to run. ``P7`` (charging)
+goes low while the Li‑Po is actually being charged. Both pins also
+drive on‑board status LEDs — ``P6`` lights a **green** LED, ``P7``
+lights a **red** LED::
+
+    from machine import Pin
+
+    pg  = Pin("P6", Pin.IN, Pin.PULL_UP)
+    chg = Pin("P7", Pin.IN, Pin.PULL_UP)
+
+    if not pg.value():
+        print("Charger powered")
+        if not chg.value():
+            print("Battery charging")
+        else:
+            print("Battery full or no battery")
+    else:
+        print("Running off battery only")
+
+Monitor the Li‑Po battery and LV input voltages on ``P8`` and
+``P9``. The shield divides each supply down to the AE3's 1.8 V
+ADC range, so scale the reading back up by the input's full‑scale
+range::
+
+    from machine import ADC
+    import time
+
+    lipo = ADC("P8")    # 0–5 V at the input
+    lv   = ADC("P9")    # 0–6 V at the input
+
+    while True:
+        # 0–1.8 V at the pin → 0–5 V on the battery rail
+        vbat = lipo.read_u16() * 1.8 / 65535 * (5.0 / 1.8)
+        # 0–1.8 V at the pin → 0–6 V on the LV rail
+        vlv  = lv.read_u16()  * 1.8 / 65535 * (6.0 / 1.8)
+        print("Li‑Po:", vbat, "V  LV:", vlv, "V")
+        time.sleep_ms(500)