Changes between Version 21 and Version 22 of SettingUpDevelopmentEnvironmentForN9

Timestamp:

Feb 16, 2012, 2:50:39 AM (14 years ago)

Author:

vestbo@webkit.org

Comment:

--

SettingUpDevelopmentEnvironmentForN9

@@ -128 +128 @@
 }}}
 
-= 2. Configuring N9 =
+= 2. Configuring your device (N9/N950) =
+
+''Note:'' It's highly encouraged that you enable open mode on your device. This disables the security system on the device (AEGIS), which lets you mount (SSHF/NFS), making development a lot easier.
+
+== 2.1 Enabling open mode ==
+
+The retail N9 has a very stricky security system, called AEGIS. You can read about this at: [http://harmattan-dev.nokia.com/docs/library/html/guide/html/Developer_Library_Developing_for_Harmattan_Harmattan_security_Security_guide.html Harmattan Security Guide]
+
+The only known way to disable AEGIS restrictions is flashing an alternate kernel onto N9.
+
+Notice: This could void the warranty! After flashing the device will show a warranty void message while booting.
+
+This section based on
+  - http://maemo.cloud-7.de/HARM/N9/openmode_kernel_PR1.1/
+  - http://talk.maemo.org/showthread.php?t=81579
+  - http://forum.meego.com/showthread.php?t=4575&page=22
+
+Prerequisite 
+  * Pached kernel: [http://maemo.cloud-7.de/HARM/N9/openmode_kernel_PR1.1/zImage-2.6.32.39-dfl61-20113701 zImage-2.6.32.39-dfl61-20113701]
+  * Original firmware 20.2011.40-4 (you can download it with [http://www.symbian-toys.com/navifirm.aspx NaviFirm+], or using [https://gist.github.com/1636192 this script] on non-Windows machines.)
+  * Nokia flasher: [http://tablets-dev.nokia.com/maemo-dev-env-downloads.php flasher_3.12.1_amd64.deb]
+
+It is recommended to flash back the device to factory state. If you have any importand data on the device, back it up first or you will lose it!
+
+Install Nokia flasher utility and download the firmware and pached kernel file to a directory. 
+
+Turn off the device and disconnect it from usb. Flash the original firmware to the device:
+{{{
+  sudo flasher -F DFL61_HARMATTAN_20.2011.40-4_PR_LEGACY_001-OEM1-958_ARM.bin -F DFL61_HARMATTAN_20.2011.40-4.CENTRALEUROPE_EMMC_CENTRALEUROPE.bin -f
+}}}
+
+Do NOT disconnect usb cable. Do NOT restart the phone. Now, flash the pached kernel onto it:
+{{{
+  sudo flasher -f -a DFL61_HARMATTAN_20.2011.40-4_PR_LEGACY_001-OEM1-958_ARM.bin -k zImage-2.6.32.39-dfl61-20113701
+}}}
+
+Now, your N9 is ready. Disconnect it from usb. It will start booting.
+
 
 == 2.1. Turn on developer mode ==
 
-Notice: If you want to use NFS with retail N9, please read section [#a3.1.b.1Flashingpachedkerneltogetopenmode 3.1.b.1] first.
-
 There is a tutorial for this at http://paazio.nanbudo.fi/tutorials/qt-quick/developer-mode-in-nokia-n9
 
@@ -142 +177 @@
 Set up wifi internet connection. Connect usb cable. 
 
-
-== 2.2. Enable root access over ssh ==
-
-Login as 'developer' (run@host):
+== 2.2. Set up device ==
+
+{{{
+  $ browser-scripts/setup-device.sh
+}}}
+
+This will set up password-less login, install missing packages, and set up SSHFS if you're running in open-mode.
+
+From this point on you should be able to refer to the device as 'device', and the default user should be 'developer'.
+
+== 2.3. Enable root login (optional) ==
+
+Login as 'developer':
 {{{
   $ ssh developer@192.168.2.15
@@ -184 +228 @@
 Maybe you should change default root password, too.
 
-
-== 2.3. Install missing packages ==
-
-Resworb scripts has a solution for this.
-
-This script uses name 'device' for N9. You can add this to your /etc/hosts file (run@host):
-{{{
-  $ sudo su
-  $ echo -e '192.168.2.15\tdevice' >> /etc/hosts
-  $ exit
-}}}
-
-Scrachbox should be configured to armel target befor running this script (run@host):
-
-Run
-{{{
-  $ cd ~/swork
-  $ browser-scripts/device-install-packages-n9.sh
-}}}
-It will ask for root password of the device.
-
-= 3. How you get things running on the N9 =
-
-== 3.1.a Transfer files to N9 with rsync ==
+= 3.Running things on device =
+
+The best option is to mount your host on the device using either NFS or SSHFS (the latter is preferred). The alternative is to rsync files over.
+
+== 3.1a Mounting SSHFS
+
+If you ran the `setup-device.sh` script with an open mode kernel, you should now have your host available at `/mnt/host`, as well as your home directory available.
+
+== 3.1b Transfer files with rsync ==
 
 With rsync you can deploy the files to the device. 
@@ -252 +281 @@
 
 If you don't want to transfer LayoutTests to N9, then you should use '''./all-rsync.sh --no-layout-tests'''. Without this argument rsync always does re-transfer on LayoutTests because of the vfat filesystem's limitation.
-
-
-== 3.1.b Mounting NFS on retail N9 ==
-
-The retail N9 has a very stricky security system, called AEGIS. You can read about this at: [http://harmattan-dev.nokia.com/docs/library/html/guide/html/Developer_Library_Developing_for_Harmattan_Harmattan_security_Security_guide.html Harmattan Security Guide]
-
-The only known way to disable AEGIS restrictions is flashing an alternate kernel onto N9.
-
-Notice: This could void the warranty! After flashing the device will show a warranty void message while booting.
-
-=== 3.1.b.1 Flashing pached kernel to get open mode ===
-
-This section based on
-  - http://maemo.cloud-7.de/HARM/N9/openmode_kernel_PR1.1/
-  - http://talk.maemo.org/showthread.php?t=81579
-  - http://forum.meego.com/showthread.php?t=4575&page=22
-
-Prerequisite 
-  * Pached kernel: [http://maemo.cloud-7.de/HARM/N9/openmode_kernel_PR1.1/zImage-2.6.32.39-dfl61-20113701 zImage-2.6.32.39-dfl61-20113701]
-  * Original firmware 20.2011.40-4 (you can download it with [http://www.symbian-toys.com/navifirm.aspx NaviFirm+], or using [https://gist.github.com/1636192 this script] on non-Windows machines.)
-  * Nokia flasher: [http://tablets-dev.nokia.com/maemo-dev-env-downloads.php flasher_3.12.1_amd64.deb]
-
-It is recommended to flash back the device to factory state. If you have any importand data on the device, back it up first or you will lose it!
-
-Install Nokia flasher utility and download the firmware and pached kernel file to a directory. 
-
-Turn off the device and disconnect it from usb. Flash the original firmware to the device:
-{{{
-  sudo flasher -F DFL61_HARMATTAN_20.2011.40-4_PR_LEGACY_001-OEM1-958_ARM.bin -F DFL61_HARMATTAN_20.2011.40-4.CENTRALEUROPE_EMMC_CENTRALEUROPE.bin -f
-}}}
-
-Do NOT disconnect usb cable. Do NOT restart the phone. Now, flash the pached kernel onto it:
-{{{
-  sudo flasher -f -a DFL61_HARMATTAN_20.2011.40-4_PR_LEGACY_001-OEM1-958_ARM.bin -k zImage-2.6.32.39-dfl61-20113701
-}}}
-
-Now, your N9 is ready. Disconnect it from usb. It will start booting.
-
-=== 3.1.b.2. Developer mode and required libraries ===
-
-Enable developer mode: Settings / Security / Developer mode. After installation the device will do a reboot. 
-
-Change usb connection mode: Settings / Accessories / USB to "SDK" or "Always ask".
-
-Set up wifi internet connection. Connect usb cable.
-
-On N9 menu, select SDK Connectivity / USB. It will show your password for user developer. Leave it open.
-
-Install required libs for NFS mount and add static password for 'user' user (run@host):
-{{{
-ssh developer@192.168.2.15
-
-echo 'rootme' | devel-su
-cd /root
-apt-get install wget
-wget http://maemo.cloud-7.de/HARM/N9/openmode_kernel_PR1.1/opensh/opensh.deb
-wget http://repo.pub.meego.com/home:/rzr:/harmattan/MeeGo_1.2_Harmattan_Maemo.org_MeeGo_1.2_Harmattan_standard/armel/libwrap0_7.6.dbs-maemo6.1_armel.deb
-wget http://repo.pub.meego.com/home:/rzr:/debian/harmattan/armel/portmap_6.0.0-2_armel.deb
-
-dpkg -i opensh.deb
-dpkg -i libwrap0_7.6.dbs-maemo6.1_armel.deb
-dpkg -i portmap_6.0.0-2_armel.deb
-
-passwd user
-
-exit
-exit
-}}}
-
-Create public key for ssh connection, if you don't have it already (run@host):
-{{{
-ssh-keygen -t rsa
-}}}
-
-Copy public key to N9 (run@host):
-{{{
-ssh user@device "mkdir .ssh"
-scp ~/.ssh/id_rsa.pub user@device:./.ssh/authorized_keys
-}}}
-Now, you don't have to enter password for 'user' when you connect to N9.
-
-
-=== 3.1.b.3. Setup NFS on host computer (Ubuntu): ===
-
-Install the required packages and share swork (run@host):
-{{{
-sudo apt-get install nfs-kernel-server portmap
-sudo echo "/home/$USER/swork 192.168.2.15(rw,sync,no_root_squash)" >> /etc/exports 
-sudo /etc/init.d/nfs-kernel-server restart
-}}}
-
-=== 3.1.b.4. Setup NFS on N9 ===
-
-Create script for mounting NFS (run@host):
-{{{
-ssh user@192.168.2.15 "mkdir /home/user/swork; \
-echo 'opensh -c \"/sbin/portmap; /sbin/modprobe nfs; mount -t nfs 192.168.2.14:/home/$USER/swork /home/user/swork\"' > nfsmount.sh; \
-chmod +x nfsmount.sh "
-}}}
-
-Connect to N9 (run@host)
-{{{
-ssh user@192.168.2.15
-}}}
-
-Mount NFS if you didn't do it (run@n9).
-{{{
-opensh
-. nfsmount.sh
-}}}
-
 
 == 3.2. Running MiniBrowser ==