RPi Advanced Setup

WARNING: This page is not suitable for the average user. Information in this page is for experienced hackers only. The Raspberry Pi foundation will release pre-built SD cards which are suitable for use by the average user.

Notes

Please note that the Raspberry Pi isn't released yet - this page is a community work in progress in preparation for the launch. If something doesn't work or isn't covered in these guides, please feel free to ask on the Forum. But before you ask there, make sure you read the FAQs.

This page is based on BeagleBoardBeginners and lots of this material applies to BeagleBoard and not to Raspberry Pi. Specifically, most Raspberry Pi users do not have access to a serial port (it's on the GPIOs but you need a board or cable to convert 3.3V UART signals to RS-232 or USB) so the serial port information doesn't usually apply. Also, many Raspberry Pi users will buy pre-programmed SD cards and can skip to reading RPi Hardware Basic Setup. We expect that once Raspberry Pi boards become generally available helpful volunteers will update this page to match Raspberry Pi or point to better information elsewhere.

Finding hardware and setting up

You'll need a preloaded SD card (or make your own), USB keyboard, TV/Monitor (with HDMI/DVI/Composite/SCART input), and power supply (USB charger or a USB port from a powered USB Hub or another computer).

You'll likely also want a USB mouse, a case, and a USB Hub (a necessity for Model A). A powered USB Hub will reduce the demand on the RPi. To connect to the Internet, you'll need either an Ethernet/LAN cable (Model B) or a USB WiFi adaptor (either model).

Serial connection

The Serial Port is a simple and uncomplicated method to connect to the Raspberry Pi.
The communication depends on byte wise data transmission, is easy to setup and is generally available even before boot time.

First interaction with the board

Connect the serial cable to the COM port in the Raspberry Pi, and connect the other end to the COM port or USB Serial Adapter in the computer.

How please? I'm led to believe it's wired at the board end, so needs an accessible 9?? pin male|female 232 connector, then some sort of serial to usb dongle. Any more information on this please?

Next is this the preferred way to get low level access to the board, or using the usb for kbd and hdmi for screen?

Serial Parameters

The following parameters are needed to connect to the Raspberry. All parameters except Port_Name and Speed are default values and may not need to be set.

Tedious Old-Fashioned Way Using Minicom

GUI method with GtkTerm

Start GtkTerm, select Configuration->Port and enter the values above in the labeled fields.

Windows Users

Windows Users above Windows XP must download putty or a comparable terminal program.
Users of XP and below can choose between using putty and Hyperterminal.

First Dialog

If you get the prompt below, you are connected to the Raspberry Pi shell!

prompt> #

First command you might want try is "help":

prompt> # help

If you get some output, you are correctly connected to the Raspberry Pi! Congratulations!

SD card setup

Now we want to use an SD card to install some GNU/Linux distro in it and get more space for our stuff. You can use either an SD or SDHC card. In the latter case of course take care that your PC card reader also supports SDHC.
Be aware that you are not dealing with an x86 processor, but instead a completely different architecture called ARM, so don't forget to install the ARM port for the distro you are planning to use.

(to be completed)

Formatting the SD card via the mkcard.txt script

(to be completed)

Download mkcard.txt from ???.

$ chmod +x mkcard.txt

$ ./mkcard.txt /dev/sdx, Where x is the letter of the card. You can find this by inserting your card and then running dmesg | tail. You should see the messages about the device being mounted in the log. Mine mounts as sdc.

Once run, your card should be formatted.

Formatting the SD card via fdisk "Expert mode"

First, lets clear the partition table:

================================================================================
$ sudo fdisk /dev/sdb
Command (m for help): o
Building a new DOS disklabel. Changes will remain in memory only,
until you decide to write them. After that, of course, the previous
content won't be recoverable.
Warning: invalid flag 0x0000 of partition table 4 will be corrected by w(rite)
================================================================================

NOTE: For convenience, you can add the -L option to the mkfs.ext3 command to assign a volume label to the new ext3 filesystem. If you do that, the new (automatic) mount point under /media when you insert that SD card into some Linux hosts will be based on that label. If there's no label, the new mount point will most likely be a long hex string, so assigning a label makes manual mounting on the host more convenient.

Writing the image into the SDcard and finally booting GNU/Linux

The easiest way to do this is to use PiCard. It even saves you from some hassles explained above. You will need your SD card + reader and a Linux pc to use PiCard.
After that , just plug the card into your Rpi.

Required Software Setup

(This excutable can to write to your harddisk so exercise caution using it!)

make a copy named dd-removable.exe

(That excutable refuses to write to your harddisk as it is named dd-removable
As long as you use dd-removable.exe you can not lose your harddisk)

Connect an SD card to the computer

run "dd-removable –list"

Should give something like this:

rawwrite dd for windows version 0.6beta3.
Written by John Newbigin <jn@it.swin.edu.au>
This program is covered by terms of the GPL Version 2.
NT Block Device Objects
\\?\Device\Harddisk1\Partition0
link to \\?\Device\Harddisk1\DR8
Removable media other than floppy. Block size = 512
size is 4075290624 bytes

This "\\?\Device\Harddisk1\Partition0" is the part you need.

Reading an image from the SD Card

BEWARE: DO THIS WRONG AND YOU CAN LOSE YOUR HARDDISK!!!

Obviously, you can NOT use 'dd-removable' to read an image as that executable refuses to write to your harddisk (so extra care is required here as you use 'windd').