Editing Sailfish
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 7: | Line 7: | ||
This guide has been compiled from numerous previous sources and credits are due to lots of individuals for their original work, methods and support to the community, including: | This guide has been compiled from numerous previous sources and credits are due to lots of individuals for their original work, methods and support to the community, including: | ||
- | [http://talk.maemo.org/member.php?u=20627 rzr], [http://talk.maemo.org/member.php?u=68697 souran], [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?showComment=1386385690772 Martin Brook], [http://talk.maemo.org/member.php?u=67021 vgrade | + | [http://talk.maemo.org/member.php?u=20627 rzr], [http://talk.maemo.org/member.php?u=68697 souran], [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?showComment=1386385690772 Martin Brook], [http://talk.maemo.org/member.php?u=67021 vgrade], [http://talk.maemo.org/member.php?u=34203 mikecomputing], [http://talk.maemo.org/member.php?u=38434 TMavica], [http://talk.maemo.org/member.php?u=66860 krnlyng/liar], [http://talk.maemo.org/member.php?u=69326 max83], [http://talk.maemo.org/member.php?u=58774 flotron], [http://talk.maemo.org/member.php?u=61958 juiceme], contributors to [http://piratepad.net/nVuyI2uxrY piratepad], Nemo contributors and anyone else trying to make Sailfish run on the Nokia N9/N950. |
Please help by contributing any information or methods you have to help make Nemo and Sailfish run better on the Nokia N9/N950. | Please help by contributing any information or methods you have to help make Nemo and Sailfish run better on the Nokia N9/N950. | ||
+ | |||
=Installation environment= | =Installation environment= | ||
Line 27: | Line 28: | ||
= Notes = | = Notes = | ||
- | If your handset is factory SIM-locked, it | + | |
+ | If your handset is factory SIM-locked, it may not be possible to install unsigned kernels, thus Sailfish. There is currently no known work-around and unlocking the handset after purchase does not seem to alleviate this issue. | ||
To completely turn off the handset manually, hold the power button for ~8 seconds. | To completely turn off the handset manually, hold the power button for ~8 seconds. | ||
Line 33: | Line 35: | ||
When extracting a tarball ending with .tar, use "tar -xvf --numeric-owner". If you get a message stating "invalid tar magic", it is probably .tar.bz2 therefore use "tar -xvjf --numeric-owner". | When extracting a tarball ending with .tar, use "tar -xvf --numeric-owner". If you get a message stating "invalid tar magic", it is probably .tar.bz2 therefore use "tar -xvjf --numeric-owner". | ||
- | Lack of the package jolla-xt9 means there is no text correction engine in Sailfish. This also manifests as no Pīnyīn to Hanzi conversion for input of the Chinese language | + | Lack of the package jolla-xt9 means there is no text correction engine in Sailfish. This also manifests as no Pīnyīn to Hanzi conversion for input of the Chinese language. |
If you have any installation questions or issues, please ask them in [http://talk.maemo.org/showthread.php?t=90761 this thread] on talk.maemo.org. Please refrain from asking Ubiboot related questions in this thread. Ubiboot related questions should be posted in this [http://talk.maemo.org/showthread.php?t=89345 thread]. | If you have any installation questions or issues, please ask them in [http://talk.maemo.org/showthread.php?t=90761 this thread] on talk.maemo.org. Please refrain from asking Ubiboot related questions in this thread. Ubiboot related questions should be posted in this [http://talk.maemo.org/showthread.php?t=89345 thread]. | ||
Line 42: | Line 44: | ||
==Firmwares== | ==Firmwares== | ||
- | Obtain Nokia N9 firmwares from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] | + | Obtain Nokia N9 firmwares from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] or <br> |
- | + | [http://mrcrab.net/nokia/Nokia_N9.html?productID=4823499691&productType=RM-696 mrcrab.net] | |
- | + | ||
- | + | ||
==Kernels== | ==Kernels== | ||
Line 51: | Line 51: | ||
Obtain the MOSLO kernel from: [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or | Obtain the MOSLO kernel from: [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or | ||
- | [http://www.multiupload.nl/WLLK09RF96 multiupload.nl] (zip | + | [http://www.multiupload.nl/WLLK09RF96 multiupload.nl] (zip file) |
==Ubiboot== | ==Ubiboot== | ||
Line 69: | Line 69: | ||
===SourenAraya's Sailfish images=== | ===SourenAraya's Sailfish images=== | ||
- | Available for download from: [http://n9.araya.su/images/mic_images/ araya.su]. | + | Available for download from: [http://n9.araya.su/images/mic_images/ araya.su] |
- | + | The newer images have Terminal pre-installed on Sailfish v1.0.1.10 | |
+ | |||
+ | ===max83's image=== | ||
+ | |||
+ | Available from [http://www.mediafire.com/download/zj4q8ai80xg41iu/sailfishos_n9_1_0_0_5.tar.bz2 mediafire.com] | ||
+ | This image has Terminal, Maps and a few third party applications pre-installed on Sailfish v1.0.0.5 | ||
===vgrade's Kickstarter=== | ===vgrade's Kickstarter=== | ||
Line 79: | Line 84: | ||
Please see [https://wiki.merproject.org/wiki/Platform_SDK Mer Project Platform SDK] and [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?m=1 Martin Brook's blog] for more information about creating your own image. | Please see [https://wiki.merproject.org/wiki/Platform_SDK Mer Project Platform SDK] and [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?m=1 Martin Brook's blog] for more information about creating your own image. | ||
+ | |||
=Additional Reading Material= | =Additional Reading Material= | ||
Line 99: | Line 105: | ||
==Step 2 - Re-flash your Nokia N9 to factory firmware== | ==Step 2 - Re-flash your Nokia N9 to factory firmware== | ||
*Note: Flashing can permanently damage or brick your Nokia N9. Do so at your own risk. | *Note: Flashing can permanently damage or brick your Nokia N9. Do so at your own risk. | ||
- | + | *Download the firmware you wish to use Harmattan with from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] or [http://mrcrab.net/nokia/Nokia_N9.html?productID=4823499691&productType=RM-696 mrcrab.net]. Your factory product code is printed on your SIM tray e.g. 059J245. You want the two files containing "DFL _61" e.g. A6D5F456_'''DFL61_HARMATTAN_40.2012.21-3_PR_LEGACY'''_005-OEM1-958_ARM.bin and 59BEC3BC_'''DFL61_HARMATTAN_40.2012.13-7'''.SEAP_'''EMMC'''_SEAP.bin. | |
- | *Download the firmware you wish to use Harmattan with from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] or [http://mrcrab.net/nokia/Nokia_N9.html?productID=4823499691&productType=RM-696 mrcrab.net]. | + | |
*Rename your firmware to "main.bin" and "emmc.bin" respectively and copy them to the directory where the flasher program is installed (e.g. '''"C:\Program Files\Nokia\Flasher"'''). Check the [[Flashing_N9|Maemo Community Wiki Nokia N9 Flashing Guide]] for further information. | *Rename your firmware to "main.bin" and "emmc.bin" respectively and copy them to the directory where the flasher program is installed (e.g. '''"C:\Program Files\Nokia\Flasher"'''). Check the [[Flashing_N9|Maemo Community Wiki Nokia N9 Flashing Guide]] for further information. | ||
*Ensure your handset is fully charged. Disconnect from all cables from it and turn off. | *Ensure your handset is fully charged. Disconnect from all cables from it and turn off. | ||
+ | *If you have not already, download the Flasher for your system and install it. You want v3.12.1 from [http://skeiron.org/tablets-dev/maemo-dev-env-downloads/ here] | ||
- | *Open up a Root Terminal (Or Terminal and gain root/use sudo) or an elevated cmd.exe (by running it as Administrator on Windows Vista onwards) and set the directory to where flasher is located | + | *Open up a Root Terminal (Or Terminal and gain root/use sudo) or an elevated cmd.exe (by running it as Administrator on Windows Vista onwards) and set the directory to where flasher is located: <br> |
- | + | '''cd /d "C:\Program Files\Nokia\Flasher"''' (for Windows) | |
*By connecting the USB cable to the computer and the turned off phone, you will initialise the Flashing Mode. | *By connecting the USB cable to the computer and the turned off phone, you will initialise the Flashing Mode. | ||
- | **This status can be checked with the command:<br> | + | **This status can be checked with the command:<br> |
+ | '''flasher -i''' | ||
- | *Flash your firmware with the command:<br> | + | *Flash your firmware with the command:<br> |
+ | '''flasher -F main.bin -F emmc.bin -f''' | ||
- | * | + | *If flashing fails with message '''Error claiming USB interface: Device or resource busy''', the problem is the cdc_phonet, phonet and cdc_acm modules. Add the lines '''blacklist cdc_phonet''', '''blacklist phonet''' and '''blacklist cdc_acm''' to /etc/modprobe.d/modprobe.conf to blacklist these modules. |
*If flashing fails e.g. due to a Partition Mismatch, Security Code On Status or No Reply from Ping, you can try the following. There is a risk of bricking your phone and no warranty is provided by anyone! | *If flashing fails e.g. due to a Partition Mismatch, Security Code On Status or No Reply from Ping, you can try the following. There is a risk of bricking your phone and no warranty is provided by anyone! | ||
**Completely turn off the handset. | **Completely turn off the handset. | ||
- | ** | + | **Start flasher with the following command:<br> |
+ | '''flasher -f -F main.bin --erase-user-data=secure -F emmc.bin --erase-mmc=secure'''<br> | ||
+ | This should flash the handset but takes a few hours to complete therefore is best left to run overnight. | ||
- | If you do not wish to wait, you can stop the zeroising task and pull out the USB cable from the handset. This is a risky manoeuvre and could | + | ***If you do not wish to wait, you can stop the zeroising task and pull out the USB cable from the handset. This is a risky manoeuvre and could permanatly The task can be stopped by:<br> |
+ | '''Pressing CTRL + Z''' in a Linux Terminal <br> | ||
+ | Opening Task Manager ('''CTRL+ALT+DEL''') and Ending the tasks '''cmd.exe''' and '''flasher.exe''' in Windows | ||
**Now completely turn off the phone. | **Now completely turn off the phone. | ||
**Turn it on and you will get a message asking you to "Install and Authorised Operating System" | **Turn it on and you will get a message asking you to "Install and Authorised Operating System" | ||
**Turn the phone back off. | **Turn the phone back off. | ||
- | **In flasher, run:<br> | + | **In flasher, run:<br> |
+ | '''flasher -F main.bin -F emmc.bin -f''' | ||
**The phone should proceed to flash normally. | **The phone should proceed to flash normally. | ||
==Step 3 - Flash the OpenMode!== | ==Step 3 - Flash the OpenMode!== | ||
- | + | *Download the OpenMode kernel from [http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix swagman.org] and place it in the same directory as flasher and your firmware files. | |
- | + | *Flash the OpenMode kernel and reboot your phone with: <br> | |
- | + | flasher -a main.bin -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R" | |
- | + | ||
- | + | ||
- | * | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
==Step 4 - Prepare Harmattan== | ==Step 4 - Prepare Harmattan== | ||
*Let Harmattan load up and run for a few minutes so you have date and time set correctly and the handset is fully functional. | *Let Harmattan load up and run for a few minutes so you have date and time set correctly and the handset is fully functional. | ||
- | *Install Developer Mode on Harmattan so Terminal is made available as it is useful later on and required if are not | + | *Install Developer Mode on Harmattan so Terminal is made available as it is useful later on and required if are do not Linux. |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
*(Optional) Install N9QT from [http://talk.maemo.org/showthread.php?t=80600 here] and choose Option "'''H'''", and select "'''Enable SSH for root'''". This will allow you to run commands on Harmattan from your PC and enables copying and pasting of commands and files to and from your PC easily. | *(Optional) Install N9QT from [http://talk.maemo.org/showthread.php?t=80600 here] and choose Option "'''H'''", and select "'''Enable SSH for root'''". This will allow you to run commands on Harmattan from your PC and enables copying and pasting of commands and files to and from your PC easily. | ||
- | |||
==Step 5 - Re-partition your handset== | ==Step 5 - Re-partition your handset== | ||
Line 175: | Line 151: | ||
*Download the MOSLO kernel from [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or [http://www.multiupload.nl/WLLK09RF96 multiupload.nl]. Windows users must download from multiupload.nl as it is a .zip file. Extract the files using "Archive Manager" or an unzipping utility and copy them to where flasher and your firmware files are. | *Download the MOSLO kernel from [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or [http://www.multiupload.nl/WLLK09RF96 multiupload.nl]. Windows users must download from multiupload.nl as it is a .zip file. Extract the files using "Archive Manager" or an unzipping utility and copy them to where flasher and your firmware files are. | ||
- | |||
*Flash the MOSLO kernel using:<br> | *Flash the MOSLO kernel using:<br> | ||
- | ** | + | **'''flasher -k zImage-moslo -n initrd-moslo -l -b''' |
- | ** | + | **Allow MOSLO to repartition your handset. |
+ | |||
+ | *If you are a Windows user, please now proceed to '''Step W - Install Sailfish (Windows only Users)'''. | ||
- | *If you are a Linux user, MOSLO will now connect the " | + | *If you are a Linux user, MOSLO will now connect the "Alt_OS" partition to your PC. Disconnect the phone and turn it off completely. <br> |
- | + | ||
- | + | '''You can now either proceed to installing Sailfish (Step 7) or continue installing Ubiboot for a newer and customisable boot-loader and the future ability to have Nitdroid and Firefox OS on your handset (see the [[Ubiboot|Maemo Community Ubiboot Wiki Page]] for further details.''' | |
==Step 6 - Install Ubiboot== | ==Step 6 - Install Ubiboot== | ||
- | ===If you use the | + | ===If you use the preconfigured ubiboot for SailfishOS=== |
- | *Download and extract the ''' | + | *Download and extract the '''preconfigured''' ubiboot from [http://www.swagman.org/juice/ubiboot/ubiboot_for_sailfish/ swagman.org] into the directory where flasher, main.bin and emmc.bin reside. |
- | *Unpack the archive:<br> | + | *Unpack the archive:<br>'''tar -xvf ubiboot-02_0.3.5_131213_SFOS.tar''' |
- | *Copy the extracted ''' | + | *Copy the extracted u'''biboot_035_sailfishos.tar''' to your device e.g into the "MyDocs" folder by connecting it in Mass Storage Mode. |
- | *Go to Terminal on your device, and obtain root access, then extract the archive:<br> | + | *Go to Terminal on your device, and obtain root access, then extract the archive:<br>'''devel-su'''<br>'''cd /home/user/MyDocs/'''<br>'''tar -xvf ubiboot_035_sailfishos.tar -C /'''<br> |
- | + | *Power off your device and flash it in the usual way:<br>'''sudo flasher -a firmware.bin -k zImage_2.6.32.54-ubiboot-02_301013 --flash-only=kernel -f -R''' | |
- | + | ||
- | + | ||
- | *Power off your device and flash it in the usual way:<br> | + | |
- | ===If you use the | + | ===If you use the unconfigured ubiboot=== |
*This method also allows Nitdroid and Firefox OS installation. | *This method also allows Nitdroid and Firefox OS installation. | ||
- | *Download and extract the '''latest''' | + | *Download and extract the '''latest''' ubiboot from [http://www.swagman.org/juice/ubiboot/ubiboot-02/ swagman.org] into the directory where flasher, main.bin and emmc.bin reside. |
- | *Install the ubiboot kernel with:<br> | + | *Install the ubiboot kernel with:<br>'''flasher -a main.bin -k zImage_2.6.32.54-ubiboot-02_301013 --flash-only=kernel -f -R''' |
- | + | *Leave the cable plugged in and allow Ubiboot to enter maintenance mode. | |
- | * | + | |
+ | 4 Removable Partitions will be visible in Computer. These are "'''rootfs'''" (Harmattan root filesystem), "Alt_'''OS'''" (where nemo/sailfish lives) "'''x767x676x7c6'''" (a random string of letters +/- numbers. This is where you can install Nitdroid and Firefox OS if you wish. It is also the "/home/" directory in Harmattan but NOT "/home/user/MyDocs"). "'''Nokia N9'''" is "/home/user/MyDocs" directory on Harmattan [EMMC/USB Mass Storage Mode]).<br><br> | ||
- | + | NB: If you format Alt_OS, it will get a random string of letters and numbers, like the "/home/" directory. It is the 4.2GB file system. | |
- | + | ||
- | + | ||
- | + | ||
*Go to "/media/Nokia N9" on your PC (Harmattan's Mass Storage). Make a directory called "'''boot'''". | *Go to "/media/Nokia N9" on your PC (Harmattan's Mass Storage). Make a directory called "'''boot'''". | ||
**Copy "'''ubiboot.conf'''" and "'''ubiboot-02.menus.cpio'''" from the extracted '''ubiboot-02_310513.tar''' into "/media/Nokia N9"/boot". | **Copy "'''ubiboot.conf'''" and "'''ubiboot-02.menus.cpio'''" from the extracted '''ubiboot-02_310513.tar''' into "/media/Nokia N9"/boot". | ||
- | **Go to "'''/media/rootfs'''" on your PC to access Harmattan's root file system. Go to the "'''boot'''" directory ("'''/media/rootfs/boot'''"). Copy "'''zImage_2.6.32.54-openmode_l2fix'''" (which was flashed earlier) into "'''/media/rootfs/boot'''". | + | **Go to "'''/media/rootfs'''" on your PC to access Harmattan's root file system. Go to the "'''boot'''" directory ("'''/media/rootfs/boot'''"). Copy "'''zImage_2.6.32.54-openmode_l2fix'''" (which was flashed earlier) into "'''/media/rootfs/boot'''"). |
*If you have boot issues, please consult for help in the [http://talk.maemo.org/showthread.php?t=89345 Ubiboot thread on talk.maemo.org] so the Sailfish thread remains for Sailfish issues! | *If you have boot issues, please consult for help in the [http://talk.maemo.org/showthread.php?t=89345 Ubiboot thread on talk.maemo.org] so the Sailfish thread remains for Sailfish issues! | ||
Line 221: | Line 192: | ||
*Now download the Sailfish image of choice, or compile your own using the Mer SDK. Rename it to '''sailfish.tar.bz2''' | *Now download the Sailfish image of choice, or compile your own using the Mer SDK. Rename it to '''sailfish.tar.bz2''' | ||
*Extract the Sailfish archive to "'''/media/Alt_OS'''" on your PC with:<br> | *Extract the Sailfish archive to "'''/media/Alt_OS'''" on your PC with:<br> | ||
- | + | '''tar --numeric-owner -xvjf sailfish.tar.bz2 -C /media/Alt_OS/''' | |
===Enable Root Access=== | ===Enable Root Access=== | ||
- | After the extraction has finished, this is a good time to enable root access in Sailfish and root login via SSH. This will allow you to remotely access your device after WLAN has been set up and avoid all the chrooting hassle! To | + | After the extraction has finished, this is a good time to enable root access in Sailfish and root login via SSH. This will allow you to remotely access your device after WLAN has been set up and avoid all the chrooting hassle! To get rest root's password ([http://talk.maemo.org/showpost.php?p=1395095&postcount=678 MAX9's method]), enter the following into your PC terminal:<br> |
- | + | '''nano /media/Alt_OS/etc/shadow''' # Open the shadow file where Alt_OS is mounted<br><br> | |
On the first line, you will have (where XXXXX are 5 numbers):<br> | On the first line, you will have (where XXXXX are 5 numbers):<br> | ||
- | + | '''root:34.random.letters.numbers.and.symbols:XXXXX:0:99999:7:::'''<br><br> | |
Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::'''<br> | Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::'''<br> | ||
For example, change:<br> | For example, change:<br> | ||
- | + | '''root:$1$00Z6Bfjc$vlIKUOMHIavIABL1gNuy6/:16049:0:99999:7:::''' <br> | |
into:<br> | into:<br> | ||
- | + | '''root::16049:0:99999:7:::''' | |
<br><br> | <br><br> | ||
- | Save and exit the file ( | + | Save and exit the file (CTRL+X, Y to save).<br><br> |
- | Now, when you boot into Sailfish, '''you will not have a password for root''' | + | Now, when you boot into Sailfish, '''you will not have a password for root'''.<br><br> |
To set a root password, open Terminal in Sailfish and enter:<br> | To set a root password, open Terminal in Sailfish and enter:<br> | ||
- | + | '''passwd root'''<br> | |
- | + | '''nemo''' # Enter your password for root<br> | |
- | + | '''nemo''' # Repeat your password for root <br> | |
- | + | ||
===Enable Root SSH Access=== | ===Enable Root SSH Access=== | ||
This is also a good time to enable root SSH access. In your PC's root terminal, enter the following:<br> | This is also a good time to enable root SSH access. In your PC's root terminal, enter the following:<br> | ||
- | + | '''nano /media/Alt_OS/etc/ssh/sshd_config'''<br><br> | |
Now, go to an empty line in the file and type in the following:<br> | Now, go to an empty line in the file and type in the following:<br> | ||
- | + | '''PermitRootLogin yes'''<br><br> | |
- | Again, save and exit the file ( | + | Again, save and exit the file (CTRL+X, Y to save). |
==Step W - Install Sailfish (Windows only Users)== | ==Step W - Install Sailfish (Windows only Users)== | ||
Line 265: | Line 235: | ||
*Disconnect the phone from the PC and remove the USB cable. | *Disconnect the phone from the PC and remove the USB cable. | ||
*Launch Terminal on Harmattan (or SSH in) any type the following commands:<br> | *Launch Terminal on Harmattan (or SSH in) any type the following commands:<br> | ||
- | + | **'''devel-su'''<br> | |
- | + | **'''rootme''' # Or your root password<br> | |
- | + | **'''cd /home/user/MyDocs/'''<br> | |
- | + | **'''ls''' # Here, you should see all your MyDocs and sailfish.tar.bz2<br><br> | |
- | + | **'''mkdir /sailfish''' # Mount Alt_OS in Harmattan<br> | |
- | + | **'''mount /dev/mmcblk0p4 /sailfish'''<br><br> | |
- | + | **'''tar --numeric-owner -xvjf sailfish.tar.bz2 -C /sailfish/''' # This will take a while as it extracts Sailfish onto the handset <br> | |
- | + | **'''sync'''<br><br> | |
- | You can now exit Terminal and reboot into Sailfish or '''Enable root SSH access on Sailfish'''.<br><br> | + | You can now exit Terminal and reboot into Sailfish or '''Enable root SSH access on Sailfish''', starting at "mount -o bind /proc /sailfish/proc".<br><br> |
- | '''To upgrade to a new image, simply delete everything in /media/Alt_OS (when on a Linux PC | + | '''To upgrade to a new image, simply delete everything in /media/Alt_OS ("'''rm -frv /media/Alt_OS/'''*") when on a Linux PC or "'''rm -frv /sailfish/'''*" when you have mounted Alt_OS in Harmattan. You will loose ALL your Sailfish data!''' |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | You will loose ALL your Sailfish data! | + | |
- | + | ||
==Step 8 - Boot into Sailfish== | ==Step 8 - Boot into Sailfish== | ||
Line 293: | Line 256: | ||
If you do not select an OS, Harmattan will boot by default. | If you do not select an OS, Harmattan will boot by default. | ||
- | To boot into Sailfish, tap | + | To boot into Sailfish, tap the Nemo icon (3rd one down on the left, looks like a blue padlock) and tap either "latest 2.6.32" or "vmlinuz-2.6.63.20120129.1-n950". For Harmattan, it is "openmode+l2 fix". |
On your first boot, select your input and display languages. Next, select a theme colour. After going forward, you may have to go back and select your theme colour again and go forward again before the page that allows you to set the date and time appears. | On your first boot, select your input and display languages. Next, select a theme colour. After going forward, you may have to go back and select your theme colour again and go forward again before the page that allows you to set the date and time appears. | ||
Line 306: | Line 269: | ||
=Bugs and Known Issues= | =Bugs and Known Issues= | ||
- | + | *No text correction engine therefore also no Pīnyīn to Hanzi conversion. | |
*No Android capability as of present. | *No Android capability as of present. | ||
*Camera does not work. | *Camera does not work. | ||
- | |||
*Accelerometer does not work. | *Accelerometer does not work. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
=Additional Guidance= | =Additional Guidance= | ||
Line 323: | Line 280: | ||
The date/time may not set correctly in Sailfish. To fix this, boot into Harmattan and fire up terminal: | The date/time may not set correctly in Sailfish. To fix this, boot into Harmattan and fire up terminal: | ||
- | + | '''devel-su<br> | |
- | + | '''rootme''' # Or you root password<br> | |
- | + | '''date --set "2013-12-07 22:59"''' | |
===Enable Root Access (Windows Users)=== | ===Enable Root Access (Windows Users)=== | ||
Line 331: | Line 288: | ||
If you are using Windows or did not enable root access earlier, the following instruction will show you how. The procedure is the same as that which was explained previously in Step 7 but takes place in Harmattan as opposed to on a Linux computer. | If you are using Windows or did not enable root access earlier, the following instruction will show you how. The procedure is the same as that which was explained previously in Step 7 but takes place in Harmattan as opposed to on a Linux computer. | ||
- | Load Harmattan and open Terminal. Type the following: | + | Load Harmattan and open Terminal. Type the following:<br> |
- | + | '''devel-su<br> | |
- | + | '''cd /<br> | |
- | + | '''mkdir sailfish<br> | |
- | + | '''mount /dev/mmcblk0p4 /sailfish<br> | |
- | + | '''nano /sailfish/etc/shadow''' # Open the shadow file where Sailfish is mounted<br><br> | |
- | On the first line, you will have (where XXXXX are 5 numbers): | + | On the first line, you will have (where XXXXX are 5 numbers):<br> |
- | + | '''root:34.random.letters.numbers.and.symbols:XXXXX:0:99999:7:::'''<br><br> | |
Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::'''<br> | Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::'''<br> | ||
- | For example, change: | + | For example, change:<br> |
- | + | '''root:$1$00Z6Bfjc$vlIKUOMHIavIABL1gNuy6/:16049:0:99999:7:::''' <br> | |
- | into: | + | into:<br> |
- | + | '''root::16049:0:99999:7:::''' | |
<br><br> | <br><br> | ||
- | Save and exit the file ( | + | Save and exit the file (CTRL+X, Y to save).<br><br> |
- | Now, when you boot into | + | Now, when you boot into Sailfish, '''you will not have a password for root'''.<br><br> |
- | To set a root password, open | + | To set a root password, open Terminal in Sailfish and enter:<br> |
- | + | '''passwd root'''<br> | |
- | + | '''nemo''' # Enter your password for root<br> | |
- | + | '''nemo''' # Repeat your password for root <br> | |
- | + | ||
===Enable Root SSH Access=== | ===Enable Root SSH Access=== | ||
- | + | This is also a good time to enable root SSH access. In Harmattan's terminal, enter the following:<br> | |
- | + | '''nano /sailfish/etc/ssh/sshd_config'''<br><br> | |
- | + | Now, go to an empty line in the file and type in the following:<br> | |
- | + | '''PermitRootLogin yes'''<br><br> | |
- | + | Again, save and exit the file (CTRL+X, Y to save). | |
- | + | ||
- | |||
- | == | + | ==Chroot into Sailfish from Harmattan== |
This is based on krnlyng's (liar) method. It is useful for access to Sailfish to run terminal commands such as updating the OS. | This is based on krnlyng's (liar) method. It is useful for access to Sailfish to run terminal commands such as updating the OS. | ||
- | Open terminal in Harmattan and type: | + | Open terminal in Harmattan and type:<br><br> |
- | + | '''devel-su<br> | |
- | + | '''cd /<br> | |
- | + | '''mkdir sailfish<br> | |
- | + | '''mount /dev/mmcblk0p4 /sailfish<br> | |
- | + | '''mount -o bind /proc /sailfish/proc<br> | |
- | + | '''mount -o bind /sys /sailfish/sys<br> | |
- | + | '''mount -o bind /dev /sailfish/dev<br> | |
- | + | '''/usr/sbin/chroot /sailfish<br><br> | |
- | When you have finished in Sailfish, exit and | + | When you have finished in Sailfish, exit and unmount with the following commands: <br><br> |
- | + | '''exit'''<br><br> | |
- | + | ||
- | + | '''umount /sailfish/dev<br> | |
- | + | '''umount /sailfish/proc<br> | |
- | + | '''umount /sailfish/sys<br> | |
- | + | '''umount /sailfish'''<br> | |
- | + | '''exit''' # Exit out of devl-su<br> | |
+ | '''exit''' # Exit out of Terminal | ||
==Developer Mode frame rate issue== | ==Developer Mode frame rate issue== | ||
- | When in developer mode, do not enable "Display Framerate". It causes random colour drawings on the screen, making it impossible to disable | + | When in developer mode, do not enable "Display Framerate". It causes random colour drawings on the screen, making it impossible to disable. To fix (credits to [http://talk.maemo.org/member.php?u=66860 liar]), open SSH into your handset and type:<br> |
- | + | '''nano /home/nemo/.gconf/desktop/jolla/%gconf.xml'''<br> | |
- | To fix | + | <br> |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
Ensure that that there is nothing between the '''stringvalue''' option, as below: <br> | Ensure that that there is nothing between the '''stringvalue''' option, as below: <br> | ||
- | + | '''<stringvalue></stringvalue>'''<br><br> | |
- | Save and exit ( | + | Save and exit (CTRL + X, Y to save). Reboot the handset and it should display everything correctly again. |
==Proximity sensor Fix== | ==Proximity sensor Fix== | ||
- | To fix the proximity sensor (this must be done at every boot), in Sailfish terminal type: | + | To fix the proximity sensor (this must be done at every boot), in Sailfish terminal type:<br><br> |
- | + | '''su<br> | |
- | + | '''nemo # Your root password<br> | |
- | + | '''echo 1 > /sys/devices/platform/i2c_omap.2/i2c-2/2-0039/prox_enable<br> | |
==Repository Replacement== | ==Repository Replacement== | ||
Line 436: | Line 371: | ||
You cannot use the repositories provided by default in the Sailfish images. You must remove them and replace them with custom ones. | You cannot use the repositories provided by default in the Sailfish images. You must remove them and replace them with custom ones. | ||
- | This is done by editing | + | This is done by editing the /etc/ssu.ini file, without using "zypper ar". |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | [http://talk.maemo.org/showpost.php?p=1395790&postcount=772 This post] by csdozi has a working ssu.ini file attached. | |
- | + | This repository section is very important. | |
- | + | ||
- | + | ||
- | + | '''[repository-urls]'''<br> | |
+ | aliendalvik=https://store-repository.jolla.com/releases/latest/aliendalvik/SbJ<br> | ||
+ | limited-nemo-mw=http://repo.merproject.org/obs/home:/vgrade:/branches:/nemo:/devel:/mw/latest_armv7hl/<br> | ||
+ | nemoadaptation0=http://repo.merproject.org/obs/nemo:/devel:/hw:/ti:/omap3:/n9xx-common/latest_armv7hl/<br> | ||
+ | nemoadaptation1=http://repo.merproject.org/obs/nemo:/devel:/hw:/ti:/omap3:/n950-n9/latest_armv7hl/<br> | ||
+ | store=https://store-repository.jolla.com/SbJ/armv7hl/<br> | ||
- | [ | + | Also, under '''[General]''' this line is important:<br> |
- | + | disabled-repos=adaptation1, thirdparty, adaptation0 |
Learn more about Contributing to the wiki.