linux/Documentation/devicetree/bindings/mailbox
Dave Gerlach 8e3c595214 mailbox/omap: Add ti,mbox-send-noirq quirk to fix AM33xx CPU Idle
The mailbox framework controls the transmission queue and requires
either its controller implementations or clients to run the state
machine for the Tx queue. The OMAP mailbox controller uses a Tx-ready
interrupt as the equivalent of a Tx-done interrupt to run this Tx
queue state-machine.

The WkupM3 processor on AM33xx and AM43xx SoCs is used to offload
certain PM tasks, like doing the necessary operations for Device
PM suspend/resume or for entering lower c-states during cpuidle.

The CPUIdle on AM33xx requires the messages to be sent without
having to trigger the Tx-ready interrupts, as the interrupt
would immediately terminate the CPUIdle operation. Support for
this has been added by introducing a DT quirk, "ti,mbox-send-noirq"
and using it to modify the normal OMAP mailbox controller behavior
on the sub-mailboxes used to communicate with the WkupM3 remote
processor. This also requires the wkup_m3_ipc driver to adjust
its mailbox usage logic to run the Tx state machine.

NOTE:
- AM43xx does not communicate with WkupM3 for CPU Idle, so is
  not affected by this behavior. But, it uses the same IPC driver
  for PM suspend/resume functionality, so requires the quirk as
  well, because of changes to the common wkup_m3_ipc driver.

Signed-off-by: Dave Gerlach <d-gerlach@ti.com>
[s-anna@ti.com: revise logic and update comments/patch description]
Signed-off-by: Suman Anna <s-anna@ti.com>
Signed-off-by: Jassi Brar <jaswinder.singh@linaro.org>
2015-10-23 11:19:27 +05:30
..
altera-mailbox.txt mailbox: Add Altera mailbox driver 2015-02-06 10:58:27 +05:30
arm-mhu.txt mailbox: arm_mhu: add driver for ARM MHU controller 2015-03-17 11:12:01 +05:30
brcm,bcm2835-mbox.txt dt/bindings: Add binding for the BCM2835 mailbox driver 2015-06-09 16:05:29 +05:30
mailbox.txt dt: mailbox: Remove 'mbox-names property is discouraged' message from binding 2015-06-11 22:19:46 +05:30
omap-mailbox.txt mailbox/omap: Add ti,mbox-send-noirq quirk to fix AM33xx CPU Idle 2015-10-23 11:19:27 +05:30
sti-mailbox.txt mailbox: dt: Supply bindings for ST's Mailbox IP 2015-10-17 10:36:56 +05:30