Install LuneOS for Maguro

From WebOS-Ports
Jump to: navigation, search

This guide will walk you through the process of taking the Galaxy Nexus (GSM) from stock to having ability to flash the latest version of LuneOS.

Note: DISCLAIMER

Rules that you must agree to before using these images

Before you use our testing feeds, please read and agree to the following rules:

Fire.png
  1. Anyone participating in WebOS Ports alpha or beta testing of any kind must be prepared to fully erase and reflash their device at a moment's notice without warning and without any regrets or complaints.


  1. They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. If you are not intimately familiar with linux GO NO FURTHER
  2. They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
  3. They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
  4. They must read any and all documentation and forums threads (in their entirety) before asking a question.
  5. They must fastidiously follow the IRC Channel where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
  6. They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL http://testing-{{{device_name}}}.webos-ports.org
  7. When asking for help, they will include the phrase (which may change occasionally) "I've read and understand the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill. These images do NOT constitute a ROM, They are individual pieces and NOT intended or expected to be included in any ROM


Important Notes

The Galaxy Nexus (GSM) (Maguro) is a touchscreen smartphone manufactured by Samsung with direct support from Google. It is the third Nexus device.

Unlocking the device (bootloader)

First, the bootloader must be unlocked.

  1. Download and install the Android SDK for your platform from here: Android SDK
  2. Open a Terminal and: cd to <sdk>/tools/
  3. Run: ./android to start the Android SDK Manager
  4. Use it to install the latest version of 'Android SDK Platform-tools'
  5. Close the Android SDK Manager
  6. In your Terminal window,: cd to <sdk>/platform-tools/
  7. Power off the Galaxy Nexus (GSM) and activate the bootloader (Volume Up, Volume Down & Power to boot into fastboot mode. While at the fastboot screen, use Volume Up or Volume Down to select Recovery mode, then press Power to confirm your selection.)
  8. Connect it via USB
  9. In your Terminal window, run: ./fastboot devices
  10. If your device shows up, proceed to the next step. Otherwise, follow the instructions in this thread
  11. In your Terminal window, run: ./fastboot oem unlock
  12. A warning will appear on your Galaxy Nexus (GSM), prompting you to unlock your bootloader.
  13. Use the Volume Up and Volume Down buttons to navigate and the Power button to confirm your selection.
  14. Reboot Device

Installing recovery using fastboot

You can use fastboot to install your recovery image to the device.

Installing ClockworkMod Recovery on the Galaxy Nexus (GSM)

  1. Your Galaxy Nexus (GSM) should still be connected to your PC via USB from the last step
  2. Power off the Galaxy Nexus (GSM) and activate the bootloader Volume Up, Volume Down & Power to boot into fastboot mode. While at the fastboot screen, use Volume Up or Volume Down to select Recovery mode, then press Power to confirm your selection.
  3. Once the device is in fastboot mode, verify your PC sees the device by typing fastboot devices
  4. *If you don't see your device serial number, and instead see "<waiting for device>", fastboot is not configured properly on your machine. See fastboot documentation for more info.
  5. On your PC, download the ClockworkMod Galaxy Nexus (GSM) recovery image (at time of writing, 6.0.5.1)
  1. Flash CWM to your Galaxy Nexus (GSM), making sure to use the proper filename for the image you downloaded:

 $ fastboot flash recovery recovery-clockworkmod-6.0.5.1-maguro.img
 sending 'recovery' (6526 KB)...
 OKAY [  0.802s]
 writing 'recovery'...
 OKAY [  1.245s]
 finished. total time: 2.048s
 $ fastboot reboot
 rebooting...
 
 finished. total time: 0.020s

  1. Reboot to bootloader, by powering off, then Volume Up, Volume Down & Power to boot into fastboot mode. While at the fastboot screen, use Volume Up or Volume Down to select Recovery mode, then press Power to confirm your selection.
  2. Use the Volume Up or Volume Down key to select "Recovery mode", and the Power button to enter recovery.
  3. At this point, ClockworkMod should load.

Installing/Updating LuneOS from recovery

Note:

Some devices do not have removable SD cards. Regardless, there should still be a partition on the device named "/sdcard" that can be used for flashing purposes, even though the contents of /sdcard may actually be in internal storage.

  1. Your Galaxy Nexus (GSM) should still be connected to your PC via USB from the last step
  2. Your Galaxy Nexus (GSM) should still be booted to ClockworkMod from the last step
  3. If neither statement is currently true, please reboot to ClockworkMod. If you do not have CWM loaded, follow the steps outlined above.
  4. Download the latest stable LuneOS Dev-image or latest nightly LuneOS Dev-image
  5. Use the Volume Up and Volume Down keys on your Galaxy Nexus (GSM) to select ""install zip" and next "install zip from sideload" and now you should have the following text on your device screen :
    ClockworkMod Recovery v6.0.4.3

    Sideload started ...
    Now send the package you want to apply
    to the device with "adb sideload <filename>" ...
  6. From your PC, execute the following command:
    adb devices
    and if you have the following output
    List of devices attached
     ???????????? no permissions
    then follow the commands to restart the adb server (here in the Troobleshooting part) or if you can not wait (with the root account) :
    # adb kill-server
    # adb start-server
    * daemon not running. starting it now on port 5037 *
    * daemon started successfully *
    check now if all works fine :
    # adb devices
    List of devices attached
    your_nexus_serial_number recovery
  7. From your PC, execute the following command:
    adb sideload luneos-dev-package-maguro.zip
  8. The image will now install. It will installs both the kernel and the rootfs and now you should have the following text on your device screen :
    Restarting adbd...
    Finding update package...
    Opening update package...
    Installing update...

    Welcome to the LuneOS RootFS Updater

    Mounting system and userdata partitions...
    Copying the LuneOS rootfs tarball...
    Deploying LuneOS...
    Flashing kernel ...

  9. Once completed, reboot the Galaxy Nexus (GSM) (In ClockworkMode, use the following entries in the menu: Go Back -> reboot system now -> Go back). (If ClockworkMode asks if you want to 'root device', answer no.)
  10. Your system should now boot directly into LuneOS

Helpful Tip

See something wrong on this page? Report it here.