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

From eLinux.org
Jump to: navigation, search
m (Set Up Git: Switched to nano)
(28 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Category:ECE497]]
 
[[Category:ECE497]]
 
{{YoderHead}}
 
{{YoderHead}}
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.
 
  
== Set Up Git ==
+
You need to download some reference manuals and set up your Beagle with some extra filesHere's what to do.
 
 
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).
 
 
 
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 <code>ssh-keygen</code> which is needed to work with github.
 
 
 
On my host computer I had to run
 
  
host$ '''ssh-add id_rsa'''
+
== 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.
 +
# The official SRM is kept https://docs.beagleboard.org/0.0/boards/beaglebone/black/. You will want to bookmark this.
 +
# The TRM for the am335x  is on [http://www.ti.com/lit/pdf/spruh73 TI's site].
  
after running <code>ssh-keygen</code> to get <code>ssh -T git@github.com</code> to work.
+
Keep both of these in an easy to find place, we'll reference them now and then.
  
 
== Get the Files ==
 
== Get the Files ==
Line 25: Line 15:
 
It only takes one command to pull down all the files.
 
It only takes one command to pull down all the files.
  
  beagle$ '''git clone git@github.com:MarkAYoder/BeagleBoard-exercises.git exercises'''
+
  bone$ '''git clone https://github.com/MarkAYoder/BeagleBoard-exercises.git exercises --depth=1'''
 +
(The whole repo is some 700M.  Using '''--depth=1''' you only get the recent history and it only takes 200M.)
  
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.
+
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 if you haven't done so already.
  
  host$ '''git clone git@github.com:MarkAYoder/BeagleBoard-exercises.git exercises'''
+
  host$ '''git clone https://github.com/MarkAYoder/BeagleBoard-exercises.git exercises --depth=1'''
  
 
Now take a look at what you got.
 
Now take a look at what you got.
  
  beagle$ '''cd exercises'''
+
  bone$ '''cd exercises'''
  beagle$ '''ls'''
+
  bone$ '''ls'''
  beagle$ '''cd pptx'''
+
  bone$ '''cd pptx'''
  beagle$ '''ls'''
+
  bone$ '''ls'''
 +
 
 +
== Set Up Git ==
 +
 
 +
On ''both'' the host and the bone run:
 +
$ '''git config --global user.name "Mark A. Yoder"'''
 +
$ '''git config --global user.email Mark.A.Yoder@Rose-Hulman.edu​'''
 +
$ '''git config --global core. Editor nano'''
 +
Use your name and email address and your favorite editor.  This sets the global values.
  
 
Later exercises will tell you which files to use from here.
 
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.
+
== 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
  beagle$ '''git pull'''
+
host$ '''git clone https://github.com/derekmolloy/exploringBB.git'''
 +
  host$ '''cd exploringBB/chp06/docs'''
 +
  host$ '''ls'''
 +
BeagleboneBlackP8HeaderTable.pdf  BeagleboneBlackP9HeaderTable.pdf
 +
Put these where you can find them again.
  
 
{{YoderFoot}}
 
{{YoderFoot}}

Revision as of 08:42, 30 November 2022

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. The official SRM is kept https://docs.beagleboard.org/0.0/boards/beaglebone/black/. You will want to bookmark this.
  2. The TRM for the am335x is on TI's site.

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

Get the Files

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

bone$ git clone https://github.com/MarkAYoder/BeagleBoard-exercises.git exercises --depth=1

(The whole repo is some 700M. Using --depth=1 you only get the recent history and it only takes 200M.)

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 if you haven't done so already.

host$ git clone https://github.com/MarkAYoder/BeagleBoard-exercises.git exercises --depth=1

Now take a look at what you got.

bone$ cd exercises
bone$ ls
bone$ cd pptx
bone$ ls

Set Up Git

On both the host and the bone run:

$ git config --global user.name "Mark A. Yoder"
$ git config --global user.email Mark.A.Yoder@Rose-Hulman.edu​
$ git config --global core. Editor nano

Use your name and email address and your favorite editor. This sets the global values.

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

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 https://github.com/derekmolloy/exploringBB.git
host$ cd exploringBB/chp06/docs
host$ ls
BeagleboneBlackP8HeaderTable.pdf  BeagleboneBlackP9HeaderTable.pdf

Put these where you can find them again.




thumb‎ Embedded Linux Class by Mark A. Yoder