kernel_samsung_a34x-permissive/include/linux/soc/mediatek/mtk-mbox.h

321 lines
9 KiB
C
Raw Permalink Normal View History

/* SPDX-License-Identifier: GPL-2.0 */
/*
* Copyright (c) 2019 MediaTek Inc.
*/
#ifndef __MTK_MBOX_H__
#define __MTK_MBOX_H__
#include <linux/platform_device.h>
#include <linux/completion.h>
#include <linux/mutex.h>
#include <linux/spinlock.h>
/*
* mbox slot size definition
* 1 slot for 4 bytes
*/
#define MBOX_SLOT_SIZE 4
struct mtk_mbox_pin_send;
struct mtk_mbox_pin_recv;
typedef int (*mbox_rx_cb_t)(void *);
typedef int (*mbox_pin_cb_t)(unsigned int ipi_id, void *prdata, void *data,
unsigned int len);
typedef void (*mbox_ipi_cb_t)(struct mtk_mbox_pin_recv *, void *);
/*
* mbox receive information
*
* poll_count :mbox polling success count
* recv_irq_count :mbox receive irq count
* notify_count :mbox irq notify count
* cb_count :mbox execute callback function count
* pre_timestamp :time stamp before callback function
* post_timestamp :time stamp after callback function
*/
struct mtk_mbox_recv_record {
uint32_t poll_count;
uint32_t recv_irq_count;
uint32_t notify_count;
uint32_t cb_count;
uint64_t pre_timestamp;
uint64_t post_timestamp;
};
/*
* mbox send information
*
*/
struct mtk_mbox_send_record {
};
/*
* mbox record information
*
* write_count :mbox write success count
* busy_count :mbox read success count
* trig_irq_count :mbox trigger irq success count
*/
struct mtk_mbox_record {
uint32_t write_count;
uint32_t busy_count;
uint32_t trig_irq_count;
};
/*
* mbox pin structure, this is for send definition,
* ipi=endpoint=pin
* mbox : (mbox number)mbox number of the pin, up to 16(plt)
* offset : (slot)msg offset in share memory, up to 1024*4 KB(plt)
* send_opt : (opt)send opt, 0:send ,1: send for response(plt)
* lock : (lock)polling lock 0:unuse,1:used
* msg_size : (slot)message size in words, 4 bytes alignment(plt)
* pin_index : (bit offset)pin index in the mbox(plt)
* chan_id : (u32) ipc channel id(plt)
* mutex : (mutex)mutex for remote response
* completion : (completion)completion for remote response
* pin_lock : (spinlock_t)lock of the pin
* send_record: send pin record information
*/
struct mtk_mbox_pin_send {
unsigned int mbox : 4,
offset : 20,
send_opt : 2,
lock : 2;
unsigned int msg_size;
unsigned int pin_index;
unsigned int chan_id;
struct mutex mutex_send;
struct completion comp_ack; // to remove
spinlock_t pin_lock;
struct mtk_mbox_send_record send_record;
};
/*
* mbox pin structure, this is for receive definition,
* ipi=endpoint=pin
* mbox : (mbox number)mbox number of the pin, up to 16(plt)
* offset : (slot)msg offset in share memory, up to 1024*4 KB(plt)
* recv_opt : (opt)recv option, 0:receive ,1: response(plt)
* lock : (lock)polling lock 0:unuse,1:used
* buf_full_opt : (opt)buffer option 0:drop, 1:assert, 2:overwrite(plt)
* cb_ctx_opt : (opt)callback option 0:isr context, 1:process context(plt)
* msg_size : (slot)msg used slots in the mbox, 4 bytes alignment(plt)
* pin_index : (bit offset)pin index in the mbox(plt)
* chan_id : (u32) ipc channel id(plt)
* notify : (completion)notify process
* mbox_pin_cb: (cb)cb function
* pin_buf : (void*)buffer point
* prdata : (void*)private data
* pin_lock: (spinlock_t)lock of the pin
* recv_record: receive pin record information
*/
struct mtk_mbox_pin_recv {
unsigned int mbox : 4,
offset : 20,
recv_opt : 2,
lock : 2,
buf_full_opt : 2,
cb_ctx_opt : 2;
unsigned int msg_size;
unsigned int pin_index;
unsigned int chan_id;
struct completion notify;
mbox_pin_cb_t mbox_pin_cb;
void *pin_buf;
void *prdata;
spinlock_t pin_lock;
struct mtk_mbox_recv_record recv_record;
};
/*
* mtk mbox device,Mbox is a dedicate hardware of a tinysys consists of:
* 1) a share memory tightly coupled to the tinysys
* 2) several IRQs
*
* @ipi_cb: the callback handler for synchronization layer
* @ipi_priv: private data for synchronization layer
* @pre_cb: the callback handler in the begin of mbox receiving ipi
* @post_cb: the callback handler in the end of mbox receiving ipi
* @prdata: private data for the callback use
*/
struct mtk_mbox_device {
/* Identity of the device */
const char *name;
unsigned int id;
/* Following are platform specific interface*/
struct mtk_mbox_pin_recv *pin_recv_table;
struct mtk_mbox_pin_send *pin_send_table;
struct mtk_mbox_info *info_table;
unsigned int count;
unsigned int recv_count;
unsigned int send_count;
void (*memcpy_to_tiny)(void __iomem *dest, const void *src, int size);
void (*memcpy_from_tiny)(void *dest, const void __iomem *src, int size);
mbox_ipi_cb_t ipi_cb;
void *ipi_priv;
mbox_rx_cb_t pre_cb;
mbox_rx_cb_t post_cb;
void *prdata;
bool log_enable;
};
/*
* mbox callback function context definition
* 0: isr context, 1:process context
*/
enum MBOX_PIN_CTX {
MBOX_CB_IN_ISR = 0,
MBOX_CB_IN_PROCESS = 1,
};
/*
* mbox buffer full action definition
* 0:drop, 1:assert, 2:overwrite
*/
enum MBOX_BUF_OPT {
MBOX_BUF_FULL_DROP = 0,
MBOX_BUF_FULL_ASSERT = 1,
MBOX_BUF_FULL_OVERWRITE = 2,
MBOX_BUF_COPY_DONE = 3,
MBOX_BUF_FULL_RET = 4,
};
/*
* mbox recv action definition
* 0:receive message, 1:receive ack
*/
enum MBOX_RECV_OPT {
MBOX_RECV_MESSAGE = 0,
MBOX_RECV_ACK = 1,
};
/*
* mbox information
*
* mbdev :mbox device
* irq_num:identity of mbox irq
* id :mbox id
* slot :how many slots that mbox used
* opt :option for tx mode, 0:mbox, 1:share memory 2:queue
* enable :mbox status, 0:disable, 1: enable
* is64d :mbox is64d status, 0:32d, 1: 64d
* base :mbox base address
* set_irq_reg :mbox set irq register
* clr_irq_reg :mbox clear irq register
* init_base_reg:mbox initialize register
* mbox lock :lock of mbox
* record :mbox record information
*/
struct mtk_mbox_info {
struct mtk_mbox_device *mbdev;
int irq_num;
unsigned int id;
unsigned int slot;
unsigned int opt;
bool enable;
bool is64d;
void __iomem *base;
void __iomem *set_irq_reg;
void __iomem *clr_irq_reg;
void __iomem *init_base_reg;
void __iomem *send_status_reg;
void __iomem *recv_status_reg;
spinlock_t mbox_lock;
struct mtk_mbox_record record;
};
/*
* mbox return value definition
*/
enum MBOX_RETURN {
MBOX_POST_CB_ERR = -8,
MBOX_PRE_CB_ERR = -7,
MBOX_READ_SZ_ERR = -6,
MBOX_WRITE_SZ_ERR = -5,
MBOX_PARA_ERR = -4,
MBOX_CONFIG_ERR = -3,
MBOX_IRQ_ERR = -2,
MBOX_PLT_ERR = -1,
MBOX_DONE = 0,
MBOX_PIN_BUSY = 1,
};
/*
* mbox message options
* 0: mbox
* 1: share memory
* 2: mbox with queue
* 3: share memory with queue
*/
enum {
MBOX_OPT_DIRECT = 0,
MBOX_OPT_SMEM = 1,
MBOX_OPT_QUEUE_DIR = 2,
MBOX_OPT_QUEUE_SMEM = 3,
};
/*
* mtk ipi message header
*
* id :message id
* len :data length in byte
* options :options
* reserved :reserved
*/
struct mtk_ipi_msg_hd {
uint32_t id;
uint32_t len;
uint32_t options;
uint32_t reserved;
};
struct mtk_ipi_msg {
struct mtk_ipi_msg_hd ipihd;
void *data;
};
int mtk_mbox_write_hd(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int slot, void *msg);
int mtk_mbox_read_hd(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int slot, void *dest);
int mtk_mbox_write(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int slot, void *data, unsigned int len);
int mtk_mbox_read(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int slot, void *data, unsigned int len);
int mtk_mbox_clr_irq(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int irq);
int mtk_mbox_trigger_irq(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int irq);
unsigned int mtk_mbox_read_recv_irq(struct mtk_mbox_device *mbdev,
unsigned int mbox);
int mtk_mbox_set_base_addr(struct mtk_mbox_device *mbdev, unsigned int mbox,
unsigned int addr);
unsigned int mtk_mbox_check_send_irq(struct mtk_mbox_device *mbdev,
unsigned int mbox, unsigned int pin_index);
int mtk_mbox_probe(struct platform_device *pdev, struct mtk_mbox_device *mbdev,
unsigned int mbox);
int mtk_mbox_scp_probe(struct platform_device *pdev, struct mtk_mbox_device *mbdev,
unsigned int mbox);
int mtk_mbox_cb_register(struct mtk_mbox_device *mbdev, unsigned int pin_offset,
mbox_pin_cb_t mbox_pin_cb, void *prdata);
int mtk_mbox_polling(struct mtk_mbox_device *mbdev, unsigned int mbox,
void *data, struct mtk_mbox_pin_recv *pin_recv);
int mtk_smem_init(struct platform_device *pdev, struct mtk_mbox_device *mbdev,
unsigned int mbox, void __iomem *base,
void __iomem *set_irq_reg, void __iomem *clr_irq_reg,
void __iomem *send_status_reg, void __iomem *recv_status_reg);
void mtk_mbox_dump_all(struct mtk_mbox_device *mbdev);
void mtk_mbox_dump_recv(struct mtk_mbox_device *mbdev, unsigned int pin);
void mtk_mbox_dump_recv_pin(struct mtk_mbox_device *mbdev,
struct mtk_mbox_pin_recv *pin_recv);
void mtk_mbox_dump_send(struct mtk_mbox_device *mbdev, unsigned int pin);
void mtk_mbox_dump(struct mtk_mbox_device *mbdev, unsigned int mbox);
int mtk_mbox_log_enable(struct mtk_mbox_device *mbdev, bool enable);
void mtk_mbox_reset_record(struct mtk_mbox_device *mbdev);
#endif