Planet Computers - User contributions [en-gb]

File:Screenshot 2021-05-05 at 10.33.22.png

2021-05-05T09:33:40Z

Dguidi:

DummyPage

2021-05-05T09:30:34Z

Dguidi: /* Test3 */

==Test1==

==Another Test 2==
===Test2===
Test3

This is some text

DummyPage

2021-05-05T09:30:15Z

Dguidi: /* Test1 */

==Test1==

==Another Test 2==
===Test2===
====Test3====
This is some text

DummyPage

2021-05-05T09:29:52Z

Dguidi: Created page with "==Test1== ===Test2=== ====Test3==== This is some text"

==Test1==

===Test2===

====Test3====

This is some text

Linux for Cosmo

2021-05-05T09:17:21Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

<span style="color: #ff0000;">Please note we are investigating an issue related to not receiving incoming calls with this version of Linux.</span>

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

Notes on Linux v4 installation:

* The new installer will allow you to select your keyboard layout and time zone
* If you use a dual keyboard layoyut, your settings might not be picked up on the very first boot. For example if you choose Japanese layout, on your first boot the screen and keyboard layout could still be set to English. Simply reboot the unit and both the language and keyboard layout will be fully configured. Remember you can switch between the 2 keyboard layouts by pressing both left and right shift buttons at the same time.

