diff --git a/accessories/cables.rst b/accessories/cables.rst
index 8b9f529a33c66a260cc4f8b1a369e613497948b0..d26b854cb03b5dddf226b006ffddb12a1ff0810e 100644
--- a/accessories/cables.rst
+++ b/accessories/cables.rst
@@ -31,6 +31,8 @@ BeagleBone AI-64 you'll have to procure your own USB cable.
| BeagleBone X15 | microUSB |
+----------------------------+--------------+
+.. _serial-debug-cables:
+
Serial Debug Cables
********************
diff --git a/boards/beaglebone/ai/ch02.rst b/boards/beaglebone/ai/ch02.rst
index 28fba9aa001a3a350fc28464f28625f5a6ae84c9..b31c26639dfd27c559da69c065fe98212822d8c0 100644
--- a/boards/beaglebone/ai/ch02.rst
+++ b/boards/beaglebone/ai/ch02.rst
@@ -36,7 +36,7 @@ Rev A1a
Alpha pilot-run units and initial production.
- `Added pull-down resistor on serial debug header RX
- line <https://github.com/beagleboard/beaglebone-ai/issues/24>`__.
+ line <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/issues/24>`__.
Alpha pilot-run eMMC flash image:
https://debian.beagleboard.org/images/bbai-pilot-20190408.img.xz
@@ -49,23 +49,23 @@ Rev A2
Proposed changes.
-- `Add footprint for pull-down resistor on serial debug header RX
- line <https://github.com/beagleboard/beaglebone-ai/issues/24>`__.
+- `HW: need pull-down on console uart RX line
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/issues/24>`__.
-- `Move microSD card cage closer to microHDMI to fit cases
- better <https://github.com/beagleboard/beaglebone-ai/issues/25>`__.
+- `HW: position of microSD may impact existing case designs
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/issues/25>`__.
-- `Connect AM5729 ball AB10 to P9.13 to provide a
- GPIO <https://github.com/beagleboard/beaglebone-ai/issues/22>`__.
+- `HW: P9.13 does not have a GPIO
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/issues/22>`__.
-- `HDMI hot-plug detection
- fixes <https://github.com/beagleboard/beaglebone-ai/issues/19>`__.
+- `HW: HDMI hotplug detection not working
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/issues/19>`__.
-- `Add additional CAN port to the expansion
- headers <https://github.com/beagleboard/beaglebone-ai/issues/20>`__.
+- `HW: add extra DCAN
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/issues/20>`__.
-- `Fix JTAG connector to not require wire
- mods <https://github.com/beagleboard/beaglebone-ai/issues/21>`__.
+- `HW: wire mods required to enable JTAG
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/issues/21>`__.
-- `Add I2C EEPROM for board
- identifier <https://github.com/beagleboard/beaglebone-ai/issues/23>`__.
+- `HW: Small I2C nvmem/eeprom for board identifier
+ <https://git.beagleboard.org/beagleboard/beaglebone-ai/issues/23>`__.
diff --git a/boards/beaglebone/ai/ch03.rst b/boards/beaglebone/ai/ch03.rst
index f190367da8514c29d986ea84122a0aee3319b8d7..4edded9f0f18ca8d5c64ee7438133fbec9be2511 100644
--- a/boards/beaglebone/ai/ch03.rst
+++ b/boards/beaglebone/ai/ch03.rst
@@ -27,7 +27,7 @@ You will need to purchase:
- USB C cable or USB C to USB A cable
- MicroSD Card (optional)
-- `Serial cable <https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#serial-cable>`_ (optional)
+- `Serial cable <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#serial-cable>`_ (optional)
More information or to purchase a replacement heat sink or antenna, please go to these websites:
@@ -43,7 +43,7 @@ the board except the 46-way header sockets and the Ethernet socket.
If you run all of the accelerators or have an older software image,
you’ll likely need fan. To find a fan, visit the link to `fans in the
-FAQ <https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#fans>`_.
+FAQ <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#fans>`_.
.. caution::
@@ -184,7 +184,7 @@ A 3 PIN serial debug cable can be helpful to debug when you need to view
the boot messages through a terminal program such as putty on your host
PC. This cable is not needed for most BeagleBone® AI boot up scenarios.
-Cables: https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#serial-cable
+Cables: https://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#serial-cable
Locate the 3 PIN debug header on BeagleBone® AI, near the USB C connection.
diff --git a/boards/beaglebone/ai/ch06.rst b/boards/beaglebone/ai/ch06.rst
index b80e9d0cefea4d14fc21e04a7de47f4df5d1a1c0..a5d972e8bc4ac224b610f2b09f310a2010f1d354 100644
--- a/boards/beaglebone/ai/ch06.rst
+++ b/boards/beaglebone/ai/ch06.rst
@@ -263,7 +263,7 @@ PRU-ICSS Resources and FAQ’s
Resources
- Great resources for PRU and BeagleBone® has been compiled here https://beagleboard.org/pru
-- The PRU Cookbook provides examples and getting started information https://github.com/MarkAYoder/PRUCookbook
+- The PRU Cookbook provides examples and getting started information :ref:`pru-cookbook-home`
- Detailed specification is available at http://processors.wiki.ti.com/index.php/PRU-ICSS
FAQ
diff --git a/boards/beaglebone/ai/ch08.rst b/boards/beaglebone/ai/ch08.rst
index bb6ace0432e93599a088016de992371087e79449..7201fc38dbd206a74ed20e6ed70621750321b9d9 100644
--- a/boards/beaglebone/ai/ch08.rst
+++ b/boards/beaglebone/ai/ch08.rst
@@ -170,9 +170,8 @@ TODO
Expansion Connector Headers
******************************
-TODO: discuss header options for working with the expansion connectors
-per
-https://github.com/beagleboard/beaglebone-black/wiki/System-Reference-Manual#84-expansion-connectors
+TODO: discuss header options for working with the expansion connectors per
+https://git.beagleboard.org/beagleboard/beaglebone-black/-/wikis/System-Reference-Manual#section-7-1
Signal Usage
****************
diff --git a/boards/beaglebone/ai/ch09.rst b/boards/beaglebone/ai/ch09.rst
index 9aa783c2c5c289ae231301aa0a61483293040f97..5c20ab50456e7e690924254f058d9b243cf73d6a 100644
--- a/boards/beaglebone/ai/ch09.rst
+++ b/boards/beaglebone/ai/ch09.rst
@@ -12,4 +12,4 @@ Mechanical Information
- Gross Weight (including packaging): 110g
- 3D STEP model:
- https://github.com/beagleboard/beaglebone-ai/tree/master/Mechanical
\ No newline at end of file
+ https://git.beagleboard.org/beagleboard/beaglebone-ai/-/tree/master/Mechanical
\ No newline at end of file
diff --git a/boards/beaglebone/ai/ch12.rst b/boards/beaglebone/ai/ch12.rst
index ef0e7cc8e1d430980f959e9353a25eb22c7b9dc0..f43f53ae5b46fdca6fb3d00794f279d1fdc94d7e 100644
--- a/boards/beaglebone/ai/ch12.rst
+++ b/boards/beaglebone/ai/ch12.rst
@@ -15,7 +15,7 @@ REGULATORY, COMPLIANCE, AND EXPORT INFORMATION
- TARIC: 8473302000
- ECCN: 5A992.C
- CCATS:
- `Z1613110/G180570 <https://github.com/beagleboard/beaglebone-ai/blob/master/regulatory/Validation_Z1613110.pdf>`__
+ `Z1613110/G180570 <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/tree/master/regulatory/Validation_Z1613110.pdf>`__
- RoHS/REACH: TBD
- Volatility: TBD
diff --git a/boards/beaglebone/black/ch02.rst b/boards/beaglebone/black/ch02.rst
index 2239dafbf525ca21299984322feef9207f4e60a2..820eae28026422e621c176e183611826c35a762a 100644
--- a/boards/beaglebone/black/ch02.rst
+++ b/boards/beaglebone/black/ch02.rst
@@ -123,8 +123,8 @@ Rev C3
PCB revision C.
-* Updated microSD card cage due to availability. See https://github.com/beagleboard/beaglebone-black/issues/6. Added series resistors and depopulated C5.
-* Added reset option (GPIO1_8) for Ethernet PHY to avoid possible start-up issue. See https://github.com/beagleboard/beaglebone-black/issues/4.
+* Updated microSD card cage due to availability. See https://git.beagleboard.org/beagleboard/beaglebone-black/-/issues/6. Added series resistors and depopulated C5.
+* Added reset option (GPIO1_8) for Ethernet PHY to avoid possible start-up issue. See https://git.beagleboard.org/beagleboard/beaglebone-black/-/issues/4.
* Added series resistors to MMC1 lines and depopulated C24.
* Connected pin A6 of J5 on U13 (eMMC IC) to DGND.
* Changed USB1_VBUS series resistor to 0 ohm.
diff --git a/boards/beaglebone/blue/accessories.rst b/boards/beaglebone/blue/accessories.rst
index 88197c591d2fc358eeb982e6609ca7dbb7b0d1ec..7e3b3a781f6f0cf0706f85e4273073d600e323ac 100644
--- a/boards/beaglebone/blue/accessories.rst
+++ b/boards/beaglebone/blue/accessories.rst
@@ -279,4 +279,4 @@ Bluetooth devices
=====================
- `WowWee Groove Cube
- Speaker <https://github.com/beagleboard/beaglebone-blue/wiki/One-Liner-Module-Tests#Grove_I2C_modules>`__
+ Speaker <https://git.beagleboard.org/beagleboard/beaglebone-blue/-/wikis/One-Liner-Module-Tests#grove-i2c-modules>`__
diff --git a/boards/beaglebone/blue/faq.rst b/boards/beaglebone/blue/faq.rst
index ec2ba53d129d83ec539b21a652d3351a118bf95c..95591305731a2d9fa2877e6809a468885459062a 100644
--- a/boards/beaglebone/blue/faq.rst
+++ b/boards/beaglebone/blue/faq.rst
@@ -101,7 +101,7 @@ I'm running an image off of a microSD card. How do I write it to the on-board eM
==========================================================================================
Refer to the "Flashing Firmware" page:
-https://github.com/beagleboard/beaglebone-blue/wiki/Flashing-firmware
+https://git.beagleboard.org/beagleboard/beaglebone-blue/-/wikis/Flashing-firmware
Meanwhile, as root, run the
/opt/scripts/tools/eMMC/bbb-eMMC-flasher-eewiki-ext4.sh script which
@@ -136,7 +136,7 @@ One you’ve booted the latest image, you can update the bootloader on the
eMMC using
`/opt/scripts/tools/developers/update_bootloader.sh <https://github.com/RobertCNelson/boot-scripts/blob/master/tools/developers/update_bootloader.sh>`__.
Better yet, read the `above
-FAQ <https://github.com/beagleboard/beaglebone-blue/wiki/Frequently-Asked-Questions-%28FAQ%29#Im_running_an_image_off_of_a_microSD_card_How_do_I_write_it_to_the_onboard_eMMC_flash>`__
+FAQ <https://git.beagleboard.org/beagleboard/beaglebone-blue/-/wikis/Frequently-Asked-Questions-(FAQ)#Im_running_an_image_off_of_a_microSD_card_How_do_I_write_it_to_the_onboard_eMMC_flash>`__
on flashing firmware.
.. _ive_got_my_on_board_emmc_flash_configured_in_a_nice_way._how_do_i_copy_that_to_other_beaglebone_blue_boards:
diff --git a/boards/beaglebone/blue/pinouts.rst b/boards/beaglebone/blue/pinouts.rst
index 92fc416d45517b8c2f800e206773c8a041ff1088..fbbc4b5d6421828ca34478f764c68e7d2f6a6a9f 100644
--- a/boards/beaglebone/blue/pinouts.rst
+++ b/boards/beaglebone/blue/pinouts.rst
@@ -11,10 +11,10 @@ BeagleBone Blue Pinouts
:align: center
- Connector pinout
- `details <https://github.com/beagleboard/beaglebone-blue/blob/master/BeagleBone_Blue_sch.pdf>`__
+ `details <https://git.beagleboard.org/beagleboard/beaglebone-blue/-/blob/master/BeagleBone_Blue_sch.pdf>`__
from schematic(s)
- `Pin
- Table <https://github.com/beagleboard/beaglebone-blue/blob/master/BeagleBone_Blue_Pin_Table.csv>`__
+ Table <https://git.beagleboard.org/beagleboard/beaglebone-blue/-/blob/master/BeagleBone_Blue_Pin_Table.csv>`__
with some Blue : Black corelation.
UT1
diff --git a/boards/pocketbeagle/original/ch03.rst b/boards/pocketbeagle/original/ch03.rst
index bfce920a4b8bab4e2d792def2a3061220a0c8905..5cb7fa272f894ef329327f4b87b327929c34753f 100644
--- a/boards/pocketbeagle/original/ch03.rst
+++ b/boards/pocketbeagle/original/ch03.rst
@@ -338,5 +338,5 @@ The board can be configured in several different ways. Future revisions
of this document may include additional configurations.
As other examples become documented, we'll update them on the Wiki for
-PocketBeagle `github.com/beagleboard/pocketbeagle/wiki <https://github.com/beagleboard/pocketbeagle/wiki>`__
+PocketBeagle `PocketBeagle WiKi <https://git.beagleboard.org/beagleboard/pocketbeagle/-/wikis/home>`__
See also the `on-line discussion. <https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!msg/beagleboard/JtOGZb-FH2A/9GVu7I6kAQAJ>`__
diff --git a/boards/pocketbeagle/original/ch06.rst b/boards/pocketbeagle/original/ch06.rst
index 664f32640ff30cd2ff0f5058e46586b7b9267b5d..bac52e924026b9ccb3dfea9c82b50ce996a73767 100644
--- a/boards/pocketbeagle/original/ch06.rst
+++ b/boards/pocketbeagle/original/ch06.rst
@@ -5,7 +5,7 @@ Detailed Hardware Design
The following sections contain schematic references for PocketBeagle.
Full schematics in both PDF and Eagle are available on the
-`'PocketBeagle Wiki' <https://github.com/beagleboard/pocketbeagle>`__
+`'PocketBeagle Wiki' <https://git.beagleboard.org/beagleboard/pocketbeagle>`__
.. _osd3358_sm_sip_design:
diff --git a/boards/pocketbeagle/original/ch07.rst b/boards/pocketbeagle/original/ch07.rst
index 41f8943e4ed4858ec601a40590badce265e2ed85..e4a3efbefb9a0762e3546ec5b5d8773b7f77224b 100644
--- a/boards/pocketbeagle/original/ch07.rst
+++ b/boards/pocketbeagle/original/ch07.rst
@@ -289,7 +289,7 @@ Figure 46, with one Click Board facing each direction. When choosing
Click boards, make sure you are checking that they meet the 3.3V
requirements for PocketBeagle. A growing number of community members are
trying out various Click Boards and posting results on the
-`'PocketBeagle Wiki mikroBus Click Boards page' <https://github.com/beagleboard/pocketbeagle/wiki/mikroBus%E2%84%A2-Click-Boards>`__.
+`'PocketBeagle Wiki mikroBus Click Boards page' <https://git.beagleboard.org/beagleboard/pocketbeagle/-/wikis/mikroBus%E2%84%A2-Click-Boards>`__.
.. figure:: images/46fig-PB-Mikro.png
:align: center
@@ -305,7 +305,7 @@ Setting up an additional USB Connection
You can add an additional USB connection to PocketBeagle easily by
connecting a microUSB breakout. By default in the current software, the
system should be configured to use this port as a host. Keep up to date
-on this project on the `'PocketBeagle Wiki FAQ' <https://github.com/beagleboard/pocketbeagle/wiki/FAQ>`__.
+on this project on the `'PocketBeagle Wiki FAQ' <https://git.beagleboard.org/beagleboard/pocketbeagle/-/wikis/FAQ>`__.
.. image:: images/PocketBeagle_microUSB_bb1.png
:align: center
\ No newline at end of file
diff --git a/boards/pocketbeagle/original/ch09.rst b/boards/pocketbeagle/original/ch09.rst
index 6e9b5a02b448f3a9db641c2f5aba975ac18d38f0..38df508c0d4070ff88cebb752a9cdea54143ff22 100644
--- a/boards/pocketbeagle/original/ch09.rst
+++ b/boards/pocketbeagle/original/ch09.rst
@@ -23,4 +23,4 @@ RoHS Compliant: Yes
Weight: 10g
Rough model can be found at
-`github.com/beagleboard/pocketbeagle/tree/master/models <https://github.com/beagleboard/pocketbeagle/tree/master/models>`__
\ No newline at end of file
+`PocketBeagle models <https://git.beagleboard.org/beagleboard/pocketbeagle/-/tree/master/models>`__
\ No newline at end of file
diff --git a/boards/pocketbeagle/original/ch11.rst b/boards/pocketbeagle/original/ch11.rst
index 4cfd9db8cb99b2ca0d40a11ca0d9de56f185c847..5a7eb7490cff68824551880e1f530355c77f2436 100644
--- a/boards/pocketbeagle/original/ch11.rst
+++ b/boards/pocketbeagle/original/ch11.rst
@@ -14,17 +14,17 @@ Hardware Design
~~~~~~~~~~~~~~~~~~~~
Design documentation can be found on the wiki.
-https://github.com/beagleboard/pocketbeagle Including:
+https://git.beagleboard.org/beagleboard/pocketbeagle/ Including:
- Schematic in PDF
- https://github.com/beagleboard/pocketbeagle/blob/master/PocketBeagle_sch.pdf
+ https://git.beagleboard.org/beagleboard/pocketbeagle/-/blob/master/PocketBeagle_sch.pdf
- Schematic and layout in EAGLE
- https://github.com/beagleboard/pocketbeagle/tree/master/EAGLE
+ https://git.beagleboard.org/beagleboard/pocketbeagle/-/tree/master/EAGLE
- Schematic and layout in KiCAD
- https://github.com/beagleboard/pocketbeagle/tree/master/KiCAD
+ https://git.beagleboard.org/beagleboard/pocketbeagle/-/tree/master/KiCAD
- Bill of Materials
- https://github.com/beagleboard/pocketbeagle/blob/master/PocketBeagle_BOM.csv
-- System Reference Manual https://github.com/beagleboard/pocketbeagle.
+ https://git.beagleboard.org/beagleboard/pocketbeagle/-/blob/master/PocketBeagle_BOM.csv
+- :ref:`pocketbeagle-home` docs.
.. _software_updates:
@@ -45,7 +45,7 @@ Export Information
- ECCN: EAR99
- CCATS: G173833
- Documentation:
- `github.com/beagleboard/pocketbeagle/blob/master/regulatory/PocketBeagle_Export_Classification.pdf <https://github.com/beagleboard/pocketbeagle/blob/master/regulatory/PocketBeagle_Export_Classification.pdf>`__
+ `PocketBeagle_Export_Classification.pdf <https://git.beagleboard.org/beagleboard/pocketbeagle/-/blob/master/regulatory/PocketBeagle_Export_Classification.pdf>`__
.. _rma_support:
@@ -65,7 +65,7 @@ Getting Help
If you need some up to date troubleshooting techniques, the Wiki is a
great place to start
-`github.com/beagleboard/pocketbeagle/wiki <https://github.com/beagleboard/pocketbeagle/wiki>`__.
+`PocketBeagle wiki <https://git.beagleboard.org/beagleboard/pocketbeagle/-/wikis/home>`__.
If you need professional support, check out
`beagleboard.org/resources <https://beagleboard.org/resources>`__.
diff --git a/books/pru-cookbook/01case/case.rst b/books/pru-cookbook/01case/case.rst
index 01a9e92b8acc37cdec043192b9f1da4b53a8226b..3094ffae3381f8f542c280afc645df0a99018a85 100644
--- a/books/pru-cookbook/01case/case.rst
+++ b/books/pru-cookbook/01case/case.rst
@@ -195,7 +195,7 @@ Solution
---------
You can modify ``rc_test_servos.c``. You'll find it on the bone online at
-https://github.com/beagleboard/librobotcontrol/blob/master/examples/src/rc_test_servos.c.
+https://git.beagleboard.org/beagleboard/librobotcontrol/-/blob/master/examples/src/rc_test_servos.c
Just past line 250 you'll find a ``while`` loop that has calls to ``rc_servo_send_pulse_normalized(ch,servo_pos)`` and
``rc_servo_send_pulse_us(ch, width_us)``. The first call sets the pulse width relative to the pulse period; the other
diff --git a/books/pru-cookbook/08ai/ai.rst b/books/pru-cookbook/08ai/ai.rst
index bf503c7f8b2c4e0a3c3f53595eb1005b212cb639..95f69e9f5f0033134ddfaa5e81c2c9d7583d41da 100644
--- a/books/pru-cookbook/08ai/ai.rst
+++ b/books/pru-cookbook/08ai/ai.rst
@@ -260,7 +260,7 @@ Discission
-----------
Suppose you want to make ``P9_31`` a PRU output pin. First go to the
-`am5729 System Reference Manual <https://github.com/beagleboard/beaglebone-ai/wiki/System-Reference-Manual#p8.10-p8.13>`_
+`am5729 System Reference Manual <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/System-Reference-Manual>`_
and look up ``P9_31``.
.. tip::
diff --git a/intro/support/getting-started.rst b/intro/support/getting-started.rst
index 4b3bc58f420bf7477a4c016db33aa8c4b44403a2..434d35116fcbea0038e56ab94166e346b5924d49 100644
--- a/intro/support/getting-started.rst
+++ b/intro/support/getting-started.rst
@@ -81,17 +81,17 @@ Power and boot
Most Beagles can be powered via a USB cable, providing a convenient way to provide both power to your
Beagle and connectivity to your computer. Be sure the cable is of good quality and your source can provide enough power.
-Alternatively, your Beagle may have a barrel jack.
+Alternatively, your Beagle may have a barrel jack which can take power from a wall adapter.
+Checkout :ref:`accessories-power-supplies` to get the correct adapter for your Beagle.
-.. Note::
- Use only a 5V center positive adapter for all Beagles except BeagleBone Blue and BeagleBoard-X15 (12V).
+.. Danger::
+ Make sure to use only a 5V center positive adapter for all Beagles except BeagleBone Blue and BeagleBoard-X15 (12V).
If you are using your Beagle with an `SD (microSD) card <https://en.wikipedia.org/wiki/Secure_Digital>`_, make sure it is inserted ahead of providing power.
Most Beagles include programmed on-board flash and therefore do not require an SD card to be inserted.
You'll see the power (PWR or ON) LED lit steadily. Within a minute or so, you should see the other LEDs
-blinking in their default configurations. Consult the Quick Start Guide (QSG) or System Reference
-Manual (SRM) for your board to locate these LEDs.
+blinking in their default configurations. Consult your :ref:`boards` documentation to locate these LEDs.
- USR0 is typically configured at boot to blink in a heartbeat pattern.
- USR1 is typically configured at boot to light during SD (microSD) card accesses.
@@ -122,7 +122,12 @@ network will add a suffix such as beaglebone-2.local.
Browse to your Beagle
============================
-A web server with an IDE should be running on your Beagle. Point your browser to it to begin development.
+A web server with an Visual Studio Code (IDE) should be running on your Beagle.
+Point your browser to **http://192.168.7.2:3000** to begin development.
+
+.. image:: images/vscode.png
+ :align: center
+ :alt: Visual Studio Code
.. NOTE::
Use either `Firefox <https://www.mozilla.org/firefox>`_ or `Chrome <https://www.google.com/chrome>`_
@@ -205,8 +210,7 @@ an older operating system or need additional drivers for serial access to older
Hardware documentation
**********************
-Be sure to check check the latest hardware documentation for your board at https://docs.beagleboard.org.
-
+Be sure to check check the latest hardware documentation for your board at https://docs.beagleboard.org.
Detailed design materials for various boards can be found at https://git.beagleboard.org/explore/projects/topics/boards.
Books
diff --git a/intro/support/images/beagle-version-download.png b/intro/support/images/beagle-version-download.png
new file mode 100644
index 0000000000000000000000000000000000000000..0a745f42e72122b189d73a634d1125f75e8ab111
Binary files /dev/null and b/intro/support/images/beagle-version-download.png differ
diff --git a/intro/support/images/beagle-version.png b/intro/support/images/beagle-version.png
new file mode 100644
index 0000000000000000000000000000000000000000..e6f0bd0115393a1b0e1f32b8a3b6b2c8bde94ac0
Binary files /dev/null and b/intro/support/images/beagle-version.png differ
diff --git a/intro/support/images/vscode.png b/intro/support/images/vscode.png
new file mode 100644
index 0000000000000000000000000000000000000000..c4c83104dd5e730ad045372c99018c401c50d670
Binary files /dev/null and b/intro/support/images/vscode.png differ
diff --git a/intro/support/index.rst b/intro/support/index.rst
index 1013b6da30ed1383eea013220d150b982e1b60a6..b8d71cc66ff983e69352f5adf4e13f62067b9c75 100644
--- a/intro/support/index.rst
+++ b/intro/support/index.rst
@@ -4,7 +4,7 @@ Support
#########
.. note:: #TODO# all the links need updating and content moved into
- `this repo <https://git.beagleboard.org/docs/docs.beagleboard.io>`_, especially bone101.
+ `this repo <https://git.beagleboard.org/docs/docs.beagleboard.io>`_, especially :ref:`intro_bone101`.
Getting started
***************
@@ -24,18 +24,18 @@ Getting support
***************
BeagleBoard.org products and `open
-hardware <https://www.oshwa.org/definition/>`__ designs are supported
+hardware <https://www.oshwa.org/definition/>`_ designs are supported
via the on-line community resources. We are very confident in our
community’s ability to provide useful answers in a timely manner. If you
don’t get a productive response within 24 hours, please escalate issues
to Jason Kridner (contact info available on the `About
-Page <https://beagleboard.org/about>`__). In case it is needed, Jason
+Page <https://beagleboard.org/about>`_). In case it is needed, Jason
will help escalate issues to suppliers, manufacturers or others. Be sure
to provide a link to your questions on the `community
-forums <https://forum.beagleboard.org>`__ as answers will be provided
+forums <https://forum.beagleboard.org>`_ as answers will be provided
there.
-Be sure to ask `smart questions <http://www.catb.org/~esr/faqs/smart-questions.html>`__
+Be sure to ask `smart questions <http://www.catb.org/~esr/faqs/smart-questions.html>`_
that provide the following:
* What are you trying to accomplish?
@@ -52,14 +52,22 @@ that provide the following:
Diagnostic tools
================
-Best to be prepared with good diagnostic information to aide with
-support.
-
-.. note::
- #TODO#: Need a reference to how to run `beagle-version`.
+Best to be prepared with good diagnostic information to aide with support.
- Output of `beagle-version` script needed for support requests
-- `Beagle Tester source <https://git.beagleboard.org/jkridner/beagle-tester>`__
+- `Beagle Tester source <https://git.beagleboard.org/jkridner/beagle-tester>`_
+
+.. figure:: images/beagle-version.png
+ :align: center
+ :alt: Run beagle-version
+
+.. figure:: images/beagle-version-download.png
+ :align: center
+ :alt: Download beagle-version output
+
+.. tip::
+ You can send the beagle-version.txt you just downloaded or you can use paste output
+ from terminal to https://pastebin.com/ and send us the link of your beagle-version output.
Community resources
===================
@@ -70,19 +78,18 @@ BeagleBoard.org is a “community†project with free support only given to
those who are willing to discussing their issues openly for the benefit
of the entire community.
-- `Frequently Asked Questions <https://forum.beagleboard.org/c/faq>`__
-- `Mailing List <https://forum.beagleboard.org>`__
-- `Live Chat <https://beagleboard.org/chat>`__
+- `Frequently Asked Questions <https://forum.beagleboard.org/c/faq>`_
+- `Mailing List <https://forum.beagleboard.org>`_
+- `Live Chat <https://beagleboard.org/chat>`_
.. _consulting-resources:
Consulting and other resources
==============================
-Need timely response or contract resources because you are building a
-product?
+Need timely response or contract resources because you are building a product?
-- `Resources <https://beagleboard.org/resources>`__
+- `Resources <https://beagleboard.org/resources>`_
Repairs
=======
@@ -90,27 +97,29 @@ Repairs
Repairs and replacements only provided on unmodified boards purchased
via an authorized distributor within the first 90 days. All repaired
board will have their flash reset to factory contents. For repairs and
-replacements, please contact ‘support’ at BeagleBoard.org using the RMA
+replacements, please contact ``support`` at BeagleBoard.org using the RMA
form:
-- `RMA request <https://www.beagleboard.org/rma>`__
+- `RMA request <https://www.beagleboard.org/rma>`_
Understanding Your Beagle
*************************
-- `BeagleBone Introduction <https://beagleboard.org/Support/bone101>`__
-- `Hardware <https://beagleboard.org/Support/Hardware+Support>`__
-- `Software <https://beagleboard.org/Support/Software+Support>`__
-- `Books <https://beagleboard.org/books>`__
+- :ref:`intro_bone101`
+- `Hardware <https://beagleboard.org/Support/Hardware+Support>`_
+- `Software <https://beagleboard.org/Support/Software+Support>`_
+- :ref:`books-home`
- - `Exploring BeagleBone <https://beagleboard.org/ebb>`__
- - `BeagleBone Cookbook <https://beagleboard.org/cookbook>`__
- - `Bad to the Bone <https://beagleboard.org/bad-to-the-bone>`__
+ - :ref:`pru-cookbook-home`
+ - :ref:`bone-cook-book-home`
+ - `Exploring BeagleBone <https://beagleboard.org/ebb>`_
+ - `Bad to the Bone <https://beagleboard.org/bad-to-the-bone>`_
Working with Cape Add-on Boards
*******************************
- :ref:`capes`
- :ref:`beaglebone-cape-interface-spec`
+- :ref:`accessories-home`