2 * Generic ULPI interface.
4 * Copyright (C) 2011 Jana Rapava <fermata7@gmail.com>
5 * Copyright (C) 2011 CompuLab, Ltd. <www.compulab.co.il>
7 * Authors: Jana Rapava <fermata7@gmail.com>
8 * Igor Grinberg <grinberg@compulab.co.il>
10 * Register offsets taken from:
11 * linux/include/linux/usb/ulpi.h
13 * Original Copyrights follow:
14 * Copyright (C) 2010 Nokia Corporation
16 * This software is distributed under the terms of the GNU General
17 * Public License ("GPL") as published by the Free Software Foundation,
18 * version 2 of that License.
21 #ifndef __USB_ULPI_H__
22 #define __USB_ULPI_H__
24 #define ULPI_ERROR (1 << 8) /* overflow from any register value */
26 #ifndef CONFIG_USB_ULPI_TIMEOUT
27 #define CONFIG_USB_ULPI_TIMEOUT 1000 /* timeout in us */
31 * ulpi view port address and
32 * Port_number that can be passed.
33 * Any additional data to be passed can
34 * be extended from this structure
36 struct ulpi_viewport {
42 * Initialize the ULPI transciever and check the interface integrity.
43 * @ulpi_vp - structure containing ULPI viewport data
45 * returns 0 on success, ULPI_ERROR on failure.
47 int ulpi_init(struct ulpi_viewport *ulpi_vp);
50 * Select transceiver speed.
51 * @speed - ULPI_FC_HIGH_SPEED, ULPI_FC_FULL_SPEED (default),
52 * ULPI_FC_LOW_SPEED, ULPI_FC_FS4LS
53 * returns 0 on success, ULPI_ERROR on failure.
55 int ulpi_select_transceiver(struct ulpi_viewport *ulpi_vp, unsigned speed);
58 * Enable/disable VBUS.
59 * @ext_power - external VBUS supply is used (default is false)
60 * @ext_indicator - external VBUS over-current indicator is used
62 * returns 0 on success, ULPI_ERROR on failure.
64 int ulpi_enable_vbus(struct ulpi_viewport *ulpi_vp,
65 int on, int ext_power, int ext_ind);
68 * Enable/disable pull-down resistors on D+ and D- USB lines.
70 * returns 0 on success, ULPI_ERROR on failure.
72 int ulpi_set_pd(struct ulpi_viewport *ulpi_vp, int enable);
76 * @opmode - ULPI_FC_OPMODE_NORMAL (default), ULPI_FC_OPMODE_NONDRIVING,
77 * ULPI_FC_OPMODE_DISABLE_NRZI, ULPI_FC_OPMODE_NOSYNC_NOEOP
79 * returns 0 on success, ULPI_ERROR on failure.
81 int ulpi_opmode_sel(struct ulpi_viewport *ulpi_vp, unsigned opmode);
84 * Switch to Serial Mode.
85 * @smode - ULPI_IFACE_6_PIN_SERIAL_MODE or ULPI_IFACE_3_PIN_SERIAL_MODE
87 * returns 0 on success, ULPI_ERROR on failure.
90 * Switches immediately to Serial Mode.
91 * To return from Serial Mode, STP line needs to be asserted.
93 int ulpi_serial_mode_enable(struct ulpi_viewport *ulpi_vp, unsigned smode);
96 * Put PHY into low power mode.
98 * returns 0 on success, ULPI_ERROR on failure.
101 * STP line must be driven low to keep the PHY in suspend.
102 * To resume the PHY, STP line needs to be asserted.
104 int ulpi_suspend(struct ulpi_viewport *ulpi_vp);
107 * Reset the transceiver. ULPI interface and registers are not affected.
109 * returns 0 on success, ULPI_ERROR on failure.
111 int ulpi_reset(struct ulpi_viewport *ulpi_vp);
114 /* ULPI access methods below must be implemented for each ULPI viewport. */
117 * Write to the ULPI PHY register via the viewport.
118 * @reg - the ULPI register (one of the fields in struct ulpi_regs).
119 * @value - the value - only 8 lower bits are used, others ignored.
121 * returns 0 on success, ULPI_ERROR on failure.
123 int ulpi_write(struct ulpi_viewport *ulpi_vp, u8 *reg, u32 value);
126 * Read the ULPI PHY register content via the viewport.
127 * @reg - the ULPI register (one of the fields in struct ulpi_regs).
129 * returns register content on success, ULPI_ERROR on failure.
131 u32 ulpi_read(struct ulpi_viewport *ulpi_vp, u8 *reg);
134 * Wait for the reset to complete.
135 * The Link must not attempt to access the PHY until the reset has
136 * completed and DIR line is de-asserted.
138 int ulpi_reset_wait(struct ulpi_viewport *ulpi_vp);
140 /* Access Extended Register Set (indicator) */
141 #define ACCESS_EXT_REGS_OFFSET 0x2f /* read-write */
142 /* Vendor-specific */
143 #define VENDOR_SPEC_OFFSET 0x30
146 * Extended Register Set
148 * Addresses 0x00-0x3F map directly to Immediate Register Set.
149 * Addresses 0x40-0x7F are reserved.
150 * Addresses 0x80-0xff are vendor-specific.
152 #define EXT_VENDOR_SPEC_OFFSET 0x80
154 /* ULPI registers, bits and offsets definitions */
156 /* Vendor ID and Product ID: 0x00 - 0x03 Read-only */
161 /* Function Control: 0x04 - 0x06 Read */
162 u8 function_ctrl; /* 0x04 Write */
163 u8 function_ctrl_set; /* 0x05 Set */
164 u8 function_ctrl_clear; /* 0x06 Clear */
165 /* Interface Control: 0x07 - 0x09 Read */
166 u8 iface_ctrl; /* 0x07 Write */
167 u8 iface_ctrl_set; /* 0x08 Set */
168 u8 iface_ctrl_clear; /* 0x09 Clear */
169 /* OTG Control: 0x0A - 0x0C Read */
170 u8 otg_ctrl; /* 0x0A Write */
171 u8 otg_ctrl_set; /* 0x0B Set */
172 u8 otg_ctrl_clear; /* 0x0C Clear */
173 /* USB Interrupt Enable Rising: 0x0D - 0x0F Read */
174 u8 usb_ie_rising; /* 0x0D Write */
175 u8 usb_ie_rising_set; /* 0x0E Set */
176 u8 usb_ie_rising_clear; /* 0x0F Clear */
177 /* USB Interrupt Enable Falling: 0x10 - 0x12 Read */
178 u8 usb_ie_falling; /* 0x10 Write */
179 u8 usb_ie_falling_set; /* 0x11 Set */
180 u8 usb_ie_falling_clear; /* 0x12 Clear */
181 /* USB Interrupt Status: 0x13 Read-only */
183 /* USB Interrupt Latch: 0x14 Read-only with auto-clear */
185 /* Debug: 0x15 Read-only */
187 /* Scratch Register: 0x16 - 0x18 Read */
188 u8 scratch; /* 0x16 Write */
189 u8 scratch_set; /* 0x17 Set */
190 u8 scratch_clear; /* 0x18 Clear */
192 * Optional Carkit registers:
193 * Carkit Control: 0x19 - 0x1B Read
195 u8 carkit_ctrl; /* 0x19 Write */
196 u8 carkit_ctrl_set; /* 0x1A Set */
197 u8 carkit_ctrl_clear; /* 0x1B Clear */
198 /* Carkit Interrupt Delay: 0x1C Read, Write */
200 /* Carkit Interrupt Enable: 0x1D - 0x1F Read */
201 u8 carkit_ie; /* 0x1D Write */
202 u8 carkit_ie_set; /* 0x1E Set */
203 u8 carkit_ie_clear; /* 0x1F Clear */
204 /* Carkit Interrupt Status: 0x20 Read-only */
205 u8 carkit_int_status;
206 /* Carkit Interrupt Latch: 0x21 Read-only with auto-clear */
208 /* Carkit Pulse Control: 0x22 - 0x24 Read */
209 u8 carkit_pulse_ctrl; /* 0x22 Write */
210 u8 carkit_pulse_ctrl_set; /* 0x23 Set */
211 u8 carkit_pulse_ctrl_clear; /* 0x24 Clear */
213 * Other optional registers:
214 * Transmit Positive Width: 0x25 Read, Write
216 u8 transmit_pos_width;
217 /* Transmit Negative Width: 0x26 Read, Write */
218 u8 transmit_neg_width;
219 /* Receive Polarity Recovery: 0x27 Read, Write */
220 u8 recv_pol_recovery;
222 * Addresses 0x28 - 0x2E are reserved, so we use offsets
223 * for immediate registers with higher addresses
231 /* Function Control */
232 #define ULPI_FC_XCVRSEL_MASK (3 << 0)
233 #define ULPI_FC_HIGH_SPEED (0 << 0)
234 #define ULPI_FC_FULL_SPEED (1 << 0)
235 #define ULPI_FC_LOW_SPEED (2 << 0)
236 #define ULPI_FC_FS4LS (3 << 0)
237 #define ULPI_FC_TERMSELECT (1 << 2)
238 #define ULPI_FC_OPMODE_MASK (3 << 3)
239 #define ULPI_FC_OPMODE_NORMAL (0 << 3)
240 #define ULPI_FC_OPMODE_NONDRIVING (1 << 3)
241 #define ULPI_FC_OPMODE_DISABLE_NRZI (2 << 3)
242 #define ULPI_FC_OPMODE_NOSYNC_NOEOP (3 << 3)
243 #define ULPI_FC_RESET (1 << 5)
244 #define ULPI_FC_SUSPENDM (1 << 6)
246 /* Interface Control */
247 #define ULPI_IFACE_6_PIN_SERIAL_MODE (1 << 0)
248 #define ULPI_IFACE_3_PIN_SERIAL_MODE (1 << 1)
249 #define ULPI_IFACE_CARKITMODE (1 << 2)
250 #define ULPI_IFACE_CLOCKSUSPENDM (1 << 3)
251 #define ULPI_IFACE_AUTORESUME (1 << 4)
252 #define ULPI_IFACE_EXTVBUS_COMPLEMENT (1 << 5)
253 #define ULPI_IFACE_PASSTHRU (1 << 6)
254 #define ULPI_IFACE_PROTECT_IFC_DISABLE (1 << 7)
257 #define ULPI_OTG_ID_PULLUP (1 << 0)
258 #define ULPI_OTG_DP_PULLDOWN (1 << 1)
259 #define ULPI_OTG_DM_PULLDOWN (1 << 2)
260 #define ULPI_OTG_DISCHRGVBUS (1 << 3)
261 #define ULPI_OTG_CHRGVBUS (1 << 4)
262 #define ULPI_OTG_DRVVBUS (1 << 5)
263 #define ULPI_OTG_DRVVBUS_EXT (1 << 6)
264 #define ULPI_OTG_EXTVBUSIND (1 << 7)
267 * USB Interrupt Enable Rising,
268 * USB Interrupt Enable Falling,
269 * USB Interrupt Status and
270 * USB Interrupt Latch
272 #define ULPI_INT_HOST_DISCONNECT (1 << 0)
273 #define ULPI_INT_VBUS_VALID (1 << 1)
274 #define ULPI_INT_SESS_VALID (1 << 2)
275 #define ULPI_INT_SESS_END (1 << 3)
276 #define ULPI_INT_IDGRD (1 << 4)
279 #define ULPI_DEBUG_LINESTATE0 (1 << 0)
280 #define ULPI_DEBUG_LINESTATE1 (1 << 1)
283 #define ULPI_CARKIT_CTRL_CARKITPWR (1 << 0)
284 #define ULPI_CARKIT_CTRL_IDGNDDRV (1 << 1)
285 #define ULPI_CARKIT_CTRL_TXDEN (1 << 2)
286 #define ULPI_CARKIT_CTRL_RXDEN (1 << 3)
287 #define ULPI_CARKIT_CTRL_SPKLEFTEN (1 << 4)
288 #define ULPI_CARKIT_CTRL_SPKRIGHTEN (1 << 5)
289 #define ULPI_CARKIT_CTRL_MICEN (1 << 6)
291 /* Carkit Interrupt Enable */
292 #define ULPI_CARKIT_INT_EN_IDFLOAT_RISE (1 << 0)
293 #define ULPI_CARKIT_INT_EN_IDFLOAT_FALL (1 << 1)
294 #define ULPI_CARKIT_INT_EN_CARINTDET (1 << 2)
295 #define ULPI_CARKIT_INT_EN_DP_RISE (1 << 3)
296 #define ULPI_CARKIT_INT_EN_DP_FALL (1 << 4)
298 /* Carkit Interrupt Status and Latch */
299 #define ULPI_CARKIT_INT_IDFLOAT (1 << 0)
300 #define ULPI_CARKIT_INT_CARINTDET (1 << 1)
301 #define ULPI_CARKIT_INT_DP (1 << 2)
303 /* Carkit Pulse Control*/
304 #define ULPI_CARKIT_PLS_CTRL_TXPLSEN (1 << 0)
305 #define ULPI_CARKIT_PLS_CTRL_RXPLSEN (1 << 1)
306 #define ULPI_CARKIT_PLS_CTRL_SPKRLEFT_BIASEN (1 << 2)
307 #define ULPI_CARKIT_PLS_CTRL_SPKRRIGHT_BIASEN (1 << 3)
310 #endif /* __USB_ULPI_H__ */