From eLinux.org
Revision as of 08:16, 11 March 2018 by Wicket (talk | contribs) (Links)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


This page is about adding Nokia N800/N810 support to Linux mainline kernels. N800/N810 (from now on called just n8x0) has been in linux-omap tree far too long, we need to get it finally to mainline. There has been discussions on the linux-omap mailing list about this:

All the information about n8x0 mainline inclusion is scattered and the purpose of this page is to collect them into one place. As this is a wiki, it's encouraged for the people to improve the page based on their knowledge.

Kernel Status


  • Green = Available
  • Yellow = Work in Progress (WIP), for docs: no documentation, but kernel code available
  • Red = Missing
  • Cyan = Not Available (N/A)
Chip Dev Purpose Docs Impl Merge Board impl Board merge
OMAP2420 N8x0 System-on-chip code Yes 2.6.15 Yes 2.6.32
* ARMv6 N8x0 CPU code Yes by 2.6.12 N/A
* * SIMD N8x0 Media Extensions ?
* * Thumb N8x0 Code compression code Yes by 2.6.12 ? ?
* * Jazelle N8x0 Java acceleration ?
* * VFP N8x0 Floating-point coprocessor code Yes by 2.6.12 ? ?
* TMS320 C55x N8x0 DSP old code No No ?
* OMAP video N8x0 Video output old? code ??? ??? No No
* PowerVR MBX N8x0 OpenGL ES and OpenVG acceleration No No No No No
* OMAP Boot Tags N8x0 Provides boot information from bootloader (NOLO) code Yes needs rewrite N/A
* OMAP MMC N8x0 SD/MMC cards code Yes 2.6.22 Patch-1 Patch-2 2.6.34
* ??? N8x0 Internal UART/Serial code Yes Yes Yes 2.6.32
* * GPS5300 N810 A-GPS chipset No No No No No
tcm825x N8x0 Webcam + i2c bus code Yes 2.6.24 No No
* tea5761 N800 FM radio code Yes 2.6.26 No No
* lm8323 N810 Keyboard code Yes 2.6.31 No No
* tsl2563 N810 (Both?) Ambient light sensor code Yes 2.6.33 No No
* lp5521 N810 (Both?) 3 channel LED code Yes No No No
blizzard N8x0 LCD controller code Yes 2.6.23 usable needs tahvo
menelaus N8x0 GPIO extender + i2c bus + ??? code Yes 2.6.35 Patch 2.6.35 2.6.35
* tmp105 N8x0 Temperature sensor (menelaus GPIO) code untested 2.6.35 no no
McSPI N8x0 SPI bus code Yes 2.6.23 Yes 2.6.32
* Sharp LS041Y3 N8x0 LCD panel (compatible with MIPID) code Yes 2.6.32 usable w/ blizzard
* cx3110x / stlc4550 N8x0 802.11b/g WiFi code Yes 2.6.31 Yes 2.6.36
* tsc2301 N800 Touchscreen + Keypad + GPIO + Audio old code No No No No
* tsc2005 N810 Touchscreen controller code 2.6.35 2.6.35 2.6.35 2.6.35
TLV320AIC33 N810 Audio Yes? Yes 2.6.25 No No
Cbus N8x0 ??? old code Linux-OMAP needs rewrite ?
* Retu/Vilma N8x0 ??? including watchdog old code Linux-OMAP No ?
* Tahvo/Betty N8x0 ??? old code Linux-OMAP No ?
??? N8x0 Battery charger Slightly non-charge driver No No No No
OneNAND N8x0 Flash memory code Yes 2.6.15 Yes 2.6.32
TUSB6010 N8x0 USB code Yes 2.6.27 untested 2.6.34


Luke-Jr's git tree

Luke maintains a git tree with his latest work:


Kalle Valo's old patches

Some older patches are available from:


The patches are against a very old tree of Linus'. This was to make merge to the mainline as easy as possible.

They have been, at least, tested with Sourcery G++ Lite 2008q3-66.

TSC2301 support on linux-omap

TSC2301 support started in the linux-omap tree somewhere in early 2007. See for example commit d6aa131...

The sound driver was removed in commit c65c733... (5 Dec 2008) because the driver must be updated to the new ALSA SoC (ASoC) standard.

In 10, 17 Jun 2009 the other TSC2301 related files (keypad, touchscreen and core drivers) were all removed in commits 0887c51..., 42a0006... and 6e9c9bd.... Reason was just a reset to mainline. This code must be checked for compatibility with current mainline, and then resubmitted to there.


Compilation instructions:

## Set environment parameters for cross-compilation
export ARCH=arm CROSS_COMPILE=arm-linux- 
## Load default configuration parameters for the N8x0
make n8x0_defconfig
## Build kernel image and modules
make zImage modules
## Load kernel for testing
flasher -k arch/arm/boot/zImage -l -b
## Record, or "flash" kernel into device memory
#flasher -k arch/arm/boot/zImage -f -b


All discussion should happen at <linux-omap@vger.kernel.org> (subscription instructions). Kalle Valo <kvalo@adurom.com> coordinates all this, so you might want to contact him in case there's something private you want to discuss and CC on all n8x0 related patches. The public communication in the mailing list is the preferred method.

The Plan

This a a draft and very much work in progress!

Most of the drivers needed by n8x0 should be already in mainline, notably exception being the Nokia's proprietary cbus support. But this must be checked.

  1. platform data support for omap serial driver
  2. n8x0 board file
    1. serial port
    2. onenand
    3. spi
    4. display
    5. touchscreen
    6. keyboard
    7. wlan
    8. usb
  3. cbus
    • should be converted to use spi framework and send to inclusion for mainline
  4. retu
    • should use new cbus driver
  5. tahvo
    • should use new cbus driver

User space interfaces for Maemo

Diablo (Maemo OS 2008) user space components use non-standard kernel interfaces and most likely the interfaces are not acceptable to mainline. To get Diablo running with latest mainline kernels, this needs to be solved somehow. (You should consider instead looking for more recent systems, such as MeeGo.)

Identified non-standard interfaces:

  • watchdog interface used by dsme
  • bme interface
  • private Wireless Extension calls used by wlancond/eapd
  • audio and DSP in general
  • maybe also display control
  • /proc/component_version read by linuxrc from initfs
  • /proc/bootreason read by dsme

In theory it might be possible to implement an out-of-tree module or separate patchset which provide the diablo specific interfaces to user space. This needs to be investigated.

Patch for dumping retu/tahvo userspace interface activities.


Simplify make

To avoid using adding ARCH variable to every make command add a file named GNUmakefile with the contents below and then you can run make without any options. Thanks to Johannes Berg for the tip.

include Makefile

Avoid CodeSourcery G++ Lite 2007q3-53 release

Kernel compiled with 2007q3-53 fails to boot:

<6>OMAP242x GPIO hardware version 1.8                                           
<6>OMAP clockevent source: GPTIMER1 at 32000 Hz                                 
Console: colour dummy device 80x30                                              
<6>Calibrating delay loop...