sisusb.h 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299
  1. /* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
  2. /*
  3. * sisusb - usb kernel driver for Net2280/SiS315 based USB2VGA dongles
  4. *
  5. * Copyright (C) 2005 by Thomas Winischhofer, Vienna, Austria
  6. *
  7. * If distributed as part of the Linux kernel, this code is licensed under the
  8. * terms of the GPL v2.
  9. *
  10. * Otherwise, the following license terms apply:
  11. *
  12. * Redistribution and use in source and binary forms, with or without
  13. * modification, are permitted provided that the following conditions
  14. * are met:
  15. * 1) Redistributions of source code must retain the above copyright
  16. * notice, this list of conditions and the following disclaimer.
  17. * 2) Redistributions in binary form must reproduce the above copyright
  18. * notice, this list of conditions and the following disclaimer in the
  19. * documentation and/or other materials provided with the distribution.
  20. * 3) The name of the author may not be used to endorse or promote products
  21. * derived from this software without specific prior written permission.
  22. *
  23. * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESSED OR
  24. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  25. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  26. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  27. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  28. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  29. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  30. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  31. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  32. * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33. *
  34. * Author: Thomas Winischhofer <[email protected]>
  35. *
  36. */
  37. #ifndef _SISUSB_H_
  38. #define _SISUSB_H_
  39. #include <linux/mutex.h>
  40. /* Version Information */
  41. #define SISUSB_VERSION 0
  42. #define SISUSB_REVISION 0
  43. #define SISUSB_PATCHLEVEL 8
  44. /* Include console and mode switching code? */
  45. #include <linux/console.h>
  46. #include <linux/vt_kern.h>
  47. #include "sisusb_struct.h"
  48. /* USB related */
  49. #define SISUSB_MINOR 133 /* official */
  50. /* Size of the sisusb input/output buffers */
  51. #define SISUSB_IBUF_SIZE 0x01000
  52. #define SISUSB_OBUF_SIZE 0x10000 /* fixed */
  53. #define NUMOBUFS 8 /* max number of output buffers/output URBs */
  54. /* About endianness:
  55. *
  56. * 1) I/O ports, PCI config registers. The read/write()
  57. * calls emulate inX/outX. Hence, the data is
  58. * expected/delivered in machine endiannes by this
  59. * driver.
  60. * 2) Video memory. The data is copied 1:1. There is
  61. * no swapping. Ever. This means for userland that
  62. * the data has to be prepared properly. (Hint:
  63. * think graphics data format, command queue,
  64. * hardware cursor.)
  65. * 3) MMIO. Data is copied 1:1. MMIO must be swapped
  66. * properly by userland.
  67. *
  68. */
  69. #ifdef __BIG_ENDIAN
  70. #define SISUSB_CORRECT_ENDIANNESS_PACKET(p) \
  71. do { \
  72. p->header = cpu_to_le16(p->header); \
  73. p->address = cpu_to_le32(p->address); \
  74. p->data = cpu_to_le32(p->data); \
  75. } while(0)
  76. #else
  77. #define SISUSB_CORRECT_ENDIANNESS_PACKET(p)
  78. #endif
  79. struct sisusb_usb_data;
  80. struct sisusb_urb_context { /* urb->context for outbound bulk URBs */
  81. struct sisusb_usb_data *sisusb;
  82. int urbindex;
  83. int *actual_length;
  84. };
  85. struct sisusb_usb_data {
  86. struct usb_device *sisusb_dev;
  87. struct usb_interface *interface;
  88. struct kref kref;
  89. wait_queue_head_t wait_q; /* for syncind and timeouts */
  90. struct mutex lock; /* general race avoidance */
  91. unsigned int ifnum; /* interface number of the USB device */
  92. int minor; /* minor (for logging clarity) */
  93. int isopen; /* !=0 if open */
  94. int present; /* !=0 if device is present on the bus */
  95. int ready; /* !=0 if device is ready for userland */
  96. int numobufs; /* number of obufs = number of out urbs */
  97. char *obuf[NUMOBUFS], *ibuf; /* transfer buffers */
  98. int obufsize, ibufsize;
  99. struct urb *sisurbout[NUMOBUFS];
  100. struct urb *sisurbin;
  101. unsigned char urbstatus[NUMOBUFS];
  102. unsigned char completein;
  103. struct sisusb_urb_context urbout_context[NUMOBUFS];
  104. unsigned long flagb0;
  105. unsigned long vrambase; /* framebuffer base */
  106. unsigned int vramsize; /* framebuffer size (bytes) */
  107. unsigned long mmiobase;
  108. unsigned int mmiosize;
  109. unsigned long ioportbase;
  110. unsigned char devinit; /* device initialized? */
  111. unsigned char gfxinit; /* graphics core initialized? */
  112. unsigned short chipid, chipvendor;
  113. unsigned short chiprevision;
  114. #ifdef CONFIG_USB_SISUSBVGA_CON
  115. struct SiS_Private *SiS_Pr;
  116. unsigned long scrbuf;
  117. unsigned int scrbuf_size;
  118. int haveconsole, con_first, con_last;
  119. int havethisconsole[MAX_NR_CONSOLES];
  120. int textmodedestroyed;
  121. unsigned int sisusb_num_columns; /* real number, not vt's idea */
  122. int cur_start_addr, con_rolled_over;
  123. int sisusb_cursor_loc, bad_cursor_pos;
  124. int sisusb_cursor_size_from;
  125. int sisusb_cursor_size_to;
  126. int current_font_height, current_font_512;
  127. int font_backup_size, font_backup_height, font_backup_512;
  128. char *font_backup;
  129. int font_slot;
  130. struct vc_data *sisusb_display_fg;
  131. int is_gfx;
  132. int con_blanked;
  133. #endif
  134. };
  135. #define to_sisusb_dev(d) container_of(d, struct sisusb_usb_data, kref)
  136. /* USB transport related */
  137. /* urbstatus */
  138. #define SU_URB_BUSY 1
  139. #define SU_URB_ALLOC 2
  140. /* Endpoints */
  141. #define SISUSB_EP_GFX_IN 0x0e /* gfx std packet out(0e)/in(8e) */
  142. #define SISUSB_EP_GFX_OUT 0x0e
  143. #define SISUSB_EP_GFX_BULK_OUT 0x01 /* gfx mem bulk out/in */
  144. #define SISUSB_EP_GFX_BULK_IN 0x02 /* ? 2 is "OUT" ? */
  145. #define SISUSB_EP_GFX_LBULK_OUT 0x03 /* gfx large mem bulk out */
  146. #define SISUSB_EP_UNKNOWN_04 0x04 /* ? 4 is "OUT" ? - unused */
  147. #define SISUSB_EP_BRIDGE_IN 0x0d /* Net2280 out(0d)/in(8d) */
  148. #define SISUSB_EP_BRIDGE_OUT 0x0d
  149. #define SISUSB_TYPE_MEM 0
  150. #define SISUSB_TYPE_IO 1
  151. struct sisusb_packet {
  152. unsigned short header;
  153. u32 address;
  154. u32 data;
  155. } __attribute__ ((__packed__));
  156. #define CLEARPACKET(packet) memset(packet, 0, 10)
  157. /* PCI bridge related */
  158. #define SISUSB_PCI_MEMBASE 0xd0000000
  159. #define SISUSB_PCI_MMIOBASE 0xe4000000
  160. #define SISUSB_PCI_IOPORTBASE 0x0000d000
  161. #define SISUSB_PCI_PSEUDO_MEMBASE 0x10000000
  162. #define SISUSB_PCI_PSEUDO_MMIOBASE 0x20000000
  163. #define SISUSB_PCI_PSEUDO_IOPORTBASE 0x0000d000
  164. #define SISUSB_PCI_PSEUDO_PCIBASE 0x00010000
  165. #define SISUSB_PCI_MMIOSIZE (128*1024)
  166. #define SISUSB_PCI_PCONFSIZE 0x5c
  167. /* graphics core related */
  168. #define AROFFSET 0x40
  169. #define ARROFFSET 0x41
  170. #define GROFFSET 0x4e
  171. #define SROFFSET 0x44
  172. #define CROFFSET 0x54
  173. #define MISCROFFSET 0x4c
  174. #define MISCWOFFSET 0x42
  175. #define INPUTSTATOFFSET 0x5A
  176. #define PART1OFFSET 0x04
  177. #define PART2OFFSET 0x10
  178. #define PART3OFFSET 0x12
  179. #define PART4OFFSET 0x14
  180. #define PART5OFFSET 0x16
  181. #define CAPTUREOFFSET 0x00
  182. #define VIDEOOFFSET 0x02
  183. #define COLREGOFFSET 0x48
  184. #define PELMASKOFFSET 0x46
  185. #define VGAENABLE 0x43
  186. #define SISAR SISUSB_PCI_IOPORTBASE + AROFFSET
  187. #define SISARR SISUSB_PCI_IOPORTBASE + ARROFFSET
  188. #define SISGR SISUSB_PCI_IOPORTBASE + GROFFSET
  189. #define SISSR SISUSB_PCI_IOPORTBASE + SROFFSET
  190. #define SISCR SISUSB_PCI_IOPORTBASE + CROFFSET
  191. #define SISMISCR SISUSB_PCI_IOPORTBASE + MISCROFFSET
  192. #define SISMISCW SISUSB_PCI_IOPORTBASE + MISCWOFFSET
  193. #define SISINPSTAT SISUSB_PCI_IOPORTBASE + INPUTSTATOFFSET
  194. #define SISPART1 SISUSB_PCI_IOPORTBASE + PART1OFFSET
  195. #define SISPART2 SISUSB_PCI_IOPORTBASE + PART2OFFSET
  196. #define SISPART3 SISUSB_PCI_IOPORTBASE + PART3OFFSET
  197. #define SISPART4 SISUSB_PCI_IOPORTBASE + PART4OFFSET
  198. #define SISPART5 SISUSB_PCI_IOPORTBASE + PART5OFFSET
  199. #define SISCAP SISUSB_PCI_IOPORTBASE + CAPTUREOFFSET
  200. #define SISVID SISUSB_PCI_IOPORTBASE + VIDEOOFFSET
  201. #define SISCOLIDXR SISUSB_PCI_IOPORTBASE + COLREGOFFSET - 1
  202. #define SISCOLIDX SISUSB_PCI_IOPORTBASE + COLREGOFFSET
  203. #define SISCOLDATA SISUSB_PCI_IOPORTBASE + COLREGOFFSET + 1
  204. #define SISCOL2IDX SISPART5
  205. #define SISCOL2DATA SISPART5 + 1
  206. #define SISPEL SISUSB_PCI_IOPORTBASE + PELMASKOFFSET
  207. #define SISVGAEN SISUSB_PCI_IOPORTBASE + VGAENABLE
  208. #define SISDACA SISCOLIDX
  209. #define SISDACD SISCOLDATA
  210. /* ioctl related */
  211. /* Structure argument for SISUSB_GET_INFO ioctl */
  212. struct sisusb_info {
  213. __u32 sisusb_id; /* for identifying sisusb */
  214. #define SISUSB_ID 0x53495355 /* Identify myself with 'SISU' */
  215. __u8 sisusb_version;
  216. __u8 sisusb_revision;
  217. __u8 sisusb_patchlevel;
  218. __u8 sisusb_gfxinit; /* graphics core initialized? */
  219. __u32 sisusb_vrambase;
  220. __u32 sisusb_mmiobase;
  221. __u32 sisusb_iobase;
  222. __u32 sisusb_pcibase;
  223. __u32 sisusb_vramsize; /* framebuffer size in bytes */
  224. __u32 sisusb_minor;
  225. __u32 sisusb_fbdevactive; /* != 0 if framebuffer device active */
  226. __u32 sisusb_conactive; /* != 0 if console driver active */
  227. __u8 sisusb_reserved[28]; /* for future use */
  228. };
  229. struct sisusb_command {
  230. __u8 operation; /* see below */
  231. __u8 data0; /* operation dependent */
  232. __u8 data1; /* operation dependent */
  233. __u8 data2; /* operation dependent */
  234. __u32 data3; /* operation dependent */
  235. __u32 data4; /* for future use */
  236. };
  237. #define SUCMD_GET 0x01 /* for all: data0 = index, data3 = port */
  238. #define SUCMD_SET 0x02 /* data1 = value */
  239. #define SUCMD_SETOR 0x03 /* data1 = or */
  240. #define SUCMD_SETAND 0x04 /* data1 = and */
  241. #define SUCMD_SETANDOR 0x05 /* data1 = and, data2 = or */
  242. #define SUCMD_SETMASK 0x06 /* data1 = data, data2 = mask */
  243. #define SUCMD_CLRSCR 0x07 /* data0:1:2 = length, data3 = address */
  244. #define SUCMD_HANDLETEXTMODE 0x08 /* Reset/destroy text mode */
  245. #define SUCMD_SETMODE 0x09 /* Set a display mode (data3 = SiS mode) */
  246. #define SUCMD_SETVESAMODE 0x0a /* Set a display mode (data3 = VESA mode) */
  247. #define SISUSB_COMMAND _IOWR(0xF3,0x3D,struct sisusb_command)
  248. #define SISUSB_GET_CONFIG_SIZE _IOR(0xF3,0x3E,__u32)
  249. #define SISUSB_GET_CONFIG _IOR(0xF3,0x3F,struct sisusb_info)
  250. #endif /* SISUSB_H */