N900 Hardware USB

(The Circuit)
(USB Phy: FUSB2600)
 
(27 intermediate revisions not shown)
Line 26: Line 26:
====USB battery charger====
====USB battery charger====
-
The [http://focus.ti.com/docs/prod/folders/print/bq24150.html bq24150] charger from TI is a flexible charger. It, along with the PHY chip - support charging without the intervention of the SoC when the system is charging from a completely dead battery. The PHY chip detects a charger (shorted D+ and D- pins) and the charger uses this information to charge more rapidly.
+
The [http://focus.ti.com/docs/prod/folders/print/bq24150a.html bq24150a] charger from TI is a flexible charger. It, along with the PHY chip - support charging without the intervention of the SoC when the system is charging from a completely dead battery. The PHY chip detects a charger (shorted D+ and D- pins) and the charger uses this information to charge more rapidly.
It also features reverse boost mode - which enables power to be supplied to a USB device connected to the N900. (up to a limit of 200mA)  
It also features reverse boost mode - which enables power to be supplied to a USB device connected to the N900. (up to a limit of 200mA)  
Line 38: Line 38:
There is no published datasheet for this chip. It may be available under another name.
There is no published datasheet for this chip. It may be available under another name.
-
A reasonably similar chip (compare chips: [http://www.ebv.com/fileadmin/products/Products/ST-Ericsson/Flyer_USB_Transceivers_1.pdf]) is the 1704 which has a datasheet [http://www.stericsson.com/sales_marketing_resources/CD00222700.pdf]
+
A reasonably similar chip (compare chips: [http://www.ebv.com/fileadmin/products/Products/ST-Ericsson/Flyer_USB_Transceivers_1.pdf]) is the 1704 which has a datasheet [http://www.stericsson.com/technical_documents/CD00222700.pdf
 +
 
 +
Another equivalent chip seems to be the https://www.startpage.com/do/search?query=FUSB2500 - see http://talk.maemo.org/showthread.php?p=643577#post643577
 +
 
 +
For more information see [[N900 Hardware USB PHY]]
===The Circuit===
===The Circuit===
-
* The SoC has the USB protocol controller - this is the 'high level' controller - it implements most of the USB protocol.
+
* The SoC has the USB protocol controller - this is the 'high level' controller - it implements most of the USB protocol. This is a [http://www.mentor.com/products/ip/usb/usb20otg/ Mentorgrafix MUSBMHDRC-core] IntelectualProperty function block licenced for the OMAP.
* The PHY (physical layer) chip connects to the world through the USB socket. This is not the normal companion chip - but the NXP part, and is connected to the SoC via a standard ULPI interface. It does the very lowest level USB hardware protocol. Also it detects chargers (by sensing D+/D- short). It also has a connection to VBUS, via a 1k resistor, to do certain probing.
* The PHY (physical layer) chip connects to the world through the USB socket. This is not the normal companion chip - but the NXP part, and is connected to the SoC via a standard ULPI interface. It does the very lowest level USB hardware protocol. Also it detects chargers (by sensing D+/D- short). It also has a connection to VBUS, via a 1k resistor, to do certain probing.
-
* The [[N900 Hardware Battery Charger|bq24150 Battery charger]]. This is connected to the battery, and the PHY chip, as well as to the SoC though I2C. It handles (with the PHY chip) charging from dead. It also implements boost mode, to enable powering things through the USB socket. Of course it detects when external VBUS is applied.
+
* The [[N900 Hardware Battery Charger|bq24150a Battery charger]]. This is connected to the battery, and the PHY chip, as well as to the SoC though I2C. It handles (with the PHY chip) charging from dead. It also implements boost mode, to enable powering things through the USB socket. Of course it detects when external VBUS is applied.
-
* Gaia. The [[N900_Hardware_Power_management/I2C|TWL4030]] is used to sense the value of the ID pin. It also has a connection to VBUS, to power up the device on charger insertion and inform a running system about changes in VBUS state.
+
* Gaia. The [[N900_Hardware_Power_management/I2C|TWL4030]] is used to sense the value of the ID pin. It also has a connection to VBUS, to power up the device on charger insertion and inform a running system about changes in VBUS state. Though TWL4030 has a function similar to PHY chip as well, the original design using this function had to change as early chip revisions had problems with charger detection (so the rumour). Driver sourecode is full of cruft from that original design.
===The Software===
===The Software===
-
* [[N900 Software BME|BME]] - the battery managment entity. This has its hands in everything, especially the bq24150, and is split into
+
* [[N900 Software BME|BME]] - the battery managment entity. This has its hands in everything, especially the bq24150a, and is split into
-
** BME - kernel
+
** charger detection (via PHY) in kernel MUSB_HDRC driver, exposing /sys/devices/platform/musb_hdrc/charger
** BME - userspace driver for the charger chip, as well as monitoring battery voltage through Gaia.
** BME - userspace driver for the charger chip, as well as monitoring battery voltage through Gaia.
** Hald-addon-bme - a small helper program to interface between HAL and BME.
** Hald-addon-bme - a small helper program to interface between HAL and BME.
Line 59: Line 63:
==Host mode details.==
==Host mode details.==
-
Host mode works, see [http://talk.maemo.org/showpost.php?p=656408&postcount=852 this post by egoshin on talk.maemo.org]. He has succeeded in mounting a USB stick using an externally powered hub.
+
Host mode works, see [http://talk.maemo.org/showthread.php?p=901888#post901888 this thread] Mohammad started on talk.maemo.org, when releasing first beta of a package comprising of a hostmode patched kernel build by Paul Fertser with support of h-e-n team, and a lean GUI built by Mohammad. The basic functionality seems to work fine.
   
   
-
A [[N900_Hardware_USB_Host|user friendly implementation]] that makes it easy to use host mode is some way off.
+
A [[N900_Hardware_USB_Host|user friendly implementation]] that makes it easy to use host mode needs a lot more than this, e.g. proper automounting, clean unmounting and sync, drivers for all kinds of peripherals etc.
A USB OTG controller would normally switch between host and device mode (initially) using the ID pin, to detect if it's at the A or B-side of a OTG cable.  
A USB OTG controller would normally switch between host and device mode (initially) using the ID pin, to detect if it's at the A or B-side of a OTG cable.  
Initially it was claimed that ID is not connected externally, and that this made USB host mode impossible.
Initially it was claimed that ID is not connected externally, and that this made USB host mode impossible.
 +
 +
While this is mostly correct, it needs some exemplification:
 +
* the ID pin is not connected to PHY, but it is connected to GAIA
 +
* MUSB-core has a hw statemachine that reacts on a telegram from PHY, telling MUSB-core about ID pin grounded and to enter OTG_A hostmode now.
 +
* Other PHY chips (e.g. in N810) have a command to make them send this telegram, so you can switch MUSB-core to hostmode under software control (go figure!). 1707 is missing this function.
 +
* There is apparently no way to tell MUSB-core directly to switch to hostmode in a natural way.
 +
* However there is a bit in MUSB-core registers called FORCE_HOST, which is switching MUSB-core into a semi-lobotomized test mode and allowed us to implement h-e-n.
 +
 +
===the following text needs update, it doesn't represent current state of investigation results anymore (corrections in ''(italic)'')===
However, similar device datasheets indicate that the ID pin is used on hardware that supports it to switch between host and device mode.
However, similar device datasheets indicate that the ID pin is used on hardware that supports it to switch between host and device mode.
-
But, importantly, the ID pin does nothing directly to the state of the PHY. It simply informs the CPU of the state of the ID pin, and leaves the driver to properly configure the chip (nota bene, only for OTG, and only for determining the inital state).
+
But, importantly, the ID pin does nothing directly to the state of the PHY. It simply informs the CPU ''(the MUSB-core)'' of the state of the ID pin, and leaves the driver to properly configure the chip (nota bene, only for OTG, and only for determining the inital state).
-
So, if the kernel can be altered to ignore this pin - which should be trivial if there is host mode support for the chip in the kernel - then host mode works.(the related sourcecode is to be found here:[http://mxr.maemo.org/fremantle/source/kernel/drivers/usb/musb/musb_core.c#2010], a 'echo host >mode' should work if the kernel driver wasn't crippled in some strange way)
+
So, if the kernel can be altered to ignore this pin - which should be trivial if there is host mode support for the chip in the kernel ''(the hw statemachine in MUSB-core won't play nice with whatever kernel does to enable hostmode in a "normal" way)''- then host mode works.(the related sourcecode is to be found here:[http://mxr.maemo.org/fremantle/source/kernel/drivers/usb/musb/musb_core.c#2010], a 'echo host >mode' should work if the kernel driver wasn't crippled in some strange way)''(h-e-n kernel hostmode now is working like this, but still needs another 'echo Fx >/proc/drivers/musb-hdrc' where 'x' is depending on speed. The kernel is "crippled" in a way it can not send a command to PHY to switch to hostmode, as the 1707 '''seems''' doesn't support this - further investigation needed, maybe it has this command but it isn't documented. Or we can spoof this command rsp the resulting telegram)''
The current understanding by several people who are working on USB host mode is:
The current understanding by several people who are working on USB host mode is:
Line 77: Line 90:
The USB port can supply power - at least 200mA (as demonstrated here:[http://talk.maemo.org/showthread.php?p=588950#post588950]). This is plenty for many devices - mice and keyboards.
The USB port can supply power - at least 200mA (as demonstrated here:[http://talk.maemo.org/showthread.php?p=588950#post588950]). This is plenty for many devices - mice and keyboards.
-
It seems likely that a relatively simple kernel change should enable USB hostmode - http://focus.ti.com/lit/ug/spruf98d/spruf98d.pdf - search for FORCE_HOST - there may well be other cleaner solutions.
+
It seems likely that a relatively simple kernel change should enable USB hostmode - http://focus.ti.com/lit/ug/spruf98d/spruf98d.pdf - search for FORCE_HOST - there may well be other cleaner solutions. ''(h-e-n is exploiting this. About the "relatively simple" part that's up to your discretion)
 +
''
A possibly related errata is detailed at 3.1.3 in [http://focus.ti.com/lit/er/sprz278d/sprz278d.pdf this document] - this, and other erratas may or may not cause issues with implementing host mode.
A possibly related errata is detailed at 3.1.3 in [http://focus.ti.com/lit/er/sprz278d/sprz278d.pdf this document] - this, and other erratas may or may not cause issues with implementing host mode.
Line 85: Line 99:
{{main|N900 Hardware USB Socket}}
{{main|N900 Hardware USB Socket}}
-
[[Category:N900_Hardware]]
+
===Compatible devices===
 +
 
 +
{| class="wikitable sortable"
 +
|+ Compatible USB devices
 +
|-
 +
! USB device name
 +
! Status
 +
! class="unsortable" | Additional information
 +
! Additional driver needed
 +
! class="unsortable" | Discussion link
 +
|-
 +
| Edimax EU-4207 || Working || no problems found || <code>no</code> || http://talk.maemo.org/showthread.php?t=66667
 +
|-
 +
| ZTE-AC2766 || Working || no problems || <code>no, uses usbserial.ko</code> || http://talk.maemo.org/showpost.php?p=1198785&postcount=13
 +
|-
 +
|}
 +
 
 +
[[Category:N900 Hardware]]

Latest revision as of 04:01, 21 August 2018

The USB connector on the N900 is a micro-b connector, as now required in European and Chinese markets, under the scheme to make all phone charger sockets identical.

Contents

[edit] USB implementation

The N900 seems initially to have been designed to be capable of acting as a USB host, or implementing OSG mode. This would have allowed keyboards, mice, and other peripherals to be plugged in.

The USB port with embedded host mode could not be certified, as the OTG drivers were not ready. (see [1] last block).

This lead to the the micro-AB USB connector being replaced by a micro-B, and the host functionality being officially removed short time before launch.

Lacking certification would have a large number of issues, from some operating systems requiring certification before allowing drivers to be distributed, to legal compliance with the USB charger specs - it would technically not be a USB port.

[edit] The Chips

There are four chips involved in the USB subsystem.

[edit] SoC

The System-on-a-chip is the main processor on the n900. This is the TI omap3430

[edit] Gaia

The TWL4030 is a TI companion chip to the SoC

[edit] USB battery charger

The bq24150a charger from TI is a flexible charger. It, along with the PHY chip - support charging without the intervention of the SoC when the system is charging from a completely dead battery. The PHY chip detects a charger (shorted D+ and D- pins) and the charger uses this information to charge more rapidly.

It also features reverse boost mode - which enables power to be supplied to a USB device connected to the N900. (up to a limit of 200mA)

For more information see N900 Hardware Battery Charger

[edit] USB Phy

The NXP isp1707a is used as the USB PHY chip. [2]. This rights to this part have been bought by ST-Ericson and some information is available in a brief marketing sheet.

There is no published datasheet for this chip. It may be available under another name.

A reasonably similar chip (compare chips: [3]) is the 1704 which has a datasheet [4]

Another equivalent chip seems to be the https://www.startpage.com/do/search?query=FUSB2500 - see http://talk.maemo.org/showthread.php?p=643577#post643577

For more information see N900 Hardware USB PHY

[edit] The Circuit

  • The SoC has the USB protocol controller - this is the 'high level' controller - it implements most of the USB protocol. This is a Mentorgrafix MUSBMHDRC-core IntelectualProperty function block licenced for the OMAP.
  • The PHY (physical layer) chip connects to the world through the USB socket. This is not the normal companion chip - but the NXP part, and is connected to the SoC via a standard ULPI interface. It does the very lowest level USB hardware protocol. Also it detects chargers (by sensing D+/D- short). It also has a connection to VBUS, via a 1k resistor, to do certain probing.
  • The bq24150a Battery charger. This is connected to the battery, and the PHY chip, as well as to the SoC though I2C. It handles (with the PHY chip) charging from dead. It also implements boost mode, to enable powering things through the USB socket. Of course it detects when external VBUS is applied.
  • Gaia. The TWL4030 is used to sense the value of the ID pin. It also has a connection to VBUS, to power up the device on charger insertion and inform a running system about changes in VBUS state. Though TWL4030 has a function similar to PHY chip as well, the original design using this function had to change as early chip revisions had problems with charger detection (so the rumour). Driver sourecode is full of cruft from that original design.

[edit] The Software

  • BME - the battery managment entity. This has its hands in everything, especially the bq24150a, and is split into
    • charger detection (via PHY) in kernel MUSB_HDRC driver, exposing /sys/devices/platform/musb_hdrc/charger
    • BME - userspace driver for the charger chip, as well as monitoring battery voltage through Gaia.
    • Hald-addon-bme - a small helper program to interface between HAL and BME.
  • Kernel driver.
    • This seems to be a partially implemented OTG driver for the initial design of the N900, with OTG mode partially implemented, assuming that the twl4030 would be used as the USB PHY. It seems to have been modified only to the extent required to make the NXP PHY work as a replacement.

[edit] Host mode details.

Host mode works, see this thread Mohammad started on talk.maemo.org, when releasing first beta of a package comprising of a hostmode patched kernel build by Paul Fertser with support of h-e-n team, and a lean GUI built by Mohammad. The basic functionality seems to work fine.

A user friendly implementation that makes it easy to use host mode needs a lot more than this, e.g. proper automounting, clean unmounting and sync, drivers for all kinds of peripherals etc.

A USB OTG controller would normally switch between host and device mode (initially) using the ID pin, to detect if it's at the A or B-side of a OTG cable.

Initially it was claimed that ID is not connected externally, and that this made USB host mode impossible.

While this is mostly correct, it needs some exemplification:

  • the ID pin is not connected to PHY, but it is connected to GAIA
  • MUSB-core has a hw statemachine that reacts on a telegram from PHY, telling MUSB-core about ID pin grounded and to enter OTG_A hostmode now.
  • Other PHY chips (e.g. in N810) have a command to make them send this telegram, so you can switch MUSB-core to hostmode under software control (go figure!). 1707 is missing this function.
  • There is apparently no way to tell MUSB-core directly to switch to hostmode in a natural way.
  • However there is a bit in MUSB-core registers called FORCE_HOST, which is switching MUSB-core into a semi-lobotomized test mode and allowed us to implement h-e-n.

[edit] the following text needs update, it doesn't represent current state of investigation results anymore (corrections in (italic))

However, similar device datasheets indicate that the ID pin is used on hardware that supports it to switch between host and device mode.

But, importantly, the ID pin does nothing directly to the state of the PHY. It simply informs the CPU (the MUSB-core) of the state of the ID pin, and leaves the driver to properly configure the chip (nota bene, only for OTG, and only for determining the inital state).

So, if the kernel can be altered to ignore this pin - which should be trivial if there is host mode support for the chip in the kernel (the hw statemachine in MUSB-core won't play nice with whatever kernel does to enable hostmode in a "normal" way)- then host mode works.(the related sourcecode is to be found here:[5], a 'echo host >mode' should work if the kernel driver wasn't crippled in some strange way)(h-e-n kernel hostmode now is working like this, but still needs another 'echo Fx >/proc/drivers/musb-hdrc' where 'x' is depending on speed. The kernel is "crippled" in a way it can not send a command to PHY to switch to hostmode, as the 1707 seems doesn't support this - further investigation needed, maybe it has this command but it isn't documented. Or we can spoof this command rsp the resulting telegram)

The current understanding by several people who are working on USB host mode is:

The USB port can supply power - at least 200mA (as demonstrated here:[6]). This is plenty for many devices - mice and keyboards.

It seems likely that a relatively simple kernel change should enable USB hostmode - http://focus.ti.com/lit/ug/spruf98d/spruf98d.pdf - search for FORCE_HOST - there may well be other cleaner solutions. (h-e-n is exploiting this. About the "relatively simple" part that's up to your discretion)

A possibly related errata is detailed at 3.1.3 in this document - this, and other erratas may or may not cause issues with implementing host mode.

[edit] USB socket

Main article: N900 Hardware USB Socket


[edit] Compatible devices

Compatible USB devices
USB device name Status Additional information Additional driver needed Discussion link
Edimax EU-4207 Working no problems found no http://talk.maemo.org/showthread.php?t=66667
ZTE-AC2766 Working no problems no, uses usbserial.ko http://talk.maemo.org/showpost.php?p=1198785&postcount=13