Mer

The Mer platform is a Linux distribution for mobile devices based on the Maemo platform from Nokia. Mer goals include:


 * Improving and developing parts of Maemo that are of interest to the Maemo community.
 * Making it easier to port existing desktop applications by hildonizing and adjusting them to the tablet form factor.
 * Encouraging third party experimentation and development.
 * Supporting tablet hardware no longer receiving updated OS software by Nokia.
 * Making Maemo a generic platform for all tablet devices, including non-Nokia ones.
 * Focusing Maemo community efforts in platform-related areas

Mer platform development will be done in the open, with public SCM repository, bugtrackers, and Wiki-based blueprint discussion.

We should stop seeing the tablets as strictly under-powered embedded systems, and see them for what they really are: powerful, power-efficient, economical handheld computers.

Historically, the Mer platform came from a discussion on reconstructing Maemo and a desire to make a proof of concept system of the thoughts in this proposal (M-R PoC), which developed into Mer after realization that it was a viable direction of development.

Sprints
We employ the Maemo.org sprints method as development method for Mer. That means, get yourself a maemo.org account, and read this document through if you would like to contribute :)

Most Mer development talk goes on in #maemo on irc.freenode.net. If you do not have an IRC client, use www.mibbit.com. We currently use https://launchpad.net/m-r for collaboration, but will move to maemo.org eventually. Our current status is that we have a N8x0 image with nm-applet, advanced backlight, load-applet on top of a hildon-desktop using Fremantle components, on top of Xorg and Ubuntu Jaunty. Previous progress can be viewed at http://jaiku.com/channel/reconstructedPOC

We have fringe projects in 770, Zaurus, x86, Wii ports, and as such, code will be built first on x86 to ensure cross-platform, and then in our cross-compilers.

= Sprint January 2008 and before: Basic installable image =

The purpose of this milestone:
 * To provide a basic installable firmware image, both through installer and through flashing, for N8x0 tablets.
 * The image must include a basic user interface and ability to connect to Wi-Fi networks.
 * To provide a installer and image for 770 tablets.
 * To provide initial developer tools so we can start developing for the tablets.
 * Begin initial talks with Nokia and maemo.org on how to distribute full firmware images.
 * Prepare for next milestone in terms of collaborative technologies.

If you have a task that needs to be done to fullfill the purposes of this milestone, add it to the table below, set it to 'Just standing' status, and with no commit date and owner.

If you want to take on a task, set the initial commit date, your nickname, and update your progress as you go, and update highlights of your work (including what gets added) as you work on it. Update your activity log each day you've performed something related to Mer.

If you encounter any bugs in Maemo platform software while developing for Maemo, report them on bugs.maemo.org, and add the bug number to the sprint bug overview.

Bug reports in bugzilla discovered through or related to Mer development in this sprint:

Activity log
16th January


 * stskeeps: remade Mer blueprint to fit more into maemo.org processes, added mer-generic-x86 to play with at some point, and added nit-kernel-compat to imager.

= Documentation and tasks =

SDK
First, install Fremantle SDK, and add yourself as a user to scratchbox.

As user:
 * wget -c http://stskeeps.subnetmask.net/mer/arm-linux-cs2008q3-72-libtool2_1.0.11_i386.deb
 * sudo dpkg -i arm-linux-cs2008q3-72-libtool2_1.0.11_i386.deb (run as root)
 * wget -c http://stskeeps.subnetmask.net/mer/scratchbox-devkit-mer_1.0.11_i386.deb
 * sudo dpkg -i scratchbox-devkit-mer_1.0.11_i386.deb
 * You can optionally get qemu-arm-eabi and use that here instead. It is very good for your use of the SDK
 * sb-conf setup MER-ARMEL --compiler=arm-linux-cs2008q3-72-libtool2 --devkits=debian-etch:cputransp:perl:mer --cputransp=qemu-arm-cvs-m -f
 * sb-conf reset -f MER-ARMEL
 * sb-conf select MER-ARMEL
 * sb-conf rootstrap MER-ARMEL http://stskeeps.subnetmask.net/mer/mer-armel-rootstrap-v8.tar.gz
 * sb-conf install MER-ARMEL --etc --devkits --fakeroot

ISSUES:
 * You might have to do export PKG_CONFIG_PATH=/usr/share/pkgconfig:/usr/lib/pkgconfig to get some pkg-config stuff going
 * You might have to set cpu right and such to target armv5el (no vfp)
 * You probably need to get EABI cpu transparency target too
 * 'not safe for cross-compilation' warnings (not true, i think)
 * fakeroot apt-get dist-upgrade is good once in a while to keep up to date.

