Difference between revisions of "N900"

From eLinux.org
Jump to: navigation, search
(Kernel Status: Simplify driver field)
(Kernel Status: A/V cable detection is missing too!)
(11 intermediate revisions by 2 users not shown)
Line 144: Line 144:
 
| * || || omap_hsmmc slot-name
 
| * || || omap_hsmmc slot-name
 
|bgcolor="lime"| [http://www.ti.com/pdfs/wtbu/OMAP34xx_ES3.1.x_PUBLIC_TRM_vZV.zip OMAP34xx TRM]
 
|bgcolor="lime"| [http://www.ti.com/pdfs/wtbu/OMAP34xx_ES3.1.x_PUBLIC_TRM_vZV.zip OMAP34xx TRM]
|bgcolor="lime"| Yes
+
|bgcolor="lime"| [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=db863d8966818d3af3e415b5f60fcfeceba803c6 4.7-rc1] [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=10c1f7d32bf451d4309850c15ab1fdadccf92620 4.7-rc1]
|bgcolor="yellow" colspan="2"| [https://lkml.org/lkml/2015/5/15/661 WIP]
+
|bgcolor="cyan" colspan="2"| currently not needed
 
|-
 
|-
 
|* temp || ti-soc-thermal || OMAP34xx temperature sensor
 
|* temp || ti-soc-thermal || OMAP34xx temperature sensor
Line 199: Line 199:
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/3/15/155 3.15]
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/3/15/155 3.15]
 
|bgcolor="lime"| [http://marc.info/?l=linux-omap&m=139518444704345&w=2 3.16]
 
|bgcolor="lime"| [http://marc.info/?l=linux-omap&m=139518444704345&w=2 3.16]
 +
|-
 +
| musb || musb || USB
 +
|bgcolor="yellow"|
 +
|bgcolor="lime"| Yes
 +
|bgcolor="lime"| Yes
 +
|bgcolor="lime"| Yes
 +
|-
 +
| * || || Forced host mode (via debugfs)
 +
|bgcolor="yellow"|
 +
|bgcolor="yellow"| [https://lkml.org/lkml/2016/12/19/313 WIP]
 +
|bgcolor="cyan" colspan="2"| N/A
 
|-
 
|-
 
| GPIO || gpio-keys || Camera button
 
| GPIO || gpio-keys || Camera button
Line 231: Line 242:
 
| * || || Sysfs node for disabling device
 
| * || || Sysfs node for disabling device
 
|bgcolor="lime"| [http://www.ti.com/lit/gpn/tsc2005 datasheet]
 
|bgcolor="lime"| [http://www.ti.com/lit/gpn/tsc2005 datasheet]
|bgcolor="red"| No
+
|bgcolor="yellow"| [https://lkml.org/lkml/2016/12/25/19 RFC PATCH]
 
|bgcolor="cyan" colspan="2"| N/A
 
|bgcolor="cyan" colspan="2"| N/A
 
|-
 
|-
Line 248: Line 259:
 
| * || || Permanent mac address
 
| * || || Permanent mac address
 
|bgcolor="yellow"| code
 
|bgcolor="yellow"| code
|bgcolor="yellow"| [https://lkml.org/lkml/2013/12/8/35 WIP]
+
|bgcolor="yellow"| [https://lkml.org/lkml/2016/12/24/61 WIP]
 
|bgcolor="cyan" colspan="2"| N/A
 
|bgcolor="cyan" colspan="2"| N/A
 
|-
 
|-
 
| * || || Bluetooth coexistence mode configuration
 
| * || || Bluetooth coexistence mode configuration
 
|bgcolor="yellow"| code
 
|bgcolor="yellow"| code
|bgcolor="yellow"| [https://lkml.org/lkml/2013/12/8/33 WIP]
+
|bgcolor="yellow"| [https://lkml.org/lkml/2015/12/26/35 WIP]
 
|bgcolor="cyan" colspan="2"| N/A
 
|bgcolor="cyan" colspan="2"| N/A
 
|-
 
|-
Line 279: Line 290:
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/4/28/308 3.16]
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/4/28/308 3.16]
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/4/28/302 3.16]
 
|bgcolor="lime"| [https://lkml.org/lkml/2014/4/28/302 3.16]
 +
|-
 +
| * || || A/V cable detection
 +
|bgcolor="yellow"| In maemo fremantle kernel (nokia-av.c)
 +
|bgcolor="red"| No
 +
|bgcolor="red" colspan="2"| No
 +
|-
 +
| * || || Headset button
 +
|bgcolor="yellow"| In maemo fremantle kernel (nokia-av.c)
 +
|bgcolor="red"| No
 +
|bgcolor="red" colspan="2"| No
 
|-
 
|-
 
| * || || All sound alsa switches and channels
 
| * || || All sound alsa switches and channels
Line 328: Line 349:
 
|-
 
|-
 
| *  || || A-GPS
 
| *  || || A-GPS
|bgcolor="red"| No
+
|bgcolor="yellow"| Uses SUPL
 
|bgcolor="cyan" colspan="3"| Client SUPL application: http://www.tajuma.com/supl/index.html
 
|bgcolor="cyan" colspan="3"| Client SUPL application: http://www.tajuma.com/supl/index.html
 
|-
 
|-
Line 388: Line 409:
 
| AD5820 || ad5820 || Autofocus
 
| AD5820 || ad5820 || Autofocus
 
|bgcolor="lime"| [http://natisbad.org/N900/ref/AD5821.pdf datasheet for AD5821, which may be similar]
 
|bgcolor="lime"| [http://natisbad.org/N900/ref/AD5821.pdf datasheet for AD5821, which may be similar]
|bgcolor="yellow"| [https://gitorious.org/linux-n900/linux-n900/commit/661caf226fee7a8f54ac3559787f7474b4917f82 WIP]
+
|bgcolor="lime"| [https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=commit;h=bee3d51156113363e952674504833b4bc92cf15e 4.9-rc1]
 
|bgcolor="red" colspan="2"| No, depends on omap3isp
 
|bgcolor="red" colspan="2"| No, depends on omap3isp
 +
|-
 +
| * || || AD5820_RAMP_TIME and AD5820_RAMP_MODE ctrls
 +
|bgcolor="yellow"| code
 +
|bgcolor="yellow"| [https://lkml.org/lkml/2016/5/27/524 WIP]
 +
|bgcolor="cyan" colspan="2"| N/A
 
|-
 
|-
 
| BCM2048 || hci_h4p || Bluetooth
 
| BCM2048 || hci_h4p || Bluetooth
Line 395: Line 421:
 
|bgcolor="red"| No ([https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=a4102f90e87cfaa3fdbed6fdf469b23f0eeb4bfd removed in v3.18-rc1]) [https://lkml.org/lkml/2014/1/21/401 3.15 (staging)]
 
|bgcolor="red"| No ([https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=a4102f90e87cfaa3fdbed6fdf469b23f0eeb4bfd removed in v3.18-rc1]) [https://lkml.org/lkml/2014/1/21/401 3.15 (staging)]
 
|bgcolor="red" colspan="2"| No
 
|bgcolor="red" colspan="2"| No
|bgcolor="yellow"| [https://api.merproject.org/public/source/nemo:devel:hw:ti:omap3:n900/bcm-bt-firmware/bcm-bt-firmware-0.21rc3.tar.bz2 bcmfw.bin]
+
|bgcolor="yellow" rowspan="2"| [https://api.merproject.org/public/source/nemo:devel:hw:ti:omap3:n900/bcm-bt-firmware/bcm-bt-firmware-0.21rc3.tar.bz2 bcmfw.bin]
 
|-
 
|-
 
| * || radio-bcm2048 || FM/RDS receiver
 
| * || radio-bcm2048 || FM/RDS receiver
 
|bgcolor="yellow"| old code
 
|bgcolor="yellow"| old code
 
|bgcolor="greenyellow"| [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=899127b67df098e6d878f27be05dc91401cc6685 3.14 (staging)]
 
|bgcolor="greenyellow"| [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=899127b67df098e6d878f27be05dc91401cc6685 3.14 (staging)]
|bgcolor="red" colspan="2"| No
+
|bgcolor="yellow"| [https://github.com/pali/linux-n900/commit/e16e531e9139678acac8bc67a2a1e3f59bb65945 WIP]
 +
|bgcolor="yellow"| [https://github.com/pali/linux-n900/commit/0fbd205b2439d878da9db9df9750dced6db4b531 WIP]
 
|-
 
|-
 
| IR Diode on PWM GPIO || ir-rx51 || Infrared/CIR transmitter
 
| IR Diode on PWM GPIO || ir-rx51 || Infrared/CIR transmitter
 
|bgcolor="cyan"| N/A
 
|bgcolor="cyan"| N/A
|bgcolor="yellow"| [http://www.spinics.net/lists/linux-omap/msg75258.html 3.7-rc1] [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/drivers/media/rc/Kconfig?id=a62a6e98c370ccca37d353a5f763b532411a4c14 (broken since v3.8-rc4)]
+
|bgcolor="lime"| [http://www.spinics.net/lists/linux-omap/msg75258.html 3.7-rc1] [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/drivers/media/rc/Kconfig?id=a62a6e98c370ccca37d353a5f763b532411a4c14] [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=4406d52a0b735b27472846953fd0565302af6f3c 4.8-rc1]
|bgcolor="red" colspan="2"| No
+
|bgcolor="lime"| [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=b5406176989da601736db862643d3d7ee8335815 4.8-rc1]
 +
|bgcolor="lime"| [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=e7c8682143db9771bad62626793201eb809cfaf2 4.8-rc1]
 
|-
 
|-
 
| omap3-rom-rng || omap3-rom-rng || OMAP3 ROM Random Number Generator support
 
| omap3-rom-rng || omap3-rom-rng || OMAP3 ROM Random Number Generator support
Line 521: Line 549:
 
* Packages are available in Debian & Ubuntu (apt-get install 0xffff)
 
* Packages are available in Debian & Ubuntu (apt-get install 0xffff)
 
* Gentoo Ebuild is available in ixit overlay (emerge -av sys-apps/0xffff::ixit )
 
* Gentoo Ebuild is available in ixit overlay (emerge -av sys-apps/0xffff::ixit )
 +
 +
== Wireshark Plugin for PhoNet ==
 +
 +
* http://sre.ring0.de/isi-wireshark-plugin/
 +
 +
== A-GPS ==
 +
 +
* Uses SUPL (Secure User Plane Location) protocol (see documentation at open mobile alliance)
 +
 +
A-GPS works by Modem requesting CPU to open a socket (it supplies domain/ip and port) [pkg type LS_SOCKET_OPEN_REQUEST_NTF]. Then the modem will continue by requesting to send some data using pkg type LS_SOCKET_SEND_REQUEST_NTF, followed by requesting to receive some data [pkg type LS_SOCKET_RECV_REQ]. Last but not least it will request to close the socket using LS_SOCKET_CLOSE_REQUEST_NTF. The wireshark plugin mentioned above can also be used to analyse A-GPS sessions (e.g. initialized by Maemo).

Revision as of 07:50, 1 January 2017

The Nokia N900 is a Linux based smartphone from Nokia, which has been released in November 2009. It's sold with Maemo using a patched 2.6.28 kernel (adding board support and lots of drivers). Since then board support has been added to the mainline kernel and most hardware can be used with a current kernel. Details can be seen in the table below.

Kernel Status

also see: N900/Changelog

Colors:

  • Green = Available
  • Yellow = Work in Progress (WIP), for docs: no documentation, but kernel code available
  • Red = Missing
  • Gray = Deprecated
  • Cyan = Not Available (N/A)
Chip Driver name Purpose Docs Driver Device Tree Firmware
Driver DTS
OMAP3430 System-on-chip OMAP34xx TRM Yes < 3.13 3.13
* Cortex A8 CPU ARM infocenter Yes < 3.13 3.13
* * ARMv7 Instruction set ARM infocenter Yes N/A
* * NEON Media Extensions ARM infocenter Yes N/A
* * Thumb Code compression ARM infocenter 2.6.12 N/A
* * Thumb2 Code compression ARM infocenter Yes 3.14-rc6 N/A
* * ThumbEE Instruction Set for JIT compilers ARM infocenter Yes N/A (Userspace: Java VM?)
* * VFP Floating-point coprocessor ARM infocenter 2.6.12 N/A
* cpuidle CPUidle C-states for RX-51 code v4.6-rc1 N/A
* cpufreq CPUfreq MPU OPP values (with overclock) for RX-51 code N/A N/A CPUfreq without overclock
* M-Shield AES omap-aes AES HW acceleration (needs updated X-Loader) code 2.6.37-rc1 3.13 3.13-rc3 (disabled)
* M-Shield SHA1/MD5 omap-sham SHA1 and MD5 HW acceleration code 2.6.35-rc1 4.2-rc1 4.1-rc2
* IOMMU omap-iommu OMAP3 IO Memory Management Unit OMAP34xx TRM Yes 3.15
* OMAP 3 Camera ISP omap3-isp OMAP3 Camera Chip Connection Bus OMAP34xx TRM 2.6.39-rc1 (broken) 4.1-rc1
* OMAP DSS omapdss Video HW abstraction layer OMAP34xx TRM Yes 3.15
* OMAP DRM omapdrm KMS video driver N/A 3.3-rc1 N/A
* TMS320 C64x tidspbridge DSP (also called IVA 2+) datasheet No (removed in v3.17-rc1 broken since 3.13-rc2) No
* * DSP patches for Maemo/N900 code WIP N/A
* PowerVR SGX530 pvrsrvkm omaplfb OpenGL ES and OpenVG acceleration kernel code (userspace is closed) Code exists, upstreaming not possible N/A
* OMAP Watchdog omap_wdt Watchdog OMAP34xx TRM 3.8 < 3.13 3.13
* OMAP MMC/SD/SDIO omap_hsmmc eMMC OMAP34xx TRM Yes < 3.13 3.13-rc3
* OMAP MMC/SD/SDIO omap_hsmmc SD/MMC card OMAP34xx TRM Yes < 3.13 3.13
* omap_hsmmc slot-name OMAP34xx TRM 4.7-rc1 4.7-rc1 currently not needed
* temp ti-soc-thermal OMAP34xx temperature sensor code v4.4-rc1 v4.4-rc1 v4.6-rc1
TI TWL4030 twl-core multifunction (I2C) TPS65950 TRM N/A < 3.13 3.13
* ??? Audio part of TI TWL4030 Yes 3.13
* twl4030-vibra Vibrator part of TI TWL4030 Yes < 3.13 3.13
* rtc-twl Real-Time Clock part of TI TWL4030 Yes < 3.13 3.13
* twl4030_wdt Watchdog part of TI TWL4030 3.8 < 3.13 3.13
* twl4030_keypad Keypad part of TI TWL4030 2.6.33 3.14 3.15
* twl4030_pwrbutton Power Button part of TI TWL4030 Yes 3.14 3.14
* twl4030_madc Analog Digital Converter part of TI TWL4030 Yes 3.15 3.16
musb musb USB Yes Yes Yes
* Forced host mode (via debugfs) WIP N/A
GPIO gpio-keys Camera button N/A Yes < 3.13 3.13
Taos TSL2563 tsl2563 Ambient light sensor datasheet 2.6.33 3.14 3.15
LP5523 leds-lp5523 LED driver documentation 2.6.37-rc2 3.13 3.13
Sony ACX565AKM panel-sony-acx565akm LCD panel code 2.6.35 3.15
TI TSC2005 tsc2005 Touchscreen controller datasheet 2.6.39-rc1 3.16 3.16
* Sysfs node for disabling device datasheet RFC PATCH N/A
WL1251 wl1251_spi wl1251 802.11b/g WiFi code 2.6.31 3.15-rc1 3.16 wl1251-fw.bin wl1251-nvs.bin
* Packet injection support code 3.14 N/A
* Permanent mac address code WIP N/A
* Bluetooth coexistence mode configuration code WIP N/A
Si4713 radio-si4713 si4713-i2c FM transmitter datasheet 2.6.32 3.19 3.19
TPA6130a2 snd-soc-tpa6130a2 Headphone amplifier datasheet 2.6.33 3.13-rc1 3.13
TLV320AIC3X snd-soc-tlv320aic3x Digital audio data serial ti.com 2.6.25 3.13 3.13
Board snd-soc-rx51 Sound SoC Wiring N/A Yes 3.16 3.16
* A/V cable detection In maemo fremantle kernel (nokia-av.c) No No
* Headset button In maemo fremantle kernel (nokia-av.c) No No
* All sound alsa switches and channels In maemo fremantle kernel No N/A
GPIO gpio-keys Proximity sensor N/A Yes < 3.13 3.13
Phonet phonet Modem protocol code 2.6.28 N/A
HSI hsi Modem Bus Framework code 3.4-rc2 N/A
Omap SSI omap-ssi Synchronous Serial Interface code 3.16 3.16 3.16
Modem n900-modem modem PM etc. code 3.16 3.16 3.16
* ssi-protocol ssi_protocol HSI client driver used by N900 code 3.16 N/A
* cmt-speech cmt_speech HSI client driver used by N900 code 4.1-rc1 N/A
* TI NaviLink NL5350 GPS (via Phonet modem protocol) reveng Userspace gps2.c
* A-GPS Uses SUPL Client SUPL application: http://www.tajuma.com/supl/index.html
rx51_battery rx51_battery Battery design capacity, battery temperature code 3.8 3.17 3.19
bq27200 bq27x00_battery Battery monitor chip documentation 2.6.28 < 3.13 3.13
isp1707a isp1704_charger USB charger detector datasheet 2.6.37-rc1 3.14 3.15
bq24150a bq2415x_charger Battery charger documentation 3.8 3.14 3.15
OneNAND onenand omap2 Flash memory code 2.6.15 < 3.13 3.13
LIS302DL lis3lv02d_i2c lis3lv02d Accelerometers datasheet 2.6.32 4.1-rc1 4.1-rc1
ADP 1653 adp1653 Flash Torch datasheet 3.1-rc1 4.2-rc1 v4.6-rc1
STM VS6555 smiapp Front Webcam datasheet 3.4-rc4 (broken) 4.0-rc1 No No firmware needed
ET8EK8 et8ek8 Main Camera datasheet WIP (broken) No, depends on omap3isp Firmware was integrated into driver (it was only data structure)
AD5820 ad5820 Autofocus datasheet for AD5821, which may be similar 4.9-rc1 No, depends on omap3isp
* AD5820_RAMP_TIME and AD5820_RAMP_MODE ctrls code WIP N/A
BCM2048 hci_h4p Bluetooth old code No (removed in v3.18-rc1) 3.15 (staging) No bcmfw.bin
* radio-bcm2048 FM/RDS receiver old code 3.14 (staging) WIP WIP
IR Diode on PWM GPIO ir-rx51 Infrared/CIR transmitter N/A 3.7-rc1 [1] 4.8-rc1 4.8-rc1 4.8-rc1
omap3-rom-rng omap3-rom-rng OMAP3 ROM Random Number Generator support code 3.13-rc2 3.16 currently not needed

Kernel git repository for N900

There is git repository for upstream linux kernel with all N900 patches.

https://github.com/pali/linux-n900

This git repository is used for development. All other git repositories on internet are older and does not contains all patches.

Kernel Compilation

export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabi-
make rx51_defconfig
make zImage modules

DT Kernel Compilation

Make sure this is enabled in the kernel configuration:

CONFIG_ARM_APPENDED_DTB=y
CONFIG_ARM_ATAG_DTB_COMPAT=y
CONFIG_ARM_ATAG_DTB_COMPAT_CMDLINE_EXTEND=y
CONFIG_PINCTRL_SINGLE=y
CONFIG_REGULATOR_TWL4030=y
CONFIG_REGULATOR_FIXED_VOLTAGE=y

Compile Kernel, Modules and DTB file:

export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabi-
make zImage
make modules
make omap3-n900.dtb

Create combined kernel image by appending the DTB file:

cat arch/arm/boot/zImage arch/arm/boot/dts/omap3-n900.dtb > zImage

Install Modules:

make INSTALL_MOD_PATH=/mnt/target modules_install

root problems in recent mainline

In recent mainline (cca 3.16+), it is impossible to use nfsroot over usb0 device. There's patch from Tony Lindgren fixing that.

Also for some strange reason, mmcblk? devices do not work for root filesystem. They work fine when mounted during runtime.

Bluetooth Status in Mainline Kernel

The bluetooth driver is currently available in drivers/staging/nokia_h4p. There is a TODO file in that directory, which lists the code refactoring needed to get the driver out of staging.

Apart from the things listed in that TODO file, the driver also seems to reinvent the wheel concerning the uart port. Most code in the driver simply configures the omap serial port and duplicates code in drivers/tty/serial/omap-serial.c.

sre thinks, that the hci protocol extension code should be put into a file similar to drivers/bluetooth/hci_ll.c, which could be called drivers/bluetooth/hci_nokia.c (hci with nokia extensions). This would result in the protocol being available as hci_uart_proto for usage in a hci-uart driver.

A second driver would be needed, which would be similar to drivers/bluetooth/hci_ldisc.c with the following differences:

  • support for additional gpios
  • support to be instanciated from DT instead of hciattach
  • support for loading bluetooth hardware address from DT
  • support for automatical loading of bt firmware (see btusb.c)

M-Shield

For M-Shield AES acceleration is needed updated signed bootloader X-Loader. Without it M-Shield crashing. SHA1 and MD5 acceleration work also without updating bootloader.

More info on: http://maemo.org/community/maemo-developers/n900_aes_and_sha1-md5_hw_acceleration_drivers/
Files are reuploaded at TMO thread: http://talk.maemo.org/showthread.php?p=1478502#post1478502

U-Boot

Instead of booting the kernel directly from NOLO (which restricts you to using exactly one kernel), U-Boot can be used as second bootloader. The Maemo kernel can be appended to U-Boot to keep the existing Maemo installation working (U-Boot must be located at the location of the Maemo kernel). The resulting boot process will end up like this: NOLO -> U-Boot -> Kernel.

Pali Rohár has been working on getting the N900 support into the mainline U-Boot:

description date status
Board Support 2012-10-29 mainline
Bootmenu Support 2013-03-07 mainline

Now all N900 patches are in upstream U-Boot mainline project (part of U-Boot 2013.04). Source code is on http://git.denx.de/?p=u-boot.git

Debian packaging for Maemo is in this git repository: https://gitorious.org/u-boot-shr/u-boot (branch maemo).

There's also a thread on talk.maemo.org, where the latest released & tested version can be found: http://talk.maemo.org/showthread.php?t=81613

More info about U-Boot on N900 is in first post.

Flashing

There is an open source flasher application called 0xFFFF, which is working with the Nokia N900.

Wireshark Plugin for PhoNet

A-GPS

  • Uses SUPL (Secure User Plane Location) protocol (see documentation at open mobile alliance)

A-GPS works by Modem requesting CPU to open a socket (it supplies domain/ip and port) [pkg type LS_SOCKET_OPEN_REQUEST_NTF]. Then the modem will continue by requesting to send some data using pkg type LS_SOCKET_SEND_REQUEST_NTF, followed by requesting to receive some data [pkg type LS_SOCKET_RECV_REQ]. Last but not least it will request to close the socket using LS_SOCKET_CLOSE_REQUEST_NTF. The wireshark plugin mentioned above can also be used to analyse A-GPS sessions (e.g. initialized by Maemo).