开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Linux/Unix编程 > 查看源码
xtalk.h
资源名称：linux-2.4.20.tar.gz　[点击查看]
上传用户：jlfgdled
上传日期：2013-04-10
资源大小：33168k
文件大小：13k
源码类别：

Linux/Unix编程

开发平台：

Unix_Linux

xtalk.h：源码内容
  1. /* $Id$
  2.  *
  3.  * This file is subject to the terms and conditions of the GNU General Public
  4.  * License.  See the file "COPYING" in the main directory of this archive
  5.  * for more details.
  6.  *
  7.  * Copyright (C) 1992-1997, 2000-2002 Silicon Graphics, Inc.  All Rights Reserved.
  8.  */
  9. #ifndef _ASM_SN_XTALK_XTALK_H
  10. #define _ASM_SN_XTALK_XTALK_H
  12. /*
  13.  * xtalk.h -- platform-independent crosstalk interface
  14.  */
  15. /*
  16.  * User-level device driver visible types
  17.  */
  18. typedef char            xwidgetnum_t; /* xtalk widget number  (0..15) */
  20. #define XWIDGET_NONE (-1)
  22. typedef int xwidget_part_num_t; /* xtalk widget part number */
  24. #define XWIDGET_PART_NUM_NONE (-1)
  26. typedef int             xwidget_rev_num_t; /* xtalk widget revision number */
  28. #define XWIDGET_REV_NUM_NONE (-1)
  30. typedef int xwidget_mfg_num_t; /* xtalk widget manufacturing ID */
  32. #define XWIDGET_MFG_NUM_NONE (-1)
  34. typedef struct xtalk_piomap_s *xtalk_piomap_t;
  36. /* It is often convenient to fold the XIO target port
  37.  * number into the XIO address.
  38.  */
  39. #define XIO_NOWHERE (0xFFFFFFFFFFFFFFFFull)
  40. #define XIO_ADDR_BITS (0x0000FFFFFFFFFFFFull)
  41. #define XIO_PORT_BITS (0xF000000000000000ull)
  42. #define XIO_PORT_SHIFT (60)
  44. #define XIO_PACKED(x) (((x)&XIO_PORT_BITS) != 0)
  45. #define XIO_ADDR(x) ((x)&XIO_ADDR_BITS)
  46. #define XIO_PORT(x) ((xwidgetnum_t)(((x)&XIO_PORT_BITS) >> XIO_PORT_SHIFT))
  47. #define XIO_PACK(p,o) ((((uint64_t)(p))<<XIO_PORT_SHIFT) | ((o)&XIO_ADDR_BITS))
  50. /*
  51.  * Kernel/driver only definitions
  52.  */
  53. #if __KERNEL__
  55. #include <asm/types.h>
  56. #include <asm/sn/types.h>
  57. #include <asm/sn/alenlist.h>
  58. #include <asm/sn/ioerror.h>
  59. #include <asm/sn/driver.h>
  60. #include <asm/sn/dmamap.h>
  62. struct xwidget_hwid_s;
  64. /*
  65.  *    Acceptable flag bits for xtalk service calls
  66.  *
  67.  * XTALK_FIXED: require that mappings be established
  68.  * using fixed sharable resources; address
  69.  * translation results will be permanently
  70.  * available. (PIOMAP_FIXED and DMAMAP_FIXED are
  71.  * the same numeric value and are acceptable).
  72.  * XTALK_NOSLEEP: if any part of the operation would
  73.  * sleep waiting for resoruces, return an error
  74.  * instead. (PIOMAP_NOSLEEP and DMAMAP_NOSLEEP are
  75.  * the same numeric value and are acceptable).
  76.  * XTALK_INPLACE: when operating on alenlist structures,
  77.  * reuse the source alenlist rather than creating a
  78.  * new one. (PIOMAP_INPLACE and DMAMAP_INPLACE are
  79.  * the same numeric value and are acceptable).
  80.  */
  81. #define XTALK_FIXED DMAMAP_FIXED
  82. #define XTALK_NOSLEEP DMAMAP_NOSLEEP
  83. #define XTALK_INPLACE DMAMAP_INPLACE
  85. /* PIO MANAGEMENT */
  86. typedef xtalk_piomap_t
  87. xtalk_piomap_alloc_f    (devfs_handle_t dev, /* set up mapping for this device */
  88.  device_desc_t dev_desc, /* device descriptor */
  89.  iopaddr_t xtalk_addr, /* map for this xtalk_addr range */
  90.  size_t byte_count,
  91.  size_t byte_count_max, /* maximum size of a mapping */
  92.  unsigned flags); /* defined in sys/pio.h */
  93. typedef void
  94. xtalk_piomap_free_f     (xtalk_piomap_t xtalk_piomap);
  96. typedef caddr_t
  97. xtalk_piomap_addr_f     (xtalk_piomap_t xtalk_piomap, /* mapping resources */
  98.  iopaddr_t xtalk_addr, /* map for this xtalk address */
  99.  size_t byte_count); /* map this many bytes */
  101. typedef void
  102. xtalk_piomap_done_f     (xtalk_piomap_t xtalk_piomap);
  104. typedef caddr_t
  105. xtalk_piotrans_addr_f   (devfs_handle_t dev, /* translate for this device */
  106.  device_desc_t dev_desc, /* device descriptor */
  107.  iopaddr_t xtalk_addr, /* Crosstalk address */
  108.  size_t byte_count, /* map this many bytes */
  109.  unsigned flags); /* (currently unused) */
  111. extern caddr_t
  112. xtalk_pio_addr (devfs_handle_t dev, /* translate for this device */
  113.  device_desc_t dev_desc, /* device descriptor */
  114.  iopaddr_t xtalk_addr, /* Crosstalk address */
  115.  size_t byte_count, /* map this many bytes */
  116.  xtalk_piomap_t *xtalk_piomapp, /* RETURNS mapping resources */
  117.  unsigned flags); /* (currently unused) */
  119. /* DMA MANAGEMENT */
  121. typedef struct xtalk_dmamap_s *xtalk_dmamap_t;
  123. typedef xtalk_dmamap_t
  124. xtalk_dmamap_alloc_f    (devfs_handle_t dev, /* set up mappings for this device */
  125.  device_desc_t dev_desc, /* device descriptor */
  126.  size_t byte_count_max, /* max size of a mapping */
  127.  unsigned flags); /* defined in dma.h */
  129. typedef void
  130. xtalk_dmamap_free_f     (xtalk_dmamap_t dmamap);
  132. typedef iopaddr_t
  133. xtalk_dmamap_addr_f     (xtalk_dmamap_t dmamap, /* use these mapping resources */
  134.  paddr_t paddr, /* map for this address */
  135.  size_t byte_count); /* map this many bytes */
  137. typedef alenlist_t
  138. xtalk_dmamap_list_f     (xtalk_dmamap_t dmamap, /* use these mapping resources */
  139.  alenlist_t alenlist, /* map this address/length list */
  140.  unsigned flags);
  142. typedef void
  143. xtalk_dmamap_done_f     (xtalk_dmamap_t dmamap);
  145. typedef iopaddr_t
  146. xtalk_dmatrans_addr_f   (devfs_handle_t dev, /* translate for this device */
  147.  device_desc_t dev_desc, /* device descriptor */
  148.  paddr_t paddr, /* system physical address */
  149.  size_t byte_count, /* length */
  150.  unsigned flags);
  152. typedef alenlist_t
  153. xtalk_dmatrans_list_f   (devfs_handle_t dev, /* translate for this device */
  154.  device_desc_t dev_desc, /* device descriptor */
  155.  alenlist_t palenlist, /* system address/length list */
  156.  unsigned flags);
  158. typedef void
  159. xtalk_dmamap_drain_f (xtalk_dmamap_t map); /* drain this map's channel */
  161. typedef void
  162. xtalk_dmaaddr_drain_f (devfs_handle_t vhdl, /* drain channel from this device */
  163.  paddr_t addr, /* to this physical address */
  164.  size_t bytes); /* for this many bytes */
  166. typedef void
  167. xtalk_dmalist_drain_f (devfs_handle_t vhdl, /* drain channel from this device */
  168.  alenlist_t list); /* for this set of physical blocks */
  171. /* INTERRUPT MANAGEMENT */
  173. /*
  174.  * A xtalk interrupt resource handle.  When resources are allocated
  175.  * in order to satisfy a xtalk_intr_alloc request, a xtalk_intr handle
  176.  * is returned.  xtalk_intr_connect associates a software handler with
  178.  * these system resources.
  179.  */
  180. typedef struct xtalk_intr_s *xtalk_intr_t;
  183. /*
  184.  * When a crosstalk device connects an interrupt, it passes in a function
  185.  * that knows how to set its xtalk interrupt register appropriately.  The
  186.  * low-level interrupt code may invoke this function later in order to
  187.  * migrate an interrupt transparently to the device driver(s) that use this
  188.  * interrupt.
  189.  *
  190.  * The argument passed to this function contains enough information for a
  191.  * crosstalk device to (re-)target an interrupt.  A function of this type
  192.  * must be supplied by every crosstalk driver.
  193.  */
  194. typedef int
  195. xtalk_intr_setfunc_f    (xtalk_intr_t intr_hdl); /* interrupt handle */
  197. typedef xtalk_intr_t
  198. xtalk_intr_alloc_f      (devfs_handle_t dev, /* which crosstalk device */
  199.  device_desc_t dev_desc, /* device descriptor */
  200.  devfs_handle_t owner_dev); /* owner of this intr */
  202. typedef void
  203. xtalk_intr_free_f       (xtalk_intr_t intr_hdl);
  205. typedef int
  206. xtalk_intr_connect_f    (xtalk_intr_t intr_hdl, /* xtalk intr resource handle */
  207.  xtalk_intr_setfunc_f *setfunc, /* func to set intr hw */
  208.  void *setfunc_arg); /* arg to setfunc */
  210. typedef void
  211. xtalk_intr_disconnect_f (xtalk_intr_t intr_hdl);
  213. typedef devfs_handle_t
  214. xtalk_intr_cpu_get_f    (xtalk_intr_t intr_hdl); /* xtalk intr resource handle */
  216. /* CONFIGURATION MANAGEMENT */
  218. typedef void
  219. xtalk_provider_startup_f (devfs_handle_t xtalk_provider);
  221. typedef void
  222. xtalk_provider_shutdown_f (devfs_handle_t xtalk_provider);
  224. typedef void
  225. xtalk_widgetdev_enable_f (devfs_handle_t, int);
  227. typedef void
  228. xtalk_widgetdev_shutdown_f (devfs_handle_t, int);
  230. typedef int
  231. xtalk_dma_enabled_f (devfs_handle_t);
  233. /* Error Management */
  235. typedef int
  236. xtalk_error_devenable_f (devfs_handle_t xconn_vhdl,
  237.  int devnum,
  238.  int error_code);
  240. /* Early Action Support */
  241. typedef caddr_t
  242. xtalk_early_piotrans_addr_f (xwidget_part_num_t part_num,
  243.      xwidget_mfg_num_t mfg_num,
  244.      int which,
  245.      iopaddr_t xtalk_addr,
  246.      size_t byte_count,
  247.      unsigned flags);
  249. /*
  250.  * Adapters that provide a crosstalk interface adhere to this software interface.
  251.  */
  252. typedef struct xtalk_provider_s {
  253.     /* PIO MANAGEMENT */
  254.     xtalk_piomap_alloc_f   *piomap_alloc;
  255.     xtalk_piomap_free_f    *piomap_free;
  256.     xtalk_piomap_addr_f    *piomap_addr;
  257.     xtalk_piomap_done_f    *piomap_done;
  258.     xtalk_piotrans_addr_f  *piotrans_addr;
  260.     /* DMA MANAGEMENT */
  261.     xtalk_dmamap_alloc_f   *dmamap_alloc;
  262.     xtalk_dmamap_free_f    *dmamap_free;
  263.     xtalk_dmamap_addr_f    *dmamap_addr;
  264.     xtalk_dmamap_list_f    *dmamap_list;
  265.     xtalk_dmamap_done_f    *dmamap_done;
  266.     xtalk_dmatrans_addr_f  *dmatrans_addr;
  267.     xtalk_dmatrans_list_f  *dmatrans_list;
  268.     xtalk_dmamap_drain_f   *dmamap_drain;
  269.     xtalk_dmaaddr_drain_f  *dmaaddr_drain;
  270.     xtalk_dmalist_drain_f  *dmalist_drain;
  272.     /* INTERRUPT MANAGEMENT */
  273.     xtalk_intr_alloc_f     *intr_alloc;
  274.     xtalk_intr_alloc_f     *intr_alloc_nothd;
  275.     xtalk_intr_free_f      *intr_free;
  276.     xtalk_intr_connect_f   *intr_connect;
  277.     xtalk_intr_disconnect_f *intr_disconnect;
  278.     xtalk_intr_cpu_get_f   *intr_cpu_get;
  280.     /* CONFIGURATION MANAGEMENT */
  281.     xtalk_provider_startup_f *provider_startup;
  282.     xtalk_provider_shutdown_f *provider_shutdown;
  284.     /* Error Management     */
  285.     xtalk_error_devenable_f *error_devenable;
  286. } xtalk_provider_t;
  288. /* Crosstalk devices use these standard Crosstalk provider interfaces */
  289. extern xtalk_piomap_alloc_f xtalk_piomap_alloc;
  290. extern xtalk_piomap_free_f xtalk_piomap_free;
  291. extern xtalk_piomap_addr_f xtalk_piomap_addr;
  292. extern xtalk_piomap_done_f xtalk_piomap_done;
  293. extern xtalk_piotrans_addr_f xtalk_piotrans_addr;
  294. extern xtalk_dmamap_alloc_f xtalk_dmamap_alloc;
  295. extern xtalk_dmamap_free_f xtalk_dmamap_free;
  296. extern xtalk_dmamap_addr_f xtalk_dmamap_addr;
  297. extern xtalk_dmamap_list_f xtalk_dmamap_list;
  298. extern xtalk_dmamap_done_f xtalk_dmamap_done;
  299. extern xtalk_dmatrans_addr_f xtalk_dmatrans_addr;
  300. extern xtalk_dmatrans_list_f xtalk_dmatrans_list;
  301. extern xtalk_dmamap_drain_f xtalk_dmamap_drain;
  302. extern xtalk_dmaaddr_drain_f xtalk_dmaaddr_drain;
  303. extern xtalk_dmalist_drain_f xtalk_dmalist_drain;
  304. extern xtalk_intr_alloc_f xtalk_intr_alloc;
  305. extern xtalk_intr_alloc_f xtalk_intr_alloc_nothd;
  306. extern xtalk_intr_free_f xtalk_intr_free;
  307. extern xtalk_intr_connect_f xtalk_intr_connect;
  308. extern xtalk_intr_disconnect_f xtalk_intr_disconnect;
  309. extern xtalk_intr_cpu_get_f xtalk_intr_cpu_get;
  310. extern xtalk_provider_startup_f xtalk_provider_startup;
  311. extern xtalk_provider_shutdown_f xtalk_provider_shutdown;
  312. extern xtalk_widgetdev_enable_f xtalk_widgetdev_enable;
  313. extern xtalk_widgetdev_shutdown_f xtalk_widgetdev_shutdown;
  314. extern xtalk_dma_enabled_f xtalk_dma_enabled;
  315. extern xtalk_error_devenable_f xtalk_error_devenable;
  316. extern xtalk_early_piotrans_addr_f xtalk_early_piotrans_addr;
  318. /* error management */
  320. extern int              xtalk_error_handler(devfs_handle_t,
  321.     int,
  322.     ioerror_mode_t,
  323.     ioerror_t *);
  325. /*
  326.  * Generic crosstalk interface, for use with all crosstalk providers
  327.  * and all crosstalk devices.
  328.  */
  329. typedef unchar xtalk_intr_vector_t; /* crosstalk interrupt vector (0..255) */
  331. #define XTALK_INTR_VECTOR_NONE (xtalk_intr_vector_t)0
  333. /* Generic crosstalk interrupt interfaces */
  334. extern devfs_handle_t     xtalk_intr_dev_get(xtalk_intr_t xtalk_intr);
  335. extern xwidgetnum_t     xtalk_intr_target_get(xtalk_intr_t xtalk_intr);
  336. extern xtalk_intr_vector_t xtalk_intr_vector_get(xtalk_intr_t xtalk_intr);
  337. extern iopaddr_t        xtalk_intr_addr_get(xtalk_intr_t xtalk_intr);
  338. extern devfs_handle_t     xtalk_intr_cpu_get(xtalk_intr_t xtalk_intr);
  339. extern void            *xtalk_intr_sfarg_get(xtalk_intr_t xtalk_intr);
  341. /* Generic crosstalk pio interfaces */
  342. extern devfs_handle_t     xtalk_pio_dev_get(xtalk_piomap_t xtalk_piomap);
  343. extern xwidgetnum_t     xtalk_pio_target_get(xtalk_piomap_t xtalk_piomap);
  344. extern iopaddr_t        xtalk_pio_xtalk_addr_get(xtalk_piomap_t xtalk_piomap);
  345. extern size_t           xtalk_pio_mapsz_get(xtalk_piomap_t xtalk_piomap);
  346. extern caddr_t          xtalk_pio_kvaddr_get(xtalk_piomap_t xtalk_piomap);
  348. /* Generic crosstalk dma interfaces */
  349. extern devfs_handle_t     xtalk_dma_dev_get(xtalk_dmamap_t xtalk_dmamap);
  350. extern xwidgetnum_t     xtalk_dma_target_get(xtalk_dmamap_t xtalk_dmamap);
  352. /* Register/unregister Crosstalk providers and get implementation handle */
  353. extern void             xtalk_set_early_piotrans_addr(xtalk_early_piotrans_addr_f *);
  354. extern void             xtalk_provider_register(devfs_handle_t provider, xtalk_provider_t *xtalk_fns);
  355. extern void             xtalk_provider_unregister(devfs_handle_t provider);
  356. extern xtalk_provider_t *xtalk_provider_fns_get(devfs_handle_t provider);
  358. /* Crosstalk Switch generic layer, for use by initialization code */
  359. extern void             xswitch_census(devfs_handle_t xswitchv);
  360. extern void             xswitch_init_widgets(devfs_handle_t xswitchv);
  362. /* early init interrupt management */
  364. typedef void
  365. xwidget_intr_preset_f   (void *which_widget,
  366.  int which_widget_intr,
  367.  xwidgetnum_t targ,
  368.  iopaddr_t addr,
  369.  xtalk_intr_vector_t vect);
  371. typedef void
  372. xtalk_intr_prealloc_f   (void *which_xtalk,
  373.  xtalk_intr_vector_t xtalk_vector,
  374.  xwidget_intr_preset_f *preset_func,
  375.  void *which_widget,
  376.  int which_widget_intr);
  378. typedef void
  379. xtalk_intr_preconn_f    (void *which_xtalk,
  380.  xtalk_intr_vector_t xtalk_vector,
  381.  intr_func_t intr_func,
  382.  intr_arg_t intr_arg);
  385. #define XTALK_ADDR_TO_UPPER(xtalk_addr) (((iopaddr_t)(xtalk_addr) >> 32) & 0xffff)
  386. #define XTALK_ADDR_TO_LOWER(xtalk_addr) ((iopaddr_t)(xtalk_addr) & 0xffffffff)
  388. typedef xtalk_intr_setfunc_f *xtalk_intr_setfunc_t;
  390. typedef void xtalk_iter_f(devfs_handle_t vhdl);
  392. extern void xtalk_iterate(char *prefix, xtalk_iter_f *func);
  394. extern int xtalk_device_powerup(devfs_handle_t, xwidgetnum_t);
  395. extern int xtalk_device_shutdown(devfs_handle_t, xwidgetnum_t);
  397. #endif /* __KERNEL__ */
  398. #endif /* _ASM_SN_XTALK_XTALK_H */