Difference between revisions of "EBC Exercise 05 Getting Exercise Support Materials"

From eLinux.org
Jump to: navigation, search
(Get the Files: Swtiched to read only git)
m (Set Up Git: Added instructions for setting up own git repository)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:ECE497]]
 
[[Category:ECE497]]
 
{{YoderHead}}
 
{{YoderHead}}
Many of the following exercises require some extra files on the BeagleBoardThese files are stored in a '''git''' repository. We'll learn more about using git laterHere I'll just show you how to get the files.
+
 
 +
You need to download some reference manuals and set up your Beagle with some extra files.  Here's what to do.
 +
 
 +
== Download Reference Manuals ==
 +
There are two important hardware reference manuals you need to have, the '''System Reference Manual''' (SRM) and the '''Technical Reference Manual''' (TRM) for the ARM processor. Here's where to find them.
 +
# [http://circuitco.com CircuitCo] has the [http://circuitco.com/support official reference materials] for the Bone. Click on the link for the Bone Black and then click on the ''Hardware Files'' link. Here you will find a link to a pdf file with the SRM.  Download it.
 +
# Finding the TRM is a bit trickier. Open the SRM you found in the previous step and find what processor it is using.  (Hint: page 52) You'll find a link to a TI site that has the manual.  Be sure you have the right one, it's some 18M and 4,100+ pages long.
 +
 
 +
Keep both of these in an easy to find place, we'll reference them now and then.
  
 
== Set Up Git ==
 
== Set Up Git ==
  
