Changes

Many thanks for the Cosmo Communicator open source community that provided an initial version of '''11/12/2020 - Linux for Cosmo Communicator!update<br />'''

==Today we released a new update for Linux installation==The first step to install Linux on your Cosmo is to make sure you are running the latest Android firmware, currently v19. You users! It can check the Android version be installed by tapping Settings -> System -> Advanced -> About Phone and scrolling to typing the end of the page as following commands in the following screenshot.a terminal:

You can download The update includes a brand new feature which allow users to set the latest archive at this address: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)

* [http://supportThe update also contains keyboard improvements and CoDi bug fixes.planetcom.co.uk/download/cosmo-customos-installer.zip http://support.planetcom.co.uk/download/cosmo-customos-installer.zip] (MD5: 554e8ec1f1c57b0fc3a6140b1ecad3ea)

 '''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 the 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/]

# Open Using the Files by Google and 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.

<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.

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. If you select to reserve some space for install Linux, 4 additional partitions will be created:

* 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.'''

Follow the installation steps above and just remember that '''Please use caution when using TWRP as it can brick your device. ''' '''TWRP support is limited for Cosmo Communicator (you can only installed in 't access the EMPTY_RECOVERY_BOOT_2 encrypted user data partition) and its usage is discouraged.'''

===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[[File:*# Become root by typing 'sudo bash' followed by the 'cosmo' password*# type 'apt-get update'*# type 'apt-get upgrade'21.* ESC key now sends escape command on Linux. To send the power command, use Fn+ESC.* The default keyboard layout is English. To configure a different keyboard layout, click on the menu icon and select System Settings. Inside System Settings select "Input Devices" and set the Keyboard Model under Hardware to "Planet jpg|center|800x600px| Planet Computers Cosmo Communicator" as in the screenshot below. Tap the Apply button.border]]

[[File:55===Phone and Message apps===The latest Linux update comes with a phone dialler and an SMS message app.jpg|center|640x480px|border]]They are available under the Phone application category

Under layout you Both applications are quite simple and work as expected. Both apps have a special button at the botton that can now select your own Cosmo keyboard layoutbe swiped up to reveal more information. For example the Phone Dialler app will show recent and missed calls as in the picture below.

* WIFI - To setup the WIFI connection tap on the WIFI icon on the bottom rightThe default NetworkManager application also supports mobile data, select the WIFI network you want to connect to and tap Connectbut it does not work well with Cosmo.

To activate mobile data [[File:26.jpg|center|640x480pxMobile Data In Linux Cosmo|borderplease follow this link]].

===Known bugsTips===* Opening/Closing There is a default user named 'cosmo'. The password for the unit does not suspend/resume '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 unit at this time'cosmo' password*# type 'apt update'*# type 'apt upgrade'. You will have to manually shutdown * On Linux, the ESC key sends the unit via software when you want to terminate your Escape command on Linux session. To send the power command, use Fn+ESC.