Eclipse integration/Known issues

= Known Issues for Maemo Eclipse Integration Edition 2 Final release =

More detailed known issues lists can be found from Garage projects for each product https://garage.maemo.org/.

Product baselines

 * N900 device with Maemo Fremantle 5.x platform releases
 * Fremantle 5.0 SDK, the latest final release
 * N8x0 devices with Maemo Diablo 4.1.x platform releases
 * Diablo 4.1.2 SDK, the latest maintenance release

Product configuration

 * Maemo SDK ARMEL rootstrap is meant to be used only for cross-compiling and it does not support running or debugging applications
 * Diablo 4.1.2 device requires kernel patch from here http://tablets-dev.nokia.com/maemo-dev-env-downloads.php to be flashed to the Tablet for USB Networking to work with Windows host PC
 * Diablo 4.1.2 device requires hildon-desktop patch to be installed to the Tablet from pc-connectivity Garage repository (see instructions from here http://pc-connectivity.garage.maemo.org/2nd_edition/main.html#SECTION00030000000000000000) for VNC client to work on host PC

Maemo Mica plugin framework for Eclipse

 * While debugging Python application automatic termination of debugged program does not work when debugging session ends

Maemo ESBox plugin for Eclipse

 * Installation wizard for SDK Virtual Image on Mac OS X may run into deadlock in situations when more than one dialog is open at the same time
 * workaround is to use manual installation of SDK Virtual Image on Mac OS X
 * There is no automatic mounting of /scratchbox shares from inside a Maemo SDK Virtual Image into Mac OS X host PC which prevents automatic configuring of C/C++ indexing. Manual configuring and C/C++ indexing works.
 * Hover help for Python and C++ for Maemo API documents does not work on ESBox because documentation is not integrated yet
 * Debian installation packages creation for Python applications using Eclipse Wizard may fail to create correct structure for packages
 * The disk free space calculation on Mac OS X may be incorrect when installing Maemo SDK Virtual Image. If you know you have enough disk space, ignore the not enough disk space warning.

Maemo Pluthon plugin for Eclipse

 * Remote ltrace tool launching for Maemo device fails with Windows host PC if SBRSH is used
 * workaround is to use SSH and RSE instead of SBRSH
 * Hover help for Python for Maemo API documents does not work on Pluthon because documentation is not integrated yet

Maemo PC Connectivity

 * Maemo PC Connectivity functionality with N900 device and Fremantle is more limited than with N800/N810 device with Diablo
 * N900 will not support USB host mode
 * no workaround (N900 HW issue)
 * N900 will not support IP Forwarding (iptable NAT kernel modules)
 * workaround is to rebuild Fremantle kernel with NAT enabled and hack kernel symbols for NAT kernel modules
 * N900 will not support BlueTooth connections simultaneously with WLAN connections
 * no known workaround
 * N900 will not support "USB Networking" with platform default USB applet but only "PC Suite" and "Mass Storage" mode (applet provided by PC Connectivity supports also USB Networking)
 * workaround is to use ONLY configuration applet provided by PC Connectivity instead of default applet
 * Notice that USB mode changes are possible only if USB cable is plugged-out and plugged-in between mode changes with both applets
 * Notice that if both applets (platform default USB applet and PC Connectivity applet) are used for mode changes device may fail to change mode after first change
 * Fremantle platform does not have libicd-dummy package available until final release and thus user cannot navigate to Internet through the browser using USB and BlueTooth. He/she will be able to navigate only using WLAN (standard behavior)
 * final PC Connectivity release will have libicd-dummy package
 * Samba does not work with Fremantle platform and N900 causing disk mounts between N900 and Windows host PC to fail
 * will be (hopefully) fixed for final release
 * Fremantle platform and SDK support ONLY 16-bit color depth for X Server
 * workaround is to configure host PC X Server (in Windows and Mac OS X) to use 16-bit depth instead of default one (if default does not happen to be 16-bit)
 * Configuring connectivity to work between Maemo device and host PC after installation is still partly manual work on host PC side for all supported operating systems
 * When creating a project and setting SBRSH as download method quite often errors like "sbrsh server: fuse: bad mount point" and "sbrsh server: Can't mount to point:" happens. As a workaround you need to restart SBRSHD (on Maemo device side) and restart ESBox (on host PC side)
 * WLAN connection may get broken if using WLAN and USB Networking simultaneously. Connection problems may occur after some time (can take hours or days) when device is (re)started and WLAN tries to connect.
 * when the problem occurs user gets "Internet connection failed. Unable to retrieve IP address from server" error
 * workaround is to reflash Maemo device or manually assign IP number to the connection (which may cause problems with DHCP)
 * If FileZilla has already been installed to the Mac OS X host PC, installation of Host PC Connectivity with default settings fails
 * workaround is to move FileZilla first to trash and then reinstall Host PC Connectivity or select not to install FileZilla with Host PC Connectivity

Maemo SDK Virtual Image

 * NetworkManager is being started after Scratchbox, so the resolv.conf file used by Scratchbox may be invalid which causes network problems
 * VMWare Player version 3.0 may have problems to keep ssh connection live (notice that VMWare Player 2.5 works fine)

Maemo Flasher-3.5 Tool

 * Flasher-3.5 beta for Windows tool may have problems in some Windows host PC configurations to flash eMMC images properly
 * workaround is to use Linux or Mac Flasher-3.5 tool for eMMC flashing
 * Flasher-3.5 beta for Windows tool fails to unpack FIASCO image with '-u' option
 * workaround is to use Linux or Mac Flasher-3.5 tool for unpacking FIASCO images

Integration testing

 * Some publically available test suites (for Eclipse components and NFS mounts, for example) are run on Linux, Windows and Mac OS X during integration testing but frameworks and test sets are not yet ready to be published


 * Test results (for unit tests and integration tests) for official releases are not yet ready to be published together with products

Feedback can be sent to eclipse-integration@maemo.org