Difference between revisions of "Getting started"

From PINE64
Jump to navigation Jump to search
Line 55: Line 55:
You will need the following utilities to get started with imaging the OS of your choice onto your microSD card:
You will need the following utilities to get started with imaging the OS of your choice onto your microSD card:
* A compression utility (used to unarchive the OS image). We recommend you use [http://www.7-zip.org/download.html 7zip].
* A compression utility (used to unarchive the OS image). We recommend you use [http://www.7-zip.org/download.html 7zip].
* A disk image utility (used to ‘burn’ the .img to your SD card). We recommend you use either the [https://etcher.io/ Etcher] or [https://sourceforge.net/projects/win32diskimager/ Win32Imager] utility.
* A disk image utility (used to flash the .img to your SD card). We recommend you use either the [https://etcher.io/ Etcher] or [https://sourceforge.net/projects/win32diskimager/ Win32Imager] utility.


'''Optional for Allwinner A64 SoC based boards'''
'''Optional for Allwinner A64 SoC based boards'''

Revision as of 21:34, 20 October 2017

NOOB.png

Setting Up Your device - What You’ll Need to Get Started

You will need the following to get started with using your PINE A64(+), SOPine/PINE A64-LTS, Pinebook or ROCK64 board:

  • Windows / Linux PC or MAC with a SD Card Reader connected to the Internet.
  • For PINE A64(+): Power Supply (PSU) and a micro usb cable. Please make sure to use a PSU rated at +5V @2A and a micro USB cable that is at least 26 AWG thick.
  • For SOPine/PINE A64-LTS: Power Supply (PSU) with 3.5mm OD/1.5mm ID barrel DC Jack. Please make sure to use a PSU rated at +5V @2A.
  • For Pinebook and ROCK64: Power Supply (PSU) with 3.5mm OD/1.5mm ID barrel DC Jack. Please make sure to use a PSU rated at +5V @3A.
  • MicroSD card (8GB or higher capacity) rated 'class 10' or better.
  • HDMI cable (unless you wish to run headless / without a monitor). On A64 Devices Android and Remix OS support 720p and 1080p, while Linux supports a wider range of resolutions.
  • Input device(s) such as: keyboard, mouse, remote, pointer, etc.

A One-Step Solution to Flashing Your MicroSD Card

Please try our PINE64 Installer to easily select the PINE A64(+), SOPINE/PINE A64-LTS, Pinebook or ROCK64 OS of your choice and flash it to your MicroSD Card.

You can also flash an OS image manually; please follow the instructions below.

Step-by-Step Instructions to Flashing MicroSD Cards

Caution!

Handle the Pine64 Single Board Computers' PCBs with care. Always hold bare boards by the edges and make sure to wear an anti-static wrist strap. Touching components on the front and back of the boards can result in an ESD discharge that may cause damage to the electronics. Avoid placing bare boards on materials such as carpets, plastics or other surfaces prone to electrostatic build-up.


Begin by imaging the OS of your choice

The process of flashing PINE64 OS images to micro SD on your Windows, Linux or OSX device is the same for all devices. You will require a quality microSD card (8GB or greater; class 10 or faster). There are many substandard and counterfeit cards in circulation and even reputable vendors may unknowingly sell counterfeit microSD cards. Cards that do not meet the criteria outlined above are known to cause a variety of issues including, but not limited to, complete boot failure. There are ways of testing microSD cards prior to installing the operating system to make sure they are appropriate for use with your board. The main utility for checking microSD cards is H2testw 1.4; yet another alternative is F3.

Please refer to the relevant section below for instructions on how to image your microSD card:

Having successfully imaged your microSD card, insert it into the microSD slot.


Plug in the HDMI Cable, Ethernet Cable and Peripherals to your PINE64 SBC

Unless you are planning on running your board headless (without a monitor / as a server) you should plug in all necessary peripherals, including the HDMI and Ethernet cable, prior to powering ON the board. Do note, depending on which OS image you are using, some peripherals may or may not work.


Apply Power to Your Board

Once you have imaged your microSD and plugged everything in, you are ready to apply power to the PIN64 Single Board Computer. You'll need a good quality 5 Volt, 2 Amp PSU. Using a good quality PSU is very important as failing to meet the required specifications may prevent the board from booting correctly. A marginally higher PSU Voltage is acceptable (for instance, 5.1 volts - due to the nature of the micro usb connection, a 5.1v supply can help protect slightly against voltage drops which can cause undesirable results). However, a significantly higher voltage of 7 Volts or more will damage the PINE64 Single Board Computer and may render it inoperative.

For PINE A64(+) board, if you are using a separate micro USB cable with your PSU, make sure that the cable has a low resistance rating. Cables with high resistance will cause improper function and the unit may not boot at all or only partially. The thicker the internal cabling, the better i.e. AWG (American Wire Gauge) 20 is better than AWG 28. In General, power-only microUSB cables come with red colour USB header.

Having completed the steps outlined above the PINE64 SIngle Board Computer will begin to boot. The onboard power-on LEDs will come on and Ethernet port LEDs will start to blink if you have an Ethenet cable plugged in.


Imaging microSD on Windows 7/8/8.1/10

You will need the following utilities to get started with imaging the OS of your choice onto your microSD card:

  • A compression utility (used to unarchive the OS image). We recommend you use 7zip.
  • A disk image utility (used to flash the .img to your SD card). We recommend you use either the Etcher or Win32Imager utility.

Optional for Allwinner A64 SoC based boards

  • Phoenix Card image utility (used ONLY for phoenix card images). You can download it from here.


Downloading and extracting OS image(s)

You can find OS images for the respective devices in the device section on the main page. Images designated ‘DD’ need to be flashed using Etcher or Win32imager, whilst images labelled ‘Phoenix Card Image’ require the Phoenix Card utility.

Having downloaded the required OS image proceed to use 7zip to unarchive it by right-clicking the archive, and selecting ‘Extract All’. Upon completion, note the destination of where the .img file was extracted (‘Downloads’ folder by default). Once the process has completed, you can proceed to imaging the .img file.


Imaging the microSD card (DD)

  • Insert your microSD card into your laptop/USB card reader. You may require a SD → microSD converter, as most laptops and desktops only feature a full-size SD card reader. Once the microSD card is plugged into your computer, make sure to take note of the drive it has been assigned (the drive is assigned a letter, e.g. ‘F:’). You will need to remember the ‘letter’ it has been assigned when imaging the OS.
  • Launch Win32diskImager.exe or etcher.exe. You will be presented with a field titled ‘path’ and a drop down menu labeled ‘device’. Click the ‘path’, navigate to and select the OS image you extracted from the archive earlier. Next, from the drop-down menu select the drive your microSD has been assigned. N.B. Pay close attention to the selected drive (remember your letter) – the imaging process will format the selected drive. If you choose the wrong drive all your data will be lost.
  • Having chosen the desired OS image and the correct driver press ‘write’. Once the image has been written to your microSD card you will receive a pop-up notification. Be sure to close the application and to eject/remove your SD card safely from Windows.


Imaging using Phoenix Card (applicable only to Allwinner A64 SoC based boards)

On Windows, you can also use Phoenix Card (for detailed instructions click here). The Phoenix Card utility works ONLY with images designated as ‘Phoenix Card’ in the downloads section. To use Phoenix Card follow these steps:

  • Insert your microSD card into your laptop/USB card reader. You may require a SD → microSD converter, as most laptops and desktops only feature a full-size SD card reader. Once the microSD card is plugged into your computer, make sure to take note of the drive it has been assigned (the drive is assigned a letter, e.g. ‘F:’). You will need to remember the ‘letter’ it has been assigned when imaging the OS.
  • Launch phoenixcard.exe. You will be presented with a ‘disk’ drop-down menu and a field denoted as ‘.img File’. Click on ‘.img File’ and navigate to and select the OS image have downloaded and unarchived. Next, make sure to select the disk that your microSD card has been assigned. N.B. Pay close attention to the selected drive (remember your letter) – the imaging process will format the selected drive. If you choose the wrong drive all your data will be lost.
  • Make sure to select ‘Startup!’ from the ‘Write mode’ window and click Burn. Once the image has been written to your microSD card you will receive a confirmation in the ‘option’ window. Be sure to close the application and to eject/remove your SD card safely from Windows.



Imaging microSD on Apple OSX

You will need the following utilities to get started with imaging the OS of your choice onto your microSD card:

  • A compression Utility (used to unarchive the OS image). We recommend you use 7Zip.
  • A disk image utility (used to ‘burn’ the .img to your SD card in GUI). We recommend you use ApplePi Baker or Etcher.


N.B. Phoenix Card utility and images are NOT available on Apple OSX.


Downloading and extracting OS image(s)

You can find OS images for the respective devices in the device section on the main page. On OSX you can only use images designated as ‘DD’.

Having downloaded the required OS image proceed to use 7zip to unarchive it by double clicking the archive, and selecting ‘Extract All’. Upon completion, note the destination where the .img file was extracted (‘Downloads’ folder by default). Once the process has completed, you can proceed to imaging the .img file.


Imaging the microSD card (GUI)

  • Insert your microSD card into your Mac laptop/USB card reader. You may require a SD → microSD converter, as Apple’s laptops and desktops only feature a full-size SD card reader. Once the microSD card is plugged into your computer it should appear in Finder / on your desktop.
  • Launch Apple-Pi Baker or the etcher utility. Upon startup the application it will ask for your password. When the application launches you will be presented with a field titled ‘IMG file’ and a path of the mounted microSD card (it will look something like this: ‘/dev/diskX 32.0Gb SD card’). Click the ‘IMG file’ button, navigate to and select the OS image you extracted from the archive earlier. Next, select the microSD from the window. N.B. Pay close attention to the selected drive – the imaging process will format the selected drive. If you choose the wrong drive all your data will be lost.
  • Having chosen the desired OS image and the correct driver press ‘Restore Backup’. Once the image has been written to your microSD card you will receive a pop-up notification. Be sure to close the application and to eject/remove your SD card safely from your Mac.


Imaging from Terminal

N.B. If you are not comfortable using the terminal, please use the GUI method outlined above instead.

  • Insert your microSD card into your Mac laptop/USB card reader. You may require a SD → microSD converter, as Apple’s laptops and desktops only feature a full-size SD card reader. Once the microSD card is plugged into your computer it should appear in Finder / on your desktop.
  • Open up your terminal and navigate to the directory where you unarchived your OS image.
  • Before you start writing to the card, you will have to identify your microSD card. Type: diskutil list and note the output. The disk number should match the size of your SD card and will likely be using ‘Fdisk_partition_scheme’. Having identified the disk number execute the following commands (substitute diskX for your disk and name of image for pine64-image-name.img):

diskutil unmountDisk /dev/diskX sudo dd if=pine64-image-name.img of=/dev/disk2 bs=1M

  • Wait patiently for the process to complete. Be sure to eject/remove your SD card safely from your Mac.



Imaging microSD on Linux

You will need the following utilities to get started with imaging the OS of your choice onto your microSD card:

  • A compression Utility (used to unarchive the OS image). We recommend you use 7Zip.
  • A disk image utility (used to ‘burn’ the .img to your SD card in GUI). We recommend you use Etcher or the GUI Disks utility that ships with most popular distros.


N.B. Phoenix Card utility and images are NOT available on Linux.


Downloading and extracting OS image(s)

You can find OS images for the respective devices in the device section on the main page. On Linux you can only use images designated as ‘DD’.

Having downloaded the required OS image proceed to use 7zip to unarchive it by double clicking the archive, and selecting ‘Extract All’. Upon completion, note the destination where the .img file was extracted (‘Downloads’ folder by default). Once the process has completed, you can proceed to imaging the .img file.


Imaging the microSD card (GUI)

  • Insert your microSD card into your Linux laptop/USB card reader. Once the microSD card is plugged into your computer it should appear in your File Manager / on your desktop.
  • Launch Disks or the etcher utility (This tutorial outlines how to use Disks, if you wish to learn how to use Etcher please visit their website).
  • Upon launching Disks, you will be presented with all volumes visible to your computer. As a rule of thumb, your microSD card should be found at the bottom of listed volumes. Verify this by checking the size and mounting of the microSD card. N.B. Pay close attention to the selected drive – the imaging process will format the selected drive. If you choose the wrong drive all your data will be lost.
  • Having selected your microSD card, click the cog menu in top right corner and choose the ‘Restore Disk Image’ option from the drop-down list. Navigate to and select the OS image you extracted from the archive earlier. Once you select it, you will be asked to enter your password and to confirm writing to the chosen volume (microSD card).
  • You will be given a predicted time, writing-speed and completion percentage. Once the image has been written to your microSD card you will receive a pop-up notification. Be sure to close the application and to eject/remove your SD card safely from your computer.


Imaging from Terminal

N.B. If you are not comfortable using the terminal, please use the GUI method outlined above instead.

  • Insert your microSD card into your Linux laptop/USB card reader. Once the microSD card is plugged into your computer it should appear in Finder / on your desktop.
  • Open up your terminal and navigate to the directory where you unarchived your OS image.
  • Before you start writing to the card, you will have to identify your microSD card.
  • Type: lsblk and pay attention to the listed disks. Disks will appear as /dev/sda /dev/sdb etc. Look at the drive that matches your microSD card’s size.
  • Having located the microSD card use the following command to burn the .img of choice to the microSD card (/dev/sdb used as example): ‘’sudo unmount /dev/sdb1
  • Now you are ready to write the image to the microSD card using this command: ‘’sudo dd if=pine64_image_name.img of=/dev/sdb bs=1M
  • Wait patiently for the process to complete. Be sure to eject/remove your SD card safely from your computer.

Instructions to Flashing eMMC Modules

All PINE64 devices - with the notable exception of the original Pine A64(+) SBC - support eMMC modules as an alternative boot and storage solution to micro SD cards. An eMMC module can be purchased for your device(s) from the PINE64 store. The only PINE64 device that ships with an eMMC module by default is the Pinebook.

The available modules come in three different capacities: 16Gb, 32Gb and 64Gb.

There are a few ways to flash eMMC modules with the desired OS image. The following sections are a summary of the processes involved in flashing the OS image of your choice to the eMMC module.

Flashing Using Pine64 Installer (Micro SD-to-eMMC)

This may be the simplest way to install an OS image to eMMC, however the selection of images that can be installed using this method is, at the time of writing, very limited. To flash the OS image to your eMMC using this process you will need the following:

  • An SD card of at least 8Gb capacity
  • A Windows, Linux or Mac OS computer with the PINE64 installer installed. The PINE64 Installer is available for all major platforms.
  • A SD card reader
  • Your PINE64 device with the eMMC module installed


The SD-to-eMMC Flashing Process

  • Begin the process by launching the PINE64 Installer utility and clicking 'Choose an OS'. Next select your device from the drop-down menu. You will be presented with the various OS images available via the utility; you will notice that some of the OS images have SDCard to eMMC listed next to them in the brackets. Only images with this designation in the brackets will be able to help you flash the image of your choice to eMMC.
  • Having selected an OS image put in your microSD card into your SD cardreader and follow the on-screen instructions. The process will flash the SD-to-eMMC installation image to your micro SD card. Once PINE64 Installer has completed the flashing process remove and micro SD card from your computer and place insert it into your PINE64 device.
  • Connect a keyboard and HDMI display for the SD-to-eMMC installation process (does not apply to Pinebook). Make sure that both your eMMC module and micro SD card are inserted into your device and apply power to the unit. You will be provided with further instructions on the display as well as a progress bar of the eMMC installation process. Once the process is complete, power down your PINE64 device and remove the micro SD from its socket. You can now boot into your OS image of choice from the eMMC module.

Flashing Using the USB-to-eMMC Adaptor (Preferred Way)

A USB-to-eMMC adaptor is available from purchase from the PIN64 Store making it easy to mount the eMMC module as a volume in your Windows, Mac OS or Linux computer. The eMMC can hence be flashed directly from your computer with any image similarly to a micro SD card.

This installation method works for all devices that support eMMC modules regardless of the chipset and it is therefore the preferred way of flashing OS images to eMMC. All available OS images for your device can be installed on the eMMC module this way.

For this method you will need the following:

  • A Windows, Linux or Mac OS computer
  • A PINE64 eMMC module
  • The PINE64 USB-to-eMMC adaptor

Flashing eMMC using the adaptor

  • Insert the the eMMC module into the USB adaptor and plug it into your Windows, Linux or Mac OS computer. It should mount as a regular USB drive and show up in your file manager.
  • If you are using Linux or Mac OS you can either use the dd terminal command or a GUI utility such as Etcher to flash the chosen OS Image to eMMC.
  • If you are using a Windows machine use Etcher or Win32 Disk Imager to flash the OS Image to the eMMC module.

Once the image has been flashed using your preferred method safely dismount the USB adaptor in your system and unplug it from your computer. Your eMMC is now ready to boot and can be inserted into the eMMC socket on your PINE64 device.


Flashing to eMMC from a SD Boot (Allwinner A64 Devices)

Some of the available Linux images for Allwinner A64 devices recognise eMMC modules as mounted storage when the device is booted from a micro SD card. This is true for all recent releases of ayufan's Linux images. In result it is possible to flash an OS image to eMMC using the DD command in terminal or the Disks GUI utility included with the Mate desktop.

There are two ways in which an OS image can be flashed from within a micro SD boot:

  • Via a script called Pine64_install_to_eMMC.sh found in /usr/local/sbin. This script will install an Ubuntu Mate OS installation (identical to the on running on the SD) to the eMMC module. To execute the script navigate to its location in the terminal and type sudo ./Pine64_install_to_eMMC.sh. Follow the instructions.
  • By manually downloading and flashing a OS image for your device using DD or the Disk GUI. This way of flashing an OS image to the eMMC is identical to that used on a Linux computer (e.g. for flashing an OS image to a SD card). For more information on how the process works please see the detailed guide on imaging OS images to SD card on Linux.

For the latter of the two methods here is a summary of the process:

  • Flash an OS image which recognises eMMC as mounted storage to a micro SD card. For details on how to flash a micro SD card see section 3.0
  • Insert both the micro SD and eMMC module into your device and power it on.
  • Once the PINE64 device boots from micro SD, open the web browser and download the desired OS image for your device.
  • Once the OS image downloads check in terminal or in Disks utility the eMMC's mounting location.
  • Use the DD command or Disks utility to flash the downloaded image to the eMMC module.
  • Once the flashing process is completed power down your device and remove the micro SD card. You should now be able to power your device back up and it will boot the image flashed to the eMMC module.

Flashing to eMMC using FEL (Allwinner A64 Devices Only)

Under particular circumstances it may prove difficult to rely on a SD card to flash an OS image to an Allwinner A64 device. In such instances OS images can be directly flashed by means of entering into FEL mode. FEL is a low-level subroutine in the BootROM, and the process of enabling FEL differs from one device to another. To learn more about FEL please refer to the SUNXI Wiki section dedicated to the subject.

The process of flashing via FEL is more complex than utilising a micro SD and is therefore better suited for proficient and advanced users.

For the process of flashing an image to the eMMC on a device in FEL mode you will need:

  • A computer running Mac OS or Linux
  • An OTG USB A-to-A cable

To enter FEL you will need to:

  • On the Pinebook, power down the Pinebook and remove the PSU, unscrew the bottom of the case and press down the FEL button on the PCB (REF). Plug in the OTG USB A-to-A cord to your computer and the OTG USB port on the Pinebook (on the right facing an open case). Reinsert the PSU cord and press the power button with the FEL button pressed down. Release the FEL button after 3 seconds.
  • On the Pine A64(+) power down the board and remove the micro SD card and power cord. Plug in the OTG USB A-to-A cord to your computer and the OTG USB port on the Pine A64 (+) and SoPine (top port). Power on the device and immediately after insert a micro SD card with FEL code.


You can check if your device entered FEL mode using lsusb command in terminal. It should be listed as a device on the USB Bus.

The next step is to mount your device so that your computer recognises the eMMC as mass storage (UMS). A script called boot-tools streamlining this process is available thanks to ayufan on his github. Follow his instructions and in terminal perform the following stepps:

or

  • make pine64_ums

Once your device mounts as UMS it will appear in your file manager. In CLI you can check if the storage is listed using fdisk -l.

This process of flashing an OS image to eMMC with the device in FEL mode and mounted as UMS is literally identical to imaging micro SD cards, so please read Step-by-Step Instructions to Flashing Micro SD Cards and follow the procedure. You can use DD or Disks/ Disk Utility to flash the OS image directly to your device's eMMC.

Once the flashing process is completed, power down your device, remove the A-to-A USB OTG cable and after reapply power to boot your device from eMMC.

Flashing to eMMC using Rockchip Tools (Rock64 Only) (section is WIP)

Rockchip has a different boot hierarchy to Allwinner's devices making it much more difficult to flash OS images using the micro SD-to-eMMC scheme used on A64. There are, however, flashing tools that make it possible to flash directly to eMMC on a Rock64 in loader mode.

To flash to the eMMC module using these tools you will need the following:

  • A Windows, Mac OS or Linux computer
  • An A-to-A USB cable
  • The Rock64 board with the eMMC module inserted into the socket

Using Windows 7/8.1/10 You will need to download the Rockchip driver as well as the AndroidTool used for flashing OS images. Having completed the downloads extract both archives.The Rockchip driver needs to be installed prior to using the AndroidTool utility.

Having installed the driver and flashing utility, follow these steps:

  • Make sure that eMMC is inserted into the slot on the Rock64
  • Place a jumper / short out the eMMC pins on the board (consult this document for more details.
  • Insert one end of the A-to-A cable into your Windows PC and the other into your Rock64 OTG USB port (top)
  • Inset the power cord into the Rock64
  • Start AndroidTool; make sure that it reports 'Found One Maskrom Device' (if it does not recognise your device, please repeat previous steps)
  • Select either the latest Stock Android build or ayufan's Android TV build with the suffic -update. Download and the extract the chosen image.
  • In AndroidTool press the firmware tab and navigate to where you extracted the OS image and select it.
  • Press the upgrade tab. You will be prompted when the flashing process is completed.
  • Remove the USB A-to-A cable, power off your board and power it on again to boot into eMMC.

Using Linux or Mac OS

  • Make sure that eMMC is inserted into the slot on the Rock64
  • Download latest stable or pre-release (to be used at own risk) Android TV OS image from ayufan's github. The image you wish to download is the one without a suffix; without -update or -raw in the OS image title.
  • In terminal, download rkflashtool following instructions on ayufan's github
  • Extract the folder containing partitions of the OS image and place the script listed on ayufan's github in the folder
  • Hold down the recovery button on the board
  • Insert one end of the A-to-A cable into your Mac OS or Linux PC and the other into your Rock64 OTG USB port (top)
  • Inset the power cord into the Rock64
  • Check that your device is in loader mode by typing in the terminal sudo rkflashtool n. If rkflashtool doesn't detect the Rock64 please repeat last 3 steps
  • In terminal navigate to where you extracted the Android folder containing the OS partitions and the script and type rkinstall; this will install the community Android TV build to eMMC.
  • Remove the USB A-to-A cable, power off your board and power it on again to boot into eMMC.

Troubleshooting Your Device

There is a number of things that can prevent the PINE64 board from booting up properly. The most common culprits of a failed boot are (to find out more click here):

  • Subpar or counterfeit microSD card
  • Subpar Power Supply
  • High resistance (thin) or a very long microUSB cable
  • Failed imaging of the microSD card or eMMC module

Make sure to have the newest version of the OS image your are running. On Allwinner A64 devices running Linux you can update the kernel and uboot using scripts located in the following directory: /usr/local/sbin

  • To navigate to the directory type (in terminal): cd /usr/local/sbin
  • You list all the available scripts by typing (in terminal): ls
  • To run the script required update script run the following command: sudo ./update_script.sh (substitute the relevant update script for update_script)

Troubleshooting Step by Step

Follow these steps to determine the cause of your problem:

  • Check your PSU and microUSB cable ratings
  • Download and image a base image of Linux
  • Plug in power and Ethernet into your PINE64 device
  • Watch Ethernet port LED activity
  • Check your router for your device's IP
  • Attempt to ssh into your device's from your computer

If your PSU and microUSB meet the criteria, and you have correctly followed the instructions to image your card and power on the board, but you are not seeing any LED activity and cannot ssh into your device then either the imaging process failed (possibly due to a subpar microSD) OR the PSU / microUSB cable is/are faulty.

If your PSU and microUSB meet the criteria, and you have correctly imaged the OS to your card and power on the board and your can ssh into your PINE A64(+) but get no video feed, then it's likely that the native resolution of your monitor/TV is not supported.

If neither of the above mentioned scenarios fits the problem you are facing, please consult this thread (thanks to Ghost for compiling the list): http://forum.pine64.org/showthread.php?tid=680

If you cannot find a solution to your problem you can submit a ticket at: https://support.pine64.org/