Difference between revisions of "Satellite CCRMA (Alpha Release)"

From CCRMA Wiki
Jump to: navigation, search
(Installing New Software)
Line 83: Line 83:
 
If your favorite linux software has been compiled for the ARM architecture, it may be available by way of the ''apt-get'' utility.  
 
If your favorite linux software has been compiled for the ARM architecture, it may be available by way of the ''apt-get'' utility.  
  
To get a list of packages available on the OMAP's ARM architecture, type <tt>sudo apt-cache pkgnames</tt>
+
* To get a list of packages available on the OMAP's ARM architecture, type <tt>sudo apt-cache pkgnames</tt>
  
You will notice that this list is way too long to look at. You can pipe it to the text file using the command
+
* You will notice that this list is way too long to look at. You can pipe it to the text file using the command
<tt>sudo apt-cache pkgnames > packages.txt</tt>
+
<tt>sudo apt-cache pkgnames > packages.txt</tt> and then look at it using <tt>emacs packages.txt</tt>, or you search for a particular package, such as <tt>sudo apt-cache pkgnames | grep emacs</tt>.
and then look at it using <tt>emacs packages.txt</tt>, or you search for a particular package, such as  
+
  
<tt>sudo apt-cache pkgnames | grep emacs</tt>.
+
* Or, you can compile linux software yourself on the Beagleboard. The gcc, g++ tools etc. are already installed.
 
+
Or, you can compile linux software yourself on the Beagleboard. The gcc, g++ tools etc. are already installed.
+
  
 
Type the <tt>df</tt> command. You can see that there is not a whole lot more than 1GB available on the SD card, so you should only install software if you decide that you need it.
 
Type the <tt>df</tt> command. You can see that there is not a whole lot more than 1GB available on the SD card, so you should only install software if you decide that you need it.
 
 
  
 
= Troubleshooting =
 
= Troubleshooting =

Revision as of 15:08, 13 December 2010

Here we provide instructions for getting the alpha version of Satellite CCRMA up and running.

Required Hardware

  • 4GB SD card or larger
  • Two GT Max adjustable-length USB cables
  • Ethernet cable
  • 2.5A 5V switching power adaptor (For example DVE DSA-15P-05 US)
  • Solderless breadboard

Note: Yes, both the host USB connector (for communication) and client USB connector (for power) on the Beagleboard are connected to the hub!


Powering Up For The First Time

Plug the power cable from the 5V supply into the hub. You will see some lights turn on, flickering every now and then. This means that Satellite CCRMA is booting up.


How To Connect

On this page, we explain how to connect to Satellite CCRMA over the Ethernet cable.

Mac OS X

Go to System Preferences, select Network, and choose the Ethernet module. Write down your current settings in case you think that you might need them in the future. (For example, if you use Ethernet to connect to the Internet in your dormitory, you probably want to save these settings for when you go home.) Now change your Ethernet settings to the following:

  • Configure: Manually
  • IP Address: 192.168.1.1
  • Subnet Mask: 255.255.255.0

The remaining items such as Router, DNS Server, and Search Domains can be left blank for now, and click the Apply button in the bottom right to apply the settings.

If your laptop is currently connected to the Internet using some method other than Ethernet: It can be convenient to enable the Beagleboard to get onto the Internet. Go back to System Preferences and choose Sharing. Edit the settings so that your Internet connection is shared with the Ethernet port. In order to do this, you may have to disable Internet Sharing temporarily. Finally, click the Internet Sharing checkbox to enable this option.

You will use the Terminal program to login to Satellite CCRMA over the Ethernet connection. It should be inside the Utilities folder inside of Applications.

Now open up a window in Terminal. Your Satellite CCRMA board should choose the IP address 192.168.1.105. To check that it is visible type the command ping 192.168.1.105, and see how fast the network response is. Once you are satisfied, hit Control-C to quit ping. Then, to finally login to Satellite CCRMA, type

ssh -X ccrma@192.168.1.105 The password should be temppwd.

Windows 7

<No instructions yet, but it should be analogous to the examples for other operating systems.>

Linux

Instructions for Ubuntu 10.04 Netbook Remix:

  • Run ifconfig in a terminal and look for your wired ethernet device. It will probably be called "eth0". Copy down the value next to HWaddr.
  • Go to "System" -> "Network Connections".
  • Under the "Wired" tab of the dialog that opens click "Add".
  • Set the "Connection name" to something logical, like CCRMA Satellite. Paste the value you copied from HWAddress in the "MAC address" box.
  • Click the "IPv4 Settings" tab. Change "Method" to "Manual". Next to "Addresses" click "Add". In the "Address" column type "192.168.1.1". In the "Netmask" column type "255.255.255.0". Click "Apply".
  • In the notification area on your desktop panel, click the NetworkManager Applet icon. Select the connection you just created. You now should be able to ssh into the board by typing "ssh -X ccrma@192.168.1.105" in a terminal.

For internet connection sharing, this link might help (I haven't tried it yet): https://help.ubuntu.com/community/Internet/ConnectionSharing


Test Run

Try issuing some of the following commands to explore the possibilities enabled by Satellite CCRMA:

  • qjackctl & (Opens up a GUI for starting the Jack audio server)
  • pd & (Starts pure data extended, an environment for graphical programming for sound synthesis)
  • ls /dev/tty* (To verify that the Arduino Nano is showing up on /dev/ttyUSB0)
  • arduino & (Starts the Arduino software for programming the Arduino Nano microcontroller attached via USB)
    • For instance, you could use the Arduino software to install some default firmware. It can be found under File|Examples|Firmata|StandardFirmata.
  • Run audacity & to edit audio samples.
  • Explore employing Faust to automatically generate audio DSP code in a variety of environments. The source code for Faust is in /usr/src/faust.
  • Run the example script in the directory ~/chuck_examples to takes the ChucK audio programming language for a spin.


Installing New Software

If your favorite linux software has been compiled for the ARM architecture, it may be available by way of the apt-get utility.

  • To get a list of packages available on the OMAP's ARM architecture, type sudo apt-cache pkgnames
  • You will notice that this list is way too long to look at. You can pipe it to the text file using the command

sudo apt-cache pkgnames > packages.txt and then look at it using emacs packages.txt, or you search for a particular package, such as sudo apt-cache pkgnames | grep emacs.

  • Or, you can compile linux software yourself on the Beagleboard. The gcc, g++ tools etc. are already installed.

Type the df command. You can see that there is not a whole lot more than 1GB available on the SD card, so you should only install software if you decide that you need it.

Troubleshooting

  • If you are running out of space on the SD card, you can free up some space by deleting items in /usr/src. For instance, all of the files needed for building Pure Data Extended are rather large.
  • If you are unable to access the internet from Satellite CCRMA, you may need to change the nameservers specified in /etc/resolv.conf


Halt Your Board When Finished!

When you are finished, it is probably best to shut down Satellite CCRMA by issuing the command sudo halt, just as you would shut down a linux desktop machine. This ensures that any data that is scheduled to be written to the SD card is written right away.