Workshop #1: The Basics for Beginners

NOTE: These are draft. First workshop to test this will be 2011/05/18. Feel free to contribute!

What you will learn in this workshop

• Why use Android for robotics?
• What's available for Android?
• How do I setup source control?
• How to setup the Eclipse and environment?
• Basics of Android application programming
• Writing your first Android program
• How to commit your changes

What you will need

• A MacOS X (Intel), Linux (x86 or x86_64) or Windows laptop
• Time: 1 hour to setup, 1 hour to do the workshop (PPC is not possible as the android SDK is not available by source code)

Before the workshop

1. Make sure to install the OEM USB (development) driver for your Android phone
2. Create a GitHub account and send the account name to the presenter prior to the class

If you need help, these steps should be done right before the workshop or go an hour earlier:

1. Generate a Private and Public Key
2. Install git
3. Install Android SDK Release 11
4. Install Eclipse 3.6.2
5. Help > Install new software > works with:
6. Install ADT 10.0.1 into eclipse: https://dl-ssl.google.com/android/eclipse/
7. (optional) Install eGit into eclipse: http://download.eclipse.org/egit/updates
8. Checkout XinCheJian-Workshop
9. Create your own directory in XinCheJian-Workshop/Android/Participants with your github username

Public and Private Keys

A public key is designed to be shared with the world, it can be considered a door lock without a key - everyone can see it but only the correct key can open the lock, the private key is the key itself, if you have this you can open the door, each private and public key are unique, you can create many different public keys from your private key, but you cannot create a private key from any public keys.

rule of thumb: Share your public key with the world, print it on everything, stamp it everywhere, tattoo your dog with it. Never share your private key, guard it with your internet life, give it a passphrase to keep it locked up.

Windows users use Puttygen GUI tool save both your private and public key (RSA 2048), make sure you set a passphrase on the private key.

Linux/Mac/Unix users

openssl genrsa -des3 -out ~/private.pem 2048 
openssl rsa -in ~/private.pem -pubout -out ~/public.key

you should have two files in your home directory ~/

copy the contents of your public key

--- sample key ---
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApj42p5QPgEYHbV8kT+ds
pNw1arRKEXdfaMOHGGwpV/J6h+rFySHql7EEbKef+kL28LRx6Eh+YUIKWZBWQZzw
1yDvPGK/RSKa4Fzp/8q8K1gr68pXMqKx4QphGYc2/k6oEOfqm9XjbJSsSvAZnTzd
FuW1DSFChiRtp/17aZdU+DOA5e0cUqMqzKC1M6eMsg3Q/Qau9CbbHu8cAohkS+1Y
UKYPZfAwFrgl0BIeKzB6PhNsIT6kx+TXcH3bqM9S6yz5onOLLewJRJIcKCyEejZ+
Xes3azAsFOBAUWfBU1ptlDkrkhFnCDEPXQqib2L6Y+LITgaqgNLg+UwW7c05UH4p
pQIDAQAB
--- end sample key ---

Now setup your account in github.com > Account Settings > SSH Public Keys > add a Public Key: give it a title and paste the contents into the key field.

Move the private key into the right location for Linux/OSX/Unix

mkdir ~/.ssh
cp ~/public.key ~/.ssh/id_rsa
chmod -R 600 ~/.ssh
chmod 400 ~/.ssh/id_rsa

Sorry for windows users.. find out and update this wiki

Checking the workshop projects and documentation

in a shell (or git bash shell on Windows)

mkdir XinCheJian-Workshops
cd XinCheJian-Workshops
git init
git pull [email protected]:rngadam/XinCheJian-Workshops.git
mkdir wiki
cd wiki
git pull [email protected]:rngadam/XinCheJian-Workshops.wiki.git

Verifying the setup

1. Creating the Hello World project using the wizard
2. Running and uploading to the phone
3. Debugging
4. Commit a change

Overview of interaction with hardware

1. Using Bluetooth
2. Reading from sensors