Go to [http://help.github.com/set-up-git-redirect github] and follow the directions for installing and setting up git.  No need to set up your own repository right now (unless you want to).
+
Many of the following exercises require some extra files on the BeagleBoard. These files are stored in a '''git''' repository. We'll learn more about using git laterHere I'll just show you how to get the files.
  
 
I suggest you do this for both your host computer and your Beagle.  On the Beagle use
 
I suggest you do this for both your host computer and your Beagle.  On the Beagle use
Line 13: Line 21:
 
  beagle$ '''opkg install openssh-keygen'''
 
  beagle$ '''opkg install openssh-keygen'''
  
The last opkg installs <code>ssh-keygen</code> which is needed to work with github.
+
The last opkg installs <code>ssh-keygen</code> which is needed to work with github. If <code>opkg</code> can't find it try:
 +
beagle$ '''wget http://www.rose-hulman.edu/~yoder/Beagle/ssh-keygen'''
 +
beagle$ '''chmod +x ssh-keygen'''
  
 
On my host computer I had to run
 
On my host computer I had to run
  
 +
host$ '''apt-get install git'''
 
  host$ '''ssh-add id_rsa'''
 
  host$ '''ssh-add id_rsa'''
  
after running <code>ssh-keygen</code> to get <code>ssh -T git@github.com</code> to work.
+
Now go to [https://help.github.com/articles/set-up-git github] and [https://help.github.com/articles/generating-ssh-keys generating-ssh-keys] and follow the directions for installing and setting up git using the ssh-keys method. Note:  The versions of git installed by opkg (1.7.7) and apt-get (1.7.9.5) aren't new enough to use the credential helper so (you need git 1.7.10 or newer) so you need to use the 2nd link above and use the ssh-keys method.
 +
 
 +
Set up your own repository, then go to [https://github.com/edu github's edu request] page and ask for a free upgrade.
 +
 
 +
Once you've followed the instructions on github check your setup with
 +
beagle$ '''ssh -T git@github.com'''
 +
Warning: untrusted X11 forwarding setup failed: xauth key data not generated
 +
Warning: No xauth data; using fake authentication data for X11 forwarding.
 +
X11 forwarding request failed on channel 0
 +
Hi MarkAYoder! You've successfully authenticated, but GitHub does not provide shell access.
 +
 
 +
Now you are ready to use github.
  
 
== Get the Files ==
 
== Get the Files ==
Line 43: Line 65:
  
 
  beagle$ '''git pull'''
 
  beagle$ '''git pull'''
 +
 +
=== P8 and P9 Header Files ===
 +
The BeagleBone Black has two headers, P8 and P9, that have lots of IO. There are two [http://derekmolloy.ie/gpios-on-the-beaglebone-black-using-device-tree-overlays/ pdf files] that have lots of information about the headers in this git repository.  Here's how to get them
 +
host$ '''git clone git://github.com/derekmolloy/boneDeviceTree.git'''
 +
host$ '''cd boneDeviceTree/docs'''
 +
host$ '''ls'''
 +
BeagleboneBlackP8HeaderTable.pdf  BeagleboneBlackP9HeaderTable.pdf
 +
Put these where you can find them again.
 +
 +
== Materials for later ==
 +
 +
Some later exercises will need the following additional git repositories.  You don't have to load them now, the exercises will tell you when to do it.
 +
 +
This will load Big Buck Bunny and some other media.
 +
beagle$ '''cd ~/exercises/gstreamer'''
 +
beagle$ '''git clone git://github.com/MarkAYoder/esc-media.git'''
 +
 +
This load the things needed for using the DSP.
 +
beagle$ '''cd ~/exercises/audioThru/lab06d_audio_c6run'''
 +
beagle$ '''git clone git://github.com/MarkAYoder/c6run_build.git'''
  
 
{{YoderFoot}}
 
{{YoderFoot}}

Latest revision as of 14:53, 5 September 2013

thumb‎ Embedded Linux Class by Mark A. Yoder


You need to download some reference manuals and set up your Beagle with some extra files. Here's what to do.

Download Reference Manuals

There are two important hardware reference manuals you need to have, the System Reference Manual (SRM) and the Technical Reference Manual (TRM) for the ARM processor. Here's where to find them.

  1. CircuitCo has the official reference materials for the Bone. Click on the link for the Bone Black and then click on the Hardware Files link. Here you will find a link to a pdf file with the SRM. Download it.
  2. Finding the TRM is a bit trickier. Open the SRM you found in the previous step and find what processor it is using. (Hint: page 52) You'll find a link to a TI site that has the manual. Be sure you have the right one, it's some 18M and 4,100+ pages long.

Keep both of these in an easy to find place, we'll reference them now and then.

Set Up Git

Many of the following exercises require some extra files on the BeagleBoard. These files are stored in a git repository. We'll learn more about using git later. Here I'll just show you how to get the files.

I suggest you do this for both your host computer and your Beagle. On the Beagle use

beagle$ opkg update
beagle$ opkg install git
beagle$ opkg install openssh-keygen

The last opkg installs ssh-keygen which is needed to work with github. If opkg can't find it try:

beagle$ wget http://www.rose-hulman.edu/~yoder/Beagle/ssh-keygen
beagle$ chmod +x ssh-keygen

On my host computer I had to run

host$ apt-get install git
host$ ssh-add id_rsa

Now go to github and generating-ssh-keys and follow the directions for installing and setting up git using the ssh-keys method. Note: The versions of git installed by opkg (1.7.7) and apt-get (1.7.9.5) aren't new enough to use the credential helper so (you need git 1.7.10 or newer) so you need to use the 2nd link above and use the ssh-keys method.

Set up your own repository, then go to github's edu request page and ask for a free upgrade.

Once you've followed the instructions on github check your setup with

beagle$ ssh -T git@github.com
Warning: untrusted X11 forwarding setup failed: xauth key data not generated
Warning: No xauth data; using fake authentication data for X11 forwarding.
X11 forwarding request failed on channel 0
Hi MarkAYoder! You've successfully authenticated, but GitHub does not provide shell access.

Now you are ready to use github.

Get the Files

It only takes one command to pull down all the files.

beagle$ git clone git://github.com/MarkAYoder/BeagleBoard-exercises.git exercises

This will take a while since it's getting all the course files, including pdf files of the course PowerPoint. You only have to clone once for each computer. I suggest you do the same on your host computer.

host$ git clone git://github.com/MarkAYoder/BeagleBoard-exercises.git exercises

Now take a look at what you got.

beagle$ cd exercises
beagle$ ls
beagle$ cd pptx
beagle$ ls

Later exercises will tell you which files to use from here.

If it's been a while since you did the clone it's a good idea to do a pull. This will make sure all the files are up to date.

beagle$ git pull

P8 and P9 Header Files

The BeagleBone Black has two headers, P8 and P9, that have lots of IO. There are two pdf files that have lots of information about the headers in this git repository. Here's how to get them

host$ git clone git://github.com/derekmolloy/boneDeviceTree.git
host$ cd boneDeviceTree/docs
host$ ls
BeagleboneBlackP8HeaderTable.pdf  BeagleboneBlackP9HeaderTable.pdf

Put these where you can find them again.

Materials for later

Some later exercises will need the following additional git repositories. You don't have to load them now, the exercises will tell you when to do it.

This will load Big Buck Bunny and some other media.

beagle$ cd ~/exercises/gstreamer
beagle$ git clone git://github.com/MarkAYoder/esc-media.git

This load the things needed for using the DSP.

beagle$ cd ~/exercises/audioThru/lab06d_audio_c6run
beagle$ git clone git://github.com/MarkAYoder/c6run_build.git




thumb‎ Embedded Linux Class by Mark A. Yoder