For more information about this release, please see [https://gemian.thinkglobally.org/releases/2021-04-22-gemian-release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

'''The latest Linux v4 will automatically configure the keyboard layout based on the installation choice. The following guide is obsolete and kept as reference.'''

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T19:46:07Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

Notes on Linux v4 installation:

* The new installer will allow you to select your keyboard layout and time zone
* If you use a dual keyboard layoyut, your settings might not be picked up on the very first boot. For example if you choose Japanese layout, on your first boot the screen and keyboard layout could still be set to English. Simply reboot the unit and both the language and keyboard layout will be fully configured. Remember you can switch between the 2 keyboard layouts by pressing both left and right shift buttons at the same time.

For more information about this release, please see [https://gemian.thinkglobally.org/releases/2021-04-22-gemian-release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

'''The latest Linux v4 will automatically configure the keyboard layout based on the installation choice. The following guide is obsolete and kept as reference.'''

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T16:42:13Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

Notes on Linux v4 installation:

* The new installer will allow you to select your keyboard layout and time zone
* If you use a dual keyboard layoyut, your settings might not be picked up on the very first boot. For example if you choose Japanese layout, on your first boot the screen and keyboard layout could still be set to English. Simply reboot the unit and both the language and keyboard layout will be fully configured. Remember you can switch between the 2 keyboard layouts by pressing both left and right shift buttons at the same time.

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

'''The latest Linux v4 will automatically configure the keyboard layout based on the installation choice. The following guide is obsolete and kept as reference.'''

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T16:40:18Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

Note on Linux v4 installation:

* The new installer will allow you to select your keyboard layout and time zone
* If you use a dual keyboard layoyut, your settings might not be picked up on the very first boot. For example if you choose Japanese layout, on your first boot the screen and keyboard layout could still be set to English. Simply reboot the unit and both the language and keyboard layout will be fully configured. Remember you can switch between the 2 keyboard layouts by pressing both left and right shift buttons at the same time.

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

'''The latest Linux v4 will automatically configure the keyboard layout based on the installation choice. The following guide is obsolete and kept as reference.'''

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Main Page

2021-04-28T12:16:10Z

Dguidi: /* Cosmo Communicator Latest News */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 28/04/2021 - Linux firmware v4 for Cosmo Communicator has been released! A special thanks goes to Adam Boardman and all the volunteers from our Open Source community. Read more about the latest Linux [[Linux for Cosmo|here]].
* 22/03/2021 - Android firmware v25 has been released! This version includes keyboard firmware improvements, security patches and bug fixes. If you use the rooted Android Firmware, [[Rooted Android For Cosmo|make sure to update it by following these instructions]].
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features, including Cosmo Cover Display support. [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Main Page

2021-04-28T12:12:47Z

Dguidi: /* Cosmo Communicator Latest News */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 28/04/2021 - Linux firmware v4 for Cosmo Communicator has been released! A special thanks goes to Adam Boardman and all the volunteers of our Open Source community. Read more about the latest Linux [[Linux for Cosmo|here]].
* 22/03/2021 - Android firmware v25 has been released! This version includes keyboard firmware improvements, security patches and bug fixes. If you use the rooted Android Firmware, [[Rooted Android For Cosmo|make sure to update it by following these instructions]].
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features, including Cosmo Cover Display support. [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Main Page

2021-04-28T12:11:17Z

Dguidi: /* Cosmo Communicator Latest News */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 28/04/2021 - Linux firmware v4 for Cosmo Communicator has been release!
* 22/03/2021 - Android firmware v25 has been released! This version includes keyboard firmware improvements, security patches and bug fixes. If you use the rooted Android Firmware, [[Rooted Android For Cosmo|make sure to update it by following these instructions]].
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features, including Cosmo Cover Display support. [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Linux for Cosmo

2021-04-28T12:10:25Z

Dguidi: /* Debian/KDE installation */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

'''The latest Linux v4 will automatically configure the keyboard layout based on the installation choice. The following guide is obsolete and kept as reference.'''

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T12:08:22Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to install Linux v4.'''

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T12:08:09Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoing support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, updating from v3 to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to update to Linux v4.'''

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T12:07:22Z

Dguidi: /* Linux News */

==Linux News==
'''28/04/2021 - The latest Linux Debian firmware v4 is now available!'''

Thanks to the ongoin support from the open source community, today we are glad to release the latest Linux Debian v4 for Cosmo Communicator!

This latest release provides bug fixes and new features:

* Support for Camera is now available
* Improved boot screen and lock screen
* Support for dual keyboard language layout. If you use a dual keybaord layout, such as Japanese, you can press both shift keys at the same time to cycle between the layouts (i.e. english and japanese).
* New installation program allows you to select your keyboard layout and time zone. The information is then stored in phone settings and retained even after Linux reinstallation.

Please note that altough it's possible to keep using Linux v3, update to v4 using apt is not possible.

'''It's therefore recommended to use the guide below to update to Linux v4.'''

For more information about this release, please see [https://gemian.thinkglobally.org/preview/release-notes.txt here].

'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T11:49:11Z

Dguidi: /* Cosmo Linux installation */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

Touchpad functionality for Linux is added in the latest CoDi, version 1.1.1.16.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-04-28T11:48:26Z

Dguidi: /* Cosmo Linux installation */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

====Download and Install Linux firmware v4 (latest)====
You will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v4.zip] (MD5: 8e5b2ec60d45627e66828f419fe63199)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux v3 Installation

2021-04-28T11:43:38Z

Dguidi: /* No summary */

==Cosmo Linux installation==
====Existing Linux installations====
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V25 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v25====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
Using the latest Android firmware version v25 the Cover Display application will automatically install the latest Codi firmware v15. It is therefore recommended to update the Android firmware and use the Cover Display to install the latest Codi firmware.

For reference, you can find how to manually install Codi v15 using Android v23 [[Manual Install Codi v15|here]].

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

Latest Cosmo Firmware

2021-04-27T08:52:36Z

Dguidi: /* Android Firmware update v25 - 22/03/2021 */

===Android Firmware update v25 - 22/03/2021===
<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;"> This version includes keyboard firmware improvements, security patches and bug fixes. </span>

<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;">If you use the rooted Android Firmware, </span>[[Rooted Android For Cosmo|make sure to update it by following these instructions]].

===Android Firmware update v23 - 6/07/2020===
This Android firmware release contains some improvements in the cover display communication and bug fixes, as well as introducing the power save setting for the Cover Display.

The Cover Display power save setting is OFF by default and can be found in Settings -> Cosmo Settings.

The new option is called “Cover Display Power Save”. If enabled, it will activate a power saving functionality that will result in less power being used when the phone is idle. With the option disabled, the firmware will behave as the same V19 firmware.

===Android Firmware update v22 - 22/06/2020'''<br />'''===
The latest Android firmware update includes:

* Modified bootloader to enable mobile radio modem and SIM cards to be recognised when booting into Linux, rooted Android and other non-Android operating systems
* Much improved battery consumption for Cosmo in idle (sleep) mode
* Improved screen rotation function plus soft keyboard availability when Cosmo screen is used in portrait mode
* Recent Android Security and other OS Updates
* Notes app: dictation feature can now be controlled via Cover Display
* Data app: databasefile export and import functions
* Improved eSIM compatibility
* Updated Google certificate
* Bugfixes

Please note that you will have to update your CoDi firmware as well to take advantage of the new features. You can update the CoDi firmware by using the Cover Display Assistant application or alternatively you can [[#Manual CoDi firmware update|update the firmware manually]].

'''Android Firmware update 11/12/2019'''

This Cosmo firmware includes new features and solves a number firmware issues reported by users:

# New settings: switch OFF cover display on power down<br /><br />[[File:ndhcaeyk8nlog9t2na6s.png|center|639x320px|border]]<br /><br />This feature helps saving battery when Cosmo Communicator is powered down by switching OFF the cover display. When powered down in this way, you will only be able to switch on your Cosmo using the Esc key and charge your Cosmo using the left hand side USB-C port. We are looking at further power saving firmware possibilities
# Fix for power charging indicator being on while the keyboard backlight is on.
# The Duraspeed and Background Power Saving settings status is now OFF by default. This fixes the operation of many applications which were reported to be closing in the background when Duraspeed is ON. Some services were being closed down after some time of inactivity.
# The eSIM chip status is now fixed after Cosmo restart, so eSIM selection is preserved (instead of switching to SIM lost 2)
# Fix for Reject ringing call during another call from cover display
# Fix for sending SMS reject call when two calls exist
# Fix for Switch calls and merge calls from cover display
# The Cover Display will now support the advertised landscape mode.
# The Cover display will also support two font sizes for notification text.
# Fix for icon sensitivity on top row of icons on the cover display
# Optimisation for Contact list update on cover display
# Some stability fixes for cover display

==Manual CoDi firmware update==
You can manually update the Codi firmware in case the automatic download fails. The Codi firmware consists of 2 files and the latest version is available here:

* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_firmware-stem_ospi2_1_1_1_14.bin Cosmo_firmware-stem_ospi2_1_1_1_14.bin]
* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_resource-stem_resource_1_1_1_14.bin Cosmo_resource-stem_resource_1_1_1_14.bin]

To manually update the Codi firmware, plesae download and copy these two files on your Cosmo Communicator. After that, run the Codi Display Assistant application, tap on the ADVANCED button and select "Flash Image Manually". On the file selector view, you might have to tap on the "Show Internal storage" option under the more option icon on the top right of the screen (the icon with the 3 round dots).

Bear in mind that the file names are important - please don't rename the files.

Latest Cosmo Firmware

2021-04-26T15:41:53Z

Dguidi:

===Android Firmware update v25 - 22/03/2021===
<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;"> This version includes keyboard firmware improvements, security patches and bug fixes. </span>

<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;">If you use the rooted Android Firmware, </span>[index.php/Rooted_Android_For_Cosmo make sure to update it by following these instructions]<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;">.</span>

===Android Firmware update v23 - 6/07/2020===
This Android firmware release contains some improvements in the cover display communication and bug fixes, as well as introducing the power save setting for the Cover Display.

The Cover Display power save setting is OFF by default and can be found in Settings -> Cosmo Settings.

The new option is called “Cover Display Power Save”. If enabled, it will activate a power saving functionality that will result in less power being used when the phone is idle. With the option disabled, the firmware will behave as the same V19 firmware.

===Android Firmware update v22 - 22/06/2020'''<br />'''===
The latest Android firmware update includes:

* Modified bootloader to enable mobile radio modem and SIM cards to be recognised when booting into Linux, rooted Android and other non-Android operating systems
* Much improved battery consumption for Cosmo in idle (sleep) mode
* Improved screen rotation function plus soft keyboard availability when Cosmo screen is used in portrait mode
* Recent Android Security and other OS Updates
* Notes app: dictation feature can now be controlled via Cover Display
* Data app: databasefile export and import functions
* Improved eSIM compatibility
* Updated Google certificate
* Bugfixes

Please note that you will have to update your CoDi firmware as well to take advantage of the new features. You can update the CoDi firmware by using the Cover Display Assistant application or alternatively you can [[#Manual CoDi firmware update|update the firmware manually]].

'''Android Firmware update 11/12/2019'''

This Cosmo firmware includes new features and solves a number firmware issues reported by users:

# New settings: switch OFF cover display on power down<br /><br />[[File:ndhcaeyk8nlog9t2na6s.png|center|639x320px|border]]<br /><br />This feature helps saving battery when Cosmo Communicator is powered down by switching OFF the cover display. When powered down in this way, you will only be able to switch on your Cosmo using the Esc key and charge your Cosmo using the left hand side USB-C port. We are looking at further power saving firmware possibilities
# Fix for power charging indicator being on while the keyboard backlight is on.
# The Duraspeed and Background Power Saving settings status is now OFF by default. This fixes the operation of many applications which were reported to be closing in the background when Duraspeed is ON. Some services were being closed down after some time of inactivity.
# The eSIM chip status is now fixed after Cosmo restart, so eSIM selection is preserved (instead of switching to SIM lost 2)
# Fix for Reject ringing call during another call from cover display
# Fix for sending SMS reject call when two calls exist
# Fix for Switch calls and merge calls from cover display
# The Cover Display will now support the advertised landscape mode.
# The Cover display will also support two font sizes for notification text.
# Fix for icon sensitivity on top row of icons on the cover display
# Optimisation for Contact list update on cover display
# Some stability fixes for cover display

==Manual CoDi firmware update==
You can manually update the Codi firmware in case the automatic download fails. The Codi firmware consists of 2 files and the latest version is available here:

* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_firmware-stem_ospi2_1_1_1_14.bin Cosmo_firmware-stem_ospi2_1_1_1_14.bin]
* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_resource-stem_resource_1_1_1_14.bin Cosmo_resource-stem_resource_1_1_1_14.bin]

To manually update the Codi firmware, plesae download and copy these two files on your Cosmo Communicator. After that, run the Codi Display Assistant application, tap on the ADVANCED button and select "Flash Image Manually". On the file selector view, you might have to tap on the "Show Internal storage" option under the more option icon on the top right of the screen (the icon with the 3 round dots).

Bear in mind that the file names are important - please don't rename the files.

Latest Cosmo Firmware

2021-04-26T15:41:33Z

Dguidi:

==='''Android Firmware update v25 - 22/03/2021'''===
<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;"> This version includes keyboard firmware improvements, security patches and bug fixes. </span>

<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;">If you use the rooted Android Firmware, </span>[index.php/Rooted_Android_For_Cosmo make sure to update it by following these instructions]<span style="caret-color: #252525; color: #252525; font-family: 'Source Sans Pro', sans-serif; font-size: 15.008000373840332px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: #ffffff; text-decoration: none; display: inline !important; float: none;">.</span>

==='''Android Firmware update v23 - 6/07/2020'''===
This Android firmware release contains some improvements in the cover display communication and bug fixes, as well as introducing the power save setting for the Cover Display.

The Cover Display power save setting is OFF by default and can be found in Settings -> Cosmo Settings.

The new option is called “Cover Display Power Save”. If enabled, it will activate a power saving functionality that will result in less power being used when the phone is idle. With the option disabled, the firmware will behave as the same V19 firmware.

==='''Android Firmware update v22 - 22/06/2020<br />'''===
The latest Android firmware update includes:

* Modified bootloader to enable mobile radio modem and SIM cards to be recognised when booting into Linux, rooted Android and other non-Android operating systems
* Much improved battery consumption for Cosmo in idle (sleep) mode
* Improved screen rotation function plus soft keyboard availability when Cosmo screen is used in portrait mode
* Recent Android Security and other OS Updates
* Notes app: dictation feature can now be controlled via Cover Display
* Data app: databasefile export and import functions
* Improved eSIM compatibility
* Updated Google certificate
* Bugfixes

Please note that you will have to update your CoDi firmware as well to take advantage of the new features. You can update the CoDi firmware by using the Cover Display Assistant application or alternatively you can [[#Manual CoDi firmware update|update the firmware manually]].

'''Android Firmware update 11/12/2019'''

This Cosmo firmware includes new features and solves a number firmware issues reported by users:

# New settings: switch OFF cover display on power down<br /><br />[[File:ndhcaeyk8nlog9t2na6s.png|center|639x320px|border]]<br /><br />This feature helps saving battery when Cosmo Communicator is powered down by switching OFF the cover display. When powered down in this way, you will only be able to switch on your Cosmo using the Esc key and charge your Cosmo using the left hand side USB-C port. We are looking at further power saving firmware possibilities
# Fix for power charging indicator being on while the keyboard backlight is on.
# The Duraspeed and Background Power Saving settings status is now OFF by default. This fixes the operation of many applications which were reported to be closing in the background when Duraspeed is ON. Some services were being closed down after some time of inactivity.
# The eSIM chip status is now fixed after Cosmo restart, so eSIM selection is preserved (instead of switching to SIM lost 2)
# Fix for Reject ringing call during another call from cover display
# Fix for sending SMS reject call when two calls exist
# Fix for Switch calls and merge calls from cover display
# The Cover Display will now support the advertised landscape mode.
# The Cover display will also support two font sizes for notification text.
# Fix for icon sensitivity on top row of icons on the cover display
# Optimisation for Contact list update on cover display
# Some stability fixes for cover display

==Manual CoDi firmware update==
You can manually update the Codi firmware in case the automatic download fails. The Codi firmware consists of 2 files and the latest version is available here:

* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_firmware-stem_ospi2_1_1_1_14.bin Cosmo_firmware-stem_ospi2_1_1_1_14.bin]
* [http://support.planetcom.co.uk/download/CodiLatest/Cosmo_resource-stem_resource_1_1_1_14.bin Cosmo_resource-stem_resource_1_1_1_14.bin]

To manually update the Codi firmware, plesae download and copy these two files on your Cosmo Communicator. After that, run the Codi Display Assistant application, tap on the ADVANCED button and select "Flash Image Manually". On the file selector view, you might have to tap on the "Show Internal storage" option under the more option icon on the top right of the screen (the icon with the 3 round dots).

Bear in mind that the file names are important - please don't rename the files.

Gemini Android 8 Upgrade

2021-04-14T14:06:45Z

Dguidi: /* Android 8.1 manual upgrade for Gemini 4G (x25 and x27) */

==Android 8.1 manual upgrade for Gemini 4G (x25 and x27)==
'''NOTE: Some users reported problems with Android 8.1 and it's currently recommended to use Android 7 for Gemini devices.'''

'''Android 8 can still be manually installed by using SP Flash Tool following this guide: [[Gemini Firmware]].<br />'''

''' '''

<span style="color: #ff0000;">'''The rest of this guide is now deprecated and left as reference only.'''</span>

'''Please note this guide is for Gemini 4G devices only (both x25 and x27 models), not for Gemini WIFI devices.'''

The following guide will help you to install the Android 8.1 upgrade on your Gemini 4G, both x25 and x27 model. This guide is for an Android-only Gemini firmware. For multi-boot firmware, please see the [[Linux Flashing Guide]] together with the updated [https://support.planetcom.co.uk/partitionTool.html partition tool].

If you have trouble updating your Gemini using the over-the-air udpate mechanism you can follow the guide below to perform a manual upgrade.

'''IMPORTANT INFORMATION for users in Japan on the NTT DoCoMo network: <span style="color: #ff0000;">we had some reports that the network is not detected by the Android 8 firmware. We are investigating - please wait to upgrade your Gemini until further information is provided </span>'''

To proceed, start by running the Firmware Update application. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

A new version should be detected, please make sure you are connected to a WIFI network.

[[File:Screenshot_20190508-134811.png|center|800x400px|border]]

[[File:Screenshot_20190508-134815.png|center|800x400px|border]]

By tapping on the Download button you will start the firmware update download. If the download completes successfully you will just need to tap on the 'Install Now' button to start the update process and then tap 'Firmware Update' to complete it. In case you have troubles downloading the update, please continue with the guide.

If your download stops and cannot complete successfully you can complete the process manually. To do that, first tap on the square button on the soft keys (bottom right) as in the picture below to bring up the task manager.

[[File:Screenshot_20190508-134832.png|center|800x400px|border]]

After that, close the Firmware Update by swiping it out of the list as in the following screenshot.

Now, run the File Manager application and look at the root folder in Internal Storage. You should see a file called ota.zip. Delete the file by selecting it with a long tap and tap and then using the Delete action on the menu that appears when tapping on the 3 dots button as in the following screenshots.

[[File:Screenshot_20190508-134903.png|center|800x400px|border]]

[[File:Screenshot_20190508-134906.png|center|800x400px|border]]

After that, you can download the firmware from a different location: [http://support.planetcom.co.uk/download/Android8_4G/ota.zip http://support.planetcom.co.uk/download/Android8_4G/ota.zip]. It's easier to download this archive directly from your Gemini, where you just need to open a browser and point it to the URL above. The file will be downloaded in your Download folder.

You can also download the file on a computer and copy it to your Gemini Download folder at a second stage.

Once the file is downloaded, open the File Manager application

[[File:Screenshot_20190507-084642.png|center|800x400px|border]]

In File Manager, browse the Download folder inside the Internal Storage to reveal the downloaded ota.zip archive. Make sure that the file you just downloaded was not been saved with a different file name. In that case rename the file to ota.zip.

[[File:Screenshot_20190507-084700.png|center|800x400px|border]]

Next, we will have to copy the ota.zip file inside the root folder of the Internal Storage. To do that, simply long tap the ota.zip file to select the file and then use the copy icon that will appear once the file is selected, as in the following screenshot.

[[File:Screenshot_20190507-084706.png|center|800x400px|border]]

After that simply go back to the content of the root folder of Internal Storager.

Now, tap on the paste icon to paste the ota.zip file in the root folder.

[[File:Screenshot_20190507-084723.png|center|800x400px|border]]

 

Please note that if you already have a file called ota.zip, then the just copied file will be renamed with an extension. In that case, please remove the ota.zip file in the root folder of your Internal Storage and copy/paste the file again.

Now that we copied the update archive in the correct location, we need to start the update process. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

Now, inside the Firmware Update application, tap on the settings icon, in the top right of the screen.

[[File:29.jpg|center|800x400px|border]]

Inside settings, tap on Manual Update.

[[File:32.jpg|center|800x400px|border]]

 

You should then be presented with a screen as in the screenshot below. Tap on 'Install Now' option on the left.

[[File:01.jpg|center|800x400px|border]]

A confirmation dialog will then appear. By tapping on the 'Firmware Update' button you will start the update procedure. Note the the button might be not fully visible in landscape mode.

[[File:22.jpg|center|800x400px|border]]

Your Gemini will then reboot and complete the update. Once the update is completed you will see the following message.

[[File:Screenshot_20190507-085946.png|center|800x400px|border]]

Please note that the Android 8.1 update might trigger a number of upgrade scripts and application updates. As a result your device might appear slower and feel hotter than usual for some time.

==Notes on using your Gemini with Android 8.1 ==
===Re-starting and booting Android 8.1 for the first time===
<div style='color: #000000; text-align: start; text-decoration: none;'>The first boot of the ungraded Android 8 Gemini will take a while as the system is booting for the first time.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Once the Gemini has restarted, it will still take some time until the installation is fully complete. You will get an on-screen message that the Android update is complete. After that the device may still feel a bit sluggish as file formats and data is being adapted for each application to Android 8 formats. This process should last a maximum of few hours, but it is dependent on the storage of your device. The more data you have the longer the process may take. You may feel the device even getting warm from the processing of this data. </div>

===Android 8 security ===
<div style='color: #000000; text-align: start; text-decoration: none;'>Because the security frameworks are different in Android 8 and Android 7, you may be asked to re-authenticate your Google or other accounts as well as to re-grant permissions for the apps that you are running.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Typically you will be asked to grant specific permissions with an on-screen message.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>If you notice any apps crashing, this may be because they are simply not compatible with Android 8. Please check in Settings->Apps if all the required permissions have been granted to the app that is crashing, just in case it is a security issue.</div>

===New features in Android 8===
<div style='color: #000000; text-align: start; text-decoration: none;'>'''[[File:Screenshot_20190508-135353.png|800x400px|center|border]]'''</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>We have introduced some new settings for the Gemini in Android 8.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can now move the Android Navigation bar from the right hand side of the screen to the left hand side using the "Move Navigation Bar to the left side" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can also completely remove the Android Navigation bar from the screen by using the "Hide Navigation Bar" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You will need to restart the Gemini for this feature to take effect. </div>

<div style='color: #000000; text-align: start; text-decoration: none;'>When the Navigation Bar is hidden you will need to use the keyboard shortcuts for the Go Back, Go to Desktop and Apps list functions.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The keyboard shortcuts for Go Back, Go to Desktop and Apps list are as follows:</div>
* Back - Esc (escape key)
* Desktop - Fn + d
* Apps - Fn + a

<div style='color: #000000; text-align: start; text-decoration: none;'>There is a new keyboard shortcut to rotate the screen:</div>
* Shift + Fn + R will rotate the screen from landscape to portrait and vice versa.

<div style='color: #000000; text-align: start; text-decoration: none;'>[[File:Screenshot_20190508-135359.png|800x400px|center|border]]</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The new App Bar is now scrollable. You can scroll left and right and extend the number of app icons in the app bar.</div>

===Reporting issues===
<div style='color: #000000; text-align: start; text-decoration: none;'>Please report any issue with Android 8 on Gemini to support@planetcom.co.uk</div>

==Known Bugs==
* LEDison has been reported to crash under some circumstancies - we will update the application in the Play Store soon
* It has been reported that sometimes the Micro SD may 'disappear' - we are investigating, but if this happens to you, just reboot your Gemini
* The Factory Reset does not work on Android 8 - we are investigating this

Gemini Android 8 Upgrade

2021-04-14T14:05:44Z

Dguidi: /* Android 8.1 manual upgrade for Gemini 4G (x25 and x27) */

==Android 8.1 manual upgrade for Gemini 4G (x25 and x27)==
'''NOTE: Some users reported problems with Android 8.1 and it's currently suggested to use Android 7 for Gemini devices.'''

'''Android 8 can still be manually installed by using SP Flash Tool, following this guide: [[Gemini Firmware]].<br />'''

''' '''

<span style="color: #ff0000;">'''The following guide is deprecated and left as reference only.'''</span>

'''Please note this guide is for Gemini 4G devices only (both x25 and x27 models), not for Gemini WIFI devices.'''

The following guide will help you to install the Android 8.1 upgrade on your Gemini 4G, both x25 and x27 model. This guide is for an Android-only Gemini firmware. For multi-boot firmware, please see the [[Linux Flashing Guide]] together with the updated [https://support.planetcom.co.uk/partitionTool.html partition tool].

If you have trouble updating your Gemini using the over-the-air udpate mechanism you can follow the guide below to perform a manual upgrade.

'''IMPORTANT INFORMATION for users in Japan on the NTT DoCoMo network: <span style="color: #ff0000;">we had some reports that the network is not detected by the Android 8 firmware. We are investigating - please wait to upgrade your Gemini until further information is provided </span>'''

To proceed, start by running the Firmware Update application. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

A new version should be detected, please make sure you are connected to a WIFI network.

[[File:Screenshot_20190508-134811.png|center|800x400px|border]]

[[File:Screenshot_20190508-134815.png|center|800x400px|border]]

By tapping on the Download button you will start the firmware update download. If the download completes successfully you will just need to tap on the 'Install Now' button to start the update process and then tap 'Firmware Update' to complete it. In case you have troubles downloading the update, please continue with the guide.

If your download stops and cannot complete successfully you can complete the process manually. To do that, first tap on the square button on the soft keys (bottom right) as in the picture below to bring up the task manager.

[[File:Screenshot_20190508-134832.png|center|800x400px|border]]

After that, close the Firmware Update by swiping it out of the list as in the following screenshot.

Now, run the File Manager application and look at the root folder in Internal Storage. You should see a file called ota.zip. Delete the file by selecting it with a long tap and tap and then using the Delete action on the menu that appears when tapping on the 3 dots button as in the following screenshots.

[[File:Screenshot_20190508-134903.png|center|800x400px|border]]

[[File:Screenshot_20190508-134906.png|center|800x400px|border]]

After that, you can download the firmware from a different location: [http://support.planetcom.co.uk/download/Android8_4G/ota.zip http://support.planetcom.co.uk/download/Android8_4G/ota.zip]. It's easier to download this archive directly from your Gemini, where you just need to open a browser and point it to the URL above. The file will be downloaded in your Download folder.

You can also download the file on a computer and copy it to your Gemini Download folder at a second stage.

Once the file is downloaded, open the File Manager application

[[File:Screenshot_20190507-084642.png|center|800x400px|border]]

In File Manager, browse the Download folder inside the Internal Storage to reveal the downloaded ota.zip archive. Make sure that the file you just downloaded was not been saved with a different file name. In that case rename the file to ota.zip.

[[File:Screenshot_20190507-084700.png|center|800x400px|border]]

Next, we will have to copy the ota.zip file inside the root folder of the Internal Storage. To do that, simply long tap the ota.zip file to select the file and then use the copy icon that will appear once the file is selected, as in the following screenshot.

[[File:Screenshot_20190507-084706.png|center|800x400px|border]]

After that simply go back to the content of the root folder of Internal Storager.

Now, tap on the paste icon to paste the ota.zip file in the root folder.

[[File:Screenshot_20190507-084723.png|center|800x400px|border]]

 

Please note that if you already have a file called ota.zip, then the just copied file will be renamed with an extension. In that case, please remove the ota.zip file in the root folder of your Internal Storage and copy/paste the file again.

Now that we copied the update archive in the correct location, we need to start the update process. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

Now, inside the Firmware Update application, tap on the settings icon, in the top right of the screen.

[[File:29.jpg|center|800x400px|border]]

Inside settings, tap on Manual Update.

[[File:32.jpg|center|800x400px|border]]

 

You should then be presented with a screen as in the screenshot below. Tap on 'Install Now' option on the left.

[[File:01.jpg|center|800x400px|border]]

A confirmation dialog will then appear. By tapping on the 'Firmware Update' button you will start the update procedure. Note the the button might be not fully visible in landscape mode.

[[File:22.jpg|center|800x400px|border]]

Your Gemini will then reboot and complete the update. Once the update is completed you will see the following message.

[[File:Screenshot_20190507-085946.png|center|800x400px|border]]

Please note that the Android 8.1 update might trigger a number of upgrade scripts and application updates. As a result your device might appear slower and feel hotter than usual for some time.

==Notes on using your Gemini with Android 8.1 ==
===Re-starting and booting Android 8.1 for the first time===
<div style='color: #000000; text-align: start; text-decoration: none;'>The first boot of the ungraded Android 8 Gemini will take a while as the system is booting for the first time.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Once the Gemini has restarted, it will still take some time until the installation is fully complete. You will get an on-screen message that the Android update is complete. After that the device may still feel a bit sluggish as file formats and data is being adapted for each application to Android 8 formats. This process should last a maximum of few hours, but it is dependent on the storage of your device. The more data you have the longer the process may take. You may feel the device even getting warm from the processing of this data. </div>

===Android 8 security ===
<div style='color: #000000; text-align: start; text-decoration: none;'>Because the security frameworks are different in Android 8 and Android 7, you may be asked to re-authenticate your Google or other accounts as well as to re-grant permissions for the apps that you are running.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Typically you will be asked to grant specific permissions with an on-screen message.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>If you notice any apps crashing, this may be because they are simply not compatible with Android 8. Please check in Settings->Apps if all the required permissions have been granted to the app that is crashing, just in case it is a security issue.</div>

===New features in Android 8===
<div style='color: #000000; text-align: start; text-decoration: none;'>'''[[File:Screenshot_20190508-135353.png|800x400px|center|border]]'''</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>We have introduced some new settings for the Gemini in Android 8.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can now move the Android Navigation bar from the right hand side of the screen to the left hand side using the "Move Navigation Bar to the left side" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can also completely remove the Android Navigation bar from the screen by using the "Hide Navigation Bar" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You will need to restart the Gemini for this feature to take effect. </div>

<div style='color: #000000; text-align: start; text-decoration: none;'>When the Navigation Bar is hidden you will need to use the keyboard shortcuts for the Go Back, Go to Desktop and Apps list functions.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The keyboard shortcuts for Go Back, Go to Desktop and Apps list are as follows:</div>
* Back - Esc (escape key)
* Desktop - Fn + d
* Apps - Fn + a

<div style='color: #000000; text-align: start; text-decoration: none;'>There is a new keyboard shortcut to rotate the screen:</div>
* Shift + Fn + R will rotate the screen from landscape to portrait and vice versa.

<div style='color: #000000; text-align: start; text-decoration: none;'>[[File:Screenshot_20190508-135359.png|800x400px|center|border]]</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The new App Bar is now scrollable. You can scroll left and right and extend the number of app icons in the app bar.</div>

===Reporting issues===
<div style='color: #000000; text-align: start; text-decoration: none;'>Please report any issue with Android 8 on Gemini to support@planetcom.co.uk</div>

==Known Bugs==
* LEDison has been reported to crash under some circumstancies - we will update the application in the Play Store soon
* It has been reported that sometimes the Micro SD may 'disappear' - we are investigating, but if this happens to you, just reboot your Gemini
* The Factory Reset does not work on Android 8 - we are investigating this

Gemini Android 8 Upgrade

2021-04-14T14:02:39Z

Dguidi: /* Android 8.1 manual upgrade for Gemini 4G (x25 and x27) */

==Android 8.1 manual upgrade for Gemini 4G (x25 and x27)==
'''NOTE: As some users reported problems with Android 8.1, it's suggested to keep Android 7 for Gemini devices.'''

'''Android 8 Can be manually installed by using the following guide'''

'''Please note this guide is for Gemini 4G devices only (both x25 and x27 models), not for Gemini WIFI devices.'''

The following guide will help you to install the Android 8.1 upgrade on your Gemini 4G, both x25 and x27 model. This guide is for an Android-only Gemini firmware. For multi-boot firmware, please see the [[Linux Flashing Guide]] together with the updated [https://support.planetcom.co.uk/partitionTool.html partition tool].

If you have trouble updating your Gemini using the over-the-air udpate mechanism you can follow the guide below to perform a manual upgrade.

'''IMPORTANT INFORMATION for users in Japan on the NTT DoCoMo network: <span style="color: #ff0000;">we had some reports that the network is not detected by the Android 8 firmware. We are investigating - please wait to upgrade your Gemini until further information is provided </span>'''

To proceed, start by running the Firmware Update application. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

A new version should be detected, please make sure you are connected to a WIFI network.

[[File:Screenshot_20190508-134811.png|center|800x400px|border]]

[[File:Screenshot_20190508-134815.png|center|800x400px|border]]

By tapping on the Download button you will start the firmware update download. If the download completes successfully you will just need to tap on the 'Install Now' button to start the update process and then tap 'Firmware Update' to complete it. In case you have troubles downloading the update, please continue with the guide.

If your download stops and cannot complete successfully you can complete the process manually. To do that, first tap on the square button on the soft keys (bottom right) as in the picture below to bring up the task manager.

[[File:Screenshot_20190508-134832.png|center|800x400px|border]]

After that, close the Firmware Update by swiping it out of the list as in the following screenshot.

Now, run the File Manager application and look at the root folder in Internal Storage. You should see a file called ota.zip. Delete the file by selecting it with a long tap and tap and then using the Delete action on the menu that appears when tapping on the 3 dots button as in the following screenshots.

[[File:Screenshot_20190508-134903.png|center|800x400px|border]]

[[File:Screenshot_20190508-134906.png|center|800x400px|border]]

After that, you can download the firmware from a different location: [http://support.planetcom.co.uk/download/Android8_4G/ota.zip http://support.planetcom.co.uk/download/Android8_4G/ota.zip]. It's easier to download this archive directly from your Gemini, where you just need to open a browser and point it to the URL above. The file will be downloaded in your Download folder.

You can also download the file on a computer and copy it to your Gemini Download folder at a second stage.

Once the file is downloaded, open the File Manager application

[[File:Screenshot_20190507-084642.png|center|800x400px|border]]

In File Manager, browse the Download folder inside the Internal Storage to reveal the downloaded ota.zip archive. Make sure that the file you just downloaded was not been saved with a different file name. In that case rename the file to ota.zip.

[[File:Screenshot_20190507-084700.png|center|800x400px|border]]

Next, we will have to copy the ota.zip file inside the root folder of the Internal Storage. To do that, simply long tap the ota.zip file to select the file and then use the copy icon that will appear once the file is selected, as in the following screenshot.

[[File:Screenshot_20190507-084706.png|center|800x400px|border]]

After that simply go back to the content of the root folder of Internal Storager.

Now, tap on the paste icon to paste the ota.zip file in the root folder.

[[File:Screenshot_20190507-084723.png|center|800x400px|border]]

 

Please note that if you already have a file called ota.zip, then the just copied file will be renamed with an extension. In that case, please remove the ota.zip file in the root folder of your Internal Storage and copy/paste the file again.

Now that we copied the update archive in the correct location, we need to start the update process. Inside Settings, scroll to the bottom and tap on 'About phone'.

[[File:Screenshot_20190507-084800.png|center|800x400px|border]]

 

Next, tap on the first option 'Firmware Update'.

[[File:Screenshot_20190507-084804.png|center|800x400px|border]]

Now, inside the Firmware Update application, tap on the settings icon, in the top right of the screen.

[[File:29.jpg|center|800x400px|border]]

Inside settings, tap on Manual Update.

[[File:32.jpg|center|800x400px|border]]

 

You should then be presented with a screen as in the screenshot below. Tap on 'Install Now' option on the left.

[[File:01.jpg|center|800x400px|border]]

A confirmation dialog will then appear. By tapping on the 'Firmware Update' button you will start the update procedure. Note the the button might be not fully visible in landscape mode.

[[File:22.jpg|center|800x400px|border]]

Your Gemini will then reboot and complete the update. Once the update is completed you will see the following message.

[[File:Screenshot_20190507-085946.png|center|800x400px|border]]

Please note that the Android 8.1 update might trigger a number of upgrade scripts and application updates. As a result your device might appear slower and feel hotter than usual for some time.

==Notes on using your Gemini with Android 8.1 ==
===Re-starting and booting Android 8.1 for the first time===
<div style='color: #000000; text-align: start; text-decoration: none;'>The first boot of the ungraded Android 8 Gemini will take a while as the system is booting for the first time.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Once the Gemini has restarted, it will still take some time until the installation is fully complete. You will get an on-screen message that the Android update is complete. After that the device may still feel a bit sluggish as file formats and data is being adapted for each application to Android 8 formats. This process should last a maximum of few hours, but it is dependent on the storage of your device. The more data you have the longer the process may take. You may feel the device even getting warm from the processing of this data. </div>

===Android 8 security ===
<div style='color: #000000; text-align: start; text-decoration: none;'>Because the security frameworks are different in Android 8 and Android 7, you may be asked to re-authenticate your Google or other accounts as well as to re-grant permissions for the apps that you are running.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>Typically you will be asked to grant specific permissions with an on-screen message.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>If you notice any apps crashing, this may be because they are simply not compatible with Android 8. Please check in Settings->Apps if all the required permissions have been granted to the app that is crashing, just in case it is a security issue.</div>

===New features in Android 8===
<div style='color: #000000; text-align: start; text-decoration: none;'>'''[[File:Screenshot_20190508-135353.png|800x400px|center|border]]'''</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>We have introduced some new settings for the Gemini in Android 8.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can now move the Android Navigation bar from the right hand side of the screen to the left hand side using the "Move Navigation Bar to the left side" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You can also completely remove the Android Navigation bar from the screen by using the "Hide Navigation Bar" setting.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>You will need to restart the Gemini for this feature to take effect. </div>

<div style='color: #000000; text-align: start; text-decoration: none;'>When the Navigation Bar is hidden you will need to use the keyboard shortcuts for the Go Back, Go to Desktop and Apps list functions.</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The keyboard shortcuts for Go Back, Go to Desktop and Apps list are as follows:</div>
* Back - Esc (escape key)
* Desktop - Fn + d
* Apps - Fn + a

<div style='color: #000000; text-align: start; text-decoration: none;'>There is a new keyboard shortcut to rotate the screen:</div>
* Shift + Fn + R will rotate the screen from landscape to portrait and vice versa.

<div style='color: #000000; text-align: start; text-decoration: none;'>[[File:Screenshot_20190508-135359.png|800x400px|center|border]]</div>

<div style='color: #000000; text-align: start; text-decoration: none;'>The new App Bar is now scrollable. You can scroll left and right and extend the number of app icons in the app bar.</div>

===Reporting issues===
<div style='color: #000000; text-align: start; text-decoration: none;'>Please report any issue with Android 8 on Gemini to support@planetcom.co.uk</div>

==Known Bugs==
* LEDison has been reported to crash under some circumstancies - we will update the application in the Play Store soon
* It has been reported that sometimes the Micro SD may 'disappear' - we are investigating, but if this happens to you, just reboot your Gemini
* The Factory Reset does not work on Android 8 - we are investigating this

Main Page

2021-03-22T11:06:59Z

Dguidi: /* Cosmo Communicator Latest News */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 22/03/2021 - Android firmware v25 has been released! This version includes keyboard firmware improvements, security patches and bug fixes. If you use the rooted Android Firmware, [[Rooted Android For Cosmo|make sure to update it by following these instructions]].
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features, including Cosmo Cover Display support. [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Linux for Cosmo

2021-03-22T11:03:37Z

Dguidi: /* Rooted Android installation */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V25 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v25====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
Using the latest Android firmware version v25 the Cover Display application will automatically install the latest Codi firmware v15. It is therefore recommended to update the Android firmware and use the Cover Display to install the latest Codi firmware.

For reference, you can find how to manually install Codi v15 using Android v23 [[Manual Install Codi v15|here]].

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
'''Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]'''

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-03-22T11:03:19Z

Dguidi: /* Rooted Android installation */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V25 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v25====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
Using the latest Android firmware version v25 the Cover Display application will automatically install the latest Codi firmware v15. It is therefore recommended to update the Android firmware and use the Cover Display to install the latest Codi firmware.

For reference, you can find how to manually install Codi v15 using Android v23 [[Manual Install Codi v15|here]].

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Please see [[Rooted Android For Cosmo|this page for instruction on how to install Rooted Android on a Cosmo.]]

The following information is now outdated and kept as reference only.

Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Rooted Android For Cosmo

2021-03-22T11:01:22Z

Dguidi: /* Completing Rooted Android Firmware setup */

====Download and Install Rooted Android for Firmware v25 (latest)====
The latest Android Firmware v25 requires an updated rooted Android Firmware.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/rooted_android_v25.zip http://support.planetcom.co.uk/download/rooted_android_v25.zip] (MD5: 261bfe7633494174157716aa8c8b9578)

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

====Completing Rooted Android Firmware setup====
After booting into the rooted Android partition, complete the installation by tapping on the Magisk application icon. Once started, Magist will ask to upgrade to full Magisk to finish the setup.

[[File:Screenshot_20210322-105526.png|800x400px|center|border]]

Tap OK to Download and Install. The phone will then reboot into Recovery mode, from which you can exit by press and hold the ESC button. The installation is now complete, you can now install a root checker application to verify that the phone is rooted. Please note that the firmware will be rooted only when selecting ROOTED_ANDROID boot when starting the phone. If you select NORMAL boot, then the standard Android will be started.

File:Screenshot 20210322-105526.png

2021-03-22T10:59:26Z

Dguidi:

Rooted Android For Cosmo

2021-03-22T10:49:59Z

Dguidi: /* Download and Install Rooted Android for Firmware v25 (latest) */

====Download and Install Rooted Android for Firmware v25 (latest)====
The latest Android Firmware v25 requires an updated rooted Android Firmware.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/rooted_android_v25.zip http://support.planetcom.co.uk/download/rooted_android_v25.zip] (MD5: 261bfe7633494174157716aa8c8b9578)

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

====Completing Rooted Android Firmware setup====
After booting into the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

MediaWiki:Sidebar

2021-03-22T10:49:00Z

Dguidi:

* navigation
** mainpage|mainpage-description
** Cosmo Configuration|Cosmo Configuration
** Cosmo Troubleshooting|Cosmo Troubleshooting
** Cosmo Firmware upgrade|Updating your Cosmo
** Latest Cosmo Firmware|Latest Cosmo Firmware
** Rooted Android For Cosmo|Rooted Android For Cosmo
** Linux for Cosmo|Linux for Cosmo
** Configuration|Gemini Configuration
** Gemini Android 8 Upgrade|Gemini Android 8 Upgrade
** Gemini Firmware | Gemini Firmware
** Android Flashing Guide|Gemini Android Flashing Guide
** Linux Flashing Guide|Gemini Linux Flashing Guide
** Debian Notes|Gemini Debian Notes
** Sailfish OS Notes|Gemini Sailfish OS Notes
** Kali Notes|Gemini Kali Notes
** Troubleshooting|Gemini Troubleshooting
** Android Manual Update|Gemini Android Manual Update

Rooted Android For Cosmo

2021-03-22T10:46:27Z

Dguidi: /* Download and Install Rooted Android for Firmware v25 (latest) */

====Download and Install Rooted Android for Firmware v25 (latest)====
You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/rooted_android_v25.zip http://support.planetcom.co.uk/download/rooted_android_v25.zip] (MD5: 261bfe7633494174157716aa8c8b9578)

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

====Completing Rooted Android Firmware setup====
After booting into the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Rooted Android For Cosmo

2021-03-22T10:43:15Z

Dguidi: Created page with "====Download and Install Rooted Android for Firmware v25 (latest)==== You can download the latest archive file at this URL: * [http://support.planetcom.co.uk/download/cosmo-c..."

====Download and Install Rooted Android for Firmware v25 (latest)====
You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

Once you select a custom OS you have to select where to install its boot firmware.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

====Completing Rooted Android Firmware setup====
After booting into the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2021-03-22T10:26:49Z

Dguidi: /* Cosmo Linux installation */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V25 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v25====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
Using the latest Android firmware version v25 the Cover Display application will automatically install the latest Codi firmware v15. It is therefore recommended to update the Android firmware and use the Cover Display to install the latest Codi firmware.

For reference, you can find how to manually install Codi v15 using Android v23 [[Manual Install Codi v15|here]].

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Manual Install Codi v15

2021-03-22T10:23:07Z

Dguidi: Created page with "Starting with Android firmware version v25, Codi v15 can be installed automatically using the Cover Display application. This section is now outdated - it explains how to man..."

Starting with Android firmware version v25, Codi v15 can be installed automatically using the Cover Display application.

This section is now outdated - it explains how to manually install Codi v15 using Android firmware v23.

To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|800x400px|center|border]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

Linux for Cosmo

2021-03-22T10:04:19Z

Dguidi: /* Existing Linux installations */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
Before installing Linux, make sure you have the latest Android Firmware installed, currently v25.

If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

TWRP Manual Recovery

2021-01-11T16:31:30Z

Dguidi: /* No summary */

This page is aimed at users that soft bricked their Cosmo Communicator by corrupting the the boot or recovery partition, for example because of improper use of TWRP.

First of all, if you can still boot into the original Recovery mode, then restoring a full Android firmware is easy. You will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) and then use the Recovery mode to install the Android firmware.

In case you can't boot into Recovery mode, there could still be a chance of recovering the Android installation if you can boot into TWRP. The procedure here is a bit more complicated:

* As in the previous case, you will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]])
* In this case, please '''make sure you use version v23.'''
* After that, download [https://support.planetcom.co.uk/download/Cosmo_Installer_V23_TWRP.sh this file] and place it into the SD card under the '''cosmo-customos-installer''' folder
* Put the SD card into your Cosmo Communicator and boot into TWRP. Your SD content should be available in folder /auto0-1.
* Tap on "Advanced" and then "Terminal" to open the terminal application
* Finally, type the following commands (using the on-screen keyboard):

<code>cd /auto0-1/cosmo-customos-installer</code>

<code>sh Cosmo_Installer_V23_TWRP.sh</code>

This should restore your Andriod firmware on your Cosmo Communicator.

If you can't boot into either Recovery mode or TWRP then you will most likely have to send the device to us for repair.

TWRP Manual Recovery

2021-01-11T16:28:51Z

Dguidi: /* No summary */

This page is aimed at users that soft bricked their Cosmo Communicator by corrupting the the boot or recovery partition, for example because of improper use of TWRP.

First of all, if you can still boot into the original Recovery mode, then restoring a full Android firmware is easy. You will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) and then use the Recovery mode to install the Android firmware.

In case you can't boot into Recovery mode, there could still be a chance of recovering the Android installation if you can boot into TWRP. The procedure here is a bit more complicated:

* As in the previous case, you will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]])
* In this case, please '''make sure you use version v23.'''
* After that, download [https://support.planetcom.co.uk/download/Cosmo_Installer_V23_TWRP.sh this file] and place it into the SD card under the '''cosmo-customos-installer''' folder
* Put the SD card into your Cosmo Communicator and boot into TWRP. Your SD content should be available in folder /auto0-1.
* Tap on "Advanced" and then "Terminal" to open the terminal application
* Finally, type the following commands (use the on-screen keyboard as the keyboard layout will differ from your one)

<code>cd /auto0-1/cosmo-customos-installer</code>

<code>sh Cosmo_Installer_V23_TWRP.sh</code>

This should restore your Andriod firmware on your Cosmo Communicator.

If you can't boot into either Recovery mode or TWRP you will most likely have to send the device to us for repair.

TWRP Manual Recovery

2021-01-11T16:26:20Z

Dguidi:

This page is aimed at users that soft bricked their Cosmo Communicator by corrupting the the boot or recovery partition, for example because of improper use of TWRP.

First of all, if you can still boot into the original Recovery mode, then restoring a full Android firmware is easy. You will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) and then use the Recovery mode to install the Android firmware.

In case you can't boot into Recovery mode, there could still be a chance of recovering the Android installation if you can boot into TWRP. The procedure here is a bit more complicated:

* As in the previous case, you will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) Make sure you use version v23.
* After that, download [https://support.planetcom.co.uk/download/Cosmo_Installer_V23_TWRP.sh this file] and place it into the SD card under the '''cosmo-customos-installer''' folder
* Put the SD card into your Cosmo Communicator and boot into TWRP. Your SD content should be available in folder /auto0-1.
* Tap on "Advanced" and then "Terminal" to open the terminal application
* Finally, type the following commands

<code>cd /auto0-1/cosmo-customos-installer</code>

<code>sh Cosmo_Installer_V23_TWRP.sh</code>

This should restore your Andriod firmware on your Cosmo Communicator.

If you can't boot into either Recovery mode or TWRP you will most likely have to send the device to us for repair.

TWRP Manual Recovery

2021-01-11T16:23:32Z

Dguidi: Created page with "This page is aimed at users that soft bricked their Cosmo Communicator by corrupting the the boot or recovery partition, for example because of improper use of TWRP. First of..."

This page is aimed at users that soft bricked their Cosmo Communicator by corrupting the the boot or recovery partition, for example because of improper use of TWRP.

First of all, if you can still boot into the original Recovery mode, then restoring a full Android firmware is easy. You will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) and then use the Recovery mode to install the Android firmware.

In case you can't boot into Recovery mode, there could still be a chance of recovering the Android installation if you can boot into TWRP. The procedure here is a bit more complicated:

* As in the previous case, you will need to prepare an SD card following these instructions ([[Cosmo Android Firmware Manual Installation]]) Make sure you use version v23.
* After that, download this file and place it into the SD card under the '''cosmo-customos-installer''' folder
* Put the SD card into your Cosmo Communicator and boot into TWRP. Your SD content should be available in folder /auto0-1.
* Tap on "Advanced" and then "Terminal" to open the terminal application
* Finally, type the following commands

<code>cd /auto0-1/cosmo-customos-installer</code>

<code>sh Cosmo_Installer_V23_TWRP.sh</code>

This should restore your Andriod firmware on your Cosmo Communicator.

If you can't boot into either Recovery mode or TWRP you will most likely have to send the device to us for repair.

Linux for Cosmo

2020-12-11T10:20:26Z

Dguidi: /* Linux News */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after these commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-12-11T10:20:06Z

Dguidi: /* Linux News */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after executing the commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-12-11T10:19:48Z

Dguidi: /* Linux News */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

Please reboot the unit after the executing the commands.

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-12-11T09:56:29Z

Dguidi: /* Linux News */

==Linux News==
'''11/12/2020 - Linux update<br />'''

Today we released a new update for Linux users! It can be installed by typing the following commands in a terminal:

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

The update includes a brand new feature which allow users to set the keyboard brightness either by using the key combinations Shift+Fn+B and Shift+Fn+N or by setting its value in the settings (System Settings ->Power Management -> Energy Saving -> Keyboard backlight)

The update also contains keyboard improvements and CoDi bug fixes.

'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-11-19T12:46:51Z

Dguidi: /* Debian/KDE installation */

==Linux News==
'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetcosmo -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetcosmo -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-11-19T12:46:17Z

Dguidi: /* Requirement 2 - Codi firmware v15 */

==Linux News==
'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. '''After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.'''</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetgemini -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetgemini -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Linux for Cosmo

2020-11-19T12:45:53Z

Dguidi: /* Requirement 2 - Codi firmware v15 */

==Linux News==
'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetgemini -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetgemini -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]

Main Page

2020-11-18T15:27:06Z

Dguidi: /* Cosmo Communicator Latest News */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features, including Cosmo Cover Display support. [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Main Page

2020-11-18T15:26:27Z

Dguidi: /* Welcome to Planet Computers Support Website */

==Welcome to Planet Computers Support Website==
This Website will provide you with the latest information and support for your Planet Computers devices.

'''Linux support for Cosmo Communicator has been released!'''

===Cosmo Communicator Latest News===
* 18/11/2020 - Cosmo Linux firmware v3 has been released with lots of new features! [[Linux for Cosmo|Read more about it here]]
* 24/07/2020 - The latest Linux version supporting Phone calls, SMS messages, 4G mobile data and power save is now available! [[Linux for Cosmo|Read more information here]].
* 6/07/2020 - Android firmware v23 has been released! This version includes bugfixes and introduces the power save setting for the Cover Display. You can [[Latest Cosmo Firmware|read more information about it here]].
* 22/06/2020 - Android firmware v22 has been released! This release contains a number of improvements and bugfixes. You can [[Latest Cosmo Firmware|read more information about it here]].
* 29/03/2020 - If you have been affected by the latest FOTA v20 firmware, <s>please look at this page for a hot fix solution</s> please update your device using the latest v22 firmware.
* 24/02/2020 - Initial release of Linux for Cosmo Communicator is out. You can find more information [http://support.planetcom.co.uk/index.php/Linux_for_Cosmo here].
* 11/12/2019 - The first firmware upgrade for the Cosmo Communicator is out today! Find out [[Cosmo Firmware upgrade|how to upgrade your Android firmware and your Cover Display firmware]]. You can find more information about the [[Latest Cosmo Firmware|firmware update here]].

===Gemini Latest News===
* Gemini Android 8 upgrade - We added some instructions to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* The official Gemini PDA User Guide<br />The Official Gemini PDA User Guide is now in print and available. Purchase now at Amazon. [https://www.amazon.com/dp/1789265207 Click here to order].<br />Also, the Gemini PDA User Guide is now available for digital download as a PDF. [http://support.planetcom.co.uk/download/GeminiPDAUserGuide.pdf Click here to download].

* Configuring your keyboard''' - '''If you have a non-uk keyboard you will have to configure the keyboard software in order to use your keyboard layout properly. Please follow the instruction on this page: [[Configuration|Configuration Page]]
* 25/05/2019 - Android 8.1 update for Gemini WIFI PDA has been released! Also, the partition tool has now been updated to support multi boot Android 8.1/Linux systems.
* 8/05/2019 - We added instruction to perform a manual upgrade to Android 8. [[Gemini Android 8 Upgrade|They are available here]].
* 6/05/2019 - Android 8.1 update for Gemini 4G is out! In case the update mechanism does not start, you can double check that the file ota.zip is present in the root folder of your Gemini using File Manager. You can then tap on Manual Update under the Firmware Update Settings in the Firmware Update application, which can be found under Settings.
* 20/02/2019 - The Kali Linux community updated their Kali Linux image for Gemini PDA. You can use the partition tool to download and flash the laster version - [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html].
* 12/02/2019 - We updated the Linux firmware to support Sailfish 3 Beta for Gemini Community Edition, Kali Linux and TWRP. The updated partition tool is available at [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. Many thanks to the Jolla/Sailfish Community, the Kali community (<span style="caret-color: #000000; color: #000000; font-family: Helvetica; font-size: 14px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; text-decoration: none; display: inline !important; float: none;">Re4son</span>) and the TWRP community (deadman96385). If needed, you can find the old partition tool [https://support.planetcom.co.uk/partitionToolOld.html here].
* 11/12/2018 - We updated the Linux firmware to support a change in the LCM module in the latest Gemini devices. The updated firmware is compatible with all Gemini devices, and it's available using the usual partition tool: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]
* 08/11/2018 - We released a further updated Android firmware only for x27 devices, to fix an issue regarding SIM2 selection at boot.
* 10/10/2018 - We have released an updated Android firmware! The update contains a number of fixes, new applications and the latest security updates. We provided an over-the-air update for Android-only Gemini. Users of multi-boot Geminis can now update the Android side by following our [[Android Manual Update]] page.
* 17/09/2018 - A new firmware for rooted Android has been released. This will fix the issue that has been reported about the updated Magisk Manager software not working correctly. You can download the new firmware using the usual partition tool link: [http://support.planetcom.co.uk/partitionTool.html support.planetcom.co.uk/partitionTool.html]. The old firmware is still available under the "Firmware List and MD5 checksums" link on the partition tool page, if needed.
* 16/07/2018 - We've released an updated Sailfish OS firmware that fixes the orientation of the optional camera. See the [[Sailfish OS Notes|Sailfish OS notes page]] for more details
* 22/06/2018 - Released updated FlashTool, FlashToolDrivers, Android Firmware, Linux Firmware (including updated Debian and Sailfish OS Community edition). We also released an updated PartitionTool which offers more flexibility, together with new Android and Linux flashing guides (see menu on the left). Follow this links for the [[Android Flashing Guide|new Android Flashing Guide]], [[Linux Flashing Guide|new Linux Flashing Guide]] and the [[Gemini Firmware|new Gemini Firmware page]]. For reference, here are the links related to the [[Flashing Guide OLD|old Flashing Guide]] and the [[Gemini Firmware OLD|old Firmware page]].
* 21/05/2018 - This is a reminder that community-driven discussion forum for Gemini is available at [https://www.oesf.org/forum/index.php?showforum=192 https://www.oesf.org/forum/index.php?showforum=192]
* 11/05/2018 - The Linux and Windows flash tools have been updated. The Gemini firmware has also been updated and we now released 3 firmware versions: Gemini Wifi-Only, Gemini 4G x25 and Gemini 4G x27.
* 25/04/2018 - A Linux version of the Flash Tool has been released, see our [[Flashing Guide]] for more information
* 23/04/2018 - A few important news have been shared via Indiegogo but not posted here. So here we go:
** Gemini has its own forum on XDA! Check it out: [https://forum.xda-developers.com/gemini-pda Gemini PDA forum on XDA]
** An [https://forum.xda-developers.com/gemini-pda/development/recovery-twrp-3-2-1-0-t3763855 unofficial TWRP port for Gemini PDA] has been developed by deadman96385!
** An [https://forum.xda-developers.com/gemini-pda/development/rom-lineageos-14-1-geminipda-t3770821 initial release of Lineage OS for Gemini PDA] has also been developed, again by deadman96385!
* 16/03/2018 - A rooted Android firmware is now available, see [http://support.planetcom.co.uk/index.php/Gemini_Firmware http://support.planetcom.co.uk/index.php/Gemini_Firmware]
* 16/03/2018 - Source code for the Linux kernel and the bootloader has been published on GitHub: [https://github.com/dguidipc https://github.com/dguidipc]
* 02/2018 - We have updated our [https://play.google.com/store/apps/details?id=com.gemini.keyboard Keyboard application] with a new configuration wizard that will help you setup the correct driver/layout. We planned an over the air firmware update but, as it is not ready yet, we strongly suggest you to update the application using the Google Play Store. In case the application does not automatically update, please update the app using the this link: [https://play.google.com/store/apps/details?id=com.gemini.keyboard https://play.google.com/store/apps/details?id=com.gemini.keyboard]

[[File:gemini_keyboard.jpg|128x128px]]

Linux for Cosmo

2020-11-18T15:16:27Z

Dguidi: /* Download and Install Linux firmware v3 */

==Linux News==
'''18/11/2020 - The latest Linux Debian firmware v3 is now available!'''

This release contains a Cover Display (CoDi) implementation for Linux which provides a number of new features, such as:

* Mouse Control - you can now use the CoDi display as a trackpad when the unit is open
* Phone Control - you can browse contact and place/accept calls from the Codi screen while the unit is closed
* Device Control - you can switch OFF/reboot Cosmo from the CoDi display
* Contacts can be updated by the gka-contacts-qt application or directly from the dialer app

<br /> A big thank you to the Cosmo Communicator open source community for supporting Linux on Cosmo Communicator!

[[File:Screenshot_20201118_110844.png|left|422x211px|border]]

[[File:Screenshot_20201118_111109.png|right|422x211px|border]]

To see some of the new features, please take a look at this Cosmo Communicator update video [https://youtu.be/aljMVuzT5-Y https://youtu.be/aljMVuzT5-Y]

Older Linux Debian v2 firmware

The Linux Debian v2 firmware has numerous bug fixes and supports the following new features:

* Phone Calls
* SMS support
* 4G Mobile data support using connman
* Open/Close power save support

==Cosmo Linux installation==
====Existing Linux installations====
If you plan to update your current Linux installation to the latest version, please make sure that you manually install CoDi firmware v15 ('''Requirement 2''' - see below) and [[Manual Update Linux v3|follow this link.]]

The rest of this guide details how to perform a fresh Linux installation.

====New Linux Installations====
Before starting the installation, please be sure that you are running the latest Android firmware, currently '''V23 (Requirement 1)'''.

====Requirement 1 - Latest Android firmware v23====
You can check the Android version by tapping Settings -> System -> Advanced -> About Phone and scrolling to the end of the page (see Build number detail, in the screenshot below).

[[File:24_43.jpg|center|800x400px|border]]

====Requirement 2 - Codi firmware v15====
To take full advantage of the latest features (such as CoDi trackpad control) you will need to manually install CoDi v15. Flashing this firmware is a relatively quick process, because it does not contain the (big) resource file. However, you should make sure you have the latest v14 CoDi firmware and resources before starting this update.

Once your CoDi is running v14, you can proceed to manually flash version v15. You will need to download the firmware from this location: [http://%20http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin http://support.planetcom.co.uk/download/Cosmo_firmware-stem_ospi2_mouse15.bin] (save it to the internal memory into the root directory) and install it manually using the Cover Display Assistant app on Android.

The flashing process does not need the second resource file but it assumes that the v14 firmware is installed.

[[File:IMAGE2020-11-18.jpg|center|800x400px]]

Select "Advanced" and then "Flash Image Manually" and then select the<span style="color: #000000;"> Cosmo_firmware-stem_ospi2_mouse15.bin. To update the CoDi firmware click on the "FLASH NOW" button. After flashing, please ignore any over-the-air Cover Display assistant notifications to update firmware as this is a custom build.</span>

====Download and Install Linux firmware v3 (latest)====
Next, you will have to download the Linux firmware file, which will need to be installed onto the microSD card on your Cosmo. Insert a microSD card on your Cosmo and make sure it is formatted as MS-DOS(FAT32).

The Linux firmware is part of an archive that also contains TWRP and rooted Android.

You can download the latest archive file at this URL:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v3.zip] (MD5: f6a765389913c790174d05dfdcb031d9)

Older versions:

* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v2.zip] (MD5: ba7f88924eb4254ac4c2aeb1c59ce6d6)
* [http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip http://support.planetcom.co.uk/download/cosmo-customos-installer-v1.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

Alternatively, you can also purchase a Linux Media Installation Card with the firmware already preloaded onto a micro SD card. This can be purchased from [https://store.planetcom.co.uk/collections/media-books https://store.planetcom.co.uk/collections/media-books/]

Once you downloaded the zip archive you will have to extract its content onto your microSD card:

# Using the Files app (do not use File Manager app) locate the ZIP archive
# Tap the archive file to reveal the cosmo-customos-installer folder
# Long tap on that folder, select Extract to... and finally select the root folder of the microSD card as destination.
# Complete the ZIP extraction process.
# Your microSD card should now contain a folder named cosmo-customos-installer with several files inside it.

Next, you will have to boot into recovery mode. To do that, simply turn ON your Cosmo while keeping pressed the volume up button on the outside cover. The volume up button is the one on the fingerprint sensor, which points UP when the unit is open. The unit should boot into recovery mode and you should be able to see the Android logo, but nothing else - as in the following screenshot.

[[File:39.jpg|center|640x480px|border]]

At this point, keep the ESC key pressed (top left key on the keyboard) and press the volume up button from the outside cover again, then release both keys. This following menu will be displayed.

[[File:41.jpg|center|640x480px|border]]

<span style="color: #ff0000;">The main requirement when installing Linux is to reserve space for it. In order to do this you will have to re-partition your device, which will lead to the loss of all your data.</span> Once you reserve some space for Linux you can update Android or Linux independently, without loosing your data again. To change the partition table of your Cosmo use the option "Change the partition table of your COSMO", as in the picture below.

[[File:Screenshot_2020-02-12_at_15.12.52.png|center|640x330px|border]]

You will have 5 options to choose from:

# Reserve all space for Android
# Reserve 90GB for Android and 30GB for Linux
# Reserve 60GB for Android and 60GB for Linux
# Reserve 30GB for Android and 90 GB for Linux
# Reserve all space for Linux

[[File:Screenshot_2020-02-12_at_15.15.52.png|center|640x412px|border]]

Note that in recent firmwares you will also have the option to keep all the storage for Android while allowing the installation of TWRP and rooted Android, which is useful if you want to have a rooted Android without using Linux.

If you select to install Linux, 4 additional partitions will be created:

# EMPTY_RECOVERY_BOOT_2 - This partition can be used to store an image that runs in recovery mode, such as TWRP
# EMPTY_NORMAL_BOOT_3 - This partition can be used to store Debian/KDE or Rooted Android
# EMPTY_NORMAL_BOOT_4 - This partition can be used to store Debian/KDE or Rooted Android
# In addition, an extra partition will be created with the custom size selected by the user, which will be used to store the root file system.

Once the storage for Linux has been reserved, you can install a custom OS on your Cosmo, by choosing the related option as in the picture below.

[[File:Screenshot_2020-02-12_at_15.18.42.png|center|640x428px|border]]

This option will scan the microSD card for compatible installers and will present you with a menu showing the available installers as in the picture below.

[[File:43.jpg|center|640x480px|border]]

Whenever new or updated custom operating systems will be available for the Cosmo, you will be able to download them into a micro SD card and install it in your device.

At the moment we have initial support for the following:

* TWRP (Team Win Recovery Project) '''Please use caution when using TWRP as it can brick your device.TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. Use it at your own risk.'''
* Debian using KDE/Plasma - beta
* Rooted Android

Once you select a custom OS you have to select where to install its boot firmware. Remember that you can install TWRP only on the EMPTY_RECOVERY_BOOT_2 partition, while you can install Debian/KDE and the Rooted android image in either EMPTY_NORMAL_BOOT_3 or EMPTY_NORMAL_BOOT_4 partitions.

Once you select the boot partition, the custom OS will be installed on your Cosmo Communicator. A boot menu will then appear when you turn ON the device, allowing you to choose what to start as in the following picture.

[[File:46.jpg|center|640x480px|border]]

Using this method you will be able to install a custom OS such as Linux on your device without the need for a laptop or a desktop computer. All you need to do is to download the installer in a micro SD card and use the recovery mode to start the installation.

You can watch a Cosmo Communicator How-To video detailing the Linux installation process from SD card at this address [https://youtu.be/7guqI4nA8CU https://youtu.be/7guqI4nA8CU]

==TWRP installation==
'''Please use caution when using TWRP as it can brick your device. '''

'''TWRP support is limited for Cosmo Communicator (you can't access the encrypted user data partition) and its usage is discouraged. '''

'''Use it at your own risk.'''

Follow the installation steps above and just remember that TWRP can only installed in the EMPTY_RECOVERY_BOOT_2 partition.

==Debian/KDE installation==
Simply follow the installation steps above. The Debian/KDE installer will automatically install the boot image into the selected partition and it will also install the rootfs image into the Linux partition.

====Keyboard Layout Configuration====
The default keyboard layout is American English, to configure a different layout, see the example command below.

The following command can be used to set the keyboard layout to English (GB):

<code>setxkbmap -model planetgemini -layout gb</code>

To restore the layout to English (US), use the following command:

<code>setxkbmap -model planetgemini -layout us</code>

====WIFI Configuration====
To setup the WIFI connection tap on the NetworkManager icon on the bottom right, select the WIFI network you want to connect to and tap Connect.

[[File:10.jpg|center|800x600px|border]]

After entering the password, the system will ask you how to store the password. If you want to store it without entering a password, then select the first option "Classic, blowfish encrypted file" and when asked to enter a password just leave it empty and tap OK. The system will then popup a warning that the password has a low strength, just tap on the Yes button.

[[File:21.jpg|center|800x600px|border]]

===Phone and Message apps===
The latest Linux update comes with a phone dialler and an SMS message app. They are available under the Phone application category

[[File:23_33.jpg|center|800x600px|border]]

Both applications are quite simple and work as expected. Both apps have a special button at the botton that can be swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

[[File:23_28.jpg|center|800x600px|border]]

===Enbling Mobile Data===
Please note that WIFI, Phone calls and SMS work straight away.

The default NetworkManager application also supports mobile data, but it does not work well with Cosmo.

To activate mobile data [[Mobile Data In Linux Cosmo|please follow this link]].

===Tips===
* There is a default user named 'cosmo'. The password for the 'cosmo' user is 'cosmo'
* To update your Linux installation, make sure you configure a WIFI connection and then:
*# Become root by typing 'sudo bash' followed by the 'cosmo' password
*# type 'apt update'
*# type 'apt upgrade'.
* On Linux, the ESC key sends the Escape command on Linux. To send the power command, use Fn+ESC.

==Rooted Android installation==
Install the Rooted Android image as per the installation above.<br />After booting the rooted Android partition, complete the installation by downloading and running Magisk Manager ([https://magiskmanager.com https://magiskmanager.com]). The Magisk Manager interface should then be similar to the following screenshot (notice the green OK icon, device IS rooted).

[[File:53.jpg|center|640x320px|border]]

If instead you run Magisk Manager from a normal Android boot (not rooted), it will look like in the following screenshot. The red icon shows that the device is NOT rooted.

[[File:50.jpg|center|640x320px|border]]