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