Mer Installer
Make installer for Maemo/Diablo that does the following:


 * Depends on bootmenu (bootmenu with bootmenu.d item)
 * Allows simple installation (partition my internal/external MMC to 50mb FAT, 128mb swap, rest linux), or advanced (choose my own partition)
 * Partitions, mkfs.ext3's and unpacks a downloaded tar.gz (built by the imager, uploaded to some http.). Should support resume of dls (wget -c?)
 * Sets up the bootmenu item for Mer.

qemu-eabi cputransp for Scratchbox
See http://maemogeek.blogspot.com/2007/11/installing-qemu-arm-eabi-patch-into.html

Make a debian package with this binary (for i386), installing into /scratchbox/devkits/cputransp/bin/qemu-arm-eabi-sb2 and adding 'qemu-arm-eabi-sb2' to /scratchbox/devkits/cputransp/etc/cputransp-methods when installing, and removing when removing (sed -i?)

Edit |SDK to make instructions use qemu-arm-eabi-sb2 instead, and getting your .deb package.

Getting your package included in the Repository

 * Make sure it compiles after getting your build dependancies, dpkg-buildpackage.
 * Ideally test both dpkg-buildpackage -S -us -uc, dpkg-buildpackage -b -us -uc, dpkg-buildpackage -B (some packages may not build any arch-dep packages, so that's ok. Microdocument it on Jaiku.)
 * bzr export lp:~yourusername/m-r/ (gives you a checked out version, without metadata)
 * cd
 * dpkg-buildpackage -S -us -uc, to generate a source package
 * Upload the resulting source package (*.changes, *.tar.gz, possibly *.diff.gz) to your ~/incoming on the repo server.
 * ssh yourlogin@reposerver /import-new-packages

(This will add the source package to repository)


 * You need access to merbuilder & repository upload for the following, ask Stskeeps on Jaiku/IRC for this. Or refer on Jaiku to the source package and some may pick it up
 * On http://jaiku.com/channel/merbuilder, write "build = "
 * Monitor progress at http://merbuilder.jaiku.com
 * An LP player notes that it has picked up a package for building at a certain builder
 * A toast means it baked properly on this architecture. And is uploaded to repository.
 * A heart means it built properly on all architectures. And is uploaded to the repository
 * A bomb means it failed to build on an architecture.
 * A shopping wagon means it has noticed your build request and queued it.

Open system sounds
List of wav files from osso-sounds-ui (non-free package):

/usr/share/sounds/ui-recharge_battery.wav /usr/share/sounds/ui-connection_lost.wav /usr/share/sounds/ui-window_open.wav /usr/share/sounds/ui-window_close.wav /usr/share/sounds/ui-information_note.wav /usr/share/sounds/ui-new_email.wav /usr/share/sounds/ui-wake_up_tune.wav /usr/share/sounds/ui-charging_started.wav /usr/share/sounds/ui-confirmation_note.wav /usr/share/sounds/ui-gesture_number_recognized.wav /usr/share/sounds/ui-shutdown.wav /usr/share/sounds/ui-key_press.wav /usr/share/sounds/ui-pen_down.wav /usr/share/sounds/ui-general_warning.wav /usr/share/sounds/ui-thumb_keyboard_launch.wav /usr/share/sounds/ui-battery_low.wav /usr/share/sounds/ui-default_beep.wav /usr/share/sounds/ui-operation_ready.wav /usr/share/sounds/ui-wrong_charger.wav

Using the imager
Grab the imager from bzr (lp:~mer-committers/m-r/imager)

Targets are:


 * targets/mer-770-fs-only - builds a filesystem for Mer on Nokia 770
 * targets/mer-n800-fs-only - builds a filesystem for Mer on N800
 * targets/mer-x86-generic - builds a filesystem for X86 in general

Imager can be run with: sh imager targets/TARGET /path/where/you/want/fs

Look inside the target scripts and work your way back.

Making a x86 Mer bootable
Partition your boot device, make a ext3 partition. In the following, sda1 is your ext3 partition and sda is your boot device. Only install this on a USB stick or whatever that you want to have possibly destroyed.


 * mkdir -p /mnt/deblet
 * mkfs.ext3 /dev/sda1
 * mount -t ext3 /dev/sda1 /mnt/deblet
 * Grab a release x86-generic tar.gz and put in /mnt/deblet, tar pzvxf it from within /mnt/deblet OR

Use imager from above, or grab a release tar.gz of x86-generic, and unpack it on your