xref: /freebsd/sys/dev/usb/uftdiio.h (revision 2ff63af9b88c7413b7d71715b5532625752a248e)
1 /*-
2  * Copyright 2008-2012 - Symmetricom, Inc.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions, and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
18  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  */
27 
28 /*
29  * FTDI USB serial converter chip ioctl commands.
30  */
31 
32 #ifndef _USB_UFTDIIO_H_
33 #define _USB_UFTDIIO_H_
34 
35 #include <sys/ioccom.h>
36 
37 enum uftdi_bitmodes
38 {
39 	UFTDI_BITMODE_ASYNC = 0,
40 	UFTDI_BITMODE_MPSSE = 1,
41 	UFTDI_BITMODE_SYNC = 2,
42 	UFTDI_BITMODE_CPU_EMUL = 3,
43 	UFTDI_BITMODE_FAST_SERIAL = 4,
44 	UFTDI_BITMODE_CBUS = 5,
45 	UFTDI_BITMODE_NONE = 0xff,	/* aka UART mode. */
46 };
47 
48 /*
49  * For UFTDIIOC_SET_BITMODE:
50  *   mode   = One of the uftdi_bitmodes enum values.
51  *   iomask = Mask of bits enabled for bitbang output.
52  *
53  * For UFTDIIOC_GET_BITMODE:
54  *   mode   = Mode most recently set using UFTDIIOC_SET_BITMODE.
55  *   iomask = Returned snapshot of DBUS0..DBUS7 pin states at time of call.
56  *            Pin states can be read in any mode, not just bitbang modes.
57  */
58 struct uftdi_bitmode
59 {
60 	uint8_t mode;
61 	uint8_t iomask;
62 };
63 
64 /*
65  * For UFTDIIOC_READ_EEPROM, UFTDIIOC_WRITE_EEPROM:
66  *
67  * IO is done in 16-bit words at the chip level; offset and length are in bytes,
68  * but must each be evenly divisible by two.
69  *
70  * It is not necessary to erase before writing.  For the FT232R device (only)
71  * you must set the latency timer to 0x77 before doing a series of eeprom writes
72  * (and restore it to the prior value when done).
73  */
74 struct uftdi_eeio
75 {
76 	uint16_t offset;
77 	uint16_t length;
78 	uint16_t data[64];
79 };
80 
81 /* Pass this value to confirm that eeprom erase request is not accidental. */
82 #define	UFTDI_CONFIRM_ERASE	0x26139108
83 
84 #define	UFTDIIOC_RESET_IO	_IO('c', 0)	/* Reset config, flush fifos.*/
85 #define	UFTDIIOC_RESET_RX	_IO('c', 1)	/* Flush input fifo. */
86 #define	UFTDIIOC_RESET_TX	_IO('c', 2)	/* Flush output fifo. */
87 #define	UFTDIIOC_SET_BITMODE	_IOW('c', 3, struct uftdi_bitmode)
88 #define	UFTDIIOC_GET_BITMODE	_IOR('c', 4, struct uftdi_bitmode)
89 #define	UFTDIIOC_SET_ERROR_CHAR	_IOW('c', 5, int)	/* -1 to disable */
90 #define	UFTDIIOC_SET_EVENT_CHAR	_IOW('c', 6, int)	/* -1 to disable */
91 #define	UFTDIIOC_SET_LATENCY	_IOW('c', 7, int)	/* 1-255 ms */
92 #define	UFTDIIOC_GET_LATENCY	_IOR('c', 8, int)
93 #define	UFTDIIOC_GET_HWREV	_IOR('c', 9, int)
94 #define	UFTDIIOC_READ_EEPROM	_IOWR('c', 10, struct uftdi_eeio)
95 #define	UFTDIIOC_WRITE_EEPROM	_IOW('c', 11, struct uftdi_eeio)
96 #define	UFTDIIOC_ERASE_EEPROM	_IOW('c', 12, int)
97 
98 #endif
99