Home | History | Annotate | Download | only in include
      1 /* SPDX-License-Identifier: GPL-2.0+ */
      2 /*
      3  * Copyright (C) 2006-2009 Freescale Semiconductor, Inc.
      4  *
      5  * Dave Liu <daveliu (at) freescale.com>
      6  * based on source code of Shlomi Gridish
      7  */
      8 
      9 #ifndef __QE_H__
     10 #define __QE_H__
     11 
     12 #include "common.h"
     13 #ifdef CONFIG_U_QE
     14 #include <linux/immap_qe.h>
     15 #endif
     16 
     17 #define QE_NUM_OF_BRGS	16
     18 #define UCC_MAX_NUM	8
     19 
     20 #define QE_DATAONLY_BASE	0
     21 #define QE_DATAONLY_SIZE	(QE_MURAM_SIZE - QE_DATAONLY_BASE)
     22 
     23 /* QE threads SNUM
     24 */
     25 typedef enum qe_snum_state {
     26 	QE_SNUM_STATE_USED,   /* used */
     27 	QE_SNUM_STATE_FREE    /* free */
     28 } qe_snum_state_e;
     29 
     30 typedef struct qe_snum {
     31 	u8		num;   /* snum	*/
     32 	qe_snum_state_e	state; /* state */
     33 } qe_snum_t;
     34 
     35 /* QE RISC allocation
     36 */
     37 #define	QE_RISC_ALLOCATION_RISC1	0x1  /* RISC 1 */
     38 #define	QE_RISC_ALLOCATION_RISC2	0x2  /* RISC 2 */
     39 #define	QE_RISC_ALLOCATION_RISC3	0x4  /* RISC 3 */
     40 #define	QE_RISC_ALLOCATION_RISC4	0x8  /* RISC 4 */
     41 #define	QE_RISC_ALLOCATION_RISC1_AND_RISC2 	(QE_RISC_ALLOCATION_RISC1 | \
     42 						 QE_RISC_ALLOCATION_RISC2)
     43 #define	QE_RISC_ALLOCATION_FOUR_RISCS	(QE_RISC_ALLOCATION_RISC1 | \
     44 					 QE_RISC_ALLOCATION_RISC2 | \
     45 					 QE_RISC_ALLOCATION_RISC3 | \
     46 					 QE_RISC_ALLOCATION_RISC4)
     47 
     48 /* QE CECR commands for UCC fast.
     49 */
     50 #define QE_CR_FLG			0x00010000
     51 #define QE_RESET			0x80000000
     52 #define QE_INIT_TX_RX			0x00000000
     53 #define QE_INIT_RX			0x00000001
     54 #define QE_INIT_TX			0x00000002
     55 #define QE_ENTER_HUNT_MODE		0x00000003
     56 #define QE_STOP_TX			0x00000004
     57 #define QE_GRACEFUL_STOP_TX		0x00000005
     58 #define QE_RESTART_TX			0x00000006
     59 #define QE_SWITCH_COMMAND		0x00000007
     60 #define QE_SET_GROUP_ADDRESS		0x00000008
     61 #define QE_INSERT_CELL			0x00000009
     62 #define QE_ATM_TRANSMIT			0x0000000a
     63 #define QE_CELL_POOL_GET		0x0000000b
     64 #define QE_CELL_POOL_PUT		0x0000000c
     65 #define QE_IMA_HOST_CMD			0x0000000d
     66 #define QE_ATM_MULTI_THREAD_INIT	0x00000011
     67 #define QE_ASSIGN_PAGE			0x00000012
     68 #define QE_START_FLOW_CONTROL		0x00000014
     69 #define QE_STOP_FLOW_CONTROL		0x00000015
     70 #define QE_ASSIGN_PAGE_TO_DEVICE	0x00000016
     71 #define QE_GRACEFUL_STOP_RX		0x0000001a
     72 #define QE_RESTART_RX			0x0000001b
     73 
     74 /* QE CECR Sub Block Code - sub block code of QE command.
     75 */
     76 #define QE_CR_SUBBLOCK_INVALID		0x00000000
     77 #define QE_CR_SUBBLOCK_USB		0x03200000
     78 #define QE_CR_SUBBLOCK_UCCFAST1		0x02000000
     79 #define QE_CR_SUBBLOCK_UCCFAST2		0x02200000
     80 #define QE_CR_SUBBLOCK_UCCFAST3		0x02400000
     81 #define QE_CR_SUBBLOCK_UCCFAST4		0x02600000
     82 #define QE_CR_SUBBLOCK_UCCFAST5		0x02800000
     83 #define QE_CR_SUBBLOCK_UCCFAST6		0x02a00000
     84 #define QE_CR_SUBBLOCK_UCCFAST7		0x02c00000
     85 #define QE_CR_SUBBLOCK_UCCFAST8		0x02e00000
     86 #define QE_CR_SUBBLOCK_UCCSLOW1		0x00000000
     87 #define QE_CR_SUBBLOCK_UCCSLOW2		0x00200000
     88 #define QE_CR_SUBBLOCK_UCCSLOW3		0x00400000
     89 #define QE_CR_SUBBLOCK_UCCSLOW4		0x00600000
     90 #define QE_CR_SUBBLOCK_UCCSLOW5		0x00800000
     91 #define QE_CR_SUBBLOCK_UCCSLOW6		0x00a00000
     92 #define QE_CR_SUBBLOCK_UCCSLOW7		0x00c00000
     93 #define QE_CR_SUBBLOCK_UCCSLOW8		0x00e00000
     94 #define QE_CR_SUBBLOCK_MCC1		0x03800000
     95 #define QE_CR_SUBBLOCK_MCC2		0x03a00000
     96 #define QE_CR_SUBBLOCK_MCC3		0x03000000
     97 #define QE_CR_SUBBLOCK_IDMA1		0x02800000
     98 #define QE_CR_SUBBLOCK_IDMA2		0x02a00000
     99 #define QE_CR_SUBBLOCK_IDMA3		0x02c00000
    100 #define QE_CR_SUBBLOCK_IDMA4		0x02e00000
    101 #define QE_CR_SUBBLOCK_HPAC		0x01e00000
    102 #define QE_CR_SUBBLOCK_SPI1		0x01400000
    103 #define QE_CR_SUBBLOCK_SPI2		0x01600000
    104 #define QE_CR_SUBBLOCK_RAND		0x01c00000
    105 #define QE_CR_SUBBLOCK_TIMER		0x01e00000
    106 #define QE_CR_SUBBLOCK_GENERAL		0x03c00000
    107 
    108 /* QE CECR Protocol - For non-MCC, specifies mode for QE CECR command.
    109 */
    110 #define QE_CR_PROTOCOL_UNSPECIFIED	0x00 /* For all other protocols */
    111 #define QE_CR_PROTOCOL_HDLC_TRANSPARENT	0x00
    112 #define QE_CR_PROTOCOL_ATM_POS		0x0A
    113 #define QE_CR_PROTOCOL_ETHERNET		0x0C
    114 #define QE_CR_PROTOCOL_L2_SWITCH	0x0D
    115 #define QE_CR_PROTOCOL_SHIFT		6
    116 
    117 /* QE ASSIGN PAGE command
    118 */
    119 #define QE_CR_ASSIGN_PAGE_SNUM_SHIFT	17
    120 
    121 /* Communication Direction.
    122 */
    123 typedef enum comm_dir {
    124 	COMM_DIR_NONE		= 0,
    125 	COMM_DIR_RX		= 1,
    126 	COMM_DIR_TX		= 2,
    127 	COMM_DIR_RX_AND_TX	= 3
    128 } comm_dir_e;
    129 
    130 /* Clocks and BRG's
    131 */
    132 typedef enum qe_clock {
    133 	QE_CLK_NONE = 0,
    134 	QE_BRG1,     /* Baud Rate Generator  1 */
    135 	QE_BRG2,     /* Baud Rate Generator  2 */
    136 	QE_BRG3,     /* Baud Rate Generator  3 */
    137 	QE_BRG4,     /* Baud Rate Generator  4 */
    138 	QE_BRG5,     /* Baud Rate Generator  5 */
    139 	QE_BRG6,     /* Baud Rate Generator  6 */
    140 	QE_BRG7,     /* Baud Rate Generator  7 */
    141 	QE_BRG8,     /* Baud Rate Generator  8 */
    142 	QE_BRG9,     /* Baud Rate Generator  9 */
    143 	QE_BRG10,    /* Baud Rate Generator 10 */
    144 	QE_BRG11,    /* Baud Rate Generator 11 */
    145 	QE_BRG12,    /* Baud Rate Generator 12 */
    146 	QE_BRG13,    /* Baud Rate Generator 13 */
    147 	QE_BRG14,    /* Baud Rate Generator 14 */
    148 	QE_BRG15,    /* Baud Rate Generator 15 */
    149 	QE_BRG16,    /* Baud Rate Generator 16 */
    150 	QE_CLK1,     /* Clock  1	       */
    151 	QE_CLK2,     /* Clock  2	       */
    152 	QE_CLK3,     /* Clock  3	       */
    153 	QE_CLK4,     /* Clock  4	       */
    154 	QE_CLK5,     /* Clock  5	       */
    155 	QE_CLK6,     /* Clock  6	       */
    156 	QE_CLK7,     /* Clock  7	       */
    157 	QE_CLK8,     /* Clock  8	       */
    158 	QE_CLK9,     /* Clock  9	       */
    159 	QE_CLK10,    /* Clock 10	       */
    160 	QE_CLK11,    /* Clock 11	       */
    161 	QE_CLK12,    /* Clock 12	       */
    162 	QE_CLK13,    /* Clock 13	       */
    163 	QE_CLK14,    /* Clock 14	       */
    164 	QE_CLK15,    /* Clock 15	       */
    165 	QE_CLK16,    /* Clock 16	       */
    166 	QE_CLK17,    /* Clock 17	       */
    167 	QE_CLK18,    /* Clock 18	       */
    168 	QE_CLK19,    /* Clock 19	       */
    169 	QE_CLK20,    /* Clock 20	       */
    170 	QE_CLK21,    /* Clock 21	       */
    171 	QE_CLK22,    /* Clock 22	       */
    172 	QE_CLK23,    /* Clock 23	       */
    173 	QE_CLK24,    /* Clock 24	       */
    174 	QE_CLK_DUMMY
    175 } qe_clock_e;
    176 
    177 /* QE CMXGCR register
    178 */
    179 #define QE_CMXGCR_MII_ENET_MNG_MASK	0x00007000
    180 #define QE_CMXGCR_MII_ENET_MNG_SHIFT	12
    181 
    182 /* QE CMXUCR registers
    183  */
    184 #define QE_CMXUCR_TX_CLK_SRC_MASK	0x0000000F
    185 
    186 /* QE BRG configuration register
    187 */
    188 #define QE_BRGC_ENABLE			0x00010000
    189 #define QE_BRGC_DIVISOR_SHIFT		1
    190 #define QE_BRGC_DIVISOR_MAX		0xFFF
    191 #define QE_BRGC_DIV16			1
    192 
    193 /* QE SDMA registers
    194 */
    195 #define QE_SDSR_BER1			0x02000000
    196 #define QE_SDSR_BER2			0x01000000
    197 
    198 #define QE_SDMR_GLB_1_MSK		0x80000000
    199 #define QE_SDMR_ADR_SEL			0x20000000
    200 #define QE_SDMR_BER1_MSK		0x02000000
    201 #define QE_SDMR_BER2_MSK		0x01000000
    202 #define QE_SDMR_EB1_MSK			0x00800000
    203 #define QE_SDMR_ER1_MSK			0x00080000
    204 #define QE_SDMR_ER2_MSK			0x00040000
    205 #define QE_SDMR_CEN_MASK		0x0000E000
    206 #define QE_SDMR_SBER_1			0x00000200
    207 #define QE_SDMR_SBER_2			0x00000200
    208 #define QE_SDMR_EB1_PR_MASK		0x000000C0
    209 #define QE_SDMR_ER1_PR			0x00000008
    210 
    211 #define QE_SDMR_CEN_SHIFT		13
    212 #define QE_SDMR_EB1_PR_SHIFT		6
    213 
    214 #define QE_SDTM_MSNUM_SHIFT		24
    215 
    216 #define QE_SDEBCR_BA_MASK		0x01FFFFFF
    217 
    218 /* Communication Processor */
    219 #define QE_CP_CERCR_MEE		0x8000	/* Multi-user RAM ECC enable */
    220 #define QE_CP_CERCR_IEE		0x4000	/* Instruction RAM ECC enable */
    221 #define QE_CP_CERCR_CIR		0x0800	/* Common instruction RAM */
    222 
    223 /* I-RAM */
    224 #define QE_IRAM_IADD_AIE	0x80000000	/* Auto Increment Enable */
    225 #define QE_IRAM_IADD_BADDR	0x00080000	/* Base Address */
    226 #define QE_IRAM_READY		0x80000000
    227 
    228 /* Structure that defines QE firmware binary files.
    229  *
    230  * See doc/README.qe_firmware for a description of these fields.
    231  */
    232 struct qe_firmware {
    233 	struct qe_header {
    234 		u32 length;	/* Length of the entire structure, in bytes */
    235 		u8 magic[3];	/* Set to { 'Q', 'E', 'F' } */
    236 		u8 version;	/* Version of this layout. First ver is '1' */
    237 	} header;
    238 	u8 id[62];		/* Null-terminated identifier string */
    239 	u8 split;		/* 0 = shared I-RAM, 1 = split I-RAM */
    240 	u8 count;		/* Number of microcode[] structures */
    241 	struct {
    242 		u16 model;	/* The SOC model  */
    243 		u8 major;	/* The SOC revision major */
    244 		u8 minor;	/* The SOC revision minor */
    245 	} __attribute__ ((packed)) soc;
    246 	u8 padding[4];		/* Reserved, for alignment */
    247 	u64 extended_modes;	/* Extended modes */
    248 	u32 vtraps[8];		/* Virtual trap addresses */
    249 	u8 reserved[4];		/* Reserved, for future expansion */
    250 	struct qe_microcode {
    251 		u8 id[32];	/* Null-terminated identifier */
    252 		u32 traps[16];	/* Trap addresses, 0 == ignore */
    253 		u32 eccr;	/* The value for the ECCR register */
    254 		u32 iram_offset;/* Offset into I-RAM for the code */
    255 		u32 count;	/* Number of 32-bit words of the code */
    256 		u32 code_offset;/* Offset of the actual microcode */
    257 		u8 major;	/* The microcode version major */
    258 		u8 minor;	/* The microcode version minor */
    259 		u8 revision;	/* The microcode version revision */
    260 		u8 padding;	/* Reserved, for alignment */
    261 		u8 reserved[4];	/* Reserved, for future expansion */
    262 	} __attribute__ ((packed)) microcode[1];
    263 	/* All microcode binaries should be located here */
    264 	/* CRC32 should be located here, after the microcode binaries */
    265 } __attribute__ ((packed));
    266 
    267 struct qe_firmware_info {
    268 	char id[64];		/* Firmware name */
    269 	u32 vtraps[8];		/* Virtual trap addresses */
    270 	u64 extended_modes;	/* Extended modes */
    271 };
    272 
    273 void qe_config_iopin(u8 port, u8 pin, int dir, int open_drain, int assign);
    274 void qe_issue_cmd(uint cmd, uint sbc, u8 mcn, u32 cmd_data);
    275 uint qe_muram_alloc(uint size, uint align);
    276 void *qe_muram_addr(uint offset);
    277 int qe_get_snum(void);
    278 void qe_put_snum(u8 snum);
    279 void qe_init(uint qe_base);
    280 void qe_reset(void);
    281 void qe_assign_page(uint snum, uint para_ram_base);
    282 int qe_set_brg(uint brg, uint rate);
    283 int qe_set_mii_clk_src(int ucc_num);
    284 int qe_upload_firmware(const struct qe_firmware *firmware);
    285 struct qe_firmware_info *qe_get_firmware_info(void);
    286 void ft_qe_setup(void *blob);
    287 void qe_init(uint qe_base);
    288 void qe_reset(void);
    289 
    290 #ifdef CONFIG_U_QE
    291 void u_qe_init(void);
    292 int u_qe_upload_firmware(const struct qe_firmware *firmware);
    293 void u_qe_resume(void);
    294 int u_qe_firmware_resume(const struct qe_firmware *firmware,
    295 			 qe_map_t *qe_immrr);
    296 #endif
    297 
    298 #endif /* __QE_H__ */
    299