diff --git a/index-tex.rst b/index-tex.rst index 0f359fc099ef12be697169c9acac963a155d9a89..e9f35092f5eabc83f9816e50197cbc5fbcf8a4d0 100644 --- a/index-tex.rst +++ b/index-tex.rst @@ -10,6 +10,7 @@ BeagleBoard Docs .. toctree:: + intro/blinkLED intro/index.rst boards/beagleplay/index boards/beaglebone/ai-64/index diff --git a/index.rst b/index.rst index f7645c7ae0b6bc0c3e65a5db43b132d67e83f1bf..2696bea737efbe0756043f5a3eabfc465943c4a8 100644 --- a/index.rst +++ b/index.rst @@ -30,6 +30,7 @@ Get started engaging the BeagleBoard.org developer community by reading our :ref :hidden: :caption: Introduction + /intro/blinkLED /intro/support/index /intro/beagle101/index /intro/contribution/index diff --git a/intro/blinkLED.rst b/intro/blinkLED.rst new file mode 100644 index 0000000000000000000000000000000000000000..bce48d34ff0ca584b4aba4c2378ea2b74e046b98 --- /dev/null +++ b/intro/blinkLED.rst @@ -0,0 +1,85 @@ +.. + BeagleBoard projects Blink LED demo + +.. _blinkLED: + +Blink LED +######### + +The "Hello World!" of the embedded world is to blink and LED. +Here we'll show you hw to do just that in three simple steps. + +#. Plug in the Beagle +#. Log into the Beagle +#. Blink the LED + +These steps will work for any of the Beagles. + +Plug in the Beagle +------------------ + +For this step you need to get a USB cable and attached your Beagle +to your host computer with it. +Once attached you will see some LEDs blinking. +Wait a bit and the blinks will settle down to a steady +heart beat. + +The Beagle is now up and running, but you didn't have to +load up Linux. This is because all Beagles +(except the PocketBeagle) have built-in flash memory +that has the Debian distribution of Linux preinstalled. + +Login +----- + +Next you login to the Beagle from your host computer. +This is slightly different if you host is running Windows. + +Login from Windows +^^^^^^^^^^^^^^^^^^ + +If you are running Window you need to run an ``ssh`` client +to connect to the Beagle. I suggest you use ``putty``. +You can download it here: https://www.putty.org/. +Once installed, launch it and connect to your Beagle +by sshing to ``192.168.7.2``. Login with user ``debian`` +and password ``temppwd``. + +Login from Linux +^^^^^^^^^^^^^^^^ + +If you are running a Linux host, open a terminal widow and run + +.. code-block:: shell-session + + host:~$ ssh debian@192.168.7.2 + +Use password ``temppwd``. + +Blink the LED +------------- + +One logged in the rest is easy. First: + +.. code-block:: shell-session + + bone:~$ cd /sys/class/LEDs + bone:~$ ls + beaglebone:green:usr0 beaglebone:green:usr2 mmc0:: + beaglebone:green:usr1 beaglebone:green:usr3 mmc1:: + +Here you see a list of LEDs. Your list may be slightly +different depending on which Beagle you are running. +You can blink any of them. Let's try usr1. + +.. code-block:: shell-session + + bone:~$ cd beaglebone\:green\:usr1/ + bone:~$ ls + brightness device max_brightness power subsystem trigger uevent + bone:~$ echo 1 > brightness + bone:~$ echo 0 > brightness + +When you echo 1 into ``brightness`` the LED turns on. +Echoing a 0 turns it off. Congratulations! you've blinked +your first LED.