2 linux/include/comedilib.h
3 header file for kcomedilib
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 1998-2001 David A. Schleef <ds@schleef.org>
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #ifndef _LINUX_COMEDILIB_H
25 #define _LINUX_COMEDILIB_H
29 /* Kernel internal stuff. Needed by real-time modules and such. */
32 #error linux/comedilib.h should not be included by non-kernel-space code
35 /* exported functions */
37 #ifndef KCOMEDILIB_DEPRECATED
39 /* these functions may not be called at real-time priority */
41 void *comedi_open(const char *path);
42 int comedi_close(void *dev);
44 /* these functions may be called at any priority, but may fail at
47 int comedi_lock(void *dev, unsigned int subdev);
48 int comedi_unlock(void *dev, unsigned int subdev);
50 /* these functions may be called at any priority, but you must hold
51 the lock for the subdevice */
53 int comedi_loglevel(int loglevel);
54 void comedi_perror(const char *s);
55 char *comedi_strerror(int errnum);
56 int comedi_errno(void);
57 int comedi_fileno(void *dev);
59 int comedi_cancel(void *dev, unsigned int subdev);
60 int comedi_register_callback(void *dev, unsigned int subdev,
61 unsigned int mask, int (*cb) (unsigned int, void *), void *arg);
63 int comedi_command(void *dev, struct comedi_cmd *cmd);
64 int comedi_command_test(void *dev, struct comedi_cmd *cmd);
65 int comedi_trigger(void *dev, unsigned int subdev, struct comedi_trig *it);
66 int __comedi_trigger(void *dev, unsigned int subdev, struct comedi_trig *it);
67 int comedi_data_write(void *dev, unsigned int subdev, unsigned int chan,
68 unsigned int range, unsigned int aref, unsigned int data);
69 int comedi_data_read(void *dev, unsigned int subdev, unsigned int chan,
70 unsigned int range, unsigned int aref, unsigned int *data);
71 int comedi_data_read_hint(void *dev, unsigned int subdev,
72 unsigned int chan, unsigned int range, unsigned int aref);
73 int comedi_data_read_delayed(void *dev, unsigned int subdev,
74 unsigned int chan, unsigned int range, unsigned int aref,
75 unsigned int *data, unsigned int nano_sec);
76 int comedi_dio_config(void *dev, unsigned int subdev, unsigned int chan,
78 int comedi_dio_read(void *dev, unsigned int subdev, unsigned int chan,
80 int comedi_dio_write(void *dev, unsigned int subdev, unsigned int chan,
82 int comedi_dio_bitfield(void *dev, unsigned int subdev, unsigned int mask,
84 int comedi_get_n_subdevices(void *dev);
85 int comedi_get_version_code(void *dev);
86 const char *comedi_get_driver_name(void *dev);
87 const char *comedi_get_board_name(void *dev);
88 int comedi_get_subdevice_type(void *dev, unsigned int subdevice);
89 int comedi_find_subdevice_by_type(void *dev, int type, unsigned int subd);
90 int comedi_get_n_channels(void *dev, unsigned int subdevice);
91 unsigned int comedi_get_maxdata(void *dev, unsigned int subdevice, unsigned
93 int comedi_get_n_ranges(void *dev, unsigned int subdevice, unsigned int
95 int comedi_do_insn(void *dev, struct comedi_insn *insn);
96 int comedi_poll(void *dev, unsigned int subdev);
98 /* DEPRECATED functions */
99 int comedi_get_rangetype(void *dev, unsigned int subdevice,
102 /* ALPHA functions */
103 unsigned int comedi_get_subdevice_flags(void *dev, unsigned int subdevice);
104 int comedi_get_len_chanlist(void *dev, unsigned int subdevice);
105 int comedi_get_krange(void *dev, unsigned int subdevice, unsigned int
106 chan, unsigned int range, struct comedi_krange *krange);
107 unsigned int comedi_get_buf_head_pos(void *dev, unsigned int subdevice);
108 int comedi_set_user_int_count(void *dev, unsigned int subdevice,
109 unsigned int buf_user_count);
110 int comedi_map(void *dev, unsigned int subdev, void *ptr);
111 int comedi_unmap(void *dev, unsigned int subdev);
112 int comedi_get_buffer_size(void *dev, unsigned int subdev);
113 int comedi_mark_buffer_read(void *dev, unsigned int subdevice,
114 unsigned int num_bytes);
115 int comedi_mark_buffer_written(void *d, unsigned int subdevice,
116 unsigned int num_bytes);
117 int comedi_get_buffer_contents(void *dev, unsigned int subdevice);
118 int comedi_get_buffer_offset(void *dev, unsigned int subdevice);
122 /* these functions may not be called at real-time priority */
124 int comedi_open(unsigned int minor);
125 void comedi_close(unsigned int minor);
127 /* these functions may be called at any priority, but may fail at
128 real-time priority */
130 int comedi_lock(unsigned int minor, unsigned int subdev);
131 int comedi_unlock(unsigned int minor, unsigned int subdev);
133 /* these functions may be called at any priority, but you must hold
134 the lock for the subdevice */
136 int comedi_cancel(unsigned int minor, unsigned int subdev);
137 int comedi_register_callback(unsigned int minor, unsigned int subdev,
138 unsigned int mask, int (*cb) (unsigned int, void *), void *arg);
140 int comedi_command(unsigned int minor, struct comedi_cmd *cmd);
141 int comedi_command_test(unsigned int minor, struct comedi_cmd *cmd);
142 int comedi_trigger(unsigned int minor, unsigned int subdev, struct comedi_trig *it);
143 int __comedi_trigger(unsigned int minor, unsigned int subdev, struct comedi_trig *it);
144 int comedi_data_write(unsigned int dev, unsigned int subdev, unsigned int chan,
145 unsigned int range, unsigned int aref, unsigned int data);
146 int comedi_data_read(unsigned int dev, unsigned int subdev, unsigned int chan,
147 unsigned int range, unsigned int aref, unsigned int *data);
148 int comedi_dio_config(unsigned int dev, unsigned int subdev, unsigned int chan,
150 int comedi_dio_read(unsigned int dev, unsigned int subdev, unsigned int chan,
152 int comedi_dio_write(unsigned int dev, unsigned int subdev, unsigned int chan,
154 int comedi_dio_bitfield(unsigned int dev, unsigned int subdev,
155 unsigned int mask, unsigned int *bits);
156 int comedi_get_n_subdevices(unsigned int dev);
157 int comedi_get_version_code(unsigned int dev);
158 char *comedi_get_driver_name(unsigned int dev);
159 char *comedi_get_board_name(unsigned int minor);
160 int comedi_get_subdevice_type(unsigned int minor, unsigned int subdevice);
161 int comedi_find_subdevice_by_type(unsigned int minor, int type,
163 int comedi_get_n_channels(unsigned int minor, unsigned int subdevice);
164 unsigned int comedi_get_maxdata(unsigned int minor, unsigned int subdevice, unsigned
166 int comedi_get_n_ranges(unsigned int minor, unsigned int subdevice, unsigned int
168 int comedi_do_insn(unsigned int minor, struct comedi_insn *insn);
169 int comedi_poll(unsigned int minor, unsigned int subdev);
171 /* DEPRECATED functions */
172 int comedi_get_rangetype(unsigned int minor, unsigned int subdevice,
175 /* ALPHA functions */
176 unsigned int comedi_get_subdevice_flags(unsigned int minor, unsigned int
178 int comedi_get_len_chanlist(unsigned int minor, unsigned int subdevice);
179 int comedi_get_krange(unsigned int minor, unsigned int subdevice, unsigned int
180 chan, unsigned int range, struct comedi_krange *krange);
181 unsigned int comedi_get_buf_head_pos(unsigned int minor, unsigned int
183 int comedi_set_user_int_count(unsigned int minor, unsigned int subdevice,
184 unsigned int buf_user_count);
185 int comedi_map(unsigned int minor, unsigned int subdev, void **ptr);
186 int comedi_unmap(unsigned int minor, unsigned int subdev);