118 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			118 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* SPDX-License-Identifier: GPL-2.0-or-later */
 | |
| /*
 | |
|  * QMC management
 | |
|  *
 | |
|  * Copyright 2022 CS GROUP France
 | |
|  *
 | |
|  * Author: Herve Codina <herve.codina@bootlin.com>
 | |
|  */
 | |
| #ifndef __SOC_FSL_QMC_H__
 | |
| #define __SOC_FSL_QMC_H__
 | |
| 
 | |
| #include <linux/bits.h>
 | |
| #include <linux/types.h>
 | |
| 
 | |
| struct device_node;
 | |
| struct device;
 | |
| struct qmc_chan;
 | |
| 
 | |
| int qmc_chan_count_phandles(struct device_node *np, const char *phandles_name);
 | |
| 
 | |
| struct qmc_chan *qmc_chan_get_byphandles_index(struct device_node *np,
 | |
| 					       const char *phandles_name,
 | |
| 					       int index);
 | |
| struct qmc_chan *devm_qmc_chan_get_byphandles_index(struct device *dev,
 | |
| 						    struct device_node *np,
 | |
| 						    const char *phandles_name,
 | |
| 						    int index);
 | |
| 
 | |
| static inline struct qmc_chan *qmc_chan_get_byphandle(struct device_node *np,
 | |
| 						      const char *phandle_name)
 | |
| {
 | |
| 	return qmc_chan_get_byphandles_index(np, phandle_name, 0);
 | |
| }
 | |
| 
 | |
| static inline struct qmc_chan *devm_qmc_chan_get_byphandle(struct device *dev,
 | |
| 							   struct device_node *np,
 | |
| 							   const char *phandle_name)
 | |
| {
 | |
| 	return devm_qmc_chan_get_byphandles_index(dev, np, phandle_name, 0);
 | |
| }
 | |
| 
 | |
| struct qmc_chan *qmc_chan_get_bychild(struct device_node *np);
 | |
| void qmc_chan_put(struct qmc_chan *chan);
 | |
| 
 | |
| struct qmc_chan *devm_qmc_chan_get_bychild(struct device *dev, struct device_node *np);
 | |
| 
 | |
| enum qmc_mode {
 | |
| 	QMC_TRANSPARENT,
 | |
| 	QMC_HDLC,
 | |
| };
 | |
| 
 | |
| struct qmc_chan_info {
 | |
| 	enum qmc_mode mode;
 | |
| 	unsigned long rx_fs_rate;
 | |
| 	unsigned long rx_bit_rate;
 | |
| 	u8 nb_rx_ts;
 | |
| 	unsigned long tx_fs_rate;
 | |
| 	unsigned long tx_bit_rate;
 | |
| 	u8 nb_tx_ts;
 | |
| };
 | |
| 
 | |
| int qmc_chan_get_info(struct qmc_chan *chan, struct qmc_chan_info *info);
 | |
| 
 | |
| struct qmc_chan_ts_info {
 | |
| 	u64 rx_ts_mask_avail;
 | |
| 	u64 tx_ts_mask_avail;
 | |
| 	u64 rx_ts_mask;
 | |
| 	u64 tx_ts_mask;
 | |
| };
 | |
| 
 | |
| int qmc_chan_get_ts_info(struct qmc_chan *chan, struct qmc_chan_ts_info *ts_info);
 | |
| int qmc_chan_set_ts_info(struct qmc_chan *chan, const struct qmc_chan_ts_info *ts_info);
 | |
| 
 | |
| struct qmc_chan_param {
 | |
| 	enum qmc_mode mode;
 | |
| 	union {
 | |
| 		struct {
 | |
| 			u16 max_rx_buf_size;
 | |
| 			u16 max_rx_frame_size;
 | |
| 			bool is_crc32;
 | |
| 		} hdlc;
 | |
| 		struct {
 | |
| 			u16 max_rx_buf_size;
 | |
| 		} transp;
 | |
| 	};
 | |
| };
 | |
| 
 | |
| int qmc_chan_set_param(struct qmc_chan *chan, const struct qmc_chan_param *param);
 | |
| 
 | |
| int qmc_chan_write_submit(struct qmc_chan *chan, dma_addr_t addr, size_t length,
 | |
| 			  void (*complete)(void *context), void *context);
 | |
| 
 | |
| /* Flags available (ORed) for read complete() flags parameter in HDLC mode.
 | |
|  * No flags are available in transparent mode and the read complete() flags
 | |
|  * parameter has no meaning in transparent mode.
 | |
|  */
 | |
| #define QMC_RX_FLAG_HDLC_LAST	BIT(11) /* Last in frame */
 | |
| #define QMC_RX_FLAG_HDLC_FIRST	BIT(10) /* First in frame */
 | |
| #define QMC_RX_FLAG_HDLC_OVF	BIT(5)  /* Data overflow */
 | |
| #define QMC_RX_FLAG_HDLC_UNA	BIT(4)  /* Unaligned (ie. bits received not multiple of 8) */
 | |
| #define QMC_RX_FLAG_HDLC_ABORT	BIT(3)  /* Received an abort sequence (seven consecutive ones) */
 | |
| #define QMC_RX_FLAG_HDLC_CRC	BIT(2)  /* CRC error */
 | |
| 
 | |
| int qmc_chan_read_submit(struct qmc_chan *chan, dma_addr_t addr, size_t length,
 | |
| 			 void (*complete)(void *context, size_t length,
 | |
| 					  unsigned int flags),
 | |
| 			 void *context);
 | |
| 
 | |
| #define QMC_CHAN_READ  (1<<0)
 | |
| #define QMC_CHAN_WRITE (1<<1)
 | |
| #define QMC_CHAN_ALL   (QMC_CHAN_READ | QMC_CHAN_WRITE)
 | |
| 
 | |
| int qmc_chan_start(struct qmc_chan *chan, int direction);
 | |
| int qmc_chan_stop(struct qmc_chan *chan, int direction);
 | |
| int qmc_chan_reset(struct qmc_chan *chan, int direction);
 | |
| 
 | |
| #endif /* __SOC_FSL_QMC_H__ */
 |