linux-toradex.git/include/linux/firmware/imx, branch v5.12-rc5

firmware: imx-dsp: Export functions to request/free channels

2020-11-16T08:33:48+00:00

In order to save power, we only need to request a channel
when the communication with the DSP active.

For this we export the following functions:
	- imx_dsp_request_channel, gets a channel with a given index
	- imx_dsp_free_channel, frees a channel with a given index

Notice that we still request channels at probe to support devices
that do not have PM callbacks implemented.

More explanations about why requesting a channel has an effect
on power savings:
 - requesting an mailbox channel will call mailbox's startup
   function.
 - startup function calls pm_runtime_get_sync which increments device
   usage count and will keep the device active. Specifically, mailbox
   clock will be always ON when a mailbox channel is requested.

Signed-off-by: Daniel Baluta 
Reviewed-by: Paul Olaru 
Signed-off-by: Shawn Guo

firmware: imx: add dummy functions

2020-10-28T08:59:40+00:00

add dummy functions to avoid build failure when header files
are included, but drivers are not built.

Signed-off-by: Peng Fan 
Signed-off-by: Shawn Guo

firmware: imx: Move i.MX SCU soc driver into imx firmware folder

2020-07-13T02:02:00+00:00

The i.MX SCU soc driver depends on SCU firmware driver, so it has to
use platform driver model for proper defer probe operation, since
it has no device binding in DT file, a simple platform device is
created together inside the platform driver. To make it more clean,
we can just move the entire SCU soc driver into imx firmware folder
and initialized by i.MX SCU firmware driver.

Signed-off-by: Anson Huang 
Signed-off-by: Shawn Guo

firmware: imx: add resource management api

2020-06-23T07:37:56+00:00

Add resource management API, when we have multiple
partition running together, resources not owned to current
partition should not be used.

Reviewed-by: Leonard Crestez 
Reviewed-by: Dong Aisheng 
Signed-off-by: Peng Fan 
Signed-off-by: Shawn Guo

dt-bindings: firmware: imx: Move system control into dt-binding headfile

2020-05-13T08:19:23+00:00

i.MX8 SoCs DTS file needs system control macro definitions, so move them
into dt-binding headfile, then include/linux/firmware/imx/types.h can be
removed and those drivers using it should be changed accordingly.

Signed-off-by: Dong Aisheng 
Signed-off-by: Jacky Bai 
Signed-off-by: Anson Huang 
Signed-off-by: Shawn Guo

firmware: imx: Remove IMX_SC_RPC_SVC_ABORT

2020-02-24T06:46:35+00:00

This is not used by linux and not supported as part of imx SCU api, it
was added by mistake.

The constant value "9" has since been reassigned in firmware to a
different service.

Signed-off-by: Leonard Crestez 
Signed-off-by: Shawn Guo

firmware: imx: Add DSP IPC protocol interface

2019-08-12T13:19:25+00:00

Some of i.MX8 processors (e.g i.MX8QM, i.MX8QXP) contain
the Tensilica HiFi4 DSP for advanced pre- and post-audio
processing.

The communication between Host CPU and DSP firmware is
taking place using a shared memory area for message passing
and a dedicated Messaging Unit for notifications.

DSP IPC protocol offers a doorbell interface using
imx-mailbox API.

We use 4 MU channels (2 x TXDB, 2 x RXDB) to implement a
request-reply protocol.

Connection 0 (txdb0, rxdb0):
        - Host writes messasge to shared memory [SHMEM]
	- Host sends a request [MU]
	- DSP handles request [SHMEM]
	- DSP sends reply [MU]

Connection 1 (txdb1, rxdb1):
	- DSP writes a message to shared memory [SHMEM]
	- DSP sends a request [MU]
	- Host handles request [SHMEM]
	- Host sends reply [MU]

The protocol interface will be used by a Host client to
communicate with the DSP. First client will be the i.MX8
part from Sound Open Firmware infrastructure.

The protocol offers the following interface:

On Tx:
   - imx_dsp_ring_doorbell, will be called to notify the DSP
   that it needs to handle a request.

On Rx:
   - clients need to provide two callbacks:
	.handle_reply
	.handle_request
  - the callbacks will be used by the protocol on
    notification arrival from DSP.

Signed-off-by: Daniel Baluta 
Reviewed-by: Oleksij Rempel 
Signed-off-by: Shawn Guo

firmware: imx: enable imx scu general irq function

2019-04-11T07:31:02+00:00

The System Controller Firmware (SCFW) controls RTC, thermal
and WDOG etc., these resources' interrupt function are managed
by SCU. When any IRQ pending, SCU will notify Linux via MU general
interrupt channel #3, and Linux kernel needs to call SCU APIs
to get IRQ status and notify each module to handle the interrupt.

Since there is no data transmission for SCU IRQ notification, so
doorbell mode is used for this MU channel, and SCU driver will
use notifier mechanism to broadcast to every module which registers
the SCU block notifier.

Signed-off-by: Anson Huang 
Reviewed-by: Dong Aisheng 
Signed-off-by: Shawn Guo

firmware: imx: Add support to start/stop a CPU

2019-02-11T02:00:47+00:00

This is done via RPC call to SCU.

Signed-off-by: Daniel Baluta 
Reviewed-by: Dong Aisheng 
Signed-off-by: Shawn Guo

firmware: imx: add pm svc headfile

2018-11-14T01:20:44+00:00

Add SCU PM SVC related protocol definitions which will be used by
a number of PM functions like Power Domain, Clock, Reset and etc.
The detailed implementation of each function will put in the individual
function drivers.

Cc: Shawn Guo 
Cc: Sascha Hauer 
Reviewed-by: Ulf Hansson 
Signed-off-by: Dong Aisheng 
Signed-off-by: Shawn Guo