diff --git a/boards/beagleboard/index.rst b/boards/beagleboard/index.rst index c94a4e0a261caad1e71899338d07984986ad7cb3..f6e73423d460af3c3ab7dd312f19b4ed9fd02d22 100644 --- a/boards/beagleboard/index.rst +++ b/boards/beagleboard/index.rst @@ -3,8 +3,9 @@ BeagleBoard (all) ################### -BeagleBoard boards are low-cost, ARM-based development boards suitable for rapid prototyping and -open-hardware to enable professionals to develop production systems. +BeagleBoard.org Single Board Computers (SBCs) and microcontroller development boards are fully OpenSource, low-cost, RISC-V & ARM +based boards. Which makes them suitable for students to learn about embedded electronics & embedded linux. The BeagleBoard development +platforms also enables rapid prototyping for professionals to develop industrial & production systems. .. note:: Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page. @@ -12,7 +13,11 @@ open-hardware to enable professionals to develop production systems. Use of either the boards or the design materials constitutes agreement to the T&C including any modifications done to the hardware or software solutions provided by beagleboard.org foundation. -The latest PDF-formatted System Reference Manual for each BeagleBoard board is linked below. +The latest unified docs PDF is linked below. + +* `BeagleBoard.org unified docs PDF <https://docs.beagleboard.org/latest/beagleboard-docs.pdf>`_ + +The latest System Reference Manual (PDF) for some older boards is linked below. * `BeagleBoard <https://git.beagleboard.org/beagleboard/beagleboard/-/blob/master/BeagleBoard_revC5_SRM.pdf>`_ * `BeagleBoard-xM <https://git.beagleboard.org/beagleboard/beagleboard-xm/-/blob/master/BeagleBoard-xM_SRM.pdf>`_ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/01-introduction.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/01-introduction.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d917e8e3b71553f8cccea1e14522b5e833edce51 Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/01-introduction.jpg differ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/02-quick-start.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/02-quick-start.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3c9732c3c1c99a495096069297d98f554edad483 Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/02-quick-start.jpg differ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/03-design-and-specifications.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/03-design-and-specifications.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f83f5b9a4e800a302150a80b733077691bc925c7 Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/03-design-and-specifications.jpg differ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/04-connectors-and-pinouts.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/04-connectors-and-pinouts.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cfef870ab8502553848b60c01bdb942d237da660 Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/04-connectors-and-pinouts.jpg differ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/05-demos-and-tutorials.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/05-demos-and-tutorials.jpg new file mode 100644 index 0000000000000000000000000000000000000000..69562a8d2efa7de244a17ad2f3bd75570a8ceaa1 Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/05-demos-and-tutorials.jpg differ diff --git a/boards/beaglebone/ai/images/demos-and-tutorials/06-support-documents.jpg b/boards/beaglebone/ai/images/demos-and-tutorials/06-support-documents.jpg new file mode 100644 index 0000000000000000000000000000000000000000..90db7381f1797f8e44dcaa57ba0f4f679a393bca Binary files /dev/null and b/boards/beaglebone/ai/images/demos-and-tutorials/06-support-documents.jpg differ diff --git a/conf.py b/conf.py index 7fea3b885788fd7b1e0ec8a56d7bb6fff6e7ceb2..927f3a5980f9c0561f00bb0d82614f4740759aec 100644 --- a/conf.py +++ b/conf.py @@ -16,6 +16,12 @@ ImagemagickConverter.conversion_rules.append(('image/webp', 'image/png')) BBDOCS_BASE = Path(__file__).resolve().parents[0] +rst_epilog ="" + +# Add latest images to rst_epilog +with open('latest.images') as f: + rst_epilog += f.read() + # -- Project information ----------------------------------------------------- project = 'BeagleBoard Docs' @@ -36,6 +42,7 @@ extensions = [ "sphinx.ext.todo", "sphinx_tabs.tabs", "breathe", + "sphinx_copybutton", ] # "exhale" diff --git a/intro/support/getting-started.rst b/intro/support/getting-started.rst index 3283c0705b90d7b2a3d3a4d57ee6c5709270605a..c9b6805ff0657f6c1552afa56efaf4484c2b78aa 100644 --- a/intro/support/getting-started.rst +++ b/intro/support/getting-started.rst @@ -23,6 +23,20 @@ The "IoT" images provide more free disk space if you don't need to use a graphic .. NOTE:: Due to sizing necessities, this download may take 30 minutes or more. +1. `BeaglePlay latest image (xfce)`_ +2. `BeaglePlay latest image (home-assistant)`_ +3. `AM57xx latest image (IoT)`_ for BeagleBone AI and BeagleBone-X15 +4. `AM57xx latest image (Xfce)`_ for BeagleBone AI and BeagleBone-X15 +5. `BeagleBone AI-64 latest image (Minimal)`_ +6. `BeagleBone AI-64 latest image (TI EDGEAI)`_ +7. `BeagleBone AI-64 latest image (Xfce)`_ +8. `AM335x latest image`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc. +9. `AM335x latest image (Xfce)`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc. +10. `AM335x latest image (IoT)`_ for BeagleBone Black, PocketBeagle, BeagleBone Blue, etc. +11. `BeagleConnect Freedom latest image (micropython)`_ +12. `BeagleV-Ahead latest image (Ubuntu)`_ +13. `BeagleV-Ahead latest image (Yocto)`_ + The Debian/Ubuntu distribution is provided for the boards. The file you download will have an .img.xz extension. This is a compressed sector-by-sector image of the SD card. @@ -221,21 +235,26 @@ Books For a complete list of books on BeagleBone, see `beagleboard.org/books <https://beagleboard.org/books>`_. -`Bad to the Bone <https://bbb.io/bad-to-the-bone>`_ +|image8| Perfect for high-school seniors or freshman univerisity level text, consider using "Bad to the Bone" -`BeagleBone Cookbook <https://bbb.io/cookbook>`_ +|image9| A lighter treatment suitable for a bit broader audience without the backgrounders on programming and electronics, consider "BeagleBone Cookbook" -`Exploring BeagleBone <https://bbb.io/ebb>`_ and `Embedded Linux Primer <https://bbb.io/elp>`_ +|image10| To take things to the next level of detail, consider "Exploring BeagleBone" which can be considered -the missing software manual and utilize "Embedded Linux Primer" as a companion textbook to provide +the missing software manual. + +|image11| + +utilize "Embedded Linux Primer" as a companion textbook to provide a strong base on embedded Linux suitable for working with any hardware that will run Linux. + .. |image0| image:: images/distros.png :width: 75.0% .. |image1| image:: images/download-etcher.png diff --git a/latest.images b/latest.images new file mode 100644 index 0000000000000000000000000000000000000000..7375fbebb5eff59c7a7036571a0b181cd4610728 --- /dev/null +++ b/latest.images @@ -0,0 +1,23 @@ +.. Latest distro images +.. Created on: 2023-11-17 +.. Updated on: 2023-11-17 + +.. _BeaglePlay latest image (Xfce): https://www.beagleboard.org/distros/beagleplay-11-8-2023-10-07-10gb-emmc-xfce-flasher +.. _BeaglePlay latest image (home-assistant): https://www.beagleboard.org/distros/beagleplay-11-8-2023-10-07-8gb-emmc-home-assistant-flasher + +.. _AM57xx latest image (IoT): https://www.beagleboard.org/distros/am57xx-12-2-2023-10-07-4gb-emmc-iot-flasher +.. _AM57xx latest image (Xfce): https://www.beagleboard.org/distros/am57xx-11-7-2023-09-02-4gb-emmc-xfce-flasher + +.. _BeagleBone AI-64 latest image (Minimal): https://www.beagleboard.org/distros/bbai64-12-2-2023-10-07-6gb-emmc-minimal-flasher +.. _BeagleBone AI-64 latest image (TI EDGEAI): https://www.beagleboard.org/distros/bbai64-11-8-2023-10-07-10gb-emmc-ti-edgeai-xfce-flasher +.. _BeagleBone AI-64 latest image (Xfce): https://www.beagleboard.org/distros/bbai64-11-8-2023-10-07-10gb-emmc-xfce-flasher + +.. _AM335x latest image: https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-microsd-iot +.. _AM335x latest image (Xfce): https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-emmc-xfce-flasher +.. _AM335x latest image (IoT): https://www.beagleboard.org/distros/am335x-11-7-2023-09-02-4gb-emmc-iot-flasher + +.. _BeagleConnect Freedom latest image (micropython): https://www.beagleboard.org/distros/beagleconnect-freedom-micropython-v0-0-3 + +.. _BeagleV-Ahead latest image (Ubuntu): https://www.beagleboard.org/distros/beaglev-ahead-ubuntu-2023-07-05 +.. _BeagleV-Ahead latest image (Yocto): https://www.beagleboard.org/distros/beaglev-ahead-yocto-npi-2023-06-10 + diff --git a/venv-build-env.sh b/venv-build-env.sh index bea1e929a8805564d7de5f0297bda2a884a92520..bcf495a0efcbcca3356069b1caf2b259e6aa189d 100755 --- a/venv-build-env.sh +++ b/venv-build-env.sh @@ -6,6 +6,6 @@ fi source ./sphinx-env/bin/activate python3 -m pip install --upgrade pip python3 -m pip install sphinx==5.3.0 sphinx-rtd-theme sphinx_design sphinx-tabs sphinxcontrib.svg2pdfconverter sphinx-reredirects -python3 -m pip install sphinxcontrib-images +python3 -m pip install sphinxcontrib-images sphinx-copybutton python3 -m pip install breathe exhale python3 -m pip install graphviz