Changes between Version 2 and Version 3 of SettingUpDevelopmentEnvironmentForN9

Timestamp:

Jan 27, 2012 5:40:32 AM (12 years ago)

Author:

zarvai@inf.u-szeged.hu

Comment:

--

SettingUpDevelopmentEnvironmentForN9

@@ +1 @@
+[[PageOutline]]
+= Setting up development environment for Nokia N9 = 
+
 under construction
 
-= Setting up development environment for Nokia N9 =
-
 Build Qt5 and WebKit2 for N9 on Ubuntu 11.10 x64. Running MiniBrowser on the device.
 
-== I. Scratchbox Instructions ==
+= 1. Scratchbox Instructions =
 
 This section based on 
@@ -13 +14 @@
 Follow the instructions exactly!
 
-=== 1. Install and configure Scratchbox for Harmattan: ===
+== 1.1. Install and configure Scratchbox for Harmattan ==
 (run@host)
 {{{
@@ -53 +54 @@
 
 
-=== 2. Prepare your environment ===
+== 1.2. Prepare your environment ==
 (run@host)
 {{{
@@ -127 +128 @@
 }}}
 
-=== 3. Create ICECC toolchain (optional) ===
+== 1.3. Create ICECC toolchain (optional) ==
 
 If you have multiple workstations configured to use [http://en.opensuse.org/Icecream ICECC], you can speed up building process significantly. 
@@ -156 +157 @@
 Make the script runnable and execute it before building inside scratchbox when you need speedup.
 
-=== 4. Build QtWebKit ===
+== 1.4. Build QtWebKit ==
 
 Login to scratchbox and optionally execute script for icecc (run@host):
@@ -227 +228 @@
 }}}
 
-== II.  ==
+== 1.5. Updating build environment ==
+If you need to update browser-scripts, run on host:
+{{{
+  $ cd ~/swork/browser-scripts
+  $ git reset --hard HEAD
+  $ git pull
+  $ patch -p1 < ../browser-script.patch
+}}}
+
+If you neet to update Qt5 and WebKit, run on host:
+{{{
+  $ cd ~/swork/qt5 
+  $ git submodule foreach --recursive git clean -fdx
+  $ git clean -fdx
+  $ git reset --hard HEAD
+  $ cd ~/swork/webkit
+  $ git clean -fdx
+  $ git reset --hard HEAD
+  $ cd ~/swork
+  $ browser-scripts/update-sources.sh
+}}}
+Than rebuild binaries inside scratchbox:
+{{{
+  [sbox-HARMATTAN_ARMEL: ~] > cd ~/swork
+  [sbox-HARMATTAN_ARMEL: ~] > browser-scripts/build-sources.sh
+}}}
+
+
+
+= 2. Configuring N9 =
+
+== 2.1. Turn on developer mode ==
+
+== 2.2. Enable root access over ssh ==
+
+== 2.3. Install missing packages ==
+
+
+= 3. How you get things running on the N9 =
+
+== 3.1.a Moving files to N9 with rsync ==
+
+== 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.
+
+=== 3.1.b.1 Flashing pached kernel to get open mode ===
+
+Prerequisite (all of this can be found in /common/projects/WebKit/N9-!FirmWare)
+  * 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 
+  * 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).
+{{{
+. nfsmount.sh
+}}}
+
+
+== 3.2. Running MiniBrowser ==
+
+=== 3.2.1. Environment variables ===
+Now create script for setting environment variables (run@host):
+
+{{{
+ssh user@192.168.2.15 "echo 'export QTDIR=/home/user/swork/qt5/qtbase' > nfsenv.sh; \
+echo 'export QT_IMPORT_PATH=/home/user/swork/qt5/qtbase/imports' >> nfsenv.sh; \
+echo 'export QML_IMPORT_PATH=/home/user/swork/qt5/qtbase/imports' >> nfsenv.sh; \
+echo 'export LD_LIBRARY_PATH=/home/user/swork/qt5/qtbase/lib:/home/user/swork/qtwebkit-webkit2-dev-builddir-armel-m6/Release/lib' >> nfsenv.sh; \
+echo 'export QT_PLUGIN_PATH=/home/user/swork/qt5/qtbase/plugins' >> nfsenv.sh; \
+echo 'export QT_QPA_PLATFORM_PLUGIN_PATH=/home/user/swork/qt5/qtbase/plugins/platforms' >> nfsenv.sh; \
+echo 'export QT_QPA_PLATFORM=xcb' >> nfsenv.sh; \
+echo 'export WEBKIT_TESTFONTS=/home/user/swork/testfonts' >> nfsenv.sh; \
+echo '# export TZ=/usr/share/zoneinfo/America/Los_Angeles' >> nfsenv.sh; \
+echo 'export PATH=/home/user/swork/qt5/qtbase/bin:$PATH' >> nfsenv.sh"
+}}}
+
+
+Load environment variables (run@n9):
+{{{
+. nfsenv.sh
+}}}
+
+=== 3.2.2. Launch browser ===
+(run@n9)
+{{{
+~/swork/qtwebkit-webkit2-dev-builddir-armel-m6/Release/bin/MiniBrowser
+}}}
+
+== IV. Flash back N9 to factory state ==
+
+