Changes

Linux Flashing Guide

2,904 bytes added, 12:26, 21 June 2018
No summary
==Introduction==
This document will guide you through the necessary steps needed to flash your Gemini with a Linux or Android /Linux OS.
'''Please note: ''' '''<span style="color: #ff0000;">Flashing Android or Linux will delete any user data on the device. Please make sure you have a backup of any important data before starting!</span>'''
To flash your Gemini with an Android or Linux firmware you will need a Windows or Linux PC and you will have to complete the following steps:
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>There are 3 steps needed to install Android/Linux your Gemini:</div># Download and Install the FlashTool for software on your Windows PC or LinuxPC# Customise your Gemini partition table. Using a simple tool, you will be able to specify the space you want to reserve for Linux and for Android. You will also be able to choose the firmware to download, at the moment we support Android, Rooted Android, Debian and Sailfish OS.# DownFlash the firmware on your device
 
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>These steps are detailed in the next sections.</div>
==Download and Install FlashTool on Windows==
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>The first step to install FlashTool on a Windows PC is to install the flash tool drivers. These The drivers are needed for your Windows PC to communicate with your Gemini, the minimum requirement is to have a 64bit Windows operating system. You can find the latest drivers here: [http://support.planetcom.co.uk/download/FlashToolDrivers.zip Windows Flash Tool Drivers] Once downloaded, unzip the archive. You will find a folder called '''FlashToolDrivers''', open the folder and double click on the '''Install''' (install.bat) file. Allow the installation to complete by clicking '''Yes''' when asked to make changes. Now that the drivers have been installed, you can download the latest Windows flash tool: [http:/</support.planetcom.co.uk/download/FlashToolWindows.zip Windows Flash Tool]div>
Once downloaded the Windows flash tool, please unzip it to reveal the <div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro'FlashToolWindows''' folder, sans-serif; font-size: 15. Next, run the flash tool by double clicking on 008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'''flash_tool''' (flash_tool.exe) file in >You can find the '''FlashToolWindows''' folderlatest drivers here: [download/FlashToolDrivers.zip Windows Flash Tool Drivers]</div>
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>Once downloaded, unzip the archive. You can now skip will find a folder called '''FlashToolDrivers''', open the next part regarding Linux folder and move double click on the '''Install''' (install.bat) file. Allow the installation to the complete by clicking '''Download Gemini FirmwareYes''' section. You will also need a firmware  when asked to flash, either Linux or Androidmake changes. You can find the available Gemini firmware here: [[Gemini Firmware]]</div>
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>Now that the drivers have been installed, you can download the latest Windows flash tool: [download/FlashToolWindows.zip Windows Flash Tool]</div>
<div style='margin: 0.4em 0px 0.5em; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration-style: initial; text-decoration-color: initial;'>Once downloaded the Windows FlashTool, please unzip it to reveal the '''FlashToolWindows''' folder. Next, run the flash tool by double clicking on '''flash_tool''' (flash_tool.exe) file in the '''FlashToolWindows''' folder.</div>
==Download and Install FlashTool on Linux==
<code>sudo apt-get install libjpeg62</code>
 
'''Notes - Fedora 28'''
<code>xhost +local:</code>
Additionally you will have to restart the udev service by typing (or rebooting your machine):
<code>udevadm control --reload-rules && udevadm trigger</code>
==Download Android-Only Customise your Gemini Firmware==Now that the Flash Tool is running, it is time to download the Gemini Firmware. Planet Computers provides both an Android-only firmware and a Linux or Android-Linux firmware. If you choose to flash a standard Android firmware, you will have to download one from this page: [[Gemini Firmware|Gemini Firmware.]] After downloading the firmware, unzip it to reveal the folder containing the firmware folder, for example '''Gemini_WIFI_MP_09052018''' or '''Gemini_x27_FOTA3_12062018'''.   ==Download Android/Linux Gemini Firmwarepartition table==
If you choose to flash a Linux or Android-Linux firmware, then you will have to repartition your device, reserving some space for Linux and some for Android. To repartition your Gemini you will have to use our partition tool, available at [http://support.planetcom.co.uk/partitionTool.html http://support.planetcom.co.uk/partitionTool.html]. A screenshot of the tool is provided below.
[[File:Screen_Shot_2018-06-20_at_11.06.06.png|800x527px|center|640x422px|border]]
You can choose the partition size for Linux and Android by dragging the planet slider left or right. You can choose to have an Android-only Gemini, a multi boot Linux-Android or a Linux-only Gemini. Once you have selected the partition sizes you have to select your Gemini model using the appropriate drop down menu.
* The optional Linux (Debian, Sailfish or Debian+Sailfish) contains the additional Linux module. This needs to be unzipped into the firmware folder
Once you have extracted the base firmware, copied the scatter file and unzipped the optional Linux module, you will be ready to proceed to the next step.
==Configuring Flash Tool==