Forum | Documentation | Website | Blog

Skip to content
Snippets Groups Projects
Commit d5f1afb4 authored by Jason Kridner's avatar Jason Kridner
Browse files

Merge branch 'main' of git.beagleboard.org:lorforlinux/docs.beagleboard.io

parents 49a2d8df 2c210ab3
Branches
Tags
No related merge requests found
......@@ -6,35 +6,37 @@ Cables
USB Cables
***********
A miniUSB cable will normally be supplied with the BeagleBone Black. For other boards like PocketBeagle, BeagleBone AI & BeagleBone AI-64 you'll have to procure your own USB cable.
A USB (Type Mini B) cable will normally be supplied with the BeagleBone Black. For other boards
like PocketBeagle, BeagleBone AI & BeagleBone AI-64 you'll have to procure your own USB cable. The
type of cable you have to procure is listed in the table below:
.. table:: USB ports on BeagleBone hardware
+----------------------------+--------------+
| Board | USB type |
+============================+==============+
| BeaglePlay | USB-C |
+----------------------------+--------------+
| BeagleV-Fire | USB-C |
+----------------------------+--------------+
| BeagleBone AI | USB-C |
+----------------------------+--------------+
| BeagleBone AI-64 | USB-C |
+----------------------------+--------------+
| BeagleV-Ahead | microUSB 3.0 |
+----------------------------+--------------+
| BeagleBone Black | miniUSB |
+----------------------------+--------------+
| PocketBeagle | microUSB |
+----------------------------+--------------+
| BeagleBone Blue | microUSB |
+----------------------------+--------------+
| BeagleBone Black Wireless | microUSB |
+----------------------------+--------------+
| BeagleBone xM | miniUSB |
+----------------------------+--------------+
| BeagleBone X15 | microUSB |
+----------------------------+--------------+
+----------------------------+----------------------+
| Board | USB |
+============================+======================+
| BeaglePlay | Type C |
+----------------------------+----------------------+
| BeagleV-Fire | Type C |
+----------------------------+----------------------+
| BeagleBone AI | Type C |
+----------------------------+----------------------+
| BeagleBone AI-64 | Type C |
+----------------------------+----------------------+
| BeagleV-Ahead | Type Micro B USB 3.0 |
+----------------------------+----------------------+
| BeagleBone Black | Type Mini-B |
+----------------------------+----------------------+
| PocketBeagle | Type Micro B |
+----------------------------+----------------------+
| BeagleBone Blue | Type Micro B |
+----------------------------+----------------------+
| BeagleBone Black Wireless | Type Micro B |
+----------------------------+----------------------+
| BeagleBone xM | Type Mini B |
+----------------------------+----------------------+
| BeagleBone X15 | Type Micro B |
+----------------------------+----------------------+
.. _serial-debug-cables:
......@@ -63,8 +65,9 @@ JST-SH serial cables
====================
These cables are not active (only wries and connector) and provide an interface
between USB to Serial converter cables such as the ones listed below and serial debug ports on Beagles such as the BeagleBone AI
and AI-64. You can purchase these cables from different sources including:
between USB to Serial converter cables such as the ones listed below and serial
debug ports on Beagles such as BeagleBone AI and AI-64. You can purchase these
cables from different sources including:
1. `Farnell <https://www.newark.com/element14/1103004000156/serial-cable-ai-board/dp/50AH3702>`_
2. `DigiKey <https://www.digikey.com/en/products/detail/digi-key-electronics/BBCAI/10187731>`_
......@@ -81,7 +84,8 @@ It can purchased from several different sources including but not limited to:
- `FTDI serial cable at Sparkfun <https://www.sparkfun.com/products/9717>`_
- `FTDI serial cable at Adafruit <https://www.adafruit.com/products/70>`_
Other options with different USB to Serial ICs exist and will work as well, such as CP2102, CH340G etc but may require additional drivers depending on your operating system.
Other options with different USB to Serial ICs exist and will work as well, such as CP2102, CH340G
etc but may require additional drivers depending on your operating system.
.. image:: images/FTDI_Cable.jpg
:align: center
......@@ -165,7 +169,7 @@ Working miniDP to HDMI Adapters
- `CableCreation Mini DP (Thunderbolt 2 Compatible) to HDMI <https://www.amazon.in/CD0257-Mini-DP-to-HDMI/dp/B01FM51O0W/>`_
Examples of "Bad" MiniDP to HDMI Adapters
=================================
===========================================
- `UGREEN Mini DP Male to HDMI <https://www.amazon.in/Mini-Male-Female-Converter-Cable/dp/B01CL1P6TA/>`_
- `AGARO Mini Displayport (Mini Dp) To Hdmi <https://www.amazon.in/AGARO-Meters-Laptop-Computers-Mobile/dp/B09GW1NMNZ/>`_
......
......@@ -4,12 +4,10 @@ Displays
#########
Monitors and Resolutions
=========================
*************************
Verified Desktop Monitors
-------------------
==========================
The following monitors and resolutions have been tested for operation with the BeagleBone Black.
Check here often as we will update the list as we confirm the operation. Let
......@@ -37,12 +35,12 @@ Links are not provided as they change frequently. So, search on the model number
- Sharp Aquos TV Dell S244OL 1920 x 1080 @60HZ
Unsupported Monitors
---------------------
=====================
LG 37LH30 - did not seem to work, the display didn't even recognize that anything was plugged in at all.
Verified Televisions
-----------------------
=====================
The following TVs and resolutions have been tested for operation with the BeagleBone Black. Check here often as we will update the list as we confirm the operation.
If you have a TV that works fine, let us know the model and resolution at which it works and we will add it to the list. Only the highest resolution is listed below.
......@@ -54,7 +52,7 @@ Vizio E322VL 1920x1080 @24Hz.
Panasonic TX-L19X10BW 1280x720 @60Hz.
Unsupported Televisions
------------------------
========================
.. tip::
If you don't have a monitor/TV you can use a Video Captiure Card like
......
......@@ -16,6 +16,7 @@ Keyboard & Mouse combos.
- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.com/ProductDetail/Adafruit/1738?qs=GURawfaeGuBoaqdx8E%2Fl7w%3D%3D>`_
- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
- `Portronics Key2-A Combo of Multimedia Wireless Keyboard & Mouse <https://www.amazon.in/Portronics-Combo-Multimedia-Wireless-Light-Weight/dp/B07X1KRPDZ/>`_
Keyboards
************
......
......@@ -63,7 +63,10 @@ Perform the post installation steps as described in the html file opened when yo
Install the Libero licensing daemon
************************************
Download the 64 bit Licensing Daemons from the `Microchip's daemons section <http://ww1.microchip.com/downloads/aemdocuments/documents/fpga/media-content/FPGA/daemons/Linux_Licensing_Daemon_11.16.1_64-bit.tar.gz>`_
Download the 64 bit Licensing Daemons from the `Microchip's daemons section <https://www.microchip.com/en-us/products/fpgas-and-plds/fpga-and-soc-design-tools/fpga/licensing>`_
* `Linux_Licensing_Daemon_11.16.1_64-bit.tar.gz <https://ww1.microchip.com/downloads/aemdocuments/documents/fpga/media-content/FPGA/daemons/Linux_Licensing_Daemon_11.16.1_64-bit.tar.gz>`_
* `Windows_Licensing_Daemon_11.16.1_64-bit.zip <https://ww1.microchip.com/downloads/aemdocuments/documents/fpga/media-content/FPGA/daemons/Windows_Licensing_Daemon_11.16.1_64-bit.zip>`_
Copy the downloaded file to the Microchip directory within your home directory and untar it.
......@@ -104,7 +107,7 @@ Download tool setup script
.. code-block::
git clone https://github.com/vauban353/Microchip-FPGA-Tools-Setup.git
git clone https://git.beagleboard.org/beaglev-fire/Microchip-FPGA-Tools-Setup
Source the script:
......
......@@ -16,7 +16,7 @@ Here we'll show you how to do just that in three simple steps.
These steps will work for any of the Beagles.
Plug in the Beagle
------------------
*******************
For this step you need to get a USB cable and attach your Beagle
to your host computer with it. Where you attached the cable
......@@ -28,19 +28,17 @@ depends on which Beagle you have. Click on the tab for your board.
.. figure:: figures/image8.jpg
:width: 632px
:height: 166px
:align: center
:alt: Tethered Configuration
Tethered Configuration
Tethered Configuration
.. figure:: figures/image9.jpg
:width: 451px
:height: 206px
:align: center
:alt: USB Connection to the Board
Mini USB Connection to the Board as seen from the bottom.
Mini USB Connection to the Board as seen from the bottom.
For more details see: :ref:`beagleboneblack-connectivity`
......@@ -51,7 +49,7 @@ depends on which Beagle you have. Click on the tab for your board.
:align: center
:alt: USB Connection to the Blue
Micro USB Connection to the Blue
Micro USB Connection to the Blue
.. group-tab:: AI-64
......@@ -60,28 +58,28 @@ depends on which Beagle you have. Click on the tab for your board.
:align: center
:alt: Tethered Configuration
Tethered Configuration
Tethered Configuration
.. figure:: figures/usb-c-connection.jpg
:width: 400px
:align: center
:alt: USB Connection to the Board
USB-c Connection to the Board
USB-c Connection to the Board
.. figure:: figures/usb-a-connection.jpg
:width: 400px
:align: center
:alt: USB Connection to the PC/Laptop
USB Connection to the PC/Laptop
USB Connection to the PC/Laptop
.. figure:: figures/power-led.jpg
:width: 400px
:align: center
:alt: Board Power LED
Board Power LED
Board Power LED
For more details see: :ref:`connecting-up-your-beaglebone-ai-64`
......@@ -92,7 +90,7 @@ depends on which Beagle you have. Click on the tab for your board.
:align: center
:alt: Tethering BeaglePlay to PC
Tethering BeaglePlay to PC
Tethering BeaglePlay to PC
For more details see: :ref:`beagleplay-quick-start`
......@@ -102,7 +100,7 @@ depends on which Beagle you have. Click on the tab for your board.
:align: center
:alt: Tethered Configuration
Micro USB Connection
Micro USB Connection
For more details see: :REF:`connecting_up_pocketbeagle`
......@@ -116,69 +114,67 @@ load up Linux. This is because all Beagles
to install an image on the Pocket) have built-in flash memory
that has the Debian distribution of Linux preinstalled.
Login
-----
Using VS Code
**************
Next you login to the Beagle from your host computer.
Here you have a choice. If you want a graphical approach,
choose the ``VS Code`` tab. If you want a command line
and your host is a Mac, take the ``ssh (Mac)`` tab. If you
are running Linux on your host,
take the ``ssh (Linux)`` tab. Finally take the
``putty (Windows)`` tab for command line from Windows.
.. important:: If VS code is not installed on your board please skip this section and refer
to next section on how to login and run the code via command line.
.. tabs::
Recent Beagles come with the IDE Visual Studio Code (https://code.visualstudio.com/) installed and
running. To access it, open a web browser on your host computer and browse to: ``192.168.7.2:3000``
(use ``192.168.6.2:3000`` for the Mac) and you will see something like:
.. group-tab:: VS Code
.. figure:: figures/vscode1.png
:width: 740
:align: center
Recent Beagles come with the IDE Visual Studio Code
(https://code.visualstudio.com/) installed and
running. To access it, open a web browser on
your host computer and browse to: ``192.168.7.2:3000``
(use ``192.168.6.2:3000`` for the Mac)
and you will see something like:
At this point you can either run the scripts via a command line within VS Code, or
run them by clicking the ``RUN Code`` button.
.. figure:: figures/vscode1.png
At this point you can either run the scripts via a command
line within VS Code, or run them by clicking the
``RUN Code`` button.
Running via the command line
============================
Open a terminal window in VS Code by dropping down the ``Terminal`` menu and selecting ``New Terminal``
(or entering ``Ctrl+```). The terminal window appears at the bottom of the screen as shown below.
Running via the command line
.. figure:: figures/vscode3.png
:width: 740
:align: center
Open a terminal window in VS Code by dropping down the
``Terminal`` menu and selecting ``New Terminal`` (or entering
``Ctrl+Shift+```). The terminal window appears at the
bottom of the screen as shown below.
You can now enter commands and see them run as shown below.
.. figure:: figures/vscode3.png
.. figure:: figures/vscode4.png
:width: 740
:align: center
Running via the ``RUN`` button
===============================
You can now enter commands and see them run as shown below.
Use the file navigator on the left to navigate to ``examples/BeagleBone/Black/blinkInternalLED.sh`` and you will see:
.. figure:: figures/vscode4.png
.. figure:: figures/vscode2.png
:width: 740
:align: center
Running via the ``RUN`` button
This code blinks one of the USR LEDs built into the board. Click on the ``RUN Code`` triangle on the upper right of the
screen (see red arrow) to run the code. (You could also enter ``Ctrl+Alt+N``) The USR3 LED should now be blinking.
Use the file navigator on the left to navigate to
``examples/BeagleBone/Black/blinkInternalLED.sh``
and you will see:
Click on the ``Stop Code Run`` (``Ctrl+Alt+M``) square to the right of the ``Run Code`` button.
.. figure:: figures/vscode2.png
Time to play! Try changing the LED number (on line 10) from 3 to something else. Click the ``Run Code``
button (no need to save the file, autosave is on by default).
This code blinks one of the USR LEDs built into the board.
Click on the ``RUN Code`` triangle on the upper right of
the screen (see red arrow) to run the code. (You could also enter ``Ctrl+Alt+N``)
The USR3 LED should now be blinking.
Try running ``seqLEDs.py``.
Click on the ``Stop Code Run`` (``Ctrl+Alt+M``) square to the right of the
``Run Code`` button.
Using command line
******************
Time to play! Try changing the LED number (on line 10) from
3 to something else. Click the ``Run Code`` button (no
need to save the file, autosave is on by default).
To access the command line and your host is a Mac, take the ``ssh (Mac)`` tab. If you
are running Linux on your host, take the ``ssh (Linux)`` tab. Finally take the
``putty (Windows)`` tab for command line from Windows.
Try running ``seqLEDs.py``.
.. tabs::
.. group-tab:: ssh (Mac)
......@@ -214,7 +210,7 @@ take the ``ssh (Linux)`` tab. Finally take the
and password ``temppwd``.
Blink an LED
------------
============
Once logged in the rest is easy. First:
......@@ -253,7 +249,7 @@ Here you see a simple bash script that turns an LED
on and off. Enter Ctrl+c to stop the script.
Blinking via Python
-------------------
====================
Here's a script that sequences the LEDs on and off.
......@@ -287,7 +283,7 @@ Here's a script that sequences the LEDs on and off.
Again, hit Ctrl+c to stop the script.
Blinking from Command Line
--------------------------
==========================
You can control the LEDs from the command line.
......@@ -314,7 +310,7 @@ When you echo 1 into ``brightness`` the LED turns on.
Echoing a 0 turns it off.
Blinking other LEDs
-------------------
===================
You can blink the other LEDs by changing in to thier
directories and doing the same. Let's blink the USR0 LED.
......@@ -351,7 +347,7 @@ Try experimenting with some of the other triggers and see if you
can figure them out.
Another way to Blink an LED
---------------------------
===========================
An interesting thing about Linux is there are often many ways
to do the same thing. For example, I can think of at least five ways to blink
......@@ -394,7 +390,7 @@ Try it for the other LEDs.
version of Debian you are running.
Blinking in response to a button
---------------------------------
=================================
Some Beagles have a USR button that can be used to control the LEDs.
You can test the USR button with ``evtest``
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment