Please read the whole guide before unpacking the board!
This guide describes how to get started with the Parallella board. The picture below shows the Gen1.1 Parallella board that is shipping to Kickstarter backers and customers from Dec 2013.
The pictures and illustration highlight some key components relevant to getting the board up and running:
Step #1: Insert Micro-SD Card
Imaging the SD-Card
For the Parallella board to operate the SD card must have the boot image which includes the boot files and the Ubuntu Linux in two partitions – for instructions how to flash the card, see the FAQs below.
Push the pre-imaged micro-SD card in the micro-SD slot on the bottom of the board. The gold tabs on the micro-SD card should be facing down. The SD card should go in smoothly and clicks into place. To remove the card, push the card in further and it should unlock and pop out. Do not try to forcibly pull out the card without first pushing it in as this could damage the board!
Step #2 Connect peripherals (optional)
Connect an HDMI cable and connect to a monitor and then connect a keyboard and mouse through a USB hub to the USB port next to the HDMI port. (DO NOT USE A NON CONFORMING POWERED USB HUB)
Step #3: Connect to Network
Connect the Parallella board to the network with a CAT5 Ethernet cable.
Step #4: Power up board
Apply power to the board through the 5V DC power connector. One green LED should come on and stay on.
Step #5 – You’re Done!
The system will boot and the Ubuntu login screen will appear.
Login with the username linaro and password linaro
FINAL STEP: Running a Test
After a successful login, open a terminal window and enter “./test.sh” at the command line to run your first parallel Parallella program.
You now have a fully functional Parallella board running Ubuntu – check out the parallella.org website and forums.parallella.org for help, ideas and recommendations of programming you can get involved in.
1) How to Flash an SD Card with Ubuntu
1. Download and uncompress the latest image found in the directory (ftp://ftp.parallella.org/parallella/gen1/)
For the Parallella-16 use file Parallella16_z7020wGPIO_xxxxxx.zip
2. Insert new 16 GB SD card into your PC (windows machine)
3. In order to flash the SD card in Windows, it is necessary to first download a third-party application named Disk Imager (http://sourceforge.net/projects/win32diskimager/)
a. Locate and uncompress the files you downloaded in a convenient place.
b. Launch the application Win32DiskImager.exe
c. Select uncompressed version of the image (Parallella16_z7020wGPIO_xxxxxx.img)
d. Make sure the correct device is selected
e. Click the Write button
4. Writing the image to the SD card can take about 35 min.
2) How to log into the Parallella board from a Remote Machine
From Windows Login into a remote session using a terminal tool like PuTTY (http://www.putty.org/)
Session is SSH on Port 22
The default Parallella user name is “linaro”
The default password is “linaro”
From Linux: Open an SSH shell
3) How to open a Graphic UI Window from a Remote Machine
You can login to the Parallella board’s Ubuntu GUI from another Linux machine using VNC
1) On the Parallella board:
Start the VNC server
New ‘X’ desktop is linaro-ubuntu-desktop:1
Starting applications specified in /home/linaro/.vnc/xstartup
Log file is /home/linaro/.vnc/linaro-ubuntu-desktop:1.log
Note the response gives the “display #” which you will need to access this server (number after the colon)
2) On a Linux machine:
testuser@MyPC:~$ xtightvncviewer 192.168.x.x:N
Where the IP address is the IP of the Parallella board and N is the Display number
example: testuser@MyPC:~$ xtightvncviewer 192.168.2.119:1
The user password to the Parallella board will be required (linaro) and then a window will open with the Ubuntu GUI of the Parallella.
Note: a version of tightVNC and VNC Client is also available for Windows and Android – these can be used to access the Parallella board as well.
4) How to Update the Software
The FTP will be regularly updated with new packaged boot images. If you want to update components of the image, check the Github for software, examples and updates.
Check for development software updates to make sure you are always running the latest Epiphany SDK. Pre-built SDKs are available at ftp://ftp.parallella.org while sources and built scripts are available at http://github.com/adapteva/epiphany-sdk
5) How to find the MAC Address and IP Address of the Parallella
The MAC Address is printed on the label of the Parallella board – 04:4F:8B:xx:xx:xx.
[The rightmost numbers in the serial number can also be used to determine the MAC address of the board. The rightmost seven numbers are used converted to HEX format. The base MAC address for all Parallella boards is 04:4F:8B:00:00:00. To get the exact MAC ID for your board, add the number in HEX to the base MAC address. Example: for serial number 0000031, the MAC ID would be 04:4F:8B:00:00:1E (for hex converter tool link here)]
To find the IP Address of the board check your router or use an IP scanning tool – find the IP address associated with the MAC Address of the board. (Alternatively try logging in directly to “linaro-ubuntu-desktop” from another computer.)
Recommended IP Scanning tools:
http://www.advanced-ip-scanner.com/ (no install required)
http://www.radmin.com/download/previousversions/portscanner.php (install required)
Known Issues with the Gen1 Board:
1. USB device port is not operating (TBD) - The USB port between the Ethernet and the power connector is a USB device port. More details to follow on its use and functionality.