Cubie Board

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
m
 
(24 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
=== Cubieboard Fedora Remix ===
 
=== Cubieboard Fedora Remix ===
  
The Cubieboard Fedora Remix, produced and maintained by [https://fedoraproject.org/wiki/User:Tekkamanninja Tekkaman Ninja], is a Fedora-based Linux distribution that runs on the low-cost ($49) system-on-a-chip ([http://wiki.linux-sunxi.org/A10 Allwinner A10 or sun4i]) known as the [http://cubieboard.org/ Cubieboard (Cubie)]. This distribution consists of software packages from the Fedora ARM project (armv7hfp architecture) and a small number of additional packages that are modified from the Fedora versions.
+
The Cubieboard Fedora Remix, produced and maintained by [https://fedoraproject.org/wiki/User:Tekkamanninja Tekkaman Ninja], is a Fedora-based Linux distribution that runs on the low-cost ($49) system-on-a-chip ([http://wiki.linux-sunxi.org/A10 Allwinner A10 or sun4i]) known as the [http://cubieboard.org/ Cubieboard (Cubie)]. This distribution consists of software packages from the Fedora ARM project (armv7hl architecture), a custom kernel, and a small number of additional packages that are modified from the Fedora versions.
  
This page will show you how to install Fedora Remix on the Cubieboard. Installing Fedora Remix on the Cubieboard is easier than installing Fedora on a laptop or desktop because all you have to do is copy the prepared image to a SD card and plug in the Cubie.
+
This page will show you how to install the Fedora Remix on the Cubieboard. Installing the Fedora Remix on the Cubieboard is not complicated,because all you have to do is copy the prepared image and bootloader(u-boot) to an SD card and plug it into the Cubie.
  
The current build of Fedora 18 seems to be stable to me so far. The first core components of the Allwinner A10 landed in kernel 3.4.24, and the kernel source code come from [https://github.com/linux-sunxi/linux-sunxi.git linux-sunxi.git]
+
The current build of Fedora 18 seems to be stable. The first core components of the Allwinner A10 landed in kernel 3.4.24, and the kernel source code comes from [https://github.com/linux-sunxi/linux-sunxi.git linux-sunxi.git]
  
 
Let’s get started with it!
 
Let’s get started with it!
Line 16: Line 16:
 
There are four steps to installing Fedora Remix on your Cubieboard the manual way.
 
There are four steps to installing Fedora Remix on your Cubieboard the manual way.
  
*Copy [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ the ready-made Fedora Remix image] onto an 8GB (or larger, I use an 8GB/16GB Class 10) Micro SD memory card.
+
*Copy [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ the ready-made Fedora Remix image] and [http://tekkamanninja.fedorapeople.org/boards/cubieboard/u-boot/ u-boot]onto an 8GB (or larger, I use an 8GB/16GB Class 10) Micro SD memory card.
     But for [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ the nano version image(no-GUI)](wait for uploading),you can use 4GB Micro-SD card.
+
     But for [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ the '''nano version''' image(no-GUI)],you can use 4GB Micro-SD card.
 
*Hook up a monitor (preferably via HDMI), a USB keyboard and mouse (ideally that share a single USB port) and, optionally, an internet connection (ethernet cable)
 
*Hook up a monitor (preferably via HDMI), a USB keyboard and mouse (ideally that share a single USB port) and, optionally, an internet connection (ethernet cable)
 
*Power on and walk through the Fedora “first boot” wizard
 
*Power on and walk through the Fedora “first boot” wizard
 
*Reboot, login and geek out!
 
*Reboot, login and geek out!
 +
 +
=== Installing the image ===
  
 
The SD card serves as the Cubieboard’s primary drive. By default, the Cubie will look on the SD card for the operating system to load (though it’s possible to boot from other devices as well). Therefore, the first step is to grab the image and put it on the card.
 
The SD card serves as the Cubieboard’s primary drive. By default, the Cubie will look on the SD card for the operating system to load (though it’s possible to boot from other devices as well). Therefore, the first step is to grab the image and put it on the card.
  
1. Download the latest [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ Cubieboard Fedora 18 Remix distribution], F18-cubie-{*build date*}.img.tar.bz2 (531MB).
+
1. Download the latest [http://tekkamanninja.fedorapeople.org/boards/cubieboard/images/ Cubieboard Fedora 18 Remix distribution], F18-cubie-{*build date*}-mali-uboot-buildin.img.gz (581MB).
  
2. Extract the archive using the Archive Manager (file-roller) application or "tar -xjvf" from the command line. This will create the file F18-cubie-{*build date*}.img.
+
2. Extract the archive using the Archive Manager (file-roller) application or "gunzip" from the command line. This will create the file F18-cubie-{*build date*}-mali-uboot-buildin.img.
  
 
3. Get the device name of the SD card using the Disks (palimpsest) application or sudo fdisk -l from the command line. Most likely the SD card is named /dev/mmcblk0. (or can be different on your machine)
 
3. Get the device name of the SD card using the Disks (palimpsest) application or sudo fdisk -l from the command line. Most likely the SD card is named /dev/mmcblk0. (or can be different on your machine)
  
4. Transfer the extracted image file F18-cubie-{*build date*}.img to the SD card using a terminal window.
+
4. Transfer the extracted image file F18-cubie-{*build date*}-mali-uboot-buildin.img to the SD card using a terminal window.
  
 
Here’s the transfer command to execute in Step 4.
 
Here’s the transfer command to execute in Step 4.
  
   sudo dd if=F18-cubie-{*build date*}.img of=/dev/mmcblk0 ;sync
+
   sudo dd if=F18-cubie-{*build date*}-mali-uboot-buildin.img of=/dev/mmcblk0 ;sync
  
The command above assumes you saved F18-cubie-{*build date*}.img in your work directory after extraction. If you saved the file elsewhere, you’ll need to change to the appropriate directory via the command line (cd directory/name) before executing the dd command. dd is a low-level copy command that can read and write complete disk images. "if" stands for “input file”, "of" stands for “output file” and another command "sync" is for synchronizing data on disk with memory.
+
The command above assumes you saved F18-cubie-{*build date*}-mali-uboot-buildin.img in your work directory after extraction. If you saved the file elsewhere, you’ll need to change to the appropriate directory via the command line (cd directory/name) before executing the dd command. dd is a low-level copy command that can read and write complete disk images. "if" stands for “input file”, "of" stands for “output file” and the command "sync" is for synchronizing data on disk with memory.
  
In our case, the input file is the disk image F18-cubie-{*build date*}.img, the output file is the SD card device /dev/mmcblk0 and then synchronization. This command will create the necessary file systems partitions on the SD card, occupying 4.3GB of space, then copy the prepared operating system files to those partitions. A one step installation!
+
In our case, the input file is the disk image F18-cubie-{*build date*}-mali-uboot-buildin.img, the output file is the SD card device /dev/mmcblk0, and then synchronization. These commands will create the necessary file system partitions on the SD card, occupying 4.3GB of space, then copy the prepared operating system files to those partitions.  
  
 
NOTE: As you’ll learn later, the first boot wizard will allow you to resize the main partition to use all available space on the card.
 
NOTE: As you’ll learn later, the first boot wizard will allow you to resize the main partition to use all available space on the card.
Line 44: Line 46:
 
TIP: The dd command is also your friend if you need to move to a bigger SD card. Simply reverse the if and of values, insert a bigger card and run the above command again.
 
TIP: The dd command is also your friend if you need to move to a bigger SD card. Simply reverse the if and of values, insert a bigger card and run the above command again.
  
The dd command doesn’t output any messages until the operation is complete, so be patient. The length of time to execute the command will vary depending on the speed of the card. With my Class 10 card, it takes about 20 minutes ( 3.5 MB/s). Here’s an example of the output you’ll see when the command finishes:
+
The dd command doesn’t output any messages until the operation is complete, so be patient. The length of time to execute the command will vary depending on the speed of the card. A Class-10 SD card will take about 20 minutes (@ 3.5 MB/s). Here’s an example of the output you’ll see when the command finishes:
  
   sudo dd if=F18-cubie-20130219.img of=/dev/mmcblk0 ;sync
+
   sudo dd if=F18-cubie-20130219-mali-uboot-buildin.img of=/dev/mmcblk0 ;sync
 
   [sudo] password for tekkamanninja:  
 
   [sudo] password for tekkamanninja:  
 
   8388608+0 records in
 
   8388608+0 records in
Line 52: Line 54:
 
   4294967296 bytes (4.3 GB) copied, 1217.55 s, 3.5 MB/s
 
   4294967296 bytes (4.3 GB) copied, 1217.55 s, 3.5 MB/s
  
You can verify the operation worked by ejecting the SD card, reinserting it, then browsing the contents using the file explorer. You should see two mounts, boot and rootfs. Once you’re done poking around, unmount boot and rootfs and we will flash u-boot in next step.
+
You can verify the operation worked by ejecting the SD card, reinserting it, and then browsing the contents using the file explorer. You should see two mounts, boot and rootfs. Once you’re done poking around, unmount the /boot and rootfs ('/') partitions.
  
 +
The SD card is ready. Now let’s prepare the Cubie!
  
 +
==== Updating the u-boot ====
  
 +
If the image you downloaded has "uboot-buildin" in the name of the file, it can be used to boot the device directly. Otherwise, follow the instruction below to install u-boot:
  
 +
Flash u-boot to the SD card.
 +
 +
  wget http://tekkamanninja.fedorapeople.org/boards/cubieboard/u-boot/sunxi-spl.bin
 +
  wget http://tekkamanninja.fedorapeople.org/boards/cubieboard/u-boot/u-boot.bin
 +
  sudo dd if=sunxi-spl.bin of=/dev/mmcblk0 bs=1024 seek=8
 +
  sudo dd if=./u-boot.bin of=/dev/mmcblk0 bs=1024 seek=32
 +
  sync
 +
 +
You can also use the instructions above if you want to update u-boot.
  
The SD card is ready. Now let’s prepare the Cubie!
 
  
 
== Preparing the Cubie ==
 
== Preparing the Cubie ==
Line 65: Line 78:
  
 
     SD card
 
     SD card
     Monitor HDMI cable
+
     Monitor HDMI cable(or Monitor VGA cable + HDMI to VGA box)
 
     USB keyboard
 
     USB keyboard
 
     USB mouse
 
     USB mouse
 
     Ethernet cable
 
     Ethernet cable
  
 +
[[File:Cubie hardware.jpg|800px]]
  
Next, turn on the monitor and, if necessary, the keyboard and mouse.  
+
Next, turn on the monitor, and if necessary, the keyboard and mouse.  
  
 
The Cubieboard only has two USB ports, which you may quickly outgrow. One solution is to expand the number of ports by adding a (preferably powered) USB hub. Before going that route, you can save one of the USB ports by getting a keyboard and mouse that can share the same port.
 
The Cubieboard only has two USB ports, which you may quickly outgrow. One solution is to expand the number of ports by adding a (preferably powered) USB hub. Before going that route, you can save one of the USB ports by getting a keyboard and mouse that can share the same port.
Line 79: Line 93:
 
The final input is the power (otherwise known as the “on” switch).
 
The final input is the power (otherwise known as the “on” switch).
  
Grab a your proper charger(5 Volt 2A) and plug it into a power outlet. You may be tempted to use the USB port of your laptop as the power source; however, the USB port may not provide the necessary power required by the Cubieboard (2A). The general recommendation is to play it safe and use a wall outlet.Also don't forget the your charger must give proper volt(5V) and amper(>=2A) to make it work properly for your Cubieboard.
+
Grab a your proper charger (5 Volt, 2A) and plug it into a power outlet. You may be tempted to use the USB port of your laptop as the power source, however the USB port may not provide the necessary power required by the Cubieboard (2A). The general recommendation is to play it safe and use a wall outlet. Also, don't forget that your charger must provide the proper voltage (5V) and amperage (>=2A) to work properly for your Cubieboard.
  
 +
== Customizing the installation on first boot ==
  
 +
This wouldn’t be a Fedora installation without the first boot wizard. The inclusion of first boot is one of the features that sets the Fedora Remix apart from other Cubieboard distributions.
  
== Customizing the installation on first boot ==
+
This Fedora Remix for Cubie will automatically resize the rootfs partition to use all remaining space on the SD card at first boot, and then reboot automatically.
  
This wouldn’t be a Fedora installation without the first boot wizard. The inclusion of first boot is one of the features that sets the Fedora Remix apart from other Cubieboard distributions. In addition to the simple first boot operations (review license, set language, timezone and date, root password), the Fedora Remix allows you to:
+
In addition to the simple first auto-reboot, the Fedora Remix allows you to:
  
Resize the rootfs partition to use all remaining space on the SD card, optionally allocating some of that space for a swap file (I used the defaults)
+
*  review license;
  
Create a user account (add the user to administrators group)
+
*  set timezone and date (including NTP servers);
  
Fedora Remix create user boot screen
+
*  Create a user account (set password and add the user to administrators group).
  
== Fedora Remix create system settings boot screen ==
 
  
 +
The default login for root is :
 +
  user:root
 +
  password:fedora
  
 +
For security reasons, be sure to change the root password after your first login.
  
== Cubieboard XFCE desktop login ==
 
  
After you’ve logged in (go check your email, this may take a moment as well), you’ll see the following dialog window.
+
=== Fedora Remix create system settings boot screen ===
  
== Cubieboard XFCE start panel ==
+
[[File:Cubie Remix first boot.jpg|800px]]
 +
[[File:Cubie Remix first boot License.jpg|800px]]
 +
[[File:Cubie Remix first boot create user.jpg|800px]]
 +
[[File:Cubie Remix first boot NTP.jpg|800px]]
  
This is part of the XFCE desktop; You can choose the default or manual configuration.
+
== Cubieboard XFCE desktop login ==
  
== Updating Fedora Remix on the Cubieboard ==
+
After you’ve logged in (go check your email, this may take a moment as well. even we are using mali400), you’ll see the following dialog window.
  
You use Fedora Remix on the Cubieboard just like any other Fedora installation. You might start by opening a terminal and updating the packages (internet connection required):
+
[[File:Cubie Remix Login.jpg|800px]]
  
  sudo yum -y update
+
== Cubieboard XFCE start panel ==
  
Installing updates via yum
+
This is part of the XFCE desktop; You can choose the default or manual configuration.
  
You can browse the hardware information by installing and running hardinfo:
+
[[File:Cubie Remix set panel.jpg|800px]]
 +
[[File:Cubie Remix Desktop.jpg|800px]]
  
  sudo yum -y install hardinfo
+
== Updating Fedora Remix on the Cubieboard ==
  
After you type the above command, you will be asked for your password. Next, the system will resolve dependencies, download new packages, run transaction check and test, run transaction, and install packages.
+
=== Installing updates via yum ===
  
Installing hardinfo via yum
+
You use Fedora Remix on the Cubieboard just like any other Fedora installation. You might start by opening a terminal and updating the packages (internet connection required):
  
 +
  sudo yum -y update
  
  
Line 129: Line 152:
 
== Tinker! ==
 
== Tinker! ==
  
The Fedora Remix is one of many distributions you can install on the Cubieboard, and there is plenty of room for it to improve. If your goal is to use the Cubieboard as a multimedia center, Fedora Remix may not be your best option (check out [http://wiki.linux-sunxi.org/XBMC XBMC]). You’d choose Fedora Remix for things the Fedora OS excels at, such as software development. Fortunately, you don’t have to limit yourself to a single distribution. Changing distributions is as easy as swapping SD cards. We encourage you to try different distributions to get the most out of your Cubieboard.
+
The Fedora Remix is one of many distributions you can install on the Cubieboard, and there is plenty of room for improvement. If your goal is to use the Cubieboard as a multimedia center, Fedora Remix may not be your best option (check out [http://wiki.linux-sunxi.org/XBMC XBMC]). You’d choose Fedora Remix for things the Fedora OS excels at, such as software development. Fortunately, you don’t have to limit yourself to a single distribution. Changing distributions is as easy as swapping SD cards. We encourage you to try different distributions to get the most out of your Cubieboard.
  
 
== Cubieboard Photobooth ==
 
== Cubieboard Photobooth ==
Line 137: Line 160:
 
[[Cubieboard photobooth]]
 
[[Cubieboard photobooth]]
  
[[Category:CUBIEBOARD CUBIE]
+
[[Category:Cubieboard]]

Latest revision as of 05:03, 8 May 2013

Cog.png
This page needs some love
This page should be revised or reconstructed to be more helpful. Problems may include being out of step with current team or project status or process.
Note.png
We need more hands on board!
We need more folks to improve the distribution process. We need YOU!

Contents

[edit] Cubieboard Fedora Remix

The Cubieboard Fedora Remix, produced and maintained by Tekkaman Ninja, is a Fedora-based Linux distribution that runs on the low-cost ($49) system-on-a-chip (Allwinner A10 or sun4i) known as the Cubieboard (Cubie). This distribution consists of software packages from the Fedora ARM project (armv7hl architecture), a custom kernel, and a small number of additional packages that are modified from the Fedora versions.

This page will show you how to install the Fedora Remix on the Cubieboard. Installing the Fedora Remix on the Cubieboard is not complicated,because all you have to do is copy the prepared image and bootloader(u-boot) to an SD card and plug it into the Cubie.

The current build of Fedora 18 seems to be stable. The first core components of the Allwinner A10 landed in kernel 3.4.24, and the kernel source code comes from linux-sunxi.git

Let’s get started with it!

[edit] Installing the Cubieboard Fedora Remix

There are four steps to installing Fedora Remix on your Cubieboard the manual way.

   But for the nano version image(no-GUI),you can use 4GB Micro-SD card.
  • Hook up a monitor (preferably via HDMI), a USB keyboard and mouse (ideally that share a single USB port) and, optionally, an internet connection (ethernet cable)
  • Power on and walk through the Fedora “first boot” wizard
  • Reboot, login and geek out!

[edit] Installing the image

The SD card serves as the Cubieboard’s primary drive. By default, the Cubie will look on the SD card for the operating system to load (though it’s possible to boot from other devices as well). Therefore, the first step is to grab the image and put it on the card.

1. Download the latest Cubieboard Fedora 18 Remix distribution, F18-cubie-{*build date*}-mali-uboot-buildin.img.gz (581MB).

2. Extract the archive using the Archive Manager (file-roller) application or "gunzip" from the command line. This will create the file F18-cubie-{*build date*}-mali-uboot-buildin.img.

3. Get the device name of the SD card using the Disks (palimpsest) application or sudo fdisk -l from the command line. Most likely the SD card is named /dev/mmcblk0. (or can be different on your machine)

4. Transfer the extracted image file F18-cubie-{*build date*}-mali-uboot-buildin.img to the SD card using a terminal window.

Here’s the transfer command to execute in Step 4.

 sudo dd if=F18-cubie-{*build date*}-mali-uboot-buildin.img of=/dev/mmcblk0 ;sync

The command above assumes you saved F18-cubie-{*build date*}-mali-uboot-buildin.img in your work directory after extraction. If you saved the file elsewhere, you’ll need to change to the appropriate directory via the command line (cd directory/name) before executing the dd command. dd is a low-level copy command that can read and write complete disk images. "if" stands for “input file”, "of" stands for “output file” and the command "sync" is for synchronizing data on disk with memory.

In our case, the input file is the disk image F18-cubie-{*build date*}-mali-uboot-buildin.img, the output file is the SD card device /dev/mmcblk0, and then synchronization. These commands will create the necessary file system partitions on the SD card, occupying 4.3GB of space, then copy the prepared operating system files to those partitions.

NOTE: As you’ll learn later, the first boot wizard will allow you to resize the main partition to use all available space on the card.

TIP: The dd command is also your friend if you need to move to a bigger SD card. Simply reverse the if and of values, insert a bigger card and run the above command again.

The dd command doesn’t output any messages until the operation is complete, so be patient. The length of time to execute the command will vary depending on the speed of the card. A Class-10 SD card will take about 20 minutes (@ 3.5 MB/s). Here’s an example of the output you’ll see when the command finishes:

 sudo dd if=F18-cubie-20130219-mali-uboot-buildin.img of=/dev/mmcblk0 ;sync
 [sudo] password for tekkamanninja: 
 8388608+0 records in
 8388608+0 records out
 4294967296 bytes (4.3 GB) copied, 1217.55 s, 3.5 MB/s

You can verify the operation worked by ejecting the SD card, reinserting it, and then browsing the contents using the file explorer. You should see two mounts, boot and rootfs. Once you’re done poking around, unmount the /boot and rootfs ('/') partitions.

The SD card is ready. Now let’s prepare the Cubie!

[edit] Updating the u-boot

If the image you downloaded has "uboot-buildin" in the name of the file, it can be used to boot the device directly. Otherwise, follow the instruction below to install u-boot:

Flash u-boot to the SD card.

 wget http://tekkamanninja.fedorapeople.org/boards/cubieboard/u-boot/sunxi-spl.bin
 wget http://tekkamanninja.fedorapeople.org/boards/cubieboard/u-boot/u-boot.bin
 sudo dd if=sunxi-spl.bin of=/dev/mmcblk0 bs=1024 seek=8
 sudo dd if=./u-boot.bin of=/dev/mmcblk0 bs=1024 seek=32
 sync

You can also use the instructions above if you want to update u-boot.


[edit] Preparing the Cubie

Plug the following inputs into the Cubieboard:

   SD card
   Monitor HDMI cable(or Monitor VGA cable + HDMI to VGA box)
   USB keyboard
   USB mouse
   Ethernet cable

Cubie hardware.jpg

Next, turn on the monitor, and if necessary, the keyboard and mouse.

The Cubieboard only has two USB ports, which you may quickly outgrow. One solution is to expand the number of ports by adding a (preferably powered) USB hub. Before going that route, you can save one of the USB ports by getting a keyboard and mouse that can share the same port.

[edit] Power it up!

The final input is the power (otherwise known as the “on” switch).

Grab a your proper charger (5 Volt, 2A) and plug it into a power outlet. You may be tempted to use the USB port of your laptop as the power source, however the USB port may not provide the necessary power required by the Cubieboard (2A). The general recommendation is to play it safe and use a wall outlet. Also, don't forget that your charger must provide the proper voltage (5V) and amperage (>=2A) to work properly for your Cubieboard.

[edit] Customizing the installation on first boot

This wouldn’t be a Fedora installation without the first boot wizard. The inclusion of first boot is one of the features that sets the Fedora Remix apart from other Cubieboard distributions.

This Fedora Remix for Cubie will automatically resize the rootfs partition to use all remaining space on the SD card at first boot, and then reboot automatically.

In addition to the simple first auto-reboot, the Fedora Remix allows you to:

  • review license;
  • set timezone and date (including NTP servers);
  • Create a user account (set password and add the user to administrators group).


The default login for root is :

 user:root
 password:fedora

For security reasons, be sure to change the root password after your first login.


[edit] Fedora Remix create system settings boot screen

Cubie Remix first boot.jpg Cubie Remix first boot License.jpg Cubie Remix first boot create user.jpg Cubie Remix first boot NTP.jpg

[edit] Cubieboard XFCE desktop login

After you’ve logged in (go check your email, this may take a moment as well. even we are using mali400), you’ll see the following dialog window.

Cubie Remix Login.jpg

[edit] Cubieboard XFCE start panel

This is part of the XFCE desktop; You can choose the default or manual configuration.

Cubie Remix set panel.jpg Cubie Remix Desktop.jpg

[edit] Updating Fedora Remix on the Cubieboard

[edit] Installing updates via yum

You use Fedora Remix on the Cubieboard just like any other Fedora installation. You might start by opening a terminal and updating the packages (internet connection required):

 sudo yum -y update


[edit] Cubieboard hard at work

To be continued

[edit] Tinker!

The Fedora Remix is one of many distributions you can install on the Cubieboard, and there is plenty of room for improvement. If your goal is to use the Cubieboard as a multimedia center, Fedora Remix may not be your best option (check out XBMC). You’d choose Fedora Remix for things the Fedora OS excels at, such as software development. Fortunately, you don’t have to limit yourself to a single distribution. Changing distributions is as easy as swapping SD cards. We encourage you to try different distributions to get the most out of your Cubieboard.

[edit] Cubieboard Photobooth

Check what are we doing with Cubieboard !!! ;)

Cubieboard photobooth