Copyright (C) 2007 Nokia Corporation. All rights reserved. RELEASE NOTES ============= RELEASE INFORMATION Project: maemo 3.1 'bora' SDK Version: 3.1 Baseline: Week 10-7 of product SW (3.2007.10-7) Date: 2007-03-27 GENERAL INFORMATION =================== This version of maemo 3.1 SDK is based on the latest Nokia Internet Tablet OS 3.2007.10-7 image content and is a Maintenance Release for maemo 3.0. The 'bora' repositories now point to the maemo 3.1 content. The developer who has previously installed maemo 3.0 sdk can now upgrade to maemo 3.1 by running the following commands: [sbox-SDK_X86: ~] apt-get update ... [sbox-SDK_X86: ~] fakeroot apt-get install maemo-sdk-meta ... [sbox-SDK_X86: ~] fakeroot apt-get dist-upgrade ... In both SB targets. See the "KNOWN LIMITATIONS" chapter in the end of this document for additional notes and read carefully the INSTALL.txt file before starting the installation. We have not published a separate repository for this release so there is no need for you to edit your "/etc/apt/sources.list" file inside your SB environment. RELEASE CONTENT OVERVIEW ======================== This maemo 3.1 'bora' SDK release contains the following components: - i386 rootstrap - armel rootstrap - developer rootfs binaries in .jffs2 and .tgz file format - scratchbox installer - maemo installer - Nokia EUSA binaries installer in self-extracting archive - 'bora' repositories with updated packages maemo developer rootstraps provide development environment for building software for the Internet Tablet product. The rootstraps contain a large number of headers, libraries and tools that are needed to develop software for the selected target system. Rootstraps are installed inside the Scratchbox cross compilation environment. This release includes two rootstraps for two different architectures and purposes: - i386 rootstrap: The i386 rootstap is used during the development stage of the software. The benefit of using native i386 based environment is the added speed because no emulation is needed nor used. Majority of development work is done in the i386 rootstrap environment inside the Scratchbox. - ARMEL rootstrap: The main use case for the developer for using ARMEL rootstrap environment is to cross compile his application for the actual device. The developer root filesystem (="dev rootfs") - Developer ROOTFS: this is a minimal SW image that can be flashed to the actual device. It can be used for various development and testing purposes. Scratchbox installer script - This script installs the Scratchbox environment for you. Maemo installer script - The installer script installs the maemo SDK to your local machine. This script downloads the rootstraps for both ARMEL and i386 and setups the targets inside the Scratchbox. It also downloads and installs the Nokia EUSA Binary packages for you. You need to have the Scratchbox Apophis R4 readily installed in your machine before using the installer script. Nokia EUSA licensed binaries installer - Some Nokia EUSA licensed packages are only made available as binaries. To make these packages available, you will need to run the installer and accept the license. Accepting the license will extract the files to a directory under your Scratchbox home path. Flasher tools - New flasher tool is required to flash developer root filesystem and FIASCO images to the new Nokia N800 device. This version of the Flasher tool supports image flashing also to Nokia 770 device. SOFTWARE AND HARDWARE REQUIREMENTS ================================== Recommended minimum hardware setup: - Please visit http://www.scratchbox.org/ for detailed information about hardware requirements. Software: - Scratchbox Apophis R4 or later - The following toolchains from scratchbox.org scratchbox-toolchain-cs2005q3.2-glibc-arm scratchbox-toolchain-cs2005q3.2-glibc-i386 - This maemo release was tested on Ubuntu Dapper Linux distribution. - This release should work (even if it was not tested) also on other Scratchbox supported Linux distributions. Debian based distributions are recommended. FEATURES ======== Features listed below are present only in the developer ROOTFS ============================================================== Battery charging and power management USB/IP - networking using g_ether.ko USB networking gadget is available in initfs - USB networking control panel applet in rootfs Root user access to device - root shell available with "sudo gainroot" Pre-installed utilities - vi text editor - osso-xterm - scp, ssh and sshd - gdb and gdbserver MMC card support DSP and multimedia support, ALSA support - ALSA plugin included Screen calibration tool Video-4-Linux support - gstreamer plugins included DSME code lock - code lock ui and control panel applet present in rootfs Connectivity support (USB, WLAN, bluetooth) support - USB networking - WLAN networking - searching for WLAN devices - searching for Bluetooth devices Ability to mount device file system on Linux desktop (NFS support in rootfs) - NFS kernel module and daemon packages included Scratchbox CPU Transparency - Includes sbrshd for Scratchbox 1.0.x Full package management, apt support - All the required tools are included The features below are included both in ROOTSTRAPS and DEV ROOTFS or they are available from the bora repository unless otherwise stated ==================================================================== Video-4-Linux support - gstreamer plugins included Hildon Application Framework - application framework libraries - home/desktop - control panel - task navigator - help framework - backup framework - statusbar plugins for connectivity (included in rootfs) - statusbar plugins for battery (included in rootfs) - statusbar plugins for brightness (included in rootfs) Control panel applets for: - backup (in repository) - application installer (in repository) - sound (in repository) - brightness (included in rootfs) - calibration (included in rootfs) - personalization and themes (included in rootfs) - Note: personalisation control panel applet not included RTC framework: VoIP/Chat/Presence/address engines and open components - All libraries are included ALARM subsystem - Alarm libraries included Input Method framework, virtual keyboard - New SDK specific input methods Support for UPnP development - Libraries included Support for glade - Libraries included Full package management, apt support - All the required tools are included REMOVED FEATURES ================ In this release we have removed some packages (see the content_comparison.html file for details). Reasons for removal can be many. For example, the package: - may not work in the target architecture where it was provided. - package is not supported by product itself (like libsdl-net, libsdl-ttf, libusb, perl-base) but might mislead developers to believe otherwise - package may not work properly or not at all in QEMU environment and is thus removed from SB/ARMEL side - package has been subject for general clean up and removal process INSTALLATION INSTRUCTIONS ========================= Please see INSTALL.txt file under this directory. KNOWN LIMITATIONS ================= - POTENTIAL PROBLEM DOING "apt-get dist-upgrade" You MUST run "fakeroot apt-get install maemo-sdk-meta" BEFORE running the "dist-upgrade" command. If you do not do this the "dist-upgrade" will fail. You can now do "fakeroot apt-get dist-upgrade" from inside the Scratchbox (assuming you have already installed maemo 3.0) to upgrade from maemo 3.0 to maemo 3.1. There will be some warnings from "apt-get" when running the "dist-upgrade" command in the SDK_ARMEL target. These warnings can be ignored. - Both ARMEL and i386 rootstraps print out some unnecessary warnings and debugging messages when the Hildon Application Framework is started with "af-sb-init start" command. - Qemu emulator in Scratchbox (ARMEL) does not exit properly after closing the Hildon Application Framework. Workaround is to kill the leftover Qemu processes manually using command "sb-conf killall". - In some Ubuntu Edgy Linux installation the networking might not work from inside Scratchbox. The workaround is to reset the target and reinstall the rootstraps. - VIRTUAL KEYBOARD The special characters button in the new Virtual Keyboard does not function. If you work on rootstraps the workaround is just to use the normal PC keyboard to enter characters. This button does not function in developer rootfs. - XEPHYR Xephyr is not included in rootstraps and is meant to be installed to developer host system instead. See the INSTALL.txt file for details. - The gazpacho hildon plugins are still beta version (in garage). - Maemo-launcher fails due to SB ARMEL C-library The ARMEL C-library files from Scratchbox toolchains have a problem that causes the maemo-launcher to fail in the ARMEL target. You need to use the C-libraries that are included in the rootstraps. See the INSTALL.txt file for the details about the workaround. NOTE: If you are using the maemo-installer then this is automatically taken care of for you. - DEBCONF The SDK contains the debconf package due to dependency reasons but this is not present in Nokia N800 product. Please take this into account when creating packages. DOCUMENTATION ============= - One new document has been produced: - "Maemo Debugging Guide". The document is available from maemo.org: http://www.maemo.org/platform/docs/how-to.html - Content comparison table of maemo 3.0 and maemo 3.1 is available from: http://repository.maemo.org/stable/3.1/content_comparison.html - In addition some other minor documentation fixes were made. FIXED PROBLEMS ============== The following officially reported problems have been fixed in this release: 1. Bugzilla ID: 1003: Maemo installer does not use cached rootstrap files by default. 2. Bugzilla ID: 1030: Missing "/bin/sh" link in rootstraps. 3. Bugzilla ID: 1041: CPU transparency guide fixes. 4. Bug ID: (internal): Installer did not reset target when overwriting existing target. 5. Bug ID: (internal): pixeldoubling not working (X11 related) 6. Bug ID: (internal): SDL window refocusing causes unpredictable behavior. 7. Bug ID: (internal): libsdl calls exit() on fatal signal. RELEASE FEEDBACK ================ General feedback about this release can be send to: bora-feedback@maemo.org --- END