Revision as of 11:17, 29 October 2010

Note: This page is work-in-progress (26 Oct 2010).

This page instructs in installing the MeeGo image and configuring device access when using a N900 device for your development work.

Prerequisites

• You have set up MeeGo SDK environment on Linux

Installing the MeeGo image on your N900 device

These instructions cover installing the MeeGo image on the N900 using an external SD card without destroying the data from the internal memory of the N900. For more information on this way of installing MeeGo, see http://wiki.meego.com/ARM/N900/Install/MMC. For information on other ways of installing MeeGo, see http://wiki.meego.com/ARM/N900.

On Ubuntu and openSUSE:

1. Insert the SD card into your computer.
2. Find out what device the SD card is:

   sudo fdisk -l

   See the disk size information to recognize the SD card from other drives. (Optionally, you can identify the SD card based on differences in the sudo -l fdisk output before and after inserting the SD card.)

3. Unmount the SD card:

   sudo umount <sd card>

4. Download MeeGo image from http://repo.meego.com/MeeGo/builds/ > folder 1.0.99 > folder with the latest update* > handset/ > images/ > meego-handset-armv7l-n900/ > meego-handset-armv7l-n900-<meego image version number>-mmcblk0p.raw.bz2.

   Note: For information on how much functionality is known to work on the N900, see the most recent N900 sanity test results at Quality/HandsetTestReport.

5. Download kernel image from the same URL (http://repo.meego.com/MeeGo/builds/). The kernel image file name is of the format meego-handset-armv7l-n900-<meego image version number>-vmlinuz-<kernel version number>-n900.
6. Decompress the MeeGo image (.bz2) file.
7. Copy the MeeGo image to the SD card:

   $ sudo dd bs=4096 if=<raw_image> of=/dev/<SD card>

   Note: Copying takes some time. For instructions on how to see the status of the process, see http://wiki.meego.com/ARM/N900/Install/MMC.

8. Flash the N900:
   1. Insert the SD card into the N900, attach the battery, and close the back cover. Do not start the N900.
   2. Navigate to http://tablets-dev.nokia.com/maemo-dev-env-downloads.php and accept the license agreement.
   3. Download and run flasher:
      • On Ubuntu:
        1. Download maemo_flasher-3.5_2.5.2.2_i386.deb.
        2. In a 32-bit architecture, install flasher with:

           $ sudo dpkg -i maemo_flasher-<version number>i386.deb

        3. Accept license agreements.
        4. Run flasher:

           $ sudo flasher-3.5 -l -k <kernel image> -b

      • On openSUSE:
        1. Download maemo_flasher-3.5_2.5.2.2.tar.gz and decompress it with the command:

           tar xzvf <name of tar file>

           The file is decompressed into the directory maemo_flasher-3.5_2.5.2.2.

        2. Run flasher:

           $ sudo <path to flasher>flasher-3.5 -l -k <kernel image> -b

   4. The command prompt displays text "Suitable USB device not found, waiting." Attach USB cable.

      The device is booted and MeeGo image runs on your device. If the device does not boot, press the power button.

Next time you boot the device, the original kernel is used and your MeeGo OS should boot normally.

Setting up the connection

You can use USB or WLAN to connect your N900 device and your computer.

To use USB connection:

1. Connect the device to your computer with the USB cable.
2. Configure the device access in Qt Creator.

To use WLAN connection:

1. Connect the device to your computer with the USB cable.
2. To log into the device, use the following command:

    ssh root@192.168.2.15 

   (password: meego)

3. To view the WLAN IP address of the device, use the following command:

   ifconfig

4. Unplug the USB cable.
5. Configure the device access in Qt Creator.

Configuring device access in Qt Creator

To configure device access:

1. Open Tools > Options > Projects > MeeGo Device Configurations.
2. In the opened dialog, create a new Device Configuration by clicking on Add.
3. Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
   • Device type: Remote device
   • Authentication type: Password
   • Host Name: <device IP address> (USB port IP address 192.168.2.15 by default)
   • SSH Port: 22
   • Gdb server: 10000

   Note: If this port is not free, you can select another one.

   • Connection Timeout: 30
   • User Name: root
   • Password: meego
4. Click Apply.
5. To test the settings, click Test.

   The message "Device configuration successful." is displayed in Device Configuration Test window.

6. Click Close and OK.

If the message "Could not connect to host" is displayed, check your setting selections and make sure that the network is connected.