include: Add snapshot of header files for wcd spi and dsp manager

/* SPDX-License-Identifier: GPL-2.0-only */

/*

 * Copyright (c) 2016-2019, The Linux Foundation. All rights reserved.

 */

#ifndef __WCD_DSP_MGR_H__

#define __WCD_DSP_MGR_H__

#include <linux/types.h>

#include <linux/device.h>

/*

 * These enums correspond to the component types

 * that wcd-dsp-manager driver will use. The order

 * of the enums specifies the order in which the

 * manager driver will perform the sequencing.

 * Changing this will cause the sequencing order

 * to be changed as well.

 */

enum wdsp_cmpnt_type {

	/* Component to control the DSP */

	WDSP_CMPNT_CONTROL = 0,

	/* Component to perform data transfer to/from DSP */

	WDSP_CMPNT_TRANSPORT,

	/* Component that performs high level IPC */

	WDSP_CMPNT_IPC,

	WDSP_CMPNT_TYPE_MAX,

};

enum wdsp_event_type {

	/* Initialization related */

	WDSP_EVENT_POST_INIT,

	/* Image download related */

	WDSP_EVENT_PRE_DLOAD_CODE,

	WDSP_EVENT_DLOAD_SECTION,

	WDSP_EVENT_POST_DLOAD_CODE,

	WDSP_EVENT_PRE_DLOAD_DATA,

	WDSP_EVENT_POST_DLOAD_DATA,

	WDSP_EVENT_DLOAD_FAILED,

	WDSP_EVENT_READ_SECTION,

	/* DSP boot related */

	WDSP_EVENT_PRE_BOOTUP,

	WDSP_EVENT_DO_BOOT,

	WDSP_EVENT_POST_BOOTUP,

	WDSP_EVENT_PRE_SHUTDOWN,

	WDSP_EVENT_DO_SHUTDOWN,

	WDSP_EVENT_POST_SHUTDOWN,

	/* IRQ handling related */

	WDSP_EVENT_IPC1_INTR,

	/* Suspend/Resume related */

	WDSP_EVENT_SUSPEND,

	WDSP_EVENT_RESUME,

	/* Misc */

	WDSP_EVENT_GET_DEVOPS

};

enum wdsp_signal {

	/* Hardware generated interrupts signalled to manager */

	WDSP_IPC1_INTR,

	WDSP_ERR_INTR,

	/* Other signals */

	WDSP_CDC_DOWN_SIGNAL,

	WDSP_CDC_UP_SIGNAL,

	/* Software generated signal indicating debug dumps to be collected */

	WDSP_DEBUG_DUMP,

	WDSP_DEBUG_DUMP_INTERNAL,

};

/*

 * wdsp_cmpnt_ops: ops/function callbacks for components

 * @init: called by manager driver, component is expected

 *	  to initialize itself in this callback

 * @deinit: called by manager driver, component should

 *	    de-initialize itself in this callback

 * @event_handler: Event handler for each component, called

 *		   by the manager as per sequence

 */

struct wdsp_cmpnt_ops {

	int (*init)(struct device *dev, void *priv_data);

	int (*deinit)(struct device *dev, void *priv_data);

	int (*event_handler)(struct device *dev, void *priv_data,

			     enum wdsp_event_type, void *data);

};

struct wdsp_img_section {

	u32 addr;

	size_t size;

	u8 *data;

};

struct wdsp_err_signal_arg {

	bool mem_dumps_enabled;

	u32 remote_start_addr;

	size_t dump_size;

};

/*

 * wdsp_ops: ops/function callbacks for manager driver

 * @register_cmpnt_ops: components will use this to register

 *			their own ops to manager driver

 * @get_dev_for_cmpnt: components can use this to get handle

 *		       to struct device * of any other component

 * @get_devops_for_cmpnt: components can use this to get ops

 *			  from other related components.

 * @signal_handler: callback to notify manager driver that signal

 *		    has occurred. Cannot be called from interrupt

 *		    context as this can sleep

 * @vote_for_dsp: notifies manager that dsp should be booted up

 * @suspend: notifies manager that one component wants to suspend.

 *	     Manager will make sure to suspend all components in order

 * @resume: notifies manager that one component wants to resume.

 *	    Manager will make sure to resume all components in order

 */

struct wdsp_mgr_ops {

	int (*register_cmpnt_ops)(struct device *wdsp_dev,

				  struct device *cdev,

				  void *priv_data,

				  struct wdsp_cmpnt_ops *ops);

	struct device *(*get_dev_for_cmpnt)(struct device *wdsp_dev,

					    enum wdsp_cmpnt_type type);

	int (*get_devops_for_cmpnt)(struct device *wdsp_dev,

				    enum wdsp_cmpnt_type type, void *data);

	int (*signal_handler)(struct device *wdsp_dev,

			      enum wdsp_signal signal, void *arg);

	int (*vote_for_dsp)(struct device *wdsp_dev, bool vote);

	int (*suspend)(struct device *wdsp_dev);

	int (*resume)(struct device *wdsp_dev);

};

int wcd_dsp_mgr_init(void);

void wcd_dsp_mgr_exit(void);

#endif /* end of __WCD_DSP_MGR_H__ */

/* SPDX-License-Identifier: GPL-2.0-only */

/*

 * Copyright (c) 2016-2019, The Linux Foundation. All rights reserved.

 */

#ifndef __WCD_SPI_H__

#define __WCD_SPI_H__

struct wcd_spi_msg {

	/*

	 * Caller's buffer pointer that holds data to

	 * be transmitted in case of data_write and

	 * data to be copied to in case of data_read.

	 */

	void *data;

	/* Length of data to write/read */

	size_t len;

	/*

	 * Address in remote memory to write to

	 * or read from.

	 */

	u32 remote_addr;

	/* Bitmask of flags, currently unused */

	u32 flags;

};

struct wcd_spi_ops {

	struct spi_device *spi_dev;

	int (*read_dev)(struct spi_device *spi, struct wcd_spi_msg *msg);

	int (*write_dev)(struct spi_device *spi, struct wcd_spi_msg *msg);

};

#endif /* End of __WCD_SPI_H__ */